Нашли ошибку? Выделите
текст с ошибкой и нажмите кнопку "Сообщить об ошибке"
или CTRL+ENTER.
Справочная
система на версию 9.2
Update 17 от 29/12/2020,
© ООО «ФОРСАЙТ»,
В этой статье:
В данной статье приведены различные настройки, которые выполняются после установки BI-сервера на ОС Linux.
BI-сервер под Linux поддерживает подключение к репозиториям, созданным на базе СУБД Oracle, PostgreSQL и SQLite.
Настройки подключения к репозиториям могут храниться в файле registry.reg и/или Metabases.xml. Файл registry.reg можно получить путём экспорта ветки реестра Windows, в которой хранится информация о репозиториях. Для получения файла выполните следующие действия:
На рабочей станции с ОС Windows экспортируйте ветку реестра.
Скопируйте файл registry.reg в домашний каталог Linux и при необходимости отредактируйте. После этого, если файл был получен из ветки реестра [HKEY_LOCAL_MACHINE], то скопируйте его в папку /opt/Foresight/fp9.2-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.2-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.2-biserver/envvars.
Переменные добавляются в файл в формате:
export ИМЯ_ПЕРЕМЕННОЙ=ЗНАЧЕНИЕ
Могут быть добавлены следующие переменные:
| Переменные окружения | Описание |
| export PP_LOG=1 | Для вывода отладочной информации о работе BI-сервера в файл /var/log/apache2-fp9.2/error.log необходимо добавить в конец файла (или раскомментировать существующую строку). |
| export CURLOPT_VERBOSE=1 | Для логирования действий, выполняемых через стороннюю
библиотеку libcurl создайте переменную окружения со значением
1.
Вывод сообщений осуществляется в файл /var/log/apache2-fp9.2/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/9.2 | При использовании репозиториев на базе СУБД Oracle необходимо установить переменную TNS_ADMIN с указанием пути до папки с файлом tnsnames.ora (доступ к файлу должен быть обеспечен для дочернего процесса Apache2). |
Примечание. При работе в ОС Red Hat Enterprise Linux или CentOS и при использовании в качестве системы инициализации systemd для корректной настройки команду export писать не нужно. В файл в этом случае добавляются строки вида: DISPLAY=:987.
Различные файлы BI-сервера будут располагаются в следующих папках:
| Папка или файл | Описание |
| /opt/Foresight/fp9.2-biserver/bin | Основные файлы BI-сервера. |
| /opt/Foresight/fp9.2-biserver/logs/axis2.log | Журнал обращений к BI-серверу. |
| /etc/opt/Foresight/fp9.2-biserver | Дополнительные конфигурационные файлы экземпляра BI-сервера, такие как файл envvars для задания переменных окружения Apache HTTP Server. |
| /etc/opt/Foresight/httpd-fp9.2
(в Astra Linux)
/etc/apache2-fp9.2 (в Debian и Ubuntu) /etc/httpd-fp9.2 (в RHEL) |
Конфигурационные файлы экземпляра Apache HTTP Server. |
| /var/opt/Foresight/httpd/logs/error-fp9.2.log
(в Astra Linux)
/var/log/apache2-fp9.2/error.log (в Debian и Ubuntu) /var/log/httpd/error-fp9.2.log (в RHEL) |
Ошибки и отладочные сообщения экземпляра Apache HTTP Server. |
| /var/opt/Foresight/httpd/access-fp9.2.log
(в Astra Linux)
/var/log/apache2-fp9.2/access.log (в Debian и Ubuntu) /var/log/httpd/access-fp9.2.log (в RHEL) |
Журнал доступа к экземпляру Apache HTTP Server. |
| /root/.config/Foresight/Foresight Analytics Platform | Общие конфигурационные файлы BI-сервера (путь может отличаться при изменении переменной окружения HOME). |
| /etc/init.d/Foresight-httpd-fp9.2
(в Astra Linux)
/etc/init.d/apache2-fp9.2 (в Debian и Ubuntu) /etc/init.d/httpd-fp9.2 (в RHEL) |
init-скрипт запуска экземпляра Apache HTTP Server. |
| /etc/init.d/Foresight-xvfb | init-скрипт виртуального дисплея (X virtual framebuffer, по умолчанию запускается на дисплее с номером 987 и dpi 96). |
| /opt/Foresight/fp9.2-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.exe». Для запуска выполните команду:
PP_NODISPLAY=1 ./PP.Util
Scheduler. Планировщик задач, управляющий процессом запуска задач. Более подробно читайте в подразделе «Планировщик задач». Для запуска выполните команду:
DISPLAY=:987 ./Scheduler
echoid. Утилита получения цифрового отпечатка компьютера, нужна на этапе запроса лицензии. Более подробно читайте в подразделе «Получение цифрового отпечатка компьютера».
lsdecode. Утилита получения информации о файле лицензии.
lsinit. Утилита для инициализации подсистемы лицензирования.
См. также:
Установка BI-сервера на ОС Linux | Настройки в системном реестре | Settings.xml | Metabases.xml | Дополнительные настройки