SES. Руководство администратора

Общее описание

Сервис предназначен для сценарных машин.

Термины и определения

script engine service (SES) – сервис обеспечивающий работу сценарных машин

Требования к окружению

В процессе работы сервис взаимодействует со следующими сервисами:

• UPS – настройка осуществляется через файл /opt/ups/config.json

• SMC, SEE, SPR, TTS, SBS, QAS - настройка осуществляется через файл /opt/ses/config.json

Установка ses

Дистрибутив распространяется в виде установочных пакетов для окружения и сервиса. Загрузите установочные пакеты на сервер и выполните команды для Вашей системы в каталоге с пакетом.

Перед установкой непосредственно сервиса необходимо установить сервисный пакет окружения.

• Установка/обновление ses осуществляется скриптом chmod +x ./ses-<версия>-<релиз>.sh && ./ses-<версия>-<релиз>.sh -i с правами администратора. Список всех ключей инсталлятора можно посмотреть, запустив инсталлятор ./ses-<версия>-<релиз>.sh без ключей.
• Загрузить последнюю версию продукта curl -s "https://repo.connect2ai.net/api/ses/new" --user '[user]:[pass]' 2>&1 | bash или в интерактивном режиме bash -c "$(curl -s https://repo.connect2ai.net/api/ses --user '[user]:[pass]' 2>&1)".
• Обновить ses /opt/ses/inupdate в интерактивном режиме. Или запустить с ключём:
  • /opt/ses/inupdate -b - обновить до последней beta версии;
  • /opt/ses/inupdate -r - обновить до последней release версии;
  • /opt/ses/inupdate -n - обновить до последней версии (не важно beta или release).
• Проверить актуальную версию продукта curl -s "https://repo.connect2ai.net/api/ses/version.
• Посмотреть лог изменений curl -s "https://repo.connect2ai.net/api/ses/changelog" --user '[user]:[pass]'.
• Полное описание всех команд API репозитория можно найти по ссылке https://repo.connect2ai.net/api. [user]:[pass] - это тот же логин и пароль, что и от Nextcloud.
• В папке с продуктом можно добавить 2 файла конфигурации (допускается один общий файл на все продукты в папке с окружением /opt/pve/):
  • echo -n "[user]:[pass]" > /opt/ses/.userapi (это файл авторизации в API, нужен для обновления и загрузки моделей)
  • echo -n "http://example.com:3128 [user] [password]" > /opt/ses/.proxy (это файл конфигурации proxy необходим для обновления и загрузки моделей, при отсутсвующем прямом подключение к интернету)

При обновление следующий список файлов и папок сохранияется: .userapi, .proxy, logs, nnets, config.json, cache, pretrained, pve, data. Сервис не требует остановки и возвращается в актуальное состояние после обновления.

Не забудьте запустить сервис и включить в автозапуск в системе:

sudo systemctl enable ses.service && sudo systemctl start ses.service

Удостоверьтесь, что сервис стартовал:

systemctl status ses.service

Разрешите доступ к портам 6157/tcp, 6170/tcp а также порту, определенном в конфиге (по умолчанию 6189/tcp) на нужном интерфейсе.

Настройка

Файл config.json

Настройка параметров сервиса ses производится в файле /opt/ses/config.json

Описание параметров приведено в таблице

Параметр	По умолчанию	Назначение
port	6190	порт api интерфейса, используется в UPS - настройка servers.ses в конфиге UPS
logs.path	logs/	Путь к папке логов
logs.backups	10	Количество старых сохраняемых логов
logs.maxSize	5242880	Максимальный размер текущего лог-файла, в байтах
servers.smc.url	"http://127.0.0.1:6181/smc"	адрес сервера smc
servers.smc.timers.connect	2	таймаут подключения к серверу smc
servers.smc.timers.read	10	таймаут получения данных с сервера smc
servers.see.url	"http://127.0.0.1:6184/see"	адрес сервера see
servers.see.timers.connect	2	таймаут подключения к серверу see
servers.see.timers.read	5	таймаут получения данных с сервера see
servers.spr.url	"http://127.0.0.1:6183/spr"	адрес сервера spr
servers.spr.timers.connect	30	таймаут подключения к серверу spr
servers.spr.timers.read	30	таймаут получения данных с сервера spr
servers.tts.url	"http://127.0.0.1:6186/tts"	адрес сервера tts
servers.tts.timers.connect	5	таймаут подключения к серверу tts
servers.tts.timers.read	10	таймаут получения данных с сервера tts
servers.sbs.url	"http://127.0.0.1:6185/sbs"	адрес сервера sbs
servers.sbs.timers.connect	2	таймаут подключения к серверу sbs
servers.sbs.timers.read	5	таймаут получения данных с сервера sbs
servers.qas.url	"http://127.0.0.1:6187/qas"	адрес сервера qas
servers.qas.timers.connect	5	таймаут подключения к серверу qas
servers.qas.timers.read	300	таймаут получения данных с сервера qas
connectors.vk	{}	Параметры подключения к ботам VK
connectors.telegram	{}	Параметры подключения к telegram ботам
tmp	"/tmp/ses"	временная папка

Эмуляция сервисов интеграции

В каталоге /opt/ses/testapi могут располагаться эмуляторы сервисов интеграции. Каждый эмулятор располагается в папке с названием сервиса и должен содержать в этой папке файл handler.py. Эмулятор будет доступен по адресу htttp://<адрес ses>/testapi/<названием сервиса>

Протоколы и порты

Сервис использует порт 6190/tcp для доступа к api интерфейсу. Порт доступа к api может быть изменен в конфигурационном файле

Журналы работы

Для проверки состояния сервиса выполните sudo systemctl status ses.

Журналы сервиса находятся в каталоге, определенном в конфигурационном файле (по умолчанию - /opt/ses/logs/). Ошибки также пишутся в системный журнал, для просмотра можно воспользоваться командой sudo journalctl -u ses

Удаление и обновление ses

Для удаления выполните команду:

/opt/ses/uninstall

Команда удалит сервис и рабочий каталог, включая все файлы конфигурации. Для обновления запустите скрипт установки как указано в п 4. При этом, обновление не изменяет файл /opt/ses/config.json.