Installation & update

Supervisor is a containerized application, provided as a docker image.

In order to perform the application deployment, the following elements are necessary:

• docker installed and running;
• Profitap Supervisor docker image (provided);
• Profitap Supervisor license file (provided).

Minimum:

• CPU: Any physical x86_64 CPU with 4 threads capability and a top frequency of 2.40 GHz;
• System RAM: 4 GB;
• Available disk space: 2 GB.

Suggested:

• Processor: Any physical x86_64 CPU with 8 threads capability and a top frequency of 3 GHz;
• System RAM: 8 GB;
• Available disk space: 4 GB.

The installation can be performed using the following commands in order:

1. Create a directory to be used to store the supervisor configuration and license:

mkdir -p /home/user/supervisor-data/

This is only a reference path used for this documentation. If a different path is used, edit the following commands accordingly.

2. Copy the provided license file in the data directory:

cp SFM-010010-10.lic /home/user/supervisor-data/license.lic

Replace the name of the file in this command with the actual license file provided.

3. Load the provided docker container (replace 'X.Y.Z' with the appropriate version number):

docker load -i profitap-supervisor-vX.Y.Z.tar

4. Run the docker container, specifying the correct data directory (replace 'X.Y.Z' with the appropriate version number):

docker run -v /home/user/supervisor-data:/data:Z --network host --rm --name supervisor -d profitap-supervisor:vX.Y.Z

At this point, the Supervisor application should be running. If you wish to verify that deployment has proceeded correctly, you can check the running containers using the following command:

docker ps

The Profitap Supervisor container should appear.

1. Stop the docker container:

docker stop supervisor

2. Replace the certificate (cert.pem) and key (key.pem) files in the data folder with the one you want to use.

3. Restart the docker container:

docker run -v /home/user/supervisor-data:/data:Z --network host --rm --name supervisor -d profitap-supervisor:vX.Y.Z

If you wish to recreate a new self-signed certificate, in step 2, remove the cert.pem and key.pem files.

When using the Supervisor docker container, the update process simply consists of shutting down the currently-running docker container, and starting the new updated docker container using the same data folder. The new instance will perform all of the necessary data migration. It is good practice to perform a backup of the Supervisor configuration before proceeding with the update (see Configuration Backup and Restore).

In order to perform the update, the following elements are necessary:

• Currently installed Supervisor docker container;
• Data folder (we are using /home/user/supervisor-data for this example);
• Supervisor license file.

The steps for updating Supervisor are as follows:

1. (Optional) Backup the current Supervisor configuration (see Configuration Backup and Restore).

2. Load the new docker container in your local registry (replace 'X.Y.Z' with the appropriate version number):

docker load -i profitap-supervisor-vX.Y.Z.tar

3. Stop previous instance using the following command:

docker stop supervisor

4. Start a new docker container instance (replace 'X.Y.Z' with the appropriate version number):

docker run -v /home/user/supervisor-data:/data:Z --network host --rm --name supervisor -d profitap-supervisor:vX.Y.Z

When deployed, Supervisor is accessible through the following ports:

• 443: HTTPS GUI and API access;
• 80: HTTP redirection to HTTPS GUI;
• 8080: HTTP API access (docker container only).

The first access is possible using the following default credentials:

• username: admin
• password: admin

It is strongly advised to change these credentials on first access.