Установка и настройка Wildfly (JBoss) в Ubuntu

WildFly, ранее известный как JBoss, - это бесплатный, с открытым исходным кодом и кросс-платформенный сервер приложений, который в настоящее время разрабатывается компанией Red Hat. WildFly написан на Java и помогает создавать отличные приложения. Благодаря его подключаемым подсистемам вы можете настраивать приложение так, как вам нужно. В этой статье мы расскажем, как администратор Ubuntu может установить и настроить Wildfly для локального и удаленного доступа.

Table of Contents

Установите Wildfly

Администратор Ubuntu может установить стабильный сервер приложений WildFly, тщательно выполнив следующие шаги:

Шаг 1: Откройте Терминал

Для установки и настройки WildFly мы будем использовать командную строку Ubuntu, Терминал. Вы можете открыть приложение Terminal либо через поиск Application Launcher, либо с помощью сочетания клавиш Ctrl+alt+T.

Шаг 2: Обновить индекс репозитория

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

sudo apt-get update

1	sudo apt-get update

Шаг 3: Установите пакет OpenJDK из APT

Выполните следующую команду от имени sudo, чтобы установить OpenJDK из репозиториев APT:

sudo apt-get install default-jdk

1	sudo apt-get install default-jdk

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

Система может запросить у вас пароль для sudo, а также предложить вам опцию Y/n для продолжения установки. Введите Y и нажмите Enter.

Шаг 4: Создание пользователя и группы для WildFly

В качестве предварительного шага необходимо создать пользователя и группу, которые впоследствии будут использоваться для запуска службы WildFly.

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

sudo groupadd -r wildfly

1	sudo groupadd -r wildfly

Выполните следующую команду, чтобы добавить пользователя, который будет уполномочен запускать службу из /opt/wildfly

sudo useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly

1	sudo useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly

Во время установки WildFly вам придется использовать некоторые длинные команды. Вместо того чтобы набирать команду, вы можете скопировать ее отсюда и вставить в Терминал с помощью клавиш Ctrl+Shift+V или с помощью опции Вставить из меню правой кнопки мыши.

Шаг 5: Скачайте установочный файл Wildfly

Сейчас мы будем загружать tar.gz для WildFly с официального сайта JBoss.

Во-первых, давайте создадим переменную для определения номера версии WildFly, которую мы хотим загрузить.

Version_Number=26.1.2.Final

1	Version_Number=26.1.2.Final

Последняя версия WildFly, на момент написания статьи, 26.1.2.Final. Эту переменную можно использовать во всех командах, где нужно указать версию WildFly.

Выполните следующую команду для загрузки tar.gz файла в папку /tmp вашего Ubuntu.

wget https://github.com/wildfly/wildfly/releases/download/$Version_Number/wildfly-$Version_Number.tar.gz -P /tmp

1	wget https://github.com/wildfly/wildfly/releases/download/$Version_Number/wildfly-$Version_Number.tar.gz -P /tmp

Шаг 6: Распакуйте файл WildFly tar.gz в папку /opt

Программное обеспечение WildFly будет установлено после того, как вы извлечете скачанный файл .tar.gz. Выполните следующую команду от имени sudo, чтобы извлечь файл в папку /opt.

sudo tar xf /tmp/wildfly-$Version_Number.tar.gz -C /opt/

1	sudo tar xf /tmp/wildfly-$Version_Number.tar.gz -C /opt/

Шаг 7: Создайте символическую ссылку, указывающую на каталог установки WildFly

Выполните следующую команду, чтобы создать символическую ссылку с именем wildfly. Эта ссылка будет указывать на каталог установки WildFly.

sudo ln -s /opt/wildfly-$Version_Number /opt/wildfly

1	sudo ln -s /opt/wildfly-$Version_Number /opt/wildfly

Шаг 8: Предоставьте доступ группе и пользователю WildFly

Пользователь и группа WildFly должны иметь право собственности на каталог установки WildFly, чтобы они могли получить доступ и запустить WildFly.

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

sudo chown -RH wildfly: /opt/wildfly

1	sudo chown -RH wildfly: /opt/wildfly

Шаг 9: Настройка Wildfly для запуска в качестве службы

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

1. Создайте каталог, в который мы скопируем файл wildfly.conf. Этот файл является частью пакета WildFly, который вы скачали и установили.

sudo mkdir -p /etc/wildfly

1	sudo mkdir -p /etc/wildfly

2. Скопируйте файл wildfly.conf из файлов пакета во вновь созданный каталог с помощью следующей команды:

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/

1	sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/

3. Откройте файл конфигурации в редакторе Nano с помощью следующей команды:

sudo nano /etc/wildfly/wildfly.conf

1	sudo nano /etc/wildfly/wildfly.conf

Конечно, вы можете использовать любой из ваших любимых текстовых редакторов.

Вот как выглядит файл:

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

4. Далее скопируйте сценарий launch.sh из пакета WildFly в папку /opt/wildfly/bin/:

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/

1	sudo cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/

Также сделайте скрипт исполняемым с помощью следующей команды:

sudo sh -c 'chmod +x /opt/wildfly/bin/*.sh'

1	sudo sh -c 'chmod +x /opt/wildfly/bin/*.sh'

5. Последний файл, который необходимо скопировать, это файл wildfly.service unit в папку служб вашей системы /etc/systemd/system

sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/

1	sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/

6. Наконец, необходимо сообщить системе, что вы добавили новый служебный файл. Это можно сделать, перезагрузив демон systemctl:

sudo systemctl daemon-reload

1	sudo systemctl daemon-reload

Теперь вы готовы запустить службу WildFly от имени администратора.

Шаг 10: Запустите службу WildFly

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

Выполните следующую команду от имени sudo, чтобы запустить службу:

sudo systemctl start wildfly

1	sudo systemctl start wildfly

Вы можете убедиться, что все работает хорошо, проверив статус службы следующим образом:

sudo systemctl status wildfly

1	sudo systemctl status wildfly

Статус Active, подтверждает, что служба запущена и работает.

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

sudo systemctl enable wildfly

1	sudo systemctl enable wildfly

Настройка WildFly

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

Настройка вашего брандмауэра
Создание безопасного администратора WildFly
Проверка успешной установки
Доступ к административной консоли WildFly локально и удаленно.

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

Шаг 1: Разрешить трафик на порту 8080

Системы Ubuntu по умолчанию защищены брандмауэром UFW. Если вы хотите, чтобы ваш сервер WildFly был доступен удаленно, вам необходимо разрешить трафик на порту 8080.

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

sudo ufw allow 8080/tcp

1	sudo ufw allow 8080/tcp

Шаг 2: Создание администратора WildFly

На этом шаге мы создадим и настроим пользователя WildFly. Этот пользователь будет управляющим пользователем/администратором для административной веб-консоли и CLI, который можно использовать удаленно.

Выполните следующую команду, чтобы запустить сценарий добавления пользователя из каталога WildFly:

sudo /opt/wildfly/bin/add-user.sh

1	sudo /opt/wildfly/bin/add-user.sh

Дальнейшая процедура практически не требует пояснений, но тем не менее мы вас проинструктируем.

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

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

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

На изображении выше видно, что я создал пользователя под именем "user".

Теперь этот пользователь может выполнять административные функции на WildFly.

Шаг 3: Проверка успешной установки WindFly

Теперь давайте проверим, работает ли наш сервер WindFly. Откройте браузер и введите следующий URL:

http://<ваш_домен_или_IP_адрес>:8080

Я тестирую настройку на своем локальном хосте:

http://localhost:8080/

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

Как открыть административную консоль через веб-интерфейс?

Введите в браузере следующий URL, чтобы открыть административную консоль через локальную систему:

http://localhost:9990/console

Укажите имя пользователя и пароль пользователя управления, который вы создали в Шаге 2 "Настройка WildFly". После нажатия кнопки OK консоль откроется следующим образом:

Удаленное управление административной консолью

Для того чтобы получить удаленный доступ к административной консоли, необходимо внести небольшие изменения в три файла WildFly.

1. Откройте файл wildfly.conf с помощью следующей команды:

sudo nano /etc/wildfly/wildfly.conf

1	sudo nano /etc/wildfly/wildfly.conf

Добавьте следующие строки в конец файла:

WILDFLY_CONSOLE_BIND=0.0.0.0

1	WILDFLY_CONSOLE_BIND=0.0.0.0

Вот как должен выглядеть файл:

Выйдите из файла через Ctrl+X, а затем сохраните изменения, нажав y, а затем Enter.

2. Откройте файл сценария запуска .sh с помощью следующей команды:

sudo nano /opt/wildfly/bin/launch.sh

1	sudo nano /opt/wildfly/bin/launch.sh

Измените выделенные строки на следующие:

    $WILDFLY_HOME/bin/domain.sh -c $2 -b $3 -bmanagement $4
else
    $WILDFLY_HOME/bin/standalone.sh -c $2 -b $3 -bmanagement $4

$WILDFLY_HOME/bin/domain.sh -c $2 -b $3 -bmanagement $4

else

$WILDFLY_HOME/bin/standalone.sh -c $2 -b $3 -bmanagement $4

Выйдите из файла через Ctrl+X, а затем сохраните изменения, нажав y, а затем Enter.

После этого перезапустите службу WildFly с помощью следующей команды:

sudo systemctl restart wildfly

3. Наконец, отредактируйте файл wildfly.service с помощью следующей команды:

sudo nano /etc/systemd/system/wildfly.service

1	sudo nano /etc/systemd/system/wildfly.service

Замените выделенную строку на следующую:

ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND

1	ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND

Поскольку мы изменили файл сервисного блока, давайте уведомим об этом систему с помощью следующей команды:

sudo systemctl daemon-reload

1	sudo systemctl daemon-reload

Также перезапустите службу WildFly с помощью следующей команды:

sudo systemctl restart wildfly

1	sudo systemctl restart wildfly

Добавьте порт 9990 в разрешенные в UFW

sudo ufw allow 9990/tcp

1	sudo ufw allow 9990/tcp

Теперь вы можете получить доступ к консоли, введя следующий URL на удаленной машине:

http://<ваш_домен_или_IP_адрес>:9990/console

Как открыть административную консоль CLI

Откройте терминал Ubuntu и перейдите в папку /opt/wildfly/bin, откуда мы будем запускать сценарий CLI:

cd /opt/wildfly/bin/

1	cd /opt/wildfly/bin/

Затем введите следующую команду для запуска сценария CLI административной консоли WildFly:

./jboss-cli.sh --connect

1	./jboss-cli.sh --connect

Теперь вы находитесь в консоли "[standalone@localhost:9990 /]".

Введите "help", чтобы узнать, что вы можете здесь сделать.

Я проверю номер версии, введя команду "version":

Вы успешно установили и настроили WildFly в своей системе. Вы также знаете, как настроить WildFly и вашу систему так, чтобы вы могли получить удаленный доступ к административной консоли.