Page History

...

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

Warning

title	Важно!

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

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

Warning

title	Важно!

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

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

...

Code Block

language	bash

postgres-#CREATE DATABASE vitrodb withWITH ownerOWNER = vitrodbuser encodingENCODING = 'UTF8' connection limit LOCALE_PROVIDER = 'icu' ICU_LOCALE = -1;'ru-u-kn-true' TEMPLATE = template0 CONNECTION_LIMIT = -1;

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

Code Block

language	bash

postgres-#CREATE DATABASE workflow withWITH ownerOWNER = vitrodbuser encodingENCODING = 'UTF8' LOCALE_PROVIDER = 'icu' ICU_LOCALE = 'ru-u-kn-true' TEMPLATE = connectiontemplate0 limitCONNECTION_LIMIT = -1;

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

...

Code Block

language	js
title	Json

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

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

Указать адрес и порт SMTP сервера
изменить параметр "BaseUrl", указав корректный Url сайта
:
Code Block
language

...

bash
"

...

Host": "

...

smtp.example.ru",

...

изменить параметр
"
PortalUrl
Port"
, указав корректный Url сайта
: 587,
Указать данные УЗ для подключения к SMTP серверу:
Code Block
language

...

bash

...

"

...

Login": "

...

mail@example.ru",

...

"Password": "123456",
Указать адрес отправителя
изменить параметр "BasePath", указав корректный корректный относительный путь для Url
:
Code Block
language

...

bash

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

...

mail@example.ru",
Указать
логин/пароль учетной записи администратора
используется ли SSL для подключения к SMTP серверу:
Code Block
language

...

bash
"

...

EnableSsl":

...

true,
Убедиться, что есть параметр SecureSocketOptions

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

Указать адрес и порт SMTP сервера:
Code Block
language bash
"HostSecureSocketOptions": "smtp.example.ru", "Port": 587,
Указать данные УЗ для подключения к SMTP серверу:
Code Block
language bash
"Login": "mail@example.ru", "Password": "123456",
Указать адрес отправителя:
Code Block
language bash
"FromAddress": "mail@example.ru", "FromName": "mail@example.ru",
Указать используется ли SSL для подключения к SMTP серверу:
Code Block
language bash
"EnableSsl": true,
Убедиться, что есть параметр SecureSocketOptions:
Code Block
language bash
"SecureSocketOptions": "StartTls"
Остальные параметры оставить по умолчанию.

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

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

Image Removed

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

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

"StartTls"
Остальные параметры оставить по умолчанию.

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

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

Image Added

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

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

Image Added

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

Image Added

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

Image Added

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

Image Added

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

в строке "рабочая папка" указать (без кавычек) путь к папке приложения

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

Image Added

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

Image Added

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

Code Block

language	powershell

...

"Имя" задачи: "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 интерфейса

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

Image Removed

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

Image Removed

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

Code Block

language	powershell

"Имя" задачи: "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 интерфейса:

Code Block

language	powershell

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

   Имя    Локальный адрес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        Состояние
 ...
  TCP    127.0.0.1:4615           Vitrow2k16:0           LISTENING   ...
  TCP    127.0.0.1:4616           Vitrow2k16:0

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

Code Block

language	yml
title	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       LISTENING   ...

27. Настроить обратное проксирование.
Если планируется использование авторизации через Kerberos, то необходимо настроить обратное проксирование через IIS.
Иначе возможно использовать NGINX в качестве обратного прокси.
Пример конфигов для обратного проксирования для NGINX (for Windows):

Code Block

language	yml
title	C:\nginx\conf\nginx.conf

#user  nobody;
worker_processes  1;

#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;

#pid        logs/nginx.pid;


events {
    worker_connections  1024;
}


http {
    include       mime.types;
    default_type  application/octet-streamon;
    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;

    #log_format# 1. mainНастройка Upstream '$remote_addrс Keep-Alive $remote_user [$time_local] "$request" '
    #(обязательно для Negotiate/NTLM)
    upstream vitros_backend {
        server 127.0.0.1:4615;
        keepalive 64; 
 '$status $body_bytes_sent "$http_referer" ' }

    # Редирект с HTTP на HTTPS
    server {
         '"$http_user_agent" "$http_x_forwarded_for"';

listen 80 default_server;
      #access_log  logs/access.log  main;
listen [::]:80 default_server;
    sendfile    server_name dev-vs.vitro.dev;

   on;
    #tcp_nopush if ( $host  on;

!= "dev-vs.vitro.dev" ){
     #keepalive_timeout  0;
    keepalive_timeout return 65444;

      #gzip  on;}

server {
       return listen 80 default_server;
		server_name vitro.example.ru;
  
 301 https://$host$request_uri;
    }

    # Основной  client_max_body_size 100000M;
        
        proxy_http_versionSSL сервер
    server {
        listen 443  1.1;
		proxy_pass_request_headers on;
		proxy_pass_request_bodyssl default_server;
     on;       listen [::]:443 ssl default_server;
      

		proxy_buffer_size   1M;server_name dev-vs.vitro.dev;

        proxyssl_bufferscertificate    4 1M C:/nginx/conf/ssl/dev-vs.vitro.dev.crt;
        proxyssl_readcertificate_timeout 1hkey C:/nginx/conf/ssl/dev-vs.vitro.dev.key;
        proxy_send_timeout 1h; 

        location / {ssl_protocols TLSv1.2 TLSv1.3;
        
        # Оптимизация SSL для  Windows
   #proxying traffic to upstream application (Vitro.Server.Core.Web)
 ssl_session_cache shared:SSL:10m;
        ssl_session_timeout 10m;

        if ( $host proxy_pass http://127.0.0.1:4615;
				proxy_set_header X-Real-IP $remote_addr;
				proxy_set_header!= "dev-vs.vitro.dev" ){
             X-Forwarded-Forreturn 444;
     $proxy_add_x_forwarded_for;
				proxy_set_header   }

      X-Forwarded-Proto   $scheme;
				proxy_set_header Host $host;         
		}
 
# Общие настройки проксирования для Windows Auth
         location /workflow/manager {
proxy_http_version 1.1;
        proxy_pass_request_headers on;
        proxy_pass http://localhost:4616/workflow/manager;_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. Code Block
  title Извлечь ключ
  openssl pkcs12 -in dev-vs.vitro.dev.pfx -nocerts -out dev-vs.vitro.dev.key -nodes
2. Code Block
  title Извлечь сертификат
  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
Image Added
Нажать Import
Image Added
Выбрать файл шаблона из папки workflows дистрибутива
Image Added
После загрузки шаблона нажать Publish
Image Added
Перейти обратно на вкладку Workflow defenitions и убедиться, что шаблон создан
Таким образом добавить все шаблоны из папки workflows дистрибутива

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

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

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

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

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

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

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

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

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

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

Image Added

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

Перейти на вкладку Workflow Defenitions в Elsa
http://vitro.example.ru/workflow/manager/workflow-definitions
где vitro.example.ru - адрес сайта

Нажать Create workflow

Image Removed
Нажать Import

Image Removed
Выбрать файл шаблона из папки workflows дистрибутива

Image Removed
После загрузки шаблона нажать Publish

Image Removed
Перейти обратно на вкладку Workflow defenitions и убедиться, что шаблон создан

Таким образом добавить все шаблоны из папки workflows дистрибутива

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

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

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

Перейти в список Конфигурация пространства Центр Администрирования.

Открыть папку Общие настройки

Для ключа Адрес портала указать в поле Значение (строка) адрес портала в виде https://example.com

WarningВажно!
Адрес портала не должен заканчиваться символом слэша.

Page tree

Versions Compared

Old Version 23

New Version Current

Key

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

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

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