一,安装JBOSS:

安装JBOSS很简单。将jboss-4.0.4.GA.zip解压到一个目录(比如d:\ jboss-4.0.4.GA)下即可。

        提示:保留原来的zip文件,以免在使用过程中出错,还可以恢复到正常状态。

二,运行JBOSS:

在JBOSS的home目录(即$JBOSS_HOME \bin)有一个run.bat文件和 一个run.sh文件,直接运行run.sh(linux系统)或run.bat(windows系统)即可启动JBOSS。

如果需要设置JBOSS应用启动的端口,可以修改$JBOSS_HOME \server\default\deploy\jbossweb-tomcat55.sar\server.xml文件

<!-- A HTTP/1.1 Connector on port 8080 -->

      <Connector port="8080" address="${jboss.bind.address}"

         maxThreads="250" strategy="ms" maxHttpHeaderSize="8192"

         emptySessionPath="true"

         enableLookups="false" redirectPort="8443" acceptCount="100"

         connectionTimeout="20000" disableUploadTimeout="true"/>

可将这个port修改成需要的端口。


三。启动JBOSS,打开http://IP:Port/  可进入如下页面

略。


3.2 如何控制Jboss控制台的访问权限

web-console和jmx-console都可以使用Jboss提供的JAAS框架进行访问权限控制,修改应用war包内的WEB-INF/web.xml和jboss-web.xml,取消对应的注释即可。以web-console为例

jboss-web.xml
<security-domain>java:/jaas/web-console</security-domain>
 web.xml
       <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>

jboss-web.xml中指明该应用的policy为web-console,授权的角色为JBossAdmin。在$JBOSS_HOME/server/${app}/conf/login-config.xml中可以找到对policy:web-console的配置

    <application-policy name = "web-console">
       <authentication>
          <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule"
             flag = "required">
             <module-option name="usersProperties">web-console-users.properties</module-option>
             <module-option name="rolesProperties">web-console-roles.properties</module-option>
          </login-module>
       </authentication>
    </application-policy>

在$JBOSS_HOME/server/${app}/conf/中建立文件web-console-roles.properties配置角色信息

#用户名=角色1,角色2,…,角色n

admin=JBossAdmin,HttpInvoker

在$JBOSS_HOME/server/${app}/conf/中建立文件web-console-users.properties配置用户信息

#用户名=密码(明文)

admin=admin

经过上述配置,需要以用户admin密码admin才能登录http://IP:Port/web-console。


第二章 发布目录及配置文件
1 JBOSS的应用发布目录

       JBOSS在控制台没有提供直接的目录发布应用的功能。需要通过直接修改配置文件完成。系统默认的发布目录是$JBOSS_HOME \server\default\deploy,直接将war包复制到这个目录下即可。如果需要以目录方式部署,可以将war包解开后的整个目录复制过来,但注意目录名一定要修改成${app}.war这种形式。
2 JBOSS配置文件
2.1 增加jboss-web.xml

jboss-web.xml的作用类似于weblogic.xml,用于指定一些跟应用服务器相关的配置。在jboss环境下,原有的weblogic.xml已经没有用处,可以删除。在WEB-INF目录下新增jboss-web.xml,内容如下:

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE jboss-web PUBLIC "-//JBoss//DTD Web Application 2.3V2//EN" "http://www.jboss.org/j2ee/dtd/jboss-web_3_2.dtd">

<jboss-web>

    <context-root>${app}</context-root>

       <resource-ref>

        <res-ref-name>jdbc/JDBCDS</res-ref-name>

        <jndi-name>java:/JDBCDS</jndi-name>

    </resource-ref>

</jboss-web>

指定了web应用的context为/${app},以及指定web应用中使用数据源的jndi名java:/JDBCDS
2.2 修改web.xml

修改WEB-INF目录下的web.xml文件,增加如下内容:

<resource-ref>

    <res-ref-name>jdbc/JDBCDS</res-ref-name>

    <res-type>javax.sql.DataSource</res-type>

    <res-auth>Container</res-auth>

  </resource-ref>

注意这里面的配置关系:web.xml里的<res-ref-name> jdbc/JDBCDS </res-ref-name>
中的jdbc/JDBCDS与jboss-web.xml里的<res-ref-name> jdbc/JDBCDS </res-ref-name>
中的jdbc/JDBCDS一致,前者是向后者看齐的;而jboss-web.xml里的  <jndi-name>java:jdbc/MyDs</jndi-name>中的java:jdbc/MyDs 为前缀“java:” 加上 在第一步(数据源配置文件配置)中配置的jndi名称组成。
2.3 增加oracle-ds.xml
在JBOSS发布应用时,我们需要为数据库创建一个数据源描述文件,在$JBOSS_HOME/ server/default/deploy /目录下,增加一个oracle-ds.xml文件,内容如下

<?xml version="1.0" encoding="UTF-8"?>

<datasources>

  <local-tx-datasource>

    <jndi-name>JDBCDS</jndi-name>

    <connection-url>jdbc:oracle:thin:@10.1.1.1:1521:ora9i</connection-url>

    <driver-class>oracle.jdbc.driver.OracleDriver</driver-class>

    <user-name>eafcem</user-name>

    <password>eafcem</password>

<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>

      <metadata>

         <type-mapping>Oracle9i</type-mapping>

      </metadata>

  </local-tx-datasource>

</datasources>
我们可以把$JBOSS_HOME\docs\examples\jca\oracle-ds.xml或oracle-xa-ds.xml拷贝到deploy目录下,修改其中的连接串、用户名、密码即可
第三章 JBOSS配置
以下以Linux平台为例:
Jboss部署位置用$JBOSS_HOME指代

1、  精简服务(可选)

default配置中有一些我们不需要的服务,在deploy目录下以xml或sar的形势存在。可以删除以加快启动速度减少资源占用,目前确认可以删除的内容如下

n         jboss-aop.deployer

n         jbossws14.sar

n         jms

n         uuid-key-generator.sar

n         bsh-deployer.xml

n         cache-invalidation-service.xml

n         client-deployer-service.xml

n         ear-deployer.xml

n         ejb-deployer.xml

n         hsqldb-ds.xml

n         jboss-ha-xa-jdbc.rar

n         jsr88-service.xml

n         mail-ra.rar

n         mail-service.xml

n         vi conf/jboss-service.xml,删除以下内容

   <!-- ==================================================================== -->

   <!-- Class Loading                                                        -->

   <!-- ==================================================================== -->
 

   <mbean code="org.jboss.web.WebService"

      name="jboss:service=WebService">

      <attribute name="Port">8083</attribute>

      <!-- Should non-EJB .class files be downloadable -->

      <attribute name="DownloadServerClasses">true</attribute>

      <!-- Should resources other than .class files be downloadable. Both

         DownloadServerClasses and DownloadResources must be true for resources

         to be downloadable. This is false by default because its generally a

         bad idea as server configuration files that container security

         information can be accessed.

       -->

      <attribute name="DownloadResources">false</attribute>

      <attribute name="Host">${jboss.bind.address}</attribute>

      <attribute name="BindAddress">${jboss.bind.address}</attribute>

      <!-- Use the default thread pool for dynamic class loading -->

      <depends optional-attribute-name="ThreadPool"

         proxy-type="attribute">jboss.system:service=ThreadPool</depends>

   </mbean>

2、  修改jboss运行参数配置文件

修改run.conf,修改或增加以下内容,参数值根据实际情况调整

MAX_FD="8192"

JAVA_HOME="/opt/aspire/product/jboss/jdk1.5.0_10"

JAVA_OPTS="-server -Xms512m -Xmx1024m -Xloggc:./gc/$$ -XX:PermSize=64m -XX:MaxPermSize=128m -XX:-UseParallelGC -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000"

3、  创建启动脚本

在$JBOSS_HOME/server/default创建启动脚本start,内容如下

mv nohup.out nohup.bak

nohup $JBOSS_HOME/bin/run.sh -c default -P run.conf & > nohup.out

4、  创建停止脚本

在$JBOSS_HOME/server/default创建启动脚本down,内容如下

$JBOSS_HOME/bin/shutdown.sh --server=jnp://localhost:1099 --shutdown

其中11099端口为示意,请根据实际的JNDI端口修改。

5、  数据库驱动

JBOSS不带oracle jdbc driver,需要手工放置classes12.jar到$JBOSS_HOME/server/default/lib目录下。

6、  log4j的问题

       JBOSS自己的log4j和应用Log4j冲突的问题,目前暂时的做法删除JBOSS自带的server/default/deploy目录下的log4j.jar,启动时会报一个错,但simf的日志可正常使用,在$JBOSS_HOME/bin目录下会生成eaflog目录

7、  修改端口(可选)

如果在一台机器上部署了多个jboss server或者jboss默认端口已被其它应用使用,需要修改相关端口以避免端口冲突。目前确认需要修改的配置如下

vi $JBOSS_HOME/server/default/conf/jboss-service.xml

n         JNDI端口:默认1099

   <mbean code="org.jboss.naming.NamingService"

      name="jboss:service=Naming"

      xmbean-dd="resource:xmdesc/NamingService-xmbean.xml">

......

        <attribute name="Port">1099</attribute>
        <!--
        <attribute name="RmiPort">1098</attribute>
        -->

n         RMI端口:默认4444/4445

   <mbean code="org.jboss.invocation.jrmp.server.JRMPInvoker"

      name="jboss:service=invoker,type=jrmp">

      <attribute name="RMIObjectPort">4444</attribute>

.........

   </mbean>

……

   <mbean code="org.jboss.invocation.pooled.server.PooledInvoker"

      name="jboss:service=invoker,type=pooled">

......

        <attribute name="ServerBindPort">4445</attribute>

   </mbean>

vi $JBOSS_HOME/eaf/deploy/jbossweb-tomcat55.sar/server.xml

n         HTTP端口:默认8080

      <Connector port="8080" address="${jboss.bind.address}"

         maxThreads="250" strategy="ms" maxHttpHeaderSize="8192"

         emptySessionPath="true"

         enableLookups="false" redirectPort="8443" acceptCount="100"

         connectionTimeout="20000" disableUploadTimeout="true"/>