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">

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

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

    $ EAP_HOME/bin/domain.sh --host-config=host-slave.xml

  2. 启动管理 CLI，连接域控制器。 

    $ EAP_HOME/bin/jboss-cli.sh --connect --controller=DOMAIN_CONTROLLER_IP_ADDRESS

  3. 使用以下命令来设置新主机名： 

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

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

    <host name="NEW_HOST_NAME" xmlns="urn:jboss:domain:8.0">

  4. 重新加载主机控制器，使更改生效。 

    reload --host=EXISTING_HOST_NAME

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

$ EAP_HOME/bin/domain.sh --host-config=host-slave.xml  -Djboss.host.name=HOST_NAME