Prerequisites
- Have a computer/server running Linux (recommended: Ubuntu 18.04 LTS or newer)
- Download the required version of the Chariot MQTT Server zip file
Warning |
---|
If Upgrading Chariot to a Newer Version please review this tutorial. |
The instructions below detail Installing (as superuser), Installing (as non superuser), Starting, Stopping, Restarting and Uninstalling the Chariot MQTT Server.
Anchor |
---|
| install-chariot-linux-superuser |
---|
| install-chariot-linux-superuser |
---|
|
Installing Chariot® MQTT Server (as superuser)Using the file transfer method of your choice, transfer the Chariot MQTT Server zip file to the Linux server. From a command prompt, run the unzip command on the file. For example, unzip the files into a directory named Chariot
Code Block |
---|
unzip ./chariot_linux.zip -d ./Chariot |
From the command prompt, run the Chariot service install script in the directory where the files were unzipped.
Code Block |
---|
/bin/bash ./install.sh |
Image Added
The Chariot MQTT Server should now be installed in the Linux server and will run automatically when the server is booted.
Anchor |
---|
| install-chariot-linux-non-superuser |
---|
| install-chariot-linux-non-superuser |
---|
|
Installing Chariot MQTT Server (as non-superuser)
Using the file transfer method of your choice, transfer the downloaded Chariot MQTT Server zip file to the server.
From a command prompt, create a new user 'chariot' and give the user super user privileges
Code Block |
---|
|
sudo adduser chariot
sudo usermod -aG sudo chariot |
From the command prompt, install the unzip utility.
Code Block |
---|
|
sudo apt-get install unzip |
From the command prompt, switch user to the 'chariot' user
From the command prompt, run the unzip command on the file. For example, unzip the files into a directory named chariot
Code Block |
---|
|
sudo unzip /tmp/chariot_linux.zip -d ./chariot |
From the command prompt, run the Chariot service install script in the directory where the files were unzipped.
Code Block |
---|
|
cd chariot
sudo /bin/bash ./install.sh |
From the command prompt, change ownership to 'chariot', log out of the 'chariot' user, remove 'chariot' from the sudo group and log in as 'chariot'
Code Block |
---|
|
cd ..
sudo chown -R chariot:chariot ./chariot
exit
sudo deluser chariot sudo
su chariot |
The Chariot MQTT Server should now be installed in the Linux server and will run automatically when the server is booted.
Starting the Chariot MQTT ServerFrom a command prompt, run the Chariot service start script in the directory where the service was installed.
For Chariot versions prior to 2.4.1
Code Block |
---|
/etc/init.d/chariot start |
For Chariot versions 2.4.1 and newer
Code Block |
---|
systemctl start chariot |
Verify the Chariot service is running. From a command prompt, run the Chariot service status script in the directory where the service was installed.
The status returned will be: INSTALLED, NOT INSTALLED or RUNNING.
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.Image Added
Stopping the Chariot MQTT ServerFrom a command prompt, run the Chariot service stop script in the directory where the service was installed.
For Chariot versions prior to 2.4.1
Code Block |
---|
/etc/init.d/chariot stop |
For Chariot versions 2.4.1 and newer
Code Block |
---|
systemctl stop chariot |
Restarting the Chariot MQTT ServerFrom a command prompt, run the Chariot service restart script in the directory where the service was installed
For Chariot versions prior to 2.4.1
Code Block |
---|
/etc/init.d/chariot restart |
For Chariot versions 2.4.1 and newer
Code Block |
---|
systemctl restart chariot |
Uninstalling the Chariot MQTT Server- From a command prompt, run the Chariot service uninstall script in the directory where the service was installed.