Installing the Numbas editor on Ubuntu¶
These are outline instructions on setting up the Numbas editor with a backend MySQL database.
The Numbas editor uses Django, a web framework written in the Python programming language. Django has many configuration options, which we won’t detail here. For more information, consult the Django documentation.
The following instructions are for a server running Ubuntu Xenial (16.04) or newer.
Essential package installation¶
Packages that would be installed as part of a standard Ubuntu install are not listed.
Install Apache, Git, Apache WSGI module, MySQL and Python 3 using the
apt-get install apache2 apache2-dev git-core mysql-server \ mysql-common python3 acl libmysqlclient-dev python-dev \ libapache2-mod-wsgi-py3 python-tk tcl-dev tk-dev
mod_wsgi, if it’s not already:
Rather than rely on the system-wide Python executable and libraries, a more flexible approach is to use virtualenv, which is a tool to create an isolated Python environment.
Create a user group which will have access to the virtualenv, and add yourself to it:
groupadd numbas usermod your_username -a -G numbas,www-data
You might need to start a new terminal, or log out and back in, for the group change to take effect.
apt-get install python3-pip
pip3 install virtualenv
Create the virtualenv in a suitable location:
mkdir /opt/python setfacl -dR -m g:numbas:rwx /opt/python virtualenv /opt/python/numbas-editor
Activate the virtualenv:
(This ensures that subsequent python packages are installed in this isolated environment, and not in the system environment.)
Open the MySQL client:
Create a MySQL database called
create database numbas_editor;
Create a database user and grant privileges on
numbas_editordatabase, with a password of your choice:
grant all privileges on numbas_editor.* to 'numbas_editor'@'localhost' identified by 'password';
Create directories and set permissions¶
Create the following directories outside the web root, so they’re not accessible to the public:
mkdir /srv/numbas mkdir /srv/numbas/compiler mkdir /srv/numbas/media mkdir /srv/numbas/previews mkdir /srv/numbas/static
Set the correct ownership and permissions:
cd /srv/numbas chmod 2770 media previews chmod 2750 compiler static chgrp www-data compiler media previews static setfacl -dR -m g::rwX media previews setfacl -dR -m g::rX compiler static
Clone the editor and compiler repositories¶
Clone the Numbas repository:
git clone git://github.com/numbas/Numbas /srv/numbas/compiler
Clone the editor under the webroot directory:
git clone git://github.com/numbas/editor /srv/www/numbas_editor
Install the Python module dependencies of the editor (in the virtualenv):
pip install -r /srv/www/numbas_editor/requirements.txt pip install -r /srv/numbas/compiler/requirements.txt pip install mysqlclient mod_wsgi
Run the “first setup” script:
This will configure the editor based on your answers to a few questions, and write the file
If you’ve been following these instructions exactly, you can accept the defaults for each question.
If you make any mistakes, you can run the script again, or edit
Create the apache config file and enable the site.
/etc/apache2/sites-available/numbas_editor.confwith contents similar to that in
this prepared config file. If following these instructions exactly, then you only need to change the lines containing
Enable the configuration:
a2ensite numbas_editor.conf service apache2 reload
Point a web browser at the server hosting the editor.
To keep the editor up to date, run the following script:
source /opt/python/numbas-editor/bin/activate cd /srv/numbas/compiler git pull origin master pip install -r requirements.txt cd /srv/www/numbas_editor git pull origin master python manage.py migrate python manage.py collectstatic --noinput pip install -r requirements.txt touch web/django.wsgi
Note that if any changes are made to the editor code, including
editing the settings files, then for the web server to recognise
these changes you must either run the command
or restart the Apache server.