====== Установка и настройка системы ======
''Инструкция для размещения ADVANTA на сервере с ОС Windows и СУБД MS SQL Server''


Перед началом настройки системы ознакомьтесь с актуальными [[product/settings/system/specifications#требования_к_программному_обеспечению_сервера_приложения_и_сервера_базы_данных|требованиями к программному обеспечению]]. 

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

Для начала работы создайте на сервере приложения папку ''SL_Files'' и распакуйте туда содержимое архива (инсталляционного диска), чтобы путь к содержанию папки был: ''C:\SL_Files''
<grid>
<col sm="9">
<callout type="warning" icon="true">На 64х-разрядных операционных системах следует использовать 64х-разрядный IIS (Internet Information Services) и 64х-разрядный .NET Framework.</callout>
</col>
</grid>
===== Подготовка сервера базы данных =====

Для настройки сервера баз данных необходимо запустить //SQL Server Managment Studio// и выполнить следующие действия.
  - В окне «Обозреватель объектов» (//Object Explorer//) правой кнопкой мышки кликнуть на «Базы данных» (//Database//) -> «Восстановить базу данных» (//Restore Database//).  \\  {{ :product:settings:settings_install_1.png }}  \\  <TEXT align="center"> **Рисунок 3.1** -- Параметры разворачивания бэкапа в MS SQL Server 2008 R2</text>
    - В разделе «Общие» (//General//):
      * В поле «В базу данных» (//To database//) ввести название создаваемой из бэкапа базы данных -- ''streamline''.
      * В разделе «Источник для восстановления» (//Source for restore//) выбрать «Устройство» (From device: ).
      * Выбрать бэкап из папки ''C:\SL_Files\DB_Backup\''.
      * В окне «Восстанавливаемые резервные наборы данных» (//Select the backup sets to restore//) выбрать последнюю версию бэкапа (отметить галочкой).
    - В разделе «Параметры» (//Options//) (**или «Файлы» (//Files//) для MS SQL Server 2016**), в окне «Восстановить файлы базы данных как» (//Restore the database files as://) в колонке «Восстановить как» (//Restore as//) нужно переписать названия для файлов данных и лога БД -- для файла данных ввести название ''streamline.mdf'', для файла лога ''streamline_log.lgf''.
      * Нажать на «ОК».  \\  {{ :product:settings:03.02_backup_properties_options.png }}  \\  <TEXT align="center"> **Рисунок 3.2** -- Параметры разворачивания бэкапа в MS SQL Server 2008 R2</text>
  - Создать учетную запись //«advanta»//:
    * В окне «Обозреватель объектов» (//Object Explorer//) раскрыть «Безопасность» (//Security//), нажать правой кнопкой мышки на «Имена входа» (//Logins//)и выбрать «Создать имя входа» (//New Login//).
    * В разделе «Общие» (//General//):
      * В поле «Имя входа» (//Login name//) ввести //advanta//.
      * Выставить опцию «Проверка подлинности SQL Server» (//SQL Server authentication//).
      * Убрать опцию «Требовать использование политики паролей» (//Enforce password policy//).
      * Ввести пароль учетной записи (введенный пароль затем понадобится указать на сервере приложения для доступа к базе данных).
      * Выставить используемый язык «Язык по умолчанию» (//Default language//) выбрав в выпадающем меню «Русский» (//Russian//).
    * Нажать «ОК».
  - Открыть созданную учетную запись. Перейти на страницу «Сопоставление пользователей» (User Mapping):
    * В окне «Пользователи, сопоставленные с этим именем входа» (User mapped to this login) в столбце «Схема» (Map) установить галочку напротив базы streamline.
    * В окне «Членство в роли базы данных для: streamline» (Database role membership for: streamline) выставить права ''db_owner''.<callout type="danger" icon="true" title="ВНИМАНИЕ!">**Схема базы данных** должна оставаться ''dbo''! В противном случае структура базы данных нарушается и последующее обновление системы будет невозможно. \\ ''db_owner'' -- это права доступа пользователя на таблицу в базе данных, а не схема!</callout>
    * Нажать «ОК».
  - Включить функцию интеграции со средой CLR, для чего выполнить следующие действия:
    * в окне Обозреватель объектов (//Object Explorer//) нажать правой кнопкой мыши на базе данных //streamline// и выбрать пункт «Создать запрос» (//New Query//);
    * выполнить следующий скрипт (на инсталляционном диске файл с текстом скрипта -- ''sp_configure.sql'' расположен в папке ''SL_Files\DB_Backup\''):<code sql>
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'clr enabled', 1;
GO
RECONFIGURE;
GO
</code>
  - Выполнить скрипт исключения ошибок взаимоблокировки транзакций (на инсталляционном диске файл с текстом скрипта -- ''READ_COMMITTED_SNAPSHOT.sql'' расположен в папке ''SL_Files\DB_Backup\''):<code sql>
SELECT is_read_committed_snapshot_on FROM
sys.databases WHERE name= DB_NAME();
GO

DECLARE @cmd nvarchar(200)
SET @cmd = 'ALTER DATABASE ' + DB_NAME() + ' SET SINGLE_USER WITH ROLLBACK IMMEDIATE;';
EXEC(@cmd);
GO

DECLARE @cmd nvarchar(200)
SET @cmd = 'ALTER DATABASE ' + DB_NAME() + ' SET READ_COMMITTED_SNAPSHOT ON;';
EXEC(@cmd);
GO

DECLARE @cmd nvarchar(200)
SET @cmd = 'ALTER DATABASE ' + DB_NAME() + ' SET MULTI_USER;';
EXEC(@cmd);
GO
    
SELECT is_read_committed_snapshot_on FROM
sys.databases WHERE name= DB_NAME();
</code>
  - Выполнить скрипт отключения опции принудительной работы по HTTPS:<code sql>Update Core_Settings Set Value = 'False' Where Name = 'USE.SSL'</code><callout type="primary">Скрипт работает только на SQL Server 2008 SP3 c версией 10.50.6000 и выше.</callout>
  - Если у вас SQL Server 2017 и выше, выполнить скрипт для корректной работы OLAP-кубов: <code sql>USE [название базы];
GO

DECLARE @clrName nvarchar(4000);
DECLARE @asmBin varbinary(max);

SELECT @clrName = clr_name FROM sys.assemblies WHERE name = 'StringUtilities'
SELECT @asmBin = content FROM sys.assembly_files WHERE name = 'StringUtilities'

DECLARE @hash varbinary(64);

SELECT @hash = HASHBYTES('SHA2_512', @asmBin);

EXEC sys.sp_add_trusted_assembly @hash = @hash, @description = @clrName;

</code> <callout type="primary">Выполнять скрипт из-под учётной записи с предопределенной ролью сервера sysadmin или с разрешением CONTROL SERVER.</callout>

<callout type="warning" icon="true">Проверьте параметры MS SQL Server, чтобы были разрешены удалённые подключения для учётных записей SQL.</callout>

===== Подготовка сервера приложения =====

Перед проведением работ на сервере приложения в каталоге //C:\Inetpub\wwwroot// необходимо создать папку //streamline// и содержимое //C:\SL_Files\Context_bkp// поместить в созданную папку. Выполнение настройки сервера приложения состоит из нескольких процедур:
  - Установка обязательных компонентов на с сервер с IIS.
  - Настройка Internet Information Services (IIS).
  - Редактирование системных файлов.
  - Получение лицензии.
  - Установка компонентов системы.

Рассмотрим эти процедуры более подробно.

==== Установка обязательных компонентов на с сервер с IIS ====

В мастере настройки дополнительных ролей и компонентов нужно включить роль *«Разработка приложений»*, после чего включить следующие пункты:
  * ASP;
  * ASP .NET 3.5;
  * ASP .NET 4.5.
{{ :product:settings:03.03_vibor_dopolnitelnih_punktov.png }}  \\  
<TEXT align="center">**Рисунок 3.3** -- Настройка ролей и компонентов сервера с IIS</text>

==== Настройка Internet Information Services ====

  - Открыть «Диспетчер служб IIS» (Internet Information Services (IIS) Manager). Далее в разделе «Узлы» (Sites) раскрыть «Веб-узел по умолчанию» (Default web site) и нажать правой кнопкой мыши на папке ''streamline''.
  - В раскрывшемся меню нажать «Преобразовать в приложение» (Convert to application).
  - В появившемся окне нажать «Ок».  \\  {{ :product:settings:streamline.png }}
  - Перейти к разделу «Пулы приложений» (Application pools):
    * открыть «Основные настройки» (Basic Settings) пула приложений, содержащего приложение «streamline» и выполнить следующие действия:
      * в пункте «Версии среды .NET Framework» (.NET Framework version) выбрать значение .NET Framework 4.0.30319 ;
      * в пункте «Режим управляемого конвейера» (Managed Pipeline Mode) выбрать режим «Встроенный» (Integrated);
    * открыть «Дополнительные настройки» (Advanced Settings) пула приложений, содержащего приложение ''streamline'' и изменить параметр «Загрузить профиль пользователя» (Load User Profile) на "True".
  - Добавление типа MIME (для Windows Server 2008 R2)
    * в Диспетчере IIS перейти на веб сайт, в котором находится приложение streamline
    * в просмотре возможностей перейдите в "типы MIME", в случае отсутствия расширения ''.woff'':
      * добавьте новый тип: ◦в поле "Расширение файла" введите ''.woff'' 
      * в поле "Тип MIME" введите ''font/x-woff''. 
==== Настройка системных файлов ====

**Редактирование файла** ''client.config'': 
  - Тег <code xml> <add name="db" providerName="System.Data.SqlClient" connectionString="Data Source=DB_servername;Initial Catalog=streamline;User=advanta;Password=Type_your_password;Max Pool Size=500" /> </code> //Начиная с **версии 3.18** нужно внести правки ещё в два тега: // <code xml><add name="busDb" providerName="System.Data.SqlClient" connectionString="Data Source=DB_servername;Initial Catalog=streamline;User=advanta;Password=Type_your_password;Max Pool Size=500" /></code> <code xml><add name="dbCubes" providerName="System.Data.SqlClient" connectionString="Data Source=DB_servername;Initial Catalog=streamline;User=advanta;Password=Type_your_password;Max Pool Size=500" /> </code> \\ Значения:
    * ''connectionString'' -- строка подключения к базе данных. 
    * ''Data Source'' -- название сервера базы данных
    * ''Initial Catalog'' -- название базы данных
    * ''User'' -- пользователь для базы данных 
    * ''Password'' -- пароль пользователя
    * ''sqlServerCacheDb'' -- имя строки подключения для базы данных распределенного кэша. 
    * ''signalRDb'' -- имя строка подключения к базе с которой работает SignalR (пуш-уведомления). \\
  - Тег <code xml> <add key="WebPath" value="http://servername/streamline"/></code> параметр ''value'' -- это ссылка, которая отображается в уведомлениях из системы, рассылаемых на почтовые ящики. Вместо слова //servername// впишите адрес вашего сервера.<callout type="warning" icon="true" title="Внимание!">Для системы Адванта, начиная с версии 3.04 необходимо настроить маршрутизацию таким образом, чтобы сервер мог подключиться к самому себе по внешнему адресу. Данное требование связано с изменениями в работе таймера, экспорте диаграммы Ганта и интеграцией с Office 365. \\  Пример: внешний адрес сервера ''client.a2nta.ru'', сервер IIS должен корректно заходить по этому адресу. В файле конфигурации системы Адванта ''client.config'' необходимо указать корректный путь в параметре ''WebPath''. Для приведенного выше примера:<code xml><add key="WebPath" value="https://client.a2nta.ru" /></code> Для этого нужно в настройках Bindings (привязки, в настройках IIS) сайта указать тот внешний адрес системы, но без указания протокола и названия приложения. Например, если система открывается по адресу ''https://a2nta.ru/streamline'', то в настройках привязки нужно указать лишь ''a2nta.ru'' .</callout>
  - В теге <code xml>
<register name="searchIndexDirectoryPath" type="System.IO.DirectoryInfo, mscorlib">
  <constructor>
    <param name="path" value="C:\documents\search" />
  </constructor>
</register>
</code> в параметре value прописывается путь к поисковому индексу системы на диске. Например ''C:\SL_Files\Doc_Files\search''.<callout type="info" icon="true">Рекомендуется поисковый индекс хранить на скоростной и не нагруженной другими задачами дисковой системе, например, на отдельном SSD-диске сервера.</callout>
  - В теге <code xml><param name="documentsFolder" value="C:\documents\streamline" type="string"></param></code> в параметре ''value'' прописывается путь к документам на диске. Например ''C:\SL_Files\Doc_Files\streamline''. \\ <callout type="warning" icon="true">Документы хранятся в созданной вами папке, куда вы скопировали дистрибутив: ''C:\SL_Files\Doc_Files\streamline''. Скопируйте содержимое папки с документами в вашу папку (или оставьте документы там, где они сейчас) и пропишите путь до хранения документов.</callout>
  - В теге <code xml><add key="TimeZone" value="+5" /></code> в параметре ''value'' укажите часовой пояс, который должен отображаться в системе.
  - В разделе ''<appSettings>'' в теге <code xml><add key="CubeCommandTimeout" value="30" /></code> в параметре ''value'' можно указать  ограничение времени ожидания выполнения команд в подключении к OLAP-кубу (в секундах). Если параметр не указан в файле ''client.config'', то он устанавливается в значение по умолчанию - 60 секунд.

После внесения изменений перенесите файл ''client.config'' в корневую папку системы (по умолчанию ''c:\inetpub\wwwroot\streamline'')


<html>
<!--
{toggle-cloak:id=My Cloak_4} {color:#006DAF}Начиная **с версии 3.25** нужно внести правки ещё в три тега:{color}
{cloak:id=My Cloak_4|visible=false}
  - В теге <code sql><add key="ApplicationId" value="691d5689-f2c5-4215-a906-3753d61876f0" /></code> в параметре value укажите уникальный идентификатор приложения. ApplicationId - обязательный параметр, уникальный идентификатор экземпляра приложения (максимальна длина 36 символов), если в конфиге нет параметра, происходит генерация значения при запуске модуля обновления (\Updates\deploy.ps1).
  - В теге <code sql><add key="DistributedCacheType" value="SqlServer" /></code> в параметре value укажите тип распределенного кэша (если в конфиге нет параметра, используется значение Memory). Возможные значения:
    * ''SqlServer'' - распределенный кэш хранится в SqlServer
    * ''Memory'' - распределенный кэш хранится в памяти (для случая когда приложение работает в одном экземпляре и тестовых целей)
  - В теге <code sql><add key="SignalRScaleoutType" value="SqlServer" /></code> в параметре value укажите тип масштабирования для SignalR (пуш-уведомления) (если в конфиге нет параметра, используется значение Memory). Возможные значения:
    * ''SqlServer'' – для масштабирования используется SqlServer
    * ''Memory'' - масштабирование отключено (для случая когда приложение работает в одном экземпляре и тестовых целей).
{cloak}

{toggle-cloak:id=My Cloak_3} {color:#006DAF}+*Настройка системных файлов для версий системы до 3.03.x.x включительно*+{color}
{cloak:id=My Cloak_3|visible=false}
Добавьте тег в контейнер <appSettings> <code> <add key="GanttExportPagesPath" value="{0}://servername:{1}{2}/components/Gantt/Storage.ashx?format=html&amp;id="/> </code> Настройка для корректной печати Ганта. Вместо слова //servername// необходимо вписать адрес Вашего сервера.
{cloak}

{toggle-cloak:id=My Cloak_1} {color:#006DAF}+*Настройка системных файлов для версий системы до 2.04.x.x включительно*+{color}
{cloak:id=My Cloak_1|visible=false}
+Редактирование файла *client.config* :+
В значении _SL.SqlServer2008_ (второй тег <register />) в группе тегов, представленной ниже, указывается версия используемого MS SQL Server. Если используется SQL Server 2012, изменить выделенное значение на _SL.SqlServer2012_.
<code>
<container name="db">
  <register type="SmartSuite.Data.Persistence.StorageProviderFactory, SmartSuite.Data" mapTo="SmartSuite.Data.Persistence.SQLServer.SqlStorageProviderFactory, SmartSuite.Data" />
  <register type="SL.App.ServerObjects.IServerObjectsProvider, SL.App" mapTo="SL.App.SqlServer.ServerObjectsProvider, SL.SqlServer2008" />
  <register type="P2M.Cubes.Data.IDirectoryDataManager, smcorelib" mapTo="P2M.Cubes.Data.SQL.DirectoryDataManager, smcorelib" />
  <register type="P2M.Cubes.Data.IPivotDataManager, smcorelib" mapTo="P2M.Cubes.Data.SQL.PivotDataManager, smcorelib" />
</container>
{code}
{cloak}

{toggle-cloak:id=My Cloak_2} {color:#006DAF}+*Настройка системных файлов и реестра Windows для версий системы до 2.0.4.9 включительно*+{color}
{cloak:id=My Cloak_2|visible=false}
{panel}
+Редактирование файла *web.config* :+
  - Исправить файл _C:\Inetpub\wwwroot\streamline\Web.config_:
    * Значение _SL.SqlServer2008_ тэга _<provider> SL.App.SqlServer.ServerObjectsProvider, *SL.SqlServer2008* </provider>_ зависит от версии SQL Server. Если используется SQL Server 2012, изменить значение на _SL.SqlServer2012_.
    * В теге _<appSettings> <add key="AppName" value=" "/> </appSettings>_ значение _«value»_ заменить на _«streamline»._

+Внесение данных в реестр Windows.+
Открыть файл _C:\SL_Files\sl_client.reg_ на редактирование:
  - Указать в качестве значения параметра _Data Source_ параметры подключения к серверу баз данных (имя сервера, либо его IP адрес). В случае, если база создана в именованном экземпляре MS SQL, то и путь следует прописать соответственно.
  - Указать значение параметра _Password_, прописав пароль учетной записи _advanta_, созданной на шаге 2 при подготовке сервера базы данных.
  - Указать значение параметра _WebPath_, прописав имя сервера приложения и имя приложения, например: _"WebPath"="http://sl.a2nta.ru/streamline"_. Данная ссылка будет использоваться в уведомлениях системы, рассылаемых на почтовые ящики, поэтому должна корректна в плане используемого протокола, порта и пути для всех пользователей.
  - Указать значение параметра _DocumentsFolder_, прописав путь до папки с документами системы. По умолчанию _С:\ \SL_Files\ \Doc_Files\ \streamline_.
  - Сохранить изменения и закрыть файл.
  - Добавить данные файла _sl_client.reg_ в реестр.
{panel}
{cloak}
-->
</html>

==== Выбор языка интерфейса системы ====

<callout type="info" icon="true">
На данный момент доступно 4 языка на выбор:
  * Русский (по-умолчанию)
  * Английский (добавлен в версии 3.04.2348.32888-3ed5179)
  * Чешский
  * Украинский

</callout>

Для выбора языка, отличного от русского, нужно:

  - Открыть на редактирование файл ''globalization.config''.<callout type="warning">Для версии системы, меньше 3.03.2166.х, настройка языка в файле ''web.config''.</callout>
  - Найти строку:<code sql>
<globalization culture="ru-RU" uiCulture="ru-Ru" fileEncoding="windows-1251" requestEncoding="utf-8" responseEncoding="utf-8" /></code>
  - Изменить в ней значение параметра ''uiCulture'' на:
    * ''uk-UA'' , если нужен украинский язык интерфейса.
    * ''cs-CZ'' , если нужен чешский язык интерфейса.
    * ''en'' , если нужен английский язык интерфейса.

<callout type="primary" icon="true">Для возврата к русскому языку нужно установить значение ''ru-Ru''.</callout>


==== Установка библиотек для работы с Microsoft SQL Server ====

На сервер приложений нужно установить следующие библиотеки: **Microsoft® System CLR Types for Microsoft® SQL Server® 2016.**

Все вышеперечисленные компоненты можно найти на инсталляционном диске с системой в папке <..Tools\SQL_Library\>

==== Получение лицензии ====

  - Запустить файл //C:\SL_Files\License\SL.Protect.ClientInfo.ехе//
  - Выслать созданный файл //sl.dat// специалисту сервиса технической поддержки компании «Адванта-Груп».
  - Полученный в ответ файл //sl.lic// поместить в папку //C:\Inetpub\wwwroot\streamline//.

<callout type="warning" icon="true" title="Внимание!">
Лицензия привязывается к процессору, жестким дискам и операционной системе. При изменении количества ядер, размера\количества логических дисков, версии операционной системы необходимо генерировать новый _sl.dat и новую лицензию.  Вышлите файл sl.dat с новой конфигурацией специалисту сервиса технической поддержки компании «Адванта-Груп».
</callout>

==== Сервис для обеспечения работы таймера ====

{{page>product:settings:system:timer&noheader&nofooter}}