Setup

Help

To display the help section for the setup.py

python setup.py help

Migrate test settings

In order to use the test settings to access localhost services for the project the test_settings.py files must be moved to settings.py.

Note: This will overwrite all your settings.py files

python setup.py test_settings

Install external programs

Open the build/settings.py file and alter the file paths to where you want the external programs to be installed on your operating system. Ensure you change the correct settings for your operating system.

python setup.py externals

You can optionally choose to only install a selection of services using the -s argument.

python setup.py externals -s list,of,services

Database Setup

This is only required if you are creating a local database for testing (only required for database development)

The mysql installation needs to be callable/available from the command prompt you are using, and the mysql service needs to be running (e.g. sudo /etc/init.d/mysql start on linux).

You also need to set-up the test user in the database via:

# this assumes you are in the repository root
sudo mysql < build/database/reset_autoreduction_db.sql

python setup.py database

Start services

To start activemq do

python setup.py start

On Linux and if using virtualenv as per installation instruction then need to do sudo /home/#user#/autoreduction/venv3/bin/python setup.py start where #user# is your username.

To start the Queue Processors please see https://github.com/ISISScientificComputing/autoreduce/tree/master/queue_processors.

Starting the web app

Once you've got the DB, you can start up the Web App.

Make sure you are in WebApp/autoreduction_webapp -> it should contain a manage.py file Then you can do:

python manage.py runserver

and in the output it will tell you at what hostname / port you can find the app. Mind that you might have to port forward to see it locally, or go to your workstations' hostname:port. Some software will port-forward for you automatically (such as VSCode) if using the integrated terminal and click the link from it.