Установка bpm’online

Для установки bpm’online требуются следующие компоненты:

1.MS SQL Server 2012 SP3 или Oracle Database 11g Release 2 и выше;

2.Microsoft .Net Framework 4.5 и выше;

3.IIS 7 и выше;

4.Redis Server 2.8, 3.0 или 3.2.

В общем случае для разворачивания bpm'online on-site приложения вам необходимо:

•Включить и установить обязательные компоненты Windows;

•Установить сервер Redis;

•Развернуть базу данных;

•Внести изменения в файл конфигурации ConnectionStrings.config;

•Создать и настроить сайт приложения в IIS.

Обратите внимание, что установка bpm’online on-site отличается для MS SQL Server 2012 SP3 и Oracle Database 11g Release 2.

На заметку

Процедура развертывания MS SQL Server или Oracle Database 11g и сервера SVN описана в документации к этим программным продуктам.

Важно

Не рекомендуется распаковывать файлы при помощи встроенного архиватора Windows. Воспользуйтесь программами 7-Zip, WinRAR или WinZIP.

Содержание

•Развертывание базы данных bpm’online

•Установка Redis Server

•Настройка ConnectionStrings.config

•Настройка web.config (только Oracle)

•Проверка обязательных компонентов Windows

•Создание и настройка сайта приложения в IIS

Развертывание базы данных bpm’online

Разверните на SQL-сервере базу данных bpm’online, восстановив ее из файла резервной копии, который находится в папке \db с файлами приложения. Процесс отличается для MS SQL Server и Oracle Database. При необходимости вы можете использовать копию базы данных своей рабочей версии приложения, если, например, разворачиваете тестовый сайт. Процесс создания резервной копии БД MS SQL Server доступен по ссылке.

Развертывание базы данных MS SQL Server

Для восстановления базы данных:

1.Авторизируйтесь в Microsoft SQL Server Management Studio.

2.Нажмите правой клавишей мыши по каталогу [Databases] и в контекстном меню выберите команду [Restore Database] (Рис. 439).

Рис. 439 — Выбор команды восстановления базы данных

 

3. В окне [Restore Database]:

a.В поле [Database] введите название базы данных;

b.Выберите переключатель [Device] и укажите путь к файлу резервной копии базы данных. По умолчанию данный файл находится в директории ~\db с исполняемыми файлами bpm’online (Рис. 440).

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

 

4.Перейдите на вкладку [Files]. В области [Restore the database files as] укажите пути к файлам базы данных и имена для этих файлов (Рис. 441). Также укажите пути к файлам базы данных TS_Data.mdf и TS_Log.ldf.

Важно

Необходимо заранее создать папку, которая будет указываться для восстановления файлов базы данных, т.к. SQL сервер не имеет прав на создание директорий.

Рис. 441 — Указание названий файлов и путей размещения файлов TS_Data.mdf и TS_Log.ldf.

 

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

Развертывание базы данных Oracle Database

Скачайте и разархивируйте архив с SQL-скриптами, которые используются для развертывания базы данных из файла дампа Oracle.

Чтобы развернуть базу данных:

1.Откройте скрипты CreateUser.sql и RecompileSchema.sql в текстовом редакторе и замените значения макросов:

•YOUR_SCHEMA_NAME — имя схемы;

•YOUR_SCHEMA_PASSWORD — пароль для схемы;

•\\your_server.com\Share — путь к файлу резервной копии .dmp.

На заметку

По умолчанию файл резервной копии базы данных Oracle .dmp находится в директории ~\db с исполняемыми файлами bpm’online. Если файл дампа находится не на сервере Oracle, то необходимо разместить его в сетевой папке с общим доступом.

2.Откройте файл резервной копии базы данных .dmp в текстовом редакторе, найдите и сохраните название используемой схемы, которое находится перед записью “.SYS_EXPORT_SCHEMA” (Рис. 442).

Рис. 442 — Просмотр названия схемы в файле дампа базы данных

 

3.Перенесите отредактированные скрипты на сервер Oracle. Из директории со скриптами в командной строке выполните команду для создания новой схемы:

sqlplus.exe "SYS/SYS_PASSWORD@your_server.com:1521/YOUR_SERVICE_NAME AS SYSDBA" @CreateUser.sql

•SYS_PASSWORD — пароль для авторизации на сервере Oracle;

•your_server.com — сетевой адрес сервера Oracle;

•YOUR_SERVICE_NAME — имя сервиса Oracle.

4.Выполните импорт бекапа базы данных в созданную схему:

impdp "YOUR_SCHEMA_NAME/YOUR_SCHEMA_NAME@//your_server.com:1521/BPMBUILD"
REMAP_SCHEMA=ORIGINAL_SCHEMA_NAME:YOUR_SCHEMA_NAME
DIRECTORY=BACKUPDIR DUMPFILE=filename.dmp NOLOGFILE=YES

•YOUR_SCHEMA_NAME — имя схемы, прописанной в CreateUser.sql;

•your_server.com — сетевой адрес сервера Oracle;

•ORIGINAL_SCHEMA_NAME — название схемы из файла дампа (шаг 2).

На заметку

Утилиты sqlplus и impdp устанавливаются вместе с сервером Oracle.

5.Последовательно выполните команды:

sqlplus.exe "YOUR_SCHEMA_NAME/YOUR_SCHEMA_PASSWORD@your_server.com:1521/YOUR_SERVICE_NAME"
@tspkg_UtilitiesGlobalTypes.sql

sqlplus.exe "YOUR_SCHEMA_NAME/YOUR_SCHEMA_PASSWORD@your_server.com:1521/ YOUR_SERVICE_NAME"
@RecompileSchema.sql

Установка Redis Server

Redis Server устанавливается как сервис при помощи установочного файла.

Для установки Redis Server запустите файл redis-server.exe. В ходе установки будет последовательно запущено несколько команд. После завершения каждой из них необходимо нажать [Далее] и дождаться завершения процесса.

После установки запустите Redis Server. Для этого перейдите в меню [Control Panel]–>[Administrative Tools]–>[Services] или в командной строке наберите Services.msc (Рис. 443).

Рис. 443 — Окно запуска сервиса Redis Server

 

Настройка ConnectionStrings.config

Настройки конфигурационного файла ConnectionStrings.config различаются для MS SQL Server и Oracle Database.

Настройка ConnectionStrings.config для MS SQL Server

1.Отредактируйте файл ConnectionStrings.config, который находится в корневой папке сайта bpm’online. Укажите в нем параметры подключения (сonnectionString) к восстановленной базе данных (name=”db”) и к Redis Server (name=”redis”).

<?xml version="1.0" encoding="utf-8"?>
<connectionStrings>
<add name="db" connectionString="Data Source=TSW\MSSQL2014;
Initial Catalog=7.10.2.1416_SalesEnterprise_Demo;
Persist Security Info=True; MultipleActiveResultSets=True;
Integrated Security=SSPI; Pooling = true; Max Pool Size = 100; Async = true" />
  <add name="redis" connectionString="host=[Имя компьютера];db=[Номер БД Redis];port=6379;
maxReadPoolSize=25;maxWritePoolSize=25" />
 <add name="reports" connectionString="XpoProvider=MSSqlServer;
Data Source=TSW\MSSQL2014;Initial Catalog=7.10.2.1416_SalesEnterprise_Demo;
Integrated Security=SSPI" />
 <add name="defRepositoryUri" connectionString="" />
<add name="defWorkingCopyPath" connectionString="%TEMP%\%WORKSPACE%" />
 <add name="defPackagesWorkingCopyPath"
connectionString="%TEMP%\%APPLICATION%\%WORKSPACE%\TerrasoftPackages" />
 <add name="clientUnitContentPath"
connectionString="%TEMP%\%APPLICATION%\%WORKSPACE%\ClientUnitSrc" />
 <add name="sourceControlAuthPath"
connectionString="%TEMP%\%APPLICATION%\%WORKSPACE%\Svn" />
<add name="elasticsearchCredentials" connectionString="User=gs-es; Password=DEQpJMfKqUVTWg9wYVgi;" />
</connectionStrings>

Важно

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

2.Имя сервера баз данных (Data Source) можно увидеть в окне авторизации при подключении к серверу из Microsoft SQL Server Management Studio (Рис. 444).

Рис. 444 — Окно авторизации на SQL сервер

 

3.Имя базы данных (Initial Catalog) должно совпадать со значением поля [Database], которое вы указали при восстановлении базы данных (Рис. 440).

Настройка ConnectionStrings.config для Oracle Database

1.Отредактируйте файл ConnectionStrings.config, который находится в корневой папке сайта bpm’online. Укажите в нем параметры подключения (сonnectionString) к восстановленной базе данных (name=”db”) и отчетам (name=”reports”), а также к Redis Server (name=”redis”).

<?xml version="1.0" encoding="utf-8"?>
<connectionStrings>
 <add name="db" connectionString="Data Source=(DESCRIPTION =
(ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = [Сетевой адрес
сервера])(PORT = 1521))) (CONNECT_DATA = (SERVICE_NAME = [Имя сервиса
Oracle]) (SERVER = DEDICATED)));User Id=[Имя схемы];Password=[Пароль
схемы];Statement Cache Size = 300" />
 <add name="redis" connectionString="host=[Имя компьютера];db=[Номер
БД Redis];port=6379;
maxReadPoolSize=25;maxWritePoolSize=25" />
 <add name="reports" connectionString="XpoProvider=Oracle;Data
Source=(DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL =
TCP)(HOST = [Сетевой адрес сервера])(PORT = 1521))) (CONNECT_DATA =
(SERVICE_NAME = [Имя сервиса Oracle]) (SERVER = DEDICATED)));User
Id=[Имя схемы];Password=[Пароль схемы];Statement Cache Size = 300" />
 <add name="defRepositoryUri" connectionString="" />
<add name="defWorkingCopyPath" connectionString="%TEMP%\%WORKSPACE%" />
 <add name="defPackagesWorkingCopyPath"
connectionString="%TEMP%\%APPLICATION%\%WORKSPACE%\TerrasoftPackages" />
 <add name="clientUnitContentPath"
connectionString="%TEMP%\%APPLICATION%\%WORKSPACE%\ClientUnitSrc" />
 <add name="sourceControlAuthPath"
connectionString="%TEMP%\%APPLICATION%\%WORKSPACE%\Svn" />
</connectionStrings>

Важно

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

В конфигурационном файле необходимо указать сетевой адрес сервера, имя сервиса Oracle, имя схемы восстановленной базы данных и пароль к ней.

Настройка web.config (только Oracle)

Также необходимо настроить конфигурационный файл Web.config, который находится в корневой директории приложения bpm’online:

1.В параметре general блока <db> измените значение атрибута currentSchemaName на имя схемы, которая указана в ConnectionStrings.config:

<db>
    <general securityEngineType="Terrasoft.DB.Oracle.OracleSecurityEngine, Terrasoft.DB.Oracle"
executorType="Terrasoft.DB.Oracle.OracleExecutor, Terrasoft.DB.Oracle"
isCaseInsensitive="true" maxAnsiJoinCount="0"
engineType="Terrasoft.DB.Oracle.OracleEngine, Terrasoft.DB.Oracle"
metaEngineType="Terrasoft.DB.Oracle.OracleMetaEngine,
Terrasoft.DB.Oracle"
metaScriptType="Terrasoft.DB.Oracle.OracleMetaScript,
 Terrasoft.DB.Oracle" typeConverterType="Terrasoft.DB.Oracle.OracleTypeConverter,
Terrasoft.DB.Oracle" connectionStringName="db"
binaryPackageSize="1048576" useOrderNullsPosition="true"
 currentSchemaName="[Имя схемы базы данных Oracle]" maxEntitySchemaNameLength="30" />
</db>

2.Снимите комментарий с блока <system.data>, проверьте, что указана версия библиотеки 4.112.1.2.

<system.data>
       <DbProviderFactories>
           <remove invariant="Oracle.DataAccess.Client" />
           <add name="Oracle Data Provider for .NET"
invariant="Oracle.DataAccess.Client" description="Oracle Data
 Provider for .NET" type="Oracle.DataAccess.Client.OracleClientFactory, Oracle.DataAccess,
Version=4.112.1.2, Culture=neutral, PublicKeyToken=89b483f429c47342"/>
       </DbProviderFactories>
   </system.data>

3.В блоке <quartz> укажите значение ключа quartz.dataSource.SchedulerDb.provider:

<add key="quartz.dataSource.SchedulerDb.provider" value="OracleODP-20" />

4.Сохраните изменения.

Проверка обязательных компонентов Windows

Перед созданием и настройкой web-сайта убедитесь, что на веб-сервере установлены компоненты Web Server IIS и компоненты Windows.

Чтобы проверить наличие необходимых компонентов:

1.В поиске меню [Пуск] введите “control panel” и выберите пункт [Control Panel] (Рис. 445)

Рис. 445 — Раздел [Control Panel] меню [Пуск]

 

2.В открывшемся окне выберите пункт меню [Programs] (Рис. 446).

Рис. 446 — Меню [Programs] панели управления Windows

 

3.В разделе меню [Programs and Features] выберите команду [Turn Windows features on or off] (Рис. 447).

Рис. 447 — Команда [Turn Windows features on or off]

 

4.В окне [Windows Features] выберите все необходимые компоненты (Рис. 448).

Рис. 448 — Окно включения компонентов Web Server IIS и Windows

 

Создание и настройка сайта приложения в IIS

Для создания и настройки web-сайта:

1.В окне управления IIS щелкните правой клавишей мыши по [Sites] и выберите [Add Website] в контекстном меню (Рис. 449).

Рис. 449 — Создание сайта для приложения bpm’online

 

2.Укажите название сайта, путь к корневому каталогу с файлами bpm’online, используемые IP-адреса и порт сайта (Рис. 450).

Важно

Путем по умолчанию для web-сайтов является путь C:\Inetpub\wwwroot. В случае необходимости можно указать свой адрес.

Рис. 450 — Окно параметров нового сайта

 

3.В области [Connections] щелкните правой клавишей мыши по созданному сайту и выберите команду [Add Application] контекстного меню (Рис. 451).

Рис. 451 — Выбор команды добавления приложения в IIS

 

4.Введите имя приложения “0” в поле [Alias]. Укажите директорию “Terrasoft.WEBApp” (Рис. 452).

Рис. 452 — Окно выбора параметров приложения

 

5.Перейдите в секцию [Applications Pools].

6.Выберите пул [BPMonline].

7.В поле [Managed pipeline mode] выберите режим [Integrated].

8.В поле [.Net Framework version] укажите версию Asp.Net - 4.0.30319 (Рис. 453).

Рис. 453 — Окно ввода параметров Applications Pools.

 

9.Проверьте, что введенная версия ASP.Net разрешена. Для этого:

a.Перейдите в ISAPI and CGI Restrictions на уровне web-сервера (Рис. 454).

Рис. 454 — Переход в ISAPI and CGI Restrictions

 

b.Убедитесь что для используемой версии ASP.Net в поле [Restriction] установлен статус [Allowed] (Рис. 455).

Рис. 455 — Проверка статуса используемой версии ASP.Net

 

10.Убедитесь в том, что все необходимые разрешения активны. Для этого:

a.Перейдите в Handler Mappings на уровне сервера (Рис. 456).

Рис. 456 — Переход в Handler Mappings

 

b.Нажмите на [Edit Feature Permissions] в области [Actions].

c.Убедитесь, что в окне [Edit Feature Permissions] установлены все признаки (Рис. 457).

Рис. 457 — Проверка необходимых параметров в окне [Edit Feature Permissions]

 

11.Перезапустите web-сайт при помощи команды [Restart] области [Manage Website] (Рис. 458).

Рис. 458 — Выбор команды [Restart] в области [Manage Websites]

 

12.Откройте сайт, перейдя по адресу или при помощи команды [Browse] (Рис. 459). Убедитесь, что открывается страница авторизации в приложении.

Рис. 459 — Выбор команды [Browse] в области [Actions] веб-сайта

 

На заметку

Первый вход в систему после настройки приложения осуществляется под учетной записью Supervisor (логин — Supervisor; пароль — Supervisor).

Смотрите далее

•Настройка вебсокетов (websockets)

•Перевод bpm’online с HTTP на HTTPS

•Настройка дополнительных параметров и интеграций

•Часто задаваемые вопросы по установке bpm’online