BPS 6.6 手工部署指南 (JBoss4) 手工部署 BPS( 单机 ) 手工部署包支持的 jboss 版本有 jboss-4.0.5.ga 和 jboss-5.1.0.ga 示例中的 jboss 版本为 jboss-4.0.5.ga, 操作系统为 Solaris(IP:192.168.2.179), 进行手工配置前需要准备好干净的 jboss 环境 1. 获取部署文件 从 BPS_6.6_Deploy_Package.zip 中获取 jboss 对应版本的 bps.war,governor.war, workspace.war 部署包 功能 bps.war 包括 BPS Process Server(BPS 流程引擎 ),BPS Rule Engine(BPS 规则引擎 ) 包括 BPS Process Composer(BPS 业务流程定制 ),BPS Rule workspace.war Composer(BPS 业务规则定制 ),BPS Admin & Monitor(BPS 流程管理监控台 ) 包括 BPS Governor(BPS 引擎治理工具 ) 它是集成 BPS 提 governor.war 供的系统管理工具, 系统管理员可以通过它对 BPS 流程引擎 进行配置和管理
2. 创建外置目录 在 ${JBOSS_HOME} 目录下创建 apps_config 目录, 在 apps_config 目录下分别创建 bps, governor,workspace 三个目录, 在三个目录下分别创建 startup.conf 文件, 并分别修改 修改 ${JBOSS_HOME}/apps_config/bps/startup.conf, 添加如下内容 : AdminPort=6200 LocalIP=192.168.2.179 修改 ${JBOSS_HOME}/apps_config/governor/startup.conf, 添加如下内容 : AdminPort=6299 LocalIP=192.168.2.179 修改 ${JBOSS_HOME}/apps_config/workspace/startup.conf, 添加如下内容 : AdminPort=6399 LocalIP=192.168.2.179 注意 :LocalIP 及 AdminPort 需要根据实际情况进行修改, 如果 LocalIP 设为 127.0.0.1 应 用只能在本机访问,AdminPort 使用的端口不能冲突, 否则会造成应用启动失败 3. 配置数据源 本示例中使用的数据库为 Oracle11g 在 ${JBOSS_HOME}/server/default/deploy 目录下创 建 *-ds.xml 文件, 这里创建的文件名为 DefaultDataSource-ds.xml, 添加如下内容 <?xml version="1.0" encoding="utf-8"?> <datasources> <local-tx-datasource> <jndi-name>defaultdatasource</jndi-name> <connection-url>jdbc:oracle:thin:@192.168.2.178:1521:orcl</connection-url> <driver-class>oracle.jdbc.driver.oracledriver</driver-class> <connection-property name="user">bps65</connection-property> <connection-property name="password">000000</connection-property> <min-pool-size>5</min-pool-size> <max-pool-size>100</max-pool-size>
</local-tx-datasource> </datasources> 注意 : 如果使用的数据库为 sybase, 还需要在配置信息中增加一行内容 <connection-property name="select_opens_cursor">true</connection-property> 修改 ${bps.war}/web-inf/_srv/config/user-config.xml, 添加如下内容, 红色部分为添加的 内容 如果 user-config.xml 文件中有这些配置信息, 则不用再添加 <module name="datasource"> <group name="default"> <configvalue key="jndi-name">defaultdatasource</configvalue> <configvalue key="transaction-isolation">isolation_read_committed</configvalue> <configvalue key="test-connect-sql">select count(*) from EOS_UNIQUE_TABLE</configValue> <configvalue key="retry-connect-count">-1</configvalue> </group> </module> 将所用数据库的驱动 jar 拷贝到 ${JBOSS_HOME}/server/default/lib 目录下 数据库驱动 可以 BPS_6.6_Deploy_Package.zip/syslib 下获取 4. 修改启动参数 修改 ${JBOSS_HOME}/bin/run.conf, 在文件最后位置添加如下内容 JAVA_OPTS="$JAVA_OPTS -Xms128m -Xmx512m -XX:MaxPermSize=128m -XX:+HeapDumpOnOutOfMemoryError" EXTERNAL_CONFIG_DIR=/home/bpstest/deploy_jboss/jboss-4.0.5.GA/apps_config JAVA_OPTS="$JAVA_OPTS -DEXTERNAL_CONFIG_DIR=$EXTERNAL_CONFIG_DIR" 如果是 windows 环境, 则只修改 ${JBOSS_HOME}/bin/run.bat 文件, 在 set JAVA_OPTS=%JAVA_OPTS% -Dprogram.name=%PROGNAME% 后添加如下内容 set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m -XX:MaxPermSize=128m -XX:+HeapDumpOnOutOfMemoryError
set EXTERNAL_CONFIG_DIR=D:\bps65\deploy_jboss405\jboss-4.0.5.GA\apps_config set JAVA_OPTS=%JAVA_OPTS% -DEXTERNAL_CONFIG_DIR=%EXTERNAL_CONFIG_DIR% 其中, 变量 EXTERNAL_CONFIG_DIR 是外置目录, 值为用户配置的外置目录的路径 5. 初始化数据库 执行 BPS_6.6_Deploy_Package.zip/dbscripts 目录下对应数据库的 sql 脚本 6. 部署 war 文件 将 bps.war 中的文件解压到 ${JBOSS_HOME}/server/default/deploy/bps.war 目录下 ; 同样 将 governor.war workspace.war 中的文件分别解压到 ${JBOSS_HOME}/server/default/deploy 下的 governor.war 和 workspace.war 目录中 7. 修改配置文件 修改 ${JBOSS_HOME}/server/default/deploy/jbossweb-tomcat55.sar/conf/web.xml 文件, 将 红色部分的注释去掉 如果没有红色部分的内容, 需要添加进来 <servlet> <servlet-name>jsp</servlet-name> <servlet-class>org.apache.jasper.servlet.jspservlet</servlet-class> <init-param> <param-name>compilersourcevm</param-name> <param-value>1.5</param-value> </init-param> </servlet> 修改 ${JBOSS_HOME}/server/default/deploy/ear-deployer.xml 文件, 将 Isolated 和 CallByValue 的值改为 true <server>
<mbean code="org.jboss.deployment.eardeployer" name="jboss.j2ee:service=eardeployer"> <attribute name="isolated">false</attribute> <attribute name="callbyvalue">false</attribute> </mbean> </server> 8. 启动服务器, 添加 BPS 应用 运行 ${JBOSS_HOME}/bin/run.bat 启动服务器 如果需要对 BPS 引擎应用进行管理, 必须 将应用添加到 governor 和 workspace 1) 将应用添加到 governor 访问 http://192.168.2.179:8080/governor, 登录 governor, 默认用户名 / 密码为 sysadmin/000000 依次点击 管理 -> 应用管理, 在应用管理界面中点击 < 增加应用 >; 输入应用名称 IP 地址 管理端口号 用户名 密码, 本示例中应用名为 bps,ip 地址为 192.168.2.179, 管路端口为 6200, 用户名为 bps, 密码为 000000; 选择 作为非集群应用, 点击 < 确定 > 完成应用添加 2) 添加应用到 workspace 访问 http://192.168.2.179:8080/workspace, 登录 workspace, 选择 引擎实例管理, 默 认用户名 / 密码为 sysadmin/000000 在引擎实例配置中添加受管引擎实例, 点击 < 添加 >, 本 示例中输入以下参数, 引擎编号 :default 引擎名称 :localserver 逻辑名称 :default IP 地址 :192.168.2.179 服务调用端口 :8080 管理端口 :6200 Web 应用 :bps 用户名 : bps 密码 :000000; 点击 < 测试连接 >, 提示 连接成功!, 点击 < 确定 > 完成引擎添加
手工部署 BPS( 集群 ) 请参见 BPS 6.6 产品安装指南.doc 的第 5 章 5.2 节手工部署方式的集群 FAQ 请参见 BPS 6.6 产品安装指南.doc 的附录 A-H