Skip to content

University Training Booking System

[Team | Holberton Team] [Tech Lead | prb34] [Service Owner | mg356] [Service Manager | mg356] [Product Manager | TBC]

This page gives an overview of the University Training Booking System (UTBS), describing its current status, where and how it's developed and deployed, and who is responsible for maintaining it.

Service Description

The UTBS provides an admin and booking system for training events to various University institutions.

Service Status

The UTBS is currently live.

Contact

Technical queries and support should be directed to servicedesk@uis.cam.ac.uk and will be picked up by a member of the team working on the service. To ensure that you receive a response, always direct requests to servicedesk@uis.cam.ac.uk rather than reaching out to team members directly.

Issues discovered in the service or new feature requests should be opened as GitLab issues here.

Environments

The UTBS is currently deployed to the following environments:

Name URL Supporting VMs
Production https://training.cam.ac.uk utbs-live1.srv.uis.private.cam.ac.uk
https://uis-tm-live.training.cam.ac.uk/ utbs-live2.srv.uis.private.cam.ac.uk
utbs-live-db.srv.uis.private.cam.ac.uk
Training https://training.training.cam.ac.uk utbs-train1.srv.uis.private.cam.ac.uk
https://uis-tm-train.training.cam.ac.uk/ utbs-train2.srv.uis.private.cam.ac.uk
devgroup-test-db.srv.uis.private.cam.ac.uk (pending migration)
Staging https://uis-tm-test.training.cam.ac.uk/ utbs-test1.srv.uis.private.cam.ac.uk
utbs-test2.srv.uis.private.cam.ac.uk
utbs-dev-db.srv.uis.private.cam.ac.uk

The training environment is used to train users of the system.

Source code

The source code for the UTBS is spread over the following repositories:

Repository Description
Application Server The source code for the main application server.
UTBS API client utbs-client provides Java, Python and PHP client code for accessing the UTBS web service API.
Ansible The Ansible used to deploy all the Dev Group Grails Apps

Technologies used

The following gives an overview of the technologies the UTBS is built on.

Category Language Framework(s)
Web Application Groovy 2.4.12 Grails 1.3.10
DB Postgres 16 (except Training site where upgrade is pending)

Operational documentation

The following gives an overview of how the UTBS is deployed and maintained.

How and where the UTBS is deployed

Deploying a new release

The UTBS application is deployed using WAR packages. These are built by Gitlab CI in the Application Server repository. These are deployed using the Ansible above

Monitoring

The UTBS is monitored by the UIS infra-sas nagios service.

Sevices currently monitored:

  • ping - standard nagios ping check.
  • SSL - checks for a valid TLS certificate on port 8443.
  • https_devgroup - checks for a 200 response from the /adm/status page on port 8443.
  • disc-space - checks for at least 15% free disk space.
  • colocation-check - checks that all resources are located in distinct locations.

There is also a check for a valid TLS certificate being served by the traffic manager for https://uis-tm-live.training.cam.ac.uk/

Backups

See legacy application backups

Debugging

A docker development environment is available.

Service Management

The Team responsible for this service is Holberton Team.

The Tech Lead for this service is prb34.

The Service Owner for this service is mg356.

The Service Manager for this service is mg356.

The Product Manager for this service is TBC.

The following engineers have operational experience with this service and are able to respond to support requests or incidents:

System Dependencies

Contact Addresses