Skip to content

Installing LUNA PASS#

The LUNA PASS service requires LUNA PLATFORM 5 minimum version 5.115.0.

Do not install LUNA PASS and LUNA PLATFORM 5 (LP5) on a server where LP5 is already running for other tasks. To ensure stable operation, deploy the systems on separate servers.

Installing LUNA PLATFORM 5#

1. Preparing for installation

Follow the steps from the docker compose deployment documentation according to the LP5 version you received. For this, select the required documentation version on the site.

Steps for deploying LP5:

1․ Unpack the distribution 2․ Create a symbolic link 3․ Configure SELinux and Firewall (if required) 4․ Activate the license 5․ Install Docker and Docker Compose 6․ Log in to the registry

2. Run

1․ Go to the directory with the Docker Compose script:

cd /var/lib/luna/current/example-docker

2․ Run the script:

./start_platform.sh --pass

To use the GPU in the Remote SDK service, add the --gpu flag. GPU parameters, such as the device number, are configured in the docker-compose.gpu.yml file.

This script:

  • Starts the PostgreSQL database and the Redis database
  • Prepares the environment for Luna Configurator and loads the settings
  • Starts the services:
  • Luna Configurator
  • Luna Licenses
  • Luna Remote SDK

Important: An example for deployment is provided. For industrial use, please contact a VisionLabs employee.

Preparing and unpacking the distribution#

The distribution package is an archive of the form "luna_pass_2.0.3".

Before the installation process, place the distribution files in a directory on the server. For example, in the /root directory. There should be no other distribution files in this directory other than the target files used to install the final product.

Perform the following steps.

1․ Switch to root superuser mode:

sudo su

2․ Create a directory to unzip the distribution:

mkdir -p /var/lib/luna-pass

3․ Move the distribution to the directory you created:

mv /root/luna-pass-2.0.3 /var/lib/luna-pass

4․ Install the unzip archiver if it is not installed:

yum install unzip

5․ Change to the distribution directory:

cd /var/lib/luna-pass

6․ Unzip the files:

unzip luna-pass-2.0.3.zip

7․ Create a symbolic link. The link indicates that it is the current version of the distribution that is used for launching:

ln -s luna-pass-2.0.3 current

If the /var/lib/luna-pass/current link is missing, the startup scripts will not be able to locate the binary files of the current release, and further installation will not be possible.

Before starting, update the settings in the configurator:

docker run --rm --entrypoint='' --network=host dockerhub.visionlabs.ru/lunapass/lunapass-configs:v3.0.2 python3 -m configs.migrate head --config_db_url postgres://luna:luna@127.0.0.1:5432/luna_configurator

127.0.0.1 is the configurator host. Specify your address if the configurator is located on another one.

Quick Start#

After you unpack the distribution and configure the license, run LUNA PASS with the command:

./start_selfsigned.sh {host}:{port}

Specify the host and port on which you plan to open the interface.

Script start_selfsigned.sh:

  • generates a self-signed certificate for nginx and places it in the desired directory (see point 3 of the "Running jslib examples" section);
  • generates the directories necessary for operation (./LOGS, ./videos) and sets the necessary permissions for them;
  • starts services at the following addresses:
  • https://{host}:{port}—lunapassui;
  • https://{host}:{port}/admin—lunapassui admin panel. Default login/password—admin/admin;
  • http://{host}:8321—lunapassapi;
  • http://{host}:8320—filebrowser interface, where you can view, for example, saved videos and session frames. Default login/password—admin/adminl;
  • http://{host}:5070/dashboard/settings.html — Luna Configurator service, stores all service configurations.

Starting LUNA PASS in container mode#

Enter the current data and settings into the files before running in docker. The data to enter see the section "Service Configuration".

1․ Change to the Docker directory:

cd /var/lib/luna-pass/current/example-docker

2․ Create configuration files for the services to be used (for example, from the example files in each service) to be mounted in docker. To start the service, enter the command:

docker-compose up -d

3․ Check the status of all running Docker containers.

docker-compose ps