Installing a Protocol Adapter

About this task

Use the following steps to install a protocol adapter:

Procedure

  1. On the server where you want to install the protocol adapter, extract the SOTI Connect installation package (.zip file) to a temporary folder.
  2. In the temporary folder, double-click the installer (Soti.IoT.Installer.exe).

    When prompted, confirm that you want to allow the installer to make changes to your system.

  3. In the installer, select New installation of some or all components, then click Next.
  4. For the installation type select Custom, then click Next.
  5. On the Select Components panel, select only the protocol adapter types you want to install: REST or MQTT or both. Make sure all the other components are deselected, then click Next.
  6. If you are installing a REST protocol adapter, enter the fully qualified domain name (FQDN) of the server on which you installed SOTI Connect, and the port numbers of the SOTI Connect management service, logging service, and webhook receiver. Click Next.

    The default port numbers are already entered and we recommend not changing them. The FQDN you enter here is the same one you entered when you installed SOTI Connect (in step 5).

  7. If you are installing an MQTT protocol adapter, enter the fully qualified domain name (FQDN) of the server on which you installed SOTI Connect, and the port numbers of the SOTI Connect management service and logging service. Click Next.

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

    The default port numbers are already entered and we recommend not changing them. The FQDN you enter here is the same one you entered when you installed SOTI Connect (in step 5).

  8. Click Browse to select the folder where you want to install the protocol adapter, or accept the default location. Click Next.
  9. Import the root certificate you generated and exported when you installed SOTI Connect (in step 11). Click Next.
  10. Click Install to start installing the protocol adapter.
  11. Click Finish to complete the protocol adapter installation.

Results

The SOTI Connect protocol adapter has now been installed.