Установка серверной части веб-приложения на ОС Debian

В данной статье приведен пример установки серверной части веб-приложения на OC Debian (поддерживаемые версии).

Производите установку от имени пользователя, обладающего правами локального администратора компьютера.

Установка веб-приложения на OC Linux выполняется с помощью установочного архива pp.war (единый для x86 и x64 платформ). Процесс установки зависит от используемой версии Java. В инструкции приведен пример установки веб-приложения на веб-сервер Apache Tomcat версии 8.

Примечание. Также имеется возможность запустить веб-приложение на веб-сервере Apache без использования Java. Более подробно читайте в разделе «Настройка Apache для доступа к ресурсам веб-приложения».

  1. Установите пакеты tomcat8 и tomcat8-admin (в терминале, можно обойтись без веб-интерфейса администратора, распаковав в дальнейшем файл pp.war как архив с помощью утилиты jar или unzip):

sudo apt install tomcat8 tomcat8-admin

  1. Откройте на редактирование файл /etc/tomcat8/tomcat-users.xml (в некоторых случаях файл конфигурации находится здесь: /var/lib/tomcat8/conf/tomcat-users.xml). Добавьте пользователя с правами manager-gui:

<tomcat-users>
<role rolename="manager-gui"/>
<user username="user" password="123456" roles="manager-gui"/>
</tomcat-users>

  1. Установите Oracle Java.

  2. После установки Oracle Java 8, нужно изменить переменную JAVA_HOME в файле /etc/default/tomcat8. Установите следующее значение:

JAVA_HOME=/usr/lib/jvm/jre-8-oracle-x64

  1. В этом же файле для загрузки больших файлов внутри приложение потребуется убрать/увеличить лимит оперативной памяти для Apache Tomcat. Это задаётся параметрами запуска Java-приложения. Для этого из переменной JAVA_OPTS надо удалить параметр -Xmx128m (или изменить на нужный лимит памяти) и добавить параметры -XX:PermSize=256m -XX:MaxPermSize=2048m:

JAVA_OPTS="-Djava.awt.headless=true -XX:+UseConcMarkSweepGC -XX:PermSize=256m -XX:MaxPermSize=2048m"

  1. Если размер веб-архива веб-приложения pp.war превышает лимит загрузки по умолчанию равный 50 мегабайт, то отредактируйте допустимый лимит. Для этого откройте файл /usr/share/tomcat8-admin/manager/WEB-INF/web.xml и добавьте по нулю справа от значений параметров max-file-size и max-request-size:

<multipart-config>
<!-- 50MB max -->
<max-file-size>524288000</max-file-size>
<max-request-size>524288000</max-request-size>
</multipart-config>

  1. Перезапустите Apache Tomcat с помощью утилиты systemctl (в терминале):

sudo systemctl restart tomcat8

Примечание. Для проверки работы Apache Tomcat в браузере перейдите на страницу http://localhost:8080/.

  1. В браузере перейдите на странице администрирования Apache Tomcat по ссылке http://localhost:8080/manager/html. Авторизуйтесь под пользователем, который был указан в tomcat-users.xml.

  2. На открывшейся странице перейдите к разделу «WAR file to deploy». Нажмите кнопку «Browse» и укажите путь к  файлу pp.war:

Нажмите кнопку «Deploy». Убедитесь, что приложение успешно установлено:

  1. Добавьте ссылку на BI-сервер и идентификатор репозитория, к которому будет осуществляться подключение, в файле PP.xml. Чтобы открыть файл, в терминале выполните команду:

sudo gedit /var/lib/tomcat8/webapps/pp/config/PP.xml

<service url="http://localhost:9090/axis2/services/PP.SOM.Som" timeout="120000" />
<metabase id="FPREPOSITORY" ping="59000" />

<service url="http://localhost/fpBI_App_v9.2x64/axis2/services/PP.SOM.Som" timeout="120000" />
<metabase id="FPREPOSITORY" ping="59000" />

Если BI-сервер был установлен с помощью установочного пакета, то строка будет иметь следующий вид:

<service url="http://localhost:8092/fpBI_App_v9.2x64/axis2/services/PP.SOM.Som" />

  1. Перезапустите Apache Tomcat:

sudo systemctl restart tomcat8

  1. Откройте веб-приложение, перейдя в браузере по ссылке http://localhost:8080/pp/app/login.html?repo=FPREPOSITORY, где FPREPOSITORY - идентификатор репозитория. Если не удаётся авторизоваться, то проверьте работу BI-сервера.

См. также:

Установка и настройка в Debian-подобных дистрибутивах | Установка серверной части веб-приложения на Java