Prerequisites
- Have a computer/server running Linux (recommended: Ubuntu 18.04 LTS or newer)
- Have a copy of the latest Chariot MQTT Server zip file found here:.
Installing Chariot MQTT Server (as superuser)
The following installation instructions assume you have superuser privileges. Non-superuser installation instructions can be found here. The Chariot MQTT Server can be installed on the Linux server by following these steps:
Transfer the zip file to the Linux server and unzip the file
Using the file transfer method of you choice, transfer the Chariot MQTT Server zip file to the Linux server and unzip with the following command
$ unzip ./chariot_linux.zip -d ./Chariot |
Run the install script
Navigate to the directory where the Chariot MQTT Server was unzipped and run the install script using the following commands
$ cd ./Chariot
$ /bin/bash ./install.sh |
An example of a success installation may look like the following:
The Chariot MQTT Server should now be installed in the Linux server and will run automatically when the server is booted.
Start the Chariot MQTT Server
After the Chariot MQTT Server is installed, the Chariot daemon can be launched with the following command
Verify the Chariot MQTT Server installation
The status of the Chariot MQTT Server can be obtained by running the following script
An example of a success running Chariot MQTT Server may look like the following:
Additionally the Chariot MQTT Server Web UI can be accessed on port 8080. Navigate to the server's URL in a browser and verify that the EULA page is shown.
Stop the Chariot MQTT Server
Chariot daemon can be stopped by running the following script:
Uninstall the Chariot MQTT Server
The Chariot MQTT Server can be uninstalled by running the following script:
Installing Chariot MQTT Server (as non-superuser)
The following installation instructions assume you do not have superuser privileges. Superuser installation instructions can be found here. The Chariot MQTT Server can be installed on the Linux server by following these steps:
Create new user 'chariot'
Give user super user privileges
sudo usermod -aG sudo chariot |
Install unzip
sudo apt-get install unzip |
Switch User
Unzip Chariot
cd /opt
sudo unzip /tmp/chariot_linux.zip -d ./chariot |
Update scripts and config (if installing v2.0.0)
# The following updates are only necessary if installing Chariot v2.0.0 as a non-superuser. This is fixed and no longer required in later versions of Chariot.
# In /opt/chariot/chariot-common
In line 28 - Change the script that is called:
'queryDaemon.sh' to be 'queryDaemonNoPriv.sh'
# In /opt/chariot/yajsw/conf/wrapper.conf
Add the line:
wrapper.pidfile = /tmp/wrapper.chariot.pid |
Install Chariot
cd /opt/chariot
sudo /bin/bash ./install.sh |
Change ownership to be owned by chariot
sudo chown -R chariot:chariot /opt/chariot |
Log out of 'chariot' user
Remove chariot from sudo group
sudo deluser chariot sudo |
Log in as 'chariot' and start Chariot (as non-super user)
su chariot
/etc/init.d/chariot start |