Installation¶

For proper installation one need to clone project from git.

Surroundings¶

The service can be installed on Windows 10 and AlmaLinux 9 (not tested on other system versions).

Required predefined dependencies:

Python of version 3.13 is required.
It is strongly recommended to create virtual surroundings for python dependencies installation.
Python setuptools module can be installed via pip (pip install setuptools).

Dependencies installation¶

After surroundings installation launch pip install with “-r requirements.txt” parameter.

pip install -r requirements.txt

Configuration¶

After dependencies installation configuration file should be set. File is placed in “./luna_configurator/configs/config.conf”. Also another configuration file can be used: just pass it with -\-config=./luna_configurator/configs/dev_config.conf.

Database creation¶

Database for the service must be created in accordance with “./luna_configurator/configs/config.conf”.

Postgresql (require version 12 or higher)

For database preparation use storages tool provided by VisionLabs, for example:

luna_prepare prepare configurator --entity database

Customising database creation:

to recreate database, use the -\-clear-database command line argument;
to create dumped settings and limitations from the provided file, set -\-dump-file command line argument (limitations from the listed limitation files are replaced with limitations from dump-file, if names of the limitations are same):

See more here.:

First launch and testing¶

If all previous actions are executed successfully, server is ready to work. To start server please launch run.py script. While start one can add arguments: server message port and not default config for a service. By default 5070 port is used. Example:

python run.py --port=5070 --config=./configs/config.conf

After server is started, testing is recommended. To perform testing execute command

python -m unittest tests.unittests_main

All tests should perform successfully.