Нашли ошибку? Выделите
текст с ошибкой и нажмите кнопку "Сообщить об ошибке"
или CTRL+ENTER.
Справочная
система на версию 9.2
Update 17 от 29/12/2020,
© ООО «ФОРСАЙТ»,
На странице приведен пример установки, настройки и удаления BI-сервера на OC Debian, Ubuntu и Astra Linux. Поддерживаемые версии Linux приведены в статье «Поддерживаемые версии ОС Linux».
Примечание. Функциональность BI-сервера ограничена набором доступных операций и их реализацией.
В этой статье:
Также можно посмотреть видеоинструкцию по установке BI-сервера на Ubuntu 16.04 на YouTube:
Выполните подготовительные действия перед установкой BI-сервера:
Убедитесь в соблюдении настроек операционной системы и программно-аппаратных требований, необходимых для корректной установки и полноценного функционирования веб-приложения «Форсайт. Аналитическая платформа».
Выполните настройку для серверной части СУБД.
Создайте репозиторий метаданных одним из способов:
в тестовом контуре с ОС Windows создайте репозиторий метаданных, служебного пользователя подсистемы безопасности и выполните настройку подключения к репозиторию, используя настольное приложение «Форсайт. Аналитическая платформа».
Перед созданием репозитория ознакомьтесь с разделом «Установка настольного приложения продукта «Форсайт. Аналитическая платформа»».
в тестовом контуре c ОС семейства Linux создайте репозиторий метаданных и выполните настройку подключения к репозиторию.
После выполнения одного из действий перенесите репозиторий и настройки подключения в промышленный контур средствами СУБД.
Выполните установку клиентской части СУБД:
Скачайте клиент Oracle с официального сайта (требуются пакеты basic, devel, sqlplus в RPM-формате).
Рассмотрим установку на примере клиента Oracle версии 12.1. Выполните следующие действия:
sudo
apt-get install alien
sudo alien oracle-instantclient12.1-basic-12.1.0.2.0-1.x86_64.rpm
sudo alien oracle-instantclient12.1-devel-12.1.0.2.0-1.x86_64.rpm
sudo alien oracle-instantclient12.1-sqlplus-12.1.0.2.0-1.x86_64.rpm
sudo
apt-get install libaio1
sudo dpkg -i oracle-instantclient12.1*.deb
После установки добавьте путь до библиотек клиента 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 apt-get install postgresql-client
Альтернативным вариантом является установка клиента Postgres Pro. Инструкция по установке доступна на сайте производителя.
Подробней про создание базы данных для репозитория читайте в подразделе «Подготовка сервера PostgreSQL».
Если осуществляется ручная установка BI-сервера из архива или установка клиентской части СУБД выполнена после установки BI-сервера, то нужно создать символьную ссылку:
sudo ln -s /usr/lib/x86_64-linux-gnu/libpq.so.5 /usr/lib/x86_64-linux-gnu/libpq.so
Настройка не требуется. Достаточно скопировать файл с базой репозитория на сервер, выдать права доступа BI-серверу к файлу и добавить SQLite-репозиторий с указанием файла базы.
Если репозиторий создан на базе СУБД Microsoft SQL Server, то работа с ним возможна через ODBC-драйвер. Более подробно читайте в статье «Подготовка ODBC драйвера для подключения к Microsoft SQL Server».
Примечание. Возможные проблемы, которые могут быть возникнуть после установки клиентской части СУБД при подключении к серверу СУБД, представлены в разделах, описывающих решение возможных проблем при установке, обновлении и при работе с «Форсайт. Аналитическая платформа».
Для работы BI-сервера продукта «Форсайт. Аналитическая платформа» потребуется установка сторонних пакетов, которые можно загрузить из сети Интернет или, в случае отсутствия доступа к сети, установить из DVD-репозитория или из готовых deb-пакетов. Если доступ к Интернет осуществляется через прокси-сервер, то произведите необходимые для подключения настройки.
Перед установкой каких-либо пакетов обновите информацию о пакетах в репозитории. Для этого выполните команду:
sudo apt-get update
Если работа осуществляется в ОС Astra Linux SE, то перейдите к разделу ниже по установке Apache HTTP Server с модулем coworker. При работе в других дистрибутивах, включая Astra Linux CE, данная настройка не требуется.
При установке Deb-пакета BI-сервера в ОС Astra Linux SE предварительно потребуется установить сборку Apache HTTP Server (httpd) с модулем MPM coworker и обеспечить доступ в репозиторий (подойдёт установочный диск ОС) с пакетами libc6 libstdc++6 libssl1.0.0 libglib2.0-0 libx11-6 libglu1-mesa libgomp1 xvfb.
Deb-пакет «Foresight-httpd2.4.41-1~AstraLinuxSE~1.6_amd64.deb» с Apache HTTP Server входит в комплект поставки BI-сервера для ОС Linux. Скопируйте его в домашнюю директорию и установите, выполнив следующую команду:
sudo dpkg -i Foresight-httpd*
После этого перейдите к непосредственной установке BI-сервера.
Для установки deb-пакета BI-сервера потребуется доступ в репозиторий с зависимыми пакетами: libc6, libstdc++6, libglib2.0-0, lsb-release, libx11-6, libgl1-mesa-glx, libglu1-mesa, libgomp1, libxi6, libxrandr2, libxrender1, libxcursor1, libxinerama1, fontconfig, fonts-liberation, xvfb, libldap-2.4-2, libqt5gui5, libqt5opengl5, qt5-image-formats-plugins, libssl1.0.2, libtiff5, libjpeg62-turbo.
Если есть модули или пакеты, которые не совместимы с MPM Worker (например, libapache2-mod-php5) - их необходимо отключить на экземпляре BI-сервера, либо удалить, если они вызывают конфликт при установке BI-сервера. Далее выполните следующие действия:
Скопируйте deb-пакет вида «Foresight-fp9.2-biserver_9.2.*.deb» в домашнюю директорию.
Установите скопированный пакет (может использоваться другая утилита для установки пакетов):
sudo dpkg -i Foresight-fp9.2-biserver*
Установите недостающие зависимости (может потребоваться обновить список пакетов из репозиториев командой sudo apt-get update):
sudo apt-get -f install
В процессе установки будет создан новый экземпляр конфигурации Apache2 для BI-сервера, включен модуль mpm_worker, включен модуль fp9.2-biserver для загрузки mod_axis2, созданы ссылки вида apache2ctl-fp9.2 в директории /usr/local/sbin для управления экземпляром, зарегистрирован и добавлен в автозагрузку сервис apache2-fp9.2, установлены файлы «Форсайт. Аналитическая платформа», зарегистрирован и добавлен в автозагрузку сервис Foresight-xvfb для запуска виртуального графического дисплея под номером 987. Сервис Foresight-xvfb будет запущен автоматически, а apache2-fp9.2 потребует запуска командой:
sudo service apache2-fp9.2 start
При работе в Astra Linux SE запуск выполняется следующей командой:
sudo service foresight-httpd-fp9.2 start
Примечание. Для изменения версии BI-сервера достаточно установить поверх другую версию пакета. Файлы конфигурации будут сохранены, если в пакете не будет обновлена их версия.
После установки для отслеживания работы BI-сервера и фиксирования различных ошибок можно включить логирование системных сообщений:
В файл /etc/opt/Foresight/fp9.2-biserver/envvars добавьте и раскомментируйте следующие строки:
## Uncomment line below to export extended log
#export PP_LOG=1
В файл /etc/apache2-fp9.2/mods-available/fp9.2-biserver.conf добавьте следующие строки:
Axis2LogFile "/opt/Foresight/fp9.2-biserver/logs/axis2.log"
Axis2LogLevel info
При своей работе BI-сервер использует настройки, заданные в файле settings.xml. Ознакомьтесь с его структурой и при необходимости внесите изменения.
Примечание. Наличие файла с настройками необязательно. Если файл отсутствует, то используются значения параметров по умолчанию.
Для получения информации о репозиториях, с которыми может осуществляться работа, BI-сервер использует файл registry.reg или Metabases.xml. О их настройке более подробно читайте в статье «Конфигурация и настройка».
На все дополнительные файлы, которые будет использовать BI-сервер, должны быть выданы права доступа для пользователя Apache HTTP Server:
sudo chown -R www-data:www-data /opt/Foresight/fp9.2-biserver
После выполнения настроек и раздачи прав перезагрузите сервис BI-сервер:
sudo service apache2-fp9.2 restart
или при работе в Astra Linux SE:
sudo service foresight-httpd-fp9.2 restart
Выполните проверку работы BI-сервера.
Установленный BI-сервер будет работать в фоновом режиме как отдельный сервис Linux. Экземпляр Apache2 с BI-сервером будет запускаться на порту 80xx, где xx соответствует минорной версии релиза продукта «Форсайт. Аналитическая платформа».
После установки и настройки BI-сервера перейдите к установке серверной части веб-приложения.
Для удаления файлов BI-сервера без удаления конфигурационных файлов выполните команду и подтвердите удаление:
sudo apt-get remove fp9.2-biserver
Все файлы конфигурации в папках /etc/apache2-fp9.2 и /etc/opt/Foresight/fp9.2-biserver, а также новые файлы, не входящие в пакет установки, в этих папках и /opt/Foresight/fp9.2-biserver будут сохранены и могут быть использованы при следующей установке пакета.
Для полного удаления BI-сервера вместе с файлами конфигурации выполните команду и подтвердите удаление:
sudo apt-get purge fp9.2-biserver
При этом новые файлы, не входящие в пакет установки, будут сохранены.
См. также:
Установка веб-приложения на ОС Linux | Проверка работы BI-сервера