JBoss 5.0 安装与配置详解

 

本文引自:

另有:http://wiki.ubuntu.org.cn/JBoss_5.0.0GA安装指南

一.下载与安装JBoss

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

下载地址:  http://www.jboss.org/jbossas/downloads/

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

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

JBoss 5.0 安装与配置详解_log4j

在此,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/  

若启动失败,可能由以下原因引起:

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>的注释。修改后的该文件内容为:


< jboss-web >  
 

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

        need to edit the htmladaptor login configuration to setup the

        login modules used to authentication users. -->  
 

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

 
 </ jboss-web >



ii)修改与 i)中的 jboss-web.xml同级目录下的 web.xml文件,查找到 < 节点,去掉它的注释,修改后该部分内容为:


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

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

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

     secured access to the HTML JMX console. -->   

      < security-constraint >  
 

        < web-resource-collection >  
 

          < web-resource-name > HtmlAdaptor </ web-resource-name >  
 

          < description >  
 An example security config that only allows users 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 >

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

iii)   在第一步中的 jmx-console 安全域和第二步中的运行角色 JBossAdmin 都是在 login-config.xml 中配置,我们在 JBoss 安装目录 /server/default/config 下找到它。查找名字为: jmx-console 的 application-policy :


< 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的页面。

四.    中配置

笔者的 MyEclipse版本:6

JBoss版本: 5.0
JDK版本:

进入 Window-> Preferences-> MyEclipse -> Application Servers -> JBoss5 ,进行如下设置:

     

JBoss 5.0 安装与配置详解_jmx_02

选择 JBoss 5下的 JDK设置所用的

好了,开始JBoss之旅吧.

 

 

 

 

 

使用jboss-5.1.0.GA,jdk1.6,部署了多个war网站,怎样给每个网站绑定一个单独域名? 
---------回复--------------
修改端口为80

修改域名和文件(网站的映射)web.xml
 <engine name="Catalina" defaultHost="website.com">   
 <host name="domainname.cn"appBase="webapps"unpackWARs="true"
 autoDeploy="true"xmlValidation="false" xmlNamespaceAware="false">   
   </host>    
 </engine>