Общие сведения

При развертывании on-site приложения bpm’online необходимо, чтобы сервера, на которых разворачиваются компоненты системы, а также клиентские компьютеры, на которых запускается система, отвечали определенным техническим требованиям. Эти требования подробно описаны в статьях "Системные требования к серверам" и "Системные требования к клиентскому компьютеру". Соблюдение этих технических требований обеспечит высокую эффективность и производительность работы системы.

Чтобы установить bpm’online на СУБД MS SQL, необходимо выполнить следующую последовательность шагов:

1. Включить и установить обязательные компоненты Windows на сервере приложения.
2. Установить СУБД MS SQL Server на компьютере сервера баз данных.
3. Установить хранилище данных Redis на компьютере сервера хранения сессий пользователей.
4. Установить сервер SVN на компьютере хранилища пакетов.
5. Установить приложение bpm’online на компьютере сервера приложений.

ВАЖНО Для обеспечения совместимости с облачной инфраструктурой площадки Terrasoft предоставляемая база данных приложения должна быть создана в SQL Server 2016.

К СВЕДЕНИЮ Процедура установки MS SQL Server, сервера SVN и сервера хранилища данных Redis описана в документации к этим программным продуктам.

Установка и настройка обязательных компонентов Windows

ВАЖНО В этой статье приведены компоненты, которые необходимо включить в операционных системах Windows 8 и Windows 10.

Чтобы проверить наличие необходимых компонентов, необходимо на панели управления Windows ([Control Panel]) в разделе [Programs and Features] выбрать команду [Turn Windows features on or off] (рис. 1).

Рис. 1. — Команда настройки компонентов панели управления Windows

В появившемся окне [Windows Features] (рис. 2) нужно проверить наличие и при необходимости выбрать для установки компоненты, приведенные в таблице 1.

Рис. 2. — Окно [Windows Features]

Табл. 1. — Обязательные компоненты Windows

К СВЕДЕНИЮ При необходимости можно установить и другие компоненты, например, FTP Server.

ВАЖНО Чтобы установить и запустить IIS-сервер на операционной системе Windows 7, необходимо в командной строке выполнить команду "C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe –i".

Последовательность установки приложения bpm’online

1. Разархивировать приложение

Для этого необходимо распаковать zip-архив с приложением в папку на сервере приложений, например C:\bpmonline.

2. Восстановить базу данных из резервной копии

Для этого необходимо скопировать на сервер баз данных файл резервной копии базы данных, который находится в папке db распакованного приложения, например C:\bpmonline\db.

Для восстановления базы данных из резервной копии необходимо запустить Microsoft SQL Management Studio и в контекстном меню раздела Database выбрать команду [Restore Database...] (рис. 3).

Рис. 3. — Восстановление базы данных из файла резервной копии

В открывшемся окне в качестве источника необходимо выбрать [Device] и затем указать путь к файлу резервной копии базы данных (рис. 4).

Рис. 4. — Настройка восстановления базы данных из файла резервной копии

После нажатия на кнопку [OK] запустится процесс восстановления базы данных.

ВАЖНО Если необходимо подключаться к базе данных не как пользователю домена, а как пользователю базы данных (например, USER_NAME), то необходимо добавить пользователя USER_NAME во владельцы восстановленой базы данных.

3. Настроить ConnectionStrings.config

Файл ConnectionStrings.config находится в корневой папке приложения, например C:\bpmonline. По своей структуре это обычный XML-файл. В нем необходимо указать следующую информацию:

Элемент <db>

• DataSource — сервер баз данных, на котором развернута база данных.
• InitialCatalog — название развернутой базы данных. 

<add name="db" connectionString="Data Source=DBSERVER;Initial Catalog=BPMonline78;User ID=CustomUser;Password=CustomPassword; Persist Security Info=True; MultipleActiveResultSets=True; Pooling = true; Max Pool Size = 100; Async = true" />

Элемент <redis>

• host — имя компьютера, на котором развернут сервер Redis.

ВАЖНО Рекомендуется указывать сетевое имя машины вместо localhost. В условиях высокой нагрузки использование настройки с localhost может привести к снижению быстродействия.

•  db — номер базы данных, которая будет использоваться для хранения сессий (количество доступных баз данных настраивается в конфигурационном файле Redis).

ВАЖНО Каждому приложению bpm'online должен соответсвовать свой уникальный номер базы данных Redis.

Элемент <reports>

• DataSource — сервер баз данных, на котором развернута база данных.
• InitialCatalog — название развернутой базы данных.

ВАЖНО Настройка сервера, базы данных, пользователя и пароля в секции <reports> должна быть полностью идентична секции <db>.

Элемент <defPackagesWorkingCopyPath>

Рекомендуется чтобы атрибут connectionString указывал на конкретный путь на локальной машине. По этому пути будут выгружены рабочие копии пакетов приложения.

Элемент <sourceControlAuthPath>

Рекомендуется чтобы атрибут connectionString указывал на конкретный путь на локальной машине.  Туда будет сохраняться клиентская идентификационная информация для аутентификации в хранилище.

Элемент <elasticsearchCredentials>

Содержит настройки с параметрами доступа пользователя, используемые для использования сервиса глобального поиска (Elasticsearch).

Ниже приведен пример настройки файла ConnectionStrings.config:

<?xml version="1.0" encoding="utf-8"?>
<connectionStrings>
    <add name="db" connectionString="Data Source=DBSERVER;Initial Catalog=BPMonline710;User ID=CustomUser;Password=CustomPassword; Persist Security Info=True; MultipleActiveResultSets=True; Pooling = true; Max Pool Size = 100; Async = true" />
    <add name="redis" connectionString="host=RedisServer;db=0;port=6379;maxReadPoolSize=25;maxWritePoolSize=25" />
    <add name="reports" connectionString="XpoProvider=MSSqlServer;Data Source=DBSERVER;Initial Catalog=BPMonline710;User ID=CustomUser;Password=CustomPassword" />
    <add name="defWorkingCopyPath" connectionString="C:\Projects\WorkingCopy" />
    <add name="defPackagesWorkingCopyPath" connectionString="C:\Projects\TerrasoftPackages" />
    <add name="clientUnitContentPath" connectionString="C:\Projects\Dev\ClientUnitSrc" />
    <add name="sourceControlAuthPath" connectionString="C:\Projects\WorkingCopy\Svn" />
    <add name="elasticsearchCredentials" connectionString="User=gs-es; Password=DEQpJMfKqUVTWg9wYVgi;" />
</connectionStrings>

К СВЕДЕНИЮ Файл ConnectionStrings.config может содержать и другие настройки. Но в большинстве случаев они больше не используются системой и в дальнейшем будут удалены.

4. Настроить внутренний Web.config

Внутренний Web.config, который находится в папке Terrasoft.WebApp, настраивается следующим образом:

Элемент <appSettings>

• UseSvn — по умолчанию не отображается в Web.config. По умолчанию он имеет значение true, т.е. в разделе [Конфигурация] присутствует функциональность по работе с хранилищами SVN. Однако, если эту функциональность нужно отключить, то в Web.config необходимо добавить элемент UseSvn=false.

• SeparatedJsFiles — нужен для того, чтобы при отладке код JavaScript-страницы отображался в удобочитаемом виде. Если этого параметра нет, то его можно добавить. Не обязателен.

Ниже приведен пример настройки внутреннего Web.config (секция <appSettings>):

<appSettings>
  ...
  <add key="UseSvn" value="true" />
  ...
  <add key="IncludeDebugInformation" value="true" />
  ...
  <add key="CompilerSourcesTempFolderPath" value="C:\Projects\Dev\src" />
  ...
</appSettings>

5. Выполнить настройку сайта приложения на IIS.

Для этого необходимо запустить менеджер Internet Information Services и добавить новый веб-сайт (рис. 5).

Рис. 5. — Добавление веб-сайта приложения в IIS

В настройках сайта указать произвольное имя сайта, а в качестве каталога содержимого указать корневую папку приложения (рис. 6). Также в этом окне можно указать внешний веб-адрес сайта.

Рис. 6. — Параметры создаваемого приложения

Затем в списке пулов приложений проверить версию среды .NET для созданного пула — должна быть указана версия v4.0 и режим управляемого конвейера [Встроенный]. Если указана другая версия или другой режим, то их необходимо изменить (рис. 7), выбрав пункт [Основные настройки...] на панели [Действия].

Рис. 7. — Установка необходимой версии среды .NET

Затем для созданного пула следует в контекстном меню выберать пункт [Дополнительные параметры...]. В открывшемся окне, в поле [Тайм-аут простоя (в минутах)] нужно установить значение “0” (рис. 8).

Рис. 8. — Установка тайм-аута простоя

Далее следует указать учетную запись, которую должно использовать приложение для доступа к паке с приложением в файловой системе. Для этого следует нажать на кнопку [...] в поле [Удостоверение] ([Identity]), чтобы отредактировать это свойство. В открывшемся окне нужно выбрать опцию [Особая учетная запись] и нажать на кнопку [Установить].

Затем следует ввести имя пользователя и пароль доменной учетной записи, которую должно использовать приложение для доступа к файловой системе. Например, это может быть доменный пользователь, от имени которого был запущен установщик bpm’online (рис. 9).

Рис. 9. — Настройка удостоверения для пула приложения

В веб-сайт необходимо добавить приложение (рис. 10).

Рис. 10. — Добавление приложения к веб-сайту

В настройках приложения указать псевдоним приложения — [0], а в качестве физического пути указать путь к каталогу Terrasoft.WebApp (рис. 11).

Рис. 11. — Настройки создаваемого приложения

ВАЖНО Приложение [0] соответствует рабочему пространству [Default]. Перед созданием нового рабочего пространства необходимо каждый раз добавлять новое приложение к веб-сайту системы, указывая в качестве псевдонима следующий последовательный номер (1, 2, ...). Остальные настройки приложений должны быть такими же, как в приложении [0].

Также необходимо убедиться в том, что:

a. Для используемой версии ASP.NET не установлены ограничения для ISAPI и CGI (рис. 12).

Рис. 12. — Ограничения ISAPI и CGI

b. Включена Forms-аутентификация (рис. 13).

Рис. 13. — Настройки аутентификации

Используемые порты

По умолчанию используются следующие порты: