Skip to content

Introduction#

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

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.

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 instructions for activating the license key for each method.

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

Docker images of the LP containers are required for the installation. Internet connection is required on the server for Docker images download, or the images should be downloaded on any other device and moved to the server. It is required to manually specify login and password for Docker images downloading.

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.

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.

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

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

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

For a successful launch, you need to perform the actions from the sections "Before launch" and "Platform launch".

Additional notes about Docker Compose script. The script:

  • Is tested using the default services configurations.

  • 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.

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

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.