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

Установка и настройка серверной части конструктора бизнес-приложений

Серверная часть конструктора бизнес-приложений используется для работы в веб-интерфейсе с готовым бизнес-приложением, которое создаётся с помощью дополнительного инструмента продукта «Форсайт. Аналитическая платформа» - «Конструктор бизнес-приложений».

Для работы серверной части требуется наличие установленного и настроенного BI-сервера, а также созданного в репозитории бизнес-приложения. Установку необходимо производить от имени пользователя, обладающего правами локального администратора компьютера.

Убедитесь, что на рабочей станции, где будет запускаться веб-приложение, установлен браузер, соответствующий системным требованиям.

Установка

Установка северной части конструктора бизнес-приложений выполняется с помощью одного из веб-серверов:

для OC Windows: Internet Information Server, Apache Tomcat и Apache HTTP Server;
для OC Linux: Apache Tomcat и Apache HTTP Server.

Примечание. Установка конструктора бизнес-приложений на Apache Tomcat выполняется одинаково для OC Windows и OC Linux.

Internet Information Server Apache Tomcat Apache HTTP Server

Перед началом установки, если веб-сервер будет устанавливаться на серверной операционной системе Windows, убедитесь, что была добавлена роль сервера. Если веб-сервер будет установлен не на серверной OC Windows, то перед установкой необходимо подключить службы IIS.

Установка серверной части выполняется с помощью инсталлятора DBAWebServer.exe (единый для x86 и x64 платформ).

Инсталлятор выполняет следующие действия:

устанавливает файлы серверной части конструктора бизнес-приложений;
настраивает IIS;
создаёт пул приложений (DBA Pool v9.2) и виртуальный каталог (DBA_App_v9.2).

Для установки серверной части конструктора бизнес-приложений:

Запустите инсталлятор, выберите язык установки. После подготовки к установке будет отображена стартовая страница с вводной информацией:

Для продолжения установки нажмите кнопку «Далее».

На следующем этапе установки необходимо определить папку, в которую будут установлены файлы серверной части. По умолчанию предлагается папка «C:\Program Files\Foresight\» или «C:\Program Files (x86)\Foresight\» при установке в x64 ОС. Для изменения папки нажмите кнопку «Изменить» В выбранной папке при установке будет создан подкаталог «Designer of Business Application Web Server».

Для продолжения установки нажмите кнопку «Далее».

На следующей странице для начала установки нажмите кнопку «Установить».

На последней странице нажмите кнопку «Готово» для завершения установки.

Установка серверной части конструктора бизнес-приложений выполняется с помощью файла DBA.war (единый для x86 и x64 платформ). Файл располагается в папке Java_DBAWeb комплекта поставки.

Процесс установки зависит от используемой версии Java. В инструкции приведен пример установки конструктора бизнес-приложений на Java веб-сервер Apache Tomcat версии 9.

Примечание. Также имеется возможность запустить конструктор бизнес-приложений на веб-сервере Apache без использования Java через Apache HTTP Server.

Предварительно установите и настройте Apache Tomcat в соответствии с инструкциями для OC Windows и OC Linux.

Для установки серверной части конструктора бизнес-приложений:

Откройте консоль администрирования Apache Tomcat, используя следующий адрес:

http://localhost:<port>/

где <port> - порт, указанный при установке Apache Tomcat. По умолчанию имеет значение 8080.

Нажмите кнопку «Manager app». Будет открыто всплывающее окно для запроса авторизации.
Укажите учётные данные администратора указанные при установке Apache Tomcat. После авторизации будет открыта страница:

Укажите путь к файлу DBA.war:

перейдите к разделу «Развернуть серверный WAR файл» и укажите контекстный путь в поле «Путь», который будет добавляться в строке браузера для доступа к конструктору бизнес-приложений, например «/DBA». Затем укажите путь к файлу DBA.war в поле «WAR или путь до директории»;
перейдите к разделу «WAR файл для развёртывания», нажмите кнопку «Выберите файл» и укажите путь к файлу DBA.war.

Нажмите кнопку «Развернуть».

Если все шаги были выполнены корректно, то конструктор бизнес-приложений будет добавлен в список приложений Apache Tomcat, а на странице появится соответствующее сообщение.

Предварительно должна быть создана папка, в которой будет располагаться бизнес-приложение, например:

OC Windows:

C:\Program Files\Foresight\DBA\

OC Linux:

/opt/Foresight/9.2/dba/

Скопируйте архив DBA.war в созданную папку и выполните команду для распаковки.

Веб-сервер Apache HTTP Server (Apache2) устанавливается вместе с BI-сервером. Установите веб-сервер Apache HTTP Server, если он не был установлен ранее:

Настройка

Для корректной работы конструктора бизнес-приложения должны быть заданы настройки подключения к BI-серверу и указаны идентификаторы репозитория и бизнес-приложения. Настройки задаются в файле DBA.config.json, который расположен в папке установки серверной части бизнес-приложения.

Для задания настроек подключения к бизнес-приложению:

Перейдите в папку с установленной серверной частью. Путь, по которому должен быть расположен файл DBA.config.json, зависит от типа используемого веб-сервера:

Путь для ОС Windows Путь для ОС Linux

IIS и Apache HTTP Server:

C:\Program Files\Foresight\Designer of Business Application Web Server\config

Apache Tomcat:

C:\Tomcat\webapps\<path>\config

где <path> - контекстный путь, указанный на четвертом шаге установки Apache Tomcat.

Apache HTTP Server:

/opt/foresight/9.2/<path>/config

Apache Tomcat:

/var/lib/tomcat9/webapps/<path>/config

где <path> - контекстный путь, указанный на четвертом шаге установки Apache Tomcat.

Переименуйте файл sample-DBA.config.json, находящийся в подкаталоге Config, или его копию в DBA.config.json. Полученный файл откройте в текстовом редакторе.
Добавьте ссылку на BI-сервер, к которому будет осуществляться подключение к репозиторию и передачи данных. Ссылка указывается в качестве значения для элемента «ppServiceUrl»:

Ссылка на BI-сервер для Windows Ссылка на BI-сервер для Linux

IIS:

http://localhost[:port]/fpBI_App_v9.2x64/axis2/services/PP.SOM.Som

где <port> - номер порта, через который осуществляется работа, fpBI_App_v9.2x64 - название виртуального каталога, который создается при установке BI-сервера.

Apache Tomcat и Apache HTTP Server:

http://localhost[:port]/axis2/services/PP.SOM.Som

Apache Tomcat и Apache HTTP Server:

http://localhost/axis2/services/PP.SOM.Som

Если BI-сервер и веб-сервер физически расположены на одном компьютере и работают через один порт, то в «ppServiceUrl» можно указать относительный путь к BI-серверу, например:

/fpBI_App_v9.2x64/axis2/services/PP.SOM.Som

Примечание. При работе с бизнес-приложением непосредственное подключение к BI-серверу осуществляется с клиентского компьютера пользователя, поэтому в качестве значения элемента «ppServiceUrl» необходимо указывать адрес, к которому у пользователя есть доступ.

Замените текстовые метки:

ID_REPO замените на идентификатор репозитория, в котором установлено расширение и создано бизнес-приложение. Настройки подключения к указываемому репозиторию также должны быть заданы на BI-сервере (Windows / Linux).
ID_APP замените на идентификатор созданного и настроенного в репозитории бизнес-приложения.

Пример файла DBA.config.json

Пример файла, который должен получиться после выполнения указанных действий:

{

  "targetRepo": "TEST_REPOSITORY",

  "targetApp": "TEST_APP",

  "ppServiceUrl": "http://SampleServer/fpBI_App_v9.2x64/axis2/services/PP.SOM.Som",


  "locale": ["ru"],

  "repositories": {

    "TEST_REPOSITORY": {

      "repoIdent": "TEST_REPOSITORY",

      "apps": {

        "TEST_APP": {

          "appIdent": "TEST_APP",

          "breadcrumbRootTitle": "FORESIGHT. Бизнес приложение",

          "mainMenuLogo": "assets/design/img/PPlogo_sm.png",

          "pageMetadataLogo": "assets/design/img/PPlogo.png"

        }

      }

    }

  }

}

Задайте дополнительные настройки Apache HTTP Server для доступа к ресурсам конструктора бизнес-приложения.

Примеры настроек в зависимости от операционной системы, в которой запущен веб-сервер:

Перезапустите веб-серверы Apache Tomcat и Apache HTTP Server.

Apache Tomcat Apache HTTP Server

Для перезапуска Apache Tomcat на OC Windows:

Откройте скрытые значки на панели задач.
Выполните команду контекстного меню Apache Tomcat «Stop service», затем выполните команду «Start service».

Для перезапуска Apache Tomcat на OC Linux выполните в терминале команды:

ОС RHEL:

/opt/tomcat9/<имя архива Apache Tomcat 9>/bin/catalina.sh stop

/opt/tomcat9/<имя архива Apache Tomcat 9>/bin/catalina.sh run

ОС Ubuntu:

sudo service tomcat9 restart

ОС Astra Linux:

~/<имя архива Apache Tomcat 9>/bin/catalina.sh stop

~/<имя архива Apache Tomcat 9>/bin/catalina.sh start

ОС Debian:

sudo systemctl restart tomcat9

Перезапуск Apache HTTP Server на OC Windows не требуется. Вместо этого запустите файл htpd.exe.

Для перезапуска Apache HTTP Server на OC Linux выполните в терминале команды:

ОС RHEL:

sudo service httpd restart

ОС Ubuntu:

sudo service apache2 restart

ОС Astra Linux:

sudo /etc/init.d/Foresight-httpd2.2-dbatop

sudo /etc/init.d/Foresight-httpd2.2-dba start

Для перезагрузки Apache HTTP Server из поставки продукта «Форсайт. Аналитическая платформа» используйте команду:

sudo service Foresight-httpd-fp9.2 restart

ОС Debian:

sudo systemctl restart apache2-dba

Указанные шаги являются минимально необходимыми для того, чтобы получить доступ к бизнес-приложению в веб-интерфейсе. При необходимости можно определить другие настройки и расширить список репозиториев и бизнес-приложений, с которыми возможна работа. Более подробно смотрите в описании структуры файла DBA.config.json.

Открытие

Для открытия веб-интерфейса конструктора бизнес-приложений:

Откройте поддерживаемый браузер и укажите адрес веб-приложения в строке подключения:

Адрес для Windows Адрес для Linux

IIS и Apache HTTP Server:

http://<IP-адрес или имя рабочей станции>/DBA_App_v9.2/

Примечание. Виртуальный каталог DBA_App_v9.2 создается автоматически при установке серверной части констуктора бизнес-приложений.

Apache Tomcat:

http://<IP-адрес или имя рабочей станции>:<порт>/DBA/

Apache HTTP Server:

http://<IP-адрес или имя рабочей станции>/dba/

Примечание. Виртуальный каталог dba создается вручную при установке серверной части веб-приложения.

Apache Tomcat:

http://<IP-адрес или имя рабочей станции>:<порт>/dba/

Должна открыться стартовая страница конструктора бизнес-приложений для авторизации в репозитории. Бизнес-приложение использует настройки, заданные в файле DBA.config.json. При работе с адресом по умолчанию, например: http://localhost/DBA_App_v9.2/, открывается бизнес-приложение, указанное для элемента targetApp, из репозитория, указанного для элемента targetRepo в файле DBA.config.json.

Примечание. Если окно авторизации не отображается, а выводится только белый экран, то проверьте соответствие вашего браузера минимальным требования и при необходимости обновите его до актуальной версии.

Укажите логин и пароль. После проверки учётных данных будет открыт интерфейс бизнес-приложения.

Для подключения к другому репозиторию и открытию другого бизнес-приложения, настройки которого имеются в файле DBA.config.json, к адресу могут быть добавлены дополнительные параметры «repo» и «app», например:

http://localhost/DBA_App_v9.2/#/login?repo=TEST_REPOSITORY&app=TEST_APP;
http://localhost:8080/dba/#/login?repo=TEST_REPOSITORY&app=TEST_APP.

Возможные ошибки

Описание возможных ошибок, возникающих при настройке веб-серверов IIS и Apache, приведено в статье «Проблемы при настройке веб-приложения «Форсайт. Аналитическая платформа» на ASP.NET».