Installation

GET a WAVES web-app online following the next few steps, WAVES can run on Apache, Nginx with uWSGI

Warning

To run WAVES, it’s strongly recommended that you setup a dedicated user, because WAVES run with saga-python, and this module need to create some directories you might not be able to create (.radical and .saga) with another user (such as www-data)

0. Prerequisites

Note

In order to install WAVES you will need:
  • python 2.7.X (WAVES should be compatible with python 3.5 but not fully tested)
  • pip package manager
  • A web server: Apache or NGINX
  • A database backend (Mysql or Postgres) but WAVES could run with sqlite DB
0.1 Get the sources:
0.2 Create virtual env:
  • $ cd [waves_dir]
  • [waves_dir]$ virtualenv .venv
  • [waves_dir]$ source .venv/bin/activate
  • (.venv)[waves_dir]]$ pip install -r requirements.txt

1. Install WAVES

1.1 Configuration files:
  • WAVES env configuration file:
    • (.venv)[waves_dir]/src/$ cd waves_services/settings

    • (.venv)[waves_dir]/src/waves_services_settings/$ cp local.sample.env local.env

    • minimal setup requires these parameters:
      • SECRET_KEY=your-secret-key-to-keep-secret
      • REGISTRATION_SALT=generate-your-key
      • ALLOWED_HOSTS=your-host-name
    • you can set up as well your db connection params here

  • (Optional) WAVES specific settings: some useful parameters can be set up your conf:
    • (.venv)[waves_dir]$ cd src/waves/config/
    • (.venv)[waves_dir]/config$ cp waves.env.sample waves.env
    • Uncomment/Edit your waves.env file to set your specific WAVES parameters
1.2 Set up database:
  • Create your database: (.venv)[waves_dir]/src/$ ./manage.py migrate
  • (optional) load sample data: (.venv)[waves_dir]/src/$ .manage.py loaddata waves/fixtures/init.json
  • Create Superadmin user: (.venv)[waves_dir]/src/$ ./manage.py createsuperuser
  • Create staticfiles: (.venv)[waves_dir]/src/$ ./manage.py collecstatic
  • Check parameters with: (.venv)[waves_dir]/src/$ ./manage.py check
  • See your configuration with: (.venv)[waves_dir]/src/$ ./manage.py wavesconfig

2. Configure your web server:

2.1 UWSGI:

See also

Init script is available in src/waves/config/uwsgi.conf in order to automatically start WAVES on server start-up

2.1 APACHE:
  • Sample file is located under src/waves/config/waves.apache.conf.sample
  • Rename/Edit according to your settings
  • Add it to Apache enabled conf
2.2 NGINX:
  • Sample file is located under src/waves/config/waves.nginx.conf.sample
  • Rename/Edit according to your settings
  • Add it to nginx enabled conf