Установка Tomcat на Orange Pi и Raspberry Pi под Linux Ubuntu 16.04.1 LTS 3.4.113-sun8i (ARMBIAN 5.25)

При создании Java-приложений часто прибегают к использованию специального веб-сервера - Apache Tomcat.
Он является прямым осуществлением расширений Java Servlet и JavaServer Pages, реализованных Apache Software Foundation. Эта инструкция объясняет, как правильно запускать и настраивать веб-сервера Tomcat 8 на Raspberry Pi, Orange Pi и Banana Pi под Linux Ubuntu 16.04.1 LTS.
В инструкции описывается полный запуск и установка веб-сервера на Orange Pi PC в ОС - Linux Ubuntu 16.04.1 LTS 3.4.113-sun8i (ARMBIAN 5.25).

Пошаговая инструкция

Прежде всего, нужно установить программу Java для выполнения любых приложений.
Устанавливаем OpenJDK с помощью специальной программы apt-get.
Первое, что нужно сделать - обновление индекса пакетов:

sudo apt-get update

Потом - активировать Java Development Kit:

sudo apt-get install default-jdk

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

sudo groupadd tomcat

Придумываем пользователя томкат:

sudo useradd -s /bin/false -g tomcat -d /opt/tomcat tomcat

Его следует внести в группу с домашним каталогом, где будет установлен веб-сервер томкат, и шеллом, что не позволит посторонним входить в созданную учетку.
Уже после создания пользователя приступаем непосредственно к установлению tomcat-a.
Для этого загружаем самую последнюю версию томката с сайта, затем настраиваем ее мануально.
В статье используется Tomcat 8.5.43, однако можно смело использовать более новый вариант.
Открываем Binary Distributions, в перечне Core копируем адрес на tar.gz.
После переходим к папке /tmp сервера. В ней будут сохраняться только файлы временного предназначения, которые станут ненужными как только загрузится томкат. Кроме того, в случае перезагрузки, будет происходить их автоматическое очищение:

cd /tmp

Чтобы вставить скопированную ссылку используем curl:

curl -O https://www-eu.apache.org/dist/tomcat/tomcat-8/v8.5.43/bin/apache-tomcat-8.5.43.tar.gz

Далее необходимо создать директорию для установки будущего веб-сервера. После - извлечь архив:

udo mkdir /opt/tomcat
sudo tar xzvf apache-tomcat-8*tar.gz -C /opt/tomcat --strip-components=1

Потом указываем некоторые права доступа для юзеров.

Как обновить права

Надо предоставить юзеру, которого мы создавали, права на установку веб-сервера.
Как это сделать?
Открываем тот каталог, где распаковывали томкат:

cd /opt/tomcat

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

sudo chgrp -R tomcat /opt/tomcat

Потом производим активацию прав на директорию conf:

sudo chmod -R g+r conf
sudo chmod g+x conf

Даем юзеру томката права владельца на следующие каталоги:

sudo chown -R tomcat webapps/ work/ temp/ logs/

После настройки прав создаем документ systemd, чтоб управлять процессами.

Процесс создания документа systemd

Запускаем команду, которая находит путь JAVA_HOME (расположение программы):

sudo update-java-alternatives -l

java-1.8.0-openjdk-armhf 1074 /usr/lib/jvm/java-1.8.0-openjdk-armhf
java-gcj-5 /usr/lib/jvm/java-gcj-5

Далее следует задать переменные JAVA_HOME, JDK_HOME, JRE_HOME и добавить в path:

export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-armhf
export JDK_HOME=/usr/lib/jvm/java-1.8.0-openjdk-armhf
export JRE_HOME=/usr/lib/jvm/java-1.8.0-openjdk-armhf/jre
export PATH="$PATH:$JAVA_HOME/bin:$JRE_HOME/bin"

Эти действия нужно осуществлять только если JAVA_HOME не активирована.
Открываем tomcat.service набирая:

udo nano /etc/systemd/system/tomcat.service

Вписываем необходимые команды. Там же изменяем значение JAVA_HOME и CATALINA_OPTS, если требуется:

[Unit]
Description=Apache Tomcat Web Application Container
After=network.target

[Service]
Type=forking

Environment=CATALINA_PID=/opt/tomcat/temp/tomcat.pid
Environment=CATALINA_HOME=/opt/tomcat
Environment=CATALINA_BASE=/opt/tomcat
Environment=`CATALINA_OPTS=-Xms256M -Xmx768M -server -XX:+UseParallelGC`
Environment=`JAVA_OPTS=-Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom`

ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh

User=tomcat
Group=tomcat
UMask=0007
RestartSec=10
Restart=always

[Install]
WantedBy=multi-user.target

Потом следует сохранить и закрыть файл:

CTRL-X, Y, ENTER

Теперь - перезагружаем systemd daemon:

sudo systemctl daemon-reload

Далее - запуск Tomcat:

sudo systemctl start tomcat

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

sudo systemctl status tomcat

Тестировка веб-сервера

Чтобы проверить доступ дефолтной страницы сервера, нужно настроить браундмауэр. Это нужно для того, чтобы служба отвечала на каждый запрос.
Томкатом используется порт 8080, поэтому следует сделать разрешение трафика для этого порта:

sudo ufw allow 8080

Этот этап нужно выполнять, только если установлен и включен ufw.
После этого можно открывать дефолтную страницу:

http://<домен сервера или IP-адрес>:8080

В нашем варианте оно выглядит так:

http://192.168.0.100:8080

Если установка и запуск Tomcat прошли успешно, то следует активировать автозапуск:

sudo systemctl enable tomcat

Интерфейс Tomcat Web Management

Если кликнуть ссылку, вполне вероятно придет запрет на доступ. Поэтому требуется его настройка.
Для получения возможности использовать менеджерское приложение, требуется залогиниться на сервере, редактируя документ tomcat-users.xml:

sudo nano /opt/tomcat/conf/tomcat-users.xml

Для того, чтобы юзер получил права на доступ к manager-gui и admin-gui, нужно указать пользователя как на примере. Естественно, имя и пароль создаваемого юзера следует поменять:

<?xml version="1.0" encoding="UTF-8"?>
<tomcat-users xmlns="http://tomcat.apache.org/xml"<br> xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"<br> xsi:schemaLocation="http://tomcat.apache.org/xml tomcat-users.xsd"<br> version="1.0">
<role rolename="admin-gui"/>
<role rolename="manager-gui"/>
<user username="tomcat" password="tomcat" roles="manager-gui,admin-gui"/>
</tomcat-users>

Затем сохраняем и закрываем документ.
Обновленные версии веб-сервера зачастую накладывают ограничения на доступ к Manager и Host Manager при подсоединениях с сервера. Однако и это можно настроить. Чтоб поменять права доступа IP-адресов, надо открыть файлы context.xml.
В приложении Manager:

sudo nano /opt/tomcat/webapps/manager/META-INF/context.xml

В приложении Manager app:

sudo nano /opt/tomcat/webapps/host-manager/META-INF/context.xml

Теперь, изменяя ограниченный доступ IP-адресов, следует дать разрешение на соединение из любой точки. В случае, когда нужно дать право на подсоединение определенному IP, можно добавить его к перечню.
Оригинал документа context.xml:

<?xml version="1.0" encoding="UTF-8"?>
<Context antiResourceLocking="false" privileged="true" >
<Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />
</Context>

После удаления :

<?xml version="1.0" encoding="UTF-8"?>
<Context antiResourceLocking="false" privileged="true" >

</Context>

Сохраняем и закрываем.
При активации внесенных изменений, нужно перезапустить веб-сервер Tomcat:

sudo systemctl restart tomcat

Доступ к интерфейсу

Так как пользователь создан, можно открыть веб-интерфейс управления в браузере. Для этого снова указываем домен либо IP-адрес и порт 8080 в веб-браузере:

http://<домен сервера или IP-адрес>:8080

Итоги

Итак, активация веб-сервера Tomcat 8 успешно закончены. С этого момента можно смело приступать к созданию своих личных веб-приложений Java.