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_homedomainconfiguration",打开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>

将所有127.0.0.1的地址,换成master server对应的真实IP(否则,无法从远程通过浏览器,访问jboss 管理控制台)

2.2 以domain模式启动master server

 jboss_homebindomain.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_homedomainconfiguration,将原来的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均可访问