Kaomi Server

This package is the server for KAOMI Deployer.

Installaton, configuration and use

1. Create a virtualenv

virtualenv env --python=python3
source env/bin/activate

2. Install the package

pip install kaomi_server

3. Create configuration folder

python -m kaomi_server configure --folder <path>

5. Create the config file for systemd with path /etc/systemd/system/kaomi-server.service

[Unit]
Description=Kaomi Server (TM) Service

[Service]
Type=simple
User=root
Group=root
# Load env vars from /etc/default/ and /etc/sysconfig/ if they exist.
# Prefixing the path with '-' makes it try to load, but if the file doesn't
# exist, it continues onward.
EnvironmentFile=-/etc/default/kaomi-server
EnvironmentFile=-/etc/sysconfig/kaomi-server
ExecStart=<virtualenv path>/env/bin/python -m kaomi_server start --config <path file server.conf> --apikey <path directory conf.d> 
Restart=on-abnormal
WorkingDirectory=<virtualenv path>

# When stopping, how long to wait before giving up and sending SIGKILL?
# Keep in mind that SIGKILL on a process can cause data loss.
TimeoutStopSec=3min

[Install]
WantedBy=multi-user.target

Start Kaomi server on startup

systemctl daemon-reload
systemctl enable kaomi-server.service

Start the server right now

systemctl start kaomi-server.service

Formato rispose del server

The server responses are json dictionaries with the following structure:

{ "status": "status code", "substatus": "substatus code", "message": "meaning of the substatus" "data": "eventual useful data" }

Status and substatus codes