Admin Guide

Install

Before we start you need to know the following:

  • ADSS is a software distributed in a form of Docker Image.
  • You have to have some Docker or compatible container engine to run ADSS.
  • Current software version is not compatible with SELinux. Please consider to write your own SELinux policies or switch it off as described in pre_requisites_.

To install software you could simply run the following command:

docker pull hub.arenadata.io/adss/core:latest

Then you have to create container base on that image. ADSS has some mandatory persistent information which is stored in /app/data dir inside container. That means that we have to map volume to that dir and care about backup of that volume:

docker create --name adss -p 8000:8000 -p 8443:8443 -v /opt/adss:/app/data hub.arenadata.io/adss/core:latest

In the command above we made a container on port 8000 with ADSS and all data will be stored on host machine in directory /opt/adsm/.

Start and Stop

ADSS is just a container operated by Docker. So you are able to use simple Docker commands to start and stop ADSS.

To start Docker you need to use the following:

docker start adss

After starting you will be able to login to WebUI over browser with url http://<ip_address_of_server>:8000.

To stop the ADSS docker-container you need to issue the following:

docker stop adss

Enable HTTPS

  • Prepare server private key in pem format and place it to <data_volume>/conf/ssl/key.pem
  • Prepare certificate chain and place it to <data_volume>/conf/ssl/cert.pem in PEM format.
  • Drop current adss container and create it with “ssl” port
docker create --name adss -p 8000:8000 -p 8443:8443 -v /opt/adss:/app/data hub.arenadata.io/adss/core:latest

Note

Order of certs in cert.pem should be in sync with Nginx documentation.