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

Verify that the source PAs are stopped on the System Management > System Architecture screen.
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.
Select Update configuration of existing Connect components, then select Next.
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.
Make sure all the other components are deselected, then select Next. The environment is configured as follows.
Verify that the new PAs are running on the System Management > System Architecture screen.
Next, restore the configuration settings for each PA along with links to devices. To do this, stop the PA services on the target VM.
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
Replace the duplicate files on the target VM with the corresponding files from the SRC VM.
Restart the disconnected services for both PAs on the target VM.
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.
Remove any unnecessary PAs.
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.