发布新日志

  • windows下JBOSS4.2的安装配置说明(1)

    2012-07-04 11:53:40

    一.              下载与安装JBoss

    在本文中,我们下载的JBoss版本为:4.2.1.GA

    下载地址:

    www.jboss.org

    在如上的下载页中下载JBoss-4.2.1.GA.zip文件。

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

    在此,JBoss的安装工作已经结束,可通过如下方式测试安装是否成功:

    运行JBoss安装目录"bin"run.bat,如果窗口中没有出现异常,且出现:10:16:19,765 INFO [Server] JBoss (MX MicroKernel) [4.2.1.GA (build: SVNTag=JBoss_4_2_1_GA date=200707131605)] Started in 30s:828ms字样,则表示安装成功。

    我们可以通过访问: http://localhost:8080/ 进入JBoss的欢迎界面,点击JBoss Management下的JMX Console可进入JBoss的控制台。

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

    1              JBoss所用的端口(8080109910988083等)被占用。一般情况下为8080端口被占用(例如,Oracle占用了8080端口),此时需要修改JBoss的端口,方法为进入JBoss安装目录"server"default"deploy"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 命令行中指定配置名称时使用。 ( 我们下载的 4.2.1 版本默认采用此配置 )

    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"deploy"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文件,查找到<security-constraint/>节点,去掉它的注释,修改后该部分内容为:

    <!-- 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-consoleapplication-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.propertiesjmx-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用户定义了JBossAdminHttpInvoker这两个角色。

  • JBOSS常用配置文件的路径

    2012-07-04 11:52:24

    JBOSS常用配置文件的路径   
     为了描述方便,以下描述将以JBOSS3.2.6版本,default配置为例,如果你以别的配置启动,则在对应的目录下寻找或配置相关文件。

    1、相关DTD定义文件位于$JBOSS-HOME/docs/dtd,在其下的文件中可以查阅某个XML配置文件中某个元素或属性的意义。
    2、数据源配置文件的路径,$JBOSS-HOME/server/default/deploy,文件格式必须是*-ds.xml的样式。不同的数据库配置参数可参考$JBOSS-HOME/docs/examples/jca/下的示例文档。有关参数的细节在下面会有一定的描述。

    3、公共的jar包我们可以放在$JBOSS-HOME/server/default/lib下,如数据库的JDBC jar,log4j.jar等,如果这些JAR已经在该lib下放置了,那么我们的应用WEB-INF/lib下不应该再放置,否则JBOSS也会将他们再一次加载,白白占用内存。

    4、配置日志的文件,log4j.xml位于$JBOSS-HOME/server/default/conf下,具体配置下文还会有一点介绍

    5、$JBOSS-HOME/server/default/work下存放的是JSP编译后的.java及.class文件,如果调试JSP时出错了,可以到该目录下(一级级去翻吧)去找对应的文件,调试问题。还有个小TIPS,有时我们明明把一个JSP更新到对应的目录里了,可是去刷新页面时,内容还是旧的,为了解决该问题,我们可以到work目录下,将对应的.java及.class文件删了,再刷新即可,这个原因不好推测,有时可以自动刷新,有时不行。单个的TOMCAT都能自动刷新,不知为何集成到JBOSS里却有时不行。还需注意的事,你在清除旧的java、class文件时,不能为了省事,而直接删除目录,否则刷新时会报错的,等着你的就是要重启JBOSS服务了。

    6、$JBOSS-HOME/server/default/log下存放的是日志文件,默认的log4j.xml配置是将日志输出到该文件夹下的server.log文件,可以去查看信息进行调试。

    7、我们的应用一般部署在$JBOSS-HOME/server/default/deploy/jbossweb-tomcat50.sar/下,建个TestCrm.war目录,把我们的整个应用部署在该.war目录下,这样JSP、Servlet将由tomcat引擎来解析处理。

    8、配置应用的WEB服务的端口号及参数。

    JBOSS3.2.6是在…./ deploy/jbossweb-tomcat50.sar/server.xml中,自己找8080,修改为你想设定的端口即可。
    JBOSS3.2.3是在…/default/deploy/jbossweb-tomcat41.sar/META-INF/jboss-service.xml中配置。

Open Toolbar