Конфигурация и настройка

В данной статье приведены различные настройки, которые выполняются после установки BI-сервера на ОС Linux.

Настройки подключения к репозиториям

BI-сервер под Linux поддерживает подключение к репозиториям, созданным на базе СУБД Oracle, PostgreSQL и SQLite.

Примечание. Перед настройкой подключения к репозиториям ознакомьтесь с ограничениями при работе с BI-сервером на Linux.

Настройки подключения к репозиториям могут храниться в файле registry.reg и/или Metabases.xml. Файл registry.reg можно получить путём экспорта ветки реестра Windows, в которой хранится информация о репозиториях. Для получения файла выполните следующие действия:

1. На рабочей станции с ОС Windows экспортируйте ветку реестра.

2. Скопируйте файл registry.reg в домашний каталог Linux и при необходимости отредактируйте. После этого, если файл был получен из ветки реестра [HKEY_LOCAL_MACHINE], то скопируйте его в папку /opt/Foresight/fp10.x-biserver/bin. Если файл был получен из ветки [HKEY_CURRENT_USER], то скопируйте его в папку /root/.config/Foresight/Foresight Analytics Platform/registry/.

Предполагается, что в папке bin с платформой лежит ветка реестра [HKEY_LOCAL_MACHINE], а в домашней папке /root/.config/Foresight/Foresight Analytics Platform/registry лежит ветка реестра [HKEY_CURRENT_USER]. В неё автоматически будут сохраняться репозитории из ветки [HKEY_CURRENT_USER] при использовании утилиты PP.Util для сохранения конфиденциальных учётных данных для подключения к БД. У BI-сервера должен быть доступ к файлам registry.reg.

Результат экспорта реестра сохранится в кодировке UTF-16, но BI-сервер под Linux может работать с файлом в кодировке UTF-16 и UTF-8. Можно перекодировать файл в UTF-8 для удобства редактирования в Linux, а с UTF-16 может работать редактор vi.

Файл Metabases.xml должен лежать в папке с платформой /opt/Foresight/fp10.x-biserver/bin, у BI-сервера должен быть доступ к файлу. Metabases.xml проще редактировать в Linux, но данный файл имеет ограничения, так как не может сохранять учётные данные для подключения к БД репозитория, например учётные данные гостевого пользователя.

Для применения изменённых настроек подключения к репозиторию или новых репозиториев необходимо перезапустить BI-сервер.

Дополнительные настройки

Дополнительные настройки хранятся в файле registry.reg или settings.xml. Файл settings.xml должен лежать в каталоге /root/.config/Foresight/Foresight Analytics Platform (каталог может отличаться, если изменена переменная окружения HOME).

В файле можно указать такие настройки, как ограничение количества подключений BI-сервера к серверу СУБД и другие.

Переменные окружения

Переменные окружения, которые считываются при старте BI-сервера с экземпляром Apache2, находятся в файле /etc/opt/Foresight/fp10.x-biserver/envvars.

Переменные добавляются в файл в формате:

export ИМЯ_ПЕРЕМЕННОЙ=ЗНАЧЕНИЕ

Могут быть добавлены следующие переменные:

Переменные окружения	Описание
export PP_LOG=1	Для вывода отладочной информации о работе BI-сервера в файл /var/log/apache2-fp10.x/error.log необходимо добавить в конец файла или раскомментировать существующую строку.
export PP_LOGTIME=1	Для вывода в отладочной информации временных меток, позволяющих отслеживать затрачиваемое на выполнение различных операций время, добавьте переменную PP_LOGTIME со значением 1.
export CURLOPT_VERBOSE=1	Для логирования действий, выполняемых через стороннюю библиотеку libcurl, создайте переменную окружения со значением 1. Вывод сообщений осуществляется в файл /var/log/apache2-fp10.x/error.log.
export DISPLAY=:987	Для изменения номера дисплея, на котором производится отрисовка графики, надо отредактировать строку (по умолчанию настроен вывод через xvfb).
export LSHOST=lserver1~lserver2	Для указания сетевого имени или IP-адреса сетевых серверов лицензий используется переменная LSHOST, сервера перечисляются через символ "~" (тильда).
export LSFORCEHOST=NO-NET	Для указания использования локальной автономной лицензии установите переменную LSFORCEHOST.
export HOME=/root	Для изменения пути, относительно которого ищутся конфигурационные файлы и файл лицензии укажите переменную HOME (по умолчанию совпадает с домашней директорией пользователя, от которого запускается родительский процесс Apache2, т.е. /root).
export USER=root	Для изменения пользователя, от имени которого будет производится расшифровка данных, сохранённых в реестре для авторизации в СУБД, используется переменная USER (должна совпадать с пользователем, от которого запускается родительский процесс Apache2, по умолчанию root).
export TNS_ADMIN=/etc/opt/Foresight/fp10.x-biserver	При использовании репозиториев на базе СУБД Oracle необходимо установить переменную TNS_ADMIN с указанием пути до папки с файлом tnsnames.ora (доступ к файлу должен быть обеспечен для дочернего процесса Apache2).
export PP_RETMEM=1	Для принудительной очистки памяти в операционной системе при закрытии репозитория создайте переменную окружения PP_RETMEM со значением 1. По умолчанию используется значение 0. Объем освобождаемой памяти зависит от переменной MALLOC_MMAP_THRESHOLD_.
export MALLOC_MMAP_THRESHOLD_=8192	Для управления памятью в операционной системе создайте переменную окружения MALLOC_MMAP_THRESHOLD_ со значением 8192. Объем освобождаемой памяти будет возвращаться в операционную систему, если переменная PP_RETMEM принимает значение 1.
export PP_RETMEM_CO=1	Для принудительной очистки памяти при закрытии объектов репозитория создайте переменную окружения PP_RETMEM_CO со значением 1. По умолчанию используется значение 0, при этом принудительная очистка памяти не производится или производится при закрытии репозитория, если определена переменная PP_RETMEM.

Примечание. При работе в ОС CentOS и при использовании в качестве системы инициализации systemd для корректной настройки команду export писать не нужно. В файл в этом случае добавляются строки вида: DISPLAY=:987.

Файлы и папки BI-сервера

Различные файлы BI-сервера будут располагаются в следующих папках:

Папка или файл	Описание
/opt/Foresight/fp10.x-biserver/bin	Основные файлы BI-сервера.
/opt/Foresight/fp10.x-biserver/logs/axis2.log	Журнал обращений к BI-серверу.
/etc/opt/Foresight/fp10.x-biserver	Дополнительные конфигурационные файлы экземпляра BI-сервера, такие как файл envvars для задания переменных окружения Apache HTTP Server.
/etc/opt/Foresight/httpd-fp10.x (в Astra Linux) /etc/apache2-fp10.x (в Ubuntu)	Конфигурационные файлы экземпляра Apache HTTP Server.
/var/opt/Foresight/httpd/logs/error-fp10.x.log (в Astra Linux) /var/log/apache2-fp10.x/error.log (в Ubuntu)	Ошибки и отладочные сообщения экземпляра Apache HTTP Server.
/var/opt/Foresight/httpd/access-fp10.x.log (в Astra Linux) /var/log/apache2-fp10.x/access.log (в Ubuntu)	Журнал доступа к экземпляру Apache HTTP Server.
/root/.config/Foresight/Foresight Analytics Platform	Общие конфигурационные файлы BI-сервера (путь может отличаться при изменении переменной окружения HOME).
/etc/init.d/Foresight-httpd-fp10.x (в Astra Linux) /etc/init.d/apache2-fp10.x (в Ubuntu)	init-скрипт запуска экземпляра Apache HTTP Server.
/etc/init.d/Foresight-xvfb	init-скрипт виртуального дисплея (X virtual framebuffer, по умолчанию запускается на дисплее с номером 987 и dpi 96).
/opt/Foresight/fp10.x-biserver/bin/in/fonts /usr/share/fonts /usr/local/share/fonts	Шрифты, которые могут использоваться BI-сервером при работе.