Installing SOTI Connect

Before you begin

Note: Close Windows Services and Task Manager applications before preforming any installation related activities.

About this task

This procedure describes the process of installing a new installation of SOTI Connect.

Procedure

  1. Extract the SOTI Connect installation package (.zip file) to a temporary folder.
  2. In the temporary folder, double-click the installer (SOTI Connect Installer.exe). When prompted, confirm that you allow the installer to make changes to your system.
  3. In the installer, select Install Connect components. Select Next.
    SOTI Connect Setup Wizard
  4. For the installation type, select Typical. Select Next.
    SOTI Connect Setup Wizard - Typical
  5. In the Management Service configuration step, enter the Fully Qualified Domain Name (FQDN) as shown:
    Management Service configuration with the FQDN entered
    Note: To find the FQDN, right-click Computer in the File Explorer and select Properties. The FQDN is the Device name value.
    Screen showing the FQDN
  6. Select whether you want to import a root certificate from an existing file or generate a new one. Select Next.
    Note: Select Export certificate to export the generated root certificate for later use while installing additional MS instances.
    Certificates
  7. For HTTPS communication, you need a server certificate. Select one of the following options and select Next.
    OptionDescription
    Use root certificate from previous step Select this option to generate and use another certificate from the same root certificate used in step 6.
    Upload a PKCS#12 server certificate (.PFX) Select this option if you have a certificate file you want to use (for example, one you purchased from a trusted certificate authority).
    Use a previously installed certificate from the Windows Certificate Store Select this option if the certificate you want to use is already installed in the Windows trusted store and you know its thumbprint value. This method allows you to specify a password-protected certificate without knowing the password.
    Skip this step and deal with this manually later Select this option if one of the following applies:
    • There is already a certificate in use for HTTPS communication
    • You want to manage the certificate later directly from your operating system
    Note: This option is only recommended if you are comfortable installing a certificate manually.
    Server Certificates
  8. On the File Store Service configuration screen, enter the FS hostname, Logging Service address, and their port numbers. If you want to change the FS file system location, select Browse to provide a local file storage or shared network location path. For setting up a shared network drive, see Setting Up a Shared Network Location. Select Next.
    Note: For all-in-one installation scenarios, there is no need to enter the FS hostname address and port numbers. They are pre-filled with the information entered for the MS.
    Configure File Store Service
  9. On the File Store Service HTTPS Certificate screen, provide the HTTP server and HTTP root certificate information as follows. Select Next.
    • Select Generate server certificate. Reuse root certificate from Management Service. In this case, MS root certificate (either custom or autogenerated) generates the HTTP certificate and used as the FS HTTP root certificate. This option is available only on setups with both FS and MS installed.
    • Select Generate server certificate. Upload independent root certificate to upload a custom root HTTP certificate for server HTTP certificate generation and later for its validation.
    • Select Upload server certificate and corresponding root certificate to upload the HTTP root certificate and HTTP server certificate. Use this option if your certificate is from a trusted certificate authority.
    Configure File Store Service HTTPS Certificate

    To update HTTPS certificates, see File Store Service (FS).

  10. Enter details specific to the REST Protocol Adapter and the address of the webhook receiver host. Select Next.
    Configure Webhook Receiver
  11. Enter details specific to the MQTT protocol adapter. Select Next.

    The MQTT protocol adapter address and port numbers are pre-filled with information. The connection addresses and ports in this panel must match the addresses and ports where these services are listening.

    Select the Use Tenant ID Prefix option if you want your MQTT devices to recognize only this single instance of SOTI Connect.

    Configure MQTT Protocol Adapter
  12. Enter details specific to the MQTT RPC protocol adapter. Select Next.
    Configure MQTT RPC Protocol Adapter
  13. Enter details specific to the SNMP protocol adapter. Select Next.
    Configure SNMP Protocol Adapter
  14. Enter the settings for the MQTT printer simulator. Select Next.
    Configure MQTT Printer Simulator
  15. Enter the settings for the MQTT sensor simulator. Select Next.
    Configure MQTT Printer Simulator
  16. Enter the settings for the Generic thermal printer simulator. Select Next.
    Configure Generic Thermal Printer Simulator
  17. Enter the settings for the MQTT RPC Zebra printer simulator. Select Next.
    Configure MQTT RPC Zebra Printer Simulator
  18. Enter the root installation folder, or accept the default location. Select Next.
    Root Folder
  19. Enter the information required to connect to your SQL Server database, including the FQDN name in the Server field. Select Next.

    If you have more than one instance of SQL Server or SQL Server Express running on your machine, be sure to select the right one. The connection string in the Server field can vary.

    Select Windows Authentication if that is how you prefer to connect to the SQL Server database. Note that the SOTI Connect service using the database runs as the LOCAL SYSTEM account. If you select Windows Authentication, ensure that the account running the Management Service (the default LOCAL SYSTEM) has enough privileges in SQL Server.

    Note: Set up SQL Server
    Tip: Select the TEST CONNECTION button to ensure the connection credentials are correct.
  20. Enter and confirm a temporary administrator password (you must change it when you log into SOTI Connect for the first time). Select Next.
    Create Administrator User
  21. Select Install.
    Click Install
  22. Select Finish to complete the SOTI Connect installation.
    Finish Installation
  23. Select the Open SOTI Connect now link at the bottom of the page.
  24. Log in with the temporary Administrator password you configured in step 20, and accept the License Agreement.
  25. Change your temporary password and select Save.

Results

You have successfully installed SOTI Connect.

Tip: If any problems occur during installation, check the logs. To view the logs, navigate to the installation folder and open the InstallerUI.log file.

What to do next

Use the Watchdog utility (installed with SOTI Connect) to check that SOTI Connect services are running. You must run the utility as an administrator. You can access it from the same directory where you installed SOTI Connect (\Program Files\SOTI\Connect\Soti.IoT.Watchdog\lib\Release\net472\Soti.IoT.Watchdog.exe).