如何在 Debian 9 上安装 WildFly (JBoss)

WildFly，以前称为 JBoss ，是一个用 Java 编写的跨平台开源应用程序运行时，可帮助您构建令人惊叹的应用程序。 WildFly 灵活、轻量，并且基于可根据需要添加或删除的可插拔子系统。

在本教程中，我们将引导您完成在 Debian 9 上安装 WildFly 应用程序服务器所需的步骤。

先决条件#

您登录时必须拥有的用户须藤权限能够安装软件包。

安装 Java OpenJDK#

WildFly 需要安装 Java。出色地安装 OpenJDK，这是 Debian 9 中默认的 Java 开发和运行时：

sudo apt updatesudo apt install default-jdk

创建用户#

创建新的系统用户 and group named wildfly与主目录/opt/wildfly将运行 WildFly 服务：

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

安装WildFly#

在撰写本文时，WildFly 的最新版本是16.0.0。在继续下一步之前，您应该检查下载页面以获得新版本。如果有新版本则替换WILDFLY_VERSION下面的命令中的变量。

下载 WildFly 存档/tmp使用以下目录wget命令：

WILDFLY_VERSION=16.0.0.Finalwget https://download.jboss.org/wildfly/$WILDFLY_VERSION/wildfly-$WILDFLY_VERSION.tar.gz -P /tmp

下载完成后，解压tar.gz文件并将其移动到/opt目录：

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

创建一个符号链接 wildfly这将指向 WildFly 安装目录：

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

WildFly 运行为wildfly需要访问 WildFly 安装目录的用户。更改目录所有权给用户和组wildfly:

sudo chown -RH wildfly: /opt/wildfly

配置Systemd#

WildFly 包包含将 WildFly 作为服务运行所需的文件。

开始于创建目录其中将保存 WildFly 配置文件：

sudo mkdir -p /etc/wildfly

将配置文件复制到/etc/wildfly目录：

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

该文件允许您指定 WildFly 模式和绑定地址。默认情况下，WildFly 将以独立模式运行并侦听所有接口。根据您的需要编辑文件。

# The configuration you want to run
WILDFLY_CONFIG=standalone.xml

# The mode you want to run
WILDFLY_MODE=standalone

# The address to bind to
WILDFLY_BIND=0.0.0.0

接下来，复制 WildFlylaunch.sh脚本到/opt/wildfly/bin/目录：

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

里面的脚本bin目录需要有可执行标志 :

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

最后一步是将 systemd 单元文件复制到/etc/systemd/system/目录：

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

重新加载 systemd 管理器配置：

sudo systemctl daemon-reload

启动并启用 WildFly 服务在启动时自动启动：

sudo systemctl start wildflysudo systemctl enable wildfly

使用以下命令检查服务状态：

sudo systemctl status wildfly

* wildfly.service - The WildFly Application Server
   Loaded: loaded (/etc/systemd/system/wildfly.service; disabled; vendor preset: enabled)
   Active: active (running) since Sun 2019-02-17 04:59:39 PST; 2s ago
 Main PID: 10005 (launch.sh)
    Tasks: 62 (limit: 2319)
   CGroup: /system.slice/wildfly.service

调整防火墙#

如果你的服务器是受防火墙保护如果您想从本地网络外部访问 WildFly 界面，您需要打开端口8080.

允许端口上的流量8080输入以下命令：

sudo ufw allow 8080/tcp

配置 WildFly 身份验证#

现在 WildFly 已安装并运行，下一步是创建一个能够使用管理控制台进行连接或使用 CLI 远程连接的用户。

要添加新用户，请使用add-user.sh位于 WildFly 的 bin 目录的脚本：

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

系统会询问您要添加什么类型的用户：

What type of user do you wish to add? 
 a) Management User (mgmt-users.properties) 
 b) Application User (application-users.properties)
(a):

Select a并击中Enter:

接下来，脚本将提示您输入新用户的详细信息：

Enter the details of the new user to add.
Using realm 'ManagementRealm' as discovered from the existing property files.
Username : linuxize
Password recommendations are listed below. To modify these restrictions edit the add-user.properties configuration file.
 - The password should be different from the username
 - The password should not be one of the following restricted values {root, admin, administrator}
 - The password should contain at least 8 characters, 1 alphabetic character(s), 1 digit(s), 1 non-alphanumeric symbol(s)
Password : 
Re-enter Password : 
What groups do you want this user to belong to? (Please enter a comma separated list, or leave blank for none)[  ]: 
About to add user 'linuxize' for realm 'ManagementRealm'
Is this correct yes/no? yes
Added user 'linuxize' to file '/opt/wildfly-16.0.0.Final/standalone/configuration/mgmt-users.properties'
Added user 'linuxize' to file '/opt/wildfly-16.0.0.Final/domain/configuration/mgmt-users.properties'
Added user 'linuxize' with groups  to file '/opt/wildfly-16.0.0.Final/standalone/configuration/mgmt-groups.properties'
Added user 'linuxize' with groups  to file '/opt/wildfly-16.0.0.Final/domain/configuration/mgmt-groups.properties'
Is this new user going to be used for one AS process to connect to another AS process? 
e.g. for a slave host controller connecting to the master or for a Remoting connection for server to server EJB calls.
yes/no? yes
To represent the user add the following to the server-identities definition <secret value="UGFuMjNkZWo3NyNA" />

新用户将被添加到用于身份验证的属性文件中。

测试 WildFly 安装#

要访问默认的 WildFly 页面，请打开你的浏览器并输入：http://<your_domain_or_IP_address>:8080

假设安装成功，将出现类似以下的屏幕：

访问 WildFly 管理控制台#

命令行界面#

要从命令行访问 WildFly 管理控制台，您可以使用jboss-cli.sh script.

导航到 WildFly 的 bin 目录并使用以下命令运行脚本--connect option:

cd /opt/wildfly/bin/./jboss-cli.sh --connect

系统将要求您输入管理用户名和密码（在第 6 步中创建）：

Authenticating against security realm: ManagementRealm
Username: linuxize
Password:

登录后，控制台提示符将更改为[standalone@localhost:9990 /]. Type help获取命令列表和命令语法。

从这里，您可以部署和取消部署应用程序、管理用户和组以及配置和监控 WildFly 服务器。

网页界面#

如果您喜欢从 GUI 管理服务器，WildFly 还提供基于 Web 的控制台。

默认情况下，WildFly 管理控制台只能从 localhost 访问：http://localhost:9990/console。使用您在步骤 6 中创建的用户登录。

如果您想从远程位置访问控制台，您需要对wildfly.service, wildfly.conf and launch.sh files.

打开wildfly.conf并附加WILDFLY_CONSOLE_BIND=0.0.0.0在文件末尾。

# The configuration you want to run
WILDFLY_CONFIG=standalone.xml

# The mode you want to run
WILDFLY_MODE=standalone

# The address to bind to
WILDFLY_BIND=0.0.0.0

# The address console to bind to
WILDFLY_CONSOLE_BIND=0.0.0.0

打开launch.sh并编辑突出显示的行：

#!/bin/bash

if [ "x$WILDFLY_HOME" = "x" ]; then
    WILDFLY_HOME="/opt/wildfly"
fi

if [[ "$1" == "domain" ]]; then
    $WILDFLY_HOME/bin/domain.sh -c $2 -b $3 -bmanagement $4
else
    $WILDFLY_HOME/bin/standalone.sh -c $2 -b $3 -bmanagement $4
fi

重新启动服务以使更改生效：

sudo systemctl restart wildfly

打开wildfly.service并编辑突出显示的行：

[Unit]
Description=The WildFly Application Server
After=syslog.target network.target
Before=httpd.service

[Service]
Environment=LAUNCH_JBOSS_IN_BACKGROUND=1
EnvironmentFile=-/etc/wildfly/wildfly.conf
User=wildfly
LimitNOFILE=102642
PIDFile=/var/run/wildfly/wildfly.pid
ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND
StandardOutput=null

[Install]
WantedBy=multi-user.target

创建/var/run/wildfly目录并设置正确的权限：

sudo mkdir /var/run/wildfly/sudo chown wildfly: /var/run/wildfly/

重新加载 systemd 管理器配置：

sudo systemctl daemon-reload

通过运行以下命令重新启动 WildFly 服务：

sudo systemctl restart wildfly

假设您的防火墙没有阻止该端口9990，您应该能够访问 WildFly 管理控制台http://<your_domain_or_IP_address>:9990/console.

结论#

您已在 Debian 9 服务器上成功安装 WildFly。你应该去官方看看WildFly 文档并了解有关 WildFly 功能的更多信息。

如果您遇到问题或有反馈，请在下面发表评论。