Use FaceStream with Configurator#
When FaceStream operates in the server mode, it can use LUNA Configurator service. The service enables you to store FaceStream settings and apply them to the FaceStream instances.
After FaceStream is launched it uses the parameters specified in the Configurator service and does not request them until restart.
To apply the FaceStream settings changed in the Configurator, you must restart FaceStream.
FaceStream in server mode only can utilize the Configurator service.
The Configurator service enables FaceStream to continue the processing of video streams after FaceStream crashes and restarts, all the video streams data is stored in the Configurator service.
If FaceStream is unable to receive data and get a video streams from the Configurator service after a restart, and FaceStream receives a request to process a new video stream, this particular video stream will be written to the Configurator service.
Features of working with Configurator#
If the LUNA Configurator is configured and available, then after starting FaceStream, it requests all the settings from the Configurator and applies it to start FaceStream.
If the Configurator is specified in the startup line, but is not available, FaceStream will issue an error in the log. At the same time, video streams will not be saved and recreated when FaceStream is restarted, and FaceStream settings will be taken from local configuration files.
If there are also no local configuration files, then the default settings specified in the FaceStream code will be taken.
Parameters in Configurator#
Configurator includes records with the specified parameters.
Each of the Luna Configurator records contains a name, a tag, and a configuration body. A record corresponds to one of the configuration files.
Parameters in the Configurator services have the same names as in configuration files (fs3Config.conf, input.json, trackengine.conf) and documentation.
Correspondence of the LUNA Configurator data and distribution configuration files
| Record name in LUNA Configurator | Corresponding configuration file | Description |
|---|---|---|
| FS_STREAMS | input.json | Video-sources configuration |
| TRACK_ENGINE_CONFIG and FACE_STREAM_CONFIG | trackengine.conf and fs3Config.conf | General FaceStream configurations |
Set configurations for several FaceStream instances#
If a single FaceStream instance is working with the Configurator service, it uses the settings that are loaded by default.
If you want to use multiple FaceStream instances with different settings, create a separate record with a unique tag for each of these settings.
The tag is a unique identifier for the record and is specified in the launching keys described in the installation manual. Thus a specific FaceStream instance can get its own unique settings.
Follow these steps:
- Duplicate the record, for example, "FACE_STREAM_CONFIG", by pressing the Duplicate button.
- Set a tag and specify parameters values.
Tags are not created for the default records.
See the command to lauch FaceStream in server mode with Configurator in the installation manual.