JBoss 5.0 安装与配置详解

下载安装与运行JBoss

EJB3.0应用需要运行在JDK1.5以上版本。
EJB3.0应用需要运行在EJB容器里，JavaEE应用服务器包含Web容器和EJB容器。

EJB3.0应用需要以下版本的JavaEE应用服务器：
Jboss(4.2.x以上版本)
Weblogic(10以上版本)

注意：Tomcat目前只是Web容器，它不能运行EJB应用。

jboss的下载页面为 http://www.jboss.org/jbossas/downloads/

1. 首先要安装JDK，配置JAVA_HOME环境变量
2. 如果是JDK1.5版本，可选择jboss-5.0.0.GA.zip
   如果是JDK6.0版本，可选择jboss-5.0.0.GA-jdk6.zip

下载完成后，将其解压缩后即可完成安装，解压缩后将其放置到一个不带空格的目录(若目录带有空格，例如：C:"Program Files，日后可能会产生一些莫名的错误)。

添加环境变量：
1）在“系统变量”里添加JBOSS_HOME变量，值为Jboss的安装路径，
如：JBOSS_HOME   C:/jboss-5.0.0.GA
2）为了方便jboss的命令，需要把jboss的bin目录添加到系统Path路径里，
如：Path    ;%JBOSS_HOME%/bin

在此，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/deploy/jbossweb-tomcat55.sar目录，修改其下的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 命令行中指定配置名称时使用。
server/default/conf	JBoss 的配置文件。jboss-service.xml login-config.xml
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 的临时文件。
server/default/work	存放的是JSP编译后的.java及.class文件,如果调试JSP时出错了，可以到该目录下(一级级去翻吧)去找对应的文件，调试问题。还有个小TIPS，有时我们明明把一个JSP更新到对应的目录里了，可是去刷新页面时，内容还是旧的，为了解决该问题，我们可以到work目录下，将对应的.java及.class文件删了，再刷新即可，这个原因不好推测，有时可以自动刷新，有时不行。单个的TOMCAT都能自动刷新，不知为何集成到JBOSS里却有时不行。还需注意的事，你在清除旧的java、class文件时，不能为了省事，而直接删除目录，否则刷新时会报错的，等着你的就是要重启JBOSS服务了。

• $JBOSS-HOME/server/下有3个目录，all/default/minimal，它们是表示3种配置，全部的配置、默认配置、最小配置，我们在启动JBOSS服务时，可以指定：
•                           run –c all 表示是启动all配置(将会加载所有服务)；
•                           run 表示是以默认配置启动；
•                           run –c mimimal 表示是启动mimimal配置。

  default/data default/log  default/tmp  default/work 这四个目录可以删除

"conf" 目​录​的​内​容​

文​件​	描​述​
jboss-minimal.xml	这​是 jboss-service.xml 配​置​文​件​的​最​简​单​夫​的​示​例​（它​是​在 minimal 配​置​文​件​集​里​使​用​的 jboss-service.xml）。​
jboss-service.xml	jboss-service.xml 定​义​了​核​心​的​服​务​及​其​配​置​。​
jndi.properties	jndi.properties 文​件​指​定​了​当 InitialContext 使​用​无​参​数​的​构​造​函​数​创​建​时​，在 JBoss 服​务​器​里​使​用​的 JNDI InitialContext 属​性​。​
jboss-log4j.xml	这​个​文​件​配​置​了 Apache log4j 框​架​类​别​优​先​级​和 JBoss 服​务​器​代​码​使​用​的 appender。​
login-config.xml	这​个​文​件​包​含​了​当​使​用​基​于 JAAS 的​安​全​性​时​适​用​的​服​务​器​端​验​证​配​置​的​样​本​。​
props/*	props 目​录​包​含​了​用​于 jmx-console 的​用​户​和​角​色​属​性​文​件​。​
standardjaws.xml	此​文​件​提​供​了​旧​的 EJB 1.1 CMP 引​擎​的​缺​省​配​置​。​
standardjboss.xml	此​文​件​提​供​了​缺​省​的​容​器​配​置​。​
standardjbosscmp-jdbc.xml	此​文​件​为 JBoss CMP 引​擎​提​供​了​缺​省​的​配​置​文​件​。​
xmdesc/*-mbean.xml	xmdesc 目​录​包​含​了 jboss-service.xml 文​件​里​配​置​的​服​务​的 XMBean 描​述​符​。​

"deploy" 目​录​的​内​容

文​件​	描​述​
bsh-deployer.xml	此​文​件​配​置​了​可​将 bean shell 脚​本​部​署​为 JBoss 服​务​的​部​署​者​。​
cache-invalidation-service.xml	这​个​服​务​允​许​通​过 JMS 通​知​的 EJB 缓​存​的​自​定​义 invalidation。​它​缺​省​是​禁​用​的​。​
client-deployer-service.xml	此​服​务​提​供​对 J2EE 应​用​程​序​客​户​端​的​支​持​。​它​为​基​于 application-client.xml 描​述​符​的​客​户​端​应​用​程​序​管​理 java:comp/env 企​业​命​名​上​下​文​。​
ear-deployer.xml	EAR 部​署​者​是​负​责​部​署 J2EE EAR 文​件​的​服​务​。​
ejb-deployer.xml	EJB 部​署​者​是​负​责​部​署 J2EE EJB JAR 文​件​的​服​务​。​
hsqldb-ds.xml	hsqldb-ds.xml 配​置 Hypersonic 嵌​入​式​数​据​库​服​务​。​它​设​置​嵌​入​的​数​据​库​和​相​关​的​连​接​工​厂​。​
http-invoker.sar	http-invoker.sar 包​含​支​持​基​于 HTTP 的 RMI 的​脱​管​调​用​者​（detached invoker）。​它​也​包​含​基​于 HTTP 访​问 JNDI 的​代​理​绑​定​。​
jboss-aop-jdk50.deployer	此​服​务​配​置 AspectManagerService 并​部​署 JBoss AOP 应​用​程​序​。​
jboss-bean.deployer	jboss-bean.deployer 提​供​了 JBoss microcontainer，它​部​署​包​含​在 .beans 文​件​里​的 POJO 服​务​。​
jboss-ha-local-jdbc.rar	jboss-ha-local-jdbc.rar 是​支​持​数​据​源​失​效​切​换​的 jboss-local-jdbc.rar 的​实​验​版​本​。​
jboss-ha-xa-jdbc.rar	jboss-ha-xa-jdbc.rar 是​支​持​数​据​源​失​效​切​换​的 jboss-xa-jdbc.rar 的​实​验​版​本​。​
jboss-local-jdbc.rar	jboss-local-jdbc.rar 是​一​个 JCA 资​源​适​配​器​，它​实​现​支​持 DataSource 接​口​但​不​支​持 JCA 的 JDBC 驱​动​的 JCA ManagedConnectionFactory 接​口​。​
jboss-xa-jdbc.rar	jboss-xa-jdbc.rar 是​一​个 JCA 资​源​适​配​器​，它​实​现​支​持 XADataSource 接​口​的 JDBC 驱​动​的 JCA ManagedConnectionFactory 接​口​。​
jbossjca-service.xml	jbossjca-service.xml 是 JCA 规​格​的​应​用​服​务​器​实​现​。​它​提​供​了​将​资​源​适​配​器​集​成​到 JBoss 服​务​器​的​连​接​管​理​工​具​。​
jboss-web.deployer	jboss-web.deployer 目​录​提​供 Tomcat servlet 引​擎​。​
jbossws.sar	jbossws.sar 提​供 J2EE web 服​务​的​支​持​。​
jms/hsqldb-jdbc-state-service.xml	hsqldb-jdbc-state-service.xml 提​供 Hypersonic 的 JMS 状​态​管​理​。​
jms/hsqldb-jdbc2-service.xml	hsqldb-jdbc2-service.xml 使​用 Hypersonic 配​置 JMS 持​久​性​和​缓​存​。​它​也​包​含 作​为 JMS 实​现​的​核​心​服​务​的 DestinationManager MBean。​
jms/jbossmq-destinations-service.xml	jbossmq-destinations-service.xml 配​置​一​系​列 JMS 单​元​测​试​所​使​用​的 JMS 队​列​和​主​题​。​
jms/jbossmq-httpil.sar	jbossmq-httpil.sar 提​供​运​行​通​过 HTTP 使​用 JMS 的 JMS 调​用​层​。​
jms/jbossmq-service.xml	jbossmq-service.xml 文​件​配​置​了​核​心​的 JBossMQ JMS 服​务​。​
jms/jms-ds.xml	jms-ds.xml 文​件​配​置​了​和 jms-ra.rar JCA 资​源​适​配​器​一​起​使​用​的 JBossMQ JMS 提​供​者​。​
jms/jms-ra.rar	jms-ra.rar 是​一​个​资​源​适​配​器​，它​为 JMS 连​接​工​厂​实​现​了 JCA ManagedConnectionFactory 接​口​。​
jms/jvm-il-service.xml	jvm-il-service.xml 配​置​了 JVM 内​部​的 JMS 传​输​调​用​层​。​
jms/uil2-service.xml	uil2-service.xml 配​置​了 JMS version 2 统​一​调​用​层​。​它​是​快​速​和​可​靠​的​基​于​自​定​义​套​接​字​的​传​输​，用​于 JVM 之​间​的​消​息​传​递​。​
jmx-console.war	jmx-console.war 目​录​提​供 JMX 控​制​台​。​JMX 控​制​台​提​供​管​理 MBean 服​务​器​的​简​单​的 web 界​面​。​
jmx-invoker-service.sar	jmx-invoker-service.sar 是​一​个​未​解​压​的 MBean 服​务​归​档​，它​开​放​了 JMX MBeanServer 接​口​方​法​的​一​个​子​集​作​为 RMI 接​口​来​启​用​对 JMX 核​心​功​能​的​远​程​访​问​。​它​和​旧​的 jmx-rmi-adaptor.sar 类​似​，区​别​是​传​输​是​由​脱​管​调​用​者​架​构​来​处​理​的​。​
jsr-88-service.xml	jsr-88-service.xml 提​供​了 JSR 88 远​程​部​署​服​务​。​
mail-ra.rar	mail-ra.rar 是​提​供 JavaMail 连​接​器​的​资​源​适​配​器​。​
mail-service.xml	mail-service.xml 文​件​是​一​个 MBean 服​务​描​述​符​，它​提​供​在 JBoss 服​务​器​内​部​使​用​的 JavaMail 会​话​。​
management/console-mgr.sar	console-mgr.sar 提​供 Web 控​制​台​。​它​是​一​个 web 应​用​程​序​/applet，提​供​比 JMX 控​制​台​更​丰​富​的 JMX 服​务​器​管​理​视​图​。​你​可​以​用 URL http://localhost:8080/web-console/ 来​访​问​此​控​制​台​。​
monitoring-service.xml	monitoring-service.xml 文​件​配​置​了​警​告​监​控​器​，如 JMX 通​知​使​用​的​控​制​台​侦​听​者​和​电​子​邮​件​侦​听​者​。​
properties-service.xml	properties-service.xml 文​件​是​一​个 MBean 服​务​描​述​符​，它​允​许​自​定​义 JavaBeans PropertyEditor 以​及​系​统​属​性​。​
scheduler-service.xml	scheduler-service.xml 和 schedule-manager-service.xml 文​件​是 MBean 服​务​描​述​符​，它​提​供​一​个​调​度​类​型​的​服​务​。​
sqlexception-service.xml	sqlexception-service.xml 文​件​是​一​个 MBean 服​务​描​述​符​，它​处​理​和​供​应​商​相​关​的 SQLException。​
uuid-key-generator.sar	uuid-key-generator.sar 服​务​提​供​基​于 UUID 的​密​钥​生​成​工​具​。​