Contents
Cirrus Link Resources
Chariot MQTT Server v1 (previous version)
Cirrus Link Modules for Ignition
Contact Us (Sales/Support)
Forum
The following guide will walk through the process of upgrading from a Chariot MQTT Server version 2.0.0 to version 2.2.*.
Due to the updated method of system backup/restore released in 2.1.0, the process will first need to upgrade from 2.0.0 to 2.1.0 and then to 2.2.*.
The following upgrade instructions for each of the supported platforms Upgrading from v2.0.0 and Upgrading from v2.0.0 requires the user has superuser/admin privileges and can execute any scripts at the command line in the directories where these servers are installed.
Stop the v2.0.0 Chariot service. From a command prompt, run the Chariot service stop script in the v2.0.0 directory.
sudo /etc/init.d/chariot stop
Install v2.1.0 following the Chariot MQTT Server Installation instructions. This instance should be installed ONLY and should not be started.
Copy the upgradeExport.sh file from the v2.1.0 directory to the v2.0.0 directory. For example:
sudo cp ./chariotv2.1.0/upgradeExport.sh ./chariotv2.0.0/upgradeExport.sh
From a command prompt, run the upgradeExport script in the v2.0.0 directory to create the upgrade zip file containing the data from the old installation. The file naming convention will be chariot_upgrade_YYMMDD_HHMM.tgz.
sudo ./upgradeExport.sh
Copy the upgrade.tgz file from the v2.0.0 directory to the v2.1.0 directory. For example:
sudo mv ./chariotv2.0.0/chariot_upgrade_20220113_1612.tgz ./chariotv2.1.0/chariot_upgrade_20220113_1612.tgz
From a command prompt, run the upgradeImport script in the v2.1.0 directory referencing the upgrade.tgz file
sudo ./upgradeImport.sh chariot_upgrade_20220113_1612.tgz
Start the v2.1.0 Chariot service. From a command prompt, run the Chariot service start script in the v2.1.0 directory
sudo /etc/init.d/chariot start
Backup your Chariot configuration using the Backup/Restore feature. To do this navigate to System in the left menu bar of the Chariot MQTT UI, select Backup/Restore and Export Backup
Stop the v2.1.0 Chariot service. From a command prompt, run the Chariot service stop script in the v2.1.0 directory
sudo /etc/init.d/chariot stop
Install v2.2.* following the Chariot MQTT Server Installation instructions in a new Chariot directory.
Start the v2.2.* Chariot service. From a command prompt, run the Chariot service start script in the v2.2.* directory.
sudo /etc/init.d/chariot start
Restore your Chariot configuration using the Backup/Restore feature. To do this navigate to System in the left menu bar of the Chariot MQTT UI, select Backup/Restore and Restore from Backup. When prompted, navigate to the backup.tgz file created earlier and import.
Confirm that any configuration items have been imported correctly.
If configured for SSL, reload any SSL certificates.
Following the Licensing Procedure, activate your existing license on the v2.2.* Chariot MQTT Server to complete the upgrade.
Stop the v2.0.0 Chariot service. From a command prompt, run the Chariot service stop script in the v2.0.0 directory.
serviceStop.bat
Install v2.1.0 following the Chariot MQTT Server Installation instructions. This instance should be installed ONLY and should not be started.
Copy the upgradeExport.vbs file from the v2.1.0 directory to the v2.0.0 directory. For example:
copy D:\chariotv2.1.0\upgradeExport.vbs D:\chariotv2.0.0\upgradeExport.vbs
From a command prompt, run the upgradeExport.vbs script in the v2.0.0 directory to create the upgrade zip file containing the data from the old installation. The file naming convention will be chariot_upgrade_YYMMDD_HHMM.zip
upgradeExport.vbs
Copy the upgrade.zip file from the v2.0.0 directory to the v2.1.0 directory. For example:
copy D:\chariotv2.0.0\chariot_upgrade_20220113_1612.zip D:\chariotv2.1.0\chariot_upgrade_20220113_1612.zip
From a command prompt, run the upgradeImport script in the v2.1.0 directory
ugradeImport.vbs
Start the v2.1.0 Chariot service. From a command prompt, run the Chariot service start script in the v2.1.0 directory.
serviceStart.bat
Backup your Chariot configuration using the Backup/Restore feature. To do this navigate to System in the left menu bar of the Chariot MQTT UI, select Backup/Restore and Export Backup.
Stop the v2.1.0 Chariot service. From a command prompt, run the Chariot service stop script in the v2.1.0 directory.
serviceStop.bat
Install v2.2.* following the Chariot MQTT Server Installation instructions in a new Chariot directory.
Start the v2.2.* Chariot service. From a command prompt, run the Chariot service start script in the v2.2.* directory.
serviceStart.bat
Restore your Chariot configuration using the Backup/Restore feature. To do this navigate to System in the left menu bar of the Chariot MQTT UI, select Backup/Restore and Restore from Backup. When prompted, navigate to the backup.zip file created earlier and import.