8.3. 启动受管域


8.3.1. 启动受管域

可以使用 JBoss EAP 提供的 domain .sh 或 domain. bat 脚本启动域控制器和主机控制器。有关所有可用启动脚本参数及其目的的完整列表,请使用 --help 参数或查看 服务器运行时参数和交换机 部分。

域控制器必须在域中任何服务器组的任何从属服务器之前启动。首先启动域控制器,然后在域中启动任何其他关联的主机控制器。

启动域控制器

使用 host-master.xml 配置文件启动域控制器,它已针对专用域控制器进行了预配置。

$ EAP_HOME/bin/domain.sh --host-config=host-master.xml
Copy to Clipboard Toggle word wrap

根据域设置,您需要进行额外的配置,以允许主机控制器进行连接。另请参阅以下域设置示例:

启动主机控制器

使用 host-slave.xml 配置文件启动主机控制器,它已为从属主机控制器进行了预配置。

$ EAP_HOME/bin/domain.sh  --host-config=host-slave.xml
Copy to Clipboard Toggle word wrap

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

8.3.2. 域控制器配置

您必须将域中的一个主机配置为域控制器。

重要

在使用 RPM 安装方法安装 JBoss EAP 时,不支持在同一计算机上配置多个域控制器或主机控制器。

通过在 < domain-controller > 声明中添加 <local/ > 元素,将主机配置为域控制器。<domain-controller> 应该不包含任何其他内容。

<domain-controller>
  <local/>
</domain-controller>
Copy to Clipboard Toggle word wrap

充当域控制器的主机必须公开一个可供域中其他主机访问的管理接口。HTTP 接口是标准的管理接口。

<management-interfaces>
  <http-interface security-realm="ManagementRealm" http-upgrade-enabled="true">
    <socket interface="management" port="${jboss.management.http.port:9990}"/>
  </http-interface>
</management-interfaces>
Copy to Clipboard Toggle word wrap

示例最小域控制器配置文件 EAP_HOME/domain/configuration/host-master.xml 包含这些配置设置。

8.3.3. 主机控制器配置

主机控制器必须配置为连接到域控制器,以便主机控制器能够将自身注册到域。

重要

在使用 RPM 安装方法安装 JBoss EAP 时,不支持在同一计算机上配置多个域控制器或主机控制器。

使用配置的 <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:9990}"/>
    </discovery-options>
  </remote>
</domain-controller>
Copy to Clipboard Toggle word wrap

示例最小主机控制器配置文件 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
Copy to Clipboard Toggle word wrap

有关域控制器发现的更多信息,请参阅 域控制器发现和故障转移部分

根据您的域设置,您可能还需要为主机控制器提供身份验证,以通过域控制器进行身份验证。如需了解 有关生成具有 secret 值的管理用户以及使用该值更新主机控制器配置的详细信息,请参阅在两个机器中设置受管域

8.3.4. 配置主机的名称

受管域中运行的每个主机必须具有唯一的主机名。为简化管理并允许在多个主机上使用相同的主机配置文件,服务器在确定主机名时要使用以下优先级:

  1. 如果设置,host .xml 配置文件中的 host 元素 name 属性。
  2. jboss.host.name 系统属性的值。
  3. jboss.qualified.host.name 系统属性中最后一个句点(. )字符后面的值;如果没有最终句点(.)字符,则为整个值。
  4. 基于 POSIX 的操作系统的 HOSTNAME 环境变量中的句点(.)字符后面的值、Microsoft Windows 的 COMPUTERNAME 环境变量,或者整个值(如果没有最终句点(.)字符)。

主机控制器的名称在相关 host .xml 配置文件顶部的主机元素中配置,例如:

<host xmlns="urn:jboss:domain:8.0" name="host1">
Copy to Clipboard Toggle word wrap

使用以下步骤,通过管理 CLI 更新主机名。

  1. 启动 JBoss EAP 主机控制器。

    $ EAP_HOME/bin/domain.sh --host-config=host-slave.xml
    Copy to Clipboard Toggle word wrap
  2. 启动管理 CLI,连接域控制器。

    $ EAP_HOME/bin/jboss-cli.sh --connect --controller=DOMAIN_CONTROLLER_IP_ADDRESS
    Copy to Clipboard Toggle word wrap
  3. 使用以下命令来设置新主机名:

    /host=EXISTING_HOST_NAME:write-attribute(name=name,value=NEW_HOST_NAME)
    Copy to Clipboard Toggle word wrap

    这会修改 host-slave.xml 文件中的主机名属性,如下所示:

    <host name="NEW_HOST_NAME" xmlns="urn:jboss:domain:8.0">
    Copy to Clipboard Toggle word wrap
  4. 重新加载主机控制器,使更改生效。

    reload --host=EXISTING_HOST_NAME
    Copy to Clipboard Toggle word wrap

如果主机控制器配置文件中没有设置名称,您也可以在运行时传递主机名。

$ EAP_HOME/bin/domain.sh --host-config=host-slave.xml  -Djboss.host.name=HOST_NAME
Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat