jboss eap 6.3 域(Domain)模式配置

踏雪寻梅

　　jboss提供了二种运行模式：standalone(独立运行模式)、domain(域模式)，日常开发中，使用standalone模式足已；但生产部署时，一个app，往往是部署在jboss集群环境中的，如果所有jboss server均采用standalone模式，会给运维带来极大的工作量，需要每台jboss server上逐一部署/更新，显然不适合。
　　domain模式正是为了解决这一问题，该模式下，所有jboss server可以划分成不同的group(注：这里的jboss server并不一定要对应某台物理机或虚拟机，一个os上，可以同时run多个jboss server实例，所以本文中的jboss server均指某个运行中的jboss server instance)，每个group中可以包含多个jboss server，所有这些jboss server中，可以指定一台做为域控制器(domain controller)，俗称master server，其它jboss server均为Home Controller(俗称slave server)。
　　master上可以控制所有jboss server，并监控其运行情况，部署应用时，一个war包，只需要部署到group上，该group中的所有jboss server即会同步自动部署。
　　下面是配置步骤：
　　环境：
　　windows ，jboss eap 6.3
　　机器资源：
　　172.21.129.181 (master)、172.21.129.57(slave57)、172.21.129.128(slave128) - 即：181为主机，57、128这二台机器为slave

　　一、下载安装jboss eap 6.3
　　目前jboss eap的最新版本是6.3 ，下载地址 https://www.jboss.org/products/eap/download/
　　下载完成后，解压到某个目录即可 (下面用jboss_home代替jboss根目录)
　　二、master server配置
　　2.1 进入 "jboss_home\domain\configuration"，打开host.xml





1     <interfaces>
2         <interface name="management">
3             <inet-address value="${jboss.bind.address.management:172.21.129.181}"/>
4         </interface>
5         <interface name="public">
6            <inet-address value="${jboss.bind.address:172.21.129.181}"/>
7         </interface>
8         <interface name="unsecure">
9             <!-- Used for IIOP sockets in the standard configuration.
10                  To secure JacORB you need to setup SSL -->
11             <inet-address value="${jboss.bind.address.unsecure:172.21.129.181}"/>
12         </interface>
13     </interfaces>
View Code　　将所有127.0.0.1的地址，换成master server对应的真实IP(否则，无法从远程通过浏览器，访问jboss 管理控制台)
　　2.2 以domain模式启动master server
　　jboss_home\bin\domain.bat
　　2.3 进入master jboss 控制台
　　http://172.21.129.181:9990/console/
　　首次进入，可能会提示没有创建管理员帐号，可参考 vmware安装cent os 6.5 + oracle 11g xe + jboss eap 6.2 + weblogic 12c+ webshpere mq 7.5 一文中的 3.4 c)中的相关内容，创建管理员
　　2.4 创建group、server
　　进入控制台后，可以看到jboss已经默认创建了一些group及server，先把他们全干掉吧(通常，我们会创建自己的group/server)
　　参考下面这个界面，创建二个组 my-group-1,my-group-2

　　tips: 创建group时，profile建议选择full-ha或ha (以后会讲如何做jboss集群配置，负载均衡、智能容错时，需要使用ha系列的profile)
　　重要提示：同一个局域网里如果有多个master，如果这些master上的group名称有重复，则只有第一master能启动成功后，后面的master启动时会报错，建议每个master上的group命名时，加上master的IP，比如group+IP地址，这样肯定不会重复！
　　参考下面的图，在master server上创建4个server

　　注：创建server时，有一个Port Offset选项（参考下图）

　　解释一下，默认情况下server的端口是8080，Port Offset指端口偏移量，如果按上图配置，Port Offset指定为5，则表示该server创建后，对应的端口为8080+5，即8085端口 (可以用http://172.21.129.181:8085/ 来访问)
　　tips: 如果一个server已经处于started状态，是无法remove的，可以先到下面的界面，把该server stop掉，然后再回这个界面，就可以Remove了

　　三、Slave Server配置
　　3.1 将jboss eap 6.3解压到172.21.129.57这台slave机器上
　　3.2 进入jboss_home\domain\configuration，将原来的host.xml改名备份，然后再将host-slave.xml复制一份，并改名为host.xml
　　3.3 修改host.xml
　　a)



1         <management-interfaces>
2             <native-interface security-realm="ManagementRealm">
3                 <socket interface="management" port="${jboss.management.native.port:9099}"/>
4             </native-interface>
5         </management-interfaces>
　　这里的9999端口，改成其它不使用的端口（比如：9099），否则slave server上的9999端口，与master server上的管理端口冲突，最后启动时，会报错
　　b)



1     <domain-controller>
2        <remote host="${jboss.domain.master.address:172.21.129.181}" port="${jboss.domain.master.port:9999}" security-realm="ManagementRealm"/>
3     </domain-controller>
　　第2行，指定master server的IP（本文中为172.21.129.181），这样slave在启动时，才知道去连哪一台master
　　c)



1     <interfaces>
2         <interface name="management">
3             <inet-address value="${jboss.bind.address.management:0.0.0.0}"/>
4         </interface>
5         <interface name="public">
6            <inet-address value="${jboss.bind.address:0.0.0.0}"/>
7         </interface>
8         <interface name="unsecure">
9             <!-- Used for IIOP sockets in the standard configuration.
10                  To secure JacORB you need to setup SSL -->
11             <inet-address value="${jboss.bind.address.unsecure:0.0.0.0}"/>
12         </interface>
13     </interfaces>
　　原来的127.0.0.1，改成slave server的真实IP或0.0.0.0，否则slave上的应用，只能在slave本机访问
　　d)



1     <servers>
2         <server name="slave-server-8082" group="my-group-2">
3             <socket-bindings port-offset="2"/>
4         </server>
5         <server name="slave-server-8083" group="my-group-2">           
6             <socket-bindings port-offset="3"/>
7         </server>
8     </servers>
　　手动在slave上创建二个server，并加入到my-group-2(注：group的值，必须是在master server上创建过的，否则启动时，slave上的server无法正常加入到master相关的group中)
　　e)



1 <host name="slave57" xmlns="urn:jboss:domain:1.6">
　　最开头的host节点上，加一个name="xxx"的属性(本文中为slave57)，这个name值最终会显示在master server的jboss 控制台中，建议起一个容易识别的名称
　　四、安全认证配置
　　4.1 回到master server上，添加一个名为slave57的管理员帐号，并记住最后生成的<secret value="xxxx" />的字符串(xxx为密码经过base64处理后的内容)
　　4.2 回到slave57这台server中，再次编辑host.xml，将<secret value="xxxx" />的内容替换



1 <server-identities>
2                      <!-- Replace this with either a base64 password of your own, or use a vault with a vault expression -->
3                      <!--<secret value="c2xhdmVfdXNlcl9wYXNzd29yZA=="/>-->
4                      <secret value="c2xhdmU1Ny4xMjM=" />
5                 </server-identities>
　　中的<secret value=... />部分
　　解释：slave启动时，需要连接注册到master的jboss中，连接过程需要安全认证，这里的secret相当于认证的钥匙，而认证的用户名即为：正在连接的slave机器上jboss中host.xml中<host name='xxx'>这个节点中的name值，所以4.1需要在master中创建一个名为“slave57”的管理员
　　4.3 依次以domain模式启动master、slave57 上的jboss
　　顺利的话，master的jboss控制台里，就能看到slave57已经自动注册进来了

　　另一台slave服务器，类似的做法，host.xml中<host>节点的name为slave128，创建的server为



1     <servers>
2         <server name="slave-server-8080" group="my-group-1"/>
3         <server name="slave-server-8081" group="my-group-1">
4             <!-- server-two avoids port conflicts by incrementing the ports in
5                  the default socket-group declared in the server-group -->
6             <socket-bindings port-offset="1"/>
7         </server>
8     </servers>
　　这样，我们就创建了8个jboss server实例(4个在master server上，另外4个分散在slave57、slave128上)，共划分为2组。

　　五、应用部署

　　进入部署界面（如上图），点击Add，添加一个war包，再Assign，分配到某一个group，即可自动部署到该group下所有server。如果想把一个app，部署到多个group，也没问题，再次点击assign，再分配到另一个group。
　　以本文为例，部署了一个名为SSO的应用到my-group-1、my-group-2后，对应的8台jboss server应该均可访问，即：
　　http://172.21.129.181:8080/SSO/
　　http://172.21.129.181:8081/SSO/
　　http://172.21.129.181:8082/SSO/
　　http://172.21.129.181:8083/SSO/
　　http://172.21.129.57:8082/SSO/
　　http://172.21.129.57:8083/SSO/
　　http://172.21.129.128:8080/SSO/
　　http://172.21.129.128:8081/SSO/
　　这8个url均可访问