This grading service accepts anonymous submissions for grading via HTTP. The submissions are graded either synchronously in the web application or asynchronously in containers (usually in Kubernetes, though it is possible to run Docker containers in the web server for a small number of submissions). The results are delivered to the calling system and the grader does not keep any record other than service logs. The grader is designed to serve exercises for the A+ learning system. If the number of submissions is large, we recommend setting up a Kubernetes cluster for the grader.

The grader is implemented on Django 2.2 (grader/settings.py). The application is tested on Python 3.7 and newer versions, but Python 3.5+ should also work.

The grader can be run stand alone without the full stack to test graders in the local system environment. The grader is designed to be extended for different courses and exercise types. Course and exercise configuration is in courses directory where further documentation and examples are available.

You may run the app with Docker without installing the whole software stack locally. It is easy to get started with the aplus-manual course: apluslms/aplus-manual. The Docker image is intended for local development and testing, not production: apluslms/run-mooc-grader.

Ubuntu 20.04

General requirements

sudo apt-get install git libjpeg-dev
sudo apt-get install libxml2-dev libxslt-dev zlib1g-dev

Install software

git clone https://github.com/apluslms/mooc-grader.git
mkdir mooc-grader/uploads

sudo apt-get install python3 python3-dev python3-pip python3-venv

Then, create virtual environment with grader requirements.

python3 -m venv venv
source venv/bin/activate
pip install wheel
pip install -r mooc-grader/requirements.txt

If you enable the gitmanager app in the MOOC-Grader (see the section "Django application settings for deployment"), you need to install its requirements in the (virtual) environment that it uses. It may use a different environment than the Django application.

pip install -r mooc-grader/requirements_gitmanager.txt
# If you need to use the old Sphinx version 1.6, then install this one instead:
pip install -r mooc-grader/requirements_gitmng_sphinx16.txt

Run the Django app locally:

cd mooc-grader
python manage.py runserver

The exercise configuration and grading of individual exercises can be tested from the command line.

python manage.py exercises
python manage.py grade

courses/README.md

Ubuntu 20.04

On a server, one can install mooc-grader for a specific grader user account.

sudo adduser --system --group \
  --shell /bin/bash --home /srv/grader \
  --gecos "A-plus mooc-gracer service" \
  grader
su - grader

Then follow the "Installing for development" and continue from here.

echo "d /run/grader 0750 grader www-data - -" | \
  sudo tee /etc/tmpfiles.d/grader.conf > /dev/null
sudo systemd-tmpfiles --create

Install uwsgi to run WSGI processes. The mooc-grader directory and user must be set in the configuration files.

source ~/venv/bin/activate
pip install uwsgi
cp ~/mooc-grader/doc/etc-uwsgi-grader.ini ~/grader-uwsgi.ini
sudo cp ~grader/mooc-grader/doc/etc-systemd-system-uwsgi.service /etc/systemd/system/grader-uwsgi.service
# EDIT ~/grader-uwsgi.ini
# EDIT /etc/systemd/system/grader-uwsgi.service, set the correct uwsgi path to ExecStart

Operate the workers:

# as root
systemctl status grader-uwsgi
systemctl start grader-uwsgi
systemctl enable grader-uwsgi  # start on boot
# Graceful application reload
touch ~grader/grader-uwsgi.ini

apt-get install nginx
sed -e "s/__HOSTNAME__/$(hostname)/g" \
  ~grader/mooc-grader/doc/etc-nginx-sites-available-grader > \
  /etc/nginx/sites-available/$(hostname).conf
ln -s ../sites-available/$(hostname).conf /etc/nginx/sites-enabled/$(hostname).conf
# Edit /etc/nginx/sites-available/$(hostname).conf if necessary
# Check nginx config validity
nginx -t
systemctl reload nginx

apt-get install apache2 libapache2-mod-uwsgi
# Configure based on doc/etc-apache2-sites-available-grader
a2enmod headers

When deploying, overwrite necessary configurations in mooc-grader/grader/local_settings.py.

If gitmanager is used to update course content via Git operations, enable it in local_settings.py:

ADD_APPS = (
'gitmanager',
)

gitmanager uses a database. If sqlite3 is used (in settings.py), it must be installed:

sudo apt-get install sqlite3 libsqlite3-dev

Django must install the database schema for the gitmanager (Python virtual environment must be activated):

python manage.py migrate

Note that if the file path of the Sqlite database is changed in local_settings.py, the same path must also be hardcoded in the code gitmanager/cron.sh.

The gitmanager requires a crontab for the grader account:

sudo crontab -u grader doc/gitmanager-crontab