JBoss EAP 7 引入了 suspend 模式，它优雅地挂起服务器操作。这允许所有活动请求正常地完成，但不会接受新的请求。一旦服务器被挂起，它可以关闭、返回运行状态或保持在挂起状态以进行维护。

服务器可以用管理控制台或 CLI 挂起或恢复运行。

检查服务器的挂起状态

服务器的挂起状态可以用下列管理 CLI 命令查看。结果将是 RUNNING、PRE_SUSPEND、SUSPENDING 或 SUSPENDED 中的一个。

挂起

使用下列管理 CLI 命令来挂起服务器，指定服务器等待活动请求完成的超时时间（秒）。其默认值是 0，表示将立即挂起。-1 将让服务器无限期地等待直至所有活动请求完成为止。

以下示例中，在挂起前最多等待 60 秒让请求完成。

恢复

在相应级别（服务器、服务器组、整个域）中执行 resume 命令，服务器可以返回正常的运行状态来接受新的请求。例如：

: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 服务属性

本节向您展示如何配置 RPM 服务属性和其他的启动选项。请注意，在进行修改之前，我们建议您先备份配置文件。

关于 RPM 安装的所有可用的启动选项，请参考 RPM 服务配置属性章节。

停止 JBoss EAP 的 RPM 安装的命令取决于您启动的操作模式（独立服务器或受管域），以及您运行的 Red Hat Enterprise Linux 的版本。

停止作为独立服务器的 JBoss EAP （RPM 安装方式）

停止受管域里的 JBoss EAP（RPM 安装方式）

关于 RPM 安装的所有可用的启动选项，请参考 RPM 服务配置文件章节。

您也可以传入参数到 add-user 脚本非交互式地创建用户。我们不推荐在共享系统上使用这个方法，因为在日志和历史记录文件里可以看到密码。详情请参考非交互式地运行 Add-User 工具。

您可以在命令行传入参数，非交互式地运行 add-user 脚本。但最少您得提供用户名和密码。

创建属于多个组的用户

下列命令添加了一个管理用户（mgmtuser1）和 guest、mgmtgroup 组。

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

指定替代的属性文件

在默认情况下，用 add-user 脚本创建的用户和组信息保存在位于服务器 configuration 目录下的属性文件里。

用户信息保存在下列属性文件里：

组信息保存在下列属性文件里：

这些默认的目录和属性文件名可以被覆盖。下列命令添加了一个新的用户，指定不同的名称和用户属性文件的位置。

$ 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 文件里可以配置的其他密码要求：

管理命令行接口（Management Command-line Interface，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

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

使用管理控制台来启动和停止服务器、部署和卸载应用程序、调优系统设置、永久地修改服务器配置文件。管理控制台也可以执行管理性任务，在当前用户进行的修改需要服务器实例重启或重载时发出即时通知。

在受管域里，相同域里的服务器实例和服务器组都可以通过域控制器的管理控制台集中管理。

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

管理控制台提供下列标签页来导航和管理您的 JBoss EAP 独立服务器或受管域。

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

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

The standalone configuration files are located in the EAP_HOME/standalone/configuration/ directory. A separate file exists for each of the four predefined profiles (default, 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 命令。您可以用 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>

用下列命令将 JBoss 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 子系统里有几个标记（flag）用来控制是否应用属性替换。

JBoss 专有的描述符替换是由 jboss-descriptor-property-replacement 标记控制的，它默认为 enabled。在启用后，属性可以在下列部署描述符里进行替换：

下列管理 CLI 命令可以用来启用或禁用 JBoss 专有描述符里的属性替换：

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

Java EE 描述符替换是由 spec-descriptor-property-replacement 标记控制的，它默认为 enabled。在启用后，属性可以在下列部署描述符里进行替换：

下列管理 CLI 命令可以用来启用或禁用 Java EE 描述符里的属性替换：

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

您可以覆盖以 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: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 属性指定如何组织子目录。目录可以根据服务器或类型来分组。在默认情况下，目录是按服务器分组的。

按服务器进行目录分组

在默认情况下，目录是按服务器分组的。如果您的管理是以服务器为中心（server-centric） 的，我们推荐使用这种配置。例如，它允许对每个服务器实例配置备份和日志文件处理。

如果 JBoss EAP 是用 ZIP 方式安装的，其默认的目录结构（按服务器分组）将是这样的：

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>

按类型进行目录分组

除了按服务器分组，您也可以按文件类型分组。如果您的管理是以文件类型为中心的（file type-centric），我们推荐这种配置，它允许您轻易地只备份数据文件。

如果 JBoss EAP 是用 ZIP 方式安装且域的文件是按类型分组的，那它的目录结构将是这样的：

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 命令取决于 JBoss EAP 是作为独立服务器还是受管域运行的。关于文件处理程序的属性，请参考管理审计日志属性。

要设立 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 服务器的日志则最好使用 Syslog 查看器来查看。

审计日志条目以 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

或者，您可以在命令行里使用 -b 参数。关于服务器启动选项的更多信息，请参考服务器运行时参数。

网络接口通过指定一个逻辑名和物理接口选择条件进行声明。选择条件可以包括一个使用通配符的地址，也可以指定一组字符，只有包括这些字符的接口或地址才可以被有效匹配。如需了解选择条件的网站列表，请参阅接口属性项。

接口可以通过管理控制台或管理 CLI 进行配置。以下是添加和更新接口的一些示例。管理 CLI 命令被首先显示，接下来是相应的配置 XML。

添加带有 NIC 值的接口

添加具有 eth0 NIC 值的新接口。

/interface=external:add(nic=eth0)

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

添加带有几个条件值的接口

添加一个新的网络接口，这个接口的匹配条件是：在特定子网中、已在线、支持多点传送，并且不是点对点的。

/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 对于原生管理（被管理 CLI 使用）和 HTTP 管理（被基于 Web 的管理控制台使用）使用端口 9990。在 JBoss EAP 6 里用于原生管理端口的 9999 不再使用，但仍可以在需要时启用。

如果管理控制台启用了 HTTPS，那默认情况下端口 9993 将被使用。

JBoss EAP ships with a socket binding group for each of the four predefined profiles (default, ha, full, full-ha).

关于默认套接字绑定的详细信息，如默认端口和描述，请参考默认套接字绑定章节。

独立服务器

在运行为独立服务器时，每个配置文件都只定义一个套接字绑定组。每个独立配置文件（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>

受管域

When running in a managed domain, all socket binding groups are defined in the domain.xml file. There are four predefined socket binding groups:

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

<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。关于全部的可用套接字绑定属性，请参考套接字绑定属性章节。

套接字绑定可用管理控制台或管理 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 里使用 deploy -l 命令来列出所有部署。

deploy -l

输出即将显示每个部署的细节，如运行时名称和是否已启用。

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

部署应用程序

在管理 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 里使用 deploy -l 命令来列出所有部署。

deploy -l

输出将列出每个部署及其运行时名称。

NAME                    RUNTIME-NAME
test-application.war    test-application.war
jboss-helloworld.war    jboss-helloworld.war

您可以在管理控制台的 Deployments 标签页里查看和管理部署。

部署应用程序

点 Add 按钮，使用 New Deployment 引导程序部署一个应用程序。您可以通过上传一个部署或创建一个未被管理的部署来对应用程序进行部署。部署在默认情况下被启用。

卸载应用程序

选择部署并选择 Remove 选项来卸载应用程序。这会卸载部署，并把它从内容仓库中删除。

禁用应用程序

选择部署并选择 Disable 选项来禁用应用程序。这会卸载部署，但不会从内容仓库中删除它。

替换一个应用程序

选择部署并选择 Replace 选项。选一个新版本的部署，这个新 部署需要和原来的部署有相同的名字，点 Finish。这会卸载并删除原来的部署版本，然后部署新的版本。

在 JBoss EAP 管理控制台的 Deployments 标签页中可以查看和管理部署：

部署应用程序

通过从 Server Groups 里添加部署，您可以在一个步骤里添加、分配和启用部署。

为服务器组分配一个应用程序

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

通过选择 Content Repository 里的 Unassign 按钮，您也可以立即从多个服务器里取消分配。

卸载应用程序

这会卸载部署，并把它从内容仓库中删除。

禁用应用程序

这会卸载部署，但不会把它从内容仓库中删除。

替换一个应用程序

这会卸载并删除原来的部署，然后部署新的版本。

部署扫描器可以被配置为启用或禁用自动部署 XML、zipped 和 exploded 的内容。如果自动部署被禁用，您需要手动创建 marker 文件来触发部署操作。如需了解更多与可用的 marker 文件类型以及它们的作用相关的内容，请参阅 Deployment Scanner Marker Files 一节。

在默认情况下，自动部署 XML 和 zipped 内容是被启用的。如需了解为每类内容配置自动部署的内容，请参阅 Configure the Deployment Scanner。

部署应用程序

复制内容至 deployment 文件夹。

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

如果启用了自动部署，这个文件将被自动提取和部署，且会创建一个 .deployed marker 文件。如果没有启用自动部署，您需要手动添加 .dodeploy marker 文件来触发部署。

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

卸载应用程序

删除 .deployed marker 文件将触发卸载。

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

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

重部署应用程序

创建 .dodeploy marker 文件来初始化重部署。

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

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

关于所有可用的部署扫描器属性的细节，请参考部署扫描器属性章节。

使用下列管理 CLI 命令来配置默认的部署扫描器。

禁用部署扫描器

/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 毫秒（5 秒）更新为 10000 毫秒（10 秒）。

修改部署文件夹

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

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

path 值将作为绝对路径对待，除非指定了 relative-to 属性。

启用展开内容的自动部署

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

这启用了展开内容的自动部署（默认是禁用的）。

禁用压缩内容的自动部署

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

这禁用了压缩内容的自动部署（默认是启用的）。

禁用 XML 内容的自动部署

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

这禁用了 XML 内容的自动部署（默认是启用的）。

您可以通过使用管理 CLI， 或使用管理控制台的 Configuration 标签页中的 Deployment Scanners 子系统来添加一个新的部署扫描器。这会定义一个新的目录用于部署扫描。默认的部署扫描器会监测 EAP_HOME/standalone/deployments。如需了解如何配置一个存在的部署扫描器的信息，请参阅 Configure the 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 quickstart。

如需了解更多与 JBoss EAP quickstarts 相关的内容，请参阅 JBoss EAP Getting Started Guide 中的 Using the Quickstart Examples。

部署应用程序

在 Maven pom.xml 文件中初始 the WildFly Maven Plugin。这应该已在 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 quickstart。

如需了解更多与 JBoss EAP quickstarts 相关的内容，请参阅 JBoss EAP Getting Started Guide 中的 Using the Quickstart Examples。

部署应用程序

当在受管域中部署一个应用程序时，您需要指定这个应用程序要部署的服务器组。这会在 Maven pom.xml 文件中配置。

以下是 pom.xml 中的配置，它初始 WildFly Maven Plugin 并指定 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")

您可以为 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>

这确保了 framework.ear 在 app.ear 之前被部署。

使用部署覆盖（deployment overlay）可以在不物理修改部署归档内容的情况下覆盖一个存在的部署内容。您可以使用它来在运行时覆盖部署描述符、JAR 文件、类、JSP 页，以及其它文件，而不需要重新构建归档。

通过使用部署覆盖，可以在为一个有不同配置或设置的环境进行部署时进行相应的改变。例如，在应用程序生命周期的不同阶段（开发、测试、预生产、生产）进行部署时，您可以需要交换部署描述符、修改静态 web 资源来改变应用程序的品牌设置、或根据不同的目标环境使用不同版本的 JAR 库。另外，这个功能在一个安装需要修改配置，但因为策略或安全限制的原因而无法改变归档的情况下非常有用。

在定义一个部署覆盖时，您可以指定文件系统中的一个文件来替换部署归档中的文件。您还需要指定哪个部署会受到这个部署覆盖的影响。任何受影响的部署都需要被重新部署来使改变生效。

使用 deployment-overlay add 管理 CLI 命令来添加部署覆盖。

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

创建之后，您可以在现有的覆盖里添加内容、链接覆盖至部署或删除覆盖。关于完整的用法，请执行 deployment-overlay --help。

当使用管理 CLI 部署应用程序时，需要指定操作的头数据（header）来控制部署操作要如何执行。使用 --headers 参数可以把以下操作的头数据传递给 deploy 命令。

例如：

deploy /path/to/deployment.war --headers={allow-resource-service-restart=true}

使用分号（;）来隔离多个操作头部。

关于 Rollout 计划

在一个受管域中，针对于域或主机一级资源的操作可能会对多个服务器产生影响。这些操作可以包括一个执行计划，它指定了操作应用到服务器的顺序，以及当操作在一些服务器上执行失败时操作是否需要被复原。 如果没有指定执行计划，默认的运行计划会被使用。

以下是一个涉及到 5 个服务器组的 rollout 计划示例。操作可以按顺序在服务器组中应用（in-series）或同时应用（concurrent-groups）。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"
}}}

在上面的示例中，对域中的服务器应用操作分为 3 个阶段。如果任何一个服务器组的策略触发了一个回滚操作，则所有其它服务器组都会回滚。

Rollout 计划语法

您可以以下列方式之一指定 Rollout 计划。

虽然每个方法都具有不同的初始命令，两者都使用 rollout 操作头部来定义 Rollout 计划。它使用了下列语法。

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

用 Rollout 计划进行部署

您可以通过在 deploy 命令的 headers 参数中使用 rollout 设置来为它直接提供一个 rollout 计划的详细信息。如需了解更多相关信息，请参阅 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 计划详情。

删除一个保存的 rollout 计划

您可以在 rollout-plan 管理 CLI 命令中使用 rollout 计划的名称来删除它。

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

默认的 Rollout 计划

所有影响多个服务器的操作都将用 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 文件中。您可以在 EAP_HOME/bin/domain.conf 文件中使用 PROCESS_CONTROLLER_JAVA_OPTS 变量为进程控制器设置 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>
  <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> 项进行配置的。

<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

关于域控制器发现的详情，请参考域控制器的发现和故障转移章节。

根据域设置，您可能会需要提供一个身份验证机制来使域控制器可以验证主机控制器。如需了解使用一个密码的值产生一个管理用户并使用这个值更新主机控制器配置的信息，请参阅在两台机器上设立受管域。

<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 中，每个主机控制器都可以配置多个选项来查找域控制器。主机控制器会尝试使用每个选项，直到可以成功联系到域控制器。

因此，主机控制器可以预配置一个备份域控制器的联系信息。当主域控制器出现问题时，一个备份域控制器就可以被升级为主域控制器，从而使主机控制器可以自动切换到新的域控制器。

下面是如何用多个选项配置主机控制器来寻找域控制器的例子。

<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 或管理控制台的 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 或管理控制台的 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 使用配置集（Profile）来设置服务器可用的子系统。配置集由可用子系统的集合以及每个子系统的专有配置组成。带有大量子系统的配置集可以让服务器具有强大的功能集合；而带有少量专有子系统的配置集则使得服务器功能较少，但消耗的资源也较少。

JBoss EAP comes with four predefined profiles that should satisfy most use cases:

当现有的配置集不能提供必要的功能时，JBoss EAP 也提供了定义自定义配置集的能力。

JBoss EAP 允许您通过克隆现有的配置集在受管域里创建新的配置集。这将创建原始配置集的配置和子系统的备份。

配置集可以用管理 CLI 或 clone 操作进行克隆。

/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 附带一个 default JVM 设置，但下面的管理 CLI 命令演示了创建名为 production_jvm 的带有一些自定义 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 并点击要编辑的主机上的 JVM。

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

当创建服务器组时，您可以指定组里所有服务器将使用的 JVM 配置。下面的管理 CLI 命令演示了创建名为 groupA 的服务器组，它使用之前例子里展示的 production_jvm JVM 设置。

/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 来编辑服务器组。

这些服务器组的设置保存在 domain.xml 里。

在默认情况下，单独的服务器实例将从所属的服务器组继承 JVM 设置。然而，您可以选择用主机控制器的其他完整 JVM 设置覆盖继承的设置，或者选择覆盖具体的 JVM 设置。

例如，下面的命令覆盖了之前例子里的服务器组的 JVM 定义，并把 server-one 的 JVM 设置设为 default 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 来编辑服务器。

这些单独服务器的设置保存在 host.xml 里。

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

这个文件通常被称为服务器日志。详情请参考 Root Logger 一节。

在引导期间，JBoss EAP 记录关于 Java 环境和每个服务启动的日志信息。这个日志可用于故障解除。在默认情况下，所有的日志条目都被写入 server log。

引导日志配置是在 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 JDK 以外，垃圾收集日志会在所有支持的环境中的 JBoss EAP 独立服务器上默认启用。

垃圾收集日志的默认位置是 EAP_HOME/standalone/log/gc.log.DIGIT.current。在默认情况下，垃圾收集日志的每个文件的大小被限制为 3MB，最多 5 个文件进行轮换。

下面的日志文件是为默认的日志配置创建的。默认的配置使用 periodic 日志处理程序写入服务器日志文件。

You can configure the default locale for JBoss EAP by setting JVM properties in the appropriate startup configuration file. The startup configuration file is EAP_HOME/bin/standalone.conf for a standalone server or EAP_HOME/bin/domain.conf for a managed domain.

Log messages that have been internationalized and localized will use this default locale. See the JBoss EAP Development Guide for information on creating internationalized log messages.

Set the Language

Specify the language by setting the user.language property using the JAVA_OPTS variable. For example, add the following line to the startup configuration file to set a French locale.

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

Log messages that have been internationalized and localized will now output in French.

Set the Language and Country

In addition to the language, it may also be necessary to specify the country by setting the user.country property. For example, add the following line to the startup configuration file to set the Portuguese locale for Brazil.

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

Log messages that have been internationalized and localized will now output in Brazilian Portuguese.

JBoss EAP 的 Root logger 抓取所有发送到服务器上的、没有被任何日志类别抓取的日志消息（等于或高于特定级别）。

在默认情况下，Root logger 会被配置成使用控制台或定期日志处理程序。定期日志处理程序写入到 server.log 文件，这个文件通常被称为服务器日志。

关于更多的信息，请参考配置 Root Logger。

日志类别定义要捕获的一系列日志信息以及处理这些信息的一个或多个日志处理程序。

要捕获的日志信息是通过原始 Java 软件包和日志级别来指定的。来自该软件包里的类和日志级别的信息将被日志类别捕获并发送至指定的日志处理程序。

日志类别也可以选择使用 Root Logger 而不是自己的日志处理程序。

详情请参考配置日志类别。

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

日志处理程序类型

关于配置这些日志处理程序的细节，请参考配置日志处理程序章节。

日志级别是一个枚举值，它表示日志信息的性质和严重性。作为开发人员，您可以使用所选日志框架的相关方法指定日志级别来发送信息。

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

日志类别和处理程序使用日志级别来限制它们负责的日志信息。每个日志级别都有一个分配的数字值，指示其相对其他日志级别的顺序。日志类别和处理程序都分配一个日志级别，它们只处理该级别及高于该级别的日志信息。例如，具有 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 或处理程序里包含过滤器，但 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 开发指南》里的『隐性的模块依赖关系』章节。 #1635;

本节展示了如何用管理 CLI 配置 Console 日志处理程序。您也可以用管理控制台配置 Console 日志处理程序，您可以先从 Configuration 标签页进入 Logging 子系统，然后选择 Handler 标签页，并从左侧的菜单选择 Console 。

配置 Console 日志处理程序时要执行的主要任务是：

添加控制台日志处理程序

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

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

根据具体要求，您可能需要设置一个或多个 Console 日志处理程序属性。关于 Console 日志处理程序属性及其描述的完整列表，请参考 Console 日志处理程序属性。

分配 Console 日志处理程序给 Logger

要激活日志处理程序，您必须将其分配给一个 Logger。

下面的管理 CLI 命令将 Console 日志处理程序分配给 Root Logger。

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

下面的管理 CLI 命令将 Console 日志处理程序分配给名称由 CATEGORY 指定的 Logger。

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

删除 Console 日志处理程序

日志处理程序可以用 remove 操作删除。如果日志处理程序目前分配给了 logger 或异步日志处理程序，它就无法被删除。

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

本节展示了如何用管理 CLI 配置 File 日志处理程序。您也可以用管理控制台配置 File 日志处理程序，您可以先从 Configuration 标签页进入 Logging 子系统，然后选择 Handler 标签页，并从左侧的菜单选择 File 。

配置 File 日志处理程序时要执行的主要任务是：

添加 File 日志处理程序

在添加 File 日志处理程序时，您必须用 file 属性指定文件路径，它由 path 和 relative-to 属性组成。请使用 path 属性来设置日志的文件路径，其中包括名称，例如 my-log.log。您也可以选择 relative-to 属性来设置 path 为相对路径，例如 jboss.server.log.dir。

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

配置 File 日志处理程序设置

根据具体要求，您可能需要设置一个或多个 File 日志处理程序属性。关于 File 日志处理程序属性及其描述的完整列表，请参考 File 日志处理程序属性。

分配 File 日志处理程序给 Logger

要激活日志处理程序，您必须将其分配给一个 Logger。

下面的管理 CLI 命令将 File 日志处理程序分配给 Root Logger。

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

下面的管理 CLI 命令将 File 日志处理程序分配给名称由 CATEGORY 指定的 Logger。

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

删除 File 日志处理程序

日志处理程序可以用 remove 操作删除。如果日志处理程序目前分配给了 logger 或异步日志处理程序，它就无法被删除。

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

本节展示了如何用管理 CLI 配置 Periodic 日志处理程序。您也可以用管理控制台配置 Periodic 日志处理程序，您可以先从 Configuration 标签页进入 Logging 子系统，然后选择 Handler 标签页，并从左侧的菜单选择 Periodic 。

配置 Periodic 日志处理程序时要执行的主要任务是：

添加 Periodic 日志处理程序

在添加 Periodic 日志处理程序时，您必须用 file 属性指定文件路径，它由 path 和 relative-to 属性组成。请使用 path 属性来设置日志的文件路径，其中包括名称，例如 my-log.log。您也可以选择 relative-to 属性来设置 path 为相对路径，例如 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 日志处理程序设置

根据具体要求，您可能需要设置一个或多个 Periodic 日志处理程序属性。关于 Periodic 日志处理程序属性及其描述的完整列表，请参考 Periodic 日志处理程序属性。

分配 Periodic 日志处理程序给 Logger

要激活日志处理程序，您必须将其分配给一个 Logger。

下面的管理 CLI 命令将 Periodic 日志处理程序分配给 Root Logger。

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

下面的管理 CLI 命令将 Periodic 日志处理程序分配给名称由 CATEGORY 指定的 Logger。

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

删除 Periodic 日志处理程序

日志处理程序可以用 remove 操作删除。如果日志处理程序目前分配给了 logger 或异步日志处理程序，它就无法被删除。

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

本节展示了如何用管理 CLI 配置 Size 日志处理程序。您也可以用管理控制台配置 Size 日志处理程序，您可以先从 Configuration 标签页进入 Logging 子系统，然后选择 Handler 标签页，并从左侧的菜单选择 Size 。

配置 Size 日志处理程序时要执行的主要任务是：

添加 Size 日志处理程序

在添加 Size 日志处理程序时，您必须用 file 属性指定文件路径，它由 path 和 relative-to 属性组成。请使用 path 属性来设置日志的文件路径，其中包括名称，例如 my-log.log。您也可以选择 relative-to 属性来设置 path 为相对路径，例如 jboss.server.log.dir。

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

配置 Size 日志处理程序设置

根据具体要求，您可能需要设置一个或多个 Size 日志处理程序属性。关于 Size 日志处理程序属性及其描述的完整列表，请参考 Size 日志处理程序属性。

分配 Size 日志处理程序给 Logger

要激活日志处理程序，您必须将其分配给一个 Logger。

下面的管理 CLI 命令将 Size 日志处理程序分配给 Root Logger。

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

下面的管理 CLI 命令将 Size 日志处理程序分配给名称由 CATEGORY 指定的 Logger。

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

删除 Size 日志处理程序

日志处理程序可以用 remove 操作删除。如果日志处理程序目前分配给了 logger 或异步日志处理程序，它就无法被删除。

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

本节展示了如何用管理 CLI 配置 Periodic Size 日志处理程序。您也可以用管理控制台配置 Periodic Size 日志处理程序，您可以进入 Logging 子系统，然后选择 Handler 标签页，并从左侧的菜单选择 Periodic Size 。

配置 Periodic Size 日志处理程序时要执行的主要任务是：

添加 Periodic Size 日志处理程序

在添加 Periodic Size 日志处理程序时，您必须用 file 属性指定文件路径，它由 path 和 relative-to 属性组成。请使用 path 属性来设置日志的文件路径，其中包括名称，例如 my-log.log。您也可以选择 relative-to 属性来设置 path 为相对路径，例如 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 日志处理程序设置

根据具体要求，您可能需要设置一个或多个 Periodic Size 日志处理程序属性。关于 Periodic Size 日志处理程序属性及其描述的完整列表，请参考 Periodic Size 日志处理程序属性。

分配 Periodic Size 日志处理程序给 Logger

要激活日志处理程序，您必须将其分配给一个 Logger。

下面的管理 CLI 命令将 Periodic Size 日志处理程序分配给 Root Logger。

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

下面的管理 CLI 命令将 Periodic Size 日志处理程序分配给名称由 CATEGORY 指定的 Logger。

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

删除 Periodic Size 日志处理程序

日志处理程序可以用 remove 操作删除。如果日志处理程序目前分配给了 logger 或异步日志处理程序，它就无法被删除。

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

本节展示了如何用管理 CLI 配置 Syslog 处理程序，它可以用来发送消息至支持 Syslog 协议（RFC-3164 或 RFC-5424).）的远程日志服务器。您也可以用管理控制台配置 Syslog 处理程序，您可以先从 Configuration 标签页进入 Logging 子系统，然后选择 Handler 标签页，并从左侧的菜单选择 Syslog 。

配置 Syslog 处理程序时要执行的主要任务是：

添加 Syslog 处理程序

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

配置 Syslog 处理程序设置

根据具体要求，您可能需要设置一个或多个 Syslog 日志处理程序属性。关于 Syslog 日志处理程序属性及其描述的完整列表，请参考 Syslog 处理程序属性。

分配 Syslog 处理程序给 Logger

要激活日志处理程序，您必须将其分配给一个 Logger。

下面的管理 CLI 命令将 Syslog 日志处理程序分配给 Root Logger。

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

下面的管理 CLI 命令将 Syslog 日志处理程序分配给名称由 CATEGORY 指定的 Logger。

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

删除 Syslog 处理程序

日志处理程序可以用 remove 操作删除。如果日志处理程序目前分配给了 logger 或异步日志处理程序，它就无法被删除。

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

本节展示了如何用管理 CLI 配置 custom 日志处理程序。您也可以用管理控制台配置 custom 日志处理程序，您可以先从 Configuration 标签页进入 Logging 子系统，然后选择 Handler 标签页，并从左侧的菜单选择 File 。

配置 Custom 日志处理程序时要执行的主要任务是：

添加 Custom 日志处理程序

在添加 Custom 日志处理程序时，您必须指定处理程序的 Java 类及它所在的 JBoss EAP 模块。这个类必须继承 java.util.logging.Handler。

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

配置 Custom 日志处理程序设置

根据具体要求，您可能需要设置一个或多个 Custom 日志处理程序属性。关于 Custom 日志处理程序属性及其描述的完整列表，请参考 Custom 日志处理程序属性。

分配 Custom 日志处理程序给 Logger

要激活日志处理程序，您必须将其分配给一个 Logger。

下面的管理 CLI 命令将 Custom 日志处理程序分配给 Root Logger。

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

下面的管理 CLI 命令将 Custom 日志处理程序分配给名称由 CATEGORY 指定的 Logger。

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

删除 Custom 日志处理程序

日志处理程序可以用 remove 操作删除。如果日志处理程序目前分配给了 logger 或异步日志处理程序，它就无法被删除。

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

本节展示了如何用管理 CLI 配置 Async 日志处理程序。您也可以用管理控制台配置 Async 日志处理程序，您可以先从 Configuration 标签页进入 Logging 子系统，然后选择 Handler 标签页，并从左侧的菜单选择 Async 。

配置 Async 日志处理程序时要执行的主要任务是：

添加 Async 日志处理程序

当添加 Async 日志处理程序时，您必须指定队列长度。这是可以保持在队列里的日志请求的最大数目。

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

添加子处理程序

您可以添加一个或多个处理程序作为这个 Async 日志处理程序的子处理程序。请注意，这些处理程序必须已存在于配置里，否则这个命令会无法运行。

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

配置 Async 日志处理程序设置

根据具体要求，您可能需要设置一个或多个 Async 日志处理程序属性。关于 Async 日志处理程序属性及其描述的完整列表，请参考 Async 日志处理程序属性。

分配 Async 日志处理程序给 Logger

要激活日志处理程序，您必须将其分配给一个 Logger。

下面的管理 CLI 命令将 Async 日志处理程序分配给 Root Logger。

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

下面的管理 CLI 命令将 Async 日志处理程序分配给名称由 CATEGORY 指定的 Logger。

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

删除 Async 日志处理程序

日志处理程序可以用 remove 操作删除。但如果日志处理程序目前分配给了 logger，它就无法被删除。

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

您可以创建日志处理程序用来格式化日志信息的命名模式格式器。

本节展示了如何用管理 CLI 配置日志格式器。您也可以用管理控制台配置日志格式器，您可以先从 Configuration 标签页进入 Logging 子系统，然后选择 Formatter 标签页，并从左侧的菜单选择 Pattern 。

创建命名格式器

在定义格式器时，您要提供模式字符串来格式化日志消息。关于模式语法的详情，请参考日志格式器。

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

Per-deployment 日志允许开发人员提前为应用程序配置日志。当部署应用程序时，日志按照预先定义的配置进行记录。通过这个配置创建的日志文件只包含和应用程序行为相关的信息。

和使用系统范围的日志功能相比，这个方法有利有弊。它的优点是，JBoss EAP 实例的管理员不需要配置除服务器日志以外的任何日志功能。而缺点是，部署前的日志配置只在启动时可读，因此无法在运行时进行修改。

关于在您的应用程序里使用 per-deployment 日志的说明，请参考《JBoss EAP 部署指南》里的『添加 Per-deployment 日志到应用程序』章节。

日志配置集是独立的日志配置组，它可以分配给部署的应用程序。作为一般的 logging 子系统，日志配置集可以定义 handler、类型以及一个根日志程序，但它无法参考其它配置集或主 logging 子系统的配置。日志配置集的结构和 logging 子系统一样，这样可以减轻配置负担。

日志配置集允许管理员，在不影响其它日志配置的情况下，针对一个或多个应用程序创建日志配置。因为每个配置集都是在服务器配置中定义的，所以可以在不重新部署受影响的应用程序的情况下，修改日志配置。

每个日志配置集可以有：

应用程序可以在它的 MANIFEST.MF 文件里用 Logging-Profile 属性指定一个日志配置集。

/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

部署日志的 configuration 值可以是：

例如，下面的管理 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

如果 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 数据源可以用 data-source add 管理 CLI 命令来定义。您也可以用管理控制台定义非 XA 数据源，请选择 Configuration → Subsystems → Datasources → Non-XA 并点击 Add 打开 Create Datasource 向导。

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

关于详细的例程，请参考数据源配置示例。

数据源参数

关于所有可用的数据源参数的完整列表，请参考数据源参数章节。

XA 数据源可以用 xa-data-source add 管理 CLI 命令来定义。您也可以用管理控制台定义 XA 数据源，请选择 Configuration → Subsystems → Datasources → XA 并点击 Add 打开 Create XA Datasource 向导。

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

关于详细的例程，请参考数据源配置示例。

数据源参数

关于所有可用的数据源参数的完整列表，请参考数据源参数章节。

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

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

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

要使更新生效，必须重新启动服务器。

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

要使更新生效，必须重新启动服务器。

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

data-source remove --name=DATASOURCE_NAME

删除数据源后要求重启服务器。

您可以用 xa-data-source remove 管理 CLI 命令删除 XA 数据源。您可以在管理控制台的 datasources 子系统里删除 XA 数据源。

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 驱动的 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 驱动的 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 数据源配置示例

<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 驱动的 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 驱动的 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 服务器数据源配置示例。

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 数据源配置示例

<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 驱动的 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 数据源配置示例

<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 驱动的 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 配置事务管理者（transaction manager）。

用管理控制台配置事务管理者

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

用管理 CLI 配置事务管理者

通过管理 CLI，您可以用一系列命令来配置事务管理者。对于独立服务器，这些命令以 /subsystem=transactions 开始，而对于受管域里的 default 配置集，则是 /profile=default/subsystem=transactions/。

关于事务管理者配置选项的详细列表，请参考 JBoss EAP 事务管理者配置选项。

这个任务向您展示如何在数据源上启用 Java Transaction API（JTA）。

先决条件

配置数据源使用 JTA

您的数据源现在可以使用 JTA 了。

您可以为事务 Logger 设置 DEBUG 日志级别，使日志文件保持可读来跟踪事务状态。如果需要进行更具体的故障排除，则使用 TRACE 日志级别。关于配置事务 Logger 的信息，请参考配置事务子系统的日志。

当配置为 TRACE 日志级别时，事务管理者（TM）可以生成大量的日志信息。下面是一些常见的信息。这个列表并不完整，所以您也可能会遇到其他的信息。

您可以控制关于事务的日志信息量，这取决于 JBoss EAP 里的其他日志设置。您可以用管理控制台或 CLI 来配置日志设置。

用管理控制台配置事务 Logger

用管理 CLI 配置事务 Logger

在管理 CLI 里使用下列命令来设置日志级别。对于独立服务器，请从命令里删除 /profile=default。

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

管理 CLI 具有浏览和操纵事务记录的功能。这个功能是通过 TM 和 JBoss EAP 的管理 API 进行交互来实现的。

TM 会把每个待定事务及事务的参与者信息存储到一个持久性存储里，这个持久性存储被称为“对象库（object store）”。管理 API 将对象库作为 log-store 资源开放。名为 probe 的 API 操作读取事务日志并为每条记录创建一个节点路径。每当需要刷新 log-store 时，可以手动调用 probe 命令。事务日志快速地显示和消失是正常的。

刷新日志库

这个命令刷新受管域里使用 default 配置集的服务器组的日志库。对于独立服务器，请从命令里删除 profile=default。

/profile=default/subsystem=transactions/log-store=log-store/:probe

查看所有预备的事务

要查看所有预备的事务，首先刷新日志库（请参考刷新日志库），然后运行下列命令（和文件系统的 ls 命令类似）。

ls /profile=default/subsystem=transactions/log-store=log-store/transactions

或者

/host=master/server=server-one/subsystem=transactions/log-store=log-store:read-children-names(child-type=transactions)

显示每个事务，包括其唯一标识符。可以为单独的事务运行单独的操作（请参考管理事务）。

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9:read-resource

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9/participants=java\:\/JmsXA:read-resource

{
   "outcome" => "success",
   "result" => {
       "eis-product-name" => "ActiveMQ",
       "eis-product-version" => "2.0",
       "jndi-name" => "java:/JmsXA",
       "status" => "HEURISTIC",
       "type" => "/StateManager/AbstractRecord/XAResourceRecord"
   }
}

/profile=default/subsystem=transactions/log-store=log-store:write-attribute(name=expose-all-logs, value=true)

/host=master/server=server-one/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9:read-children-names(child-type=participants)

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9:delete

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9/participants=2:recover

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9/participants=2:refresh

如果启用了事务管理者统计，您可以通过事务管理者查看已处理事务的统计信息。关于如何启用事务管理者统计的信息，请参考配置事务管理者。

您可以用管理控制台或管理 CLI 来查看统计信息。在管理控制台里，从 Runtime 标签页的 Transactions 子系统里可以看到事务统计信息。但管理控制台里并没有所有的统计信息。

下表展示了每个可用的统计及其描述。

事务需要一个地方来存储对象。其中一个选择是 JDBC 数据源。与文件库相比，JDBC 接口可以从相同网络上的任何系统上访问数据库。如果您使用文件库，在访问数据库之前磁盘必须共享或迁移。如果考虑到性能，JDBC 对象库可能比文件系统或 ActiveMQ 日志对象库要慢。

将 JDBC 数据源用作事务对象库

按照下列步骤将 JDBC 数据源用作事务对象库。

下表列出所有和 JDBC 对象存储相关的可用属性。