LabAdmin

Labadmin is a Django application created to manage user rights to access the lab and the machines.

In this Readme you can follow the tutorial to set it up on a PC or Raspberry Pi. If you go in the Client folder you'll be able to access the different clients you can use with Labadmin

Installation

If you are going to deploy labadmin from scratch on a new Django installation you have three choices:

• follow the Tutorial
• use the Ansible role
• use docker

pip package

This repo is ready to generate a pip package. Follow the instructions here to get it published.

tl;dr

check dependencies, install twine (do it once):

python3 -m pip install --user --upgrade setuptools wheel
python3 -m pip install --user --upgrade twine

Every time you have a new build, generate package:

python3 setup.py sdist bdist_wheel

and upload:

python3 -m twine upload dist/*

Upgrade to a newer release

Before upgrading please read the release notes posted for each release on github. They may contain changes you have to do on your Django project configuration.

First we are installing the latest release from github:

cd /var/www/labadmin/labadmin
sudo -H -u labadmin ../venv/bin/pip install <url of labadmin release from github.zip>

After that you'll have to do any project settings update as described in the release notes.

Then you have to execute any eventual data migration with the migrate command and update the static files with collectstatic:

sudo -H -u labadmin ../venv/bin/python manage.py migrate
sudo -H -u labadmin ../venv/bin/python manage.py collectstatic

As a last step you have to restart the labadmin service to load the new code:

sudo service labadmin restart

Settings

The optional MQTT integration has the following settings overridable in settings.py:

LABADMIN_MQTT_CONFIG = {
    'HOSTNAME': 'localhost',
    'PORT': 1883,
    'AUTH': None,
    'TLS': None,
    'PROTOCOL': MQTTv311,
    'TRANSPORT': 'tcp',
}

# Should we publish on MQTT each entrance
LABADMIN_NOTIFY_MQTT_ENTRANCE = False

# The MQTT topic where to publish
LABADMIN_MQTT_ENTRANCE_TOPIC = 'labadmin/entrance'

See Paho MQTT documentation for LABADMIN_MQTT_CONFIG values.