Introduction#
This document describes the general steps for upgrading from LUNA PLATFORM 3 distribution (version 3.3.8) to LUNA PLATFORM 5 with Backport 3 service. See the "Backports" section in administrator manual for information about the Backport 3 service.
The database migration procedures are performed using a script. The script was tested on the LUNA PLATFORM 3 of version 3.3.8. It was not tested on the other LUNA PLATFORM 3 versions. See "Migration from LUNA PLATFORM 3 to Backport 3".
You should update LUNA PLATFORM to the version 3.3.8 if you have an earlier version.
This instruction describes migration from Aerospike and PostgreSQL (LUNA PLATFORM 3) databases to the PostgreSQL (LUNA PLATFORM 5) databases and full installation of LUNA PLATFORM 5. The instruction provides an example of commands for migrating the PostgreSQL database from version 9.6 running on the server to version 16 running in a Docker container. If necessary, you can migrate to the version 16 running on the server as a service (not described in this documentation).
This document describes migration from LUNA PLATFORM 3.3.8 installed in the default configuration. Note that your LUNA PLATFORM configuration and scaling may differ. In this case, use this manual as an example of the general approach to LUNA PLATFORM migration.
A network license is required to use the LUNA PLATFORM in Docker containers. 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.
The document describes installation of all the services on a single service.
You should install InfluxDB if monitoring is required.
For a successful upgrade, you need to perform the actions from the sections "Before upgrade" and "Services launch". The section "Additional information" provides useful information on the description of service launch parameters, Docker commands, information on launching the Python Matcher Proxy service for using matching plugins and other.
This document includes an example of LUNA PLATFORM deployment. It implements LUNA PLATFORM minimum power operating for demonstration purposes and cannot be used for the production system.
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.
This document does not include a tutorial for Docker usage. Please refer to the Docker documentation to find more information about Docker:
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.