В данной статье приведены различные настройки, которые выполняются после установки BI-сервера на ОС Linux.
Содержание
BI-сервер под Linux поддерживает подключение к репозиториям, созданным на базе СУБД Oracle, PostgreSQL и SQLite.
Настройки подключения к репозиториям могут храниться в файле registry.reg и/или Metabases.xml. Файл registry.reg можно получить путём экспорта ветки реестра Windows, в которой хранится информация о репозиториях. Для получения файла выполните следующие действия:
На рабочей станции с ОС Windows экспортируйте ветку реестра:
HKEY_LOCAL_MACHINE\SOFTWARE\JSC Prognoz\Prognoz\8.0\Metabases - если
разрядность ОС Windows и настольного приложения Prognoz Platform
совпадает;
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\JSC Prognoz\Prognoz\8.0\Metabases
- если используется 32-разрядное настольное приложение Prognoz Platform в 64-разрядной
ОС Windows.
Примечание. Настройки репозиториев сохраняются в разделе реестра HKEY_LOCAL_MACHINE, если они предназначены для всех пользователей компьютера. Если настройки репозиториев предназначены только для текущего пользователя, то их можно экспортировать из соответствующих веток раздела HKEY_CURRENT_USER.
Скопируйте файл registry.reg в домашний каталог Linux и при необходимости отредактируйте. После этого, если файл был получен из ветки реестра HKEY_LOCAL_MACHINE, то скопируйте его в папку /opt/prognoz/<версия Prognoz Platform>/bin. Если файл был получен из ветки HKEY_CURRENT_USER, то скопируйте его в папку /root/.config/JSC Prognoz/Prognoz Platform/registry/.
Предполагается, что в папке bin с платформой лежит ветка реестра HKEY_LOCAL_MACHINE, а в домашней папке /root/.config/JSC Prognoz/Prognoz 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/prognoz/<версия Prognoz Platform>/bin, у BI-сервера должен быть доступ к файлу. Metabases.xml проще редактировать в Linux, но данный файл имеет ограничения, так как не может сохранять учетные данные для подключения к БД репозитория, например учётные данные гостевого пользователя.
Для применения изменённых настроек подключения к репозиторию или новых репозиториев необходимо перезапустить BI-сервер.
Дополнительные настройки хранятся в файле registry.reg или settings.xml. Файл settings.xml должен лежать в каталоге /root/.config/JSC Prognoz/Prognoz Platform (каталог может отличаться, если изменена переменная окружения HOME).
В файле можно указать такие настройки, как ограничение количества подключений BI-сервера к серверу СУБД и другие.
Переменные окружения, которые считываются при старте BI-сервера с экземпляром Apache2, находятся в файле /etc/opt/prognoz/<версия Prognoz Platform>/envvars.
Переменные добавляются в файл в формате:
export ИМЯ_ПЕРЕМЕННОЙ=ЗНАЧЕНИЕ
Могут быть добавлены следующие переменные:
| Переменные окружения | Описание |
| export PP_LOG=1 | Для вывода отладочной информации о работе BI-сервера в файл /var/log/apache2-pp8.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/prognoz/<версия Prognoz Platform> | При использовании репозиториев на базе СУБД Oracle необходимо установить переменную TNS_ADMIN с указанием пути до папки с файлом tnsnames.ora (доступ к файлу должен быть обеспечен для дочернего процесса Apache2). |
Различные файлы BI-сервера будут располагаются в следующих папках:
| Папка или файл | Описание |
| /opt/prognoz/pp8.2-biserver/bin | Основные файлы BI-сервера. |
| /opt/prognoz/pp8.2-biserver/logs/axis2.log | Журнал обращений к BI-серверу. |
| /etc/opt/prognoz/pp8.2-biserver | Дополнительные конфигурационные файлы экземпляра BI-сервера, такие как файл envvars для задания переменных окружения Apache HTTP Server. |
| /etc/opt/prognoz/httpd2.2-pp8.2 (в Astra Linux)
/etc/apache2-pp8.2 (в Debian и Ubuntu) /etc/httpd-pp8.2 (в RHEL) |
Конфигурационные файлы экземпляра Apache HTTP Server. |
| /var/opt/prognoz/httpd2.2/logs/error-pp8.2.log
(в Astra Linux)
/var/log/apache2-pp8.2/error.log (в Debian и Ubuntu) /var/log/httpd/error-pp8.2.log (в RHEL) |
Ошибки и отладочные сообщения экземпляра Apache HTTP Server. |
| /var/opt/prognoz/httpd2.2/access-pp8.2.log (в
Astra Linux)
/var/log/apache2-pp8.2/access.log (в Debian и Ubuntu) /var/log/httpd/access-pp8.2.log (в RHEL) |
Журнал доступа к экземпляру Apache HTTP Server. |
| /root/.config/JSC Prognoz/Prognoz Platform | Общие конфигурационные файлы BI-сервера (путь может отличаться при изменении переменной окружения HOME). |
| /etc/init.d/prognoz-httpd2.2-pp8.2 (в Astra Linux)
/etc/init.d/apache2-pp8.2 (в Debian и Ubuntu) /etc/init.d/httpd-pp8.2 (в RHEL) |
init-скрипт запуска экземпляра Apache HTTP Server. |
| /etc/init.d/prognoz-xvfb | init-скрипт виртуального дисплея (X virtual framebuffer, по умолчанию запускается на дисплее с номером 987 и dpi 96). |
| /opt/prognoz/pp8.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. Приложение для установки pexf-файлов, содержащих обновления для объектов репозитория. Более подробно читайте в подразделе «Установка обновления». Для запуска выполните команду:
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 | Дополнительные настройки