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

Установка и настройка серверной части «Форсайт. Бюджетирование»

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

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

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

Установка серверной части продукта

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

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

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

Internet Information Server Apache Tomcat Apache HTTP Server

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

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

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

устанавливает файлы серверной части «Форсайт. Бюджетирование»;
настраивает IIS;
создаёт пул приложений (BUD Pool v1.0) и виртуальный каталог (BUD_App_v1.0).

Для установки серверной части продукта:

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

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

На следующем этапе установки необходимо определить папку, в которую будут установлены файлы серверной части. По умолчанию предлагается папка «C:\Program Files (x86)\Foresight\» или «C:\Program Files\Foresight\» в зависимости от разрядности операционной системы. Для изменения папки нажмите кнопку «Изменить». В выбранной папке при установке будет создан подкаталог «Budgeting 1.0»:

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

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

После завершения установки нажмите кнопку «Готово»:

Установка серверной части выполняется с помощью файла BUD_App_v1.0.war (единый для x86 и x64 платформ). Файл располагается в папке Budgeting комплекта поставки.

Процесс установки зависит от используемой версии 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. После авторизации будет открыта страница:

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

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

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

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

Установка серверной части продукта выполняется с помощью файла BUD_App_v1.0.war (единый для x86 и x64 платформ). Файл располагается в папке Budgeting комплекта поставки.

Предварительно должна быть создана папка, в которой будет располагаться бизнес-приложение, например, /opt/Foresight/10.x/bud.

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

				unzip BUD_App_v1.0.war 
				 
			

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

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

Настройка серверной части продукта

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

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

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

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

IIS:

C:\Program Files\Foresight\Budgeting 1.0\config

Apache Tomcat:

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

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

Примечание. Указанный путь до папки с установленным Apache Tomcat может отличаться в зависимости от её расположения.

Apache HTTP Server:

/opt/foresight/10.x/bud/config

Apache Tomcat:

/path_to_tomcat/webapps/path/config

Где:

path_to_tomcat. Путь до установки Apache Tomcat;
path. Контекстный путь, указанный на четвертом шаге установки Apache Tomcat.

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

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

Где:

port. Номер порта, через который осуществляется работа;
fpBI_App_v10.x. Название виртуального каталога, который создается при установке BI-сервера.

Примечание. При использовании Apache Tomcat пропустите данный шаг.

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

/fpBI_App_v10.x/axis2/services/PP.SOM.Som

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

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

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

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

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

{
  "targetRepo": "PROD_BUD",
  "targetApp": "BP_BUDGET",
  "ppServiceUrl": "http://SampleServer/fpBI_App_v10.x/axis2/services/PP.SOM.Som",

  "locale": ["ru"],
  "repositories": {
    "PROD_BUD": {
      "repoIdent": "PROD_BUD",
      "apps": {
        "BP_BUDGET": {
          "appIdent": "BP_BUDGET",
          "breadcrumbRootTitle": "Бюджетирование",
          "mainMenuLogo": "assets/design/img/budget_new.png",
          "extraBackgroundColor": "#e89121",
          "pageMetadataTitle": "Бизнес-планирование <br> и бюджетирование",
          "pageMetadataProductIcon": "assets/design/img/budget.svg",
          "pageMetadataLogo": "assets/design/img/budget_login.png"
        }
      }
    }
  }
}

Перезапустите веб-сервер.

IIS Apache Tomcat Apache HTTP Server

Для перезапуска IIS обратитесь к документации Microsoft.

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

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

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

если Apache Tomcat запущен в качестве службы OC Linux, то выполните команду:

sudo systemctl restart tomcat

Примечание. Файл tomcat является пользовательским и его наименование может отличаться.

если Apache Tomcat запущен вручную, то выполните команды:

/path_to_tomcat/bin/catalina.sh stop

/path_to_tomcat/bin/catalina.sh start

Где:

path_to_tomcat. Путь до установки Apache Tomcat.

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

ОС RHEL:

sudo service httpd restart

Debian-подобные дистрибутивы:

sudo service apache2 restart

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

Открытие продукта

Для открытия продукта «Форсайт. Бюджетирование» в веб-приложении:

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

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

IIS:

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

Примечание. Виртуальный каталог BUD_App_v1.0 создается автоматически при установке серверной части продукта.

Apache Tomcat:

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

Где:

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

Apache HTTP Server:

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

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

Apache Tomcat:

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

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

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

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

Настройка структуры бокового меню веб-приложения и наполнение пользовательскими объектами выполняется в настольном приложении продукта. Подробное описание приведено в статье «Создание структуры меню».

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

http://localhost/BUD_App_v1.0/#/login?repo=TEST_BUD&app=BUD_APP;
http://localhost:8080/bud/#/login?repo=TEST_BUD&app=BUD_APP.

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

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

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