INSTALL

ThunderstormDistributor Install Instructions

Requirements: Qt 5.0+, gcc, Linux (Kernel 2.6.18+)

ThunderstormDistributor Software Install

First, install the necessary packages, Qt 5.0+, gcc, and nginx (for the stats viewer)

For Ubuntu, this is:

:::bash
apt-add-repository ppa:ubuntu-sdk-team/ppa -y
apt-get install nginx qt5-default qtdeclarative5-dev build-essential

Or alternatively, go to: http://qt-project.org/ and install manually

Next, you can use the provided compile_install.bash script to compile and install ThunderstormDistributor on your system:

:::bash
tar -xzf tsdistributor_....tar.gz
./TSDistributor-Release/compile_install.bash

Or create a TSDistributor-Release directory at the same level as the TSDistributor source folder, then run compile_install.bash from there.

It is designed for use on Ubuntu, but should work on standard linux distributions

Nothing different is required for worker or supervisor machines, except the statistics viewer

In addition, a system configuration file should be installed to:

:::bash
cp ~/TSDistributor/global.conf /etc/tsdistributor/

Optionally, you can copy the provided scripts to /usr/bin or add them to your path for convenience. For example, 'tsub' instead of 'TSDistributor --submit'

Manual Compile:

Extract/download code to TSDistributor folder

:::bash
mkdir TSDistributor-Release
cd TSDistributor-Release
qmake -spec linux-g++ -o Makefile ../TSDistributor/TSDistributor.pro
make

By default, the ThunderstormDistributor program and the provided scripts are copied into /usr/bin/ (when the compile_install.bash script is used.)

No further install steps besides compilation and the global configuration file are necessary.

ThunderstormDistributor Statistics Viewer Install

This is optional, and only needs to be performed on the supervisor/master machine.

Copy all provided files in the TSDistributor/tsstatswww folder to /tsstatswww/

Then, copy the provided nginx_default to /etc/nginx/sites-available/default
Or, add a server deinition to an already-existing server with /tsstatswww as the root - no scripting needed (PHP, Perl, Python, etc.)