На странице приведен пример установки и настройки BI-сервера на OC Синтез-ОС.РС.
Примечание. Функциональность BI-сервера ограничена набором доступных операций и их реализацией.
В этой статье:
Настройка директорий поиска библиотек
Выполните подготовительные действия перед установкой BI-сервера:
Убедитесь в соблюдении настроек операционной системы и программно-аппаратных требований, необходимых для корректной установки и полноценного функционирования веб-приложения «Форсайт. Аналитическая платформа».
Выполните настройку для серверной части СУБД.
Создайте репозиторий метаданных одним из способов:
в тестовом контуре с ОС Windows создайте репозиторий метаданных, служебного пользователя подсистемы безопасности и выполните настройку подключения к репозиторию, используя настольное приложение «Форсайт. Аналитическая платформа».
Перед созданием репозитория ознакомьтесь с разделом «Установка настольного приложения продукта «Форсайт. Аналитическая платформа»».
в тестовом контуре c ОС семейства Linux создайте репозиторий метаданных и выполните настройку подключения к репозиторию.
После выполнения одного из действий перенесите репозиторий и настройки подключения в промышленный контур средствами СУБД.
Выполните установку клиентской части СУБД:
Скачайте клиент Oracle с официального сайта (требуются пакеты basic, devel, sqlplus в RPM-формате).
Рассмотрим установку на примере клиента Oracle версии 12.1. Для этого скопируйте RPM-пакеты и установите командой:
sudo yum localinstall oracle-instantclient*
После установки добавьте путь до библиотек клиента Oracle с помощью утилиты ldconfig в список поиска зависимых библиотек и обновите кэш:
echo
"/usr/lib/oracle/12.1/client64/lib" > ~/oracle.conf
sudo cp ~/oracle.conf /etc/ld.so.conf.d/
sudo ldconfig
После установки BI-сервера в файл переменных окружения /etc/opt/Foresight/fp9.2-biserver/envvars для экземпляра Apache2 потребуется добавить экспорт переменной TNS_ADMIN с указанием каталога, содержащего файл tnsnames.ora. У экземпляра Apache2 должен быть доступ к файлу, можно установить владельца www-data:www-data для файла tnsnames.ora.
Подробней про создание базы данных для репозитория читайте в подразделе «Подготовка сервера Oracle».
Для установки клиента PostgreSQL из репозитория выполните следующую команду:
sudo yum install postgresql
Альтернативным вариантом является установка клиента Postgres Pro. Инструкция по установке доступна на сайте производителя.
Подробней про создание базы данных для репозитория читайте в подразделе «Подготовка сервера PostgreSQL».
Если осуществляется ручная установка BI-сервера из архива или установка клиентской части СУБД выполнена после установки BI-сервера, то нужно создать символьную ссылку:
sudo ln -s /usr/lib64/libpq.so.5 /usr/lib64/libpq.so
Настройка не требуется. Достаточно скопировать файл с базой репозитория на сервер, выдать права доступа BI-серверу к файлу и добавить SQLite-репозиторий с указанием файла базы.
Если репозиторий создан на базе СУБД Microsoft SQL Server, то работа с ним возможна через ODBC-драйвер. Более подробно читайте в статье «Подготовка ODBC драйвера для подключения к Microsoft SQL Server».
Примечание. Возможные проблемы, которые могут быть возникнуть после установки клиентской части СУБД при подключении к серверу СУБД, представлены в разделах, описывающих решение возможных проблем при установке, обновлении и при работе с «Форсайт. Аналитическая платформа».
Для работы BI-сервера «Форсайт. Аналитическая платформа» потребуется установка сторонних пакетов, которые можно загрузить из сети Интернет или, в случае отсутствия доступа к сети, установить из DVD-репозитория или из готовых rpm-пакетов. Если доступ к Интернет осуществляется через прокси-сервер, то произведите необходимые для подключения настройки.
Для корректной работы BI-сервера необходим установленный набор библиотек Qt версии 4.8.x. Библиотеки могут быть установлены одним из следующих способов:
скачать из открытых источников и установить пакет QtSdk-offline-linux-x86_64-v1.2.1.run. Предварительно необходимо убедиться в надёжности источника и проверить, что в пакете именно необходимая версия Qt 4.8.x;
подключить репозиторий, который содержит версию Qt 4.8.x и установить из него;
собрать и установить самостоятельно в соответствии с шагами, указанными ниже.
Рассмотрим пример самостоятельной сборки Qt версии 4.8.7 из исходных файлов и настройку «Форсайт. Аналитическая платформа» на использование этой сборки.
Загрузите архив с исходными кодами Qt-4.8.7:
wget https://download.qt.io/official_releases/qt/4.8/4.8.7/qt-everywhere-opensource-src-4.8.7.tar.gz
Установите необходимые для сборки пакеты:
sudo yum install gcc-c++ libX11-devel libXext-devel libXtst-devel libGLU-devel libxcb libxcb-devel xcb-util xcb-util-devel perl-version
Установите необходимые зависимые заголовки:
sudo yum install freetype-devel fontconfig-devel libmng-devel cups-devel dbus-devel libicu-devel glib2-devel libXrandr-devel libXv-devel libXrender-devel libXcursor-devel libXinerama-devel libpng-devel libtiff-devel libSM-devel mesa-libGL-devel libXi-devel
Распакуйте загруженный архив и перейдите в новый каталог:
tar zxf qt-everywhere-opensource-src-4.8.7.tar.gz
cd qt-everywhere-opensource-src-4.8.7
Конфигурирование и сборка (обязательно нужны OpenGL, freetype2; дополнительные параметры сборки Qt 4.8: http://doc.qt.io/qt-4.8/configure-options.html):
./configure -confirm-license -prefix /opt/Qt-4.8.7 -opensource -release -fast -xmlpatterns -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -svg -no-webkit -script -platform linux-g++-64 -system-zlib -system-libtiff -system-libpng -system-libjpeg -no-rpath -optimized-qmake -dbus-linked -reduce-relocations -verbose -no-gtkstyle -no-openvg -lfontconfig -I /usr/include/freetype2 -qvfb -icu -no-sql-ibase -no-sql-sqlite2 -no-sql-db2 -no-sql-oci -no-sql-tds -no-sql-odbc -no-sql-psql -no-sql-sqlite -no-sql-mysql -no-qt3support -opengl desktop -no-egl -cups -shared -largefile -no-separate-debug-info -sm -stl -system-libmng -xinput -xcursor -xfixes -xinerama -xshape -xrandr -xrender -xkb -glib -nomake examples -nomake tests -nomake docs -nomake demos
gmake -j4
sudo gmake install
Примечание. Указанная конфигурация является примером и при необходимости может быть изменена. При появлении сообщения «Tablet and Xinput support cannot be enabled due to functionality tests! Turn on verbose messaging (-v) to ./configure to see the final report. If you believe this message is in error you may use the continue switch (-continue) to ./configure to continue.» - необходимо заменить флаг конфигурации сборки «-xinput» на «-no-xinput».
Следующие пункты являются необязательным и могут использоваться, если необходимо собрать Qt в другой конфигурации или удалить ранее установленную версию.
При других параметрах сборки могут потребоваться зависимости:
sudo yum install mysql-devel unixODBC-devel postgresql-devel sqlite-devel pulseaudio-libs-devel alsa-lib-devel gtk2-devel
Для очистки папки сборки выполните команды:
gmake confclean
gmake clean
Для удаления сборки выполните команду:
sudo gmake uninstall
Если сборка выполняется не на BI-сервере, то можно перенести Qt на него, упаковав в архив каталог /opt/Qt-4.8.7, а потом распаковать архив на BI-сервере в этот же каталог и добавить путь до библиотек для ldconfig. Альтернативный вариант - упаковать в rpm с помощью утилиты checkinstall, но добавление пути до библиотек для ldconfig на сервере установки всё равно является обязательным.
Для добавления директорий поиска библиотек Qt и «Форсайт. Аналитическая платформа» выполните команды:
cd ~
echo > qt-x86_64.conf "/opt/Qt-4.8.7/lib"
sudo rm /etc/ld.so.conf.d/qt-x86_64.conf
sudo cp qt-x86_64.conf /etc/ld.so.conf.d/
sudo ldconfig
Примечание. Если Qt устанавливался из пакета QtSdk-offline-linux-x86_64-v1.2.1.run, то замените путь на «/opt/QtSDK/Desktop/Qt/4.8.1/gcc/lib».
Для установки BI-сервера выполните следующие действия:
В домашний каталог скопируйте архив в формате *.tar.gz с файлами установки BI-сервера продукта «Форсайт. Аналитическая платформа».
Распакуйте архив в каталог /opt/Foresight/9.2, для этого выполните в терминале следующие команды:
sudo mkdir -p /opt/Foresight/9.2
cd /opt/Foresight/9.2
sudo tar xvfz ~/<имя архива продукта «Форсайт. Аналитическая платформа»>.tar.gz
cd /opt/Foresight/9.2/bin
sudo chmod +x axis2_start.sh
Примечание. Скрипт axis2_start.sh требуется для проверки факта корректности базовой настройки системы и отладки, не может быть использован в промышленных условиях. Замените в скрипте строку «export LD_LIBRARY_PATH=:/opt/Foresight/9.2/bin:/opt/Qt-4.8.7/lib:$LD_LIBRARY_PATH» и раскомментируйте «export PPLOG=1».
sudo yum install
mesa-libGL mesa-libGLU libgomp libpng libjpeg
sudo yum install httpd
sudo yum install postgresql-server postgresql-contrib postgresql
sudo ln -s /usr/lib64/libpq.so.5 /usr/lib64/libpq.so
sudo yum install xorg-x11-server-Xvfb
После этого выполните установку и настройку служб httpd.
В данной статье приведен пример установки и настройки служб httpd для работы с BI-сервером на OC Синтез-ОС.РС. Рекомендуется перед установкой настроить виртуальный дисплей xvfb.
Чтобы установить и настроить службы httpd для работы с BI-сервером, выполните следующие действия:
HTTPD=/usr/sbin/httpd.worker
## Foresight Analytics Platform
export WSFCPP_HOME=/opt/Foresight/R90/bin
export LD_LIBRARY_PATH=$WSFCPP_HOME:/opt/Qt-4.8.7/lib:$LD_LIBRARY_PATH
export TNS_ADMIN=$WSFCPP_HOME
# Uncomment line below to export extended log
#export PPLOG=1
export HTTPD_LANG=en_US.UTF-8
export DISPLAY=localhost:987
export LD_PRELOAD=/opt/Qt-4.8.7/lib/libQtGui.so.4
export LSFORCEHOST=NO-NET
Примечание. В указанном примере версия Qt - 4.8.7. Если в ОС установлена другая версия, то скорректируйте указанные строки, указав соответствующую версию Qt. Например, если Qt устанавливался из пакета QtSdk-offline-linux-x86_64-v1.2.1.run, то замените путь «/opt/Qt-4.8.7/lib» на «/opt/QtSDK/Desktop/Qt/4.8.1/gcc/lib». В переменной окружения DISPLAY указывается номер дисплейного сервера, на котором будет отрисовываться графика. Рекомендуется использовать виртуальный дисплей xvfb под номером 987, но если используется физический X-сервер, то укажите его номер DISPLAY=:0.0.
<IfModule worker.c>
ServerLimit 1
StartServers 1
MaxClients 64
MinSpareThreads 32
MaxSpareThreads 64
ThreadsPerChild 64
MaxRequestsPerChild 0
</IfModule>
CoreDumpDirectory /tmp
## Foresight Analytics Platform
# Uncomment line below if use httpd 2.2
LoadModule axis2_module "/opt/Foresight/R90/bin/libmod_axis2_2_2.so"
# Uncomment line below if use htppd 2.4
#LoadModule axis2_module "/opt/Foresight/R90/bin/libmod_axis2_2_4.so"
Axis2RepoPath "/opt/Foresight/R90/bin"
Axis2LogFile "/opt/Foresight/R90/bin/logs/axis2.log"
Axis2LogLevel info
Axis2ServiceURLPrefix services
<Location /axis2>
SetHandler axis2_module
</Location>
sudo chkconfig httpd on
SELINUX=disabled
Примечание. Отключение SELinux осуществляется в качестве примера. Настройку подсистемы безопасности для работы с BI-сервером «Форсайт. Аналитическая платформа» должен осуществлять системный администратор.
Далее необходимо настроить xvfb. Пример настройки приведен в подразделе «Вывод графики через виртуальный дисплей xvfb».
Перезагрузите сервис httpd:
sudo service httpd restart
Проверьте работу BI-сервера, запущенного под httpd, для этого в браузере перейдите по ссылке http://localhost/axis2/services. Должна открыться страница со списком операций BI-сервера (см. раздел «Проверка работы BI-сервера»).
При своей работе BI-сервер использует настройки, заданные в файле settings.xml. Ознакомьтесь с его структурой и при необходимости внесите изменения.
Примечание. Наличие файла с настройками необязательно. Если файл отсутствует, то используются значения параметров по умолчанию.
Для получения информации о репозиториях, с которыми может осуществляться работа, BI-сервер использует файл registry.reg или Metabases.xml. О их настройке более подробно читайте в статье «Конфигурация и настройка».
На все дополнительные файлы, которые будет использовать BI-сервер, должны быть выданы права доступа для пользователя Apache HTTP Server:
sudo chown -R apache:apache /opt/Foresight/fp9.2-biserver
После выполнения настроек и раздачи прав перезагрузите сервис BI-сервер:
sudo service httpd restart
Выполните проверку работы BI-сервера.
Установленный BI-сервер будет работать в фоновом режиме как отдельный сервис Linux. Экземпляр Apache2 с BI-сервером будет запускаться на порту 80xx, где xx соответствует минорной версии релиза продукта «Форсайт. Аналитическая платформа».
После установки и настройки BI-сервера перейдите к установке серверной части веб-приложения.
См. также: