Skip to content

Introduction#

This document describes the installation and usage of Docker Compose for LUNA PLATFORM deployment.

This document includes an example of LUNA PLATFORM deployment using the Compose script example. It implements LUNA PLATFORM minimum power operating for demonstration purposes and cannot be used for the production system.

It is considered that installation is performed on the server with CentOS OS, where LP was not installed.

Docker Compose is used for automated containers deployment. The Docker Compose scenario from this distribution is used for deploying the LUNA PLATFORM services on a single server.

Firewall and SELinux should be manually configured on the server by the administrator. Their configuration is not described in this document.

No data backup or databases replication is implemented for LP data in this installation.

To deploy the LUNA PLATFORM using the Docker Compose script, follow the steps in the following sections:

  • "Before launch" — Actions for unpacking archives, preparing directories, configuring licenses, etc. Some actions may be optional.
  • "LUNA PLATFORM launch" — Launching the Docker Compose script to deploy the LUNA PLATFORM.

To use the Docker Compose script, a LUNA PLATFORM network license is required. The license is provided by VisionLabs on request separately from the delivery. The license key is created using the fingerprint of the system. This fingerprint is created based on information about the hardware characteristics of the server. Thus, the received license key will work only on the same server from which the system fingerprint was obtained. LUNA PLATFORM can be activated using one of two utilities — HASP or Guardant. The section "Activate license" provides useful links to instructions for activating the license key for each method.

This document also contains instructions for automatically launching LUNA Dashboards (Grafana) and Loki (see the "Enable Grafana and Loki" section).

The "Additional information" section provides useful information on configuring logging, enabling log rotation, Docker commands, etc.

Additional notes about Docker Compose script. The script:

  • Is tested using the default services configurations.

  • Prepares environment using Storages.

  • Is not intended to be used for LP scaling:

    • It is not used for the deployment of LP services on several servers.

    • It is not used for deployment and balancing of several LP services on a single service.

  • Launches default databases and does not include a build-in possibility to change the databases used.

  • Supports GPU utilization for LP calculations.

  • Does not provide the possibility to use external databases already installed on the server.

  • Does not perform migrations from previous LP versions and updates from the previous LP build.

  • Does not run the services Backport 3, Backport 4, User Interface 3, User Interface 4.

See the "docker-compose.yml" file and other files in the "example-docker" directory for the information about launched services and performed actions.

You can write your scenario that deploys and configures all the required services. This document does not include information about scenario creation or tutorial for Docker usage. Please refer to the Docker documentation to find more information about Docker and Docker Compose:

https://docs.docker.com

It is recommended to use orchestration services for the commercial usage of LP. Their utilization is not described in this manual.

All the provided commands should be executed using the Bash shell (when you launch commands directly on the server) or in a program for working with network protocols (when you remotely connect to the server), for example, Putty.

A license file is required for LUNA PLATFORM activation. The file is provided by VisionLabs separately upon request.

All actions described in this manual must be performed by the root user. This document does not describe the creation of the user with administrator privileges and the following installation by this user.