This page gives an overview of the Equipment Sharing, describing its current status, where and how it's developed and deployed, and who is responsible for maintaining it.
This is the University of Cambridge research facilities and equipment searchable database. This allows University members to search entries in the Research Facilities and Equipment Database
The Equipment Sharing is currently live.
Technical queries and support should be directed to development team 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 development team rather than reaching out to team members directly.
Issues discovered in the service or new feature requests should be opened as GitLab issues in the application repository.
The Equipment Sharing is currently deployed to the following environments:
|Production||admin app: https://www.equipment.admin.cam.ac.uk/esd-admin/
web front-end : https://www.equipment.admin.cam.ac.uk/
The source code for the Equipment sharing is can be found on Gitlab repository:
The following gives an overview of the technologies the Equipment Sharing is built on.
|Front end||PHP||Symfony, Guzzle, Capifony Composer|
The following gives an overview of how the Equipment Sharing is deployed and maintained.
How and where the Equipment Sharing is deployed¶
Deploying web service, copy equipshare .war file to tomcat installation location:
restart tomcat :
systemctl restart tomcat.service
Deploying a php front end¶
Through Capifony on saw. (For example, inside /home/httpd/capifony/equipment execute “cap prod deploy”.)
Logging - locations, levels Apps logs (Monolog) to /home/httpd/www.equipment.admin.cam.ac.uk/shared/app/logs. Probably should be log-rotated as it will fill up over time.
Other operation issues¶
As the Research Facilities and Equipment Database web service is a bit broken, there are some workarounds in the code:
- When something doesn’t exist a 200 response is returned with an empty body, BrokenResponseListener converts this in a 404.
- A load of data in the database is broken (eg phone numbers like 00000 000000, email addresses like firstname.lastname@example.org), so the
MisdEquipmentSharingDataCleaningBundletries to tidy it up.
See also http://jira.devtools.admin.cam.ac.uk/browse/ESWEB.
Service Management and tech lead¶
The service owner for the Equipment Sharing is TBD.
The service manager for the Equipment Sharing is TBD.
The tech lead for the Equipment Sharing is TBD.
The following engineers have operational experience with the Equipment Sharing and are able to respond to support requests or incidents:
- engineer name TBD
- engineer name TBD