Skip to main content
Chariot v2.7 - v2.8.1

Chariot License Management

Summary​

The Chariot® MQTT Server Web UI allows for uploading, activating, and deactivating valid Chariot Licenses. If you have deployed Chariot through AWS Marketplace or Azure Marketplace, then no additional steps are required - your license is already installed and activated. This tutorial will cover the process for both online and offline activations and deactivations.

Prerequisites​

  • Request a valid Chariot License from Cirrus Link Support.
  • Follow the Chariot® MQTT Server Installation instructions to download and install Chariot MQTT Server instance.

Online​

License Activation​

The Online Activation feature allows a Chariot License to be automatically activated on a Chariot MQTT Server instance that is connected to the internet. The Chariot MQTT Server will remotely connect and activate a Chariot License if it is valid and has an activation available.

  1. Log into the Chariot MQTT Server Web UI and from the left hand menu bar select License as shown below:
  1. The text file containing the Chariot License can either be dragged & dropped in the Upload License area, or the area can be clicked to bring up an empty form and the license text can be copied & pasted into the form.
  1. Click the Save button to finish uploading the Chariot License. Once successfully added, the license will auto activate and the page should look like the following. The Chariot MQTT Server is now fully licensed and read to you.

License Dectivation​

In order to deactivate the license online, log into the Chariot MQTT Server Web UI and from the left hand menu bar select License as shown below.

  1. Select Deactivate License for the license to be remotely deactivated so that it can be potentially activated on another Chariot MQTT Server instance.

⚠️ If the server is terminated, deleted, or destroyed without deactivating the active Chariot License, that license will permanently lose one of its total number of activations.

Offline​

License Activation​

For Chariot MQTT Server instances that do not have internet access, an offline action process is available.

  1. Log into the Chariot MQTT Server Web UI and from the left hand menu bar select License as shown below:
  1. Toggle Online Activation to change it to Offline Activation mode, as shown below.
  1. The text file containing the Chariot License can either be dragged & dropped in the Upload License area, or the area can be clicked to bring up an empty form and the license text can be copied & pasted into the form. A successfully added license will look like the following:
  1. Click the Save button to finish uploading the Chariot License. The license will NOT activate and the page should look like the following:
  1. Click Generate Activation Request to generate a new request.

⚠️ Only do this ONCE as each new activation request will invalidate the previous one.

  1. Copy & paste the generated code to a text file and send the file to Cirrus Link Support (support@cirrus-link.com) along with the License ID in order to obtain an Activation Code.
  1. Once the Activation Code is obtained, return to the License page in the Chariot MQTT Server Web UI and click on Upload Activation Code and copy & paste the Activation Code into the form. Click Save - the license should be successfully activated. 🚀

License Dectivation​

In order to deactivate the license offline, log into the Chariot MQTT Server Web UI and from the left hand menu bar select License.

  1. Ensure that Offline Activation is toggled.
  2. Select the Deactivate and Generate Request as shown below:
  1. Copy & paste the generated code to a text file and send the file to Cirrus Link Support (support@cirrus-link.com) along with the License ID in order to free up the previous activation for use with another Chariot MQTT Server instance.