README.md

LabShare

Django Tool that helps everyone to get their fair share of GPU time.

Installation

1. clone repository
2. install requirements with pip install -r requirements.txt (make sure to use python 3!)
3. create database by running python manage.py migrate
4. run the test server with python manage.py runserver

Usage

1. create superuser by running python manage.py createsuperuser
2. deploy the device_query script on every machine that has a GPU that shall be monitored
3. create a new Device in the django admin for every device you want to monitor
4. after you've created the devices and deployed and started the device_query scripts you should run python manage.py update which will fill your database with information on the GPUs that each device has.
5. If you want to have updates regularly you should create a cron job that runs the update job every now and then.

Configuration

In order to make it possible for users to see the devices and their gpus you need to give each user the permission to do so! You can do this in one of the following ways:

1. Add the use_device permission to a group of your choice (for instance the default Staff group) and add users to the this group. this global permission allows each user in that group to use all GPUs in LabShare. This allows you to easily provide the necessary permission to each user.
2. For finegrained control you can control who can use which device, by adding the use_device permission to each user or a group in the permission admin of each device.