Jboss Guide.docx

Jboss Guide.docx

《Jboss Guide.docx》由会员分享，可在线阅读，更多相关《Jboss Guide.docx（11页珍藏版）》请在冰豆网上搜索。

JbossGuide

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.0Beta4版本默认采用此配置） 。

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的临时文件。

 2.启动停止JBoss

安装好JBoss后，要确认安装是否成功，进入bin目录，执行run.bat或run.sh脚本。

输出应该类似如下：

如果输出类似如上图，现在应该可以使用JBoss了。

访问:

http:

//localhost:

8080 （默认8080,自己可以改）

3.JBOSSTOOLS

MyEclipse+jboss,如果用JBossTools这个工具,比较好用.

官方网站:

http:

//www.jboss.org/tools/download

现在的版本是:

JBossTools3.1 

安装插件URL:

 http:

//download.jboss.org/jbosstools/updates/development

安装插件的方式跟其它插件是一样的,这里就不说了.

这里以:

MyEclipseEnterpriseWorkbenchVersion:

6.0.0GA为实例,发的截图:

 JBossTools是一套基于Eclipse和JBoss技术的开源项目，JBossTools的目的是为基于JBoss技术的项目开发提供一套完整工具支持，所有JBossPlugins将作为JBDS（JBossDeveloperStudio）的一部分，现在的JBossTools的所有的plugins每天都会有一个新build包括最新的修改。

JBossTools目前包括有一下模块：

1.RichFacesVE:

这个模块是有Exadel提供的，一个位于明斯克的非常有经验的和实力的团队，主要功能是为HTML和JSF提供一个可是化的编辑器，可以方便灵活的设置JSFProject的各种配置文件

2.SeamTools：

支持seam-gen以及于RichFacesVE的集成和对于Seam相关代码的refacetoring和编译等

3.HibernateTools：

提供了一些projectwizard，可以方便构建Hibernate所需的各种配置文件，同时支持mapping文件annotation和JPA的逆向工程以及交互式的HQL/JPA-QL/Criteria的执行。

4.JBossAS：

基于WTPServerAdapter框架，将Eclipse与JBossAS完美集成的工具，可以在Eclipse下方便的启动，停止JBossAS以及调试

5.JBPMTools：

用于编辑和部署JBPM工作流

6.StrutsTools：

一套为基于Struts技术开发提供支持的工具

7.FreeMarkerTools:

FreeMakerEditor，基于FreeMaker语法的，可以高亮显示

8.JBossToolsCore:

JBossTools的核心模块

9.JBossWSTools:

JBossWS是JBoss提供的WebServiceruntime，JBossWSTools的功能就是使用户在Eclipse你能方便的创建基于JBossWS的webserviceproject，用户可以轻松的完成从代码生成到打包、部署以及webservice的调用和测试，开发者之需要关注业务逻辑的开发即可

10.PortletTools:

支持portlet开发的工具

11.BIRTTools:

基于BIRT的为jbossJ2EEServer提供报表功能的工具

12.JBossESBTooling:

提供一些工程构建向导和关键的jboss-esb.xml的编辑器，支持工程的打包和部署。

 4JBoss的配置

4.1.      日志文件设置

若需要修改JBoss默认的log4j设置，可修改JBoss安装目录"server"default"conf下的jboss-log4j.xml文件，在该文件中可以看到，log4j的日志输出在JBoss安装目录"server"default"log下的server.log文件中。

对于log4j的设置，读者可以在网上搜索更加详细的信息。

4.2.      web服务的端口号的修改

这点在前文中有所提及，即修改JBoss安装目录

4.*版:

${JBOSS_HOME}/server-->default-->deploy-->jbossweb.sar-->server.xml

5.*版:

   ${JBOSS_HOME}/server-->default-->deployers-->jbossweb.deployer-->server.xml

下的server.xml文件，内容如下：

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

4.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文件，去掉java:

/jaas/jmx-console的注释。

修改后的该文件内容为：

--Uncommentthesecurity-domaintoenablesecurity.Youwill

     needtoeditthehtmladaptorloginconfigurationtosetupthe

     loginmodulesusedtoauthenticationusers.-->

     java:

/jaas/jmx-console

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

--AsecurityconstraintthatrestrictsaccesstotheHTMLJMXconsole

  touserswiththeroleJBossAdmin.Edittherolestowhatyouwantand

  uncommenttheWEB-INF/jboss-web.xml/security-domainelementtoenable

  securedaccesstotheHTMLJMXconsole.-->

      HtmlAdaptor

      Anexamplesecurityconfigthatonlyallowsuserswiththe

        roleJBossAdmintoaccesstheHTMLJMXconsolewebapplication

      /*

      GET

      POST

      JBossAdmin

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

 iii）在第一步中的jmx-console安全域和第二步中的运行角色JBossAdmin都是在login-config.xml中配置，我们在JBoss安装目录/server/default/config下找到它。

查找名字为：

jmx-console的application-policy：

            flag="required">

          props/jmx-console-users.properties

          props/jmx-console-roles.properties

在此处可以看出，登录的角色、用户等的信息分别在\server\default\deploy\jmx-console.war\WEB-INF\classes目录下的jmx-console-roles.properties和jmx-console-users.properties文件中设置，分别打开这两个文件。

其中jmx-console-users.properties文件的内容如下：

#Asampleusers.propertiesfileforusewiththeUsersRolesLoginModule

admin=admin

该文件定义的格式为：

用户名=密码，在该文件中，默认定义了一个用户名为admin，密码也为admin的用户，读者可将其改成所需的用户名和密码。

jmx-console-roles.properties的内容如下：

#Asampleroles.propertiesfileforusewiththeUsersRolesLoginModule

admin=JBossAdmin,HttpInvoker

该文件定义的格式为：

用户名=角色，多个角色以“,”隔开，该文件默认为admin用户定义了JBossAdmin和HttpInvoker这两个角色。

配置完成后读者可以通过访问：

http:

//localhost:

8088/jmx-console/，输入jmx-console-roles.properties文件中定义的用户名和密码，访问jmx-console的页面。

2）web-console登录的用户名和密码设置

默认情况下，用户访问JBoss的web-console时，不需要输入用户名和密码，为了安全起见，我们通过修改配置来为其加上用户名和密码。

步骤如下：

i）找到JBoss安装目录"server"default"deploy"management"console-mgr.sar"web-console.war"WEB-INF"jboss-web.xml文件，去掉java:

/jaas/web-console的注释，修改后的文件内容为：

xmlversion='1.0'encoding='UTF-8'?

>

DOCTYPEjboss-web

   PUBLIC"-//JBoss//DTDWebApplication2.3V2//EN"

   "http:

//www.jboss.org/j2ee/dtd/jboss-web_3_2.dtd">

--Uncommentthesecurity-domaintoenablesecurity.Youwill

  needtoeditthehtmladaptorloginconfigurationtosetupthe

  loginmodulesusedtoauthenticationusers.-->

  java:

/jaas/web-console

--Thewardependsonthe-->

  jboss.admin:

service=PluginManager

ii）打开i）中jboss-web.xml同目录下的web.xml文件，去掉部分的注释，修改后的该部分内容为：

--AsecurityconstraintthatrestrictsaccesstotheHTMLJMXconsole

  touserswiththeroleJBossAdmin.Edittherolestowhatyouwantand

  uncommenttheWEB-INF/jboss-web.xml/security-domainelementtoenable

  securedaccesstotheHTMLJMXconsole.-->

  HtmlAdaptor

  Anexamplesecurityconfigthatonlyallowsuserswiththe

  roleJBossAdmintoaccesstheHTMLJMXconsolewebapplication

  /*

  GET

  POST

  JBossAdmin

iii）打开JBoss安装目录"server"default"conf下的login-config.xml文件，搜索web-console，可找到如下内容：

            flag="required">

            web-console-users.properties

            web-console-roles.properties

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

#Asampleusers.propertiesfileforusewiththeUsersRolesLoginModule

admin=admin

web-console-roles.properties文件的内容如下：

#Asampleroles.propertiesfileforusewiththeUsersRolesLoginModule

admin=JBossAdmin,HttpInvoker

因为此时这两个文件不与login-config.xml同目录，所以login-config.xml文件需进行少许修改，修改后的元素的内容为：

            flag="required">

            props/web-console-users.properties

            props/web-console-roles.properties