域控制器是充当域的中央管理点的 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)