Документация 0.4 Администрирование

Обновление

Сервер на Windows #

  1. Распакуйте архив новой версии.
  2. В PowerShell от имени администратора в его папке:
    .\upgrade-server.ps1 -BackupDir D:\Backups\Tulpar
    
    Скрипт запускает check новой версии, делает резервную копию, останавливает службу, заменяет файлы программы, запускает службу (миграции базы применяются сами) и ждёт готовности. Простой — 1–3 минуты.

Сервер в Docker #

docker load -i tulpar-orchestrator-0.4.0.tar
sh ./backup.sh /backups
sed -i 's/^TULPAR_VERSION=.*/TULPAR_VERSION=0.4.0/' .env
docker compose up -d

Откатить миграции нельзя: чтобы вернуться к прежней версии, восстановите копию, сделанную перед обновлением.

С 0.3 на 0.4 #

  1. Права для базы отчётов. Роли tulpar, созданной установкой 0.3, нужно право создавать роли областей. До или сразу после обновления выполните от имени postgres (psql -U postgres):
    ALTER ROLE tulpar CREATEROLE;
    CREATE DATABASE tulpar_reports OWNER tulpar ENCODING 'UTF8' TEMPLATE template0;
    
    Вместо CREATE DATABASE можно выдать ALTER ROLE tulpar CREATEDB — тогда базу создаст сервер. Без этих прав оркестратор работает, но отчёты недоступны; check покажет, чего не хватает. В Docker ничего выдавать не нужно.
  2. Лицензия. Обновлённый сервер получает 30 дней пробного периода с первого запуска 0.4, но в пробном периоде лицензию получают только 2 робота. upgrade-server.ps1 предупредит, сколько роботов останется без места. Сразу после обновления выполните Tulpar.Orchestrator.exe license request, отправьте код владельцу продукта и загрузите полученный файл.
  3. Резервные копии 0.3 (без базы отчётов) восстанавливаются и на 0.4.

Агенты роботов #

  • Сервер версии N работает с агентами N и N−1: после обновления сервера роботы продолжают работать.
  • Новая версия агента входит в поставку сервера и раздаётся им самим, без интернета (папка agent данных сервера).
  • «Роботы» → у устаревших агентов пометка «устарел» → „Обновить устаревших (N)“ или «Обновить агент» в меню робота.
  • «Настройки» → «Агенты» → «Целевая версия агента»: агенты старше неё обновятся сами, когда освободятся.
  • Задание не прерывается. Если новая версия не подключилась за 2 минуты, агент сам возвращается к прежней и пишет причину в журнал агента (категория update).

Студия #

Студия обновляется заменой папки программы на новую версию из Tulpar-0.4.0-win-x64.zip; настройки и процессы пользователя (%APPDATA%\Tulpar) сохраняются. Студия 0.3 тоже подключается к серверу 0.4 и публикует процессы, пока сервер не в ограниченном режиме.