The following guide will walk through the process of upgrading from a Chariot MQTT Server version 2.0.0 to a newer version.
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 the newer version.
The following upgrade instructions for each of the supported platforms Linux and Windows requires the user has superuser/admin privileges and can execute any scripts at the command line in the directories where these servers are installed.
During this upgrade process your MQTT broker will be offline. Typical update time is less than 10 minutes. |
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.
Do not overwrite the old version of Chariot when extracting the Chariot ZIP package, but instead create a new Chariot directory and extract the new Chariot package into that new directory. For example:
|
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 the latest version of Chariot, following the Chariot MQTT Server Installation instructions in a new Chariot directory.
Do not overwrite the old version of Chariot when extracting the Chariot ZIP package, but instead create a new Chariot directory and extract the new Chariot package into that new directory. For example:
|
Start the new Chariot service. From a command prompt, run the Chariot service start script in the v2.*.* 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 new 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.
Do not overwrite the old version of Chariot when extracting the Chariot ZIP package, but instead create a new Chariot directory and extract the new Chariot package into that new directory. For example:
|
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 the latest version of Chariot, following the Chariot MQTT Server Installation instructions in a new Chariot directory.
Do not overwrite the old version of Chariot when extracting the Chariot ZIP package, but instead create a new Chariot directory and extract the new Chariot package into that new directory. For example:
|
Start the new Chariot service. From a command prompt, run the Chariot service start script in the v2.*.* 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.