7.7. 受管域配置


7.7.1. 将 JBoss EAP 作为受管域启动

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

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

先决条件

流程

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

    $ EAP_HOME/bin/domain.sh --host-config=host-primary.xml
    Copy to Clipboard Toggle word wrap
  2. 使用 host-secondary.xml 配置文件启动主机控制器,该文件已针对次要主机控制器进行了预配置。

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

根据您的域设置,您需要进行额外的配置连接到域控制器,而不冲突。另外,请查看以下域设置示例:

7.7.2. 配置域控制器

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

重要

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

流程

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

    <domain-controller>
      <local/>
    </domain-controller>
    Copy to Clipboard Toggle word wrap
  2. 公开一个管理界面,它应当可以被域中的其他主机访问。HTTP 接口是标准管理界面。

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

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

7.7.3. 配置主机控制器

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

重要

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

流程

  • 使用配置的 <domain-controller > 元素来配置与域控制器的连接。

    <domain-controller>
      <remote>
        <discovery-options>
          <static-discovery name="primary" protocol="${jboss.domain.primary.protocol:remote+http}" host="${jboss.domain.primary.address}" port="${jboss.domain.primary.port:9990}"/>
          </discovery-options>
      </remote>
    </domain-controller>
    Copy to Clipboard Toggle word wrap

示例最小主机控制器配置文件 EAP_HOME/domain/configuration/host-secondary.xml,包括用于连接域控制器的配置设置。配置假设您在启动主机控制器时提供 jboss.domain.primary.address 属性。

$ EAP_HOME/bin/domain.sh --host-config=host-secondary.xml -Djboss.domain.primary.address=<ip_address>
Copy to Clipboard Toggle word wrap

根据您的域设置,您可能还需要为主机控制器提供身份验证,以便由域控制器进行身份验证。如需了解 使用 secret 值生成管理用户并使用该值更新主机控制器配置的详情,请参阅在两台机器上设置受管域

7.7.4. 受管域的主机名配置

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

  • 如果设置,host.xml 配置文件中的 host 元素 name 属性。
  • jboss.host.name 系统属性的值。
  • jboss.qualified.host.name 系统属性前面带有第一个句点(.)字符的值,如果没有最终句点(.)字符,则该值或整个值。
  • 基于 POSIX 的操作系统的 HOSTNAME 环境变量中的句点(.)字符前面的值、适用于 Microsoft Windows 的 COMPUTERNAME 环境变量,如果没有最终句点(.)字符,则整个值。

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

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

7.7.5. 更新受管域中的主机名称

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

先决条件

  • JBoss EAP 作为受管域运行。

流程

  1. 启动管理 CLI,连接域控制器。

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

    /host=<existing_host_name>:write-attribute(name=name,value=<new_host_name>)
    Copy to Clipboard Toggle word wrap

    这会修改 host-secondary.xml 文件中的 host name 属性,如下所示:

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

    reload --host=<existing_host_name>
    Copy to Clipboard Toggle word wrap

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

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

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat