FAQ | This is a LIVE service | Changelog

Commit da64db13 authored by Sam Wenham's avatar Sam Wenham
Browse files

Update tokens page for new deployment

parent 90373ea0
Pipeline #176571 passed with stage
in 29 seconds
......@@ -27,9 +27,10 @@ The Network Access Tokens service is currently deployed to the following environ
| Name | URL | Supporting VMs |
| ----------- | ------------------ | --------------- |
| Production | [https://tokens.uis.cam.ac.uk](https://tokens.uis.cam.ac.uk) | tokens-node1.csi.private.cam.ac.uk|
| | | tokens-node2.csi.private.cam.ac.uk|
| | | tokens-nodeq.csi.private.cam.ac.uk|
| Production | [https://tokens.uis.cam.ac.uk](https://tokens.uis.cam.ac.uk) | tokens-live1.srv.uis.private.cam.ac.uk|
| | [https://uis-tm-live.tokens.uis.cam.ac.uk/](https://uis-tm-live.tokens.uis.cam.ac.uk/)| tokens-live2.srv.uis.private.cam.ac.uk|
| Staging | [https://uis-tm-test.tokens.uis.cam.ac.uk/](https://uis-tm-test.tokens.uis.cam.ac.uk/) | tokens-test1.srv.uis.private.cam.ac.uk |
| | | tokens-test2.srv.uis.private.cam.ac.uk |
## Source code
......@@ -38,6 +39,7 @@ The source code for the Network Access Tokens service is spread over the followi
| Repository | Description
| ----------- | ------------------ |
| [Application Server](https://gitlab.developers.cam.ac.uk/uis/devops/network-access/network-access) | The source code for the main application server |
| [Ansible](https://gitlab.developers.cam.ac.uk/uis/devops/grails-application-ansible-deployment) | The Ansible used to deploy all the Dev Group Grails Apps |
## Technologies used
......@@ -46,23 +48,24 @@ The following gives an overview of the technologies the Network Access Tokens se
| Category | Language | Framework(s) |
| -------- | -------- | --------- |
| Server | Groovy 2.4.12 | Grails 1.3.10 |
| DB | Postgres | 10.5 |
| DB | Postgres | 13 |
## Operational documentation
The following gives an overview of how the Network Access Tokens service is deployed and maintained.
### How and where the Network Access Tokens service is deployed
The Network Access Tokens service application is deployed using RPM packages. These are built by Gitlab CI in the [Application Server repository](https://gitlab.developers.cam.ac.uk/uis/devops/network-access/network-access). These can be copied to the [Bes RPM package repository](https://bes.csi.cam.ac.uk) run by infra-sas@uis by following these [instructions](https://wiki.cam.ac.uk/ucs/Bes_-_Managed_Installation_Service#How_to_add_SLES_10.2F11_or_RHEL_.28S.29RPMS_to_Bes). As a last resort RPMs can be manually copied and installed.
The Network Access Tokens service application is deployed using WAR packages. These are built by Gitlab CI in the [Application Server repository](https://gitlab.developers.cam.ac.uk/uis/devops/network-access/network-access). These are deployed using the Ansible above
### Deploying a new release
Once the RPM packages are added to the [Bes RPM package repository](https://bes.csi.cam.ac.uk) running `zypper in <package name>` will install, if the package is an upgrade, `zypper up` should upgrade the package(s).
Once the WAR packages are built they can be deployed using the Ansible. See the Ansible docs for information on how to.
### Monitoring
The Network Access Tokens service is monitored by [nagios](https://nagios.uis.cam.ac.uk/nagios/).
There is also a [status page](https://tokens.uis.cam.ac.uk/adm/status) that checks the various components of the service and returns 200 if everything is functioning normally.
There is a [liveness](https://tokens.uis.cam.ac.uk/adm/liveness) page used by the traffic manager to determine live nodes.
## Other documentation
* [End user documentation](https://help.uis.cam.ac.uk/service/network-services/tokens)
......@@ -80,3 +83,5 @@ The following engineers have operational experience with the Network Access Toke
respond to support requests or incidents:
* [Steve Ison](https://www.lookup.cam.ac.uk/person/crsid/si202)
* [Sam Wenham](https://www.lookup.cam.ac.uk/person/crsid/sdw37)
* [Adam Deacon](https://www.lookup.cam.ac.uk/person/crsid/ad2931)
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment