Порядок действий по установке серверной части Vitro-CAD (Windows)

1. Установка Postgresql инсталлятором

Важно!

На следующем шаге нужно указать путь к директории на разделе, выделенном для БД. Иначе файлы баз данных будут храниться на системном разделе.

Для переноса уже существующего хранилища на другой раздел следуйте инструкции.

Важно!

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

2. Проверить конфигурационный файл C:\Program Files\PostgreSQL\XX\data\pg_hba.conf, где XX - версия PostgreSQL:

Раздел "#IPv4 local connections" должен содержать запись:

host      all      all      127.0.0.1/32     scram-sha-256

При разнесенной (выделенный сервер SQL) установке, или необходимости обеспечить внешний доступ к БД, следует добавить раздел "IPv4 network connections":

и строку:

# IPv4 local connections:

host      all      all      0.0.0.0/0      scram-sha-256

3. Перезапустить службу:

4. Проверить выполняется ли прослушивание на порту 5432 для всех активных адресов:

C:\>netstat -a | findstr 5432

Активные подключения

  Имя    Локальный адрес        Внешний адрес          Состояние
...
  TCP    0.0.0.0:5432           Vitrow2k16:0           LISTENING

5. Войти в cli postgresql от имени пользователя postgres:

c:\>cd "C:\Program Files\PostgreSQL\XX\bin"
C:\Program Files\PostgreSQL\XX\bin>psql -U postgres -h 127.0.0.1
Пароль пользователя postgres: <ввести пароль пользователя "postgres", заданный при инсталляции Postgresql>

6. Создать пользователя с ролью суперпользователя:

postgres-#CREATE USER vitrodbuser WITH PASSWORD '@pwd4vitro!' SUPERUSER;

7. Создать новую базу данных с именем vitrodb:

postgres-#CREATE DATABASE vitrodb WITH OWNER = vitrodbuser ENCODING = 'UTF8' LOCALE_PROVIDER = 'icu' ICU_LOCALE = 'ru-u-kn-true' TEMPLATE = template0 CONNECTION_LIMIT = -1;

8. Создать новую базу данных с именем workflow:

postgres-#CREATE DATABASE workflow WITH OWNER = vitrodbuser ENCODING = 'UTF8' LOCALE_PROVIDER = 'icu' ICU_LOCALE = 'ru-u-kn-true' TEMPLATE = template0 CONNECTION_LIMIT = -1;

9. Отключиться от cli postgresql:

postgres-# \q

10. Скачать и распаковать дистрибутив:

Инициализация базы данных

Версия дистрибутива 24.1.38 или выше:

11. Файлы инициализации базы данных лежат в папке DB\Install (внутри распакованного дистрибутива):

C:\distr\Vitro.Server.MultiPlatform.Windows-<версия дистрибутива>\DB\Install\db_func_create.sql
C:\distr\Vitro.Server.MultiPlatform.Windows-<версия дистрибутива>\DB\Install\db_table_create.sql
C:\distr\Vitro.Server.MultiPlatform.Windows-<версия дистрибутива>\DB\Install\db_data_init.sql

12. Запустить инициализацию базы из скриптов:

C:\Program Files\PostgreSQL\ХХ\bin>psql -U vitrodbuser -h 127.0.0.1 -d vitrodb -f "C:\distr\Vitro.Server.MultiPlatform.Windows-<версия дистрибутива>\DB\Install\db_func_create.sql" -f "C:\distr\Vitro.Server.MultiPlatform.Windows-<версия дистрибутива>\DB\Install\db_table_create.sql" -f "C:\distr\Vitro.Server.MultiPlatform.Windows-<версия дистрибутива>\DB\Install\db_data_init.sql"

Версия дистрибутива ниже 24.1.38:

11.1 Скопировать путь к файлу резервной копии базы данных (внутри распакованного дистрибутива):

C:\distr\Vitro.Server.MultiPlatform.Windows-<версия дистрибутива>\DB\vitrodb.bak

12.1 Запустить восстановление БД из бэкапа:

C:\Program Files\PostgreSQL\ХХ\bin>psql -U vitrodbuser -h 127.0.0.1 vitrodb < "C:\distr\Vitro.Server.MultiPlatform.Windows-<версия дистрибутива>\DB\vitrodb.bak"

Файлы конфигурации

13. Скопировать следующие папки из дистрибутива в расположение установки в "C:\Program Files\Vitro" :

C:\Windows\system32>xcopy C:\distr\Vitro.Server.MultiPlatform.Windows-<версия дистрибутива>\Vitro "C:\Program Files\Vitro Software\Vitro\" /e
C:\Windows\system32>xcopy C:\distr\Vitro.Server.MultiPlatform.Windows-<версия дистрибутива>\Vitro.Server.Core.Web "C:\Program Files\Vitro Software\Vitro\Server\Vitro.Server.Core.Web\" /e
C:\Windows\system32>xcopy C:\distr\Vitro.Server.MultiPlatform.Windows-<версия дистрибутива>\Vitro.Server.Workflow.Manager.Web "C:\Program Files\Vitro Software\Vitro\Server\Vitro.Server.Workflow.Manager.Web\" /e

14. Скопировать папку файлового хранилища в расположение, в которое смонтирован раздел для хранения:

C:\Windows\system32>xcopy C:\distr\Vitro.Server.MultiPlatform.Windows-<версия дистрибутива>\DB\VitroFileStorage "D:\Data\VitroFileStorage\" /e

15. Внести изменения в конфигурационный файл db.json:

C:\Program Files\Vitro Software\Vitro\Server\Conf\db.json

изменить строку соединения, указав в качестве значения для атрибута "server" имя или IP сервера БД, а в качестве значения для атрибута "database" название созданной в п.7 базы данных:

Json

 "ConnectionString": "server=localhost;database=vitrodb;user id=vitrodbuser;password=@pwd4vitro!;Include Error Detail=true",

изменить параметр "FileStoragePath", указав корректный путь к папке файлового хранилища:

Json

"FileStoragePath": "D:\\Data\\VitroFileStorage",

изменить параметр "TempPath", указав корректный путь к папке временных файлов:

"TempPath": "C:\\Temp",

16. Внести изменения в конфигурационный файл workflow.json:

C:\Program Files\Vitro Software\Vitro\Server\Conf\workflow.json

изменить строку соединения, указав в качестве значения для атрибута "server" имя или IP сервера БД, а в качестве значения для атрибута "database" название созданной в п.7 базы данных:

Json

 "ConnectionString": "server=localhost;database=workflow;user id=vitrodbuser;password=@pwd4vitro!;Include Error Detail=true",

17. Внести изменения в конфигурационный файл mail.json:

Указать адрес и порт SMTP сервера:
```
"Host": "smtp.example.ru",
"Port": 587,
```
Указать данные УЗ для подключения к SMTP серверу:
```
"Login": "mail@example.ru",
"Password": "123456",
```

Указать адрес отправителя:

"FromAddress": "mail@example.ru",
"FromName": "mail@example.ru",

Указать используется ли SSL для подключения к SMTP серверу:
```
"EnableSsl": true,
```
Убедиться, что есть параметр SecureSocketOptions:
```
"SecureSocketOptions": "StartTls"
```
Остальные параметры оставить по умолчанию.

Для автоматического запуска Веб-приложений создать и настроить задания для планировщика Windows:

18. Нажать Win+s и в строке поиска ввести "планировщик заданий". Запустить найденное приложение.

19. В открывшемся окне планировщика на левой панели открыть библиотеку планировщика заданий. На панели "Действия" вызвать функцию "Создать простую задачу". В открывшемся окне ввести "Имя" задачи "Vitro Server .Net Web Application".

Нажать "Далее".

20. На шаге "Триггер" мастера создания выбрать пункт "При запуске компьютера". Нажать "Далее".

21. На шаге "Действие" выбрать пункт "Запустить программу". Нажать "Далее".

22. На шаге "Запуск программы" :

в строке "Программа или сценарий" указать полный путь к исполняемому файлу приложения:
```
"C:\Program Files\Vitro Software\Vitro\Server\Vitro.Server.Core.Web\Vitro.Server.Core.Web.exe"
```
в строке аргументов указать:
```
/urls http://localhost:4615
```
в строке "рабочая папка" указать (без кавычек) путь к папке приложения:
```
C:\Program Files\Vitro Software\Vitro\Server\Vitro.Server.Core.Web
```

23. На шаге "Завершение" отметить флаг "Открыть окно "Свойства"для..." и нажать "Готово" :

24. в открывшемся окне свойств установить переключатель в положение "Выполнять для всех пользователей", и отметить флаг "Выполнить с наивысшими правами". Также можно сменить пользователя, от которого будет выполняться задание. После подтверждения ввести пароль пользователя.

25. Повторить шаги 18 - 23 для приложения Workflow Manager задав следующие параметры:

"Имя" задачи: "Vitro Workflow Manager .Net Web Application"
"Программа или сценарий":  "C:\Program Files\Vitro Software\Vitro\Server\Vitro.Server.Workflow.Manager.Web\Vitro.Server.Workflow.Manager.Web.exe"
аргументы команды: /urls http://localhost:4616
"рабочая папка" C:\Program Files\Vitro Software\Vitro\Server\Vitro.Server.Workflow.Manager.Web

26. запустить задания вручную и проверить выполняется ли прослушивание на портах, заданных в аргументах команд (здесь 4615 и 4616) для адреса Lo интерфейса:

netstat -a | findstr 4615
netstat -a | findstr 4616

   Имя    Локальный адрес        Внешний адрес          Состояние
...
  TCP    127.0.0.1:4615           Vitrow2k16:0           LISTENING   ...
  TCP    127.0.0.1:4616           Vitrow2k16:0           LISTENING   ...

27. Настроить обратное проксирование.
Обратное проксирование можно настроить с помощью различных программных средств, с учетом предпочтений заказчика. В отдельной статье рассмотрена настройка обратного проксирования через IIS.
В рамках данной статьи рассматривается наиболее предпочтительный вариант с использованьем NGINX в качестве обратного прокси. Пример конфигурационного файла NGINX (nginx.conf):

C:\nginx\conf\nginx.conf

worker_processes  1;

# Расширенный лог для отладки
#error_log  logs/error.log info; 

events {
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;

    sendfile        on;
    client_max_body_size 20G;
    
    # КРИТИЧНО: Увеличиваем буферы для тяжелых Kerberos-тикетов
    large_client_header_buffers 4 64k;
    proxy_buffer_size   128k;
    proxy_buffers   4 256k;
    proxy_busy_buffers_size   256k;

    # Поддержка постоянных соединений с браузером
    keepalive_timeout  300s;
    keepalive_requests 1000;

    # 1. Настройка Upstream с Keep-Alive (обязательно для Negotiate/NTLM)
    upstream vitros_backend {
        server 127.0.0.1:4615;
        keepalive 64; 
    }

    # Редирект с HTTP на HTTPS
    server {
        listen 80 default_server;
        listen [::]:80 default_server;
        server_name dev-vs.vitro.dev;

        if ( $host != "dev-vs.vitro.dev" ){
            return 444;
        }

        return 301 https://$host$request_uri;
    }

    # Основной SSL сервер
    server {
        listen 443 ssl default_server;
        listen [::]:443 ssl default_server;
        server_name dev-vs.vitro.dev;

        ssl_certificate     C:/nginx/conf/ssl/dev-vs.vitro.dev.crt;
        ssl_certificate_key C:/nginx/conf/ssl/dev-vs.vitro.dev.key;
        ssl_protocols TLSv1.2 TLSv1.3;
        
        # Оптимизация SSL для Windows
        ssl_session_cache shared:SSL:10m;
        ssl_session_timeout 10m;

        if ( $host != "dev-vs.vitro.dev" ){
            return 444;
        }

        # Общие настройки проксирования для Windows Auth
        proxy_http_version 1.1;
        proxy_pass_request_headers on;
        proxy_pass_request_body    on;
        proxy_read_timeout 1h;
        proxy_send_timeout 1h;

        location / {
            # 2. Используем upstream
            proxy_pass http://vitros_backend;

            # 3. КРИТИЧНО: Отключаем буферизацию для трансляции NTLM-рукопожатия
            proxy_buffering off;
            proxy_request_buffering off;

            # 4. Сбрасываем заголовок Connection для работы Keep-Alive до бэкенда
            proxy_set_header Connection ""; 
            
            # 5. Проброс заголовков
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
            
            # Для поддержки WebSockets
            proxy_set_header Upgrade $http_upgrade;
            # proxy_set_header Connection "upgrade"; # Раскомментируйте, если нужны только сокеты
        }

        location /workflow/manager {
            proxy_pass http://localhost:4616/workflow/manager;
            proxy_http_version 1.1;
            proxy_set_header Connection "";
            proxy_buffering off;
            proxy_set_header Host $host;
        }	
    }
}

Примечание: Файлы *.crt и *.key для https протокола можно получить из pfx файла сертификата. На примере самоподписанного сертификата IIS (не рекомендуется для продукционных сред!):

Откройте IIS Manager → выберите сервер → Server Certificates → Create Self-Signed Certificate.
Кликните правой кнопкой на созданный сертификат → Export. Сохраните его как файл .pfx с паролем.
С помощью утилиты openssl (она часто идет в комплекте с Git для Windows или ставится отдельно), чтобы вытащить ключ и сертификат:
1. Извлечь ключ
```
openssl pkcs12 -in dev-vs.vitro.dev.pfx -nocerts -out dev-vs.vitro.dev.key -nodes
```
2. Извлечь сертификат
```
openssl pkcs12 -in dev-vs.vitro.dev.pfx -clcerts -nokeys -out dev-vs.vitro.dev.crt
```

Добавление шаблонов рабочих процессов

Перейти на вкладку Workflow Defenitions в Elsa
http://vitro.example.ru/workflow/manager/workflow-definitions
где vitro.example.ru - адрес сайта
Нажать Create workflow
Нажать Import
Выбрать файл шаблона из папки workflows дистрибутива
После загрузки шаблона нажать Publish
Перейти обратно на вкладку Workflow defenitions и убедиться, что шаблон создан
Таким образом добавить все шаблоны из папки workflows дистрибутива

Настройка системы

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

Для этого нужно:

Перейти в список Конфигурация пространства Центр Администрирования (список по умолчанию скрыт).
Открыть папку Общие настройки
Для ключа Адрес портала указать в поле Значение (строка) адрес портала в виде https://example.com
Важно!
Адрес портала не должен заканчиваться символом слэша.

Добавление лицензии

Для работы серверной части требуется лицензионный ключ.

Если лицензионного ключа нет, то запросы на обновление элементов выдают ошибку "Лицензионные ограничения".

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

После установки лицензионный ключ необходимо разместить в списке Лицензии пространства Центр администрирования.

Ссылка на список выведена в сайдбар:

Page tree

Порядок действий по установке серверной части Vitro-CAD (Windows)

Настройка системы

Добавление лицензии