Jboss Guide.docx

1、Jboss GuideJBoss 的目录结构说明 目录 描述 bin 启动和关闭 JBoss 的脚本（ run.bat 为 windows 系统下的启动脚本， shutdown.bat 为 windows 系统下的关闭脚本）。 client 客户端与 JBoss 通信所需的 Java 库（ JARs ）。 docs 配置的样本文件（数据库配置等）。 docs/dtd 在 JBoss 中使用的各种 XML 文件的 DTD 。 lib 一些 JAR ， JBoss 启动时加载，且被所有 JBoss 配置共享。（不要把你的库放在这里） server 各种 JBoss 配置。每个配置必须放在不同的子目

2、录。子目录的名字表示配置的名字。 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 serve

3、r/default /deploy JBoss 的热部署目录。放到这里的任何文件或目录会被 JBoss 自动部署。 EJB 、 WAR 、 EAR ，甚至服务。 server/default /lib 一些 JAR ， JBoss 在启动特定配置时加载他们。 (default 和 minimial 配置也包含这个和下面两个目录。 ) server/default/log JBoss 的日志文件。 server/default/tmp JBoss 的临时文件。 2.启动停止JBoss安装好JBoss后，要确认安装是否成功，进入bin目录，执行run.bat或run.sh脚本。输出应该类似如下：如

4、果输出类似如上图，现在应该可以使用JBoss了。访问:http:/localhost:8080 (默认8080,自己可以改)3.JBOSS TOOLS MyEclipse + jboss ,如果用 JBoss Tools 这个工具,比较好用.官方网站: http:/www.jboss.org/tools/download现在的版本是 :JBoss Tools 3.1安装插件URL: http:/download.jboss.org/jbosstools/updates/development安装插件的方式跟其它插件是一样的,这里就不说了.这里以:MyEclipse Enterprise Wor

5、kbench Version: 6.0.0 GA 为实例,发的截图:JBoss Tools 是一套基于Eclipse和JBoss 技术的开源项目，JBoss Tools的目的是为基于JBoss技术的项目开发提供一套完整工具支持，所有JBoss Plugins将作为JBDS（JBoss Developer Studio）的一部分，现在的JBoss Tools的所有的plugins 每天都会有一个新build包括最新的修改。JBoss Tools目前包括有一下模块：1. RichFaces VE : 这个模块是有Exadel提供的， 一个位于明斯克的非常有经验的和实力的团队，主要功能是为HTML和

6、JSF 提供一个可是化的编辑器，可以方便灵活的设置JSF Project的各种配置文件2. Seam Tools ： 支持seam-gen 以及于RichFaces VE的集成和对于Seam相关代码的refacetoring和编译等3. Hibernate Tools ： 提供了一些project wizard，可以方便构建Hibernate所需的各种配置文件， 同时支持mapping 文件annotation和JPA的逆向工程以及交互式的HQL/JPA-QL/Criteria的执行。4. JBoss AS ： 基于WTP Server Adapter框架， 将Eclipse与JBoss AS

7、 完美集成的工具， 可以在Eclipse下方便的启动，停止 JBoss AS以及调试5. JBPM Tools： 用于编辑和部署JBPM工作流6. Struts Tools： 一套为基于Struts技术 开发 提供支持的工具7. FreeMarker Tools: FreeMaker Editor ， 基于FreeMaker语法的， 可以高亮显示8. JBossTools Core: JBoss Tools的核心模块9. JBossWS Tools: JBossWS 是JBoss提供的Web Service runtime，JBossWS Tools的功能就是使用户在Eclipse你能方便的创

8、建基于JBossWS 的web service project，用户可以轻松的完成从代码生成到打包、部署以及web service的调用和测试，开发者之需要关注业务逻辑的开发即可10. Portlet Tools: 支持portlet开发的工具 11. BIRT Tools: 基于BIRT的为jboss J2EE Server提供报表功能的工具12. JBoss ESB Tooling: 提供一些 工程构建向导和关键的jboss-esb.xml的编辑器，支持工程的打包和部署。4 JBoss 的配置 4.1. 日志文件设置 若需要修改JBoss默认的log4j设置，可修改JBoss安装目录ser

9、verdefaultconf下的jboss- log4j.xml文件，在该文件中可以看到，log4j的日志输出在JBoss安装目录serverdefaultlog下的 server.log文件中。对于log4j的设置，读者可以在网上搜索更加详细的信息。4.2. web 服务的端口号的修改 这点在前文中有所提及，即修改JBoss安装目录4.*版:$JBOSS_HOME/server-default-deploy-jbossweb.sar-server.xml5.*版: $JBOSS_HOME/server-default-deployers-jbossweb.deployer-server.xm

10、l下的server.xml文件，内容如下：将上面的8080端口修改为你想要的端口即可。重新启动JBoss后访问：http:/localhost/:新设置的端口，可看到JBoss的欢迎界面。4.3. JBoss 的安全设置 1） jmx-console 登录的用户名和密码设置 默认情况访问 http:/localhost:8080/jmx-console 就可以浏览jboss的部署管理的一些信息，不需要输入用户名和密码，使用起来有点安全隐患。下面我们针对此问题对jboss进行配置，使得访问jmx-console也必须要知道用户名和密码才可进去访问。步骤如下：i) 找到JBoss安装目录/serv

11、er/default/deploy/jmx-console.war/WEB-INF/jboss-web.xml文 件，去掉java:/jaas/jmx-console的注释。修改后的该文件内容为： java:/jaas/jmx-consoleii）修改与i）中的jboss-web.xml同级目录下的web.xml文件，查找到节点，去掉它的注释，修改后该部分内容为： HtmlAdaptor An example security config that only allows users with the role JBossAdmin to access the HTML JMX consol

12、e web application /* GET POST JBossAdmin 在此处可以看出，为登录配置了角色JBossAdmin。iii） 在第一步中的jmx-console安全域和第二步中的运行角色JBossAdmin都是在login-config.xml中配置，我们在JBoss安 装目录/server/default/config下找到它。查找名字为：jmx-console的application-policy： props/jmx-console-users.properties props/jmx-console-roles.properties 在此处可以看出，登录的角色、用户

13、等的信息分别在serverdefaultdeployjmx-console.warWEB-INFclasses目录下的jmx-console-roles.properties和jmx-console-users.properties文件中设置，分别打开这两个文件。其中jmx-console-users.properties文件的内容如下：# A sample users.properties file for use with the UsersRolesLoginModuleadmin=admin该文件定义的格式为：用户名=密码，在该文件中，默认定义了一个用户名为admin，密码也为admi

14、n的用户，读者可将其改成所需的用户名和密码。jmx-console-roles.properties的内容如下：# A sample roles.properties file for use with the UsersRolesLoginModuleadmin=JBossAdmin, HttpInvoker该文件定义的格式为：用户名=角色，多个角色以“,”隔开，该文件默认为admin用户定义了JBossAdmin和HttpInvoker这两个角色。配置完成后读者可以通过访问： http:/localhost:8088/jmx-console/ ，输入jmx-console-roles.pr

15、operties文件中定义的用户名和密码，访问jmx-console的页面。2） web-console 登录的用户名和密码设置 默认情况下，用户访问JBoss的web-console时，不需要输入用户名和密码，为了安全起见，我们通过修改配置来为其加上用户名和密码。步骤如下：i）找到JBoss安装目录serverdefaultdeploymanagementconsole-mgr.sarweb- console.warWEB-INFjboss-web.xml文件，去掉java:/jaas /web-console的注释，修改后的文件内容为： java:/jaas/web-console jbo

16、ss.admin:service=PluginManagerii）打开i）中jboss-web.xml同目录下的web.xml文件，去掉部分的注释，修改后的该部分内容为： HtmlAdaptor An example security config that only allows users with the role JBossAdmin to access the HTML JMX console web application /* GET POST JBossAdmin iii）打开JBoss安装目录serverdefaultconf下的login-config.xml文件，搜索we

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

18、配置文件的内容，web-console-users.properties文件的内容如下：# A sample users.properties file for use with the UsersRolesLoginModuleadmin=adminweb-console-roles.properties文件的内容如下：# A sample roles.properties file for use with the UsersRolesLoginModuleadmin=JBossAdmin,HttpInvoker因为此时这两个文件不与login-config.xml同目录，所以login-config.xml文件需进行少许修改，修改后的元素的内容为： props/web-console-users.properties props/web-console-roles.properties