Adding a New Protocol Adapter (PA) to Form a Cluster
Before you begin
The following must be in place before you can set up a Protocol Adapter (PA) cluster:
- Installed Management Service (MS) instance
- Client ID and Client Secret security access credentials
- User account with administrative permissions
- Server without an installed MQTT PA, MQTT RPC PA (server requires network access to the MS and the MQTT broker)
- At least one MQTT PA or MQTT RPC PA already present in the SOTI Connect system
About this task
This process describes how to add a new protocol adapter to an existing one to form a PA cluster.
Note: The first PA in a cluster is always installed as standalone. Subsequent PA(s)
of the same type in the cluster installs as Part of a
Cluster.
Procedure
-
Run
SOTI Connect Installer.exe. The SOTI Connect Setup Wizard displays. When prompted, confirm that you want to enable the installer to make changes to your system. -
Select Install Connect components, then select
Next. The Installation Type
window displays.
-
Select Custom, then select Next.
The Select Components window displays.
-
Select Protocol Adapter: MQTT or Protocol
Adapter: MQTT RPC, then select Next. The
Management Service Root Certificate window
displays.
Important: Options for Management Service, Logging Service, and File Store Service should be cleared as these were installed when the MS was established.
-
Choose Import root certificate from file, and select
Browse and navigate to the root certificate. Add the
Certificate Password, then select
Next. The Configure MQTT Protocol
Adapter window displays.
Note: Optionally, you can download the root certificate from the SOTI Connect Web Console's main menu. Navigate to . -
Select Part of a Cluster. Complete the rest of the
fields on this window (the Network Address of Management
Service (MS) and Logging Service. The Client ID and
Client Secret, and the
Username and Password of a
user with administrative permissions).
Note: You must have created at least one security access. See Providing Security Access.
-
Select Test Connection. If the test is unsuccessful,
check the following:
- Check that the Client ID and Client Secret are correct.
- From this location, open the SOTI Connect web page. Sign in with the Username and Password used earlier. Ignore possible warning messages about the root certificate. It becomes trusted during the installation.
- Sign out on the web page and sign back in. Check and accept the EULA.
Important: A user with administrator privileges must accept the End-user License Agreement (EULA), and must do so whether using a local account or an IDP. - Select Next. The Configure MQTT Protocol Adapter Cluster window displays.
-
Select an existing PA or PA cluster with which you want to form a cluster, then
select Next. The installer connects to the MS and
requests MQTT broker connection details. Once completed, the Root
Folder window displays.
-
Select the folder where you want the PA installed. Select
Next, then Install to complete
the process.
Results
