Skip to content

Platform launch#

When the script is run, a default account of type user will be created with login user@mail.com and password password. Instructions for creating your own account are given below.

See detailed information about accounts in the "Accounts, tokens and authorization types" section of the administrator manual.

Configure User Interface 4 container#

You should configure the BP4_EXTERNAL_IP: field in the "/var/lib/luna/current/example-docker/.env" file before launching the Compose script if you are going to use the User Interface 4 service with the Backport 4 service.

BP4_EXTERNAL_IP=<Backport_4_external_IP>

You should specify the external IP of the server with Backport 4. Otherwise, the User Interface 4 will be unable to send requests to the Backport 4 service.

As a default account for working in User Interface 4, an automatically created account of the user type will be used. In the "/var/lib/luna/current/example-docker/docker-compose.yml" file, the BASIC_AUTH field is already set to dXNlckBtYWlsLmNvbTpwYXNzd29yZA== (login:password in Base64 format).

Launch services#

Go to the Docker Compose folder:

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

Make sure that LP containers are not launched before executing the script. An error will occur if you try to run a container with the same name as an existing container. If one or several LP containers are launched, you should stop them using the docker container rm -f <container_name> command. To stop all the containers, use docker container rm -f $(docker container ls -aq).

Launch Docker Compose:

You must be logged in the VisionLabs registry (see section "Login to registry")

./start_platform.sh

Deploying containers takes some time. You have to wait until all the services are running before working with Luna Platform.

Check the state of launched Docker containers.

docker ps

Enable Grafana and Loki#

Note. Follow these steps if you want to use LUNA Dashboards (Grafana) and Loki. Otherwise, skip this step.

To use Grafana and Loki, you can execute a script start_logging.sh, launching the LUNA Dashboards, Loki and Promtail service. This script must be executed after executing the main Docker Compose script.

See detailed information about monitoring visualization in the "LUNA Dashboards" and "Grafana Loki" section of the administrator manual.

Go to the Docker Compose folder:

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

Launch Docker Compose:

./start_logging.sh

Check the state of launched Docker containers.

docker ps

Run Handlers utilizing GPU#

The Handlers service does not utilize GPU by default. If you are going to use the GPU, then you should enable its use for the Handlers service in the Configurator service.

If you need to use the GPU for all estimators and detectors at once, then you need to use the global_device_class parameter in the "LUNA_HANDLERS_RUNTIME_SETTINGS" section. All estimators and detectors will use the value of this parameter if the device_class parameter of their settings like "LUNA_HANDLERS__SETTINGS.runtime_settings" is set to global (by default for all estimators and detectors).

If you need to use the GPU for a specific estimator or detector, then you need to use the device_class parameter in sections like "LUNA_HANDLERS__SETTINGS.runtime_settings".

See section "Calculations using GPU" for additional requirements for GPU utilization.

Account creation using API service#

Note. When you run the Docker Compose script, an account of type user is automatically created with login user@mail.com and password password. Instructions for creating an account with your authentication data are given below.

The account is created using an HTTP request to the "create account" resource of the API service.

You can also create an account using the Admin service. This method requires an existing login and password (or the default login and password) and enables you to create an "admin" account. See the "Admin service" section of the administrator manual for details.

To create the account using a request to the API service, you need to provide the following mandatory data:

  • login — email address
  • password — password
  • account_type — account type ("user" or "advanced_user")

Create the account using your authentication details.

Example of CURL-request to the "create account" resource:

curl --location --request POST 'http://127.0.0.1:5000/6/accounts' \
--header 'Content-Type: application/json' \
--data '{
  "login": "user@mail.com",
  "password": "password",
  "account_type": "user",
  "description": "description"
}'

It is necessary to replace the authentication data from the example with your own.

To work with tokens, you must have an account.