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

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

检查 Server Suspend State

可以使用以下管理 CLI 命令查看服务器挂起状态：生成的值为 RUNNING、PRE_SUSPEND、SUSPENDING 或 SUSPENDED 之一。

suspend

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

每个示例最多等待 60 秒，以便请求在挂起前完成。

resume

可以使用适当级别的 restore 命令（服务器、服务器组、整个域），服务器可以返回到正常的运行状态，以接受新请求。例如：

:resume

如果在停止服务器时指定了适当的超时值，服务器将被正常关闭。发出该命令后，服务器将被暂停，并等待所有请求的指定超时，然后再关机。

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

每个示例都等待 60 秒，以便请求在关闭前完成。

用于启动 JBoss EAP 的 RPM 安装的命令取决于您要启动哪个操作模式（单机服务器或受管域），以及您正在运行的 Red Hat Enterprise Linux 版本。

启动 JBoss EAP 作为单机服务器(RPM 安装)

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

在受管域中启动 JBoss EAP (RPM 安装)

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

配置 RPM 服务属性

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

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

用于停止 JBoss EAP 的 RPM 安装的命令取决于哪个操作模式（单机服务器或受管域），以及您正在运行的 Red Hat Enterprise Linux 版本。

停止 JBoss EAP 作为单机服务器(RPM 安装)

在受管域中停止 JBoss EAP (RPM 安装)

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

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

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

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

以下命令添加了一个带有 guest 和 mgmtgroup 组的管理用户(mgmtuser1)。

$ 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 实用程序参数部分。

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

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

可以在 EAP_HOME/bin/add-user.properties 文件中配置的额外密码要求：

管理命令行界面(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

使用以下命令获取特定命令的帮助信息。

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/App.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 管理层集成。JBoss EAP 管理 CLI 使用原生 API，但也为其他客户端提供集成功能。

以下 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)。

默认情况下，将 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 命令。您可以使用 max-history 属性指定要存储的条目数量。

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

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

/core-service=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"}
            }]
        }
    ]
}

本例列出了影响配置执行的三个操作的详情：

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

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

以下 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>

将 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}，然后将其输入到更大的表达式并评估生成的表达式。此配置的优点在于数据源的名称是从固定配置中提取的。

基于描述符的特征替换

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

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

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

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

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

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

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

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

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

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

覆盖受管域的标准路径

在本例中，目标是将域文件存储在 /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:3.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>

在受管域中，每台服务器的文件存储在 EAP_HOME/domain 目录中。您可以使用主机控制器的 directory-grouping 属性来指定如何为服务器组织子目录。目录可以按 服务器 分组，或者 按类型 进行分组。默认情况下，目录按 服务器 分组。

按服务器划分的目录

默认情况下，目录按服务器分组。如果您的管理是以 服务器为中心的，则建议使用此配置。例如，它允许为每个服务器实例配置备份和日志文件处理。

如果使用 ZIP 安装方法安装 JBoss EAP，则默认目录结构（按服务器分组）将如下所示：

EAP_HOME/domain
         └─ servers
            ├── server-one
            │   ├── data
            │   ├── tmp
            │   └── log
            └── server-two
                ├── data
                ├── tmp
                └── log

要按服务器对域目录进行分组，请输入以下管理 CLI 命令：

/host=HOST_NAME:write-attribute(name=directory-grouping,value=by-server)

这将更新主机控制器的 host.xml 配置文件：

<servers directory-grouping="by-server">
  <server name="server-one" group="main-server-group"/>
  <server name="server-two" group="main-server-group" auto-start="true">
    <socket-bindings port-offset="150"/>
  </server>
</servers>

按类型划分的目录

您可以使用文件类型对目录进行分组，而不是按服务器对目录进行分组。如果您的管理是以 类型为中心的文件，则建议使用此配置。例如，这可让您只 备份数据 文件。

如果使用 ZIP 安装方法安装 JBoss EAP，并且域的文件按类型分组，则目录结构将如下所示：

EAP_HOME/domain
         ├── data
         │   └── servers
         │       ├── server-one
         │       └── server-two
         ├── log
         │   └── servers
         │       ├── server-one
         │       └── server-two
         └── tmp
             └── servers
                 ├── server-one
                 └── server-two

要根据类型对域目录进行分组，请输入以下管理 CLI 命令：

/host=HOST_NAME:write-attribute(name=directory-grouping,value=by-type)

这将更新主机控制器的 host.xml 配置文件：

<servers directory-grouping="by-type">
  <server name="server-one" group="main-server-group"/>
  <server name="server-two" group="main-server-group" auto-start="true">
    <socket-bindings port-offset="150"/>
  </server>
</servers>

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

要设置 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

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

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

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

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

<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 启动为单机服务器时可以设置 public 接口的 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>

更新接口属性

更新 public 接口的默认 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=master/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.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-tcp-fd" interface="private" port="57600"/>
        <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="jgroups-udp-fd" interface="private" port="54200"/>
        <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-groups>

在定义套接字绑定时，您可以配置 port 和 interface 属性，以及多播设置，如 multicast-address 和 multicast-port。有关所有可用套接字绑定属性的详情，请查看 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 命令并指定应用部署的路径。

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

该应用已被成功部署。

取消部署应用

从管理 CLI，使用 undeploy 命令并指定部署名称。

成功取消部署不会向管理 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")

该应用已成功取消部署。

列出部署

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

deployment-info

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

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

您还可以使用 --name 参数根据名称过滤显示的部署。

部署应用程序

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

成功的部署不会向管理 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")

该应用已成功部署到受管域中的相应服务器组。

取消部署应用

从管理 CLI，使用 undeploy 命令并指定部署名称。您还必须指定应取消部署应用的服务器组。

成功取消部署不会向管理 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")

该应用已成功取消部署。

列出部署

从管理 CLI，使用 deployment-info 命令列出部署信息。您可以根据部署名称或服务器组列出部署信息。

按名称显示部署信息：

deployment-info --name=jboss-helloworld.war

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

NAME                 RUNTIME-NAME
jboss-helloworld.war jboss-helloworld.war

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

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

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

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

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

您还可以使用 deploy -l 命令列出域中的所有部署。

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

部署应用程序

点 Add 按钮，并使用 New Deployment 向导来部署应用程序。您可以选择通过 上传部署或创建 非受管部署 来部署应用程序。部署默认是启用的。

取消部署应用

选择部署，再选择 Remove 选项以取消部署应用。这会取消部署，并将它从内容存储库移除。

禁用应用程序

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

替换应用程序

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

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

部署应用程序

也可以将部署添加到服务器组，并在一个步骤中通过添加 Server Groups 的部署来启用。

将应用程序分配给服务器组

从服务器组取消分配应用程序

通过选择 Content Repository 中的部署的 Unassign 按钮，也可以一次从多个服务器组取消分配部署。

取消部署应用

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

禁用应用程序

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

替换应用程序

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

部署扫描程序可以配置为允许或禁止自动部署 XML、ziped 和 exploded 内容。如果禁用了自动部署，您必须手动创建标记文件来触发部署操作。有关可用标记文件类型及其目的的更多信息，请参阅 Deployment Scanner Marker Files 部分。

默认情况下，启用了 XML 和 zipped 内容的自动部署。有关为每个内容类型配置自动部署的详情，请参阅配置 部署扫描器。

部署应用程序

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

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

如果启用了自动部署，则该文件将自动获取、部署和 .deployed 标记文件。如果没有启用自动部署，则需要手动添加 .dodeploy 标记文件来触发部署。

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

取消部署应用

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

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

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

重新部署应用程序

创建 .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)

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

更改 Scan Interval

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

这会将扫描间隔时间从 5000 毫秒（以秒为单位）更新为 10000 毫秒（秒）。

更改部署文件夹

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

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

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

启用 Exploded 内容的自动部署

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

这可启用自动部署 exploded 内容，这默认是禁用的。

禁用 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 命令添加了一个新的部署扫描程序，它将每 5 秒检查 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 入门指南中的使用 Quickstart 示例。

部署应用程序

在 Maven pom.xml 文件中初始化 WildFly Maven 插件。这应该已在 JBoss EAP quickstart 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 "jboss-helloworld.war" (runtime-name: "jboss-helloworld.war")
WFLYUT0021: Registered web context: /jboss-helloworld
WFLYSRV0010: Deployed "jboss-helloworld.war" (runtime-name : "jboss-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: /jboss-helloworld
WFLYSRV0028: Stopped deployment jboss-helloworld.war (runtime-name: jboss-helloworld.war) in 27ms
WFLYSRV0009: Undeployed "jboss-helloworld.war" (runtime-name: "jboss-helloworld.war")

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

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

部署应用程序

在受管域中部署应用程序时，您必须指定应部署到的服务器组。这在 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 "jboss-helloworld.war" (runtime-name: "jboss-helloworld.war")
WFLYUT0021: Registered web context: /jboss-helloworld
WFLYSRV0010: Deployed "jboss-helloworld.war" (runtime-name : "jboss-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: /jboss-helloworld
WFLYSRV0028: Stopped deployment jboss-helloworld.war (runtime-name: jboss-helloworld.war) in 106ms
WFLYSRV0009: Undeployed "jboss-helloworld.war" (runtime-name: "jboss-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 umlns="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 add management CLI 命令添加部署覆盖。

deployment-overlay add --name=new-deployment-overlay --content=WEB-INF/web.xml=/path/to/other/web.xml --deployments=test-application.war --redeploy-affected

创建后，您可以将内容添加到现有的 overlay 中，将覆盖链接到部署或移除覆盖。如需完整的使用详情，请执行 deployment-overlay --help。

关于 Rollout 计划

在受管域中，针对域或主机级别资源的操作可能会影响多个服务器。此类操作可以包括一个汇总计划，详细说明操作要应用到服务器的顺序，以及用于详细说明在某些服务器上成功执行该操作时是否可以恢复操作的策略。如果没有指定 rollout 计划，则使用默认的 rollout 计划。

以下是涉及五个服务器组的 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 计划。这使用以下语法：

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

使用 Rollout 计划进行部署

您可以通过将 rollout 设置传递给 headers 参数，将 rollout 计划直接提供给 deploy 命令。有关格式的更多信息，请参阅 Rollout Plan Syntax。

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

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

使用存储的 Rollout 计划进行部署

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

删除 Stored Rollout 计划

您可以通过指定要删除的 rollout 计划的名称，使用 rollout-plan 管理 CLI 命令删除存储的 rollout 计划。

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

默认 Rollout 计划

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

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

域控制器的主要职责是：

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

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

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

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

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

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

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

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

进程控制器日志记录到 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

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

将主机配置为作为域控制器的 Act

如果在 <domain -controller> 声明中包含 <local /> 元素，则主机被指定为域控制器。

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

用作域控制器的主机必须公开可由域中的其他主机访问的管理接口。不需要公开 HTTP (S)管理界面，但建议使用，因为它允许访问管理控制台。

<management-interfaces>
  <native-interface security-realm="ManagementRealm">
    <socket interface="management" port="${jboss.management.native.port:9999}"/>
  </native-interface>
  <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& gt; 项中进行配置。

<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:9999}"/>
    </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 xmlns="urn:jboss:domain:4.0" name="host1">

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

在设置受管域时，必须为每个主机控制器配置与域控制器联系所需的信息。在 JBoss EAP 中，每个主机控制器都可配置多个选项来查找域控制器。主机控制器迭代选项列表，直到成功为止。

这允许主机控制器预先配置了备份域控制器的联系信息。如果主域控制器存在问题，则备份主机控制器可以提升到 master，允许主机控制器在提升新 master 后自动失败。

以下是如何使用多个选项配置主机控制器，以查找域控制器：

<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:9999}"/>
      <static-discovery name="backup" protocol="${jboss.domain.master.protocol:remote}" host="172.16.81.101" port="${jboss.domain.master.port:9999}"/>
    </discovery-options>
  </remote>
</domain-controller>

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

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

如果主域控制器出现问题，可以通过 --backup 选项启动的主机控制器提升为充当域控制器。

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

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

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

<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="jboss-helloworld.war" runtime-name="jboss-helloworld.war" enabled="false"/>
  </deployments>
</server-group>

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

添加服务器组

以下管理 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 或管理控制台 Runtime 选项卡配置服务器。

添加服务器

以下管理 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

您可以使用 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 域控制器可以管理运行较旧版本的 JBoss EAP 的主机和服务器，只要满足以下条件：

完成以下任务，以成功管理 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 使用 配置文件 来组织哪些子系统可供服务器使用。配置文件由一组可用子系统以及各个子系统的特定配置组成。具有大量子系统的配置集会导致服务器具有大量功能。包含小、集中一组子系统的配置集将具有较少的功能，但占用的空间较小。

JBoss EAP 附带四个预定义的配置文件，它们应该满足大多数用例：

如果现有配置集不提供必要的功能，JBoss EAP 还提供定义自定义配置集的功能。

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

通过使用所需配置集的 clone 操作，可以使用管理 CLI 克隆配置集。

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

您还可以通过选择要克隆的配置集并单击 Clone，从管理控制台克隆。

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

受管域在 domain.xml 中定义多个配置集。如果多个配置集为特定子系统使用相同的配置，您可以只在一个位置而不是不同的配置集进行配置。父配置集中的值无法覆盖。

配置文件可以使用管理 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"]
)

您还可以通过选择 Runtime 选项卡，选择 Hosts，然后单击您要编辑的主机上的 JVM，在 JBoss EAP 管理控制台中创建和编辑 JVM。

这些设置存储在 host.xml 中的 &lt ;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。

您还可以通过选择 Runtime 选项卡，选择 Server Groups，再单击您要编辑的服务器组的 View，以编辑 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")

您还可以通过选择 Runtime 选项卡，选择 Hosts，选择相关主机来编辑 JBoss EAP 管理控制台中的服务器 JVM 设置。然后选择相关的服务器，然后点您要编辑的服务器的 View。

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

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

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

在启动过程中，JBoss EAP 会记录有关 Java 环境以及各个服务的启动信息。此日志在故障排除时很有用。默认情况下，所有日志条目都写入 服务器日志。

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

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，最多会轮转五个文件。

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

您可以通过在适当的启动配置文件中设置 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"

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

设置语言和国家

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

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

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

使用 org.jboss.logging.locale Property 设置 Server 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 根日志记录器捕获指定日志级别或更高日志级别的所有日志消息，发送到不是由日志类别捕获的服务器。

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

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

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

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

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

如需更多信息 ，请参阅配置 日志条目。

日志处理程序定义如何记录捕获的日志消息。可用的日志处理程序类型是 控制台、文件、定期、大小、定期大小、syslog、自定义 和 async。

日志处理程序类型

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

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

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

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

支持的日志级别

日志格式器定义来自该处理程序的日志消息的外观。它是使用基于 java.util.logging.Formatter 类的语法的字符串。

例如，默认配置使用以下日志格式字符串将消息记录到服务器日志： %d{yyyy-MM-dd HH:mm:ss,SSS} %-5p [%c](%t)%s%e%n。这将创建类似以下的日志消息。

2016-03-18 15:49:32,075 INFO  [org.jboss.as] (Controller Boot Thread) WFLYSRV0051: Admin console listening on http://127.0.0.1:9990

有关配置日志格式器的更多信息，请参阅配置指定模式 格式或 配置自定义日志格式 器。

下表列出了日志格式字符串中使用的语法。

日志格式语法

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

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

默认情况下，JBoss EAP logging 子系统为部署添加隐式日志记录 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 Dependencies 部分。

本节介绍如何使用管理 CLI 配置控制台日志处理程序。您还可以通过从 Configuration 选项卡中导航到 Logging 子系统，选择 Handler 选项卡并从左侧菜单中选择 Console，来使用管理控制台配置控制台日志处理程序。

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

添加控制台日志处理程序

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

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

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

将 Console Log Handler 分配给 Logger

要让日志处理程序处于活动状态，您必须将它分配给日志记录器。

以下管理 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 操作来删除日志处理程序。当前分配给日志记录器或 async 日志处理程序，则无法删除日志处理程序。

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

本节介绍如何使用管理 CLI 配置文件日志处理程序。您还可以通过从 Configuration 选项卡导航到 Logging 子系统，选择 Handler 选项卡并从左侧菜单中选择 File，来使用管理控制台配置文件日志处理程序。

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

添加文件日志处理程序

在添加文件日志处理程序时，您必须使用 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 分配给 Logger

要让日志处理程序处于活动状态，您必须将它分配给日志记录器。

以下管理 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 操作来删除日志处理程序。当前分配给日志记录器或 async 日志处理程序，则无法删除日志处理程序。

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

本节介绍如何使用管理 CLI 配置定期轮转日志处理程序。您还可以通过从 Configuration 选项卡导航到 Logging 子系统，选择 Handler 选项卡，然后从左侧菜单中选择 Periodic 来配置定期日志处理程序。

配置定期日志处理器您要执行的主要任务有：

添加定期日志处理程序

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

您还必须使用 suffix 属性为轮转日志设置 后缀。这必须采用可由 java.text.SimpleDateFormat 理解的格式，如 .yyyy-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 属性。

将 Periodic Log Handler 分配给 Logger

要让日志处理程序处于活动状态，您必须将它分配给日志记录器。

以下管理 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 操作来删除日志处理程序。当前分配给日志记录器或 async 日志处理程序，则无法删除日志处理程序。

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

本节介绍如何使用管理 CLI 配置大小轮转日志处理程序。您还可以通过从 Configuration 选项卡中导航到 Logging 子系统，选择 Handler 选项卡并从左侧菜单中选择 Size，来使用管理控制台配置大小日志处理程序。

配置大小日志处理程序要执行的主要任务有：

添加大小日志处理程序

在添加大小日志处理程序时，您必须使用 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 分配给 Logger

要让日志处理程序处于活动状态，您必须将它分配给日志记录器。

以下管理 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 操作来删除日志处理程序。当前分配给日志记录器或 async 日志处理程序，则无法删除日志处理程序。

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

本节介绍如何使用管理 CLI 配置定期大小轮转日志处理程序。您还可以通过导航到 Logging 子系统，选择 Handler 选项卡，然后从左侧菜单中选择 Periodic Size，来使用管理控制台配置定期大小日志处理程序。

配置定期日志处理器时要执行的主要任务有：

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

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

您还必须使用 suffix 属性为轮转日志设置 后缀。这必须采用可由 java.text.SimpleDateFormat 理解的格式，如 .yyyy-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 Size Log Handler 属性。

将 Periodic Size Log Handler 分配给 Logger

要让日志处理程序处于活动状态，您必须将它分配给日志记录器。

以下管理 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 操作来删除日志处理程序。当前分配给日志记录器或 async 日志处理程序，则无法删除日志处理程序。

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

本节介绍如何使用管理 CLI 配置 syslog 处理程序，该处理程序可用于发送消息到支持 Syslog 协议(RFC-3164 或 RFC-5424)的远程日志记录服务器。您还可以通过从 Configuration 选项卡导航到 Logging 子系统，选择 Handler 选项卡并从左侧菜单中选择 Syslog 来配置 syslog 处理程序。

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

添加 Syslog 处理程序

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

配置 Syslog 处理程序设置

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

将 Syslog Handler 分配给 Logger

要让日志处理程序处于活动状态，您必须将它分配给日志记录器。

以下管理 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 操作来删除日志处理程序。当前分配给日志记录器或 async 日志处理程序，则无法删除日志处理程序。

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

本节介绍如何使用管理 CLI 配置自定义日志处理程序。您还可以通过从 Configuration 选项卡导航到 Logging 子系统，选择 Handler 选项卡并从左侧菜单中选择 Custom，来使用管理控制台配置自定义日志处理程序。

配置自定义日志处理器您要执行的主要任务有：

添加自定义日志处理程序

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

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

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

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

将自定义日志处理程序分配给 Logger

要让日志处理程序处于活动状态，您必须将它分配给日志记录器。

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

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

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

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

删除自定义日志处理程序

可以通过 remove 操作来删除日志处理程序。当前分配给日志记录器或 async 日志处理程序，则无法删除日志处理程序。

/subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:remove

本节介绍如何使用管理 CLI 配置 async 日志处理程序。您还可以通过从 Configuration 选项卡导航到 Logging 子系统，选择 Handler 选项卡并从左侧菜单中选择 Async，来使用管理控制台配置 async 日志处理程序。

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

添加异步日志处理程序

添加 async 日志处理程序时，您必须指定队列长度。这是队列中可以保存的日志请求的最大数量。

/subsystem=logging/async-handler=ASYNC_HANDLER_NAME:add(queue-length=QUEUE_LENGTH)

添加 Sub-handler

您可以将一个或多个处理程序添加为此 async 日志处理程序的子处理程序。请注意，处理程序必须已存在于配置中，否则此命令将失败。

/subsystem=logging/async-handler=ASYNC_HANDLER_NAME:add-handler(name=HANDLER_NAME)

配置同步日志处理程序设置

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

将 Async Log Handler 分配给 Logger

要让日志处理程序处于活动状态，您必须将它分配给日志记录器。

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

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

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

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

删除异步日志处理程序

可以通过 remove 操作来删除日志处理程序。当前分配给日志记录器，则无法删除日志处理程序。

/subsystem=logging/async-handler=ASYNC_HANDLER_NAME:remove

您可以创建一个命名模式格式器，可在日志处理程序之间用于格式化日志消息。

本节介绍如何使用管理 CLI 配置日志格式。您还可以通过从 Configuration 选项卡中导航到 Logging 子系统，选择 Formatter 选项卡并从左侧菜单中选择 Pattern，来使用管理控制台配置日志格式。

创建指定格式

在定义 formatter 时，您可以提供一个用于格式化日志消息的模式字符串。有关 模式语法的更多信息，请参阅日志格式ter。

/subsystem=logging/pattern-formatter=PATTERN_FORMATTER_NAME:add(pattern=PATTERN_STRING)

您还可以定义一个颜色映射，将颜色分配给不同的日志级别。格式是 LEVEL:COLOR 的逗号分隔列表。

/subsystem=logging/pattern-formatter=PATTERN_FORMATTER_NAME:write-attribute(name=color-map,value="LEVEL:COLOR,LEVEL:COLOR")

将指定格式器分配给日志处理程序

以下管理 CLI 命令分配供定期轮转文件处理程序使用的模式格式器。

/subsystem=logging/periodic-rotating-file-handler=FILE_HANDLER_NAME:write-attribute(name=named-formatter,value=PATTERN_FORMATTER_NAME)

您可以创建自定义日志格式器，该格式可在日志处理程序之间用于格式化日志消息。

本节介绍如何使用管理 CLI 配置自定义日志格式。您还可以通过从 Configuration 选项卡中导航到 Logging 子系统，选择 Formatter 选项卡并从左侧菜单中选择 Custom，来使用管理控制台配置日志格式。

配置自定义日志格式

自定义 XML 格式器示例

以下示例配置了一个自定义 XML 格式。它使用 org.jboss.logmanager 模块中提供的 java.util.logging.XMLFormatter 类，并将其分配给控制台日志处理程序。

/subsystem=logging/custom-formatter=custom-xml-formatter:add(class=java.util.logging.XMLFormatter, module=org.jboss.logmanager)
/subsystem=logging/console-handler=CONSOLE:write-attribute(name=named-formatter, value=custom-xml-formatter)

使用这个格式器的日志消息的格式如下。

<record>
  <date>2016-03-23T12:58:13</date>
  <millis>1458752293091</millis>
  <sequence>93963</sequence>
  <logger>org.jboss.as</logger>
  <level>INFO</level>
  <class>org.jboss.as.server.BootstrapListener</class>
  <method>logAdminConsole</method>
  <thread>22</thread>
  <message>WFLYSRV0051: Admin console listening on http://%s:%d</message>
  <param>127.0.0.1</param>
  <param>9990</param>
</record>

通过每个部署日志，开发人员可以提前为其应用程序配置日志配置。部署应用程序时，日志记录会根据定义的配置开始。通过此配置创建的日志文件仅包含与应用行为相关的信息。

与使用系统范围的日志记录相比，这种方法具有优缺点。优点是 JBoss EAP 实例的管理员不需要配置除服务器日志记录以外的任何其他日志记录。缺点是，每个部署的日志配置仅在服务器启动时读取，因此在运行时无法更改。

有关在应用程序中使用每个部署日志的说明，请参阅 JBoss EAP 开发指南中的 添加 Per-deployment Logging 到应用程序。

日志记录配置集是可分配给部署的应用程序的独立日志记录配置集合。与常规日志记录子系统一样，日志记录配置文件可以定义处理程序、类别和根日志记录器，但它无法引用其他配置集或主日志记录子系统中的配置。 日志记录配置集的设计模拟 logging 子系统，以简化配置。

通过日志记录配置集，管理员可以创建特定于一个或多个应用程序的日志记录配置，而不影响任何其他日志记录配置。由于在服务器配置中定义了每个配置集，因此可以更改日志配置，而无需重新部署受影响的应用程序。但是，无法使用管理控制台配置日志配置集。

每个日志记录配置集都可以：

应用程序可以使用 Logging-Profile 属性指定在 MANIFEST.MF 文件中要使用的日志配置集。

/subsystem=logging/logging-profile=accounts-app-profile:add

/subsystem=logging/logging-profile=accounts-app-profile/file-handler=ejb-trace-file:add(file={path=>"ejb-trace.log", "relative-to"=>"jboss.server.log.dir"})

/subsystem=logging/logging-profile=accounts-app-profile/file-handler=ejb-trace-file:write-attribute(name="level", value="DEBUG")

/subsystem=logging/logging-profile=accounts-app-profile/logger=com.company.accounts.ejbs:add(level=TRACE)

/subsystem=logging/logging-profile=accounts-app-profile/logger=com.company.accounts.ejbs:add-handler(name="ejb-trace-file")

<logging-profiles>
   <logging-profile name="accounts-app-profile">
      <file-handler name="ejb-trace-file">
         <level name="DEBUG"/>
         <file relative-to="jboss.server.log.dir" path="ejb-trace.log"/>
      </file-handler>
      <logger category="com.company.accounts.ejbs">
         <level name="TRACE"/>
         <handlers>
            <handler name="ejb-trace-file"/>
         </handlers>
      </logger>
   </logging-profile>
</logging-profiles>

Manifest-Version: 1.0
Logging-Profile: accounts-app-profile

您可以使用以下管理 CLI 命令获取有关特定部署的日志记录配置的信息。

/deployment=DEPLOYMENT_NAME/subsystem=logging/configuration=CONFIG:read-resource

部署的日志记录配置值(CONFIG)可以是以下三个值之一：

例如，以下管理 CLI 命令显示 MYPROFILE 日志记录配置集的配置，供指定部署使用。

/deployment=mydeployment.war/subsystem=logging/configuration=profile-MYPROFILE:read-resource(recursive=true,include-runtime=true)

这将输出以下信息：

{
    "outcome" => "success",
    "result" => {
        "error-manager" => undefined,
        "filter" => undefined,
        "formatter" => {
            "MYFORMATTER" => {
                "class-name" => "org.jboss.logmanager.formatters.PatternFormatter",
                "module" => undefined,
                "properties" => {"pattern" => "%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%e%n"}
            }
        },
        "handler" => {
            "MYPERIODIC" => {
                "class-name" => "org.jboss.logmanager.handlers.PeriodicRotatingFileHandler",
                "encoding" => undefined,
                "error-manager" => undefined,
                "filter" => undefined,
                "formatter" => "MYFORMATTER",
                "handlers" => [],
                "level" => "ALL",
                "module" => undefined,
                "properties" => {
                    "append" => "true",
                    "autoFlush" => "true",
                    "enabled" => "true",
                    "suffix" => ".yyyy-MM-dd",
                    "fileName" => "EAP_HOME/standalone/log/deployment.log"
                }
            }
        },
        "logger" => {"MYCATEGORY" => {
            "filter" => undefined,
            "handlers" => [],
            "level" => "DEBUG",
            "use-parent-handlers" => true
        }},
        "pojo" => undefined
    }
}

您还可以使用递归 read-resource 操作来读取日志记录配置以及有关部署的其他信息。

/deployment=DEPLOYMENT_NAME/subsystem=logging:read-resource(include-runtime=true, recursive=true)

可以使用管理 CLI 将 JDBC 驱动程序作为核心模块安装，并执行下列步骤。

JDBC 驱动程序现在可供应用数据源引用。

JDBC 驱动程序可以使用管理 CLI 或管理控制台作为 JAR 部署安装。只要驱动程序兼容 JDBC 4，它将在部署时自动识别并安装为 JDBC 驱动程序。

下列步骤描述了如何使用管理 CLI 安装 JDBC 驱动程序。

JDBC 驱动程序现在可供应用数据源引用。

更新 JDBC 驱动程序 JAR，使其 JDBC 4-Compliant

如果 JDBC 驱动程序 JAR 不兼容 JDBC 4，则可以按照以下流程部署它。

下表提供了用于 JBoss EAP 的通用数据库的 JDBC 驱动程序的标准下载位置。

在某些情况下，应用需要使用不属于 JDBC API 的特定供应商功能。在这些情况下，您可以通过声明该应用中的依赖项来访问特定于供应商的 API。

您可以使用 MANIFEST.MF 文件或 jboss-deployment-structure.xml 文件为应用程序定义依赖项。

如果您还没有这样做，请将 JDBC 驱动程序安装为核心模块。

使用 MANIFEST.MF 文件

使用 jboss-deployment-structure.xml 文件

以下示例代码访问 MySQL API。

import java.sql.Connection;
import org.jboss.jca.adapters.jdbc.WrappedConnection;

...

Connection c = ds.getConnection();
WrappedConnection wc = (WrappedConnection)c;
com.mysql.jdbc.Connection mc = wc.getUnderlyingConnection();

非 XA 数据源可以使用 数据源添加 管理 CLI 命令来定义。您还可以使用管理控制台定义非 XA 数据源，方法是导航到 Configuration → Subsystems → Datasources → Non-XA，然后点 Add 来打开 Create Datasource 向导。

以下步骤描述了如何使用管理 CLI 定义非 XA 数据源。

有关详细 示例，请参阅支持的数据库 示例数据源配置。

数据源参数

有关所有可用数据源参数的完整列表，请参阅 Datasource Parameters 部分。

XA datasources 可使用 xa-data-source add 管理 CLI 命令来定义。您还可以使用管理控制台定义 XA datasources，方法是导航到 Configuration → Subsystems → Datasources → XA，然后点击 Add 来打开 Create XA Datasource 向导。

以下步骤描述了如何使用管理 CLI 定义 XA 数据源。

有关详细 示例，请参阅支持的数据库 示例数据源配置。

数据源参数

有关所有可用数据源参数的完整列表，请参阅 Datasource Parameters 部分。

非 XA 数据源设置可以使用 数据源 管理 CLI 命令更新。您也可以从管理控制台中的 datasources 子系统更新数据源属性。

可以使用以下管理 CLI 命令更新数据源的设置。

data-source --name=DATASOURCE_NAME --ATTRIBUTE_NAME=ATTRIBUTE_VALUE

可能需要重新加载服务器才能使更改生效。

可以使用 xa-data-source 管理 CLI 命令更新 XA 数据源设置。您也可以从管理控制台中的 datasources 子系统更新数据源属性。

可能需要重新加载服务器才能使更改生效。

可以使用 data-source remove management CLI 命令删除非 XA 数据源。您也可以从管理控制台中的 datasources 子系统删除数据源。

data-source remove --name=DATASOURCE_NAME

在数据源被删除后，服务器将需要重新加载。

XA datasources 可使用 xa-data-source remove 管理 CLI 命令移除。您也可以从管理控制台中的 datasources 子系统移除 XA datasources。

xa-data-source remove --name=XA_DATASOURCE_NAME

在删除 XA 数据源后，服务器将需要重新加载。

对于大多数 JDBC 资源，恢复模块会自动与资源关联。在这些情况下，您只需要配置允许恢复模块连接到资源的选项来执行恢复。

下表描述了特定于 XA 恢复的 XA 数据源参数。这些配置属性可以在数据源创建期间或之后设置。您可以使用管理控制台或管理 CLI 设置它们。有关配置 XA 数据源的信息，请参阅修改 XA 数据源。

使用以下管理 CLI 命令禁用 XA 数据源的恢复：

/subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME:write-attribute(name=no-recovery,value=true)

特定于供应商的配置

有些数据库需要特定的配置，才能在由 JBoss EAP 事务管理器管理的 XA 事务中进行协作。有关详情和最新信息，请查看您的数据库厂商的文档。

已知问题

处理 XA 事务的这些已知问题适用于 JBoss EAP 7 支持的特定数据库和 JDBC 驱动程序版本。有关支持的数据库的最新信息，请参阅 JBoss EAP 支持的配置。

这是包含连接信息、基本安全性和验证选项的 MySQL 数据源配置示例。

MySQL 数据源配置示例

<datasources>
  <datasource jndi-name="java:jboss/MySqlDS" pool-name="MySqlDS">
    <connection-url>jdbc:mysql://localhost:3306/jbossdb</connection-url>
    <driver>mysql</driver>
    <security>
      <user-name>admin</user-name>
      <password>admin</password>
    </security>
    <validation>
      <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker"/>
      <validate-on-match>true</validate-on-match>
      <background-validation>false</background-validation>
      <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLExceptionSorter"/>
    </validation>
  </datasource>
  <drivers>
    <driver name="mysql" module="com.mysql">
      <driver-class>com.mysql.jdbc.Driver</driver-class>
      <xa-datasource-class>com.mysql.jdbc.jdbc2.optional.MysqlXADataSource</xa-datasource-class>
    </driver>
  </drivers>
</datasources>

MySQL JDBC Driver module.xml 文件示例

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="com.mysql">
  <resources>
    <resource-root path="mysql-connector-java-5.1.36-bin.jar"/>
  </resources>
  <dependencies>
    <module name="javax.api"/>
    <module name="javax.transaction.api"/>
  </dependencies>
</module>

管理 CLI 命令示例

此示例配置可以通过以下管理 CLI 命令来实现。

这是带有 XA 数据源属性、基本安全性和验证选项的 MySQL XA 数据源配置示例。

MySQL XA 数据源配置示例

<datasources>
  <xa-datasource jndi-name="java:jboss/MySqlXADS" pool-name="MySqlXADS">
    <xa-datasource-property name="ServerName">
      localhost
    </xa-datasource-property>
    <xa-datasource-property name="DatabaseName">
      mysqldb
    </xa-datasource-property>
    <driver>mysql</driver>
    <security>
      <user-name>admin</user-name>
      <password>admin</password>
    </security>
    <validation>
      <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker"/>
      <validate-on-match>true</validate-on-match>
      <background-validation>false</background-validation>
      <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLExceptionSorter"/>
    </validation>
  </xa-datasource>
  <drivers>
    <driver name="mysql" module="com.mysql">
      <driver-class>com.mysql.jdbc.Driver</driver-class>
      <xa-datasource-class>com.mysql.jdbc.jdbc2.optional.MysqlXADataSource</xa-datasource-class>
    </driver>
  </drivers>
</datasources>

MySQL JDBC Driver module.xml 文件示例

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="com.mysql">
  <resources>
    <resource-root path="mysql-connector-java-5.1.36-bin.jar"/>
  </resources>
  <dependencies>
    <module name="javax.api"/>
    <module name="javax.transaction.api"/>
  </dependencies>
</module>

管理 CLI 命令示例

此示例配置可以通过以下管理 CLI 命令来实现。

这是包含连接信息、基本安全性和验证选项的 PostgreSQL 数据源配置示例。

PostgreSQL 数据源配置示例

<datasources>
  <datasource jndi-name="java:jboss/PostgresDS" pool-name="PostgresDS">
    <connection-url>jdbc:postgresql://localhost:5432/postgresdb</connection-url>
    <driver>postgresql</driver>
    <security>
        <user-name>admin</user-name>
        <password>admin</password>
    </security>
    <validation>
        <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLValidConnectionChecker"/>
        <validate-on-match>true</validate-on-match>
        <background-validation>false</background-validation>
        <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLExceptionSorter"/>
    </validation>
  </datasource>
  <drivers>
    <driver name="postgresql" module="com.postgresql">
        <xa-datasource-class>org.postgresql.xa.PGXADataSource</xa-datasource-class>
    </driver>
  </drivers>
</datasources>

PostgreSQL JDBC Driver module.xml 文件示例

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="com.postgresql">
  <resources>
    <resource-root path="postgresql-9.3-1102.jdbc4.jar"/>
  </resources>
  <dependencies>
    <module name="javax.api"/>
    <module name="javax.transaction.api"/>
  </dependencies>
</module>

管理 CLI 命令示例

此示例配置可以通过以下管理 CLI 命令来实现。

这是带有 XA 数据源属性、基本安全性和验证选项的 PostgreSQL XA 数据源配置示例。

PostgreSQL XA 数据源配置示例

<datasources>
  <xa-datasource jndi-name="java:jboss/PostgresXADS" pool-name="PostgresXADS">
    <xa-datasource-property name="ServerName">
      localhost
    </xa-datasource-property>
    <xa-datasource-property name="PortNumber">
      5432
    </xa-datasource-property>
    <xa-datasource-property name="DatabaseName">
      postgresdb
    </xa-datasource-property>
    <driver>postgresql</driver>
    <security>
      <user-name>admin</user-name>
      <password>admin</password>
    </security>
    <validation>
      <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLValidConnectionChecker"/>
      <validate-on-match>true</validate-on-match>
      <background-validation>false</background-validation>
      <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLExceptionSorter"/>
    </validation>
  </xa-datasource>
  <drivers>
    <driver name="postgresql" module="com.postgresql">
      <xa-datasource-class>org.postgresql.xa.PGXADataSource</xa-datasource-class>
    </driver>
  </drivers>
</datasources>

PostgreSQL JDBC Driver module.xml 文件示例

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="com.postgresql">
  <resources>
    <resource-root path="postgresql-9.3-1102.jdbc4.jar"/>
  </resources>
  <dependencies>
    <module name="javax.api"/>
    <module name="javax.transaction.api"/>
  </dependencies>
</module>

管理 CLI 命令示例

此示例配置可以通过以下管理 CLI 命令来实现。

这是包含连接信息、基本安全性和验证选项的 Oracle 数据源配置示例。

Oracle Datasource 配置示例

<datasources>
  <datasource jndi-name="java:jboss/OracleDS" pool-name="OracleDS">
    <connection-url>jdbc:oracle:thin:@localhost:1521:XE</connection-url>
    <driver>oracle</driver>
    <security>
        <user-name>admin</user-name>
        <password>admin</password>
    </security>
    <validation>
        <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleValidConnectionChecker"/>
        <validate-on-match>true</validate-on-match>
        <background-validation>false</background-validation>
        <stale-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleStaleConnectionChecker"/>
        <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleExceptionSorter"/>
    </validation>
  </datasource>
  <drivers>
    <driver name="oracle" module="com.oracle">
        <xa-datasource-class>oracle.jdbc.xa.client.OracleXADataSource</xa-datasource-class>
    </driver>
  </drivers>
</datasources>

Oracle JDBC Driver module.xml 文件示例

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="com.oracle">
    <resources>
        <resource-root path="ojdbc7.jar"/>
    </resources>
    <dependencies>
        <module name="javax.api"/>
        <module name="javax.transaction.api"/>
    </dependencies>
</module>

管理 CLI 命令示例

此示例配置可以通过以下管理 CLI 命令来实现。

这是带有 XA 数据源属性、基本安全性和验证选项的 Oracle XA 数据源配置示例。

Oracle XA 数据源配置示例

<datasources>
  <xa-datasource jndi-name="java:jboss/OracleXADS" pool-name="OracleXADS">
    <xa-datasource-property name="URL">
      jdbc:oracle:thin:@oracleHostName:1521:orcl
    </xa-datasource-property>
    <driver>oracle</driver>
    <xa-pool>
      <is-same-rm-override>false</is-same-rm-override>
    </xa-pool>
    <security>
      <user-name>admin</user-name>
      <password>admin</password>
    </security>
    <validation>
      <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleValidConnectionChecker"/>
      <validate-on-match>true</validate-on-match>
      <background-validation>false</background-validation>
      <stale-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleStaleConnectionChecker"/>
      <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleExceptionSorter"/>
    </validation>
  </xa-datasource>
  <drivers>
    <driver name="oracle" module="com.oracle">
      <xa-datasource-class>oracle.jdbc.xa.client.OracleXADataSource</xa-datasource-class>
    </driver>
  </drivers>
</datasources>

Oracle JDBC Driver module.xml 文件示例

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="com.oracle">
    <resources>
        <resource-root path="ojdbc7.jar"/>
    </resources>
    <dependencies>
        <module name="javax.api"/>
        <module name="javax.transaction.api"/>
    </dependencies>
</module>

管理 CLI 命令示例

此示例配置可以通过以下管理 CLI 命令来实现。

这是带有连接信息、基本安全性和验证选项的 Microsoft SQL Server 数据源配置示例。

Microsoft SQL Server 数据源配置示例

<datasources>
  <datasource jndi-name="java:jboss/MSSQLDS" pool-name="MSSQLDS">
    <connection-url>jdbc:sqlserver://localhost:1433;DatabaseName=MyDatabase</connection-url>
    <driver>sqlserver</driver>
    <security>
      <user-name>admin</user-name>
      <password>admin</password>
    </security>
    <validation>
      <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLValidConnectionChecker"/>
      <validate-on-match>true</validate-on-match>
      <background-validation>false</background-validation>
      <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLExceptionSorter"/>
    </validation>
  </datasource>
  <drivers>
    <driver name="sqlserver" module="com.microsoft">
      <xa-datasource-class>com.microsoft.sqlserver.jdbc.SQLServerXADataSource</xa-datasource-class>
    </driver>
  </drivers>
</datasources>

Microsoft SQL Server JDBC 驱动程序 module.xml 文件示例

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="com.microsoft">
  <resources>
    <resource-root path="sqljdbc41.jar"/>
  </resources>
  <dependencies>
    <module name="javax.api"/>
    <module name="javax.transaction.api"/>
  </dependencies>
</module>

管理 CLI 命令示例

此示例配置可以通过以下管理 CLI 命令来实现。

这是带有 XA 数据源属性、基本安全性和验证选项的 Microsoft SQL Server XA 数据源配置的示例。

Microsoft SQL Server XA 数据源配置示例

<datasources>
  <xa-datasource jndi-name="java:jboss/MSSQLXADS" pool-name="MSSQLXADS">
    <xa-datasource-property name="ServerName">
      localhost
    </xa-datasource-property>
    <xa-datasource-property name="DatabaseName">
      mssqldb
    </xa-datasource-property>
    <xa-datasource-property name="SelectMethod">
      cursor
    </xa-datasource-property>
    <driver>sqlserver</driver>
    <xa-pool>
      <is-same-rm-override>false</is-same-rm-override>
    </xa-pool>
    <security>
      <user-name>admin</user-name>
      <password>admin</password>
    </security>
    <validation>
      <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLValidConnectionChecker"/>
      <validate-on-match>true</validate-on-match>
      <background-validation>false</background-validation>
      <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLExceptionSorter"/>
    </validation>
  </xa-datasource>
  <drivers>
    <driver name="sqlserver" module="com.microsoft">
      <xa-datasource-class>com.microsoft.sqlserver.jdbc.SQLServerXADataSource</xa-datasource-class>
    </driver>
  </drivers>
</datasources>

Microsoft SQL Server JDBC 驱动程序 module.xml 文件示例

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="com.microsoft">
  <resources>
    <resource-root path="sqljdbc41.jar"/>
  </resources>
  <dependencies>
    <module name="javax.api"/>
    <module name="javax.transaction.api"/>
  </dependencies>
</module>

管理 CLI 命令示例

此示例配置可以通过以下管理 CLI 命令来实现。

这是带有连接信息、基本安全性和验证选项的 IBM DB2 数据源配置示例。

IBM DB2 数据源配置示例

<datasources>
  <datasource jndi-name="java:jboss/DB2DS" pool-name="DB2DS">
    <connection-url>jdbc:db2://localhost:50000/ibmdb2db</connection-url>
    <driver>ibmdb2</driver>
    <pool>
      <min-pool-size>0</min-pool-size>
      <max-pool-size>50</max-pool-size>
    </pool>
    <security>
      <user-name>admin</user-name>
      <password>admin</password>
    </security>
    <validation>
      <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.db2.DB2ValidConnectionChecker"/>
      <validate-on-match>true</validate-on-match>
      <background-validation>false</background-validation>
      <stale-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.db2.DB2StaleConnectionChecker"/>
      <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.db2.DB2ExceptionSorter"/>
    </validation>
  </datasource>
  <drivers>
    <driver name="ibmdb2" module="com.ibm">
        <xa-datasource-class>com.ibm.db2.jcc.DB2XADataSource</xa-datasource-class>
    </driver>
  </drivers>
</datasources>

IBM DB2 JDBC 驱动程序 module.xml 文件示例

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="com.ibm">
  <resources>
    <resource-root path="db2jcc4.jar"/>
  </resources>
  <dependencies>
    <module name="javax.api"/>
    <module name="javax.transaction.api"/>
  </dependencies>
</module>

管理 CLI 命令示例

此示例配置可以通过以下管理 CLI 命令来实现。

这是使用 XA 数据源属性、基本安全性和验证选项的 IBM DB2 XA 数据源配置的示例。

IBM DB2 XA 数据源配置示例

<datasources>
  <xa-datasource jndi-name="java:jboss/DB2XADS" pool-name="DB2XADS">
    <xa-datasource-property name="ServerName">
      localhost
    </xa-datasource-property>
    <xa-datasource-property name="DatabaseName">
      ibmdb2db
    </xa-datasource-property>
    <xa-datasource-property name="PortNumber">
      50000
    </xa-datasource-property>
    <xa-datasource-property name="DriverType">
      4
    </xa-datasource-property>
    <driver>ibmdb2</driver>
    <xa-pool>
      <is-same-rm-override>false</is-same-rm-override>
    </xa-pool>
    <security>
      <user-name>admin</user-name>
      <password>admin</password>
    </security>
    <recovery>
      <recover-plugin class-name="org.jboss.jca.core.recovery.ConfigurableRecoveryPlugin">
        <config-property name="EnableIsValid">
          false
        </config-property>
        <config-property name="IsValidOverride">
          false
        </config-property>
        <config-property name="EnableClose">
          false
        </config-property>
      </recover-plugin>
    </recovery>
    <validation>
      <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.db2.DB2ValidConnectionChecker"/>
      <validate-on-match>true</validate-on-match>
      <background-validation>false</background-validation>
      <stale-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.db2.DB2StaleConnectionChecker"/>
      <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.db2.DB2ExceptionSorter"/>
    </validation>
  </xa-datasource>
  <drivers>
    <driver name="ibmdb2" module="com.ibm">
        <xa-datasource-class>com.ibm.db2.jcc.DB2XADataSource</xa-datasource-class>
    </driver>
  </drivers>
</datasources>

IBM DB2 JDBC 驱动程序 module.xml 文件示例

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="com.ibm">
  <resources>
    <resource-root path="db2jcc4.jar"/>
  </resources>
  <dependencies>
    <module name="javax.api"/>
    <module name="javax.transaction.api"/>
  </dependencies>
</module>

管理 CLI 命令示例

此示例配置可以通过以下管理 CLI 命令来实现。

这是包含连接信息、基本安全性和验证选项的 Sybase 数据源配置示例。

Sybase Datasource 配置示例

<datasources>
  <datasource jndi-name="java:jboss/SybaseDB" pool-name="SybaseDB">
    <connection-url>jdbc:sybase:Tds:localhost:5000/DATABASE?JCONNECT_VERSION=6</connection-url>
    <driver>sybase</driver>
    <security>
      <user-name>admin</user-name>
      <password>admin</password>
    </security>
    <validation>
      <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.sybase.SybaseValidConnectionChecker"/>
      <validate-on-match>true</validate-on-match>
      <background-validation>false</background-validation>
      <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.sybase.SybaseExceptionSorter"/>
    </validation>
  </datasource>
  <drivers>
    <driver name="sybase" module="com.sybase">
      <xa-datasource-class>com.sybase.jdbc4.jdbc.SybXADataSource</xa-datasource-class>
    </driver>
  </drivers>
</datasources>

Sybase JDBC Driver module.xml 文件示例

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="com.sybase">
    <resources>
      <resource-root path="jconn4.jar"/>
    </resources>
    <dependencies>
      <module name="javax.api"/>
      <module name="javax.transaction.api"/>
    </dependencies>
</module>

管理 CLI 命令示例

此示例配置可以通过以下管理 CLI 命令来实现。

这是使用 XA 数据源属性、基本安全性和验证选项的 Sybase XA 数据源配置示例。

Sybase XA Datasource 配置示例

<datasources>
  <xa-datasource jndi-name="java:jboss/SybaseXADS" pool-name="SybaseXADS">
    <xa-datasource-property name="ServerName">
      localhost
    </xa-datasource-property>
    <xa-datasource-property name="DatabaseName">
      mydatabase
    </xa-datasource-property>
    <xa-datasource-property name="PortNumber">
      4100
    </xa-datasource-property>
    <xa-datasource-property name="NetworkProtocol">
      Tds
    </xa-datasource-property>
    <driver>sybase</driver>
    <xa-pool>
      <is-same-rm-override>false</is-same-rm-override>
    </xa-pool>
    <security>
      <user-name>admin</user-name>
      <password>admin</password>
    </security>
    <validation>
      <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.sybase.SybaseValidConnectionChecker"/>
      <validate-on-match>true</validate-on-match>
      <background-validation>false</background-validation>
      <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.sybase.SybaseExceptionSorter"/>
    </validation>
  </xa-datasource>
  <drivers>
    <driver name="sybase" module="com.sybase">
      <xa-datasource-class>com.sybase.jdbc4.jdbc.SybXADataSource</xa-datasource-class>
    </driver>
  </drivers>
</datasources>

Sybase JDBC Driver module.xml 文件示例

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="com.sybase">
    <resources>
      <resource-root path="jconn4.jar"/>
    </resources>
    <dependencies>
      <module name="javax.api"/>
      <module name="javax.transaction.api"/>
    </dependencies>
</module>

管理 CLI 命令示例

此示例配置可以通过以下管理 CLI 命令来实现。

这是包含连接信息、基本安全性和验证选项的 MariaDB 数据源配置示例。

MariaDB 数据源配置示例

<datasources>
  <datasource jndi-name="java:jboss/MariaDBDS" pool-name="MariaDBDS">
    <connection-url>jdbc:mariadb://localhost:3306/jbossdb</connection-url>
    <driver>mariadb</driver>
    <security>
      <user-name>admin</user-name>
      <password>admin</password>
    </security>
    <validation>
      <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker"/>
      <validate-on-match>true</validate-on-match>
      <background-validation>false</background-validation>
      <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLExceptionSorter"/>
    </validation>
  </datasource>
  <drivers>
    <driver name="mariadb" module="org.mariadb">
      <driver-class>org.mariadb.jdbc.Driver</driver-class>
      <xa-datasource-class>org.mariadb.jdbc.MySQLDataSource</xa-datasource-class>
    </driver>
  </drivers>
</datasources>

MariaDB JDBC 驱动程序 module.xml 文件示例

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="org.mariadb">
  <resources>
    <resource-root path="mariadb-java-client-1.2.3.jar"/>
  </resources>
  <dependencies>
    <module name="javax.api"/>
    <module name="javax.transaction.api"/>
  </dependencies>
</module>

管理 CLI 命令示例

此示例配置可以通过以下管理 CLI 命令来实现。

这是带有 XA 数据源属性、基本安全性和验证选项的 MariaDB XA 数据源配置示例。

MariaDB XA 数据源配置示例

<datasources>
  <xa-datasource jndi-name="java:jboss/MariaDBXADS" pool-name="MariaDBXADS">
    <xa-datasource-property name="ServerName">
      localhost
    </xa-datasource-property>
    <xa-datasource-property name="DatabaseName">
      mariadbdb
    </xa-datasource-property>
    <driver>mariadb</driver>
    <security>
      <user-name>admin</user-name>
      <password>admin</password>
    </security>
    <validation>
      <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker"/>
      <validate-on-match>true</validate-on-match>
      <background-validation>false</background-validation>
      <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLExceptionSorter"/>
    </validation>
  </xa-datasource>
  <drivers>
    <driver name="mariadb" module="org.mariadb">
      <driver-class>org.mariadb.jdbc.Driver</driver-class>
      <xa-datasource-class>org.mariadb.jdbc.MySQLDataSource</xa-datasource-class>
    </driver>
  </drivers>
</datasources>

MariaDB JDBC 驱动程序 module.xml 文件示例

<?xml version="1.0" ?>
<module xmlns="urn:jboss:module:1.1" name="org.mariadb">
  <resources>
    <resource-root path="mariadb-java-client-1.2.3.jar"/>
  </resources>
  <dependencies>
    <module name="javax.api"/>
    <module name="javax.transaction.api"/>
  </dependencies>
</module>

管理 CLI 命令示例

此示例配置可以通过以下管理 CLI 命令来实现。

您可以使用基于 Web 的管理控制台或命令行管理 CLI 配置事务管理器。

使用管理控制台配置事务管理器

以下步骤解释了如何使用基于 Web 的管理控制台配置事务管理器：

使用管理 CLI 配置事务管理器

使用管理 CLI，您可以使用一系列命令配置事务管理器。对于单机服务器，所有命令都以 /subsystem=transactions 开头，对于受管域中默认配置集，都以 /profile= default /subsystem=transactions/ 开头。

有关所有事务管理器配置选项的详细列表，请参阅 JBoss EAP 的 Transaction Manager 配置选项。

此任务演示了如何在数据源上启用 Java Transaction API (JTA)。

先决条件

将数据源配置为使用 Java Transaction API

您的数据源现在配置为使用 JTA。

您可以跟踪事务状态，同时将 DEBUG 日志级别用于事务日志记录器来保持日志文件可读。若要进行详细的调试，请使用 TRACE 日志级别。有关配置事务日志记录器的信息 ，请参阅为 Transactions subsystem 配置 日志记录。

当配置为登录 TRACE 日志级别时，事务管理器(TM)可以生成大量日志信息。以下是一些最常见的消息。此列表不全面，因此您可能看到它们以外的消息。

您可以控制记录事务的信息量，独立于 JBoss EAP 中的其他日志记录设置。您可以使用管理控制台或管理 CLI 配置日志设置。

使用管理控制台配置事务日志

使用管理 CLI 配置事务日志

使用以下命令，从管理 CLI 设置日志级别。对于单机服务器，请从命令中删除 /profile=default。

/profile=default/subsystem=logging/logger=com.arjuna:write-attribute(name=level,value=VALUE)