JBoss的配置(转)

• 本文介绍了JBoss的配置方法。首先安装JDK，配置变量；然后设置Web服务端口号，JBoss安全选项，定义登陆用户名和密码，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文件，内容如下：

 
<


 
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的欢迎界面。

2   JBoss的安全设置

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

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

 
<


 
jboss-web
>


 

  
<


 
security-domain
>


java:/jaas/jmx-console
<


 /security-domain
>


 
   
<


 /jboss-web
>


 

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

 
   
<


 
security-constraint
>


 

<


 
web-resource-collection
>


 
  
<


 
web-resource-name
>


HtmlAdaptor
<


 /web-resource-name
>


 
  
<


 
description
>


An example security config that only allows user with the role   
 JBossAdmin to access the HTML JMX console web application  
  
<


 /description
>


 
  
<


 
url-pattern
>


/*
<


 /url-pattern
>


 
  
<


 
http-method
>


GET
<


 /http-method
>


 
  
<


 
http-method
>


POST
<


 /http-method
>


 
<


 /web-resource-collection
>


 
<


 
auth-constraint
>


 
  
<


 
role-name
>


JBossAdmin
<


 /role-name
>


 
<


 /auth-constraint
>


 
   
<


 /security-constraint
>


 

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

 
<


 
application-policy


 
name

 = 
"jmx-console"

>


 

 
<


 
authentication
>


 
   
<


 
login-module


 
code

=
"org.jboss.security.auth.spi.UsersRolesLoginModule"

 
 
flag

 = 
"required"

>


 
   
<


 
module-option


 
name

=
"usersProperties"

>


props/jmx-console-users.properties  
   
<


 /module-option
>


 
   
<


 
module-option


 
name

=
"rolesProperties"

>


props/jmx-console-roles.properties  
   
<


 /module-option
>


 
 
<


 /login-module
>


 
    
<


 /authentication
>


 
  
<


 /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文件需进行少许修改

 
<


 
module-option


 
name

=
"usersProperties"

>


props/web-console-users.properties  

 
<


 /module-option
>


 
 
<


 
module-option


 
name

=
"rolesProperties"

>


props/web-console-roles.properties  
 
<


 /module-option
>


 

JBoss的配置这样就完成了。