Skip to content

Introduction#

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

Docker enables you to create a container that already has the required service, environment for the service, and a minimum number of required tools.

Each LUNA PLATFORM service has its image. Docker images are the basis of containers. Each container includes libraries required for running services and execution parameters for use within a container runtime.

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.

You should perform additional actions for license key activation and required software installation before launching the Compose script. The actions are described in this manual.

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.

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.

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 Putty (when you remotely connect to the server). The provided commands were tested with these utilities only. The use of other shells or emulators can lead to errors when executing commands.