Jboss 基本配置

一 配置变量

首先，要安装JDK，配置JAVA_HOME环境变量

其次，将下载的JBoss解压，即完成安装。（解压目录最好不要有空格，否则运行容易出现异常）

然后，配置JBOSS_HOME环境变量，值为JBoss的解压路径

最后，可以运行％JBOSS_HOME％\bin\目录中的run.bat运行JBoss；地址栏输入http://localhost:8080/会进入JBoss的欢迎界面

二 目录结构说明

目录 描述
bin    包含启动和关闭JBoss等脚本文件。
docs  配置的样本文件（包括数据库配置等）。
docs/dtd   在JBoss中使用的各种XML文件的DTD文档。
lib    一些JAR，JBoss启动时加载，且被所有JBoss配置共享。
client客户端与JBoss通信所需的Java库（JARs）。
server各种JBoss配置。每个配置必须放在不同的子目录。子目录名字表示配置名字。JBoss包含3个默认的配置：minimial，default，all。在安装时可以进行选择。
server/default/confJBoss的配置文件。
server/default/dataJBoss的数据库文件。比如，嵌入的数据库或者JBossMQ。
server/default/deploy   JBoss的热部署目录。放到这里的任何文件或目录会被JBoss自动部署。包括EJB，WAR，EAR甚至服务。
server/default/lib一些JAR，JBoss在启动特定配置时加载它们。
server/default/logJBoss的日志文件。
server/default/tmpJBoss的临时文件。

三 JBoss的配置

1   web服务端口号的修改

这点在前文中有所提及，即修改JBoss安装目录"server"default"deploy"jboss-web.deployer下的server.xml文件，内容如下：

1. < Connector port="8080" address="${jboss.bind.address}" maxThreads="250"   
2.   maxHttpHeaderSize="8192" emptySessionPath="true" protocol="HTTP/1.1" 
3.   enableLookups="false" redirectPort="8443" acceptCount="100" 
4.   connectionTimeout="20000" disableUploadTimeout="true" /> 

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

2   JBoss的安全设置

（1）jmx－console登陆的用户名和密码设置

在%JBOSS_HOME%/server/default/deploy/jmx-console.war/WEB-INF/jboss-web.xml文件中
将注释文档去掉修改为：

1. < jboss-web> 
2.   < security-domain>java:/jaas/jmx-console< /security-domain> 
3.    < /jboss-web> 

在同目录下web.xml,查找< security-constraint/>节点，修改为：

1.    < security-constraint> 
2. < web-resource-collection> 
3.   < web-resource-name>HtmlAdaptor< /web-resource-name> 
4.   < description>An example security config that only allows user with the role   
5.  JBossAdmin to access the HTML JMX console web application  
6.   < /description> 
7.   < url-pattern>/*< /url-pattern> 
8.   < http-method>GET< /http-method> 
9.   < http-method>POST< /http-method> 
10. < /web-resource-collection> 
11. < auth-constraint> 
12.   < role-name>JBossAdmin< /role-name> 
13. < /auth-constraint> 
14.    < /security-constraint> 

在jmx-console安全域和运行角色JBossAdmin都是在login-config.xml中配置，在%JBOSS_HOME%/server/default/conf下找到它，查找application-policy name = "jmx-console"，修改为

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  
6.    < /module-option> 
7.    < module-option name="rolesProperties">props/jmx-console-roles.properties  
8.    < /module-option> 
9.  < /login-module> 
10.     < /authentication> 
11.   < /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的页面。

（2）web-console登陆的用户名和密码设置

找到%JBOSS_HOME%/server/default/deploy/management/console-mgr.sar/web-console.war/WEB-INF下的jboss-web.xml文件，去掉< security-domain>java:/jaas/web-console< /security-domain>的注释。

在同目录下的web.xml文件中去掉< security-constraint>部分的注释。

在%JBOSS_HOME%/server/default/conf下的login-config.xml文件中查找application-policy name = "web-console"

在文件中可以看到，设置登录web-console的用户名和角色等信息分别在login-config.xml文件所在目录下的web-console-users.properties和web-console- roles.properties文件中，但因为该目录下无这两个文件，我们在JBoss安装目录"server"default"conf"props目录下建立这两个文件，文件内容可参考在“jmx-console登录的用户名和密码设置”中的两个相应的配置文件的内容。

web-console-users.properties文件的内容如下：

# A sample users.properties file for use with the UsersRolesLoginModule
admin=admin

web-console-roles.properties文件的内容如下：

admin=JBossAdmin,HttpInvoker

因为此时这两个文件不与login-config.xml同目录，所以login-config.xml文件需进行少许修改

1. < module-option name="usersProperties">props/web-console-users.properties  
2.  < /module-option> 
3.  < module-option name="rolesProperties">props/web-console-roles.properties  
4.  < /module-option> 

JBoss的配置这样就完成了。