一,安装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。可将这个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"/>