Нашли ошибку? Выделите
текст с ошибкой и нажмите кнопку "Сообщить об ошибке"
или CTRL+ENTER.
Справочная
система на версию 9.9
от 20/03/2024,
© ООО «ФОРСАЙТ»,
В этой статье:
В данной статье приведены различные настройки, которые выполняются после установки BI-сервера на ОС Linux.
BI-сервер под Linux поддерживает подключение к репозиториям, созданным на базе СУБД Oracle, PostgreSQL и SQLite.
Примечание. Перед настройкой подключения к репозиториям ознакомьтесь с ограничениями при работе с BI-сервером на Linux.
Настройки подключения к репозиториям могут храниться в файле registry.reg и/или Metabases.xml. Файл registry.reg можно получить путём экспорта ветки реестра Windows, в которой хранится информация о репозиториях. Для получения файла выполните следующие действия:
На рабочей станции с ОС Windows экспортируйте ветку реестра.
Скопируйте файл registry.reg в домашний каталог Linux и при необходимости отредактируйте. После этого, если файл был получен из ветки реестра [HKEY_LOCAL_MACHINE], то скопируйте его в папку /opt/Foresight/fp9.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/fp9.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/fp9.x-biserver/envvars.
Переменные добавляются в файл в формате: <наименование переменной>=<значение>.
Могут быть добавлены следующие переменные:
| Переменные окружения | Описание |
| PP_LOG=1 | Для вывода отладочной информации о работе BI-сервера в файл /var/log/apache2-fp9.x/error.log необходимо добавить в конец файла или раскомментировать существующую строку. |
| PP_LOGTIME=1 | Для вывода в отладочной информации временных меток, позволяющих отслеживать затрачиваемое на выполнение различных операций время, добавьте переменную PP_LOGTIME со значением 1. |
| CURLOPT_VERBOSE=1 | Для логирования действий, выполняемых через стороннюю библиотеку
libcurl, создайте переменную окружения со значением 1.
Вывод сообщений осуществляется в файл /var/log/apache2-fp9.x/error.log. |
| DISPLAY=:987 | Для изменения номера дисплея, на котором производится отрисовка графики, надо отредактировать строку (по умолчанию настроен вывод через xvfb). |
| LSHOST=lserver1~lserver2 | Для указания сетевого имени или IP-адреса сетевых серверов лицензий используется переменная LSHOST, сервера перечисляются через символ "~" (тильда). |
| LSFORCEHOST=NO-NET | Для указания использования локальной автономной лицензии установите переменную LSFORCEHOST. |
| HOME=/root | Для изменения пути, относительно которого ищутся конфигурационные файлы и файл лицензии укажите переменную HOME (по умолчанию совпадает с домашней директорией пользователя, от которого запускается родительский процесс Apache2, т.е. /root). |
| USER=root | Для изменения пользователя, от имени которого будет производится расшифровка данных, сохранённых в реестре для авторизации в СУБД, используется переменная USER (должна совпадать с пользователем, от которого запускается родительский процесс Apache2, по умолчанию root). |
| TNS_ADMIN=/etc/opt/Foresight/fp9.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/fp9.x-biserver/var/cache | Для использования интегрированной доменной аутентификации в ОС Linux. В указанной папке создаётся файл *.rcache2 при работе модуля mod_auth_gssapi. |
Различные файлы BI-сервера будут располагаются в следующих папках:
| Папка или файл | Описание |
| /opt/Foresight/fp9.x-biserver/bin | Основные файлы BI-сервера. |
| /opt/Foresight/fp9.x-biserver/logs/axis2.log | Журнал обращений к BI-серверу. |
| /etc/opt/Foresight/fp9.x-biserver | Дополнительные конфигурационные файлы экземпляра BI-сервера, такие как файл envvars для задания переменных окружения Apache HTTP Server. |
| /etc/opt/Foresight/httpd-fp9.x
(в Astra Linux)
/etc/apache2-fp9.x (в Ubuntu) |
Конфигурационные файлы экземпляра Apache HTTP Server. |
| /var/opt/Foresight/httpd/logs/error-fp9.x.log
(в Astra Linux)
/var/log/apache2-fp9.x/error.log (в Ubuntu) |
Ошибки и отладочные сообщения экземпляра Apache HTTP Server. |
| /var/opt/Foresight/httpd/access-fp9.x.log
(в Astra Linux)
/var/log/apache2-fp9.x/access.log (в Ubuntu) |
Журнал доступа к экземпляру Apache HTTP Server. |
| /root/.config/Foresight/Foresight Analytics Platform | Общие конфигурационные файлы BI-сервера (путь может отличаться при изменении переменной окружения HOME). |
| /etc/init.d/Foresight-httpd-fp9.x
(в Astra Linux)
/etc/init.d/apache2-fp9.x (в Ubuntu) |
init-скрипт запуска экземпляра Apache HTTP Server. |
| /etc/init.d/Foresight-xvfb | init-скрипт виртуального дисплея (X virtual framebuffer, по умолчанию запускается на дисплее с номером 987 и dpi 96). |
| /opt/Foresight/fp9.x-biserver/bin/in/fonts /usr/share/fonts /usr/local/share/fonts |
Шрифты, которые могут использоваться BI-сервером при работе. |
После установки BI-сервера также будет доступен ряд приложений, которые входят в комплект поставки:
axis2_http_server. Тестовое приложение, используемое при отладке разрабатываемых приложений. Для запуска выполните команду:
PP_LOG=1 DISPLAY=:987 ./axis2_http_server
UpdateManager. Приложение для установки pefx-файлов, содержащих обновления для объектов репозитория. Более подробно читайте в подразделе «Установка обновления». Для запуска выполните команду:
DISPLAY=:987 ./UpdateManager
PP.Util. Приложение, выполняющее различные вспомогательные действия при настройке BI-сервера. Более подробно читайте в разделе «PP.Util». Для запуска выполните команду:
PP_NODISPLAY=1 ./PP.Util
Scheduler. Планировщик задач, управляющий процессом запуска задач. Более подробно читайте в подразделе «Планировщик задач». Для запуска выполните команду:
DISPLAY=:987 ./Scheduler
echoid. Утилита получения цифрового отпечатка компьютера, нужна на этапе запроса лицензии. Более подробно читайте в подразделе «Получение цифрового отпечатка компьютера»;
lsinit. Утилита для инициализации подсистемы лицензирования.
См. также:
Установка BI-сервера на ОС Linux | Настройки в системном реестре | Settings.xml | Metabases.xml | Дополнительные настройки