配置指南

JBoss EAP 7 引入了暂停模式，可正常暂停服务器操作。这允许所有活动的请求正常完成，但不接受任何新请求。服务器暂停后，可以关机，返回到运行中状态，或保持暂停状态以执行维护。

可以使用管理控制台或管理 CLI 暂停和恢复服务器。

检查 Server Suspend 状态

可以通过下列管理 CLI 命令查看服务器暂停状态：生成的值为 RUNNING、PRE_SUSPEND、SUSPEND ING 或 SUS PENDED 之一。

suspend

使用以下管理 CLI 命令，通过指定超时值（以秒为单位）暂停服务器，以便服务器等待活动请求完成：默认值为 0，它会立即暂停。值为 -1 将导致服务器无限期等待所有活动的请求完成。

每个示例最多等待 60 秒以请求完成，然后再暂停。

恢复

restore 命令将服务器返回到正常运行状态，以接受新请求。您可以在主机、服务器、服务器组或域级别启动 命令。例如：

:resume

在 Suspended State 中启动 Server

您可以启动处于暂停状态的服务器，以便在服务器恢复之前不会接受任何请求。

如果在停止服务器时指定了适当的超时值，则会安全地关闭服务器。发出 命令后，服务器将被暂停，并将等待所有请求的指定超时完成，然后再关机。

使用以下管理 CLI 命令，安全地关闭服务器：指定服务器的超时值（以秒为单位），以便服务器等待活跃请求完成。默认值为 0，它将立即关闭服务器。值为 -1 将导致服务器无限期等待所有活动的请求完成，然后再关机。

每个示例最多等待 60 秒以请求完成，然后关机。

可以通过发送 OS TERM 信号 （如 kill -15 PID ）来安全地关闭服务器。默认情况下，这个值与管理 CLI 的 shutdown --suspend-timeout=0 命令相同，从而导致任何当前处理请求立即终止。超时可以通过 org.wildfly.sigterm.suspend.timeout 系统属性进行配置，这表示服务器关闭之前等待请求完成的最大秒数。值 -1 表示服务器将无限期等待。

如果使用 OS 信号正常关机，如果 JVM 配置为禁用信号处理，例如 -Xrs java 参数已传递到 JVM 选项，或者发送的信号不是进程可以响应的信号，例如发送 KILL 信号 时，则不会起作用。

启动 JBoss EAP RPM 安装的命令取决于您要启动的操作模式、单机服务器或受管域，以及您正在运行的红帽企业 Linux 版本。

启动 JBoss EAP 作为单机服务器（RPM 安装）

默认情况下，此操作将使用 standalone.xml 配置文件启动 JBoss EAP。您可以通过在 RPM 服务配置文件中设置属性，使用不同的单机服务器配置文件启动 JBoss EAP。如需更多信息，请参阅以下 Configure RPM Service Properties 部分。

在受管域中启动 JBoss EAP（RPM 安装）

默认情况下，此操作将使用 host.xml 配置文件启动 JBoss EAP。您可以通过在 RPM 服务配置文件中设置属性，使用不同的受管域配置文件启动 JBoss EAP。如需更多信息，请参阅以下 Configure RPM Service Properties 部分。

配置 RPM 服务属性

本节介绍如何为您的 JBoss EAP 安装配置 RPM 服务属性和其他启动选项。请注意，建议在进行修改前备份您的配置文件。

有关 RPM 安装的所有可用启动选项列表，请参阅 RPM 服务配置属性部分。

用于停止 JBoss EAP RPM 安装的命令取决于启动的运营模式、单机服务器或受管域，以及您正在运行的红帽企业 Linux 版本。

停止 JBoss EAP 作为单机服务器（RPM 安装）

在受管域中停止 JBoss EAP（RPM 安装）

有关 RPM 安装的所有可用启动选项列表，请参阅 RPM 服务配置文件 部分。

也可以通过向 add-user 脚本传递参数，以非交互方式创建用户。共享系统上不建议使用此方法，因为密码将在日志和历史记录文件中可见。如需更多信息，请参阅非活动运行 Add-User 实用程序。

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

创建一个属于多个组的用户

以下命令添加了一个管理用户, mgmtuser1，它带有 guest and 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'

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

有关所有可用 add-user 参数及其目的的完整列表，请使用 --help 参数或参阅 Add-User 实用程序参数 部分。

可以使用 EAP_HOME/bin/add -user.properties 文件配置 add -user 实用程序脚本的密码限制。

要避免设置不需要的密码，请检查键盘的系统键映射是否正确。默认系统键映射为 en-qwerty。如果更改此默认设置并创建新密码，您必须检查密码是否满足类 SimplePasswordStrengthChecker 中的条件。

默认情况下，JBoss EAP 允许弱密码，但会发出警告。要拒绝不满足指定最低要求的密码，请将 password.restriction 属性设置为 REJECT。

下表描述了可在 EAP_HOME/bin/add-user.properties 文件中配置的额外密码要求设置：

您可以使用 add-user 实用程序脚本在提示时输入用户名来更新现有管理用户的设置。

$ EAP_HOME/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): a

Enter the details of the new user to add.
Using realm 'ManagementRealm' as discovered from the existing property files.
Username : test-user
User 'test-user' already exists and is enabled, would you like to...
 a) Update the existing user password and roles
 b) Disable the existing user
 c) Type a new username
(a):

当您输入已存在的用户名时，会显示几个选项：

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

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

许多常见的终端命令可用，如 ls、cd 和 pwd。管理 CLI 也支持 tab 自动完成功能。

有关使用管理 CLI 的详细信息，包括命令和操作、语法以及批处理模式下运行，请参阅 JBoss EAP管理 CLI 指南。

启动管理 CLI

$ EAP_HOME/bin/jboss-cli.sh

连接到正在运行的服务器

connect

或者，您可以使用 EAP_HOME/bin/jboss-cli.sh --connect 命令启动管理 CLI 并在一个步骤中进行连接。

显示帮助

使用以下命令获取一般帮助：

help

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

deploy --help

退出管理 CLI

quit

查看系统设置

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

/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)

更新系统设置

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

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

启动服务器

管理 CLI 也可用于在受管域中运行时启动和停止服务器。

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

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

使用管理控制台启动和停止服务器、部署和取消部署应用、调优系统设置，以及对服务器配置进行持续修改。管理控制台还具备执行管理任务的功能，当当前用户执行的任何更改都要求重新启动或重新加载服务器实例时，实时通知功能。

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

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

管理控制台提供下列选项卡，用于浏览和管理 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=false)

HTTP API 端点是管理客户端的入口点，它依赖于 HTTP 协议与 JBoss EAP 管理层集成。

HTTP API 由 JBoss EAP 管理控制台使用，但也为其他客户端提供集成功能。默认情况下，HTTP API 可通过 http://HOST_NAME: 9990/management 访问。此 URL 将显示公开给 API 的原始属性和值。

读取资源

虽然您可以使用 HTTP POST 方法读取、写入或执行其他操作，但您可以使用 GET 请求 来执行一些读取操作。HTTP GET 方法使用以下 URL 格式：

http://HOST_NAME:9990/management/PATH_TO_RESOURCE?operation=OPERATION&PARAMETER=VALUE

务必将所有可替换值替换为适合您的请求的值。以下值是 OPERATION 可替换 值 的可用选项：

以下示例 URL 演示了如何使用 HTTP API 执行读取操作。

http://HOST_NAME:9990/management/subsystem/undertow/server/default-server/http-listener/default

这将显示 默认 HTTP 侦听器的所有属性及其值。

http://HOST_NAME:9990/management/subsystem/datasources/data-source/ExampleDS?operation=attribute&name=enabled

这会读取 ExampleDS 数据源的 enabled 属性的值。

更新资源

您可以使用 HTTP POST 方法更新配置值或使用 HTTP API 执行其他操作。您必须为这些操作提供身份验证。

以下示例演示了如何使用 HTTP API 更新资源。

$ curl --digest http://HOST_NAME:9990/management --header "Content-Type: application/json" -u USERNAME:PASSWORD -d '{"operation":"write-attribute", "address":["subsystem","datasources","data-source","ExampleDS"], "name":"enabled", "value":"false", "json.pretty":"1"}'

这会将 ExampleDS 数据源的 enabled 属性值更新为 false。

$ curl --digest http://localhost:9990/management --header "Content-Type: application/json" -u USERNAME:PASSWORD -d '{"operation":"reload"}'

这将重新加载服务器。

如需有关如何使用 HTTP API 部署应用程序到 JBoss EAP 的信息，请参阅使用 HTTP API 部署应用。

原生 API 端点是管理客户端的入口点，它依赖于原生协议与 JBoss EAP 管理层集成。原生 API 由 JBoss EAP 管理 CLI 使用，但也为其他客户端提供集成功能。

以下 Java 代码演示了如何使用原生 API 从 Java 代码执行管理操作的示例。

// Create the management client
ModelControllerClient client = ModelControllerClient.Factory.create("localhost", 9990);

// Create the operation request
ModelNode op = new ModelNode();

// Set the operation
op.get("operation").set("read-resource");

// Set the address
ModelNode address = op.get("address");
address.add("subsystem", "undertow");
address.add("server", "default-server");
address.add("http-listener", "default");

// Execute the operation and manipulate the result
ModelNode returnVal = client.execute(op);
System.out.println("Outcome: " + returnVal.get("outcome").toString());
System.out.println("Result: " + returnVal.get("result").toString());

// Close the client
client.close();

独立配置文件位于 EAP_HOME/standalone/configuration/ 目录中。每个预定义配置文件（默认为 ha、full、full-ha、负载平衡器）均存在单独的 文件。

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

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

受管域配置文件位于 EAP_HOME/domain/configuration/ 目录中。

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

$ 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"
}

列出快照

使用管理 CLI 列出已执行的所有快照。

: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)

使用快照启动服务器

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

JBoss EAP 7 提供了跟踪对运行系统进行的配置更改的功能。这样，管理员可以查看其他授权用户所做的配置更改历史记录。

您可以从管理 CLI 或管理控制台启用跟踪和查看配置更改。

通过管理 CLI 跟踪和查看配置更改

若要启用跟踪配置更改，可使用以下管理 CLI 命令：您可以使用 max-history 属性指定要存储的条目数量。

/subsystem=core-management/service=configuration-changes:add(max-history=20)

/host=HOST_NAME/subsystem=core-management/service=configuration-changes:add(max-history=20)

要查看最近的配置更改列表，请使用以下管理 CLI 命令：

/subsystem=core-management/service=configuration-changes:list-changes

/host=HOST_NAME/subsystem=core-management/service=configuration-changes:list-changes

/host=HOST_NAME/server=SERVER_NAME/subsystem=core-management/service=configuration-changes:list-changes

这会列出所做的每个配置更改，包括日期、来源、结果和操作详情。例如，以下 list-changes 命令的输出显示配置更改，最近显示的第一个显示为第一个。

{
    "outcome" => "success",
    "result" => [
        {
            "operation-date" => "2016-02-12T18:37:00.354Z",
            "access-mechanism" => "NATIVE",
            "remote-address" => "127.0.0.1/127.0.0.1",
            "outcome" => "success",
            "operations" => [{
                "address" => [],
                "operation" => "reload",
                "operation-headers" => {
                    "caller-type" => "user",
                    "access-mechanism" => "NATIVE"
                }
            }]
        },
        {
            "operation-date" => "2016-02-12T18:34:16.859Z",
            "access-mechanism" => "NATIVE",
            "remote-address" => "127.0.0.1/127.0.0.1",
            "outcome" => "success",
            "operations" => [{
                "address" => [
                    ("subsystem" => "datasources"),
                    ("data-source" => "ExampleDS")
                ],
                "operation" => "write-attribute",
                "name" => "enabled",
                "value" => false,
                "operation-headers" => {
                    "caller-type" => "user",
                    "access-mechanism" => "NATIVE"
                }
            }]
        },
        {
            "operation-date" => "2016-02-12T18:24:11.670Z",
            "access-mechanism" => "HTTP",
            "remote-address" => "127.0.0.1/127.0.0.1",
            "outcome" => "success",
            "operations" => [{
                "operation" => "remove",
                "address" => [
                    ("subsystem" => "messaging-activemq"),
                    ("server" => "default"),
                    ("jms-queue" => "ExpiryQueue")
                ],
                "operation-headers" => {"access-mechanism" => "HTTP"}
            }]
        }
    ]
}

这个示例列出了影响配置的三个操作详情：

从管理控制台跟踪和查看配置更改

若要启用从管理控制台跟踪配置更改，可选择到 Runtime 选项卡，前往服务器或主机以跟踪 的更改，并从下拉菜单中选择 Configuration Changes。单击 Enable Configuration Changes，并提供最大历史记录值。

然后，此页面上的表列出进行的每个配置更改，包括日期、来源、结果和操作详情。

JBoss EAP 允许您使用表达式来定义可在配置中替换字面值的可替换属性。表达式使用 ${PARAMETER: DEFAULT_VALUE} 格式。如果设置了指定参数，则将使用参数的值。否则，将使用提供的默认值。

解析表达式支持的源包括系统属性、环境变量和密码库。对于部署，源可以是部署存档中的 META-INF/jboss.properties 文件中的属性。对于支持子部署的部署类型，如果属性文件位于外部部署中，则解析范围仅限于所有子部署，如 EAR。如果属性文件在子部署中，则解析的范围仅限于该子部署。

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

<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

嵌套表达式

表达式可以嵌套，允许更高级地使用表达式来代替固定值。嵌套表达式的格式类似于普通表达式的格式，但一个表达式被嵌入在另一个表达式中，例如：

${SYSTEM_VALUE_1${SYSTEM_VALUE_2}}

嵌套表达式是递归评估的，因此首先评估内嵌表达式 ，然后评估外部表达式。表达式也可能是递归的，其中表达式解析为其他表达式，然后解析。允许表达式的任何位置都允许嵌套表达式，但管理 CLI 命令除外。

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

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

ds_ExampleDS 的值可以替换为使用嵌套表达式的系统属性(datasource_name)。数据源的配置可以改为有以下行：

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

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

基于描述符的特征替换

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

基于描述符的属性替换基于描述符的属性，允许您从应用和构建链中删除对环境相关的假设。特定环境的配置可以在部署描述符中指定，而不是注释或构建系统脚本。您可以在文件中提供配置，或者作为参数在命令行中提供。

ee 子系统中有几个标记控制是否应用属性替换。

JBoss 特定的描述符替换由 jboss-descriptor-property-replacement 标志控制，默认情况下是 启用 的。启用后，可以在以下部署描述符中替换属性：

以下管理 CLI 命令可用于启用或禁用特定于 JBoss 的描述符中的属性替换：

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

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

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

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

自 JBoss EAP 7.3 起，您可以使用 Git 来管理和持久保留您的服务器配置数据、属性文件和部署。这不仅允许您管理这些文件的版本历史记录，还允许您使用一个或多个 Git 存储库在多个服务器和节点间共享服务器和应用配置。此功能仅适用于使用默认配置目录布局的单机服务器。

您可以选择在本地 Git 存储库中使用配置数据 ，也可以从远程 Git 存储库中提取数据。Git 存储库在 jboss.server.base.dir 目录中配置，这是单机服务器内容的基础目录。在 jboss.server.base.dir 目录配置为使用 Git 后，JBoss EAP 将自动通过管理 CLI 或管理控制台提交每次更新到配置的更新。通过手动编辑配置文件在服务器外进行的任何更改都不会提交或保留，但您可以使用 Git CLI 添加和提交手动更改。您还可以使用 Git CLI 查看提交历史记录，管理分支和管理内容。

要使用此功能，在您启动服务器时在命令行中传递一个或多个参数。

使用本地 Git 存储库

要使用本地 Git 存储库，请使用 --git-repo=local 参数启动服务器。您还可以在启动服务器时添加 --git-branch=GIT_BRANCH_NAME 参数，在远程存储库中指定可选分支或标签名称。此参数应命名现有的分支或标签名称，因为如果不存在，则不会 创建该分支或标签名称。如果使用标签名称，请将存储库置于分离的 HEAD 状态，这意味着以后的提交不会附加到任何分支。

以下是使用 本地存储库 的 1.0.x 分支启动服务器的命令示例：

$ EAP_HOME/bin/standalone.sh --git-repo=local --git-branch=1.0.x

如果您使用 参数启动服务器以使用 本地 Git 存储库，JBoss EAP 将检查 jboss.server.base.dir 目录是否已针对 Git 进行了配置。否则，JBoss EAP 会利用现有配置内容在 jboss.server.base.dir 目录中创建并初始化 Git 存储库。JBoss EAP 检查由 --git-branch 参数传递的分支名称。如果未传递该参数，它将检查 master 分支。初始化后，您应该会看到单机服务器内容的基础目录中的 a .git/ 目录和 a.gitignore 文件。

使用远程 Git 存储库

要使用远程 Git 存储库，请使用 --git-repo=REMOTE_REPO 参数启动服务器。参数的值可以是您手动添加到本地 Git 配置的 URL 或远程别名。

您还可以在启动服务器时添加 --git-branch=GIT_BRANCH_NAME 参数，在远程存储库中指定可选分支或标签名称。此参数应命名现有的分支或标签名称，因为如果不存在，则不会创建该分支或标签名称。如果使用标签名称，请将存储库置于分离的 HEAD 状态，这意味着以后的提交不会附加到任何分支。

如果您的 Git 存储库需要身份验证，那么在启动服务器时，还必须添加 --git-auth=AUTH_FILE_URL 参数。此参数应当是 Elytron 配置文件的 URL，其中包含连接 Git 存储库所需的凭据。以下是可用于身份验证的 Elytron 配置文件的示例：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <authentication-client xmlns="urn:elytron:client:1.2">
    <authentication-rules>
      <rule use-configuration="test-login">
      </rule>
    </authentication-rules>
    <authentication-configurations>
      <configuration name="test-login">
        <sasl-mechanism-selector selector="BASIC" />
        <set-user-name name="eap-user" />
        <credentials>
          <clear-password password="my_api_key" />
        </credentials>
        <set-mechanism-realm name="testRealm" />
      </configuration>
    </authentication-configurations>
  </authentication-client>
</configuration>

以下是使用 full 配置文件启动服务器的命令示例，它使用远程 eap-configuration 存储库的 1.0.x 分支，并将 URL 传递到包含身份验证凭据的 Elytron 配置文件。

$ EAP_HOME/bin/standalone.sh --git-repo=https://github.com/MY_GIT_ID/eap-configuration.git --git-branch=1.0.x --git-auth=file:///home/USER_NAME/github-wildfly-config.xml --server-config=standalone-full.xml

如果您使用 参数启动服务器以使用远程 Git 存储库，JBoss EAP 会检查 jboss.server.base.dir 目录是否已针对 Git 进行了配置。否则，JBoss EAP 将删除 jboss.server.base.dir 目录中的现有配置文件，并将它们替换为远程 Git 配置数据。JBoss EAP 检查由 --git-branch 参数传递的分支名称。如果未传递该参数，它将检查 master 分支。这个过程完成后，您应该会在单机服务器内容的基础目录中看到 a .git/ 目录和 a.gitignore 文件。

使用 Git 时发布远程配置数据

您可以使用管理 CLI 发布配置 操作将您的 Git 存储库更改推送到远程存储库。由于当您启动服务器时，JBoss EAP 会在启动过程中从远程 Git 存储库提取配置，这允许您在多个服务器之间共享配置数据。您只能将此操作用于远程存储库。它不适用于本地存储库。

以下管理 CLI 操作将配置数据发布到远程 eap-configuration 存储库：

:publish-configuration(location="=https://github.com/MY_GIT_ID/eap-configuration.git")
{"outcome" => "success"}

通过 Git 使用快照

除了使用 Git 提交历史记录来跟踪配置更改外，您还可以生成快照以在特定时间点保留配置。您可以列出快照并删除快照。

使用 Git 时生成快照

快照作为标签存储在 Git 中。您可以在 take-snapshot 操作上将快照标签名称和提交消息指定为参数。

以下管理 CLI 操作将拍摄快照，并将其命名为"snapshot-01"标签。

:take-snapshot(name="snapshot-01", comment="1st snapshot")
{
    "outcome" => "success",
    "result" => "1st snapshot"
}

使用 Git 列出快照

您可以使用 list-snapshots 操作列出所有快照标签。

以下管理 CLI 操作列出了快照标签：

:list-snapshots
{
    "outcome" => "success",
    "result" => {
        "directory" => "",
        "names" => [
            "snapshot : 1st snapshot",
            "refs/tags/snapshot-01",
            "snapshot2 : 2nd snapshot",
            "refs/tags/snapshot-02"
        ]
    }
}

使用 Git 删除快照

您可以通过在 delete-snapshot 操作上传递标签名称来删除特定的快照。

以下管理 CLI 操作将使用标签名称 "snapshot-01" 删除快照。

:delete-snapshot(name="snapshot-01")
{"outcome" => "success"}

使用以下命令列出文件系统路径：

ls /path

ls /host=HOST_NAME/server=SERVER_NAME/path

使用以下命令来读取文件系统路径的值：

/path=PATH_NAME:read-resource

/host=HOST_NAME/server=SERVER_NAME/path=PATH_NAME:read-resource

您可以覆盖以 jboss. server.* 或 jboss. domain.* 开头的标准路径的默认位置。这可以通过以下两种方式之一完成：

覆盖受管域的标准路径

在本示例中，目标是将域文件存储在 /opt/jboss_eap/domain_data 目录中，并为每个顶级目录指定一个自定义名称。使用默认目录分组 by-server。

为了实现此配置，启动 JBoss EAP 时将覆盖多个系统属性。

$ EAP_HOME/bin/domain.sh -Djboss.domain.temp.dir=/opt/jboss_eap/domain_data/all_temp -Djboss.domain.log.dir=/opt/jboss_eap/domain_data/all_logs -Djboss.domain.data.dir=/opt/jboss_eap/domain_data/all_data -Djboss.domain.servers.dir=/opt/jboss_eap/domain_data/all_servers

生成的路径结构如下：

/opt/jboss_eap/domain_data/
               ├── all_data
               ├── all_logs
               ├── all_servers
               │   ├── server-one
               │   │   ├── data
               │   │   ├── log
               │   │   └── tmp
               │   └── server-two
               │       ├── data
               │       ├── log
               │       └── tmp
               └── all_temp

您可以使用管理 CLI 或管理控制台添加自定义文件系统路径。

然后您可以在配置中使用这个自定义路径。例如，以下日志处理程序将自定义路径用于其相对路径：

<subsystem xmlns="urn:jboss:domain:logging:6.0">
  ...
  <periodic-rotating-file-handler name="FILE" autoflush="true">
    <formatter>
      <named-formatter name="PATTERN"/>
    </formatter>
    <file relative-to="my.custom.path" path="server.log"/>
    <suffix value=".yyyy-MM-dd"/>
    <append value="true"/>
  </periodic-rotating-file-handler>
  ...
</subsystem>

JBoss EAP 预配置了审计日志记录的文件处理程序，但审计日志记录默认为禁用。启用审计日志记录的管理 CLI 命令取决于您是以单机服务器还是在受管域中运行。如需文件处理程序属性，请参阅管理审计日志记录属性。

以下说明启用 NATIVE 和 HTTP 审计日志记录。要配置 JMX 审计日志，请参阅 启用 JMX 管理审计日志。

要设置 syslog 审计日志记录，请参阅发送管理审计日志记录到 Syslog 服务器。

启用单机服务器审计日志记录

可以使用以下命令启用审计日志记录：

/core-service=management/access=audit/logger=audit-log:write-attribute(name=enabled,value=true)

默认情况下，这会将审计日志写入 EAP_HOME/standalone/data/audit-log.log。

启用受管域审计日志记录

受管域的默认审计日志记录配置已预先配置为为每个主机和每一服务器写入审计日志。

可以使用以下命令，为每个主机启用审计日志记录：

/host=HOST_NAME/core-service=management/access=audit/logger=audit-log:write-attribute(name=enabled,value=true)

默认情况下，这会将审计日志写入 EAP_HOME/domain/data/audit-log.log。

可以使用以下命令，为每个服务器启用审计日志记录：

/host=HOST_NAME/core-service=management/access=audit/server-logger=audit-log:write-attribute(name=enabled,value=true)

默认情况下，这会将审计日志写入 EAP_HOME/domain/servers/SERVER_NAME/data/audit-log.log。

JBoss EAP 预配置了 JMX 审计日志的文件处理程序，尽管默认情况下这些日志是禁用的。启用审计日志记录的管理 CLI 命令取决于您是作为单机服务器还是受管域来运行。

要配置 NATIVE 或 HTTP 审计日志记录，请参阅 启用管理审计日志记录。

启用单机服务器 JMX 审计日志记录

可以使用以下命令为单机服务器启用 JMX 审计日志记录：

/subsystem=jmx/configuration=audit-log:add()
/subsystem=jmx/configuration=audit-log/handler=file:add()

这将启用 JMX 审计日志记录，然后使用定义 的文件 处理程序将这些日志写入 EAP_HOME/standalone/data/audit-log.log。

启用受管域 JMX 审计日志记录

可以为受管域中的每个主机和配置文件启用 JMX 审计日志记录。

syslog 处理程序指定审计日志条目发送到 syslog 服务器的参数，特别是 syslog 服务器的主机名和 syslog 服务器侦听的端口。将审计日志记录发送到 syslog 服务器比记录到本地文件或本地 syslog 服务器更安全的选项。可以定义多个 syslog 处理程序并同时处于活动状态。

默认情况下，审计日志在启用时预先配置为输出到文件。使用以下步骤将审计日志记录设置并启用到 syslog 服务器。如需 syslog 处理程序属性，请参阅管理审计日志记录属性。

输出到文件的审计日志条目最好使用文本查看器查看，而 syslog 服务器的输出则最好使用 syslog viewer 应用程序查看。

审计日志条目以 JSON 格式存储。每个日志条目都以可选时间戳开头，后跟下表中的字段。

您可以将侦听器注册到 JBoss EAP 核心管理 子系统，以监控服务器生命周期事件。下列步骤演示了如何创建和注册将事件记录到文件中的示例侦听器。

现在，服务器生命周期事件会根据上面的 SimpleList ener 类记录到 my-listener -output.txt 文件中。例如，在管理 CLI 中发出 :suspend 命令会将以下内容输出到 my-listener-output.txt 文件：

Running state change for STANDALONE_SERVER: normal to suspending
Running state change for STANDALONE_SERVER: suspending to suspended

这表明运行状态已从 正常 更改为 暂停，然后从 暂停 变为 暂停。

您可以注册 JMX 通知监听程序来监控服务器生命周期事件。以下步骤演示了如何创建和添加将事件记录到文件中的示例侦听器。

服务器生命周期事件现在根据上面的 StateNotificationListener 类记录到文件中。例如，在管理 CLI 中发出 :suspend 命令会将以下内容输出到 running-notifications.txt 文件：

jmx.attribute.change 5 jboss.root:type=state The attribute 'RunningState' has changed from 'normal' to 'suspending'
jmx.attribute.change 6 jboss.root:type=state The attribute 'RunningState' has changed from 'suspending' to 'suspended'

这表明运行状态已从 正常 更改为 暂停，然后从 暂停 变为 暂停。

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

默认情况下，JBoss EAP 将这些接口绑定到 127.0.0.1，但可以通过设置适当的 属性在运行时覆盖这些值。例如，通过以下命令将 JBoss EAP 启动为单机服务器时可以设置 公共 接口的 inet-address ：

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

或者，您也可以在 server start 命令行上使用 -b 参数。有关服务器启动选项的更多信息，请参阅服务器运行时参数。

通过为物理接口指定逻辑名称和选择条件来声明网络接口。选择条件可以引用通配符地址，或者指定接口或地址必须具有的一个或多个特征集，才能成为有效的匹配项。有关所有可用接口选择条件的列表，请参阅 Interface Attributes 部分。

接口可以使用管理控制台或管理 CLI 进行配置。以下是添加和更新接口的几个示例。首先显示管理 CLI 命令，后跟对应的配置 XML。

使用 NIC 值添加接口

添加一个 NIC 值为 eth0 的新接口。

/interface=external:add(nic=eth0)

<interface name="external">
   <nic name="eth0"/>
</interface>

使用 Several Conditional 值添加接口

添加一个与正确子网上任何接口/地址匹配的新接口（如果已启动，支持多播），且不是点对点的新接口。

/interface=default:add(subnet-match=192.168.0.0/16,up=true,multicast=true,not={point-to-point=true})

<interface name="default">
   <subnet-match value="192.168.0.0/16"/>
   <up/>
   <multicast/>
   <not>
      <point-to-point/>
   </not>
</interface>

更新接口属性

更新 公共 接口的默认 inet-address 值，保留 jboss.bind.address 属性，以允许在运行时设置此值。

/interface=public:write-attribute(name=inet-address,value="${jboss.bind.address:192.168.0.0}")

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

向受管域中的服务器添加接口

/host=HOST_NAME/server-config=SERVER_NAME/interface=INTERFACE_NAME:add(inet-address=127.0.0.1)

<servers>
   <server name="SERVER_NAME" group="main-server-group">
      <interfaces>
         <interface name="INTERFACE_NAME">
            <inet-address value="127.0.0.1"/>
         </interface>
      </interfaces>
   </server>
</servers>

JBoss EAP 7 中整合了管理端口。默认情况下，JBoss EAP 7 将端口 9990 用于本地管理（由管理 CLI 使用）和 HTTP 管理（由基于 Web 的管理控制台使用）。用作 JBoss EAP 6 中的原生管理端口的端口 9999 不再使用，但在需要时仍可启用。

如果为管理控制台启用了 HTTPS，则默认使用端口 9993。

JBoss EAP随附一个套接字绑定组，适用于这五个预定义配置文件（默认为 ha、full、full-ha 、负载均衡）。

有关默认套接字绑定的详细信息，如默认端口和描述，请参阅 Default Socket Bindings 部分。

独立服务器

作为单机服务器运行时，每个配置文件仅定义一个套接字绑定组。每个独立配置文件（standalone.xml、standalone-ha.xml、standalone-full.xml、standalone-full-ha.xml、standalone-load-balancer.xml）定义其对应配置集所使用的技术的套接字绑定。

例如，默认的单机配置文件(standalone.xml)指定以下套接字绑定：

<socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:0}">
    <socket-binding name="management-http" interface="management" port="${jboss.management.http.port:9990}"/>
    <socket-binding name="management-https" interface="management" port="${jboss.management.https.port:9993}"/>
    <socket-binding name="ajp" port="${jboss.ajp.port:8009}"/>
    <socket-binding name="http" port="${jboss.http.port:8080}"/>
    <socket-binding name="https" port="${jboss.https.port:8443}"/>
    <socket-binding name="txn-recovery-environment" port="4712"/>
    <socket-binding name="txn-status-manager" port="4713"/>
    <outbound-socket-binding name="mail-smtp">
        <remote-destination host="localhost" port="25"/>
    </outbound-socket-binding>
</socket-binding-group>

受管域

在受管域中运行时，所有套接字绑定组都在 domain.xml 文件中定义。有五个预定义的套接字绑定组：

每个套接字绑定组都指定其对应配置集所使用的技术套接字绑定。例如，full-ha-sockets 套接字绑定组定义几个 jgroups 套接字绑定，供 full-ha 配置文件用于高可用性。

<socket-binding-groups>
  <socket-binding-group name="standard-sockets" default-interface="public">
    <!-- Needed for server groups using the 'default' profile  -->
    <socket-binding name="ajp" port="${jboss.ajp.port:8009}"/>
    <socket-binding name="http" port="${jboss.http.port:8080}"/>
    <socket-binding name="https" port="${jboss.https.port:8443}"/>
    <socket-binding name="txn-recovery-environment" port="4712"/>
    <socket-binding name="txn-status-manager" port="4713"/>
    <outbound-socket-binding name="mail-smtp">
      <remote-destination host="localhost" port="25"/>
    </outbound-socket-binding>
  </socket-binding-group>
  <socket-binding-group name="ha-sockets" default-interface="public">
    <!-- Needed for server groups using the 'ha' profile  -->
    ...
  </socket-binding-group>
  <socket-binding-group name="full-sockets" default-interface="public">
    <!-- Needed for server groups using the 'full' profile  -->
    ...
  </socket-binding-group>
  <socket-binding-group name="full-ha-sockets" default-interface="public">
    <!-- Needed for server groups using the 'full-ha' profile  -->
    <socket-binding name="ajp" port="${jboss.ajp.port:8009}"/>
    <socket-binding name="http" port="${jboss.http.port:8080}"/>
    <socket-binding name="https" port="${jboss.https.port:8443}"/>
    <socket-binding name="iiop" interface="unsecure" port="3528"/>
    <socket-binding name="iiop-ssl" interface="unsecure" port="3529"/>
    <socket-binding name="jgroups-mping" interface="private" port="0" multicast-address="${jboss.default.multicast.address:230.0.0.4}" multicast-port="45700"/>
    <socket-binding name="jgroups-tcp" interface="private" port="7600"/>
    <socket-binding name="jgroups-udp" interface="private" port="55200" multicast-address="${jboss.default.multicast.address:230.0.0.4}" multicast-port="45688"/>
    <socket-binding name="modcluster" port="0" multicast-address="224.0.1.105" multicast-port="23364"/>
    <socket-binding name="txn-recovery-environment" port="4712"/>
    <socket-binding name="txn-status-manager" port="4713"/>
    <outbound-socket-binding name="mail-smtp">
      <remote-destination host="localhost" port="25"/>
    </outbound-socket-binding>
  </socket-binding-group>
  <socket-binding-group name="load-balancer-sockets" default-interface="public">
    <!-- Needed for server groups using the 'load-balancer' profile  -->
    ...
  </socket-binding-group>
</socket-binding-groups>

在定义套接字绑定时，您可以配置 端口 和 接口 属性，以及多播设置，如 多播地址和多 播端口。有关所有可用套接字绑定属性的详情，请查看 Socket Binding Attributes 部分。

可以使用管理控制台或管理 CLI 配置套接字绑定。下列步骤介绍了添加套接字绑定组、添加套接字绑定和使用管理 CLI 配置套接字绑定设置。

以下示例显示了在上述步骤完成后 XML 配置可以如何进行。

<socket-binding-groups>
    ...
    <socket-binding-group name="new-sockets" default-interface="public">
        <socket-binding name="new-socket-binding" interface="unsecure" port="1234"/>
    </socket-binding-group>
</socket-binding-groups>

您可以从管理控制台查看服务器的套接字绑定名称和开放端口。当服务器处于以下状态时，可看到该信息：

查看服务器的套接字绑定和开放端口：

端口偏移是一个数字偏移值，添加到该服务器的套接字绑定组中指定的所有端口值中。这使得服务器能够继承其套接字绑定组中定义的端口值，并提供偏移以确保它不与同一主机上的任何其他服务器冲突。例如，如果套接字绑定组的 HTTP 端口为 8080，并且服务器使用端口偏移 100，则其 HTTP 端口为 8180。

以下是使用管理 CLI 为 受管域中的服务器设置端口偏移 250 的示例。

/host=master/server-config=server-two/:write-attribute(name=socket-binding-port-offset,value=250)

端口偏移可用于受管域中的服务器和在同一主机上运行多个单机服务器。

使用 jboss.socket.binding.port-offset 属性启动单机服务器时，您可以传递端口偏移。

$ EAP_HOME/bin/standalone.sh -Djboss.socket.binding.port-offset=100

部署应用程序

在管理 CLI 中，使用 部署 deploy-file 命令并指定应用部署的路径。

deployment deploy-file /path/to/test-application.war

成功部署不会向管理 CLI 生成任何输出，但服务器日志会显示部署消息。

WFLYSRV0027: Starting deployment of "test-application.war" (runtime-name: "test-application.war")
WFLYUT0021: Registered web context: /test-application
WFLYSRV0010: Deployed "test-application.war" (runtime-name : "test-application.war")

同样，您可以使用以下 部署 命令：

您还可以使用 deployment enable 命令启用 禁用 的应用。

取消部署应用

在管理 CLI 中，使用 部署 undeploy 命令并指定部署名称。这将从存储库删除部署内容。如需在取消部署时保留部署内容，请参阅禁用应用程序。

deployment undeploy test-application.war

成功卸载不会向管理 CLI 生成任何输出，但服务器日志会显示未部署消息。

WFLYUT0022: Unregistered web context: /test-application
WFLYSRV0028: Stopped deployment test-application.war (runtime-name: test-application.war) in 62ms
WFLYSRV0009: Undeployed "test-application.war" (runtime-name: "test-application.war")

类似地，您可以使用 部署 undeploy-cli-archive 从 a .cli 存档文件中取消部署内容。您还可以使用通配符(*)取消部署所有部署。

deployment undeploy *

禁用应用程序

禁用部署的应用，但不从存储库中删除部署内容。

deployment disable test-application.war

您可以使用 deployment disable-all 命令禁用所有部署。

deployment disable-all

启用应用程序

启用禁用的部署应用。

deployment enable test-application.war

您可以使用 deployment enable-all 命令启用所有部署。

deployment enable-all

列出部署

在管理 CLI 中，使用 deployment info 命令列出部署信息。

deployment info

输出中将显示每个部署的详细信息，如运行时名称、状态以及是否启用。

NAME                 RUNTIME-NAME         PERSISTENT ENABLED STATUS
helloworld.war       helloworld.war       true       true    OK
test-application.war test-application.war true       true    OK

按名称显示部署信息：

deployment info helloworld.war

您还可以使用 deployment list 命令列出所有 部署。

部署应用程序

在管理 CLI 中，使用 部署 deploy-file 命令并指定应用部署的路径。您还必须指定应用应部署到的服务器组。

成功部署不会向管理 CLI 生成任何输出，但服务器日志显示每个受影响的服务器的部署消息。

[Server:server-one] WFLYSRV0027: Starting deployment of "test-application.war" (runtime-name: "test-application.war")
[Server:server-one] WFLYUT0021: Registered web context: /test-application
[Server:server-one] WFLYSRV0010: Deployed "test-application.war" (runtime-name : "test-application.war")

同样，您可以使用以下 部署 命令：

您还可以使用 deployment enable 命令启用 禁用 的应用。

取消部署应用

在管理 CLI 中，使用 部署 undeploy 命令并指定部署名称。您还必须指定应当从中取消部署应用的服务器组。如需从特定服务器组取消部署，请参阅禁用应用程序。

利用该部署，从所有服务器组取消部署应用。

deployment undeploy test-application.war --all-relevant-server-groups

成功卸载不会向管理 CLI 生成任何输出，但服务器日志显示每个受影响的服务器的未部署消息。

[Server:server-one] WFLYUT0022: Unregistered web context: /test-application
[Server:server-one] WFLYSRV0028: Stopped deployment test-application.war (runtime-name: test-application.war) in 74ms
[Server:server-one] WFLYSRV0009: Undeployed "test-application.war" (runtime-name: "test-application.war")

类似地，您可以使用 部署 undeploy-cli-archive 命令从 a .cli 存档文件中取消部署内容。您还可以使用通配符(*)取消部署所有部署。

deployment undeploy * --all-relevant-server-groups

禁用应用程序

从特定的服务器组禁用部署的应用，并将其内容保留在存储库中，以用于使用该部署的其他服务器组。

deployment disable test-application.war --server-groups=other-server-group

您可以使用 deployment disable-all 命令禁用所有部署。

deployment disable-all --server-groups=other-server-group

启用应用程序

启用禁用的部署应用。

deployment enable test-application.war

您可以使用 deployment enable-all 命令启用所有部署。

deployment enable-all --server-groups=other-server-group

列出部署

在管理 CLI 中，使用 deployment info 命令列出部署信息。您可以按照部署名称或服务器组列出部署信息。

按名称显示部署信息：

deployment info helloworld.war

输出中将列出各个服务器组中的部署及其状态。

NAME               RUNTIME-NAME
helloworld.war     helloworld.war

SERVER-GROUP       STATE
main-server-group  enabled
other-server-group added

显示服务器组的部署信息：

deployment info --server-group=other-server-group

输出将列出指定服务器组的部署及其状态。

NAME                 RUNTIME-NAME         STATE
helloworld.war       helloworld.war       added
test-application.war test-application.war enabled

您还可以使用 deployment list 命令列出域中的所有部署 。

可以从 JBoss EAP 管理控制台的 Deployments 选项卡查看和管理部署。

部署应用程序

单击添加(+)按钮。您可以选择通过上传部署、添加非受管部署或 创建空部署 来部署应用。部署默认是启用的。

取消部署应用

选择部署，再选择 Undeploy 选项。JBoss EAP 从内容存储库中移除部署。

禁用应用程序

选择部署并选择 Disable 选项来禁用应用。这会取消部署部署，但不会将它从内容存储库中移除。

替换应用程序

选择部署并选择 Replace 选项。选择部署的新版本，其名称必须与原始版本相同，然后单击 Finish。这会取消部署和删除部署的原始版本，然后部署新版本。

在 JBoss EAP 管理控制台的 Deployments 选项卡中，可以通过以下方法查看和管理部署：

添加应用程序

将应用程序部署到服务器组

从服务器组取消部署应用

也可以选择 Content Repository 中为部署的 Undeploy 按钮，一次性从多个服务器组取消部署部署。

删除应用程序

这会从内容存储库删除部署。

禁用应用程序

这会取消部署部署，但不会将它从内容存储库中移除。

替换应用程序

这会取消部署和删除部署的原始版本，然后部署新版本。

部署扫描器可以配置为允许或禁止自动部署 XML、压缩和展开的内容。如果禁用自动部署，您必须手动创建标志文件来触发部署操作。如需有关可用标志文件类型及其用途的更多信息，请参阅 Deployment Scanner Marker Files 部分。

默认情况下，启用 XML 和压缩的内容的自动部署。有关为每种内容类型配置自动部署的详情，请参阅配置 Deployment Scanner。

部署应用程序

将内容复制到部署文件夹。

$ cp /path/to/test-application.war EAP_HOME/standalone/deployments/

如果启用自动部署，将自动提取此文件，并创建 a .deployed 标记文件。如果未启用自动部署，您将需要手动添加 a .dodeploy 标记文件来触发部署。

$ touch EAP_HOME/standalone/deployments/test-application.war.dodeploy

取消部署应用

通过删除 .deployed 标记文件来触发未部署。

$ rm EAP_HOME/standalone/deployments/test-application.war.deployed

如果启用了自动部署，您也可以删除 test-application.war 文件，该文件将触发取消部署。请注意，这不适用于展开式部署。

重新部署应用

创建 a .dodeploy 标记文件以启动重新部署。

$ touch EAP_HOME/standalone/deployments/test-application.war.dodeploy

部署扫描程序可以使用管理控制台或管理 CLI 进行配置。您可以配置部署扫描器的行为，如扫描间隔、部署文件夹位置和自动部署特定应用文件类型。您还可以完全禁用部署扫描程序。

有关所有可用部署扫描器属性的详情，请参阅 Deployment Scanner Attributes 部分。

使用以下管理 CLI 命令配置默认部署扫描程序：

禁用 Deployment Scanner

/subsystem=deployment-scanner/scanner=default:write-attribute(name=scan-enabled,value=false)

这将禁用 默认的 部署扫描程序。

更改扫描间隔

/subsystem=deployment-scanner/scanner=default:write-attribute(name=scan-interval,value=10000)

这会将扫描间隔时间从 5000 毫秒（五秒）更新为 10000 毫秒（十秒）。

更改 Deployment Folder

/subsystem=deployment-scanner/scanner=default:write-attribute(name=path,value=/path/to/deployments)

这会将部署文件夹的位置从 EAP_HOME/standalone/deployments 的默认位置更改为 /path/to/deployments。

除非指定了 relative-to 属性，否则路径 值 将被视为绝对路径，在这种情况下，它将相对于该路径。

启用自动部署展开的内容

/subsystem=deployment-scanner/scanner=default:write-attribute(name=auto-deploy-exploded,value=true)

这可实现自动部署展开式内容，这在默认情况下是禁用的。

禁用 Zipped 内容的自动部署

/subsystem=deployment-scanner/scanner=default:write-attribute(name=auto-deploy-zipped,value=false)

这会禁用默认启用的 zipped 内容的自动部署。

禁用 XML 内容的自动部署

/subsystem=deployment-scanner/scanner=default:write-attribute(name=auto-deploy-xml,value=false)

这禁用了 XML 内容的自动部署，默认为启用。

可以使用管理 CLI 或从管理控制台的 Configuration 选项卡导航到 Deployment Scanners 子系统来添加新的部署扫描程序。这将定义用于扫描部署的新目录。默认部署扫描器监控 EAP_HOME/standalone/deployments。有关 配置现有部署扫描程序的详情，请参阅配置 Deployment Scanner。

以下管理 CLI 命令添加新的部署扫描器，它将每隔五秒检查 EAP_HOME/standalone/new_deployment_dir 以进行部署：

/subsystem=deployment-scanner/scanner=new-scanner:add(path=new_deployment_dir,relative-to=jboss.server.base.dir,scan-interval=5000)

已定义一个新的部署扫描器，并将监控指定的目录以监控部署。

以下说明演示了如何使用 Maven 部署和取消部署 JBoss EAP helloworld 快速入门。

如需有关 JBoss EAP 快速入门的更多信息，请参阅 JBoss EAP 快速入门指南中的快速入门示例 。

部署应用程序

在 Maven pom.xml 文件中初始化 WildFly Maven 插件。这应在 JBoss EAP faststart pom.xml 文件中配置。

<plugin>
  <groupId>org.wildfly.plugins</groupId>
  <artifactId>wildfly-maven-plugin</artifactId>
  <version>${version.wildfly.maven.plugin}</version>
</plugin>

从 helloworld quickstart 目录，执行以下 Maven 命令：

$ mvn clean install wildfly:deploy

在发出要部署的 Maven 命令后，终端窗口将显示以下输出表示部署成功：

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 2.981 s
[INFO] Finished at: 2015-12-23T15:06:13-05:00
[INFO] Final Memory: 21M/231M
[INFO] ------------------------------------------------------------------------

也可以通过查看活动服务器实例的服务器日志来确认部署。

WFLYSRV0027: Starting deployment of "helloworld.war" (runtime-name: "helloworld.war")
WFLYUT0021: Registered web context: /helloworld
WFLYSRV0010: Deployed "helloworld.war" (runtime-name : "helloworld.war")

取消部署应用

从 helloworld quickstart 目录，执行以下 Maven 命令：

$ mvn wildfly:undeploy

在发出 Maven 命令取消部署后，终端窗口将显示以下输出，指示成功取消部署：

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1.237 s
[INFO] Finished at: 2015-12-23T15:09:10-05:00
[INFO] Final Memory: 10M/183M
[INFO] ------------------------------------------------------------------------

也可以通过查看活动服务器实例的服务器日志来确认取消部署。

WFLYUT0022: Unregistered web context: /helloworld
WFLYSRV0028: Stopped deployment helloworld.war (runtime-name: helloworld.war) in 27ms
WFLYSRV0009: Undeployed "helloworld.war" (runtime-name: "helloworld.war")

以下说明演示了如何使用 Maven 在受管域中部署和取消部署 JBoss EAP helloworld 快速启动。

如需有关 JBoss EAP 快速入门的更多信息，请参阅 JBoss EAP 快速入门指南中的快速入门示例 。

部署应用程序

在受管域中部署应用时，您必须指定应当要将应用部署到的服务器组。这在 Maven pom.xml 文件中配置。

pom.xml 中的以下配置初始化 WildFly Maven 插件，并将 main-server-group 指定为应用应部署到的服务器组。

<plugin>
  <groupId>org.wildfly.plugins</groupId>
  <artifactId>wildfly-maven-plugin</artifactId>
  <version>${version.wildfly.maven.plugin}</version>
  <configuration>
    <domain>
      <server-groups>
        <server-group>main-server-group</server-group>
      </server-groups>
    </domain>
  </configuration>
</plugin>

从 helloworld quickstart 目录，执行以下 Maven 命令：

$ mvn clean install wildfly:deploy

在发出要部署的 Maven 命令后，终端窗口将显示以下输出表示部署成功：

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 4.005 s
[INFO] Finished at: 2016-09-02T14:36:17-04:00
[INFO] Final Memory: 21M/226M
[INFO] ------------------------------------------------------------------------

也可以通过查看活动服务器实例的服务器日志来确认部署。

WFLYSRV0027: Starting deployment of "helloworld.war" (runtime-name: "helloworld.war")
WFLYUT0021: Registered web context: /helloworld
WFLYSRV0010: Deployed "helloworld.war" (runtime-name : "helloworld.war")

取消部署应用

从 helloworld quickstart 目录，执行以下 Maven 命令：

$ mvn wildfly:undeploy

在发出 Maven 命令取消部署后，终端窗口将显示以下输出，指示成功取消部署：

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1.750 s
[INFO] Finished at: 2016-09-02T14:45:10-04:00
[INFO] Final Memory: 10M/184M
[INFO] ------------------------------------------------------------------------

也可以通过查看活动服务器实例的服务器日志来确认取消部署。

WFLYUT0022: Unregistered web context: /helloworld
WFLYSRV0028: Stopped deployment helloworld.war (runtime-name: helloworld.war) in 106ms
WFLYSRV0009: Undeployed "helloworld.war" (runtime-name: "helloworld.war")

默认情况下，HTTP API 可通过 http://HOST: PORT/management 访问，例如 http://localhost:9990/management。

部署应用程序

$ curl --digest -L -D - http://HOST:PORT/management --header "Content-Type: application/json" -u USER:PASSWORD -d '{"operation" : "composite", "address" : [], "steps" : [{"operation" : "add", "address" : {"deployment" : "test-application.war"}, "content" : [{"url" : "file:/path/to/test-application.war"}]},{"operation" : "deploy", "address" : {"deployment" : "test-application.war"}}],"json.pretty":1}'

取消部署应用

$ curl --digest -L -D - http://HOST:PORT/management --header "Content-Type: application/json" -u USER:PASSWORD -d '{"operation" : "composite", "address" : [], "steps" : [{"operation" : "undeploy", "address" : {"deployment" : "test-application.war"}},{"operation" : "remove", "address" : {"deployment" : "test-application.war"}}],"json.pretty":1}'

请参阅本红帽知识库文章，以编程方式生成 JSON 请求。

默认情况下，HTTP API 可通过 http://HOST: PORT/management 访问，例如 http://localhost:9990/management。

部署应用程序

取消部署应用

您可以为 JBoss EAP 定义自定义位置，以存储已部署的内容。

为单机服务器定义自定义目录

默认情况下，单机服务器部署的内容存储在 EAP_HOME/standalone/data/content 目录中。可以通过在启动服务器时传递 -Djboss.server.deploy.dir 参数来更改此位置。

$ EAP_HOME/bin/standalone.sh -Djboss.server.deploy.dir=/path/to/new_deployed_content

在 JBoss EAP 实例中，所选位置应当是唯一的。

为受管域定义自定义目录

默认情况下，受管域部署的内容存储在 EAP_HOME/domain/data/content 目录中。可以通过在启动域时传递 -Djboss.domain.deployment.dir 参数来更改此位置。

$ EAP_HOME/bin/domain.sh -Djboss.domain.deployment.dir=/path/to/new_deployed_content

在 JBoss EAP 实例中，所选位置应当是唯一的。

JBoss EAP 在服务器启动时提供精细的控制部署顺序。可以指定多个 EAR 文件中应用的部署顺序以及重启后顺序的持久性。

您可以使用 jboss-all.xml 部署描述符来声明顶级部署之间的依赖关系。

例如，如果您的 app.ear 依赖于 Framework .ear，则您可以创建一个 app.ear/META-INF/jboss-all.xml 文件，如下所示。

<jboss xmlns="urn:jboss:1.0">
  <jboss-deployment-dependencies xmlns="urn:jboss:deployment-dependencies:1.0">
    <dependency name="framework.ear" />
  </jboss-deployment-dependencies>
</jboss>

这可确保在 app.ear 之前部署 Framework.ear。

部署覆盖可用于将内容覆盖到现有的部署中，而无需物理修改部署存档的内容。它允许您在运行时覆盖部署描述符、库 JAR 文件、类、JSP 页面和其他文件，而无需重新构建存档。

如果您需要为需要不同配置或设置的不同环境调整部署，这将非常有用。例如，当将部署从开发到测试、到暂存再移到生产环境时，您可能需要交换部署描述符，修改静态 Web 资源以更改应用的品牌，或者根据目标环境将 JAR 库替换为不同的版本。对于需要更改配置但因为策略或安全限制而无法修改或破解归档的安装，此功能也非常有用。

在定义部署覆盖时，您将指定将替换部署存档中的 文件的文件系统中的 文件。您还必须指定哪些部署应受到部署覆盖的影响。必须重新部署任何受影响的部署，才能使更改生效。

有关完整使用详情，请执行 deployment-overlay --help。

关于 Rollout 计划

在受管域中，针对域或主机资源的操作可能会影响多个服务器。此类操作可能包括详细介绍操作应用到服务器的顺序的推出计划，以及详细描述是否可以在部分服务器上成功执行该操作的策略。如果没有指定推出计划，则会使用默认的推出部署计划。

以下是涉及五个服务器组的推出计划示例：操作可以按序列、序列 或 并发组应用到服务器组。Rollout Plan Syntax 中对语法进行了更为详细的说明。

{"my-rollout-plan" => {"rollout-plan" => {
    "in-series" => [
        {"concurrent-groups" => {
            "group-A" => {
                "max-failure-percentage" => "20",
                "rolling-to-servers" => "true"
            },
            "group-B" => undefined
        }},
        {"server-group" => {"group-C" => {
            "rolling-to-servers" => "false",
            "max-failed-servers" => "1"
        }}},
        {"concurrent-groups" => {
            "group-D" => {
                "max-failure-percentage" => "20",
                "rolling-to-servers" => "true"
            },
            "group-E" => undefined
        }}
    ],
    "rollback-across-groups" => "true"
}}}

查看上面的示例，将操作应用到域中的服务器时要分三个阶段完成。如果任何服务器组的策略触发在服务器组中回滚该操作，则所有其他服务器组也将回滚。

rollout Plan Syntax

您可以通过以下任一方式指定推出部署计划。

虽然每种方法都有不同的初始命令，但这两种方法都使用 rollout 操作标头来定义推出计划。这使用以下语法：

rollout (id=PLAN_NAME | SERVER_GROUP_LIST) [rollback-across-groups]

使用 Rollout 计划部署

您可以通过将推出(rollout) 设置 传递到 headers 参数，将部署计划的完整详情直接提供给 deploy 命令。有关格式的更多信息，请参阅 Rollout Plan Syntax。

以下管理 CLI 命令利用为串行部署指定 rolling -to-servers=true 的部署计划将应用部署到 main- server-group 服务器组：

deploy /path/to/test-application.war --server-groups=main-server-group --headers={rollout main-server-group(rolling-to-servers=true)}

使用 Stored Rollout 计划部署

由于推出计划可能比较复杂，您可以选择存储推出计划的详细信息。这可让您在您要使用部署计划名称时引用推出计划的名称，而不必每次都需要部署计划的完整详情。

删除 Stored Rollout Plan

您可以通过指定要删除的 rollout-plan 管理 CLI 命令，移除存储的推出部署计划。

rollout-plan remove --name=my-rollout-plan

默认 Rollout Plan

所有影响多个服务器的操作都将通过推出计划来执行。如果没有在操作请求中指定推出部署计划，则会生成默认的推出部署计划。计划将具有以下特征：

使用 browse-content 操作来查看受管部署中的文件和目录。不提供任何参数来返回整个部署结构，或使用 path 参数提供特定目录的路径。

/deployment=helloworld.war:browse-content(path=META-INF/)

这将显示 helloworld.war 部署的 META-INF/ 目录中的文件和目录。

{
    "outcome" => "success",
    "result" => [
        {
            "path" => "MANIFEST.MF",
            "directory" => false,
            "file-size" => 827L
        },
        {
            "path" => "maven/org.jboss.eap.quickstarts/helloworld/pom.properties",
            "directory" => false,
            "file-size" => 106L
        },
        {
            "path" => "maven/org.jboss.eap.quickstarts/helloworld/pom.xml",
            "directory" => false,
            "file-size" => 2713L
        },
        {
            "path" => "maven/org.jboss.eap.quickstarts/helloworld/",
            "directory" => true
        },
        {
            "path" => "maven/org.jboss.eap.quickstarts/",
            "directory" => true
        },
        {
            "path" => "maven/",
            "directory" => true
        },
        {
            "path" => "INDEX.LIST",
            "directory" => false,
            "file-size" => 251L
        }
    ]
}

您还可以为 browse-content 操作指定以下参数：

您可以使用 read-content 操作读取受管部署中文件的内容。不提供任何参数来返回整个部署，或使用 path 参数提供特定文件的路径。例如：

/deployment=helloworld.war:read-content(path=META-INF/MANIFEST.MF)

这会返回一个文件流，它可显示在管理 CLI 中或保存到文件系统中。

{
    "outcome" => "success",
    "result" => {"uuid" => "24ba8e06-21bd-4505-b4d4-bdfb16451b95"},
    "response-headers" => {"attached-streams" => [{
        "uuid" => "24ba8e06-21bd-4505-b4d4-bdfb16451b95",
        "mime-type" => "text/plain"
    }]}
}

attachment display --operation=/deployment=helloworld.war:read-content(path=META-INF/MANIFEST.MF)

ATTACHMENT 8af87836-2abd-423a-8e44-e731cc57bd80:
Manifest-Version: 1.0
Implementation-Title: Quickstart: helloworld
Implementation-Version: 7.3.0.GA
Java-Version: 1.8.0_131
Built-By: username
Scm-Connection: scm:git:git@github.com:jboss/jboss-parent-pom.git/quic
 kstart-parent/helloworld
Specification-Vendor: JBoss by Red Hat
...

attachment save --operation=/deployment=helloworld.war:read-content(path=META-INF/MANIFEST.MF) --file=/path/to/MANIFEST.MF

域控制器是 JBoss EAP 服务器实例，充当域的中央管理点。个主机控制器实例配置为充当域控制器。

域控制器的主要职责是：

默认情况下，中央管理策略存储在 EAP_HOME/domain/configuration/domain.xml 文件中。主机控制器的此目录中需要此文件，此目录设置为作为域控制器运行。

domain.xml 文件包含可供域中服务器使用的配置集配置。配置文件包含该配置文件中提供的各种子系统的详细设置。域配置还包括套接字组的定义和服务器组定义。

如需更多信息，请参阅启动受管域和 域控制器配置部分。

主机控制器的主要职责是服务器管理。它委派域管理任务，并负责启动和停止在其主机上运行的单个应用服务器进程。

它与域控制器交互，以帮助管理服务器和域控制器之间的通信。个域的多个主机控制器只能与一个域控制器交互。因此，在单一域模式中运行的所有主机控制器和服务器实例都有一个域控制器，必须属于同一域。

默认情况下，每一主机控制器从其主机文件系统上解压缩的 JBoss EAP 安装文件中的 EAP_HOME/domain/configuration/host.xml 文件中读取其配置。host.xml 文件包含以下特定于特定主机的配置信息：

如需更多信息，请参阅 Start a Managed Domain 和 Host Controller Configuration 部分。

进程控制器是一个轻量级小进程，负责生成主机控制器进程并监控其生命周期。如果主机控制器崩溃，进程控制器将重启它。它还会按照主机控制器的指示启动服务器进程；但是，它不会自动重新启动崩溃的服务器进程。

进程控制器将日志记录到 EAP_HOME/domain/log/process-controller.log 文件。您可以使用 PROCESS_ CONTROLLER_JAVA _OPTS 变量，在 EAP_HOME /bin/domain.conf 文件中为进程控制器设置 JVM 选项。

服务器组是服务器实例的集合，可以作为一个服务器实例进行管理和配置。在受管域中，每个应用服务器实例属于服务器组，即使它是唯一的成员。个组中的服务器实例共享相同的配置文件配置和部署的内容。

域控制器和主机控制器在其域中每一服务器组的所有服务器实例上强制执行标准配置。

个域可以包含多个服务器组。不同的服务器组可以配置不同的配置文件和部署。例如，一个域可以配置不同的服务器层，提供不同的服务。

不同的服务器组也可以具有相同的配置文件和部署。例如，这可以实现滚动应用升级，从而在一个服务器组中升级应用，然后在第二个服务器组中更新，从而避免彻底的服务中断。

如需更多信息，请参阅 配置服务器组部分。

服务器代表应用服务器实例。在受管域中，所有服务器实例都是服务器组的成员。主机控制器在其自己的 JVM 进程中启动每个服务器实例。

如需更多信息，请参阅 配置服务器部分。

可以使用 JBoss EAP 提供的 domain .sh 或 domain. bat 脚本启动域控制器和主机控制器。有关所有可用启动脚本参数及其目的的完整列表，请使用 --help 参数或查看 服务器运行时参数 部分。

域控制器必须在域中任何服务器组的任何从属服务器之前启动。首先启动域控制器，然后在域中启动任何其他关联的主机控制器。

启动域控制器

使用 host-master.xml 配置文件启动域控制器，它已针对专用域控制器进行了预配置。

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

根据域设置，您需要进行额外的配置，以允许主机控制器进行连接。另请参阅以下域设置示例：

启动主机控制器

使用 host-slave.xml 配置文件启动主机控制器，它已为从属主机控制器进行了预配置。

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

根据域设置，您将需要连接额外的配置，而不与域控制器冲突。另请参阅以下域设置示例：

您必须将域中的一个主机配置为域控制器。

通过在 < domain-controller > 声明中添加 <local/ > 元素，将主机配置为域控制器。<domain-controller> 应该不包含任何其他内容。

<domain-controller>
  <local/>
</domain-controller>

充当域控制器的主机必须公开一个可供域中其他主机访问的管理接口。HTTP 接口是标准的管理接口。

<management-interfaces>
  <http-interface security-realm="ManagementRealm" http-upgrade-enabled="true">
    <socket interface="management" port="${jboss.management.http.port:9990}"/>
  </http-interface>
</management-interfaces>

示例最小域控制器配置文件 EAP_HOME/domain/configuration/host-master.xml 包含这些配置设置。

主机控制器必须配置为连接到域控制器，以便主机控制器能够将自身注册到域。

使用配置的 <domain-controller> 元素 来配置与域控制器的连接。

<domain-controller>
  <remote security-realm="ManagementRealm">
    <discovery-options>
      <static-discovery name="primary" protocol="${jboss.domain.master.protocol:remote}" host="${jboss.domain.master.address}" port="${jboss.domain.master.port:9990}"/>
    </discovery-options>
  </remote>
</domain-controller>

示例最小主机控制器配置文件 EAP_HOME/domain/configuration/host-slave.xml 包含用于连接域控制器的配置设置。该配置假定您在启动主机控制器 时提供 jboss.domain.master.address 属性。

$ EAP_HOME/bin/domain.sh --host-config=host-slave.xml -Djboss.domain.master.address=IP_ADDRESS

有关域控制器发现的更多信息，请参阅域控制器发现和故障转移部分。

根据您的域设置，您可能还需要为主机控制器提供身份验证，以通过域控制器进行身份验证。如需了解有关生成具有 secret 值的管理用户以及使用该值更新主机控制器配置的详细信息，请参阅在两个机器中设置受管域。

受管域中运行的每个主机必须具有唯一的主机名。为简化管理并允许在多个主机上使用相同的主机配置文件，服务器在确定主机名时要使用以下优先级：

主机控制器的名称在相关 host .xml 配置文件顶部的主机元素中配置，例如：

<host xmlns="urn:jboss:domain:8.0" name="host1">

使用以下步骤，通过管理 CLI 更新主机名。

如果主机控制器配置文件中没有设置名称，您也可以在运行时传递主机名。

$ EAP_HOME/bin/domain.sh --host-config=host-slave.xml  -Djboss.host.name=HOST_NAME

以下是服务器组定义的示例：

<server-group name="main-server-group" profile="full">
  <jvm name="default">
    <heap size="64m" max-size="512m"/>
  </jvm>
  <socket-binding-group ref="full-sockets"/>
  <deployments>
    <deployment name="test-application.war" runtime-name="test-application.war"/>
    <deployment name="helloworld.war" runtime-name="helloworld.war" enabled="false"/>
  </deployments>
</server-group>

可以使用管理 CLI 或管理控制台 Runtime 选项卡来配置服务器组。

添加服务器组

以下管理 CLI 命令可用于添加服务器组：

/server-group=SERVER_GROUP_NAME:add(profile=PROFILE_NAME,socket-binding-group=SOCKET_BINDING_GROUP_NAME)

更新服务器组

以下管理 CLI 命令可用于更新服务器组属性：

/server-group=SERVER_GROUP_NAME:write-attribute(name=ATTRIBUTE_NAME,value=VALUE)

删除服务器组

以下管理 CLI 命令可用于移除服务器组：

/server-group=SERVER_GROUP_NAME:remove

服务器组属性

服务器组需要以下属性：

服务器组包括以下可选属性：

默认 host.xml 配置文件定义三个服务器：

<servers>
  <server name="server-one" group="main-server-group">
  </server>
  <server name="server-two" group="main-server-group" auto-start="true">
    <socket-bindings port-offset="150"/>
  </server>
  <server name="server-three" group="other-server-group" auto-start="false">
    <socket-bindings port-offset="250"/>
  </server>
</servers>

名为 server-one 的服务器实例与 main-server-group 关联，并且继承该服务器组指定的子系统配置和套接字绑定。名为 server-two 的服务器实例也与 main-server-group 关联，但也定义了套接字绑定 port-offset 值，因此不会与 server-one 使用的端口值冲突。名为 server-three 的服务器实例与 other-server-group 关联并使用该组的配置。它还定义 port-offset 值，并将 auto-start 设置为 false，以便此服务器在主机控制器启动时不启动。

可以使用管理 CLI 或管理控制台运行时选项卡来配置服务器。

添加服务器

以下管理 CLI 命令可用于添加服务器：

/host=HOST_NAME/server-config=SERVER_NAME:add(group=SERVER_GROUP_NAME)

更新服务器

以下管理 CLI 命令可用于更新服务器属性：

/host=HOST_NAME/server-config=SERVER_NAME:write-attribute(name=ATTRIBUTE_NAME,value=VALUE)

删除服务器

以下管理 CLI 命令可用于移除服务器：

/host=HOST_NAME/server-config=SERVER_NAME:remove

服务器属性

服务器需要以下属性：

服务器包括以下可选属性：

您可以通过导航到 Runtime 选项卡并选择适当的主机或服务器组，从管理控制台对服务器执行各种操作，如启动、停止和重新加载。

以下命令可以使用管理 CLI 执行这些操作。

启动服务器

您可以在特定主机上启动单个服务器。

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

您可以启动指定服务器组中的所有服务器。

/server-group=SERVER_GROUP_NAME:start-servers

停止服务器

您可以在特定主机上停止单个服务器。

/host=HOST_NAME/server-config=SERVER_NAME:stop

您可以停止指定服务器组中的所有服务器。

/server-group=SERVER_GROUP_NAME:stop-servers

重新载入服务器

您可以在特定主机上重新加载单一服务器。

/host=HOST_NAME/server-config=SERVER_NAME:reload

您可以重新加载指定服务器组中的所有服务器。

/server-group=SERVER_GROUP_NAME:reload-servers

终止服务器

您可以中断指定服务器组中的所有服务器进程。

/server-group=SERVER_GROUP_NAME:kill-servers

下例中演示了如何使用查找域控制器的多个选项配置主机控制器：

<domain-controller>
  <remote security-realm="ManagementRealm">
    <discovery-options>
      <static-discovery name="primary" protocol="${jboss.domain.master.protocol:remote}" host="172.16.81.100" port="${jboss.domain.master.port:9990}"/>
      <static-discovery name="backup" protocol="${jboss.domain.master.protocol:remote}" host="172.16.81.101" port="${jboss.domain.master.port:9990}"/>
    </discovery-options>
  </remote>
</domain-controller>

静态发现选项包括以下所需属性：

在上例中，第一个发现选项是预期成功的选项。第二个选项可用于故障转移情况。

可以使用 --cached-dc 选项在不连接域控制器的情况下启动主机控制器；不过，主机控制器必须之前已从域控制器在本地缓存其域控制器的域控制器配置。使用这个 --cached-dc 选项启动主机控制器将缓存主机控制器的域控制器配置。

$ EAP_HOME/bin/domain.sh --host-config=host-slave.xml --cached-dc

这会在 EAP_HOME/domain/configuration/ 目录中创建一个 domain.cached-remote.xml 文件，该文件包含此主机控制器临时管理其当前服务器而无需域控制器连接所需的信息。

如果在使用 --cached-dc 启动此主机控制器时域控制器不可用，主机控制器将开始使用 domain.cached-remote.xml 文件中保存的缓存配置。注意此文件必须存在，或者主机控制器将无法启动。

在这种状态下，主机控制器无法修改域配置，但可以启动服务器和管理部署。

在使用缓存的配置启动后，主机控制器将继续尝试重新连接到域控制器。域控制器变为可用后，主机控制器将自动重新连接它并同步域配置。请注意，一些配置更改可能要求您重新加载主机控制器才能生效。如果发生此情况，主机控制器上将记录警告。

如果主域控制器出现问题，您可以提升主机控制器以充当域控制器。主机控制器必须先将域配置从域控制器本地缓存 ，然后才能提升。

缓存域配置

将 --backup 选项用于您可能希望成为域控制器的任何主机控制器。

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

这会在 EAP_HOME/domain/configuration/ 目录中创建一个 domain.cached-remote.xml 文件，其中包含整个域配置的副本。如果主机控制器重新配置为充当域控制器，则将使用此配置。

<domain-controller>
  <remote username="$local" security-realm="ManagementRealm" ignore-unused-configuration="false">
    <discovery-options>
      ...
    </discovery-options>
  </remote>
</domain-controller>

将主机控制器提升为域控制器

此主机控制器现在将充当域控制器。

您可以使用 jboss.domain.base.dir 属性在一台计算机上运行多个主机控制器。

以这种方式启动的每个实例将共享基础安装目录中的其余资源，如 EAP_HOME/modules/，但使用 jboss.domain.base.dir 指定的目录中的域配置。

您可以在两台计算机上创建受管域，其中一台计算机是域控制器，另一台计算机是主机。如需更多信息，请参阅关于域控制器。

在两个机器中创建受管域

现在，您可以在启动时使用 --controller 参数指定域控制器地址，从而通过管理 CLI 管理域。

$ EAP_HOME/bin/jboss-cli.sh --connect --controller=IP1

或者，您可以从位于 http://IP1:9990 的 管理控制台管理该域。

JBoss EAP 7.1 域控制器可以管理运行 JBoss EAP 6 的主机和服务器，只要它们是 JBoss EAP 6.2 或更高版本。

完成以下任务，在 JBoss EAP 7 受管域中成功管理 JBoss EAP 6 实例。

完成这些任务后，您可以使用管理 CLI 从 JBoss EAP 7 域控制器管理 JBoss EAP 6 服务器和配置。请注意，JBoss EAP 6 主机将无法利用新的 JBoss EAP 7 功能，如批处理。

<servers>
    <server name="server-one" group="eap6-main-server-group"/>
    <server name="server-two" group="eap6-main-server-group">
        <socket-bindings port-offset="150"/>
    </server>
</servers>

/host-exclude=EAP64z:write-attribute(name=active-server-groups,value=[eap6-main-server-group])

JBoss EAP 7.3 域控制器可以管理从之前的 JBoss EAP 次要版本运行的主机和服务器。

完成以下任务，在 JBoss EAP 7.3 受管域中成功管理 JBoss EAP 7.2 实例。

完成这些任务后，您可以使用管理 CLI 从 JBoss EAP 7.3 域控制器管理 JBoss EAP 7.2 服务器和配置。

<servers>
    <server name="server-one" group="eap72-main-server-group"/>
    <server name="server-two" group="eap72-main-server-group">
        <socket-bindings port-offset="150"/>
    </server>
</servers>

<domain-controller>
    <remote security-realm="ManagementRealm" ignore-unused-configuration="true">
        <discovery-options>
            <static-discovery name="primary" protocol="${jboss.domain.master.protocol:remote}" host="${jboss.domain.master.address}" port="${jboss.domain.master.port:9990}"/>
        </discovery-options>
    </remote>
</domain-controller>

JBoss EAP 使用配置文件来组织服务器可用的子系统。配置文件由一组可用的子系统以及各个子系统的特定配置组成。具有大量子系统的配置文件将产生具有大量功能的服务器。具有一组小、重点的子系统的配置集将获得较少的功能，但占用空间比较小。

JBoss EAP 附带五个预定义配置文件，应满足大多数用例的要求：

在现有配置文件不提供必要的功能的情况下，JBoss EAP 也提供定义自定义配置文件的功能。

JBoss EAP 允许您通过克隆现有的配置文件在受管域中创建新配置文件。这将创建原始配置文件的配置和子系统的副本。

可以使用管理 CLI 对所需配置集的 克隆操作进行克隆，以克隆配置集。

/profile=full-ha:clone(to-profile=cloned-profile)

您也可以从管理控制台克隆配置集，方法是选择要克隆的所需配置集并单击 Clone。

在受管域中，您可以创建配置文件层次结构。这可让您使用其他配置集可以继承的通用扩展来创建基础配置文件。

受管域在 domain.xml 中定义多个配置文件。如果多个配置集将相同的配置用于特定的子系统，您只需在一个位置进行配置，而不必配置不同的配置文件。父配置文件中的值不能被覆盖。

此外，每个配置文件都必须可自助使用。如果引用了元素或子系统，则必须在引用它的配置文件中定义它。

配置集可以使用 management CLI 在层次结构中包含其他配置集，方法是使用 list-add 操作并提供要包含的配置集。

/profile=new-profile:list-add(name=includes, value=PROFILE_NAME)

您可以在主机控制器上定义 JVM 设置，并将这些设置应用到服务器组或个别服务器上。JBoss EAP 附带 默认的 JVM 设置，但以下管理 CLI 命令演示了使用一些自定义 JVM 设置和选项创建名为 production_jvm 的新 JVM 设置：

/host=HOST_NAME/jvm=production_jvm:add(heap-size=2048m, max-heap-size=2048m, max-permgen-size=512m, stack-size=1024k, jvm-options=["-XX:-UseParallelGC"])

有关所有可用选项的说明，请参阅受管域 JVM 配置属性。

您还可以导航到 Runtime → Hosts，选择主机并单击 View，然后选择 JVM 选项卡，在 JBoss EAP 管理控制台中创建和编辑 JVM 设置。

这些设置存储在 host.xml 中的 <jvm> 标签内。

在创建服务器组时，您可以指定组中的所有服务器都将使用的 JVM 配置。以下管理 CLI 命令演示了使用上例中显示的 production_jvm JVM 设置创建服务器组名称 groupA ：

/server-group=groupA:add(profile=default, socket-binding-group=standard-sockets)
/server-group=groupA/jvm=production_jvm:add

服务器组中的所有服务器都将从 production_jvm 继承 JVM 设置。

您也可以覆盖服务器组级别上的特定 JVM 设置。例如，要设置不同的堆大小，您可以使用以下命令：

/server-group=groupA/jvm=production_jvm:write-attribute(name=heap-size,value="1024m")

应用上述命令后，服务器组 groupA 将从 production_jvm 继承 JVM 设置，但堆大小除外，其值为 1024m。

有关所有可用选项的说明，请参阅受管域 JVM 配置属性。

您还可以导航到 Runtime → Server Groups，选择服务器组并单击 View，再选择 JVM 选项卡，以编辑 JBoss EAP 管理控制台中的服务器组 JVM 设置。

服务器组的这些设置存储在 domain.xml 中。

默认情况下，单个 JBoss EAP 服务器实例将继承它所属的服务器组的 JVM 设置。不过，您可以选择使用来自主机控制器的另一个完整的 JVM 设置定义覆盖继承的设置，或者选择覆盖特定的 JVM 设置。

例如，以下命令覆盖 上例中服务器组的 JVM 定义，并将 server-one 的 JVM 设置 设置为默认 JVM 定义：

/host=HOST_NAME/server-config=server-one/jvm=default:add

此外，与服务器组类似，您可以在服务器级别上覆盖特定的 JVM 设置。例如，要设置不同的堆大小，您可以使用以下命令：

/host=HOST_NAME/server-config=server-one/jvm=default:write-attribute(name=heap-size,value="1024m")

有关所有可用选项的说明，请参阅受管域 JVM 配置属性。

您还可以导航到 Runtime → Hosts，选择主机，单击服务器上的 View，然后选择 JVM 选项卡，在 JBoss EAP 管理控制台中编辑服务器 JVM 设置。

单个服务器的这些设置存储在 host.xml 中。

默认情况下，所有 JBoss EAP 日志条目都写入 server.log 文件。该文件的位置取决于您的操作模式。

此文件通常称为服务器日志。如需更多信息，请参阅 Root Logger 部分。

在启动期间，JBoss EAP 会记录有关 Java 环境和每个服务的启动信息。此日志在故障排除时非常有用。默认情况下，所有日志条目写入服务器日志中。

启动日志记录配置在 logging.properties 配置文件中指定，该文件处于活动状态，直到 JBoss EAP 日志记录 子系统启动并接管为止。该文件的位置取决于您的操作模式。

2016-03-16 14:32:01,627 ERROR [org.jboss.msc.service.fail] (MSC service thread 1-7) MSC000001: Failed to start service jboss.undertow.listener.default: org.jboss.msc.service.StartException in service jboss.undertow.listener.default: Could not start http listener
        at org.wildfly.extension.undertow.ListenerService.start(ListenerService.java:142)
        at org.jboss.msc.service.ServiceControllerImpl$StartTask.startService(ServiceControllerImpl.java:1948)
        at org.jboss.msc.service.ServiceControllerImpl$StartTask.run(ServiceControllerImpl.java:1881)
        at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)
        at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)
        at java.lang.Thread.run(Thread.java:745)
Caused by: java.net.BindException: Address already in use
        ...

/core-service=management:read-boot-errors

{
    "outcome" => "success",
    "result" => [
        {
            "failed-operation" => {
                "operation" => "add",
                "address" => [
                    ("subsystem" => "undertow"),
                    ("server" => "default-server"),
                    ("http-listener" => "default")
                ]
            },
            "failure-description" => "{\"WFLYCTL0080: Failed services\" => {\"jboss.undertow.listener.default\" => \"org.jboss.msc.service.StartException in service jboss.undertow.listener.default: Could not start http listener
    Caused by: java.net.BindException: Address already in use\"}}",
            "failed-services" => {"jboss.undertow.listener.default" => "org.jboss.msc.service.StartException in service jboss.undertow.listener.default: Could not start http listener
    Caused by: java.net.BindException: Address already in use"}
        }
        ...
    ]
}

垃圾回收日志记录将所有垃圾回收活动记录到纯文本日志文件。这些日志文件可用于诊断目的。默认情况下，除 IBM Java 开发工具包外，所有支持的配置上的 JBoss EAP 单机服务器都启用了垃圾回收日志记录。

垃圾收集日志的位置为 EAP_HOME/standalone/log/gc.log.DIGIT.current。垃圾回收日志的收集日志限制为 3 MB，最多五个文件会被轮转。

强烈建议启用垃圾回收日志记录，因为垃圾回收日志记录在故障排除中非常有用，它的开销应最小。但是，您可以在启动服务器前将 GC_LOG 变量设置为 false，为单机服务器禁用垃圾回收日志。例如：

$ export GC_LOG=false
$ EAP_HOME/bin/standalone.sh

为默认日志记录配置创建以下日志文件：默认配置使用定期日志处理程序写入服务器日志文件。

您可以通过在相应的启动配置文件中设置 JVM 属性来配置 JBoss EAP 的默认区域设置。启动配置文件是单机服务器的 EAP_HOME/bin/standalone.conf，或者受管域的 EAP_HOME/bin/domain.conf。

已国际化和本地化的日志消息将使用此默认区域设置。有关创建国际化日志消息的信息，请参见 JBoss EAP 开发指南。

设置语言

通过使用 JAVA_OPTS 变量设置 user.language 属性，以指定语言。例如，向启动配置文件添加以下行以设置法语区域设置：

JAVA_OPTS="$JAVA_OPTS -Duser.language=fr"

已国际化和本地化的日志消息现在将以法语输出。

设置语言和地区

除了语言之外，还可能需要通过设置 用户.国家属性来指定国家/ 地区。例如，在启动配置文件中添加以下行，为巴西设置葡萄牙区域设置：

JAVA_OPTS="$JAVA_OPTS -Duser.language=pt -Duser.country=BR"

已国际化和本地化的日志消息现在将在巴西葡萄牙语中输出。

使用 org.jboss.logging.locale 属性设置服务器位置

您可以配置 org.jboss.logging.locale 属性，以覆盖使用 JBoss Logging 记录的消息的区域设置，包括来自 JBoss EAP 的所有消息及其拥有的依赖关系。其他依赖项（如 JSF）无法获得覆盖的区域设置。

若要使用不同于系统默认值的区域设置启动 JBoss EAP 服务器，您可以编辑 EAP_HOME/bin/standalone.conf 或 EAP_HOME/bin/domain.conf 文件，具体取决于您的操作模式，并附加以下命令来为所需的区域设置 JVM 参数：属性的值必须以 BCP 47 格式指定。例如，要设置巴西葡萄牙语，请使用 pt-BR。

JAVA_OPTS="$JAVA_OPTS -Dorg.jboss.logging.locale=pt-BR"

JBoss EAP root 日志记录器捕获指定日志级别或更高级别的所有日志消息，发送到未被日志类别捕获的服务器。

默认情况下，根日志记录器配置为使用控制台和定期日志处理程序。定期日志处理程序配置为写入 server.log 文件。此文件通常称为服务器日志。

如需更多信息，请参阅配置 Root 日志器。

日志类别定义要捕获的一组日志消息，以及一个或多个处理消息的日志处理程序。

要捕获的日志消息由指定的 Java 原始软件包和日志级别定义。来自该软件包及日志级别或更高级别的类的消息将被日志类别捕获并发送到指定的日志处理程序。

日志类别可以选择使用根日志记录器的日志处理程序，而不使用自己的处理程序。

如需更多信息，请参阅配置日志类别。

日志处理程序定义如何记录捕获的日志消息。可用的日志处理程序类型有 console、file、periodic、size、periodic size、syslog、custom 和 async。

日志处理程序类型

有关配置每个日志处理程序的详情，请参考 配置日志处理程序 部分。

日志级别是一个枚举的值，指示日志消息的性质及严重性。作为开发人员，您可以使用所选日志记录框架的适当方法指定给定日志消息级别，以发送消息。

JBoss EAP 支持受支持的应用程序日志记录框架使用的所有日志级别。最常使用的从最低到最高日志级别为 TRACE、DEBUG、INFO、WARN、ERROR 和 FATAL。

日志类别和处理程序使用日志级别来限制它们所负责的消息。每个日志级别都有一个已分配的数字值，表示它相对于其他日志级别的顺序。日志级别和处理程序分配有日志级别，它们仅处理该级别或更高级别的日志消息。例如，级别为WARN的日志处理程序将仅记录 levels WARN 、ERROR 和 FATAL 的消息。

支持的日志级别

格式器用于格式化日志消息。可以使用 named-formatter 属性将格式化器分配到日志记录处理程序。如需有关日志记录处理程序配置的更多信息，请参阅 配置日志处理程序。

logging 子系统包括四种格式：

Pattern Formatter

模式格式器用于以纯文本格式记录日志消息。除了将 formatter 用作日志处理程序 的 named-formatter 属性外，它还可用作 formatter 属性，而无需先创建 formatter 资源。有关模式语法的更多信息，请参阅 Pattern Formatter 的格式字符。

有关如何配置模式格式化器的详情，请参阅配置模式格式器。

JSON Formatter

JSON 格式器用于在 JSON 中格式化日志消息。

如需有关如何配置 JSON 格式器的信息，请参阅配置 JSON 日志格式器。

XML Formatter

XML 日志格式器用于在 XML 中格式化日志消息。

有关如何配置 XML 日志格式器的详情，请参阅配置 XML 日志格式器。

自定义格式

用于处理程序的自定义格式器。请注意，大多数日志记录都采用 printf 格式格式化。格式器可能需要调用 org.jboss.logmanager.ExtLogRecord#getFormattedMessage（） 才能正确格式化消息。

有关如何配置自定义日志格式器的详情，请参阅配置自定义日志格式器。

使用 filter-spec 属性配置的过滤器表达式用于根据各种条件记录日志消息。过滤器检查始终在原始未格式化的消息上完成。您可以为日志记录器或处理程序包含过滤器，但日志记录器过滤器优先于处理程序上放置的过滤器。

/subsystem=logging/console-handler=CONSOLE:write-attribute(name=filter-spec, value="substituteAll(\"WFLY\"\,\"YLFW\")")

默认情况下，JBoss EAP 日志记录 子系统为部署添加隐式日志记录 API 依赖项。您可以使用 add-logging-api-dependencies 属性（默认为 true ）来控制这些隐式依赖项是否添加到部署中。

使用管理 CLI，您可以将 add-logging-api-dependencies 属性 设置为 false，从而不会将隐式日志记录 API 依赖项添加到部署中。

/subsystem=logging:write-attribute(name=add-logging-api-dependencies, value=false)

有关 logging 子系统隐式依赖项的信息，请参阅 JBoss EAP 开发指南 中的 Implicit Module 依赖项 部分。

本节介绍如何使用管理 CLI 配置控制台日志处理程序。您还可以使用管理控制台配置控制台日志处理程序，方法是导航到 Configuration → Subsystems → Logging → Configuration，点 View，然后选择 Handler → Console Handler。

在配置控制台日志处理程序时要执行的主要任务有：

添加控制台日志处理程序

/subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:add

配置控制台日志处理程序设置

根据您的需要，您可能需要设置以下一个或多个控制台日志处理程序属性：有关可用控制台日志处理程序属性及其描述的完整列表，请参阅 Console Log Handler Attributes。

将控制台日志处理程序分配给日志记录器

要激活日志处理程序，您必须将其分配到日志记录器。

以下管理 CLI 命令将控制台日志处理程序分配到根日志记录器：

/subsystem=logging/root-logger=ROOT:add-handler(name=CONSOLE_HANDLER_NAME)

以下管理 CLI 命令将控制台日志处理程序分配到其名称由 CATEGORY 指定的日志记录器：

/subsystem=logging/logger=CATEGORY:add-handler(name=CONSOLE_HANDLER_NAME)

删除控制台日志处理程序

可以使用 remove 操作移除日志处理程序。如果当前分配给日志记录器或异步日志处理程序，则无法移除日志处理程序。

/subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:remove

本节介绍如何使用管理 CLI 配置文件日志处理程序。您还可以使用管理控制台配置文件日志处理程序，方法是导航到 Configuration → Subsystems → Logging → Configuration，点 View，然后选择 Handler → File Handler。

在配置文件日志处理程序时要执行的主要任务有：

添加文件日志处理程序

在添加文件日志处理程序时，您必须使用 file 属性指定文件路径，该属性由 path 和 relative -to 属性组成。使用 path 属性设置日志的文件路径，包括名称，如 my-log.log。（可选）使用 relative-to 属性设置 路径 相对于指定路径，如 jboss.server.log.dir。

/subsystem=logging/file-handler=FILE_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH})

配置文件日志处理程序设置

根据您的需要，您可能需要设置以下一个或多个文件日志处理程序属性：有关可用文件日志处理程序属性及其描述的完整列表，请参阅 File Log Handler Attributes。

将文件日志处理程序分配给日志器

要激活日志处理程序，您必须将其分配到日志记录器。

以下管理 CLI 命令将文件日志处理程序分配到根日志记录器：

/subsystem=logging/root-logger=ROOT:add-handler(name=FILE_HANDLER_NAME)

以下管理 CLI 命令将文件日志处理程序分配到其名称由 CATEGORY 指定的日志记录器：

/subsystem=logging/logger=CATEGORY:add-handler(name=FILE_HANDLER_NAME)

删除文件日志处理程序

可以使用 remove 操作移除日志处理程序。如果当前分配给日志记录器或异步日志处理程序，则无法移除日志处理程序。

/subsystem=logging/file-handler=FILE_HANDLER_NAME:remove

本节介绍如何使用管理 CLI 配置定期轮转日志处理程序。您还可以使用管理控制台配置定期日志处理程序，方法是导航到 Configuration → Subsystems → Logging → Configuration，点 View，然后选择 Handler → Periodic Handler。

用于配置定期日志处理器的主要任务有：

添加定期日志处理程序

在添加定期日志处理程序时，您必须使用 file 属性指定文件路径，该属性由 path 和 relative -to 属性组成。使用 path 属性设置日志的文件路径，包括名称，如 my-log.log。（可选）使用 relative-to 属性设置 路径 相对于指定路径，如 jboss.server.log.dir。

您还必须使用 suffix 属性为轮转日志设置后缀。这的格式必须可以被 java.text.SimpleDateFormat（ 如 .yyyyyy-MM-dd-HH） 理解。轮转期间会基于此后缀自动计算。

/subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH},suffix=SUFFIX)

配置定期日志处理程序设置

根据您的需要，您可能需要设置以下一个或多个定期日志处理程序属性：有关可用定期日志处理程序属性及其描述的完整列表，请参阅 Periodic Log Handler Attributes。

将定期日志处理程序分配给日志记录器

要激活日志处理程序，您必须将其分配到日志记录器。

以下管理 CLI 命令将定期日志处理程序分配到根日志记录器：

/subsystem=logging/root-logger=ROOT:add-handler(name=PERIODIC_HANDLER_NAME)

以下管理 CLI 命令将定期日志处理程序分配到其名称由 CATEGORY 指定的日志记录器：

/subsystem=logging/logger=CATEGORY:add-handler(name=PERIODIC_HANDLER_NAME)

删除定期日志处理程序

可以使用 remove 操作移除日志处理程序。如果当前分配给日志记录器或异步日志处理程序，则无法移除日志处理程序。

/subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:remove

本节介绍如何使用管理 CLI 配置大小轮转日志处理程序。您还可以使用管理控制台配置大小日志处理程序，方法是导航到 Configuration → Subsystems → Logging → Configuration，点 View，然后选择 Handler → Size Handler。

在配置大小日志处理器时要执行的主要任务有：

添加大小日志处理程序

在添加大小日志处理程序时，您必须使用 file 属性指定文件路径，该属性由 path 和 relative -to 属性组成。使用 path 属性设置日志的文件路径，包括名称，如 my-log.log。（可选）使用 relative-to 属性设置 路径 相对于指定路径，如 jboss.server.log.dir。

/subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH})

配置大小日志处理程序设置

根据您的需要，您可能需要设置以下一个或多个大小日志处理程序属性：有关可用大小日志处理程序属性及其描述的完整列表，请参阅 Size Log Handler Attributes。

将 Size Log Handler 分配给日志器

要激活日志处理程序，您必须将其分配到日志记录器。

以下管理 CLI 命令将大小日志处理程序分配到根日志记录器：

/subsystem=logging/root-logger=ROOT:add-handler(name=SIZE_HANDLER_NAME)

以下管理 CLI 命令将大小日志处理程序分配给名称由 CATEGORY 指定的日志记录器：

/subsystem=logging/logger=CATEGORY:add-handler(name=SIZE_HANDLER_NAME)

删除大小日志处理程序

可以使用 remove 操作移除日志处理程序。如果当前分配给日志记录器或异步日志处理程序，则无法移除日志处理程序。

/subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:remove

本节介绍如何使用管理 CLI 配置定期大小轮转日志处理程序。您还可以通过使用管理控制台配置定期大小日志处理程序，导航到 Configuration → Subsystems → Logging → Configuration，点 View，然后选择 Handler → Periodic Size Handler。

用于配置定期大小日志处理器的主要任务有：

添加定期大小日志处理程序

在添加定期大小日志处理程序时，您必须使用 file 属性指定文件路径，该属性由 path 和 relative -to 属性组成。使用 path 属性设置日志的文件路径，包括名称，如 my-log.log。（可选）使用 relative-to 属性设置 路径 相对于指定路径，如 jboss.server.log.dir。

您还必须使用 suffix 属性为轮转日志设置后缀。这的格式必须可以被 java.text.SimpleDateFormat（ 如 .yyyyyy-MM-dd-HH） 理解。轮转期间会基于此后缀自动计算。

/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH},suffix=SUFFIX)

配置定期大小日志处理程序设置

根据您的需要，您可能需要设置以下一个或多个定期大小日志处理程序属性：有关可用定期大小日志处理程序属性及其描述的完整列表，请参阅 Periodic Sandler Attributes。

将 Periodic Size Log Handler 分配给日志记录器

要激活日志处理程序，您必须将其分配到日志记录器。

以下管理 CLI 命令将定期大小日志处理程序分配给根日志记录器：

/subsystem=logging/root-logger=ROOT:add-handler(name=PERIODIC_SIZE_HANDLER_NAME)

以下管理 CLI 命令将定期大小日志处理程序分配给由 CATEGORY 指定名称的日志记录器：

/subsystem=logging/logger=CATEGORY:add-handler(name=PERIODIC_SIZE_HANDLER_NAME)

删除定期大小日志处理程序

可以使用 remove 操作移除日志处理程序。如果当前分配给日志记录器或异步日志处理程序，则无法移除日志处理程序。

/subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:remove

本节介绍如何使用管理 CLI 配置 syslog 处理程序，该 CLI 可用于将消息发送到支持 Syslog 协议的远程记录服务器，可以是 RFC-3164 或 RFC-5424。您还可以使用管理控制台配置 syslog 处理程序，方法是导航到 Configuration → Subsystems → Logging → Configuration，点 View，然后选择 Handler → Syslog Handler。

在配置 syslog 处理程序时要执行的主要任务有：

添加 Syslog 处理程序

/subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:add

配置 Syslog 处理程序设置

根据您的需要，您可能需要设置以下一个或多个 syslog 处理程序属性：有关可用 syslog 处理程序属性及其描述的完整列表，请参阅 Syslog Handler Attributes。

将 Syslog Handler 分配给日志记录器

要激活日志处理程序，您必须将其分配到日志记录器。

以下管理 CLI 命令将 syslog 处理程序分配给根日志记录器：

/subsystem=logging/root-logger=ROOT:add-handler(name=SYSLOG_HANDLER_NAME)

以下管理 CLI 命令将 syslog 处理程序分配给名称由 CATEGORY 指定的日志记录器：

/subsystem=logging/logger=CATEGORY:add-handler(name=SYSLOG_HANDLER_NAME)

删除 Syslog 处理程序

可以使用 remove 操作移除日志处理程序。如果当前分配给日志记录器或异步日志处理程序，则无法移除日志处理程序。

/subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:remove

本节介绍如何使用管理 CLI 配置套接字日志处理程序，它可用于通过套接字发送消息。这可以是 TCP 或 UDP 套接字。您还可以使用管理控制台配置套接字日志处理程序，方法是导航到 Configuration → Subsystems → Logging → Configuration，点 View，然后选择 Handler → Socket Handler。

配置套接字日志处理器时要执行的主要任务有：

添加 Socket Binding

定义 remote-destination-outbound-socket-binding 或 local-destination-outbound-socket-binding，作为 要使用的套接字绑定。

/socket-binding-group=SOCKET_BINDING_GROUP/remote-destination-outbound-socket-binding=SOCKET_BINDING_NAME:add(host=HOST, port=PORT)

添加日志格式

定义要使用的日志格式器，如 JSON 格式器。

/subsystem=logging/json-formatter=FORMATTER:add

添加套接字日志处理程序

在添加套接字日志处理程序时，您必须指定要使用的套接字绑定和格式化器。

/subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:add(outbound-socket-binding-ref=SOCKET_BINDING_NAME,named-formatter=FORMATTER)

配置套接字日志处理程序设置

根据您的需要，您可能需要设置以下一个或多个套接字日志处理程序属性：有关可用套接字日志处理程序属性及其描述的完整列表，请参阅 Socket Log Handler Attributes。

将 Socket Log Handler 分配给 Logger

要激活日志处理程序，您必须将其分配到日志记录器。

以下管理 CLI 命令将套接字日志处理程序分配到根日志记录器：

/subsystem=logging/root-logger=ROOT:add-handler(name=SOCKET_HANDLER_NAME)

以下管理 CLI 命令将套接字日志处理程序分配给名称由 CATEGORY 指定的日志记录器：

/subsystem=logging/logger=CATEGORY:add-handler(name=SOCKET_HANDLER_NAME)

删除套接字日志处理程序

可以使用 remove 操作移除日志处理程序。如果当前分配给日志记录器或异步日志处理程序，则无法移除日志处理程序。

/subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:remove

使用 SSL/TLS 通过套接字发送日志消息

下列步骤演示了如何设置套接字日志处理程序以使用 SSL_TCP 协议通过套接字发送日志消息的示例。本例在 elytron 子系统中配置密钥存储、信任管理器和客户端 SSL 上下文，供套接字日志处理程序使用。来自根日志记录器的日志消息通过指定的套接字发送，格式为 JSON 格式。

有关配置 Elytron 组件的更多信息，请参阅如何为 JBoss EAP 配置服务器安全性的 Elytron Subsystem。

本节介绍如何使用管理 CLI 配置自定义日志处理程序。您还可以使用管理控制台配置自定义日志处理程序，方法是导航到 Configuration → Subsystems → Logging → Configuration，点 View，然后选择 Handler → Custom Handler。

用于配置自定义日志处理器的主要任务有：

添加自定义日志处理程序

在添加自定义日志处理程序时，您必须指定处理程序的 Java 类以及包含它的 JBoss EAP 模块。该类必须扩展 java.util.logging.Handler。

/subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:add(class=CLASS_NAME,module=MODULE_NAME)

配置自定义日志处理程序设置

根据您的需要，您可能需要设置以下一个或多个自定义日志处理程序属性：有关可用自定义日志处理程序属性及其描述的完整列表，请参阅自定义日志处理程序属性。