FAQ | This is a LIVE service | Changelog

Skip to content
Snippets Groups Projects
Commit fa6f0d23 authored by Monty Dawson's avatar Monty Dawson :coffee:
Browse files

Merge branch 'issue-79-update-sms' into 'master' 

Updated SMS page with format from service template.

Closes #79

See merge request !57
parents 9c14b91f 5e5babc5
No related branches found
No related tags found
1 merge request!57Updated SMS page with format from service template.
Pipeline #73179 passed
Stage: test
Hide whitespace changes
Inline Side-by-side
docs/services/streaming-media.md
+ 93
− 51
View file @ fa6f0d23
# Streaming Media Service
This page documents key information about the Streaming Media Service service.
Environments and Servers they run on
------------------------------------
- [Production](https://sms.cam.ac.uk)
- sms-node1.sms.cam.ac.uk (web app and DB)
- sms-node2.sms.cam.ac.uk (web app and DB)
- smew.sms.csx.cam.ac.uk (downloads)
- goldeneye.sms.csx.cam.ac.uk (downloads)
- sms-nfs1.sms.private.cam.ac.uk (ceph->nfs gateway)
- sms-nfs2.sms.private.cam.ac.uk (ceph->nfs gateway)
- ruddy.sms.csx.cam.ac.uk (nfs server)
- transcode1.sms.private.cam.ac.uk (transcoding)
- transcode2.sms.private.cam.ac.uk (transcoding)
- transcode3.sms.private.cam.ac.uk (transcoding)
- transcode4.sms.private.cam.ac.uk (transcoding)
- [Test](https://sms-dev.sms.csx.cam.ac.uk/)
- daffy.sms (web app and DB)
- donald.sms (web app and DB)
- sms-dev-storage1 (nfs)
- sms-dev-storage2 (nfs)
- mallard.sms (downloads)
- transcode5.sms.private.cam.ac.uk (transcoding)
Application repositories
------------------------
- [SMS subversion repo](https://subversion.csi.cam.ac.uk/cgi-bin/viewvc.cgi/devgroup/sms/trunk/grails-app/)
Technology
----------
| Category | Language | Framework |
This page gives an overview of the Streaming Media Service, describing its current status, where and
how it's developed and deployed, and who is responsible for maintaining it.
## Service Description
The Streaming Media Service (SMS) provides a video and audio transcoding and hosting service.
## Service Status
The Streaming Media Service is currently live/decommissioning.
- [Webpage with details of closure](https://help.uis.cam.ac.uk/news/sms-future-feb2021)
## Contact
Technical queries and support should be directed to [sms-support@uis.cam.ac.uk](mailto:sms-support@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 [sms-support@uis.cam.ac.uk](mailto:sms-support@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](https://gitlab.developers.cam.ac.uk/groups/uis/devops/sms/-/issues).
## Environments
The Streaming Media Service is currently deployed to the following environments:
| Name | URL | Supporting VMs |
| ----------- | ------------------------------------ | -------------------------------------------------- |
| Production | [https://sms.cam.ac.uk](https://sms.cam.ac.uk) | sms-node1.sms.cam.ac.uk (web application) |
| | | sms-node2.sms.cam.ac.uk (web application) |
| | | smew.sms.csx.cam.ac.uk (downloads) |
| | | goldeneye.sms.csx.cam.ac.uk (downloads) |
| | | sms-nfs1.sms.private.cam.ac.uk (ceph->nfs gateway) |
| | | sms-nfs2.sms.private.cam.ac.uk (ceph->nfs gateway) |
| | | ruddy.sms.csx.cam.ac.uk (nfs server) |
| | | pintail.sms.csx.cam.ac.uk (nfs server) |
| | | pochard.sms.csx.cam.ac.uk (nfs server) |
| | | transcode1.sms.private.cam.ac.uk (transcoding) |
| | | transcode2.sms.private.cam.ac.uk (transcoding) |
| | | transcode3.sms.private.cam.ac.uk (transcoding) |
| | | transcode4.sms.private.cam.ac.uk (transcoding) |
| | | sms-live-db.srv.uis.private.cam.ac.uk (DB) provided by [Moa](https://wiki.cam.ac.uk/ucs/Migrating_dev-group_databases_to_Moa) |
| Development | [https://sms-dev.sms.csx.cam.ac.uk](https://sms-dev.sms.csx.cam.ac.uk) | daffy.sms.csx.cam.ac.uk (web application) |
| | | donald.sms.csx.cam.ac.uk (web application) |
| | | sms-dev-storage1.sms.private.cam.ac.uk (nfs) |
| | | sms-dev-storage2.sms.private.cam.ac.uk (nfs) |
| | | mallard.sms.private.cam.ac.uk (downloads) |
| | | transcode5.sms.private.cam.ac.uk (transcoding) |
| | | devgroup-test-db.srv.uis.private.cam.ac.uk (DB) provided by [Moa](https://wiki.cam.ac.uk/ucs/Migrating_dev-group_databases_to_Moa) |
## Source code
The source code for the Streaming Media Service is spread over the following repositories:
| Repository | Description
| ----------- | ------------------ |
| [Application Server](https://gitlab.developers.cam.ac.uk/uis/sysdev/devgroup/sms/sms) | The source code for the main application server |
| [Transcode worker](https://gitlab.developers.cam.ac.uk/uis/sysdev/devgroup/sms/smsworker) | The source code for the transcode worker |
| [Infrastructure](https://gitlab.developers.cam.ac.uk/uis/devops/sms/ansible) | Ansible infrastructure code for some management tasks |
## Technologies used
The following gives an overview of the Streaming Media Service is built on.
| Category | Language | Framework(s) |
| -------- | -------- | --------- |
| Web application | Groovy 2.4.12 | Grails 1.3.10 |
| DB | Postgres | 10.5 |
## Operational documentation
Deployment
----------
Deployed by installing RPMs from the [Bes repo](https://wiki.cam.ac.uk/ucs/Bes_-_Managed_Installation_Service#.28S.29RPMS_Available_on_Bes)
The following gives an overview of how the Streaming Media Service is deployed and maintained.
Deployment repository
---------------------
- [bes.csi.cam.ac.uk](http://bes.csi.cam.ac.uk/)
### How and where the Streaming Media Service is deployed
Service Owner
-------------
[Abraham Martin](https://www.lookup.cam.ac.uk/person/crsid/amc203)
The Streaming Media 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/sysdev/devgroup/sms/sms). 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.
Service Managers
----------------
[Stephen Ison](https://www.lookup.cam.ac.uk/person/crsid/si202)
### Deploying a new release
Current Status
--------------
Live
Once the RPM packages are added to the [Bes RPM package repository](https://bes.csi.cam.ac.uk) installation is simply a matter of running `zypper up` as root.
Documentation
-------------
### Monitoring
The streaming Media Service is monitored by [nagios](https://nagios.uis.cam.ac.uk/nagios/)
There is also a [status page](https://sms.cam.ac.uk/adm/status) that checks the various components of the service and returns 200 if everything is functioning normally.
### Other Documentation
- [UCS Wiki](https://wiki.cam.ac.uk/ucs/SMS_-_Streaming_Media_Service)
- [Gitlab wiki](https://gitlab.developers.cam.ac.uk/uis/devops/sms/docs/wikis/Legacy-SMS-Docs)
## Service Management and tech lead
The **service owner** for the Streaming Media Service is [Abraham Martin](https://www.lookup.cam.ac.uk/person/crsid/amc203).
The **service manager** for the Streaming Media Service is [Stephen Ison](https://www.lookup.cam.ac.uk/person/crsid/si202).
The **tech lead** for the Streaming Media Service is [Stephen Ison](https://www.lookup.cam.ac.uk/person/crsid/si202).
System Dependencies
-------------------
- [Lookup](lookup.md)
- [Raven](raven-ucamwebauth.md)
- [Moa](https://wiki.cam.ac.uk/ucs/Migrating_dev-group_databases_to_Moa)
Contact Addresses
-----------------
- sms-support@uis.cam.ac.uk
\ No newline at end of file
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