过程 2.1. 将平台服务作为独立服务器启动

1. 对于红帽企业版 Linux。

   运行命令：EAP_HOME/bin/standalone.sh

2. 对于 Microsoft Windows 服务器。

   运行命令：EAP_HOME\bin\standalone.bat

3. 可选：指定其他的参数。

   要查看传入启动脚本的其他参数，请使用 -h 参数。

过程 2.2. 将平台服务作为受管域启动

1. 对于红帽企业版 Linux。

   运行命令: EAP_HOME/bin/domain.sh

2. 对于 Microsoft Windows 服务器。

   运行: EAP_HOME\bin\domain.bat

3. 可选：传递其他参数到启动脚本里。

   请使用 -h 参数来获取传递到启动脚本里的参数列表。

过程 2.3. 使用系统属性配置主机名

1. 打开主机配置文件，如 host.xml。
2. 找到 host 元素，例如：

   <host name="master" xmlns="urn:jboss:domain:1.6">
   

3. 如果有这些内容，请删除 name="HOST_NAME" 属性声明。host 元素应该类似于下面的例子。

   <host xmlns="urn:jboss:domain:1.6">
   

4. 用 -Djboss.host.name 参数启动服务器，例如：

   -Djboss.host.name=HOST_NAME

过程 2.4. 使用专有名称配置主机名

1. 用下列语法启动 JBoss EAP 从主机：

   bin/domain.sh --host-config=HOST_FILE_NAME

   例如：

   bin/domain.sh --host-config=host-slave01.xml

2. 启动管理 CLI。
3. 使用下列语法来替代主机名：

   /host=EXISTING_HOST_NAME:write-attribute(name="name",value=UNIQUE_HOST_NAME)

   例如：

   /host=master:write-attribute(name="name",value="host-slave01")

   你应该看到下面的结果。

    "outcome" => "success"

   这修改了 host-slave01.xml 文件里的 host name 属性：

   <host name="host-slave01" xmlns="urn:jboss:domain:1.6">
   

4. 您必须重新加载使用旧的主机名的服务器配置以完成这个过程。

   reload --host=EXISTING_HOST_NAME

   例如：

   reload --host=master

过程 2.5. 在两台主机上创建受管域

1. 在 Machine 1 上

   1. 使用 add-user.sh 脚本添加管理用户，例如 slave01，让主机可以通过域控制器进行验证。请注意 add-user 输出里的 SECRET_VALUE。
   2. 用 host-master.xml 配置文件启动域，它为指定的域控制器进行了预先配置。
   3. 用 -bmanagement=$IP1 使域控制器对于其他主机可见。

      [$JBOSS_HOME/bin]$ ./domain.sh --host-config=host-master.xml -bmanagement=$IP1

2. 在 Machine 2 上

   1. 用用户凭证更新 $JBOSS_HOME/domain/configuration/host-slave.xml 文件。

      	<?xml version='1.0' encoding='UTF-8'?>
              <host xmlns="urn:jboss:domain:1.6" name="slave01">   
              <!-- add user name here -->
               <management>
                  <security-realms>
                     <security-realm name="ManagementRealm">
                        <server-identities>
                          <secret value="$SECRET_VALUE" />   
                          <!-- use secret value from add-user.sh output-->
                        </server-identities> 
                        ...
      

   2. 启动主机。

      [$JBOSS_HOME/bin]$ ./domain.sh --host-config=host-slave.xml  -Djboss.domain.master.address=$IP1 -b=$IP2

3. 现在我们可以管理域了。

   通过 CLI：

   [$JBOSS_HOME/bin]$ ./jboss-cli.sh -c --controller=$IP1
   

   通过 Web 控制台：

   http://$IP1:9990
   

   访问服务器的索引页：

   http://$IP2:8080/
   http://$IP2:8230/
   

过程 2.6. 用其他配置启动实例

1. 独立服务器

   对于独立服务器，请将配置文件的名称作为 --server-config 参数的选项。配置文件必须位于 EAP_HOME/standalone/configuration/ 目录里，而且您需要指定相对这个目录的路径。

   例 2.1. 在红帽企业版 Linux 里对独立服务器使用其他的配置文件

   [user@host bin]$ ./standalone.sh --server-config=standalone-alternate.xml

   这个例子使用了 EAP_HOME/standalone/configuration/standalone-alternate.xml 配置文件。

   例 2.2. 在 Microsoft Windows 服务器里对独立服务器使用其他的配置文件

   C:\EAP_HOME\bin> standalone.bat --server-config=standalone-alternate.xml

   这个例子使用了 EAP_HOME\standalone\configuration\standalone-alternative.xml 配置文件。

2. 受管域

   对于受管域，请为 --domain-config 参数提供配置文件的名称。这个文件必须位于 EAP_HOME/domain/configuration/ 目录，且您需要指定相对这个目录的路径。

   例 2.3. 在红帽企业版 Linux 里对受管域使用其他的配置文件

   [user@host bin]$ ./domain.sh --domain-config=domain-alternate.xml

   这个例子使用了 EAP_HOME/domain/configuration/domain-alternate.xml 配置文件。

   例 2.4. 在 Microsoft Windows 服务器里对受管域使用其他的配置文件

   C:\EAP_HOME\bin> domain.bat --domain-config=domain-alternate.xml
   
   

   这个例子使用了 EAP_HOME\domain\configuration\domain-alternate.xml 配置文件。

过程 2.10. 启动受管域里的服务器

1. 在控制器的顶部选择 Runtime 标签页。展开 Server 菜单并选择 Overview。
2. 从 Server Instances 列表里，选择要启动的服务器。正在运行的服务器会用一个复选框标记表示。
   在这个列表的实例上悬停会在服务器细节下面以蓝色字体显示选项。
3. 要启动这个实例，请在 Start Server 文本出现时点击它。然后会出现一个确认对话框，点击 Confirm 按钮启动服务器。

过程 2.11. 使用管理控制台停止受管域里的服务器

1. 在控制器的顶部选择 Runtime 标签页。展开 Domain 菜单并选择 Overview。
2. 可用的 Server Instances 列表将显示在 Hosts, groups and server instances 表里。正在运行的服务器用一个复选框标记表示。
3. 将鼠标在所选的服务器上悬停。点击出现的 Stop Server 文本。然后将出现一个确认对话框。
4. 点击 Confirm 按钮来停止服务器。

过程 2.12. jboss-descriptor-property-replacement

1. 在管理 CLI 里，运行下列命令来确定 jboss-descriptor-property-replacement 的值：

   /subsystem=ee:read-attribute(name="jboss-descriptor-property-replacement")

2. 运行下列命令来配置其行为：

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

过程 2.13. spec-descriptor-property-replacement

1. 在管理 CLI 里，运行下列命令来确认 spec-descriptor-property-replacement 的值：

   /subsystem=ee:read-attribute(name="spec-descriptor-property-replacement")

2. 运行下列命令来配置其行为：

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

1. 确定您要启动的备份版本。这个例子将回调成功引导后第一次修改前的服务器模型的实例。

   EAP_HOME/standalone/configuration/standalone_xml_history/current/standalone.v1.xml

2. 传入 jboss.server.config.dir 下的相对文件名，用备份模型的配置启动服务器。

   EAP_HOME/bin/standalone.sh --server-config=standalone_xml_history/current/standalone.v1.xml

过程 2.14. 创建配置快照并保存

• 保存快照

  运行 take-snapshot 操作来创建当前服务器配置的快照。

  [standalone@localhost:9999 /] :take-snapshot
  {
      "outcome" => "success",
      "result" => "/home/User/EAP_HOME/standalone/configuration/standalone_xml_history/snapshot/20110630-172258657standalone.xml"
  

过程 2.15. 加载配置快照

1. 确定要加载的快照。这个例子将从 snapshot 目录回调下列文件。下面是快照文件的默认路径。

   EAP_HOME/standalone/configuration/standalone_xml_history/snapshot/20110812-191301472standalone.xml

   快照是用相对路径表达的，上面的例子可以像下面这样编写。

   jboss.server.config.dir/standalone_xml_history/snapshot/20110812-191301472standalone.xml

2. 通过传入文件名用所选的配置快照启动服务器。

   EAP_HOME/bin/standalone.sh --server-config=standalone_xml_history/snapshot/20110913-164449522standalone.xml

过程 2.16. 删除专有的快照

1. 确定要删除的快照。这个例子将从 snapshot 目录删除下列文件。

   EAP_HOME/standalone/configuration/standalone_xml_history/snapshot/20110630-165714239standalone.xml

2. 如下例所示，指定快照的名称，运行 :delete-snapshot 命令来删除专有的快照。

   [standalone@localhost:9999 /] :delete-snapshot(name="20110630-165714239standalone.xml")
   {"outcome" => "success"}
   

过程 2.17. 删除所有快照

• 如下例所示，运行 :delete-snapshot(name="all") 命令删除所有的快照。

  [standalone@localhost:9999 /] :delete-snapshot(name="all")
  {"outcome" => "success"}
  

过程 2.18. 列出所有的配置快照

• 列出所有快照

  用 :list-snapshots 命令列出所有保存的快照。

  [standalone@localhost:9999 /] :list-snapshots
  {
      "outcome" => "success",
      "result" => {
          "directory" => "/home/hostname/EAP_HOME/standalone/configuration/standalone_xml_history/snapshot",
          "names" => [
              "20110818-133719699standalone.xml",
              "20110809-141225039standalone.xml",
              "20110802-152010683standalone.xml",
              "20110808-161118457standalone.xml",
              "20110912-151949212standalone.xml",
              "20110804-162951670standalone.xml"
          ]
      }
  }
  

过程 3.1. 登录到管理控制台

1. 进入管理控制台开始页面

   通过 Web 浏览器进入管理控制台。默认的位置是 http://localhost:9990/console/App.html，其中的 9990 是预定义为管理控制台的套接绑定的。

2. 登录到管理控制台

   输入您之前创建的帐号的用户名和密码来登录到管理控制台屏幕。
   

   图 3.1. 管理控制台的登录屏幕

过程 3.2. 修改基于 Web 的管理控制台的语言

1. 登录到管理控制台。

   登录到基于 Web 的管理控制台。

2. 打开 Setting 对话框。

   屏幕的右下角是 Settings 标签。点击它打开管理控制台的设置对话框。

3. 选择语言。

   在 Locale 选择框里选择语言。然点选择 Save。确认框通知您需要重载应用程序。点击 Confirm。刷新 Web 浏览器以使用新的区域设置。

过程 3.3. 配置服务器

1. 从控制台的顶部选择 Domain 标签页。可用的服务器将显示在表格里。
2. 从 Available Server Configurations 表格里选择服务器实例。
3. 在所选的服务器细节上方点击 Edit 按钮。
4. 修改配置属性。
5. 点击Save完成。

1. 从控制台的顶部选择 Runtime 标签页。
2. 对于独立服务器，展开 Server 菜单项并选择 Manage Deployments。对于受管域，展开 Domain 菜单项并选择 Manage Deployments。Manage Deployments 面板将显示。
3. 点击 Content Repository 标签页上的 Add 按钮。Create Deployment 对话框将会出现。
4. 在这个对话框里，点击 Browse 按钮。选择您要部署和上传的文件。然后点击 Next 按钮进行。
5. 验证出现在 Create Deployments 对话框里的部署名和 runtime 名称。验证名称后请点击 Save 按钮上传文件。

过程 3.4. 创建新的服务器配置

1. 进入管理控制台里的 Server Configurations 页面

   从控制台的顶部选择 Domain 标签页。

2. 创建新的配置

   1. 点击 Available Server Configuration 表上方的 Add 按钮。
   2. 在 Create Server Configuration 对话框里输入基本服务器设置。
   3. 点击 保存 按钮保存新的服务器配置。

过程 3.5. 编辑日志级别

1. 进入管理控制台的 Logging 面板

   1. 对于受管域，选择控制台顶部的 Configuration 标签页，然后从控制台左侧的下拉菜单里选择相关的配置集。
   2. 对于受管域或独立服务器，展开控制台左侧菜单的 Core 菜单并点击 Logging 条目。
   3. 点击控制台顶部的 Log Categories 标签页。

2. 编辑 logger 细节

   编辑 Log Categories 表格里条目的细节。
   1. 在 Log Categories 表格里选择条目，然后点击下面的 Details 部分里的 Edit 按钮。
   2. 通过 Log Level 下拉框选择类别的日志级别。完成后点击 Save 按钮。

过程 3.6. 配置和添加新的服务器组

1. 进入 Server Groups 视图

   从控制台的顶部选择 Domain 标签页。
2. 展开左侧菜单里的 Server 标签。选择 Server Groups。

3. 添加服务器组

   点击 Add 按钮来添加新的服务器组。

4. 配置服务器组

   1. 输入服务器组的名称。
   2. 选择服务器组的配置集。
   3. 选择服务器组的套接字绑定。
   4. 点击 Save 按钮来保存新的组。

过程 3.7. 在 Linux 或 Windows 里启动 CLI

• • 在 Linux 里启动 CLI

    运行 EAP_HOME/bin/jboss-cli.sh 命令：

    $ EAP_HOME/bin/jboss-cli.sh

  • 在 Windows 里启动 CLI

    运行 EAP_HOME\bin\jboss-cli.bat 命令：

    C:\>EAP_HOME\bin\jboss-cli.bat

过程 3.8. 退出管理 CLI

• 运行 quit 命令

  在管理 CLI 里，输入 quit 命令：

  [domain@localhost:9999 /] quit

过程 3.9. 连接至受管服务器实例

• 运行 connect 命令

  在管理 CLI 里，输入 connect 命令：

  [disconnected /] connect
  Connected to domain controller at localhost:9999

  • 或者，在 Linux 系统里启动管理 CLI 时使用 --connect 参数来连接至受管服务器：

    $ EAP_HOME/bin/jboss-cli.sh --connect

  • --connect 参数可以用来指定服务器的主机和端口。要连接至地址 192.168.0.1 和端口 9999，请使用下列命令：

    $ EAP_HOME/bin/jboss-cli.sh --connect --controller=192.168.0.1:9999

过程 3.10. 普通和上下文敏感帮助

1. 运行 help 命令

   在管理 CLI 里，输入 help 命令：

   [standalone@localhost:9999 /] help

2. 获取上下文敏感帮助

   在管理 CLI 里，输入 help -commands 扩展命令：

   [standalone@localhost:9999 /] help --commands

3. 关于特定命令的更多详情，请运行 help 并以 '--help' 为参数。

   [standalone@localhost:9999 /]  deploy --help

过程 3.11. 批处理模式命令和操作

1. 启用批处理模式

   用 batch 命令启用批处理模式。

   [standalone@localhost:9999 /] batch
   [standalone@localhost:9999 / #]

   提示里的井号（#）指明了批处理模式

2. 添加操作请求到批处理命令里

   在批处理模式下，照常输入操作请求。操作请求将按输入的顺序添加到批处理命令里。
   关于格式化操作请求的详情，请参考 第 3.5.8 节 “在管理 CLI 里使用操作和命令”。

3. 运行批处理命令

   一旦输入了整个操作请求序列，请用 run-batch 运行这个批处理命令。

   [standalone@localhost:9999 / #] run-batch
   The batch executed successfully.

   关于可用于批处理的完整的命令列表，请参考 第 3.5.7 节 “CLI 批处理模式命令”。

4. 保存在外部文件里的批命令

   频繁运行的批处理命令可以存储在外部文件里，通过将完整文件路径作为参数传入 batch 或直接作为 run-batch 命令的参数来执行。
   您可以用文本编辑器创建批处理命令文件。每个命令都必须单独一行且 CLI 应该可以访问它。
   下面的命令将加载 myscript.txt 文件至批处理模式。这个文件里的所有命令都可以编辑或删除，您也可以插入新的命令。这个批处理会话里进行的修改不会持久化到 myscript.txt 文件里。

   [standalone@localhost:9999 /] batch --file=myscript.txt

   下面的命令将立即运行存储在文件 myscript.txt 里的批命令

   [standalone@localhost:9999 /] run-batch --file=myscript.txt

过程 3.12. 创建、配置和执行请求

1. 构造操作请求

   操作请求允许和管理模型的低层交互。它们提供一种可控的方式来编辑服务器配置。操作请求由三部分组成：
   • 地址，前缀为斜杠（/）。
   • 操作名称，前缀为冒号（:）。
   • 可选的参数，包含在括号（()）里。

   1. 确定地址

      配置以有地址的资源层级树型出现。每个资源节点都提供了一系列不同的操作。地址指定哪些资源可以执行操作。地址使用下面的语法：

      /node-type=node-name

      • node-type 是资源节点的类型。它映射配置 XML 文件里的元素名称。
      • node-name 是资源节点的名称。它映射配置 XML 文件里的元素的 name 属性。
      • 用斜杠（/）分隔资源树的每个级别。
      要确定所需的地址，请参考 XML 配置文件。EAP_HOME/standalone/configuration/standalone.xml 文件保存独立服务器的配置信息，EAP_HOME/domain/configuration/domain.xml 和 EAP_HOME/domain/configuration/host.xml 文件保存受管域的配置信息。

      例 3.3. 操作地址示例

      要执行 Logging 子系统上的操作，请使用操作请求里的下列地址：

      /subsystem=logging

      要执行 Java 数据源上的操作，请使用操作请求里的下列地址：

      /subsystem=datasources/data-source=java

   2. 确定操作

      对于不同类型的资源节点，操作会有所不同。操作使用下面的语法：

      :operation-name

      • operation-name 是要请求的操作的名称。
      在独立服务器上的任何资源地址上使用 read-operation-names 操作来列出可用的操作。

      例 3.4. 可用的操作

      要列出 Logging 子系统到所有可用的操作，在独立服务器里输入下列请求：

      [standalone@localhost:9999 /] /subsystem=logging:read-operation-names
      {
          "outcome" => "success",
          "result" => [
              "add",
              "read-attribute",
              "read-children-names",
              "read-children-resources",
              "read-children-types",
              "read-operation-description",
              "read-operation-names",
              "read-resource",
              "read-resource-description",
              "remove",
              "undefine-attribute",
              "whoami",
              "write-attribute"
          ]
      }
      

   3. 确定任何参数

      每个操作可能需要不同的参数。
      参数使用下面的语法：

      (parameter-name=parameter-value)

      • parameter-name 是参数的名称。
      • parameter-value 是参数的值。
      • 多个参数用逗号隔开（,）。
      要确定所需的参数，在资源节点上执行 read-operation-description 命令，将操作名称作为参数传入。详情请参考 例 3.5 “确定操作的参数”。

      例 3.5. 确定操作的参数

      要确定 logging 子系统上的 read-children-types 操作的必需参数，请输入 read-operation-description 命令：

      [standalone@localhost:9999 /] /subsystem=logging:read-operation-description(name=read-children-types)
      {
          "outcome" => "success",
          "result" => {
              "operation-name" => "read-children-types",
              "description" => "Gets the type names of all the children under the selected resource",
              "reply-properties" => {
                  "type" => LIST,
                  "description" => "The children types",
                  "value-type" => STRING
              },
              "read-only" => true
          }
      }
      

2. 输入完整的操作请求

   一旦确定了地址、操作和所有参数，请输入完整的操作请求。

   例 3.6. 操作请求示例

   [standalone@localhost:9999 /] /subsystem=web/connector=http:read-resource(recursive=true)

过程 3.13. 显示所选属性的当前 Runtime 值

• 运行 read-attribute 操作

  在管理 CLI 里，使用 read-attribute 操作来显示资源属性的值。关于操作请求的更多细节，请参考 第 3.5.8 节 “在管理 CLI 里使用操作和命令”。

  [standalone@localhost:9999 /]:read-attribute(name=name-of-attribute)

过程 3.14. 在管理 CLI 里用 whoami 操作显示活动用户

• 运行 whoami 操作

  在管理 CLI 里，请用 whoami 操作来显示活动的用户帐号。

  [standalone@localhost:9999 /] :whoami

  下面的例子使用了独立服务器实例里的 whoami 操作来显示活动用户 username，以及它所分配的 ManagementRealm 区。

  例 3.8. 在独立实例里使用 whoami

  [standalone@localhost:9999 /]:whoami
  {
      "outcome" => "success",
      "result" => {"identity" => {
          "username" => "username",
          "realm" => "ManagementRealm"
      }}
  }
  
  

过程 3.15. 在管理 CLI 里显示系统和服务器信息

• 运行 version 命令

  在管理 CLI 里，输入 version 命令：

  [domain@localhost:9999 /] version

过程 3.16. 在管理 CLI 里执行命令

• 运行 read-operation-description 操作

  在管理 CLI 里，使用 read-operation-description 来显示操作信息。这个操作要求键-值格式的其他参数以指定要显示的操作。关于操作请求的详情，请参考 第 3.5.8 节 “在管理 CLI 里使用操作和命令”。

  [standalone@localhost:9999 /]:read-operation-description(name=name-of-operation)

过程 3.17. 在管理 CLI 里执行命令

• 运行 read-operation-names 操作

  在管理 CLI 里，使用 read-operation-names 来显示可用操作的名称。关于操作请求的详情，请参考 第 3.5.8 节 “在管理 CLI 里使用操作和命令”。

  [standalone@localhost:9999 /]:read-operation-names

过程 3.18. 在管理 CLI 里执行命令

1. 运行 read-resource 操作

   在管理 CLI 里，请用 read-resource 操作来显示可用的资源。

   [standalone@localhost:9999 /]:read-resource

   下面的例子展示了在独立服务器里如何使用 read-resource 操作来开放普通资源信息。结果类似于 standalone.xml 配置文件，显示系统资源、扩展、接口和为服务器实例安装和配置的子系统。它们可以进一步进行直接查询。

   例 3.11. 在根级别使用 read-resource 操作

   [standalone@localhost:9999 /]:read-resource
   {
       "outcome" => "success",
       "result" => {
           "deployment" => undefined,
           "deployment-overlay" => undefined,
           "management-major-version" => 1,
           "management-micro-version" => 0,
           "management-minor-version" => 4,
           "name" => "longgrass",
           "namespaces" => [],
           "product-name" => "EAP",
           "product-version" => "6.3.0.GA",
           "release-codename" => "Janus",
           "release-version" => "7.2.0.Final-redhat-3",
           "schema-locations" => [],
           "system-property" => undefined,
           "core-service" => {
               "management" => undefined,
               "service-container" => undefined,
               "server-environment" => undefined,
               "platform-mbean" => undefined
           },
           "extension" => {
               "org.jboss.as.clustering.infinispan" => undefined,
               "org.jboss.as.connector" => undefined,
               "org.jboss.as.deployment-scanner" => undefined,
               "org.jboss.as.ee" => undefined,
               "org.jboss.as.ejb3" => undefined,
               "org.jboss.as.jaxrs" => undefined,
               "org.jboss.as.jdr" => undefined,
               "org.jboss.as.jmx" => undefined,
               "org.jboss.as.jpa" => undefined,
               "org.jboss.as.jsf" => undefined,
               "org.jboss.as.logging" => undefined,
               "org.jboss.as.mail" => undefined,
               "org.jboss.as.naming" => undefined,
               "org.jboss.as.pojo" => undefined,
               "org.jboss.as.remoting" => undefined,
               "org.jboss.as.sar" => undefined,
               "org.jboss.as.security" => undefined,
               "org.jboss.as.threads" => undefined,
               "org.jboss.as.transactions" => undefined,
               "org.jboss.as.web" => undefined,
               "org.jboss.as.webservices" => undefined,
               "org.jboss.as.weld" => undefined
           },
           "interface" => {
               "management" => undefined,
               "public" => undefined,
               "unsecure" => undefined
           },
           "path" => {
               "jboss.server.temp.dir" => undefined,
               "user.home" => undefined,
               "jboss.server.base.dir" => undefined,
               "java.home" => undefined,
               "user.dir" => undefined,
               "jboss.server.data.dir" => undefined,
               "jboss.home.dir" => undefined,
               "jboss.server.log.dir" => undefined,
               "jboss.server.config.dir" => undefined,
               "jboss.controller.temp.dir" => undefined
           },
           "socket-binding-group" => {"standard-sockets" => undefined},
           "subsystem" => {
               "logging" => undefined,
               "datasources" => undefined,
               "deployment-scanner" => undefined,
               "ee" => undefined,
               "ejb3" => undefined,
               "infinispan" => undefined,
               "jaxrs" => undefined,
               "jca" => undefined,
               "jdr" => undefined,
               "jmx" => undefined,
               "jpa" => undefined,
               "jsf" => undefined,
               "mail" => undefined,
               "naming" => undefined,
               "pojo" => undefined,
               "remoting" => undefined,
               "resource-adapters" => undefined,
               "sar" => undefined,
               "security" => undefined,
               "threads" => undefined,
               "transactions" => undefined,
               "web" => undefined,
               "webservices" => undefined,
               "weld" => undefined
           }
       }
   }
   
   

2. 针对子节点运行 read-resource 操作

   read-resource 操作可以查询根节点的子节点。操作的结构首先定义要开放的节点，然后附加这个操作来运行。

   [standalone@localhost:9999 /]/subsystem=web/connector=http:read-resource

   在下面的例子里，通过指引 read-resource 操作到专有的 Web 子系统节点来开放 Web 子系统组件的专有资源信息。

   例 3.12. 开放根结点的子节点资源

   [standalone@localhost:9999 /] /subsystem=web/connector=http:read-resource                      
   {
       "outcome" => "success",
       "result" => {
           "configuration" => undefined,
           "enable-lookups" => false,
           "enabled" => true,
           "executor" => undefined,
           "max-connections" => undefined,
           "max-post-size" => 2097152,
           "max-save-post-size" => 4096,
           "name" => "http",
           "protocol" => "HTTP/1.1",
           "proxy-name" => undefined,
           "proxy-port" => undefined,
           "redirect-port" => 443,
           "scheme" => "http",
           "secure" => false,
           "socket-binding" => "http",
           "ssl" => undefined,
           "virtual-server" => undefined
       }
   }
   
   

   相同的结果可以用 cd 命令进入子节点并直接运行 read-resource 操作获得。

   例 3.13. 通过修改目录开放子节点资源

   [standalone@localhost:9999 /] cd subsystem=web
   

   [standalone@localhost:9999 subsystem=web] cd connector=http
   

   [standalone@localhost:9999 connector=http] :read-resource
   {
       "outcome" => "success",
       "result" => {
           "configuration" => undefined,
           "enable-lookups" => false,
           "enabled" => true,
           "executor" => undefined,
           "max-connections" => undefined,
           "max-post-size" => 2097152,
           "max-save-post-size" => 4096,
           "name" => "http",
           "protocol" => "HTTP/1.1",
           "proxy-name" => undefined,
           "proxy-port" => undefined,
           "redirect-port" => 443,
           "scheme" => "http",
           "secure" => false,
           "socket-binding" => "http",
           "ssl" => undefined,
           "virtual-server" => undefined
       }
   }
   
   

3. 使用 recursive 参数在结果里包含活动的属性值。

   recursive 参数可以用来开放所有属性的值，包括非持久性的值、在启动时传入的值或其他在 runtime 模型里活动的属性。

   [standalone@localhost:9999 /]/interface=public:read-resource(include-runtime=true)

   和之前的例子相比， include-runtime 请求属性会开放其他的活动属性，如发送的字节和 HTTP 连接器接收的字节。

   例 3.14. 用 include-runtime 参数开放其他活动的属性值。

   [standalone@localhost:9999 /] /subsystem=web/connector=http:read-resource(include-runtime=true)
   {
       "outcome" => "success",
       "result" => {
           "any" => undefined,
           "any-address" => undefined,
           "any-ipv4-address" => undefined,
           "any-ipv6-address" => undefined,
           "inet-address" => expression "${jboss.bind.address:127.0.0.1}",
           "link-local-address" => undefined,
           "loopback" => undefined,
           "loopback-address" => undefined,
           "multicast" => undefined,
           "name" => "public",
           "nic" => undefined,
           "nic-match" => undefined,
           "not" => undefined,
           "point-to-point" => undefined,
           "public-address" => undefined,
           "resolved-address" => "127.0.0.1",
           "site-local-address" => undefined,
           "subnet-match" => undefined,
           "up" => undefined,
           "virtual" => undefined
       }
   }
   
   

过程 3.19. 在管理 CLI 里执行命令

1. 运行 read-resource-description 操作

   在管理 CLI 里，使用 read-resource-description 来读取和显示可用资源。关于操作请求的详情，请参考 第 3.5.8 节 “在管理 CLI 里使用操作和命令”。

   [standalone@localhost:9999 /]:read-resource-description

2. 使用可选参数

   read-resource-description 操作允许使用其他参数。
   1. 使用 operations 参数来包含资源操作的描述。

      [standalone@localhost:9999 /]:read-resource-description(operations=true)

   2. 使用 inherited 参数可以包含或排除资源继承操作的描述。默认状态是 true。

      [standalone@localhost:9999 /]:read-resource-description(inherited=false)

   3. 使用 recursive 参数来包含子资源的递归描述。

      [standalone@localhost:9999 /]:read-resource-description(recursive=true)

   4. 使用 locale 参数来获取资源描述。如果为 null 则使用默认的 locale。

      [standalone@localhost:9999 /]:read-resource-description(locale=true)

过程 3.20. 关闭应用服务器

• 运行 shutdown 操作

  • 在管理 CLI 里，使用 shutdown 操作通过 System.exit(0) 系统调用来关闭服务器。关于操作请求的详情，请参考 第 3.5.8 节 “在管理 CLI 里使用操作和命令”。
    • 在独立模式下，请使用下列命令：

      [standalone@localhost:9999 /]:shutdown

    • 在域模式下，请使用下列命令及合适的主机名：

      [domain@localhost:9999 /]/host=master:shutdown

  • 要连接到附加的 CLI 实例并关闭服务器，请执行下列命令：

    jboss-cli.sh --connect command=:shutdown
    

  • 要连接到远程的 CLI 实例并关闭服务器，请执行下列命令：

    [disconnected /] connect IP_ADDRESS
    Connected to IP_ADDRESS:PORT_NUMBER
    [192.168.1.10:9999 /] :shutdown
    

    用实例的 IP 地址替换 IP_ADDRESS

过程 3.21. 使用管理 CLI 配置资源属性

• 运行 write-attribute 操作

  在管理 CLI 里，使用 write-attribute 操作修改资源属性的值。这个擦作可以运行在资源的子节点或管理 CLI 的根节点上（指定完整资源路径）。

过程 3.22. 用管理 CLI 配置系统属性

1. 启动 JBoss EAP 服务器。
2. 使用适合操作系统的命令启动管理 CLI
   对于 Linux：

   EAP_HOME/bin/jboss-cli.sh --connect

   对于 Windows:

   EAP_HOME\bin\jboss-cli.bat --connect

3. 添加系统属性。
   使用的命令取决于服务器是否是独立服务器还是运行在受管域里。如果您运行的是受管域，您可以添加任何系统属性到运行在这个域里的任何或所有服务器里。
   • 用下列语法在独立服务器上添加一个系统属性：

     /system-property=PROPERTY_NAME:add(value=PROPERTY_VALUE)

     例 3.17. 添加系统属性到独立服务器

     [standalone@localhost:9999 /] /system-property=property.mybean.queue:add(value=java:/queue/MyBeanQueue)
     {"outcome" => "success"}
     

   • 用下列语法在受管域里的所有主机和服务器上添加一个系统属性：

     /system-property=PROPERTY_NAME:add(value=PROPERTY_VALUE)

     例 3.18. 添加系统属性到受管域里的所有服务器

     [domain@localhost:9999 /] /system-property=property.mybean.queue:add(value=java:/queue/MyBeanQueue)
     {
         "outcome" => "success",
         "result" => undefined,
         "server-groups" => {"main-server-group" => {"host" => {"master" => {
             "server-one" => {"response" => {"outcome" => "success"}},
             "server-two" => {"response" => {"outcome" => "success"}}
         }}}}
     }
     

   • 用下列语法在受管域里的主机及其服务器实例上添加一个系统属性：

     /host=master/system-property=PROPERTY_NAME:add(value=PROPERTY_VALUE)

     例 3.19. 添加系统属性到域里的主机及其服务器

     [domain@localhost:9999 /] /host=master/system-property=property.mybean.queue:add(value=java:/queue/MyBeanQueue)
     {
         "outcome" => "success",
         "result" => undefined,
         "server-groups" => {"main-server-group" => {"host" => {"master" => {
             "server-one" => {"response" => {"outcome" => "success"}},
             "server-two" => {"response" => {"outcome" => "success"}}
         }}}}
     }
     

   • 用下列语法添加一个系统属性到受管域里的服务器实例：

     /host=master/server-config=server-one/system-property=PROPERTY_NAME:add(value=PROPERTY_VALUE)

     例 3.20. 添加系统属性到受管域里的服务器实例

     [domain@localhost:9999 /] /host=master/server-config=server-one/system-property=property.mybean.queue:add(value=java:/queue/MyBeanQueue)
     {
         "outcome" => "success",
         "result" => undefined,
         "server-groups" => {"main-server-group" => {"host" => {"master" => {"server-one" => {"response" => {"outcome" => "success"}}}}}}
     }
     
     

4. 读取系统属性。
   所使用的命令取决于服务器是否是独立服务器还是运行在受管域里。
   • 用下列语法从独立服务器读取系统属性：

     /system-property=PROPERTY_NAME:read-resource

     例 3.21. 从独立服务器读取系统属性

     [standalone@localhost:9999 /] /system-property=property.mybean.queue:read-resource
     {
         "outcome" => "success",
         "result" => {"value" => "java:/queue/MyBeanQueue"}
     }
     
     

   • 用下列语法在受管域里的所有主机和服务器上读取系统属性：

     /system-property=PROPERTY_NAME:read-resource

     例 3.22. 从受管域里的所有服务器上读取系统属性

     [domain@localhost:9999 /] /system-property=property.mybean.queue:read-resource
     {
         "outcome" => "success",
         "result" => {
             "boot-time" => true,
             "value" => "java:/queue/MyBeanQueue"
         }
     }
     

   • 用下列语法从受管域里的主机及其服务器实例里读取系统属性：

     /host=master/system-property=PROPERTY_NAME:read-resource

     例 3.23. 从受管域里的主机及其服务器读取系统属性

     [domain@localhost:9999 /] /host=master/system-property=property.mybean.queue:read-resource
     {
         "outcome" => "success",
         "result" => {
             "boot-time" => true,
             "value" => "java:/queue/MyBeanQueue"
         }
     }
     
     

   • 用下列语法从受管域里的服务器实例里读取系统属性：

     /host=master/server-config=server-one/system-property=PROPERTY_NAME:read-resource

     例 3.24. 从受管域里的服务器实例读取系统属性

     [domain@localhost:9999 /] /host=master/server-config=server-one/system-property=property.mybean.queue:read-resource
     {
         "outcome" => "success",
         "result" => {
             "boot-time" => true,
             "value" => "java:/queue/MyBeanQueue"
         }
     }
     

5. 删除系统属性。
   所使用的命令取决于服务器是否是独立服务器还是运行在受管域里。
   • 用下列语法从独立服务器删除系统属性：

     /system-property=PROPERTY_NAME:remove

     例 3.25. 从独立服务器删除系统属性

     [standalone@localhost:9999 /] /system-property=property.mybean.queue:remove
     {"outcome" => "success"}
     

   • 用下列语法从受管域里的所有主机和服务器里删除系统属性：

     /system-property=PROPERTY_NAME:remove

     例 3.26. 从受管域里的所有主机和服务器里删除系统属性

     [domain@localhost:9999 /] /system-property=property.mybean.queue:remove
     {
         "outcome" => "success",
         "result" => undefined,
         "server-groups" => {"main-server-group" => {"host" => {"master" => {
             "server-one" => {"response" => {"outcome" => "success"}},
             "server-two" => {"response" => {"outcome" => "success"}}
         }}}}
     }
     
     

   • 用下列语法从受管域里的主机及其服务器实例里删除系统属性：

     /host=master/system-property=PROPERTY_NAME:remove

     例 3.27. 从受管域里的主机及其实例里删除系统属性

     [domain@localhost:9999 /] /host=master/system-property=property.mybean.queue:remove
     {
         "outcome" => "success",
         "result" => undefined,
         "server-groups" => {"main-server-group" => {"host" => {"master" => {
             "server-one" => {"response" => {"outcome" => "success"}},
             "server-two" => {"response" => {"outcome" => "success"}}
         }}}}
     }
     
     

   • 用下列语法从受管域里的服务器实例里删除系统属性：

     /host=master/server-config=server-one/system-property=PROPERTY_NAME:remove

     例 3.28. 从受管域里的服务器里删除系统属性

     [domain@localhost:9999 /] /host=master/server-config=server-one/system-property=property.mybean.queue:remove
     {
         "outcome" => "success",
         "result" => undefined,
         "server-groups" => {"main-server-group" => {"host" => {"master" => {"server-one" => {"response" => {"outcome" => "success"}}}}}}
     }
     
     

过程 3.23. 显示管理 CLI 命令历史

• 运行 history 命令

  在管理 CLI 里，输入 history 命令：

  [standalone@localhost:9999 /] history

过程 3.24. 清除管理 CLI 命令历史

• 运行 history --clear 命令

  在管理 CLI 里，输入 history --clear 命令：

  [standalone@localhost:9999 /] history --clear

过程 3.25. 禁用管理 CLI 命令历史

• 运行 history --disable 命令

  在管理 CLI 里，输入 history --disable 命令：

  [standalone@localhost:9999 /] history --disable

过程 3.26. 启用管理 CLI 命令历史

• 运行 history --enable 命令

  在管理 CLI 里，输入 history --enable 命令：

  [standalone@localhost:9999 /] history --enable

过程 3.27. 启用发送到 Syslog 服务器的日志

1. 创建一个名为 msyslog 的 syslog 处理程序

   [standalone@localhost:9999 /]batch
   [standalone@localhost:9999 /]/core-service=management/access=audit/syslog-handler=mysyslog:add(formatter=json-formatter)
   [standalone@localhost:9999 /]/core-service=management/access=audit/syslog-handler=mysyslog/protocol=udp:add(host=localhost,port=514)
   [standalone@localhost:9999 /]run-batch

2. 在 syslog 处理程序里添加一个引用。

   [standalone@localhost:9999 /]/core-service=management/access=audit/logger=audit-log/handler=mysyslog:add

过程 4.1. 为远程管理界面创建初始管理性用户

1. 调用 add-user.sh 或 add-user.bat 脚本。

   进入 EAP_HOME/bin/ 目录。根据你的操作系统调用合适的脚本。

   Red Hat Enterprise Linux

   [user@host bin]$ ./add-user.sh

   Microsoft Windows Server

   C:\bin>  add-user.bat

2. 选择添加一个管理用户。

   点击 ENTER 选择默认选项 a 来添加一个管理用户。这个用户被添加到 ManagementRealm 并被授权通过基于 web 的管理控制台或基于命令行的管理 CLI 来执行管理操作。另外一个选项 b 则添加一个用户到 ApplicationRealm，且未提供特殊的权限。该区域（Realm）用于应用程序。

3. 输入用户名和密码。

   遇到提示时输入用户名和密码，系统会提示您确认密码。

4. 输入您的组信息

   添加用户所属的组或组群。如果用户属于多个组，请输入用逗号隔开的列表。如果不属于任何组，请留空。

5. 获取信息并确认。

   系统会提示您确认信息。如果正确，请输入 yes。

6. 选择用户是否代表一个远程 JBoss EAP 6 服务器实例。

   除了管理员以外，偶尔需要在 ManagementRealm 里添加到 JBoss EAP 6 里的是代表其他 EAP 实例的用户，它需要通过验证作为成员加入到群集。下一个提示允许你指定所添加的用户。如果你选择 yes，你将得到一个 hashed secret 值，代表用户的密码，这将需要添加到不同的配置文件里。为了完成这个任务，在这里请回答 no。

7. 输入其他的用户。

   如果需要，重复刚才的过程你可以输入其他用户。你也可以在任何时候在运行系统里添加用户。不是选择默认的安全区，你需要添加用户到其他区以调整其授权过程。

8. 非交互式地创建用户。

   通过在命令行传入参数，你可以非交互式地创建用户。我们不推荐在共享系统上使用这个方法，因为密码可以在日志或历史文件里看到。这个使用管理区域的命令的语法是：

   [user@host bin]$ ./add-user.sh username password

   要使用应用程序区域，请使用 -a 参数。

   [user@host bin]$ ./add-user.sh -a username password

9. 通过 --silent 参数，你可以忽略 add-user 脚本的正常输出。这只有在指定了用户名和密码且只使用了最小参数集时才适用。 而错误信息仍会被显示。

过程 4.2. 指定替代属性文件

• • 要指定服务器配置的替代目录，请使用 -sc 参数。这个参数指定了包含服务器配置属性文件的替代目录。
  • 要为域配置指定替代目录，，请使用 -dc 参数。这个参数指定了包含域配置属性文件的替代目录。
  • 要指定替代的用户配置属性文件，请使用 -up 或 --user-properties 参数。它可以是绝对路径，也可以和 -sc 或 -dc 参数一起使用来指定替代的配置目录。
  • 要指定替代的组配置属性文件，请使用 -gp 或 --group-properties 参数。它可以是绝对路径，也可以和 -sc 或 -dc 参数一起使用来指定替代的配置目录。

• 配置接口属性

  您可以用 Tab Completion 来完成输入的命令，并开放可用的属性。

  • 用管理 CLI 配置接口属性

    使用管理 CLI 来添加新的接口并编写新的接口属性的值。

    1. 添加新的接口

       使用 add 操作来创建新的接口。您可以在管理 CLI 会话的根目录里运行 add 命令，下面的例子创建了一个名为 interfacename 的接口，它将 inet-address 声明为 12.0.0.2。

       /interface=interfacename/:add(inet-address=12.0.0.2)

    2. 编辑接口属性

       write 操作将新的值写入属性。下面的例子将 inet-address 的值更新为 12.0.0.8。

       /interface=interfacename/:write-attribute(name=inet-address, value=12.0.0.8)

    3. 检验接口属性

       通过 include-runtime=true 参数运行 read-resource 操作来确认值已修改，从而开放服务器模型里所有当前的值。例如：

       [standalone@localhost:9999 interface=public] :read-resource(include-runtime=true)

  • 用管理控制台配置接口属性

    1. 登录到管理控制台。

       登录到受管域或独立服务器实例的管理控制台。

    2. 进入 Interfaces 屏幕

       1. 进入 Configuration 标签页。

          从屏幕顶部选择 Configuration 标签页。

       2. 仅用于域模式

          从屏幕左上角的 Profile 下拉菜单里选择要修改的配置集。

    3. 从导航菜单里选择 Interfaces。

       展开 General Configuration 菜单。从导航菜单里选择 Interfaces 菜单条目。

    4. 添加新的接口

       1. 点添加。
       2. 输入 Name、Inet Address 和 Address Wildcard 的值。
       3. 点击 Save。

    5. 编辑接口属性

       1. 从 Available Interfaces 列表里选择要编辑的接口并点击 Edit。
       2. 输入 Name、Inet Address 和 Address Wildcard 的值。
       3. 点击 Save。

• 配置套接字绑定组里的套接字绑定

  请选择管理 CLI 或管理控制台来按需要配置套接字绑定。

  • 使用管理 CLI 配置套接字绑定

    使用管理 CLI 配置套接字绑定。

    1. 添加新的套接字绑定

       如果有需要，请使用 add 操作来创建新的地址设置。您可以在管理 CLI 会话的根目录里运行这个命令，下面的例子创建了一个名为 newsocket 的套接字绑定，它的 port 属性声明为 1234。这些例子适用于独立服务器和受管域的 standard-sockets 套接字绑定组。

       [domain@localhost:9999 /] /socket-binding-group=standard-sockets/socket-binding=newsocket/:add(port=1234)

    2. 编辑 Pattern 属性

       使用 write-attribute 操作来编写新的属性的值。您可以使用 tab completion 来帮助输入并提示所有可用的值。下面的例子将 port 的值更新为 2020。

       [domain@localhost:9999 /] /socket-binding-group=standard-sockets/socket-binding=newsocket/:write-attribute(name=port,value=2020)

    3. 确认 Pattern 属性

       通过 include-runtime=true 参数运行 read-resource 操作来确认值已修改以开放服务器模型里所有当前的值。

       [domain@localhost:9999 /] /socket-binding-group=standard-sockets/socket-binding=newsocket/:read-resource

  • 使用管理控制台配置套接字绑定

    使用管理控制台配置套接字绑定。

    1. 登录到管理控制台。

       登录到受管域或独立服务器的管理控制台。

    2. 进入 Configuration 标签页。

       从屏幕顶部选择 Configuration 标签页。

    3. 从导航菜单里选择 Socket Binding 菜单条目。

       展开 General Configuration 菜单。选择 Socket Binding。如果您在使用受管域，请在 Socket Binding Groups 列表里选择所需的组。

    4. 添加新的套接字绑定

       1. 点击 Add 按钮。
       2. 输入 Name, Port 和 Binding Group 的值。
       3. 点击Save完成。

    5. 编辑套接字绑定

       1. 从列表里选择要编辑的套接字绑定并点击 Edit 按钮。
       2. 输入 Name, Interface 或Port 的值。
       3. 点击Save完成。

• 配置端口偏移

  选择管理 CLI 或管理控制台来配置您的端口偏移。

  • 使用管理 CLI 配置端口偏移

    使用管理 CLI 来配置端口偏移。

    1. 编辑端口偏移

       使用 write-attribute 操作来为端口偏移属性编写新的值。下面的例子更新了 server-two 的 socket-binding-port-offset 值为 250。这个服务器是默认本地主机组的成员。为使改动生效，服务器需要重启。

       [domain@localhost:9999 /] /host=master/server-config=server-two/:write-attribute(name=socket-binding-port-offset,value=250)

    2. 确认端口偏移属性

       通过 include-runtime=true 参数运行 read-resource 操作来确认值已修改以开放服务器模型里所有当前的值。

       [domain@localhost:9999 /] /host=master/server-config=server-two/:read-resource(include-runtime=true)

  • 使用管理控制台来配置端口偏移

    使用管理控制台来配置端口偏移。

    1. 登录到管理控制台。

       登录到您的受管域的管理控制台。

    2. 选择 Domain 标签页

       从屏幕顶部选择 Domain 标签页。

    3. 编辑端口偏移属性

       1. 在 Available Server Configurations 列表里选择服务器并点击属性列表顶部的 Edit 按钮。
       2. 在 Port Offset 字段里输入想要的值。
       3. 点击Save完成。

过程 5.1. 禁用 IPv4 Stack Java 属性

1. 打开相关的安装文件：

   • 对于独立服务器：

     打开 EAP_HOME/bin/standalone.conf。

   • 对于受管域：

     打开 EAP_HOME/bin/domain.conf。
2. 修改 IPv4 Stack Java 属性为 false:

   -Djava.net.preferIPv4Stack=false

   例如：

   # Specify options to pass to the Java VM.
   #
   if [ "x$JAVA_OPTS" = "x" ]; then
      JAVA_OPTS="-Xms64m -Xmx512m -XX:MaxPermSize=256m -Djava.net.preferIPv4Stack=false 
      -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 
      -Dsun.rmi.dgc.server.gcInterval=3600000 -Djava.net.preferIPv6Addresses=true"
   fi
   

过程 5.2. 配置 IPv6 网络的接口

1. 从屏幕顶部选择 Configuration 标签页。
2. 展开 General Configuration 菜单并选择 Interfaces。
3. 从 Available Interfaces 列表里选择接口。
4. 点击细节列表里的 Edit 按钮。
5. 设置 inet 地址为：

   ${jboss.bind.address.management:[ADDRESS]}

6. 点击Save完成。
7. 重启服务器来应用这些修改。

过程 5.3. 配置 JBoss EAP 6 安装首选 IPv6 地址

1. 打开相关的安装文件：

   • 对于独立服务器：

     打开 EAP_HOME/bin/standalone.conf。

   • 对于受管域：

     打开 EAP_HOME/bin/domain.conf。
2. 附加下列 Java 属性到 Java VM 选项：

   -Djava.net.preferIPv6Addresses=true

   例如：

   # Specify options to pass to the Java VM.
   #
   if [ "x$JAVA_OPTS" = "x" ]; then
      JAVA_OPTS="-Xms64m -Xmx512m -XX:MaxPermSize=256m -Djava.net.preferIPv4Stack=false 
      -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 
      -Dsun.rmi.dgc.server.gcInterval=3600000 -Djava.net.preferIPv6Addresses=true"
   fi
   

过程 6.1. 修改 JDBC 驱动 JAR

1. 修改或创建空的临时目录。
2. 创建一个 META-INF 子目录。
3. 创建一个 META-INF/services 子目录。
4. 创建一个 META-INF/services/java.sql.Driver 文件，它包含一行指明 JDBC 驱动的全限定类名的内容。
5. 使用 JAR 命令行工具来更新 JAR：

   jar \-uf jdbc-driver.jar META-INF/services/java.sql.Driver

过程 6.2. 部署 JDBC 驱动

1. 访问管理控制台。

   第 3.4.2 节 “登录到管理控制台”

2. 将 JAR 文件部署到服务器或服务器组。

   如果你使用了受管域，你可以将 JAR 文件部署到服务器组。否则，部署到自己的服务器。请参考 第 10.2.2 节 “用管理控制台启用已部署的应用程序”。

过程 6.3. 将 JDBC 驱动安装为核心模块

1. 在 EAP_HOME/modules/ 目录下创建一个文件路径结构。例如，对于 MySQL JDBC 驱动，创建下列目录结构：EAP_HOME/modules/com/mysql/main/。
2. 将 JDBC 驱动的 JAR 文件复制到 main/ 子目录。
3. 在 main/ 子目录里，创建一个类似于下列示例的 module.xml 文件： 第 7.1.1 节 “模块”。module XSD 在 EAP_HOME/docs/schema/module-1_2.xsd 文件里进行定义。
4. 启动服务器。
5. 启动管理 CLI。
6. 运行 CLI 命令将 JDBC 驱动模块添加到服务器配置里。
   你选择的命令取决于 JDBC 驱动 JAR 里的 /META-INF/services/java.sql.Driver 文件里列出的类的数量。例如，MySQL 5.1.20 JDBC JAR 里的 /META-INF/services/java.sql.Driver 文件列出了两个类：

   • com.mysql.jdbc.Driver
   • com.mysql.fabric.jdbc.FabricMySQLDriver

   当有多个条目时，您必须也指定驱动类的名称。没这样做会导致这样的错误：

   JBAS014749: Operation handler failed: Service jboss.jdbc-driver.mysql is already registered

   • 为包含一个驱动类条目的 JDBC JAR 运行 CLI 命令。

     /subsystem=datasources/jdbc-driver=DRIVER_NAME:add(driver-name=DRIVER_NAME,driver-module-name=MODULE_NAME,driver-xa-datasource-class-name=XA_DATASOURCE_CLASS_NAME)

     例 6.1. 用于具有一个驱动类的 JDBC JAR 的独立模式的 CLI 命令示例

     /subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql,driver-xa-datasource-class-name=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource)

     例 6.2. 用于具有一个驱动类的 JDBC JAR 的域模式的 CLI 命令示例

     /profile=ha/subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql,driver-xa-datasource-class-name=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource)

   • 为具有多个驱动类条目的 JDBC JAR 运行 CLI 命令。

     /subsystem=datasources/jdbc-driver=DRIVER_NAME:add(driver-name=DRIVER_NAME,driver-module-name=MODULE_NAME,driver-xa-datasource-class-name=XA_DATASOURCE_CLASS_NAME, driver-class-name=DRIVER_CLASS_NAME)

     例 6.3. 用于具有多个驱动类条目的 JDBC JAR 的独立模式的 CLI 命令示例

     /subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql,driver-xa-datasource-class-name=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource, driver-class-name=com.mysql.jdbc.Driver)

     例 6.4. 用于具有多个驱动类条目的 JDBC JAR 的域模式的 CLI 命令示例

     /profile=ha/subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql,driver-xa-datasource-class-name=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource, driver-class-name=com.mysql.jdbc.Driver)

过程 6.4. 在应用程序里添加依赖关系

• • 配置 MANIFEST.MF 文件

    1. 在文本编辑器里打开应用程序的 META-INF/MANIFEST.MF 文件。
    2. 为 JDBC 模块添加一个依赖关系并保存文件。

       依赖关系：MODULE_NAME

       例 6.5. 依赖关系示例

       依赖关系：com.mysql

  • 1. 创建一个 jboss-deployment-structure.xml 文件

       在应用程序的 META-INF/ or WEB-INF 文件夹里创建一个名为 jboss-deployment-structure.xml 的文件。

       例 6.6. jboss-deployment-structure.xml 文件示例

       <jboss-deployment-structure>
         <deployment>
           <dependencies>
             <module name="com.mysql" />
           </dependencies>
         </deployment>
       </jboss-deployment-structure>
       
       

过程 6.5. 用管理 CLI 或管理控制台创建一个数据源

• • 管理 CLI

    1. 启动 CLI 工具并连接到您的服务器。
    2. 运行下列命令来创建 Non-XA 数据源，配置合适的变量：

       data-source add --name=DATASOURCE_NAME --jndi-name=JNDI_NAME --driver-name=DRIVER_NAME  --connection-url=CONNECTION_URL

    3. 启用数据源：

       data-source enable --name=DATASOURCE_NAME

  • 管理控制台

    1. 登陆到管理控制台。

    2. 进入管理控制台的 Datasources 面板

       1. 从控制台顶部选择 Configuration 标签页。
       2. 对于域模式，从左上角的下拉菜单里选择合适的配置集。
       3. 展开控制台左侧的 Subsystems 菜单，然后展开 Connector 菜单。
       4. 从控制台左侧的菜单里选择 Datasources。

    3. 创建新的数据源

       1. 点击 Datasources 面板顶部的 Add 按钮。
       2. 在 Create Datasource 向导里输入新的数据源属性并点击 Next 按钮。
       3. 在 Create Datasource 向导里输入 JDBC 驱动细节并点击 Next 按钮。
       4. 在 Create Datasource 向导里输入连接设置。
       5. 点击 Test Connection 按钮测试到数据源的连接并检验设置是否正确。
       6. 点击 Done 完成。

过程 6.6. 修改 Non-XA 数据源

• • 管理 CLI

    1. 第 3.5.2 节 “启动管理 CLI”.
    2. 使用 write-attribute 命令来配置数据源属性：

       /subsystem=datasources/data-source=DATASOURCE_NAME:write-attribute(name=ATTRIBUTE_NAME,value=ATTRIBUTE_VALUE)

    3. 重载服务器来确认修改：

       :reload

  • 管理控制台

    1. 第 3.4.2 节 “登录到管理控制台”.

    2. 进入管理控制台的 Datasources 面板

       1. 从控制台顶部选择 Configuration 标签页。
       2. 对于域模式，从左上角的下拉菜单里选择合适的配置集。
       3. 展开控制台左侧的 Subsystems 菜单，然后展开 Connector 菜单。
       4. 从展开的菜单选择 Datasources。

    3. 编辑数据源

       1. 从 Available Datasources 列表里选择相关的数据源。下面显示了数据源属性。
       2. 点击 Edit 按钮来编辑数据源属性。
       3. 点击Save完成。

过程 6.7. 删除 Non-XA 数据源

• • 管理 CLI

    1. 第 3.5.2 节 “启动管理 CLI”.
    2. 运行下列命令来删除 Non-XA 数据源：

       data-source remove --name=DATASOURCE_NAME

  • 管理控制台

    1. 第 3.4.2 节 “登录到管理控制台”.

    2. 进入管理控制台的 Datasources 面板

       1. 从控制台顶部选择 Configuration 标签页。
       2. 对于域模式，从左上角的下拉菜单里选择合适的配置集。
       3. 展开控制台左侧的 Subsystems 菜单，然后展开 Connector 菜单。
       4. 选择 Datasources。
    3. 选择要删除的数据源，然后点击 Remove。

过程 6.8. 用管理 CLI 或管理控制台创建 XA 数据源

• • 管理 CLI

    1. 第 3.5.2 节 “启动管理 CLI”.
    2. 运行下列命令来创建 XA 数据源，配置合适的变量：

       xa-data-source add --name=XA_DATASOURCE_NAME --jndi-name=JNDI_NAME --driver-name=DRIVER_NAME --xa-datasource-class=XA_DATASOURCE_CLASS

    3. 配置 XA 数据源属性

       1. 设置服务器名称

          运行下列命令来配置主机的服务器名称：

          /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME/xa-datasource-properties=ServerName:add(value=HOSTNAME)

       2. 设置数据库名称

          运行下列命令来配置数据库名称：

          /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME/xa-datasource-properties=DatabaseName:add(value=DATABASE_NAME)

    4. 启用数据源：

       xa-data-source enable --name=XA_DATASOURCE_NAME

  • 管理控制台

    1. 第 3.4.2 节 “登录到管理控制台”.

    2. 进入管理控制台的 Datasources 面板

       1. 从控制台顶部选择 Configuration 标签页。
       2. 对于域模式，从左上角的下拉菜单里选择合适的配置集。
       3. 展开控制台左侧的 Subsystems 菜单，然后展开 Connector 菜单。
       4. 选择 Datasources。
    3. 选择 XA Datasource 标签页。

    4. 创建新的 XA 数据源

       1. 点添加。
       2. 在 Create XA Datasource 向导里输入新的 XA 数据源属性并点击 Next 按钮。
       3. 在 Create XA Datasource 向导里输入 JDBC 驱动细节并点击 Next 按钮。
       4. 输入 XA 属性并点击 Next。
       5. 在 Create XA Datasource 向导里输入连接设置。
       6. 点击 Test Connection 按钮测试到 XA 数据源的连接并检验设置是否正确。
       7. 点击 Done 完成。

过程 6.9. 用管理 CLI 或管理控制台修改 XA 数据源

• • 管理 CLI

    1. 第 3.5.2 节 “启动管理 CLI”.

    2. 配置 XA 数据源属性

       使用 write-attribute 命令来配置数据源属性：

       /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME:write-attribute(name=ATTRIBUTE_NAME,value=ATTRIBUTE_VALUE)

    3. 配置 XA 数据源属性

       运行下列命令来配置 XA 数据源子资源：

       /subsystem=datasources/xa-data-source=DATASOURCE_NAME/xa-datasource-properties=PROPERTY_NAME:add(value=PROPERTY_VALUE)

    4. 重载服务器来确认修改：

       :reload

  • 管理控制台

    1. 第 3.4.2 节 “登录到管理控制台”.

    2. 进入管理控制台的 Datasources 面板

       1. 从控制台顶部选择 Configuration 标签页。
       2. 对于域模式，从左上角的下拉菜单里选择合适的配置集。
       3. 展开控制台左侧的 Subsystems 菜单，然后展开 Connector 菜单。
       4. 选择 Datasources。
    3. 选择 XA Datasource 标签页。

    4. 编辑数据源

       1. 从 Available XA Datasources 列表里选择相关的数据源。XA 数据源属性显示在下面的 Attributes 面板上。
       2. 选择 Edit 按钮来编辑数据源属性。
       3. 编辑 XA 数据源属性并在完成时选择 Save 按钮。

过程 6.10. 用管理 CLI 或管理控制台删除 XA 数据源

• • 管理 CLI

    1. 第 3.5.2 节 “启动管理 CLI”.
    2. 运行下列命令来删除 XA 数据源：

       xa-data-source remove --name=XA_DATASOURCE_NAME

  • 管理控制台

    1. 第 3.4.2 节 “登录到管理控制台”.

    2. 进入管理控制台的 Datasources 面板

       1. 从控制台顶部选择 Configuration 标签页。
       2. 对于域模式，从左上角的下拉菜单里选择合适的配置集。
       3. 展开控制台左侧的 Subsystems 菜单，然后展开 Connector 菜单。
       4. 选择 Datasources。
    3. 选择 XA Datasource 标签页。
    4. 选择要删除的 XA 数据源，然后点击 Remove 按钮来永久地删除这个 XA 数据源。

过程 6.11. 

• /subsystem=datasources/data-source=ExampleDS/statistics=jdbc:read-resource(include-runtime=true)
  

  /subsystem=datasources/data-source=ExampleDS/statistics=pool:read-resource(include-runtime=true)
  

• /subsystem=datasources/data-source=ExampleDS/statistics=pool:write-attribute(name=statistics-enabled,value=true)
  

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