JBoss服务器多实例配置指南

时间：2024.5.2

2008-11-21

博客分类：

问题描述:

启用jboss多个实例，可能会遇到端口冲突。比如http端口，jms端口等等。

解决方案:

默认情况下，jboss的端口定义在内置Tomcat的server.xml里面配置。如果开启多个实例，那么就要依次更新这几个文件的端口，相当麻烦。jboss提供了一个很方便的mbean来

统一管理多实例配置 --ServiceBindingManager。

基本思想如下：

jboss提供一个服务器端口绑定文件--xxx-bindings.xml，里面定义了多个以server-name为标志的端口，它就作为统一的端口绑定配置文件。然后在每个服务器实例的jboss-server.xml中注册一个端口绑定服务ServiceBindingManager,该服务用参数 --ServerName：指定xxx-bindings.xml对应的端口配置

--StoreURL：指定xx-bindings.xml文件的位置

一旦该服务注册，则Tomcat下server.xml的端口设置被忽略，而启用新的端口配置。

实施步骤：

1.拷贝${jboss_home}\docs\examples\binding-manager\sample-bindings.xml的文件到${jboss_home}\server下，重新命名为server-bindings.xml(可以不拷贝，拷贝是因为结构清晰)。文件里面已经内置了4个server的端口绑定，因此在默认情况下，你至少可以启用4个jboss服务实例。

2. 修改server-bindings.xml文件中需要启动的ServerName的tomcat启动端口.例如:ports-default的tomcat<binding port="8080"/>修改为<binding port="8081"/>;ports-default的tomcat<binding port="8180"/>修改为<binding port="8888"/>

3. 修改每个jboss服务实例下的jboss-server.xml文件，把Service Binding配置的注释去掉，修改其中参数serverName和server-bindings.xml文件的路径。比如default下的的jboss-server.xml文件ServiceBindingManager改为：

Xml代码

JBoss服务器多实例配置指南

8. <mbean code="org.jboss.services.binding.ServiceBindingManager" name="jboss.system:service=ServiceBindingManager"> <attribute name="ServerName">ports-default</attribute> <attribute name="StoreURL">${jboss.home.url}/server/server-bindings.xml</attribute> <attribute name="StoreFactoryClassName"> org.jboss.services.binding.XMLServicesStoreFactory </attribute> </mbean>

test下的的jboss-server.xml文件ServiceBindingManager改为：

Xml代码

JBoss服务器多实例配置指南

8. <mbean code="org.jboss.services.binding.ServiceBindingManager" name="jboss.system:service=ServiceBindingManager"> <attribute name="ServerName">ports-01</attribute> <attribute name="StoreURL">${jboss.home.url}/server/server-bindings.xml</attribute> <attribute name="StoreFactoryClassName"> org.jboss.services.binding.XMLServicesStoreFactory </attribute> </mbean>

4. (这个步骤不知道是不是必须的)修改每个jboss服务实例下的Tomcat的配置文件server.xml文件的端口,使其与server-bindings.xml文件中的端口相对应.例如:default下的server.xml中的

为8081;test下的server.xml中的 为8888;

5. 启动各个服务实例。 run.bat -c xxx。假如你有2个实例default, test，则运行： run.bat -c default

run.bat -c test

第二篇：JBoss 5

JBoss 5.0 安装与配置详解

一．下载与安装JBoss

在本文中，我下载的JBoss版本为：JBOSS5.0 Beta4。

下载地址： /jbossas/downloads/

在如上的下载页中下载JBOSS5.0 Beta4.zip文件。

下载完成后，将其解压缩后即可完成安装，解压缩后将其放置到一个不带空格的目录(若目录带有空格，例如：C:"Program Files，日后可能会产生一些莫名的错误)，eg：E:"JBossJBOSS5.0 Beta4。同时在“环境变量设置”中设置名为JBOSS_HOME的环境变量，值为JBoss的安装路径

在此，JBoss的安装工作已经结束，可通过如下方式测试安装是否成功：运行JBoss安装目录"bin"run.bat，如果窗口中没有出现异常，且出现：10:16:19,765 INFO [Server] JBoss (MX MicroKernel) [5.0.Beta4 (build: SVNTag=5.0.Beta4 date=20080831605)] Started in 30s:828ms字样，则表示安装成功。

我们可以通过访问： http://localhost:8080/ 进入JBoss的欢迎界面，点击JBoss Management下的JMX Console可进入JBoss的控制台。

若启动失败，可能由以下原因引起：

1） JBoss所用的端口（8080，1099，1098，8083等）被占用。一般情况下为8080端口被占用（例如，Oracle占用了8080端口），此时需要修改JBoss的端口，方法为进入JBoss安装目录

"server"default"deployer"jboss-web.deployer 目录，修改其下的

server.xml目录，在此文件中搜索8080，将其改成你想要的端口即可（例如8088）；

2） JDK安装不正确；

3） JBoss下载不完全。

二． JBoss 的目录结构说明

描述

bin

启动和关闭 JBoss 的脚本（ run.bat 为 windows 系统下的启动脚本， shutdown.bat 为 windows 系统下的关闭脚本）。

client

客户端与 JBoss 通信所需的 Java 库（ JARs ）。

docs

配置的样本文件（数据库配置等）。

docs/dtd

在 JBoss 中使用的各种 XML 文件的 DTD 。

lib

一些 JAR ， JBoss 启动时加载，且被所有 JBoss 配置共享。（不要把你的库放在这里）

server

各种 JBoss 配置。每个配置必须放在不同的子目录。子目录的名字表示配置的名字。 JBoss 包含 3 个默认的配置： minimial ， default 和 all ，在你安装时可以进行选择。

server/all

JBoss 的完全配置，启动所有服务，包括集群和 IIOP 。

server/default

JBoss 的默认配置。在没有在 JBoss 命令行中指定配置名称时使用。 ( 我们下载的 JBOSS5.0 Beta4 版本默认采用此配置 ) 。

server/default/conf

JBoss 的配置文件。

server/default/data

JBoss 的数据库文件。比如，嵌入的数据库，或者 JBossMQ

server/default /deploy

JBoss 的热部署目录。放到这里的任何文件或目录会被 JBoss 自动部署。 EJB 、 WAR 、 EAR ，甚至服务。

server/default /lib

一些 JAR ， JBoss 在启动特定配置时加载他们。 (default 和 minimial 配置也包含这个和下面两个目录。 )

server/default/log

JBoss 的日志文件。

server/default/tmp

JBoss 的临时文件。

三． JBoss 的配置

1. 日志文件设置

若需要修改JBoss默认的log4j设置，可修改JBoss安装目录

"server"default"conf下的jboss-log4j.xml文件，在该文件中可以看到，log4j的日志输出在JBoss安装目录"server"default"log下的server.log文件中。对于log4j的设置，读者可以在网上搜索更加详细的信息。

2. web 服务的端口号的修改

这点在前文中有所提及，即修改JBoss安装目录

"server"default"deployer"jboss-web.deployer下的server.xml文件，内容如下：

<Connector port="8080" address="${jboss.bind.address}"

maxThreads="250" maxHttpHeaderSize="8192"

emptySessionPath="true" protocol="HTTP/1.1"

enableLookups="false" redirectPort="8443"

acceptCount="100"

connectionTimeout="20000" disableUploadTimeout="true" /> 将上面的8080端口修改为你想要的端口即可。重新启动JBoss后访问：http://localhost/:新设置的端口，可看到JBoss的欢迎界面。

3. JBoss 的安全设置

1） jmx-console 登录的用户名和密码设置

默认情况访问 http://localhost:8080/jmx-console 就可以浏览jboss的部署管理的一些信息，不需要输入用户名和密码，使用起来有点安全隐患。下面我们针对此问题对jboss进行配置，使得访问jmx-console也必须要知道用户名和密码才可进去访问。步骤如下：

i) 找到JBoss安装目录

/server/default/deploy/jmx-console.war/WEB-INF/jboss-web.xml文件，去掉<security-domain>java:/jaas/jmx-console</security- domain>的注释。修改后的该文件内容为：

Java代码

JBoss5

1. <jboss-web>

3. <!-- Uncomment the security-domain to enable security. You will

5. need to edit the htmladaptor login configuration to setup the

7. login modules used to authentication users.--> 8.

9. <security-domain>java:/jaas/jmx-console</security-domain>

10.

11.</jboss-web>

Java代码

1. <jboss-web>

3. <!-- Uncomment the security-domain to enable security. You will

5. need to edit the htmladaptor login configuration to setup the

7. login modules used to authentication users.--> 8.

9. <security-domain>java:/jaas/jmx-console</security-domain>

10.

11.</jboss-web>

ii）修改与i）中的jboss-web.xml同级目录下的web.xml文件，查找到<security-constraint/>节点，去掉它的注释，修改后该部分内容为：

Java代码

JBoss5

1. <!-- A security constraint that restricts access to the HTML JMX console

3. to users with the role JBossAdmin. Edit the roles to what you want and

5. uncomment the WEB-INF/jboss-web.xml/security-domain element to enable

7. secured access to the HTML JMX console.-->

9. <security-constraint>

10.

11. <web-resource-collection>

12.

13. <web-resource-name>HtmlAdaptor</web-resource-name> 14.

15. <description>An example security config that only allows users with the

16.

17. role JBossAdmin to access the HTML JMX console web application

18.

19. </description>

20.

21. <url-pattern>/*</url-pattern>

22.

23. <http-method>GET</http-method>

24.

25. <http-method>POST</http-method>

26.

27. </web-resource-collection>

28.

29. <auth-constraint>

30.

31. <role-name>JBossAdmin</role-name>

32.

33. </auth-constraint>

34.

35. </security-constraint>

Java代码

JBoss5

1. <!-- A security constraint that restricts access to the HTML JMX console

3. to users with the role JBossAdmin. Edit the roles to what you want and

5. uncomment the WEB-INF/jboss-web.xml/security-domain element to enable

7. secured access to the HTML JMX console.-->

9. <security-constraint>

10.

11. <web-resource-collection>

12.

13. <web-resource-name>HtmlAdaptor</web-resource-name> 14.

15. <description>An example security config that only allows users with the

16.

17. role JBossAdmin to access the HTML JMX console web application

18.

19. </description>

20.

21. <url-pattern>/*</url-pattern>

22.

23. <http-method>GET</http-method>

24.

25. <http-method>POST</http-method>

26.

27. </web-resource-collection>

28.

29. <auth-constraint>

30.

31. <role-name>JBossAdmin</role-name>

32.

33. </auth-constraint>

34.

35. </security-constraint>

在此处可以看出，为登录配置了角色JBossAdmin。

iii）在第一步中的jmx-console安全域和第二步中的运行角色JBossAdmin都是在login-config.xml中配置，我们在JBoss安装目录

/server/default/config下找到它。查找名字为：jmx-console的application-policy：

Java代码

JBoss5

1. <application-policy name = "jmx-console">

2. <authentication>

3. <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule"

4. flag = "required">

5. <module-option name="usersProperties">props/jmx-console-users.properties</module-option>

6. <module-option name="rolesProperties">props/jmx-console-roles.properties</module-option>

7. </login-module>

8. </authentication>

9. </application-policy>

Java代码

JBoss5

1. <application-policy name = "jmx-console">

2. <authentication>

3. <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule"

4. flag = "required">

5. <module-option name="usersProperties">props/jmx-console-users.properties</module-option>

6. <module-option name="rolesProperties">props/jmx-console-roles.properties</module-option>

7. </login-module>

8. </authentication>

9. </application-policy>

在此处可以看出，登录的角色、用户等的信息分别在props目录下的

jmx-console-roles.properties和jmx-console-users.properties文件中设置，分别打开这两个文件。

其中jmx-console-users.properties文件的内容如下：

# A sample users.properties file for use with the

UsersRolesLoginModule

admin=admin

该文件定义的格式为：用户名=密码，在该文件中，默认定义了一个用户名为admin，密码也为admin的用户，读者可将其改成所需的用户名和密码。

jmx-console-roles.properties的内容如下：

# A sample roles.properties file for use with the UsersRolesLoginModule

admin=JBossAdmin, HttpInvoker

该文件定义的格式为：用户名=角色，多个角色以“,”隔开，该文件默认为admin用户定义了JBossAdmin和HttpInvoker这两个角色。

配置完成后读者可以通过访问： http://localhost:8088/jmx-console/ ，输入jmx-console-roles.properties文件中定义的用户名和密码，访问jmx-console的页面。

四．在MyEclipse 中配置JBoss

笔者的MyEclipse版本：6.5 GA

JBoss版本：5.0

JDK版本：1.6

进入Window-> Preferences-> MyEclipse -> Application Servers -> JBoss5，进行如下设置：

JBoss5

更多相关推荐：

客栈服务指南范本: 一抹时光客栈热忱欢迎阁下光临尊敬的客人欢迎您入住一抹时光客栈您的到来我们全体员工都感到非常荣幸此服务指南为您详细介绍了客栈的各项服务及设施若您有什么需要请直接与客栈前台联系我们将竭诚为您效劳在一抹时光客栈您是我...
服务指南范本: 请爱惜这里的设施如有缺失或损坏请及时与服务台或总台联系感谢您的配合本服务指南价值30元请勿在上面乱写乱画或抽页如有缺损请照价赔偿请爱惜这里的设施如有缺失或损坏请及时与服务台或总台联系感谢您的配合本服务指南价值3...
酒店服务指南模板: 祥瑞丽景酒店服务指南欢迎光临欢迎您来到祥瑞丽景酒店您会发现这是一个可使您达到最佳休闲度假的好地方祥瑞丽景酒店将为您提供独具一格的环境人性化的服务以及使您焕发休闲活力的设施与众不同的景象湖泊岛屿和天然氧吧在等候您...
酒店服务指南模板: 玉龙山氡泉度假村服务指南欢迎光临欢迎您来到玉龙山氡泉度假村您会发现这是一个可使您达到最佳休闲度假的好地方玉龙山氡泉度假村将为您提供独具一格的环境人性化的服务以及使您焕发休闲活力的设施与众不同的景象温泉峡谷和天然...
服务指南模板: Xx领导至xx调研服务指南中共县委办公室县人民政府办公室20xx年8月8日一日程安排2二用餐安排3三住宿安排4四调研点简介5
接待服务指南模板: 来市考察调研服务指南制作或接待单位年月日目录1考察调研领导名单2陪同人员名单3考察调研组行程安排4食宿安排5联系电话调研组人员名单职务职务司机陪同人员名单职务职务省委宣传部调研组行程安排月日上午900从出发11...
会议服务指南大全: 会议服务指南大全一根据客户的意愿要求策划组织执行会议的各项接待工作让会议客户放心满意最大化让会议接待服务优质最大化二免费代订各星级酒店各级餐厅各种会议室并给予客户最优惠内部协议价做好会议用房会议用餐会议室的使用...

道真嘉联酒店服务指南(中英文版)11.21: 总经理致辞尊敬的宾客欢迎您下榻道真嘉联酒店我们将以优质的服务盛情接待让您高兴而来满意而归我们殷切期望酒店的服务和设施能令阁下感到满意为了方便您的出行特奉上此服务指南以供参阅祝您在和我们相处的日子里身心愉快并期待...
美美时尚酒店服务指南: 美美时尚酒店服务指南酒店简介美美时尚酒店是南宁市青秀区的一家集客房餐饮为一体的时尚经济型商务酒店本酒店位于南宁市青秀区区的中轴线核心地段地处南宁市东葛路核心商圈地段繁华毗国际会展中心白沙大桥葫芦顶大桥东达埌东客...
会议服务指南: XX区XXXXXX工作会议会议指南二一二年四月服务指南尊敬的各位领导和代表您好热忱欢迎您参加20xx年全区XX工作会议本次会议全体工作人员将竭诚为您服务为使您在会议期间生活方便保证会议的顺利进行现将有关事项告知...

酒店服务指南: 服务指南ServicesDirectory五千年文博园总经理致辞尊敬的宾客欢迎您光临五千年文博园皖府国际大酒店酒店全体员工热诚欢迎海内外宾客以及各组织单位旅游团体下榻我们将以一流的环境一流的设施一流的服务盛情接...
酒店服务指南: 尊敬的宾客欢迎阁下光临新紫金酒店新紫金酒店竭诚为宾客缔造舒适雅致便利亲切的生活空间我们将以殷勤的服务令您有宾至如归的感受为阁下提供完善的住宿餐饮桑拿醋疗养生休闲娱乐商务等服务如阁下有任何需要请与大堂经理联系我们...

热门关注