Настройки в системном реестре

В данном подразделе создаются параметры, влияющие на работу отдельных сессий с репозиториями.

• RWLockSlim. Блокировка доступа к открытым экземплярам объектов.
  Допустимые значения:
  0 (по умолчанию) - объект блокируется на запись;
  1 - объект отдельно блокируется на чтение и запись, при этом возможно одновременное чтение из объекта несколькими потоками.
• LockSession. Блокировка всей сессии при выполнении запросов. При включенной блокировке запросы ко всем объектам в рамках сессии будут выполняться последовательно, иначе параллельно или применяются индивидуальные блокировки (RWLockSlim).
  Допустимые значения:
  0 (по умолчанию) - блокировка выключена;
  1 - блокировка включена.
• LockAd. Блокировка доступа к открытым экземплярам аналитических панелей. При включенной блокировке запросы на чтение/запись будут выполняться последовательно, иначе параллельно. Также при этом включается блокировка вложенных объектов, доступ к которым осуществляется с использованием моникера аналитической панели.
  Доступные значения:
  0 - блокировка выключена;
  1 (по умолчанию) - блокировка включена.
• SamplingStr. Включение сбора статистики по времени и памяти для счётчиков производительности.
  Допустимые значения:
  IsOn - включение сбора статистики;
  Memory - измерять память, затрачиваемую на какие-либо действия;
  Time - измерять время выполнения каких-либо действий;
  Sql - сбор статистики по выполнению SQL-запросов к БД репозитория;
  Cube - сбор статистики по выполнению кубов (построение матрицы куба в соответствии с переданной отметкой);
  Pivot - сбор статистики по работе с основами для построения таблиц экспресс-отчетов;
  Sheet - сбор статистики по работе таблиц с данными экспресс-отчетов;
  Dim - сбор статистики по построению измерений, используемых в различных объектах репозитория;
  Rub - сбор статистики по построению базы данных временных рядов (получение данных рядов в соответствии с заданным периодом);
  Laner - сбор статистики по работе таблицы с данными рабочих книг;
  Report - сбор статистики по вычислениям регламентных отчетов;
  RepSheet - сбор статистики по вычислениям листов регламентных отчетов;
  RepDataIsl - сбор статистики по вычислениям областей данных;
  RepTabIsl - сбор статистики по вычислениям реляционных областей данных;
  Fore - сбор статистики по работе макросов и обработчиков событий в регламентных отчетах.
  Флаг IsOn указывается всегда, иначе сбор статистики производиться не будет. Через запятую указываются другие флаги, определяющие, какие именно счетчики необходимо задействовать. Указание только флага IsOn эквивалентно включению всех флагов.
• Sampling. Включение сбора статистики по времени и памяти для счётчиков производительности.
  Допустимые значения:
  1 - Собирать статистику только по операциям (количество выполнений, время и т.д.);
  On - Собирать всю статистику (по запросам, по операциям, по времени/по памяти). Данный параметр является устаревшим, используйте вместо него параметр SamplingStr.
• SysLogMb. Идентификатор репозитория, в котором имеются системные таблицы для хранения собранной статистики (Создание системных таблиц для сбора статистики осуществляется с использованием утилиты PP.Util.exe).
• TimeoutSec. Время ожидания при отсутствии запросов, по истечении которого сессия будет разорвана. Время указывается в секундах, в диапазоне [60, 127800]. При значении «-1» время ожидания не ограничено. По умолчанию - 1800.
• Statable. Режим сохранения и восстановления состояний объектов на сервере состояний. Используется вместе с группой настроек StateServer.
  Допустимые значения:
  Never или 0 (по умолчанию) - не сохранять и не загружать состояния объектов;
  Yes или 1 - сохранять при изменении, загружать при отсутствии в сессии;
  Ever - сохранять при изменении, загружать всегда.
• KeyIncr. Генерация последовательных моникеров сессий и объектов.
  Допустимые значения:
  0 (по умолчанию) - генерация моникеров через GUID;
  Yes или 1 - генерация последовательных моникеров (например, S1!M).
• StoreBins. Ограничение на количество хранимых на сервере с каждым объектом результатов экспорта (для экспресс-отчетов и регламентных отчетов).
  По умолчанию 0, при этом количество сохраняемых результатов не ограничивается.
• StoreBinSize. Максимальный суммарный размер загруженных бинарных объектов в рамках сессии. По умолчанию размер указывается в байтах. Если после значения указать символ «B», «K» или «M» (англ.), то значение соответственно будет в байтах, килобайтах или мегабайтах. По умолчанию 0, при этом ограничение на загружаемый объем отсутствует.
• PoolMaxConnections. Ограничение на количество соединений с базой данных репозитория.
  Допустимые значения:
  0 (по умолчанию) - не переиспользовать соединения, всегда создавать новое;
  <0 -  переиспользовать без ограничения на количество (добавлять новое соединение, если нет свободных соединений);
  >0 - переиспользовать с указанным в параметре ограничением на количество соединений.

Примечание. Параметр PoolMaxConnections является устаревшим, оставлен для совместимости с предыдущими версиями Prognoz Platform. Используйте параметр MaxConnections в подразделе реестра [HKLM\Software\JSC Prognoz\Prognoz\8.0\PP\BIS\System\Pool].

В данном подразделе создаются параметры, влияющие на работу пула соединений, который будет использовать BI-сервер.

• MaxConnections. Максимальное количество соединений в пуле. По умолчанию 0, при этом ограничение на количество соединений отсутствует;
• Strategy. Алгоритм вытеснения соединений из пула при необходимости освободить место для нового соединения.
  Допустимые значения:
  LRU - алгоритм вытеснения давно не используемых по времени соединений (LRU-алгоритм);
  Balance или Default - вытеснение по соотношению количество открытых репозиториев/количество открытых соединений с БД;
• UserMaxConnections. Максимальное количество соединений, созданных с одинаковыми учетными данными. По умолчанию 0, при этом ограничение на количество соединений отсутствует.
• RetryCount. Число попыток проверки занятости соединения. Допустимое значение - [1; 1600], по умолчанию - 160 попыток.
• RetryInterval. Интервал между попытками проверки в миллисекундах. Допустимое значение - [10; 4000], по умолчанию - 400 миллисекунд.

Также, в подразделе Pool могут быть созданы дополнительные подразделы с параметрами для конкретных репозиториев. Создаваемый дополнительный подраздел должен иметь любое уникальное наименование, в нем могут быть созданы следующие параметры:

• Db. Параметры соединения для пользователя в следующем формате: {имя_пользователя}:{идентификатор_метабазы}@{сервер_бд};
• UserMaxConnections. Максимальное количество соединений с указанным репозиторием под указанным пользователем.

Примечание. Параметры пула соединений применяются, если значение параметра MaxConnections больше нуля.

Параметры подключения к серверу состояний.

• Type. Тип сервера состояний. В зависимости от используемого программного обеспечения доступны следующие значения:
  MemCached (по умолчанию).
  Redis.
• Host. Наименование или IP-адрес сервера состояний (по умолчанию - Localhost).
• Port. Номер порта, через который будет осуществляться подключение (при значении «-1» используется порт по умолчанию: 11211 для MemCached и 6379 для Redis).

В данном подразделе хранится закрытый ключ сертификата безопасности. Параметры этого подраздела реестра создаются при работе программы PP.Util.exe.

• Alg. Алгоритм шифрования.
• Data. Зашифрованный закрытый ключ сертификата безопасности.
• Id. Идентификатор сертификата безопаности.
• Key. GUID сертификата безопасности.

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

Параметры объектов для сбора статистики. В данном подразделе необходимо создать дополнительные подразделы с именами, равными идентификатору репозиториев. В каждом дополнительном подразделе может быть создан параметр:

• StatKeys. Ключи отдельных объектов репозитория, указанные через запятую, при работе с которыми будут собираться счётчики производительности.

Параметры работы через протокол OAuth для аутентификации пользователей на сторонних серверах, поддерживающих данный протокол. Для настройки внутри OAuth создаются подразделы с именами OAuth-серверов. В каждом подразделе задаются необходимые специфические параметры. В текущей реализации доступны следующие параметры OAuth-серверов:

• PPUserNameFormat. Формат имен пользователей (Пример: "oa-tw-%s");
• consumerKey. Ключ зарегистрированного приложения;
• consumerSecret. Секретный код зарегистрированного приложения.

Значения, указываемые в параметрах consumerKey и consumerSecret, могут будут получены после регистрации разрабатываемого приложения на необходимом OAuth-сервере. Данные параметры необходимы, чтобы после авторизации на OAuth сервере, BI-сервер смог проверить и авторизовать соответствующего пользователя в репозитории.

Если параметры consumerKey и consumerSecret не указываются, то используются внутренние настройки BI-сервера, при этом на OAuth-сервере должно быть зарегистрировано приложение на базе веб-приложения Prognoz Platform 8.

Параметры выполнения SQL-запросов с использованием операций BI-сервера. Данные параметры влияют на работу BI-сервера, если он используется в качестве клиента для доступа к СУБД.

В текущей реализации доступен следующий флаг:

• Allow. Разрешение выполнения SQL-запросов через BI-сервера. Допустимые значения:
  0 (по умолчанию) - выполнение SQL-запросов запрещено;
  1 - выполнение SQL-запросов разрешено.

Параметры работы с объектами среды разработки.

• Disallow. Признак запрета выполнения макросов, написанных на Fore/Fore.NET, с помощью операции ForeExec. При значении «1» выполнение макросов запрещено, проверка выполнения операции ForeExec осуществляется на стороне BI-сервера. Если установлено значение «0» или параметр отсутствует, то проверка осуществляется веб-приложением в соответствии со значением параметра foreExec в файле PP.xml.

Подраздел, в котором указываются конечные точки к удаленным серверам. Для каждой точки создается подраздел с уникальным именем, в каждой из которых задается параметр:

• address. Фактический адрес удаленного BI-сервера.

Подраздел содержит настройки для репозиториев. Для настройки внутри Mbs создается подраздел с уникальным именем – идентификатором описания репозитория. В каждом подразделе создаются подразделы Cubes, а также параметр:

• endpoint. Уникальное имя точки доступа из Epts. Указанная конечная точка будет использоваться для обращения за кэшированными данными при построении кубов репозитория. Если в качестве наименования указана пустая строка, то обращение будет производиться к текущему BI-серверу.

Подраздел Cubes

Подраздел содержит настройки для кубов репозитория, при работе с которыми будет осуществляться обращение за данными к удаленным BI-серверам. Для настройки создается подраздел с уникальным именем, в котором задаются следующие параметры:

• Keys. Ключи кубов через запятую без пробелов.
• endpoint. Уникальное имя точки доступа из раздела Epts.