6 Jboss安装配置手册

中间件安装配置指南(JbossforUnix)第1章概述Jboss的安装配置总共包括下面四个部分：数据库产品的安装（详见相关数据库安装文档）初始化数据库（详见相关数据库文档）Jboss中间件的安装配置服务第2章安装数据库详见相关数据库安装文档。第3章初始化数据库详见相关数据库文档。第4章Jboss中间件产品的安装Jboss是免费软件，无需安装，可在中下载到需要的jboss版本，将下载的压缩包解压缩到本地一个目录中。生成目录如下：bin:放置jboss启动和停止的可执行脚本文件docs：放置jboss的例子、测试脚本和各种脚本配置文件的DTD（文档类型定义）lib：放置jboss所需要的部分jar包文件client:放置EJB客户端运行时所需要的jar包server：放置各启动类型的服务器端EJB配置所需要的文件等。•不同版本的Jboss包含的文件会有所不同，本篇介绍以jboss-3.2.2rc3为主。第5章配置实例配置准备在“jboss安装路径/bin”目录下找到run.sh，用文本打开，增加环境变量JAVA_HOME的路径信息设置，即JDK文件所在的路径信息（如果系统没有JDK文件，则需要安装JDK，版本一般要求为1.4）：###$Id:run.sh,v2003/05/0200:51:17slaboureExp$###exportJAVA_HOME=/opt/java1.4DIRNAME='dirname$0'PROGNAME='basename$0'GREP="grep”冷在Unix操作系统环境下，是严格区分大小写的，即Path尹path，在设置启动文件的特别需要注意。设置共享库Oracle与DB2安装后，都会自带jdbc驱动程序，oracle的在“•••/ora92/jdbc/lib”路径下，db2的在“•••/IBM/SQLLIB/java”路径下，只有SQLServer数据库需要单独安装JDBC驱动程序。SQLServer数据库需要msbase.jar、mssqlserver.jar、msutil.jar三个文件；oracle9数据库需要ojdbc14.jar、nls_charset12.zip两个文件；DB2数据库需要db2java.zip文件。方法一：将需要的jar文件复制到jboss安装路径的/lib的目录下即可；包括数据库厂商提供的jdbc共享库文件和网络报表所需的jar库文件。冷此方法操作简单，但是不利于jar包的集中管理和版本维护。方法二：将数据库厂商提供的JDBC共享库文件和网络报表所需的共享库文件复制到本地硬盘的任意目录。例如：JDBC共享库：/appdir/jdbcJAVA共享库：/appdir/jar编辑启动文件，设置相关路径：在“jboss安装路径的/bin”目录下找到run.sh，用文本编辑器打开，在该文件中找到行“#Displayourenvironment”，在该行后增加jdbc共享库信息。例如：如果上一步把Oracle共享库文件复制到了“/appdir/jdbc/oracle”目录下，JAVA共享库复制到了“/appdir/jar”目录，则写法如下：JDBC共享库：/appdir/jdbc/oracle/ojdbc14.jar;/appdir/jdbc/oracle/nls_charset12.zip;JAVA程序控件：/appdir/jar/XXXX.JAR;（参照此法填写）示例：#DisplayourenvironmentexportJAVAC_JAR=${JAVA_HOME}/lib/tools.jarEXPORTJBLIB=/appdir/jar（把jar文件保存路径设置为变量，在后面设置中直接调用，便于维护）ExportJdbclib=/appdir/jdbc（把jar文件保存路径设置为变量，在后面设置中直接调用，便于维护）exportJIUQI_JAR=${JBLIB}/jcommon.jar:${JBLIB}/jfreechart.jar:${JBLIB}/JQwebCOM.jar:${JBLIB}/jdom.jar:${JBLIB}/xerces.jar:${JBLIB}/castor--xml.jar:${JBLIB}/pluto.jar:${JBLIB}/soap.jar:${JBLIB}/tokenvalidator.jar:${JBLIB}/db1.4.jar:${JBLIB}/jxl.jar（指向jar控件，其中％JBLIB%为引用的前面设置的jar路径变量信息）exportSQL_JAR=${Jdbclib}/mssql/msbase.jar:${Jdbclib}/mssql/mssqlserver.jar:${Jdbclib}/mssql/msutil.jar（指向sqlserverjdbc文件，如果数据库为Sqlserver需要此配置）exportORACLE_JAR=${Jdbclib}/oracle/ojdbc14.jar:${Jdbclib}/oracle/nls_charset12.zip（指向oraclejdbc文件，如果数据库为Oracle需要此配置）exportDB2_JAR=${Jdbclib}/DB2/db2java.zip（指向DB2jdbc文件，如果数据库为DB2需要此配置）exportJBOSS_CLASSPATH=${JBOSS_CLASSPATH}:${JAVAC_JAR}:${RUNJAR}:${JIUQI_JAR}:${ORACLE_JAR}:${SQL_JAR}:${DB2_JAR}:$Jboss主目录/lib/javax.servlet.jar（把设置的网络报表和JDBC共享库的参数加入到CLASSPATH参数中，其中，$Jboss主目录需要根据实际目录进行调整，且此文件必须要设置，否则首页显示会出现异常）配置JDBC在“jboss安装路径/docs/examples/jca”目录下找到数据库连接的配置文件模版*.xml，其中，对于系统而言，不同的数据库对应的配置文件模版如下：SQLserver：mssql-ds.xmlOracle：oracle-ds.xmlDB2：db2-ds.xml在这些配置文件中，包含了相关数据库的JDBC驱动信息。将对应数据库的配置信息模板复制到“jboss安装路径的/server/default/deploy”目录下即可。配置数据源找到上一步复制到“jboss安装路径的/server/default/deploy”目录下的数据库连接配置文件*-ds.xml，打开并填写配置信息，不同的数据库对应的配置信息示例如下：sqlserver数据库连接文件，mssql-ds.xml：<datasources><local-tx-datasource><jndi-name>cncnetrep</jndi-name>（注意必须修改为cncnetrep）<connection-url>jdbc:microsoft:sqlserver://数据库服务器名称或ip地址：1433;DatabaseName=数据库名称;SelectMethod=Cursor（模版里没有此属性，需要手工加上，否则应用服务里不能新建和发布实例）</connection-url><driver-class>com.microsoft.jdbc.sqlserver.SQLServerDriver</driver-class><user-name>用户名</user-name><password>密码</password></local-tx-datasource></datasources>oracle数据库连接，oracle-ds.xml：<datasources><local-tx-datasource><jndi-name>cncnetrep</jndi-name>（注意必须修改为cncnetrep）<connection-url>jdbc:oracle:thin:@数据库服务器名称或ip地址:1521:数据库SID</connection-url><driver-class>oracle.jdbc.OracleDriver</driver-class><user-name>用户名</user-name><password>密码</password></local-tx-datasource></datasources>db2数据库连接文件，db2-ds.xml：<datasources><local-tx-datasource><jndi-name>cncnetrep</jndi-name>（注意必须修改为cncnetrep）<connection-url>jdbc:db2:数据库名称</connection-url><driver-class>COM.ibm.db2.jdbc.app.DB2Driver</driver-class><user-name>用户名</user-name><password>密码</password></local-tx-datasource></datasources>发布应用程序将应用程序包netrep_jboss32.ear复制到“jboss安装路径/server/default/deploy”的目录下即可。启动Jboss服务。进入到jboss安装目录的bin目录，双击运行run.sh，启动jboss服务。第6章更新程序更新主程序停止jboss服务，用新的网络报表程序包netrep_jboss32.ear覆盖原有程序包。（参见5.5）更新jar库文件将新的jar库文件复制到原来jar文件所在的目录，覆盖原有文件即可。升级数据库详见相关数据库文档在“jboss安装路径/bin”目录下执行run.sh，启动jboss服务，升级完成。结束服务时弹出结束程序的窗口，如果选择了“立即结束”，再次运行服务时会出现错误，这时清空“jboss安装路径/server/default/tmp”文件夹，再运行服务就可以了。第7章其他操作说明7.1 修改端口对于不同版本的Jboss修改端口涉及的文件也有所不同。对于JBoss3.2.3（系统目前使用的版本），在Jboss的主目录下找到“/server/default/deploy/jbossweb-tomcat41.sar/META-INF/jboss-service.xml”文件，如图：要把端口由8080改成80即可将下面文件中的port=”8080”改成port=”80”即可。<!—Ahttp/1.1connectoronport8080—》<Cannectorcla55Name-"org.apache.coyote.tomcat^.CoyoteCdnnectar"addr0££='t[;bas£.bind.address}"port='BOSO'ninProceEEQrs='5"rnaxPrDC0££ors="1OO"enatileLDDkups="true"acceDtcaunt="lo"debug="D"connect!DnT'meaut-"200DD"usedidat■onHack-"false'/>更换数据库参见5.3,5.4，修改相应的数据库连接文件。同类数据库只需修改“jboss安装路径的/server/default/deploy”目录下的数据库连接配置文件*-ds.xml里的相关数据库连接信息即可。不同类数据库1） 修改“jboss安装路径/server/default/deploy”目录下的原数据库连接配置文件*-ds.xml的文件名（例如加上后缀.bak）；2） 在启动文件中配置新数据库的JDBC共享库信息（参见5.2）3） 从“jboss安装路径/docs/examples/jca”目录下把新数据库类型对应的配置文件模版复制到“jboss安装路径/server/default/deploy”目录下；4） 参照5.4配置数据源。设置服务使用内存及字符集