Typical (All-In-One) Installation
Before you begin
- Download the SOTI Connect Installer.
- Ensure you have a SQL Server already installed. See Installing and Setting Up SQL Server for more information. Make sure you have the connection string handy.
- Ensure you know the FQDN (Fully Qualified Domain Name) of the machine you will install Connect on.
About this task
The following procedure leads you through a typical new on-premises installation of SOTI Connect using the step-by-step installer.
Procedure
- Extract the SOTI Connect installation package (.zip file) to a temporary folder.
- In the temporary folder, double-click the installer (SOTI Connect Installer.exe). When prompted, confirm that you want to allow the installer to make changes to your system.
-
In the installer, select New installation of some or all components. Click Next.
-
For the installation type select Typical. Click Next.
-
Enter the Fully Qualified Domain Name (FQDN). You can find this by
right-clicking Computer in the File Explorer and
selecting Properties. The FQDN is the Device
name value.
In the Management Service configuration step, enter the FQDN as shown:
-
Select whether you want to import a root certificate from an existing file or
generate a new root certificate. Click Next.
Select Generate a new root certificate if you are performing a typical installation where all components are located on the same machine.
-
For HTTPS communication you need a server certificate. Select one of the
following options, then click Next.
Option Description 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 PFX certificate 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 needing to know 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 being used for HTTPS communication
- you want to manage the certificate later directly from your operating system
Note: This option is not recommended unless you are comfortable performing manual installation of a certificate. -
Enter details specific to the REST Protocol Adapter and the URL where the
webhook receiver will be hosted. Click Next.
-
Enter details specific to the MQTT protocol adapter. Click Next.
The MQTT protocol adapter is preconfigured. The connection addresses and ports entered 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.
-
Enter the settings for the MQTT printer simulator. Click Next.
-
Enter the settings for the MQTT sensor simulator. Click Next.
-
Click Browse to select the root installation folder, or accept the default location. Click Next.
-
Enter the information required to connect to your SQL Server database,
including the FQDN name in the Server field. Click
Next.
All SQL Server database connections default to localhost. If you have more than one instance, you must specify the instance as localhost\SQLEXRESS.
If you have multiple instances 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.
As part of installation, a backup will be made of the main SQL database. You can optionally also select to Backup historical database and Backup Logging Service database by clicking those boxes.
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 will run as the LOCAL SYSTEM account. If you select Windows Authentication, ensure that the account running the Management Service (the default LOCAL SYSTEM) has sufficient privileges in SQL Server.
For this procedure we will choose SQL Server Authentication.
-
Enter and confirm a temporary administrator password (you will be asked to change it when you log into SOTI Connect for the first time), and generate a client ID and client secret other applications will require to access the API. Click Next.
Note: Be sure to store the client ID and client secret in a secure location.
-
Click Install to start installing SOTI Connect.
-
Click Finish to complete the SOTI Connect installation.
- Click the Open SOTI Connect now link at the bottom of the page.
- Log in with the temporay Administrator password that you configured in step 14, and accept the License Agreement.
- Change your temporary password and click Save.
Results
You have now installed SOTI Connect.
What to do next
We recommend that you use the Watchdog utility (installed with SOTI Connect) to check that SOTI Connect services are running. You will need to 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).