A tool used to manage the FTS Seminar Series at Cardiff University's School of Computer Science and Informatics.
To install this package you will first have to install the dependencies recorded
in requirements.txt. These dependencies can be installed through
pip -r requirements.txt, note that pyldap has several external dependencies
that need to be installed prior to install -- libsasl2, libldap2, and libssl
(and associated development files) . These external dependencies can be
installed through your distributions package manager, for example using sudo apt install libsasl2-dev libldap2-dev libssl-dev.
Please examine FTSManager/FTSManager/settings.py, ensuring that a fresh secret
key is set, that email settings are correct, that STATIC_ROOT is set to a
location that your web server is serving as /static/. Additionally, the
hostname of the server needs to be added to the ALLOWED_HOSTS list.
Once dependencies are installed, and settings have been correctly defined
(contained in the FTSManager/settings.py file) the database can be initialised
by running python manage.py migrate, and static files can be collected for
serving by running python manage.py collectstatic.
FTS-Manager can be run through with the command python manage.py runserver --
if everything is working as it should be, then visiting http://localhost:8000
in a web browser should serve you with a blank FTS manager home page.
The preferred method for serving FTS-Manager in production is using wsgi, using
a server container such as uWSGI. Django provides a wsgi callable, accessible
through FTSManager.wsgi. An example uWSGI command for FTS-Manager would be:
uwsgi --socket 127.0.0.1:31337 --chdir /path/to/folder/containing/this/file/FTSManager --wsgi-file FTSManager/wsgi.py --master --threads 8
(example chdir path is /home/user/FTS-Manager/FTSManager -- note that the
FTSManager directory contains a subdirectory of the same name)
Having set up uwsgi, nginx/apache should be set up to proxy requests to 127.0.0.1:31337.
In order to populate FTS-Manager with LDAP users , please run
python manage.py sync_ldap. This will pre-populate all users of type
"Research Student" into Django's user database, allowing autocompletion of users
who have not yet logged in.
The final step is to configure cron to execute FTS-Manager periodic tasks.
This can be done by running the command python manage.py installtasks.
This will install a nightly cron to sync ldap users, and a minutely cron to send
reminder emails (where necessary). Check that crontab has been configured
properly by running crontab -l -- you should see two new entries ending in
#kronos :<string_of_hex>
In order to add users that are not marked as a "Research Student" in LDAP,
the management commmand python mange.py add_user <username> can be used.
Note that any user in the LDAP server is able to log in to FTS-Manager, and
add_user is only needed for adding talks on behalf of users that have never
signed in.