Installation

This section describes how to install Rundata-net on your own computer or server from scratch. Note that this may not not be needed for ordinary users. Rundata-net has different installation environments:

  • development

  • production

Dependencies differ somewhat between these environments. All the dependencies are listed in the corresponding files in the requirements directory.

Setting up the development version in Ubuntu 16.04 (64-bit)

This is a step-by-step guide for setting up a development version of Rundata-net on a clean Ubuntu 16.04. With minor modifications this guide might work with other Ubuntu flavour versions as well as with Linux flavours.

Running Rundata-net is similar to running any other Django project. If you are familiar with Django, you will already know the content of this guide. A similar guide, which provides a bit more details about individual commands, is provided by Digital Ocean.

  1. Update your system:

    $ sudo apt-get update
    $ sudo apt-get upgrade
    
  2. Install the git:

    $ sudo apt-get install git
    
  3. Get the latest sources from https://gitlab.com/fralik/rundata-net. Clone the repository using git:

    $ git clone https://gitlab.com/fralik/rundata-net.git
    
  4. Install dependencies:

    $ cd rundata-net
    $ chmod a+x utility/install*.sh
    $ sudo utility/install_os_dependencies.sh install
    $ sudo -H pip3 install virtualenv
    $ virtualenv rundata_venv
    $ source rundata_venv/bin/activate
    $ utility/install_python_dependencies.sh
    
  5. Adjust the settings to your needs. This may be done by way of environment variables. Here I show how to do it for Bash. Replace <some_path> with the path to rundata-net on your system. Alternatively, this can be any path on your system. We will be using a SQLITE database for simplicity’s sake, but you are free to use any other supported database:

    $ export DATABASE_URL=sqlite:///<some_path>/django.sqlite3
    

    For example:

    $ export DATABASE_URL=sqlite:////home/vadim/rundata-net/django.sqlite3
    
  6. Run database migrations:

    $ python manage.py migrate
    
  7. Run development server:

    $ python manage.py runserver
    
  8. Open your browser and go to http://127.0.0.1:8000. You should now see Rundata-net.

Note that we used virtualenv to install the Python dependencies. You should repeat the source rundata_venv/bin/activate command each time you want to run Rundata-net.