Install on Ubuntu 16.04 LTS (Xenial)

Single Machine Install

  1. Install a basic Ubuntu 16.04 “Server” Linux system.

    Available from

    If you have a newer version it should work fine, but hasn’t specifically been tested yet, let us know! 32/64 bits doesn’t matter. 64bit is recommended for a server unless you’re low on RAM, in which case 32 might be slightly more compact.

    Don’t install any extras unless you need them for something else. OpenSSH Server is a good idea for remote management.

  2. Create an account for OASIS to run under.

    When prompted for a Full Name, “OASIS Web Application” will do:

    adduser --disabled-login --disabled-password oasisqe
  3. Setup the main OASIS code

    It is possible to install OASIS elsewhere if you like, you will have to change the paths in various configuration options later:

    mkdir -p /opt/oasisqe
    cd /opt/oasisqe
    tar -zxf oasis3.9_latest.tgz
  4. Install dependencies

    as the root user:

    cd /opt/oasisqe/3.9
    sh deploy/
  5. Set up the OASIS database

    Choose a password for the database. You will not have to type this in often, it will go in configuration scripts, so pick something quite complex and secure. “createuser” will prompt you for this password. The database user does not need to be a superuser or to create new roles:

    su postgres
    createuser oasisdb -d -l -P
    createdb -O oasisdb oasisdb
    psql -Uoasisdb -h localhost -W oasisdb < /opt/oasisqe/3.9/deploy/emptyschema.sql
  6. Setup OASIS working space and logs

    as the ‘root’ user again:

    mkdir -p /var/cache/oasisqe/v3.9
    chown oasisqe /var/cache/oasisqe
    mkdir /var/log/oasisqe
    chown oasisqe /var/log/oasisqe
  7. Setup the main OASIS configuration file

    You can use VI or some other editor instead of nano, if you like. Go through the file and fill in the various values appropriately. The main ones you will need to change are the email addresses, the database password, and the URL. Most of the other defaults are fine:

    cp /opt/oasisqe/3.9/deploy/sampleconfig.ini /etc/oasisqe.ini
    nano /etc/oasisqe.ini
  8. Setup Apache to serve OASIS.

    This configuration file tells Apache where to find the (default) OASIS install:

    cp /opt/oasisqe/3.9/deploy/apacheconfig.sample /etc/apache2/sites-available/oasisqe
    a2ensite oasisqe

    If you have changed any of the paths in the OASIS configuration file, you may need to also change them in the apache confiration file:

    nano /etc/apache2/sites-available/oasisqe
  9. Restart Apache.

    Ask Apache to reload its configuration:

    service apache2 reload

    OASIS should now be available at the URL you configured.

  10. Reset the Admin password

    If you forget it you can perform this step again and it will reset it again:


    You should now be able to log in as the user “admin”, with the password given to you above.

  11. Setup daily schedule

    OASIS needs to run a daily task that does things like update statistics and synchronize user information with external systems:

    crontab -e -u oasisqe

    add the line:

    # m h  dom mon dow   command
    0 7 * * * /opt/oasisqe/3.9/bin/run_daily

    This will run the task at 7am every morning. You can choose another time if you wish.


Apache errors (Internal Server Error 500) should show up in: