第 2 章 管理 JBoss EAP

您也可以在 add-user 脚本里传入参数来非交互式地创建用户。我们不推荐在共享系统上使用这个方法，因为密码将出现在日志和历史文件里。更多信息请参考 Running the Add-User Utility Non-Interactively。

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

创建属于多个组的用户

下面的命令添加一个属于 guest 和 mgmtgroup 组的管理性用户（mgmtuser1）。

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

指定替代属性文件

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

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

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

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

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

添加至用户属性文件的新用户现在存储在 /path/to/standaloneconfig/newname.properties 和 /path/to/domainconfig/newname.properties。请注意这些文件必须已经存在，否则您会看到错误信息。

关于所有可用的 add-user 脚本参数及其用途的完整列表，请使用 --help 参数查看或者参考 Add-User Utility Arguments 章节。

管理命令行接口（management command-line interface，CLI）是一个 JBoss EAP 的命令行管理工具。

使用管理 CLI 启动和停止服务器、部署和卸载应用程序、配置系统设置并执行其他管理任务。操作可以批量模式进行，将多个任务作为一个组来运行。

它还有许多常用的终端命令，如 ls、cd 和 pwd。管理 CLI 也支持 Tab Completion。

关于使用管理 CLI 的详情，包括命令和操作、语法和批模式运行，请参考《JBoss EAP 管理 CLI 指南》。

启动管理 CLI

$ EAP_HOME/bin/jboss-cli.sh

连接至运行的服务器

connect

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

显示帮助

使用下列命令获取普通帮助信息。

help

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

deploy --help

退出管理 CLI

quit

查看系统设置

下列命令使用 read-attribute 操作来显示示例数据源是否已启用。

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

当运行在受管域里时，您必须在命令里用 /profile=PROFILE_NAME 参数指定要更新的配置集。

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

更新系统设置

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

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

启动服务器

管理 CLI 也可以用来启动和停止受管域里运行的服务器。

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

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

您可以使用管理控制台来启动和停止服务器、部署和卸载应用程序、调整系统设置并对服务器配置进行持久性修改。管理控制台也可以执行管理任务，并在修改需要服务器实例重启或重载时进行实时通知。

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

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

管理控制台下列标签页来导航和管理您的 JBoss EAP 独立服务器（standalone server）或受管域（managed domain）。

独立配置文件位于 EAP_HOME/standalone/configuration/ 目录，有四个单独的预定义的配置集文件（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 允许您使用表达式来定义配置里的可替换属性。表达式使用 ${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}}

嵌套表达式是递归地评估的，所以首先会评估 inner 表达式，然后是 outer 表达式。表达式也可以是递归的，表达式解析另外一个表达式，从而完成整个解析。允许表达式的地方就允许嵌套表达式，例外是管理 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 里，您可以使用基于描述符的属性替换以在外部管理配置。

基于描述符的属性替换（Descriptor-based property replacement）基于描述符替换属性，允许您从应用程序和构建链里删除关于环境的假设。您可以在部署描述符而不是应用程序或构建系统脚本里指定环境专有的配置。您可以在文件里或作为命令行参数提供配置。

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 标记控制的，它的默认值是 disabled。启用后可以替换下列属性描述符文件里的属性：

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

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

<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 参数。关于服务器启动选项的更多信息，请参考 Server Runtime Arguments。

网络接口是通过指定逻辑名和物理接口的选择标准来声明的。这个选择标准可以引用通配符地址或指定接口或地址必须具有的一系列特征以进行有效匹配。关于所有可用的接口选择标准的列表，请参考 Interface Attributes 章节。

接口可以用管理控制台或管理 CLI 来配置。下面是几个添加和更新接口的例子。它们首先显示管理 CLI 命令，然后是对应的配置 XML 内容。

添加具有 NIC 值的接口

添加 NIC 值为 eth0 的新接口。

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

对于每个预定义的配置集（default、ha、full、full-ha），JBoss EAP 都附带了一个套接字绑定组。

关于默认套接字绑定的详情，如默认端口和描述，请参考 Default Socket Bindings 章节。

独立服务器

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

例如，默认的独立配置文件（standalone.xml）指定下面的套接字绑定。

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

受管域

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

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

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

当定义套接字绑定时，您可以配置port 和 interface 属性，以及多点传送设置，如 multicast-address 和 multicast-port。关于所有可用的套接字绑定属性的细节，请参考 Socket Binding Attributes 章节。

套接字绑定可以用管理控制台或管理 CLI 来配置。下面的步骤会添加一个套接字绑定组、添加一个套接字绑定且用管理 CLI 配置套接字绑定设置。

下面的例子展示了完成上述步骤后 的 XML 配置。

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

端口偏移是添加到服务器的套接字组里指定的所有端口值的数字偏移量。这允许单个服务器继承服务器组的套接字绑定，并用偏移量来确保它和相同主机上其他服务器不冲突。例如，如果套接字绑定组的 HTTP 端口是 8080，而你的服务器使用了端口偏移量为 100，那么它的 HTTP 端口是 8180。

下面的例子用管理 CLI 设置受管域里的服务器的端口偏移量为 250。

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

端口偏移可以用于受管域里的服务器以及相同主机上运行的多台独立服务器。

在用 jboss.socket.binding.port-offset 属性启动独立服务器时，您可以传入一个端口偏移量。

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