1.3. JBoss EAP 管理

如果要远程访问管理 CLI 或者使用管理控制台，您必须添加管理用户，即使流量源自于本地主机，也会被视为远程访问。如果在添加管理用户之前尝试访问管理控制台，您会收到错误消息。

默认的 JBoss EAP 配置提供本地身份验证，使用户可以访问本地主机上的管理 CLI，而无需进行身份验证。

如果您使用图形安装程序安装 JBoss EAP，则图形安装程序在安装过程中创建一个管理用户。

您可以使用 add-user 脚本为 JBoss EAP 添加管理用户，该脚本是向属性文件添加新用户以进行立即身份验证的工具。

您可以通过将参数传递给 add-user 脚本来以非交互方式创建用户。共享系统上不建议使用此方法，因为密码将在日志和历史记录文件中可见。

您可以通过在命令行中传递参数，以非交互方式运行 add-user 脚本。必须至少提供用户名和密码。

创建属于多个组的用户

以下命令添加一个管理用户 mgmtuser1，属于 guest 和 mgmtgroup 组：

EAP_HOME/bin/add-user.sh -u 'mgmtuser1' -p 'password1!' -g 'guest,mgmtgroup'

$ EAP_HOME/bin/add-user.sh -u 'mgmtuser1' -p 'password1!' -g 'guest,mgmtgroup'

指定备选属性文件

默认情况下，使用 add-user 脚本创建的用户和组信息存储在服务器配置目录中的属性文件中。

用户信息存储在以下属性文件中：

组信息存储在以下属性文件中：

以下命令添加了一个新用户，为用户属性文件指定了不同的名称和位置：

EAP_HOME/bin/add-user.sh -u 'mgmtuser2' -p 'password1!' -sc '/path/to/standaloneconfig/' -dc '/path/to/domainconfig/' -up 'newname.properties'

$ EAP_HOME/bin/add-user.sh -u 'mgmtuser2' -p 'password1!' -sc '/path/to/standaloneconfig/' -dc '/path/to/domainconfig/' -up 'newname.properties'

新用户已添加到位于 /path/to /standaloneconfig/newname.properties 和 /path/to /domainconfig/newname.properties 的用户属性文件中。请注意，这些文件必须已经存在，否则您将看到错误。

管理命令行界面(CLI)是 JBoss EAP 的命令行工具。

使用管理 CLI 启动和停止服务器、部署和删除应用、配置系统设置，以及执行其他管理任务。您可以在批处理模式下执行操作，允许多个任务作为一个组来运行。

有许多常见的终端命令可用，如 ls (list)、cd （更改目录）和 pwd （打印工作目录）。管理 CLI 也支持 tab 自动完成功能。

启动管理 CLI

EAP_HOME/bin/jboss-cli.sh

$ EAP_HOME/bin/jboss-cli.sh

连接到正在运行的服务器

connect

connect

您可以使用 EAP_HOME/bin/jboss-cli.sh --connect 命令来一步启动管理 CLI 并连接。

显示帮助

使用以下命令提供常规帮助：

help

help

在命令中使用 --help 标志，以接收有关使用该特定命令的说明。例如，要接收有关使用 deploy 的信息，请使用以下命令：

deploy --help

deploy --help

退出管理 CLI

使用以下命令退出管理 CLI：

quit

quit

查看系统设置

以下命令使用 read-attribute 操作来显示是否启用了示例数据源：

/subsystem=datasources/data-source=ExampleDS:read-attribute(name=enabled)
{
    "outcome" => "success",
    "result" => true
}

/subsystem=datasources/data-source=ExampleDS:read-attribute(name=enabled)
{
    "outcome" => "success",
    "result" => true
}

在受管域中运行服务器时，您必须在命令前使用/profile=PROFILE_NAME 指定要更新的配置集。

/profile=default/subsystem=datasources/data-source=ExampleDS:read-attribute(name=enabled)

/profile=default/subsystem=datasources/data-source=ExampleDS:read-attribute(name=enabled)

查看子系统配置

以下命令使用 read-resource-description 操作来显示给定子系统配置的描述，其中包括是否需要资源，是否有属性替换，等等：

/subsystem=datasources:read-resource-description(recursive=true)

/subsystem=datasources:read-resource-description(recursive=true)

更新系统设置

以下命令使用 write-attribute 操作来禁用示例数据源：

/subsystem=datasources/data-source=ExampleDS:write-attribute(name=enabled,value=false)

/subsystem=datasources/data-source=ExampleDS:write-attribute(name=enabled,value=false)

启动服务器

在受管域中运行时，使用以下命令启动和停止服务器：

/host=HOST_NAME/server-config=server-one:start

/host=HOST_NAME/server-config=server-one:start

管理控制台是用于 JBoss EAP 的基于 Web 的管理工具。

使用管理控制台启动和停止服务器、部署和删除应用程序、调优系统设置，并对服务器配置进行持久性修改。当用户进行需要重启或重新加载服务器的任何更改时，管理控制台还可以执行管理任务，并发出实时通知。

在受管域中，同一域中的服务器实例和服务器组通过域控制器的管理控制台集中管理。

对于运行在本地主机上使用默认管理端口的 JBoss EAP 实例，您可以通过 Web 浏览器访问管理控制台 http://localhost:9990/console/index.html。您必须使用具有访问管理控制台权限的用户角色进行身份验证。

管理控制台提供下列选项卡，用于浏览和管理 JBoss EAP 单机服务器或受管域。

/core-service=management/management-interface=http-interface:write-attribute(name=console-enabled,value=true)

/core-service=management/management-interface=http-interface:write-attribute(name=console-enabled,value=true)

/core-service=management/management-interface=http-interface:write-attribute(name=console-enabled,value=false)

/core-service=management/management-interface=http-interface:write-attribute(name=console-enabled,value=false)

独立配置文件位于 EAP_HOME/standalone/configuration/ 目录中。对于五个预定义的配置集（default, ha, full, full-ha, load-balancer），每个都有单独的文件。以下是启动 JBoss EAP 时可以使用管理 CLI 进行修改的示例配置文件。

默认情况下，将 JBoss EAP 作为单机服务器启动使用 standalone.xml 文件。若要使用其他配置启动 JBoss EAP，可使用 --server-config 参数：例如，

EAP_HOME/bin/standalone.sh --server-config=standalone-full.xml

$ EAP_HOME/bin/standalone.sh --server-config=standalone-full.xml

受管域配置文件位于 EAP_HOME/domain/configuration/ 目录中。以下是启动 JBoss EAP 时可以使用管理 CLI 进行修改的示例配置文件。

默认情况下，在受管域中启动 JBoss EAP 将使用 host.xml 文件。若要使用其他配置启动 JBoss EAP，可使用 --host-config 参数：例如，

EAP_HOME/bin/domain.sh --host-config=host-master.xml

$ EAP_HOME/bin/domain.sh --host-config=host-master.xml

要恢复您的 JBoss EAP 服务器配置，您必须在以下位置备份数据：

为了协助服务器维护和管理，JBoss EAP 在启动时创建原始配置文件的时间戳版本。

管理操作的任何其他配置更改将导致自动备份原始文件，保留实例的工作副本供引用和回滚。此外，还可以生成配置快照，它们是当前服务器配置的即时副本。这些快照可由管理员保存和加载。

以下示例使用 standalone.xml 文件，但同一进程适用于 domain.xml 和 host.xml 文件。

创建快照

使用管理 CLI 为当前配置生成快照。

:take-snapshot
{
    "outcome" => "success",
    "result" => "EAP_HOME/standalone/configuration/standalone_xml_history/snapshot/20151022-133109702standalone.xml"
}

:take-snapshot
{
    "outcome" => "success",
    "result" => "EAP_HOME/standalone/configuration/standalone_xml_history/snapshot/20151022-133109702standalone.xml"
}

列出快照

使用管理 CLI 列出所有快照。

:list-snapshots
{
    "outcome" => "success",
    "result" => {
        "directory" => "EAP_HOME/standalone/configuration/standalone_xml_history/snapshot",
        "names" => [
            "20151022-133109702standalone.xml",
            "20151022-132715958standalone.xml"
        ]
    }
}

:list-snapshots
{
    "outcome" => "success",
    "result" => {
        "directory" => "EAP_HOME/standalone/configuration/standalone_xml_history/snapshot",
        "names" => [
            "20151022-133109702standalone.xml",
            "20151022-132715958standalone.xml"
        ]
    }
}

删除快照

使用管理 CLI 删除快照。

:delete-snapshot(name=20151022-133109702standalone.xml)

:delete-snapshot(name=20151022-133109702standalone.xml)

您可以使用快照或自动保存的配置版本来启动服务器。

您可以在 JBoss EAP 中使用表达式来定义可替换属性，以替换配置中的文字值。

在 standalone*.xml 或 domain.xml 配置文件中使用属性替换，将属性替换为系统属性中找到的值。系统属性定义在 EAP 配置文件 xml 文件中，也可以在命令行终端中输入 -D 命令来定义。

要确定给定子系统中是否允许属性替换，请使用以下命令显示子系统配置的描述：

/subsystem=datasources:read-resource-description(recursive=true)

/subsystem=datasources:read-resource-description(recursive=true)

如果 expressions-allowed 属性被设为 true，则允许属性替换。

表达式的格式为 ${PARAMETER:DEFAULT_VALUE}。如果设置了指定参数，则将使用参数的值。否则，将使用提供的默认值。

解析表达式支持的源是系统属性和环境变量。使用环境变量解析表达式时，请使用 ${env.LANG} 格式。

来自 standalone.xml 配置文件的以下示例，将 public 接口的 inet-address 设为 127.0.0.1，除非设置了 jboss.bind.address 参数。

<interface name="public">
    <inet-address value="${jboss.bind.address:127.0.0.1}"/>
</interface>

<interface name="public">
    <inet-address value="${jboss.bind.address:127.0.0.1}"/>
</interface>

在将 EAP 作为独立服务器启动时，您可以使用以下命令设置 jboss.bind.address 参数：

EAP_HOME/bin/standalone.sh -Djboss.bind.address=IP_ADDRESS

$ EAP_HOME/bin/standalone.sh -Djboss.bind.address=IP_ADDRESS

您可以嵌套表达式，它允许更高级地使用表达式来代替固定值。

嵌套表达式的格式类似于普通表达式的格式，但一个表达式被嵌入在另一个表达式中，例如：

${SYSTEM_VALUE_1${SYSTEM_VALUE_2}}

${SYSTEM_VALUE_1${SYSTEM_VALUE_2}}

JBoss EAP 会递归评估嵌套表达式，因此首先评估 inner 表达式，然后评估 outer 表达式。表达式也可以是递归的，其中表达式被解析为另一个表达式，其然后再被解析。允许表达式的任何位置都允许嵌套表达式，但管理 CLI 命令除外。

例如，如果数据源定义密码被屏蔽，您可以使用嵌套的表达式。数据源的配置可能包含以下行：

<password>${VAULT::ds_ExampleDS::password::1}</password>

<password>${VAULT::ds_ExampleDS::password::1}</password>

系统属性(datasource_name)使用嵌套表达式替换了 ds_ExampleDS 的值。以下行是数据源的示例配置：

<password>${VAULT::${datasource_name}::password::1}</password>

<password>${VAULT::${datasource_name}::password::1}</password>

JBoss EAP 首先评估表达式 ${datasource_name}，然后将其输入到更大的表达式并评估生成的表达式。此配置的优点在于数据源的名称是从固定配置中提取的。

部署基于描述符的属性替换根据描述符替换属性，以便您可以删除应用程序和构建链中有关环境的假设。

特定环境的配置可以在部署描述符中指定，而不是注释或构建系统脚本。您可以在文件中提供配置，或者作为参数在命令行中提供。

应用程序配置（如数据源连接参数）通常会因开发、测试和生产环境而异。构建系统脚本有时可以容纳这种差异，因为 Jakarta EE 规范不包含将这些配置外部化的方法。借助 JBoss EAP，您可以使用基于描述符的属性替换在外部管理配置。

spec-descriptor-property-replacement 标志控制 Jakarta EE 描述符替换，JBoss EAP 默认 禁用 它。启用后，您可以在以下部署描述符中替换属性：

您可以使用以下管理 CLI 命令，来在 Jakarta EE 描述符中启用或禁用属性替换：

/subsystem=ee:write-attribute(name="spec-descriptor-property-replacement",value=VALUE)

/subsystem=ee:write-attribute(name="spec-descriptor-property-replacement",value=VALUE)

jboss-descriptor-property-replacement 标志控制特定于 JBoss 的描述符替换，而 JBoss EAP 默认启用它。启用后，您可以在以下部署描述符中替换属性：

使用以下管理 CLI 命令，来在 JBoss EAP 特定描述符中启用或禁用属性替换：

/subsystem=ee:write-attribute(name="jboss-descriptor-property-replacement",value=VALUE)

/subsystem=ee:write-attribute(name="jboss-descriptor-property-replacement",value=VALUE)

注解-property-replacement 标志控制注释内的属性替换，它默认不启用。启用后，您可以替换应用程序类中注释属性中的属性。

使用以下管理 CLI 命令，来在注释中启用或禁用属性替换：

/subsystem=ee:write-attribute(name="annotation-property-replacement",value=VALUE)

/subsystem=ee:write-attribute(name="annotation-property-replacement",value=VALUE)