Tulpar RPA

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

Установка сервера

Windows Server #

1. PostgreSQL (5 минут) #

  1. Скачайте установщик PostgreSQL 18 для Windows (EDB) на компьютер с интернетом и перенесите на сервер.
  2. Компоненты — PostgreSQL Server и Command Line Tools. Задайте и запишите пароль пользователя postgres, порт 5432, локаль — по умолчанию.
  3. Служба postgresql-x64-18 запускается автоматически.

PostgreSQL может стоять и на другом сервере — тогда укажите -DbHost <имя> и разрешите подключение с сервера оркестратора в pg_hba.conf.

2. Сервер Tulpar (5 минут) #

Распакуйте TulparOrchestrator-0.4.0-win-x64.zip, откройте PowerShell от имени администратора в его папке:

Set-ExecutionPolicy -Scope Process Bypass
.\install-server.ps1 -PublicUrl https://orch.company.kg:8443 -WhatIf   # план, ничего не меняется
.\install-server.ps1 -PublicUrl https://orch.company.kg:8443

Скрипт спросит пароль postgres и:

  • создаст роль tulpar со случайным паролем и правом CREATEROLE, базу tulpar (UTF-8) с расширением pg_trgm, проверит поиск по кириллице и создаст базу отчётов tulpar_reports;
  • скопирует программу в C:\Program Files\Tulpar\Orchestrator\, создаст папку данных C:\ProgramData\Tulpar\Orchestrator\ (доступ только у службы и администраторов) и orchestrator.json;
  • зарегистрирует службу TulparOrchestrator (автозапуск, перезапуск при сбое), откроет порт 8443 в брандмауэре;
  • запустит службу и покажет адрес панели и токен установки.

Параметры при необходимости: -DbHost, -DbPort, -DbAdminUser, -Port (вместо 8443), -InstallDir, -DataDir, -PgBinDir. Повторный запуск ничего не пересоздаёт.

3. Мастер первого запуска (3 минуты) #

  1. Откройте адрес панели в браузере. Предупреждение о сертификате — это самоподписанный сертификат сервера (как сделать его доверенным — Настройки и HTTPS).
  2. «Первый запуск оркестратора»: «Токен установки» (файл setup-token.txt в папке данных или команда Tulpar.Orchestrator.exe print-setup-token), «Организация», «Часовой пояс», логин и пароль администратора → «Завершить».
  3. С этого момента идёт пробный период — 30 дней.

4. Сразу после установки (2 минуты) #

  1. Сохраните ключ шифрования — без него пароли учётных данных из резервной копии не восстановить: 
    & "C:\Program Files\Tulpar\Orchestrator\Tulpar.Orchestrator.exe" keys export --out D:\Сейф\tulpar-master.tkey
    Храните файл и его пароль отдельно от резервных копий.
  2. Настройте ежедневную резервную копию.
  3. Откройте «Администрирование» → «Состояние системы»: всё должно быть зелёным, поиск по кириллице — работает.
Проверка Ожидание
Get-Service TulparOrchestrator Running
https://<сервер>:8443/health/ready {"status":"ok",…}
Вход в панель «Обзор» с чек-листом начала работы
«Состояние системы» PostgreSQL 18, миграции применены, поиск по кириллице работает, ключ выгружен

Linux (Docker Compose) #

  1. Установите Docker Engine 24+ и плагин docker compose.
  2. Распакуйте TulparOrchestrator-0.4.0-docker.zip, например в /opt/tulpar. Без интернета загрузите образы: 
    docker load -i tulpar-orchestrator-0.4.0.tar
docker load -i postgres-18.tar
  3. Запустите: 
    cd /opt/tulpar
sudo sh ./init-secrets.sh       # .env со случайным паролем БД и secrets/master.key
nano .env                       # PUBLIC_URL=https://orch.company.kg:8443, TULPAR_VERSION=0.4.0
docker compose up -d
docker compose exec orchestrator dotnet Tulpar.Orchestrator.dll print-setup-token
  4. Откройте PUBLIC_URL в браузере и пройдите мастер, как на Windows.

Данные — в томах Docker pgdata (база) и tulpardata (пакеты, сертификат, журналы). Порт хоста меняется в .env (HTTPS_PORT). Журнал сервера — docker compose logs -f orchestrator, проверка — docker compose exec orchestrator dotnet Tulpar.Orchestrator.dll check. База отчётов в Docker создаётся сервером сама при первом запуске.

Первые шаги #

  1. «Пользователи» — создайте сотрудников и выдайте временные пароли (см. Пользователи и права).
  2. «Рабочие области» — создайте области отделов и добавьте участников.
  3. «Календари» — создайте производственный календарь года с праздниками и переносами (см. Календари).
  4. «Настройки» → «Каналы» — почта и Telegram для оповещений.
  5. Подключите роботов (см. Роботы) и студии разработчиков (см. Профиль).
  6. «Настройки» → «Лицензия» — отправьте код запроса и загрузите файл лицензии до конца пробного периода (см. Лицензирование).

Удаление #

.\uninstall-server.ps1                               # служба, брандмауэр, программа; данные и база сохраняются
.\uninstall-server.ps1 -RemoveData -RemoveDatabase   # всё, после подтверждения (сначала сделайте копию!)

-RemoveDatabase удаляет обе базы (основную и отчётов), роли областей отчётов и роль tulpar. Docker: docker compose down (тома остаются), docker compose down -v — удалить и данные. Агент на роботе — Tulpar.Agent.exe uninstall.