This guide covers the installation instructions for Accurate Video on AWS EC2, running against a Vidispine system on the backend, and deployed using Docker Compose. Please note that the installation instructions for Vidispine are not covered by this guide.
Go to AWS EC2 and launch a new instance using the EC2 instance wizard.
For a detailed guide on how to launch an EC2 instance, please refer to the following guide: https://docs.aws.amazon.com/quickstarts/latest/vmlaunch/step-1-launch-instance.html
Install Vidispine on the server, or skip if already installed elsewhere. For this guide, it’s assumed that Vidispine is installed on the same EC2 instance as Accurate Video, but this is no requirement. Please refer to the Vidispine installation instructions found here: https://apidoc.vidispine.com//latest/server/index.html
Docker will be used to launch the Accurate Video containers. Please refer to its guide for installation instructions: https://docs.docker.com/engine/install/
Docker-compose is used to launch all Accurate Video containers at once. Please refer to the installation guide here: https://docs.docker.com/compose/install/
Unless the system comes with git pre-installed, make sure to install it before going further.
https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
The git repository contains all the needed configuration files to start Accurate Video using Docker Compose.
git clone https://gitlab.com/codmill/accurate-player/accurate-video-docker-compose.git
You will be prompted for a username and password. Enter the supplied deploy token & password. The deploy token is a special access key which gives read-only access to this git repository and is only valid for a limited period of time.
Username for 'https://gitlab.com': <username>
Password for 'https://<username>@gitlab.com': <password>
The Codemill Docker registry contains all the Docker containers specified in the Docker Compose configuration. You’ll need to first login or authenticate to the repository. Replace email and password with the given Docker registry credentials.
docker login -u <docker-username> -p <docker-password> codemill-docker.jfrog.io
After authentication to the Codemill repository, the latest Docker containers need to be downloaded locally. Use the docker-compose pull command to retrieve the latest versions.
docker-compose -f vs-backend.yml -f frontend.yml pull
Accurate Video needs a license key to function properly. This license key is typically given to you, and will need to be entered into the settings file. Edit the file config/settings-qc-vs.js
licenseKey: "XYZ",
Replace XYZ with your given license key.
A few Vidispine variables need to be set according to the setup which is running. Edit the file vs-backend.yml using any editor.
Find the following rows:
# Vidispine credentials (may be blank if authorization forward is enabled)
- AP_ADAPTER_VIDISPINE_USERNAME=admin
- AP_ADAPTER_VIDISPINE_PASSWORD=admin
Change these to match the Vidispine user/password combination you’d like to use for authentication against Vidispine.
Also, find the following row:
# This is the "public" base URL of Vidispine, i.e. the base URL from the clients (e.g. web browsers) perspective
- AP_ADAPTER_VIDISPINE_PUBLIC_URL=http://localhost/
This needs to be updated to the IP of the external machine that is running Vidispine. For example, if the IP of the machine is 1.2.3.4 this should be http://1.2.3.4/. The Vidispine API should then be available on http://1.2.3.4/API
Nginx is a web server and will be used as a reverse proxy in front of both Accurate Video and Vidispine. Here you can see instructions on how to install it based on your Linux distribution: https://www.nginx.com/resources/wiki/start/topics/tutorials/install/
The cloned Git repository contains a pre-made nginx configuration to work in front of both Accurate Video and Vidispine. You’ll need to copy this file into the nginx sites directory as follows:
sudo cp -f config/nginx-root-vs.conf /etc/nginx/sites-available/default
Restart nginx to make the changes take effect.
sudo systemctl restart nginx
It’s time to start up Accurate Video! Start the backend and frontend services by using Docker Compose, this command will launch all required containers in the background:
docker-compose -f vs-backend.yml -f frontend.yml up -d
You should now be able to access the system on the IP of the machine if you’ve done everything correctly. Opening the IP in a browser should give you access to Accurate Video, however, there’ll be no assets to see, unless they already exist in Vidispine.