关于JBoss EAP配置文件中interface配置的一些总结

一、概述

在JBoss EAP的各种配置文件（包括standalone.xml、domain.xml、host.xml等等）中，interface部分是不太起眼的一部分。看起来比较简单，一般情况下也无须修改，但如果不小心一样会在实践中造成相当的困扰。本文对这部分进行一些经验性总结，至于更深层次的原理探究，一时还顾不上。

先做个铺垫，JBoss EAP已经预设置了四种interface，其绑定IP缺省为127.0.0.1，如下：

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

二、standalone.xml的配置

最简单也是最常用的JBoss EAP使用场景，是一个服务器上使用standalone.xml来运行单独的实例。此时，关于interface的配置只包括management和public两项：

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

不能简单地添加private和unsecure项，也不能将IP修改为实际IP，否则启动JBoss实例时会出错。

三、standalone-ha.xml或standalone-full-ha.xml的配置

通常用到standalone-ha.xml或standalone-full-ha.xml的场景比较少见，不过实际上用它们同样可以组建JBoss EAP集群，只不过比起domain模式来要麻烦一些。具体方法是：在各节点上采用相同的配置和部署，然后linux平台以 standalone.sh -c standalone-ha.xml（或standalone-full-ha.xml），而在windows平台以standalone.bat -c standalone-ha.xml（或standalone-full-ha.xml）启动。

另外，如果想在standalone.xml的基础上添加interface项或更改绑定IP，不妨在这两个配置文件的基础上修改。

以7.x版的standalone-ha.xml为例，关于interface的缺省设置为：

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

而standalone-full-ha.xml中还报括了unsecure项，缺省IP也是127.0.0.1。

如果需要用standalone-ha.xml或standalone-full-ha.xml配置为JBoss集群，则绑定IP均需改为服务器各自的实际IP。如果不需要组成集群，则改与不改均可。

四、domain.xml的配置

通常情况下，组件JBoss集群大都使用domain.xml + host.xml的配置。

对于6.x和7.x版，domain.xml中关于interface的配置有所不同：

    <!-- 6.x的缺省配置 -->
    <interfaces>
        <interface name="management"/>
        <interface name="public"/>
        <interface name="unsecure"/>
    </interfaces>

    <!-- 7.x的缺省配置 -->
    <interfaces>
        <interface name="management"/>
        <interface name="public"/>
        <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>

不管是哪一种，都不需要对其进行修改。

五、host.xml的配置

host.xml（host-master.xml和host-slave.xml同理）的情况要复杂一些。

对于6.x版，缺省配置为：

    <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="unsecure">
            <!-- Used for IIOP sockets in the standard configuration.
                 To secure JacORB you need to setup SSL -->
            <inet-address value="${jboss.bind.address.unsecure:127.0.0.1}"/>
        </interface>
    </interfaces>

如果要组成集群或从开通外部访问，需将三处127.0.0.1修改为服务器的实际IP。注意，这里没有private项。

对于7.x，缺省配置只包含management和public两项，为：

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

如果只是单纯地开通外部访问，将两处127.0.0.1修改为服务器的实际IP即可。

但如果还要组成集群（使用ha或full-ha的profile），则必须增加private项（为保险unsecure项也一起增加），否则将来无法实现负载均衡和session复制。另外，别忘记将此处所有的127.0.0.1修改为服务器的实际IP。

六、总结

再次吐个槽：JBoss EAP的资料太少，完全靠自己摸索，效率不高。