Skip to content

Introduction#

This document provides example steps for performing a migration of the LUNA PLATFORM environment using the Storages utility.

Migration includes both an upgrade to a newer version and a downgrade to an earlier version. Therefore, the same migration process is used for both upgrades and downgrades. This document provides step-by-step instructions for completing this task and then launching containers.

It is recommended to familiarize yourself with the Storages utility manual before deploying the LUNA PLATFORM.

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.

Important: Migration using Storages is only possible for LUNA PLATFORM versions v.5.46.1 and higher. To upgrade from earlier versions, please request documentation from VisionLabs specialists. Using the documentation received, upgrade to v.5.46.1 (with Storages support), then use this guide to migrate to the target version of LUNA PLATFORM.

Note that starting from versions 5.46.1, there may have been critical changes, such as updates to thresholds or neural network versions, deprecation of FaceDetV1 and FaceDetV2 detectors, and others (see the full list in the "Key changes from previous versions" section). A change such as updating the thresholds may give a different result when performing estimation than in the old build. This manual is for upgrading from a previous build and these commands are for advanced users only. These commands are marked accordingly. Be careful and do not perform unnecessary actions if you are updating from from LUNA PLATFORM v.5.126.0.

To migrate LUNA PLATFORM, you need to perform the actions from the following sections:

  • "Before migrate" — Actions to unpack archives, prepare directories, configure a license, etc. Some actions may be optional.
  • "Run third-party services" — Launching PostgreSQL, Redis, Influx databases.
  • "Migrate environment" — performing environment migration (updating or rolling back versions of databases, settings, etc.)
  • "Services launch" — Launching containers with LUNA PLATFORM services.

The section "Additional information" provides useful information on the description of service launch parameters, Docker commands, using Grafana, etc.

This manual is designed with an assumption that:

  • You already have a previous minor version of LUNA PLATFORM installed and the required environment is up and running at your server(s).
  • LP 5 is installed according to LP 5 installation manual, and the default paths are used. Otherwise, you should consider your manual changes during the migration process.