Как установить и настроить WildFly (JBoss) в Debian 10
WildFly, ранее известный как JBoss, — это бесплатный кроссплатформенный сервер приложений с открытым исходным кодом, который сейчас разрабатывается Red Hat. WildFly написан на Java и помогает вам создавать отличные приложения. Благодаря подключаемым подсистемам вы можете настроить приложение по мере необходимости. В этой статье мы объясним, как администратор Debian может установить и настроить Wildfly в своей системе.
Мы выполнили команды и процедуры, упомянутые в этой статье, в системе Debian 10 Buster.
Установить WildFly
Администратор Debian/(пользователь sudo) может установить стабильный сервер приложений WildFly, тщательно выполнив следующие действия:
Шаг 1. Откройте терминал или подключитесь к серверу по SSH.
Мы будем использовать командную строку Debian (Терминал) для установки и настройки WildFly. Открыть приложение Терминал можно через поиск в Панели запуска приложений следующим образом:
Шаг 2. Обновите индекс репозитория
Чтобы установить последнюю доступную версию программного обеспечения из интернет-репозиториев, индекс вашего локального репозитория должен соответствовать им. Запустите следующую команду от имени sudo, чтобы обновить индекс локального репозитория:
sudo apt-get update
Обратите внимание, что только авторизованный пользователь может добавлять, удалять и настраивать программное обеспечение в Debian.
Шаг 3. Установите пакет OpenJDK из APT.
Пожалуйста, запустите следующую команду от имени sudo, чтобы установить OpenJDK из репозиториев APT:
sudo apt-get install default-jdk
Система может запросить у вас пароль для sudo, а также предложить вариант «Да/Нет» для продолжения установки. Введите Y и нажмите Enter.
Шаг 4. Создайте пользователя и группу для WildFly.
В качестве предварительного шага вам необходимо создать пользователя и группу, которые в дальнейшем будут использоваться для запуска сервиса WildFly.
Выполните следующую команду, чтобы создать новую группу:
sudo groupadd -r wildfly
Запустите следующую команду, которая будет авторизована для запуска службы в /opt/wildfly.
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=16.0.0.Final
Я хочу загрузить версию 16.0.0.Final в свою систему. Эту переменную можно использовать во всех командах, где нужно указать версию WildFly.
Выполните следующую команду, чтобы загрузить файл tar.gz в папку /tmp вашего Debian.
wget https://download.jboss.org/wildfly/$Version_Number/wildfly-$Version_Number.tar.gz -P /tmp
Шаг 6. Извлеките файл tar.gz WildFly в папку /opt.
Программное обеспечение WildFly будет установлено после извлечения загруженного файла .tar.gz. Запустите следующую команду от имени sudo, чтобы извлечь файл в папку /opt.
sudo tar xf /tmp/wildfly-$Version_Number.tar.gz -C /opt/
Шаг 7. Создайте символическую ссылку, указывающую на каталог установки WildFly.
Запустите следующую команду, чтобы создать символическую ссылку по имени wildfly. Эта ссылка будет указывать на каталог установки Wildfly.
sudo ln -s /opt/wildfly-$Version_Number /opt/wildfly
Шаг 8. Предоставьте доступ группе и пользователю wildfly.
Пользователю и группе WildFly необходимо владеть каталогом установки WildFly, чтобы они могли получить доступ к WildFly и запустить его.
Для этого выполните следующую команду:
sudo chown -RH wildfly: /opt/wildfly
Шаг 9. Настройте Wildfly для запуска как службы
Пожалуйста, внимательно следуйте этим шагам, чтобы настроить WildFly для запуска в качестве службы Systemd:
1. Создайте каталог, куда скопируем файл wildfly.conf. Этот файл является частью пакета WildFly, который вы скачали и установили.
sudo mkdir -p /etc/wildfly
2. Скопируйте файл wildfly.conf из файлов пакета во вновь созданный каталог с помощью следующей команды:
sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/
3. Откройте файл конфигурации в редакторе Nano с помощью следующей команды:
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/
Также сделайте скрипт исполняемым с помощью следующей команды:
sudo sh -c 'chmod +x /opt/wildfly/bin/*.sh'
5. Последний файл, который нужно скопировать, — это файл модуля wildfly.service в папку служб вашей системы /etc/systemd/system.
sudo cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/
6. Наконец, вы должны сообщить вашей системе, что вы добавили новый файл модуля. Это можно сделать, перезагрузив демон systemctl:
sudo systemctl daemon-reload
Теперь вы готовы запустить службу WildFly от имени администратора.
Шаг 10. Запустите службу WildFly.
Теперь службу WildFly можно запускать как любую другую службу, распознаваемую Debian.
Запустите следующую команду от имени sudo, чтобы запустить службу:
sudo systemctl start wildfly
Вы можете проверить, все ли работает хорошо, проверив состояние службы следующим образом:
sudo systemctl status wildfly
Активный статус, как указано выше, подтверждает, что служба запущена и работает.
Еще одна вещь, которая вам поможет, — это включить службу wildfly при загрузке:
sudo systemctl enable wildfly
Настроить Wildfly
Теперь, когда мы установили WildFly и запустили его как службу, пришло время выполнить некоторые настройки. К ним в основном относятся:
- Настройка брандмауэра
- Создание безопасного администратора WildFly
- Проверка успешной настройки
- Доступ к административной консоли WildFly локально и удаленно
Пожалуйста, следуйте этим шагам один за другим, чтобы надежно использовать портал WildFly.
Шаг 1. Разрешите трафик на порту 8080.
Если вы хотите, чтобы к вашему серверу WildFly можно было получить удаленный доступ, вам необходимо разрешить трафик через порт 8080. Если в вашем Debian не установлено приложение брандмауэра UFW по умолчанию, выполните следующую команду, чтобы установить его в вашей системе:
sudo apt-get install ufw
Для этого выполните следующую команду:
sudo ufw allow 8080/tcp
Шаг 2. Создайте администратора WildFly
На этом этапе мы будем создавать и настраивать пользователя WildFly. Этот пользователь будет пользователем/администратором управления веб-консоли администрирования и интерфейса командной строки, который можно использовать удаленно.
Выполните следующую команду, чтобы запустить сценарий добавления пользователя из каталога WildFly:
sudo /opt/wildfly/bin/add-user.sh
Описанная ниже процедура в значительной степени не требует пояснений, но, тем не менее, мы вам поможем.
Сценарий сначала спросит вас, хотите ли вы создать пользователя управления или пользователя приложения:
Просто нажмите Enter, чтобы указать, что вы хотите создать пользователя управления.
Затем сценарий предложит вам добавить сведения о новом пользователе. Это включает в себя добавление имени пользователя нового администратора, а также указание и последующий повторный ввод пароля следующим образом:
На изображении выше вы можете видеть, что я создал пользователя с именем «admin-wildfly».
В следующем запросе вас спросят, должна ли пользователь иметь возможность использовать консоль удаленно.
Введите y, и сценарий проверит создание пользователя с помощью следующего сообщения:
Теперь этот пользователь может выполнять административные функции в WildFly.
Шаг 3. Проверьте успешную настройку WindFly.
Давайте теперь проверим, работает ли наш сервер WindFly. Откройте браузер и введите следующий URL-адрес:
http://<ваш_домен_или_IP_адрес>:8080
Я тестирую настройку на своем локальном хосте:
http://localhost:8080/
Если вы видите что-то похожее на то, что показано выше, мы можем заверить вас, что ваш экземпляр WildFly запущен и работает.
Как открыть Административную консоль через веб-интерфейс?
Введите следующий URL-адрес в своем браузере, чтобы открыть административную консоль через локальную систему:
http://localhost:9990/console
Укажите имя пользователя и пароль пользователя управления, которого вы создали на шаге 2 «Настройка WildFly». При нажатии кнопки ОК консоль откроется следующим образом:
Удаленное управление административной консолью
Чтобы получить удаленный доступ к административной консоли, вам необходимо выполнить небольшие настройки трех файлов WildFly.
1. Откройте файл wildfly.conf с помощью следующей команды:
sudo nano /etc/wildfly/wildfly.conf
Добавьте в конец файла следующие строки:
The address console to bind to
WILDFLY_CONSOLE_BIND=0.0.0.0
Вот как должен выглядеть файл:
Закройте файл, нажав Ctrl+X, а затем сохраните изменения, нажав y, а затем Enter.
2. Откройте файл сценария запуска .sh с помощью следующей команды:
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
Закройте файл, нажав Ctrl+X, а затем сохраните изменения, нажав y, а затем Enter.
После этого перезапустите службу WildFly с помощью следующей команды:
sudo systemctl restart wildfly
3. Наконец, отредактируйте файл wildfly.service с помощью следующей команды:
sudo nano /etc/systemd/system/wildfly.service
Замените выделенную строку на следующую:
ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND
Поскольку мы изменили файл служебного модуля, давайте уведомим систему с помощью следующей команды:
sudo systemctl daemon-reload
Также перезапустите службу WildFly с помощью следующей команды:
sudo systemctl restart wildfly
Теперь вы можете получить доступ к консоли, введя следующую консоль на удаленном компьютере:
http://<ваш_домен_или_IP_адрес>:9990/console
Убедитесь, что порт 9990 открыт для трафика на вашем брандмауэре.
Как открыть интерфейс командной строки административной консоли
Откройте терминал Debian и переключитесь в папку /opt/wildfly/bin, откуда мы будем запускать сценарий CLI:
cd /opt/wildfly/bin/
Затем введите следующую команду для запуска сценария CL административной консоли WildFly:
./jboss-cli.sh --connect
Теперь вы находитесь в консоли «[standalone@localhost:9990/].
Введите «помощь», чтобы увидеть, что вы можете здесь сделать.
Я проверю номер версии, введя команду «версия»:
Вы успешно установили и настроили WildFly в своей системе. Вы также знаете, как настроить WildFly и вашу систему для удаленного доступа к административной консоли.