Page History

Prerequisites

• Have a computer/server running Linux (recommended: Ubuntu 18.04 LTS or newer)
• Have a copy Download the required version of the latest  Chariot MQTT Server zip file found here:.
  • Chariot Downloads

...

...

...

The instructions below detail Installing (as superuser), Installing (as non superuser), Starting, Stopping and Uninstalling the Chariot MQTT Server.

Anchor
install-chariot-linux-superuser install-chariot-linux-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:

...

Installing Chariot MQTT Server (as superuser)

1. Using the file transfer method of

...

1. your choice, transfer the Chariot MQTT Server zip file to the Linux server

...

1. . From a command prompt, run the unzip command on the file. For example, unzip the files into a directory named Chariot

   Code Block

...

1. unzip ./chariot_linux.zip -d ./Chariot

...

1. 
   

2. From the command prompt, run the Chariot service install script

...

1. in the directory where the

...

1. files were unzipped.

   Code Block

...

1. /bin/bash ./install.sh

...

1. Image Modified

   
   

2. 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

$ /etc/init.d/chariot start

Verify the Chariot MQTT Server installation

The status of the Chariot MQTT Server can be obtained by running the following script

...

1. .

...

An example of a success running Chariot MQTT Server may look like the following:

Image Removed

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 Removed

Stop the Chariot MQTT Server

Chariot daemon can be stopped by running the following script:

$ /etc/init.d/chariot stop

Uninstall the Chariot MQTT Server

The Chariot MQTT Server can be uninstalled by running the following script:

$ ./uninstall.sh

...

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'

sudo adduser chariot

...

Installing Chariot MQTT Server (as non-superuser)

1. Using the file transfer method of your choice, transfer the downloaded Chariot MQTT Server zip file to the server.
   
   

2. From a command prompt, create a new user 'chariot' and give the user super user privileges

   Code Block
   language bash
   sudo adduser chariot sudo usermod -aG sudo chariot

...

1. 
   

2. From the command prompt, install the unzip utility.

   Code Block
   language bash
   sudo apt-get install unzip

...

1. 
   

2. From the command prompt, switch user to the 'chariot' user

   Code Block
   language bash
   su chariot

...

1. 
   

2. From the command prompt, run the unzip command on the file. For example, unzip the files into a directory named Chariot

   Code Block
   language bash

...

1. 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

...

1. 
   

2. From the command prompt, run the Chariot service install script in the directory where the files were unzipped.

   Code Block
   language bash

...

1. sudo /bin/bash ./install.sh

...

1. 
   

2. 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
   language bash
   sudo chown -R chariot:chariot

...

1. /chariot

...

Log out of 'chariot' user

...

1. ctrl + d

...

Remove chariot from sudo group

...

1. sudo deluser chariot sudo

...

1. su chariot

   
   

2. The Chariot MQTT Server should now be installed in the Linux server and will run automatically when the server is booted.

   
   

1. From a command prompt, run the Chariot service start script in the directory where the service was installed.

   Code Block
   /etc/init.d/chariot start

   
   

2. Verify the Chariot service is running. From a command prompt, run the Chariot service status script in the directory where the service was installed.

   Code Block
   ./status.sh

   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

Anchor
Stopping Stopping

Stopping the Chariot MQTT Server

1. From a command prompt, run the Chariot service stop script in the directory where the service was installed.
   
   

Log in as 'chariot' and start Chariot (as non-super user)

su chariot
/etc/init.d/chariot startstop

Anchor
Uninstalling Uninstalling

Uninstalling the Chariot MQTT Server

1. From a command prompt, run the Chariot service uninstall script in the directory where the service was installed.
   
   

./uninstall.sh