Skip to content

Introduction#

This document describes:

  • the manual process of launching the FaceStream application and the required dependencies using Docker.

  • the automatic FaceStream application deployment with the LUNA Streams service using Docker Compose.

Before launching, it is necessary to explore the general information and sequence of actions.

FaceStream licensing is managed by a special parameter of the LUNA PLATFORM 5 license key, which determines the number of streams for LUNA Streams operation. Thus, a LUNA PLATFORM 5 license is required for FaceStream to work.

If FaceStream is launched without LP services launched in advance, then you need to request a new LUNA PLATFORM 5 license with a parameter that determines the streams number for LUNA Streams operation, and go through the full activation process.

If FaceStream is launched with LP services launched in advance, then you need to make sure that the license key contains a parameter that determines the streams number for LUNA Streams operation. If LUNA Licenses is launched on another server, you will also need to specify the address of this server in the LUNA Streams settings in the LUNA Configurator service.

Docker enables you to create a container that already has the required service, environment for the service, and a minimum number of required tools.

Each LUNA PLATFORM and FaceStream service has its own image. Docker images are the basis of containers. Each container includes libraries required for running services and execution parameters for use within a container runtime.

Docker Compose is used for automated containers deployment. The Docker Compose scenario from this distribution is used for deploying the LUNA Streams and FaceStream on a single server.

It is considered that launching is performed on the server with CentOS OS, where FaceStream was not installed.

Docker images of the LP and FaceStream containers are required for the FaceStream launching. Internet connection is required on the server for Docker images download, or the images should be downloaded on any other device and moved to the server. It is required to manually specify login and password for Docker images downloading.

Firewall and SELinux should be manually configured on the server by the administrator. Their configuration is not described in this document.

This document does not include a tutorial for Docker usage. Please refer to the Docker documentation to find more information about Docker:

https://docs.docker.com

This document includes examples of FaceStream deployment in a minimal 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 Putty (when you remotely connect to the server). The provided commands were tested with these utilities only. The use of other shells or emulators can lead to errors when executing commands.

For more information on general operation and application settings, see the FaceStream administrator manual.