Установка и настройка BI-сервера на ОС Синтез-ОС.РС

На странице приведен пример установки и настройки BI-сервера на OC Синтез-ОС.РС.

Примечание. Функциональность BI-сервера ограничена набором доступных операций и их реализацией.

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

Подготовка

Установка библиотек Qt

Настройка директорий поиска библиотек

Установка BI-сервера

Установка и настройка служб httpd для работы с BI-сервером

Настройка BI-сервера

Подготовка

Выполните подготовительные действия перед установкой BI-сервера:

  1. Убедитесь в соблюдении настроек операционной системы и программно-аппаратных требований, необходимых для корректной установки и полноценного функционирования веб-приложения «Форсайт. Аналитическая платформа».

  2. Выполните настройку для серверной части СУБД.

  1. Создайте репозиторий метаданных одним из способов:

Перед созданием репозитория ознакомьтесь с разделом «Установка настольного приложения продукта «Форсайт. Аналитическая платформа»».

После выполнения одного из действий перенесите репозиторий и настройки подключения в промышленный контур средствами СУБД.

  1. Выполните установку клиентской части СУБД:

Скачайте клиент 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».

Примечание. Возможные проблемы, которые могут быть возникнуть после установки клиентской части СУБД при подключении к серверу СУБД, представлены в разделах, описывающих решение возможных проблем при установке, обновлении и при работе с «Форсайт. Аналитическая платформа».

Установка библиотек Qt

Для работы BI-сервера «Форсайт. Аналитическая платформа» потребуется установка сторонних пакетов, которые можно загрузить из сети Интернет или, в случае отсутствия доступа к сети, установить из DVD-репозитория или из готовых rpm-пакетов. Если доступ к Интернет осуществляется через прокси-сервер, то произведите необходимые для подключения настройки.

Для корректной работы BI-сервера необходим установленный набор библиотек Qt версии 4.8.x. Библиотеки могут быть установлены одним из следующих способов:

Рассмотрим пример самостоятельной сборки Qt версии 4.8.7 из исходных файлов и настройку «Форсайт. Аналитическая платформа» на использование этой сборки.

  1. Загрузите архив с исходными кодами 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

  1. Установите необходимые для сборки пакеты:

sudo yum install gcc-c++ libX11-devel libXext-devel libXtst-devel libGLU-devel libxcb libxcb-devel xcb-util xcb-util-devel perl-version

  1. Установите необходимые зависимые заголовки:

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

  1. Распакуйте загруженный архив и перейдите в новый каталог:

tar zxf qt-everywhere-opensource-src-4.8.7.tar.gz

cd qt-everywhere-opensource-src-4.8.7

  1. Конфигурирование и сборка (обязательно нужны 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 в другой конфигурации или удалить ранее установленную версию.

  1. При других параметрах сборки могут потребоваться зависимости:

sudo yum install mysql-devel unixODBC-devel postgresql-devel sqlite-devel pulseaudio-libs-devel alsa-lib-devel gtk2-devel

  1. Для очистки папки сборки выполните команды:

gmake confclean

gmake clean

  1. Для удаления сборки выполните команду:

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-сервера

Для установки BI-сервера выполните следующие действия:

  1. В домашний каталог скопируйте архив в формате *.tar.gz с файлами установки BI-сервера продукта «Форсайт. Аналитическая платформа».

  1. Распакуйте архив в каталог /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».

  1. Установите дополнительные пакеты для BI-сервера продукта «Форсайт. Аналитическая платформа», выполнив в терминале следующие команды:

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-сервером

В данной статье приведен пример установки и настройки служб httpd для работы с BI-сервером на OC Синтез-ОС.РС. Рекомендуется перед установкой настроить виртуальный дисплей xvfb.

Чтобы установить и настроить службы httpd для работы с BI-сервером, выполните следующие действия:

  1. Добавьте в файл /etc/sysconfig/httpd следующие строки:

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.

  1. В файле /etc/httpd/conf/httpd.conf удалить теги <IfModule worker.c> с их содержимым. Добавьте:

<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>

  1. Добавьте автозапуск службы httpd:

sudo chkconfig httpd on

  1. Отключите SELinux в файле /etc/sysconfig/selinux, после чего перезагрузите компьютер:

SELINUX=disabled

Примечание. Отключение SELinux осуществляется в качестве примера. Настройку подсистемы безопасности для работы с BI-сервером «Форсайт. Аналитическая платформа» должен осуществлять системный администратор.

  1. Далее необходимо настроить xvfb. Пример настройки приведен в подразделе «Вывод графики через виртуальный дисплей xvfb».

  1. Перезагрузите сервис httpd:

sudo service httpd restart

  1. Проверьте работу BI-сервера, запущенного под httpd, для этого в браузере перейдите по ссылке http://localhost/axis2/services. Должна открыться страница со списком операций BI-сервера (см. раздел «Проверка работы BI-сервера»).

Настройка BI-сервера

  1. При своей работе BI-сервер использует настройки, заданные в файле settings.xml. Ознакомьтесь с его структурой и при необходимости внесите изменения.

Примечание. Наличие файла с настройками необязательно. Если файл отсутствует, то используются значения параметров по умолчанию.

  1. Для получения информации о репозиториях, с которыми может осуществляться работа, BI-сервер использует файл registry.reg или Metabases.xml. О их настройке более подробно читайте в статье «Конфигурация и настройка».

  2. Активируйте продукт «Форсайт. Аналитическая платформа».

  3. На все дополнительные файлы, которые будет использовать BI-сервер, должны быть выданы права доступа для пользователя Apache HTTP Server:

sudo chown -R apache:apache /opt/Foresight/fp9.2-biserver

  1. После выполнения настроек и раздачи прав перезагрузите сервис BI-сервер:

sudo service httpd restart

  1. Выполните проверку работы BI-сервера.

Установленный BI-сервер будет работать в фоновом режиме как отдельный сервис Linux. Экземпляр Apache2 с BI-сервером будет запускаться на порту 80xx, где xx соответствует минорной версии релиза продукта «Форсайт. Аналитическая платформа».

После установки и настройки BI-сервера перейдите к установке серверной части веб-приложения.

См. также:

Установка BI-сервера в ОС Linux