Page History

...

• 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:.
  • https://chariot-releases.s3.amazonaws.com/2.0.0-beta1/chariot_linux.zip

...

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

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

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

...

1. bin/bash ./install.sh

An example of a success installation may look like the following:

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

$ ./daemonStart.sh

Verify the Chariot MQTT Server installation

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

$ ./status.sh

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:

$ ./daemonStop.sh

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

Install Chariot

1. 
   

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

   Code Block
   language bash
   cd

...

1. chariot 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
   cd .. sudo chown -R chariot:chariot

...

1. ./chariot exit sudo deluser chariot sudo 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.
   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

   
   

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

From 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

/etc/init.d/chariot stop

For Chariot versions 2.4.1 and newer

systemctl stop chariot

From 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

Log out of 'chariot' user

ctrl + d

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 startrestart

For Chariot versions 2.4.1 and newer

systemctl restart chariot

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

./uninstall.sh