Launching FaceStream using Docker Compose

Before automatic launching FaceStream, the following actions should be performed:

• The license key is activated.

  If the LP services are not launched and the LP license was not activated at the start of the FaceStream launch, see the "License key activation when LP is not launched" section.

  If LP services are launched and the LP license was activated at the start of the FaceStream launch, see the "License key activation when LP is launched" section.

• The required components are launched (see the "Launching LP services" section):

  • Influx OSS 2 container
  • PostgreSQL container
  • LUNA Configurator container
  • LUNA Licenses container

Additional notes about Docker Compose script. The script:

• loads LUNA Streams and FaceStream settings into Configurator

• creates and initializes the LUNA Streams database

• launches the LUNA Streams and FaceStream

• is tested using the default LUNA Streams and FaceStream configurations.

• is not intended to be used for FaceStream scaling:

  • It is not used for the deployment of FaceStream services on several servers.

  • It is not used for deployment and balancing of several FaceStream services on a single service.

• supports GPU utilization for FaceStream calculations.

• does not provide the possibility to use external database for LUNA Streams already installed on the server.

• does not perform migrations from previous FaceStream versions and updates from the previous FaceStream build.

See the "docker-compose.yml" file and other files in the "example-docker" directory for the information about launched services and performed actions.

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

Launching FaceStream command

Go to the Docker Compose folder:

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

Make sure that FS container 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).

To launch FaceStream with GPU using Docker Compose, you need to follow the steps in "GPU dependencies installation".

Launch Docker Compose:

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

./start_facestream.sh --configurator_address=127.0.0.1

--configurator_address=127.0.0.1 - LUNA Configurator service address

Check the state of launched Docker containers.

docker ps

The list of streams is available at http://127.0.0.1:34569/api/1/streams/. Viewing the stream in the browser is available at http://127.0.0.1:34569/api/1/streams/preview/<stream_id>.