Installing the Operavix Application on Linux

The Operavix application can be used on a Linux server. The server capable of installing the Docker software version 17.06 or higher is required.

To install the Operavix application on Linux:

1. Upload the provided distribution package to the desired server.
2. Create volumes to store the program operation data:
   # docker volume create operavix-app-data
   

   # docker volume create operavix-app-log
   

Running the Application with HTTP Operation

To start the container with the application that will operate via HTTP, execute the following command:

# docker run -d --name operavix-app \
--mount source=operavix-app-data,target=/var/lib/operavix/data/ \
--mount source=operavix-app-log,target=/var/log/operavix/ \
-p 0.0.0.0:8010:8010 -d --restart=always \
dockerhub.office.operavix.com/operavix/operavix_app:d230809

Running the Application with HTTP Operation (Swarm)

To start the application with HTTP operation in a Swarm environment:

1. Start Docker Swarm:
   # docker swarm init --advertise-addr 127.0.0.1:2377 --listen-addr 127.0.0.1:2377
   

2. Create a service:
   # docker service create --name operavix-app \
   --mount type=volume,src=operavix-app-data,target=/var/lib/operavix/data/ \
   --mount type=volume,src=operavix-app-log,target=/var/log/operavix/ \
   -e JVM_MAX_MEMORY='4G' \
   --publish published=8010,target=8010,mode=host \
   --limit-memory 30G \
   --limit-cpu 2 \
   --restart-max-attempts 5 \
   --restart-condition "on-failure" \
   dockerhub.office.operavix.com/operavix/operavix_app:d230809
   

Running the Application with HTTPS Operation (Swarm)

To run the container with the application that will operate via HTTPS, do the following:

1. Start Docker Swarm:
   # docker swarm init --advertise-addr 127.0.0.1:2377 --listen-addr 127.0.0.1:2377
   

2. Create secrets:
   # docker secret create operavix_app_https_certificate ${PATH_FILE}
   

   # echo -n "${PASSWORD_CERTIFICATE}" | docker secret create operavix_app_https_certificate_password -
   

   Explanation:
   • ${PATH_FILE} — is the full path to the file containing the certificate and private key
   • ${PASSWORD_CERTIFICATE} — is the password for the certificate file
3. Create a service:
   # docker service create --name operavix-app \
   --secret operavix_app_https_certificate \
   --secret operavix_app_https_certificate_password \
   --mount type=volume,src=operavix-app-data,target=/var/lib/operavix/data/ \
   --mount type=volume,src=operavix-app-log,target=/var/log/operavix/ \
   --publish published=443,target=8010,mode=host \
   --restart-max-attempts 5 \
   --restart-condition "on-failure" \
   -e JVM_MAX_MEMORY='4G' \
   -e FE_URL="https://server-name.domain.com"
   -e FE_CORS_POLICY="*"
   operavix/operavix_app:d230809
   

   Advice

   • The image name with version is shown as an example. Replace it with the version you are installing.
   • Specify the standard HTTPS port 443 for the web interface. If necessary, you can specify a different port.

In the JVM_MAX_MEMORY variable, specify the maximum amount of RAM in gigabytes that the Operavix application will be able to use. It is recommended to specify a value within 60-90% of the available free RAM on the server.

In the FE_URL variable, specify the working URL that will be used to access the web interface.

In the FE_CORS_POLICY variable, specify the value * to enable CORS for cross-domain data exchange with any website. To restrict access, list the required URLs separated by commas. For example: "https://operavix.com, https://example.com".

After launching the application, open the page https://<server-fqdn>/ in a web browser. A web page for creating the system administrator account should open.

If the page does not open:

• Verify that the container is running by executing the command:
  # docker ps
  

• Refer to the application logs by executing the command:
  # docker service logs -f operavix-app