Lookup¶
This page gives an overview of the Lookup service, describing its current status, where and how it's developed and deployed, and who is responsible for maintaining it.
Service Description¶
Lookup provides an directory of University staff, institutions and groups available via LDAP (Uni only) or a web API.
Service Status¶
Lookup 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.
Queries regarding correctness or completeness of data should be sent to servicedesk@uis.cam.ac.uk.
Issues discovered in the service or new feature requests should be opened as GitLab issues here.
Environments¶
Lookup is currently deployed to the following environments:
| Name | URL | Supporting VMs |
|---|---|---|
| Production | https://www.lookup.cam.ac.uk | dingo.csi.cam.ac.uk |
| wolf.csi.cam.ac.uk | ||
| ldap{1,2}.lookup.cam.ac.uk (HA LDAP endpoints) | dingo.csi.cam.ac.uk | |
| wolf.csi.cam.ac.uk | ||
| https://ldap.lookup.cam.ac.uk (live LDAP endpoint) | dingo.csi.cam.ac.uk | |
| lookup-live-db.srv.uis.private.cam.ac.uk | lookup-live-db.srv.uis.private.cam.ac.uk | |
| wolf.csi.cam.ac.uk | ||
| Staging | https://lookup-test.csx.cam.ac.uk | jodrell.csx.cam.ac.uk |
| lookup-test.csx.cam.ac.uk (test LDAP endpoint) | jodrell.csx.cam.ac.uk | |
| New RHEL | N/A | lookup-live1.srv.uis.private.cam.ac.uk |
| VMs | lookup-live2.srv.uis.private.cam.ac.uk |
Source code¶
The source code for Lookup is spread over the following repositories:
| Repository | Description |
|---|---|
| Application Server | The source code for the main application server |
| Lookup API Client | API Client |
Technologies used¶
The following gives an overview of the technologies Lookup is built on.
| Category | Language | Framework(s) |
|---|---|---|
| Server | Java + Groovy | Grails 1.3.10 |
| DB | Postgres | 12.4 |
Operational documentation¶
The following gives an overview of how Lookup is deployed and maintained.
How and where Lookup is deployed¶
Deployed using RPM packages from the Bes RPM repository.
A video recording of a deployment is available (DevOps only).
Deploying a new release¶
RPM packages are built by gitlab CI.
Other documentation¶
Monitoring¶
Lookup is monitored by nagios:
Debugging¶
The Lookup server readme contains details on running a local copy for debugging.
Service Management and tech lead¶
The service owner for Lookup is currently unknown. See the associated GitLab issue.
The service manager for Lookup is Currently vacant.
The tech lead for Lookup is Monty Dawson.
The following engineers have operational experience with Lookup and are able to respond to support requests or incidents: