工具预备
为了运行JBoss,你需要预备以下工具:
JDK 1.3.1或更高。
为了在JBoss上开发应用程序,你可能还需要以下开发工具:
Ant 1.5,一个Java Build Tool。
XDoclet 1.1.2,一个用于生成代码的Javadoc插件。
JBoss Project Template
下载
可以从www.jboss.org获得JBoss,JBoss现在有两种供你选择:标准版,包括用于Web页和Servlets的Jetty,和另一个用Tomcat替换Jetty的版本。
在写作本文时,JBoss 3.2.1是最新的稳定版本。
安装
解压压缩包到一个指定的目录,例如jboss-3.2.1,解压完毕后,应该生成如下目录:
bin:命令和脚本
client:客户端jars
docs:JBoss的文档
lib:服务器端jars
server:服务器配置文件
第二步,建立以下环境变量:
JBOSS_HOME:设置为JBoss的安装目录。
JAVA_HOME:设置为JDK的安装目录。
服务器配置
JBoss提供了3种服务器配置:
Minimal:最小配置,仅仅包括日志,JNDI服务和URL部署扫描器,你可能会在一个不需要J2EE的应用中使用这种配置,或者以该配置为基础自定义配置。
Default:缺省配置,包括除了RMI/IIOP和集群的所有J2EE服务。
All:这种配置包括所有的JBoss服务。
启动
为了启动JBoss,在Windows下:
打开一个命令行窗口;
键入:cd %JBOSS_HOME%\bin;
键入:run [-c defaultminimalall]。
在UNIX下:
打开一个Shell;
键入:cd $JBOSS_HOME/bin;
键入:./run [-c defaultminimalall]。
假如JBoss启动成功,你应该可以看到以下输出:
21:11:16,637 INFO [Server] JBoss (MX MicroKernel) [3.2.1 (build: CVSTag=JBoss_3 _2_1 date=200305041533)] Started in 26s:919ms
一旦服务器启动成功,你就可以通过在浏览器中打开jmx-console来验证所有的J2EE服务是否都启动了。这是JBoss的治理台,它将显示当前配置下JBoss正在运行的所有服务以及每个服务的具体内容。
JBoss也可以作为NT服务或者Unix服务来运行,可以参考“JBoss 3.0 Quick Start Guide”。
关闭
假如在Windows的命令行窗口或者当前的Unix Shell下运行JBoss,只需要简单的按下Ctrl+C即可关闭JBoss。
假如在Windows下不能看见命令行窗口:
打开一个新的命令行窗口;
键入:cd %JBOSS_HOME%\bin;
键入:shutdown ?S或者shutdown --server=url。
假如在Unix Shell的后台运行:
打开一个Shell;
键入:cd $JBOSS_HOME/bin;
键入:./shutdown ?S或./shutdown --server=url。
治理
JBoss通过一个基于Web的控制台治理,你只需在浏览器中键入:jmx-console即可。查看或更改某一服务的配置,只需简单的点击链接。
通过控制台,你还可以使用一些服务的公开的方法,例如,关闭服务器:
打开控制台;
卷动到“jboss.system”选项;
点击链接“type=server”;
卷动到“void shutdown()”选项;
点击“Invoke”按钮。
部署应用程序
在JBoss中部署应用程序是再简单不过的了。简单的复制你的应用程序打包文件:.jar,.war或者.ear到服务器缺省的部署目录下,假如JBoss正在运行,将检测到文件,自动解压,然后装载应用程序。
以下是将一个应用部署到一个缺省的服务器配置的例子,在Windows下:
复制rotmachine.ear到%JBOSS_HOME%\server\default\deploy
在Unix下:
复制rotmachine.ear到$JBOSS_HOME/server/default/deploy
在部署过程中,JBoss日志将在控制台窗口输出信息并写入日志,日志文件位于服务器的配置目录。假如部署成功,你应该可以看到以下信息:
22:21:44,730 INFO [MainDeployer] Deployed package: file&:/C:/jboss-3.2.1/server/default/deploy/rotmachine.ear
此外,假如你打开JBoss的治理台,可以在“jboss.j2ee”类别下列出你的应用。
取消已部署的应用
取消已部署的应用程序比部署应用程序更简单。只要简单的从部署目录中删除相应的应用程序文件,JBoss就会检测到文件已被删除,然后取消已部署的应用。
取消部署一个应用时,JBoss日志将在控制台窗口显示信息,并记录到服务器日志。假如取消部署成功,你应该可以看到以下信息:
22:59:41,500 INFO [MainDeployer] Undeployed file&:/C:/jboss-3.2.1/server/default/deploy/rotmachine.ear