В этой статье:

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

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

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

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

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

Настройки подключения к репозиториям могут храниться в файле registry.reg и/или Metabases.xml. В ОС Linux удобнее редактировать файл Metabases.xml.

Файл Metabases.xml должен лежать в папке /opt/foresight/fp10.x-biserver/etc.

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

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

Скопируйте файл registry.reg в домашний каталог Linux и при необходимости отредактируйте. После этого скопируйте файл в папку /opt/foresight/fp10.x-biserver/etc/registry. Предполагается, что в папке /opt/foresight/fp10.x-biserver/etc/registry лежит ветка реестра [HKEY_LOCAL_MACHINE] или [HKEY_CURRENT_USER].

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

При сохранении конфиденциальных учётных данных для подключения к БД с помощью утилиты PP.Util данные будут автоматически записываться в место хранения настроек подключения к репозиториям: registry.reg или Metabases.xml.

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

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

Дополнительные настройки хранятся в файле registry.reg или settings.xml. Файл settings.xml должен лежать в каталоге /opt/foresight/fp10.x-biserver/etc.

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

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

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

Переменные добавляются в файл в формате: <наименование переменной>=<значение>.

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

Переменные окружения	Описание
PP_LOG=1	Для вывода отладочной информации о работе BI-сервера в файл /var/log/apache2-fp10.x/error.log необходимо добавить в конец файла или раскомментировать существующую строку с PP_LOG. Описание выводимой информации представлено в подразделе «Работа с отладочной информацией».
PP_LOGTIME=1	Для вывода в отладочной информации временных меток, позволяющих отслеживать затрачиваемое на выполнение различных операций время, добавьте переменную PP_LOGTIME со значением 1.
CURLOPT_VERBOSE=1	Для логирования действий, выполняемых через стороннюю библиотеку libcurl, создайте переменную окружения со значением 1. Вывод сообщений осуществляется в файл /var/log/apache2-fp10.x/error.log.
LSHOST=lserver1~lserver2	Для указания сетевого имени или IP-адреса сетевых серверов лицензий используется переменная LSHOST, сервера перечисляются через символ "~" (тильда).
LSFORCEHOST=<имя сервера лицензий или NO-NET>	Для указания использования сетевой лицензии укажите имя сервера лицензий, при использовании автономной лицензии - «NO-NET».
HOME=/root	Для изменения пути, относительно которого ищутся конфигурационные файлы и файл лицензии укажите переменную HOME (по умолчанию совпадает с домашней директорией пользователя, от которого запускается родительский процесс Apache2, т.е. /root).
USER=root	Для изменения пользователя, от имени которого будет производится расшифровка данных, сохранённых в реестре для авторизации в СУБД, используется переменная USER (должна совпадать с пользователем, от которого запускается родительский процесс Apache2, по умолчанию root).
TNS_ADMIN=/opt/foresight/fp10.x-biserver	При использовании репозиториев на базе СУБД Oracle необходимо установить переменную TNS_ADMIN с указанием пути до папки с файлом tnsnames.ora (доступ к файлу должен быть обеспечен для дочернего процесса Apache2).
PP_RETMEM=1	Для принудительной очистки памяти в операционной системе при закрытии репозитория создайте переменную окружения PP_RETMEM со значением 1. По умолчанию используется значение 0. Объем освобождаемой памяти зависит от переменной MALLOC_MMAP_THRESHOLD_.
MALLOC_MMAP_THRESHOLD_=8192	Для управления памятью в операционной системе создайте переменную окружения MALLOC_MMAP_THRESHOLD_ со значением 8192. Объем освобождаемой памяти будет возвращаться в операционную систему, если переменная PP_RETMEM принимает значение 1.
PP_RETMEM_CO=1	Для принудительной очистки памяти при закрытии объектов репозитория создайте переменную окружения PP_RETMEM_CO со значением 1. По умолчанию используется значение 0, при этом принудительная очистка памяти не производится или производится при закрытии репозитория, если определена переменная PP_RETMEM.
KRB5RCACHEDIR=/opt/foresight/fp10.x-biserver/var/cache	Для использования интегрированной доменной аутентификации в ОС Linux. В указанной папке создаётся файл *.rcache2 при работе модуля mod_auth_gssapi.
WEBFORMS_PORT=9093	Порт BI-сервера, через который будет осуществляться работа веб-форм по протоколу WebSocket. Значение переменной окружения имеет больший приоритет, чем порт, определённый в системном реестре/файле settings.xml. По умолчанию используется порт 9091. Указываемый порт должен быть открыт на BI-сервере.

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

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

Папка или файл	Описание
/opt/foresight/fp10.x-biserver/bin	Основные файлы BI-сервера.
/opt/foresight/fp10.x-biserver/etc	Конфигурационные файлы: envvars для задания переменных окружения; Metabases.xml для настройки подключения к репозиторию; scheduler.xml для запуска планировщика задач; settings.xml для формирования параметров, аналогичных параметрам в реестре; registry/*.reg для настройки файлов реестра. Совет. Рекомендуется обеспечить доступ на запись файлов и папок в etc только администратору операционной системы root.
/opt/foresight/fp10.x-biserver/var/cache	Файлы, создаваемые при кэшировании данных по технологии In-Memory и кэшировании объектов среды разработки.
/opt/foresight/fp10.x-biserver/var/log	Файлы лога: axis2.log для логирования базового модуля сервисов; AuditError.txt для протоколирования операций над объектами при сбое записи информации в протокол доступа; Scheduler.log для логирования работы планировщика задач.
/etc/apache2-fp10.x (для Debian-подобных дистрибутивов) /etc/httpd-fp10.x (для RedHat-подобных дистрибутивов) /etc/httpd2-fp10.x (для ALT Linux)	Конфигурационные файлы экземпляра Apache HTTP Server с BI-сервером.
/var/log/apache2-fp10.x/error.log (для Debian-подобных дистрибутивов) /var/log/httpd/error-fp10.x.log (для RedHat-подобных дистрибутивов) /var/log/httpd2/error-fp10.x.log (для ALT Linux)	Ошибки и отладочные сообщения экземпляра Apache HTTP Server с BI-сервером.
/var/log/apache2-fp10.x/access.log (для Debian-подобных дистрибутивов) /var/log/httpd/access-fp10.x.log (для RedHat-подобных дистрибутивов) /var/log/httpd2/access-fp10.x.log (для ALT Linux)	Журнал доступа к экземпляру Apache HTTP Server с BI-сервером.
/root/.config/Foresight/Foresight Analytics Platform	Общие конфигурационные файлы BI-сервера (путь может отличаться при изменении переменной окружения HOME).
/etc/init.d/foresight-xvfb	init-скрипт виртуального дисплея (X virtual framebuffer, по умолчанию запускается на дисплее с номером 987 и dpi 96).
/opt/foresight/fp10.x-biserver/share/fonts	Пользовательские шрифты, которые используются BI-сервером при работе с объектами.