Installing a Failover MS Instance for a Migration

About this task

Use the following procedure to install a failover instance of the Management Service (MS) on a target VM. This will become the migrated instance when the steps below are complete.

Table 1. Abbreviations
Abbreviation Term
FS File store service
LS Logging service
MQTT MQ telemetry transport
MS Management service
PA Protocol adapter
REST Representational state transfer
SQL Refers to the structured query language database environment
VM Virtual machine
Table 2. Environment
Device System Detail
cluster88.internal.soti.net
  • The system to migrate (source VM)
  • Contains: SQL, MS, LS, FS, REST PA, MQTT PA
db-primary5e.internal.soti.net
  • Destination for the migration (target VM)
  • Contains: migrated SQL
RIL-PerfMon28.sotidev.com
  • Emulates devices
  • Holds the MQTT broker

The following diagram illustrates the setup of a typical SOTI Connect migration.

In this illustration, the SQL database is already migrated to the target VM and connected to the MS.
Note: In the steps below, use the MS on the source VM as the active source of the configuration. Use the target VM as the location where the failover instance is hosted.

Migration diagram

Procedure

  1. Run the SOTI Connect installer executable (SOTI Connect Installer.exe). The SOTI Connect Setup Wizard is displayed.
    Important: Be sure to use the same version of the installer. Failure to do so will result in an unsuccessful installation.
  2. On the SOTI Connect Setup Wizard, select Installation of a failover instance and select Next.
    Installer Failover
  3. Select Management Service and additional components as needed. This includes the Logging Service (this cannot be installed as a separate component). Select Next.
  4. On the Locate active Management Service instance screen, enter the Network Address or FQDN of the active MS instance.
    Locate active management service instance
  5. Enter the Client id, Client secret (configured on the Security Access area of the active MS), Username and Password of an Administrator user. Select Test Connection and select Next.
  6. On the Management Service configuration screen, enter the hostname of the target VM and the load balancer's hostname in the respective fields. Select Next.
  7. Choose the root folder for the failover MS installation.
  8. Select Install. The failover instance is installed. Select Finished when complete.
    Note: Only one MS can be connected to the SQL database at a time.
    Client ID Secret

Results

The environment is configured as shown below.

Migration diagram

The MS will now be accessible by the new URL (https://db-primary5e.internal.soti.net/Connect/#/devices/view-all). The devices and the PA will be connected.