Migrating to a Multi-Use Virtual Machine (VM)

Before you begin

Before migrating the PA, be sure you have first migrated the database and management service.

About this task

Use this procedure to migrate a protocol adapter (PA) to the virtual machine where your Management Service (MS) resides. Keep all previous parameters for the MS.

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

In our example, the environment should appear as follows:

Current environment

Procedure

  1. Verify that the source PAs are stopped on the System Management > System Architecture screen.
  2. Run SOTI Connect Installer.exe. The SOTI Connect Setup Wizard is displayed. When prompted, confirm that you want to allow the installer to make changes to your system.
  3. Select Update configuration of existing Connect components, then select Next.
    Setup Wizard
  4. On the Select Components panel, select only the protocol adapter types you want to install: REST, MQTT, or both.
    Note: Some items may be preselected or unavailable based on your current configuration.
  5. Make sure all the other components are deselected, then select Next. The environment is configured as follows.
    Diagram showing the migrated PAs inside the virtual machine where the management service resides
  6. Verify that the new PAs are running on the System Management > System Architecture screen.

    SOTI Connect System Management screen, System Architecture tab showing new PAs

  7. Next, restore the configuration settings for each PA along with links to devices. To do this, stop the PA services on the target VM.
  8. On the source VM, locate the folders containing each PA's ID and copy their .dat files. Folders are named in the following format: C:\ProgramData\SOTI\Connect\[PA type id]\Settings\ComponentIdStore.dat.

    For example:

    C:\ProgramData\SOTI\Connect\Protocols.Stacks.Mqtt\Settings\ComponentIdStore.dat

    C:\ProgramData\SOTI\Connect\Protocols.Stacks.Rest\Settings\ComponentIdStore.dat

    Windows explorer showing showing path to protocol adaptors

  9. Replace the duplicate files on the target VM with the corresponding files from the SRC VM.
  10. Restart the disconnected services for both PAs on the target VM.
    SOTI Connect Administration panel, System Architecture tab showing stopped PAs
  11. Devices are available once their connection status is updated (up to approximately five minutes). Alternatively, you can manually send any command, such as 'check in', to a device.
    SOTI Connect Devices panel with several devices selected and the Check Action button pressed
  12. Remove any unnecessary PAs.
    SOTI Connect Administration Page with a PA selected and the Delete Adapter option visible
  13. Some devices can send 'push' messages, such as alerts, to a Rest PA. The PA is typically a client which periodically connects to devices. A device can also connect to a Rest PA using a webhook receiver configured during installation. The connection must be refreshed on the device side. To do that, run Discover Devices on the Rest PA as shown in the diagram below.
    SOTI Connect System Management, System Architecture page with PA selected and More options menu open. Discover Devices is shown on the dropdown list