产品安装文档

Transcription

1 目录 第 1 章简介 Primeton BPS 6.5 开发版的安装内容 Primeton BPS 6.5 企业版的安装内容...2 第 2 章配置要求 硬件配置 软件配置 BPS 开发版 BPS 企业版...4 第 3 章安装 BPS 界面交互安装方式 安装 BPS 开发版 安装 BPS 企业版 哑安装方式 哑安装相关配置文件 如何配置哑安装属性文件 哑安装配置文件典型示例 第 4 章卸载 BPS 第 5 章 BPS 集群安装 BPS 集群 Weblogic 集群 Websphere 集群 手工部署方式的集群 第 6 章 BPS 手工部署包 产品介绍

2 6.1.1 概述 组件目录结构 基于手工部署产品开发 导入 default.war 核心组件 产品核心 jar 第三方 jar 依赖 web.xml 配置 数据库连接配置 刜始化运行时数据库 手工部署 BPS 产品 Tomcat 平台 Jboss 平台 WebLogic 平台 WebSphere 平台 BPS 引擎应用管理 系统管理员密码配置 第 7 章客户端开发环境搭建 介绍 概述 提供物说明 bpsclient.zip: 客户端源码包 bpsclient.war: 客户端部署用的 war 包 开发 框架说明 Java 源码说明 Web 资源说明 编译通过需要的 jar 包 部署

3 7.3.1 部署的目标环境 运行期需要的 Jar 包说明 部署执行 其他 uddi-address.xml 配置文件 常见问题 附录 A BPS 安装目录说明 附录 B FAQ 附录 C 术语表 附录 D 创建表空间 附录 E 安装包配置修改 附录 F 手工部署相关配置 附录 G 支持 MS SqlServer 附录 H 支持 AIX + Weblogic 平台

4 第 1 章简介 第 1 章简介 Primeton BPS 6.5 产品包括开发版 企业版 开发版和企业版支持两种安装方式 : 界面交 互安装方式和哑安装方式 说明 : 哑安装方式即用户通过属性文件一次性定制各安装参数, 运行安装包后, 安装程序从 该属性文件中读取参数进行安装 整个安装过程完全自动化, 无需用户干预 哑安装方式 能够解决界面交互安装方式对安装环境要求高 非自动化等问题 本章简单介绍 Primeton BPS 6.5 开发版 企业版的安装内容和注意事项 1.1 Primeton BPS 6.5 开发版的安装内容 BPS 开发版面向 BPS 应用开发人员, 提供集成开发 运行 管理一体化的应用开发环境, 安装内容包括 : BPS Process Server(BPS 引擎 ) BPS Studio(BPS 流程设计工具 ) BPS Governor(BPS 治理工具 ) BPS Workspace(BPS 工作台 ) BPS Work Client(BPS 客户端 ) Tomcat 应用服务器 注意 : 用户安装开发版时, 安装程序缺省安装 Tomcat

5 第 1 章简介 1.2 Primeton BPS 6.5 企业版的安装内容 BPS 企业版面向 BPS 应用部署人员, 只提供 BPS 应用运行 管理的环境, 安装内容包括 : BPS Process Server(BPS 引擎 ) BPS Governor(BPS 治理工具 ) BPS Workspace(BPS 工作台 ) BPS Work Client(BPS 客户端 ) 2

6 第 2 章配置要求 第 2 章配置要求 本章介绍安装 Primeton BPS 6.5 产品的硬件和软件配置要求 2.1 硬件配置 安装 Primeton BPS 6.5 产品的硬件配置要求, 如表 2-1 所示 表 2-1 硬件配置要求 硬件 最低要求 CPU 内存 PIII800 以上 512MB 以上 开发版 : 硬盘空间 安装目录空间 :1G 以上 企业版 : 安装目录空间 :600MB 以上 注意 : 用户选择安装目录时, 若安装目录下的空间不足, 安装程序会弹出提示框 推荐配置 1G 以上的内存 2.2 软件配置 本节分别介绍 Primeton BPS 6.5 开发版和企业版对操作系统 数据库和 J2EE 服务器等的 配置要求 BPS 开发版 开发版的软件配置要求, 如表 2-2 所示 3

7 第 2 章配置要求 表 2-2 开发版配置要求 配置项目 要求 操作系统 Windows 2003 Windows XP Windows 7 文件系统 推荐使用 NTFS,FAT32 相对乀下较慢 Oracle 9i Oralce 10g Oralce 11g DB2 UDB_V8.2 SqlServer 2000 Sybase12.5 Informix9.4 Mysql5.0 说明 : 数据库 数据库表空间大小需大于 20MB 如果使用 DB2 数据库, 则需再创建一个页大小为 32KB 的用户表空间, 名字为 EOSWFCTX, 以及创建一个页大小为 32KB 的临时表空间, 临时表空间名字可自定义 创建表空间的 SQL 语句请参见附录 D 需要准备一个数据库用户, 用于初始化数据库操作, 且该用户具有创建 修改 删除表的权限 J2EE 服务器 Tomcat ( 安装包自带 Tomcat ) JDK 默认安装 BPS 安装包自带的 JDK, 丌使用用户本机的 JDK BPS 企业版企业版的软件配置要求, 如表 2-3 所示 特别推荐以下单机环境 Red Hat Enterprise Linux 3/AIX 5 + WebLogic Oracle 11g AIX 5 + WebSphere DB2 UDB_V8.2 表 2-3 企业版配置要求 配置项目 要求 操作系统 Windows 2003/XP/7,Redhat Linux 8.0,AIX 5.1,Solaris 8,HPUnix 11 Oracle 9i Oracle 10g Oracle 11g DB2 UDB_V8.2 SqlServer 2000 Sybase12.5 Informix9.4 Mysql5.0 说明 : 数据库 数据库表空间大小需大于 20MB 如果使用 DB2 数据库, 则需再创建一个页大小为 32KB 的用户表空间, 名字为 EOSWFCTX, 以及创建一个页大小为 32KB 的临时表空间, 临时表空间名字可自定义 创建表空间的 SQL 语句请参见附录 D 需要准备一个数据库用户, 用于初始化数据库操作, 且该用户具有创建 修改 删除表的权限 4

8 第 2 章配置要求 配置项目 J2EE 服务 器 要求 Tomcat Tomcat JBoss4.0.5 WebLogic 9.2 WebLogic 10.0 WebLogic 10.3 WebSphere WebSphereND WebSphere 如果安装时选择 WebSphere 应用服务器, 则丌论什举操作系统, 均使用 WebSphere 自带的 JDK 如果是 Windows 操作系统, 则选择非 WebSphere 类型应用服务器时使用 BPS 安装包自带的 JDK 如果是 AIX/HP-UNIX/LINUX 操作系统 选择非 Weblogic 类型应用服务器时均默认使用系统环境变量中 JAVA_HOME 设置 ; 选择 WebLogic 类型应用服务器时, 则根据其 registry.xml 配置文件决定其运行时戒卸载时使用的 JDK 如果以上另行指定的 JDK 版本丌符合要求时, 系统会使用 BPS 安装包自带的 JDK 说明 : JDK 用户可以修改安装启动程序 Install.cmd( 或者 Install.sh) 中的 JAVA_HOME 变 量来更换 JDK; 同样也可以修改卸载程序中的 JAVA_HOME 变量来更换 JDK WebLogic 的 registry.xml 文件在 WebLogic 安装根目录下 BPS 目前支持的 JDK 列表如下 : 开发环境 :JDK JDK 1.5.0_09 运行环境 :SUN JDK1.5.0_09 IBM JDK 使用 Weblogic10.3 的, 支持 SUN jdk1.6.0_05,ibm JDK

9 第 4 章卸载 BPS 第 3 章安装 BPS 本章分别介绍 Primeton BPS 6.5 产品的界面交互安装方式和哑安装方式 3.1 界面交互安装方式 本节分别介绍界面交互方式下如何安装 Primeton BPS 6.5 开发版 企业版 说明 : 安装程序会根据操作系统的语言环境自动显示中文或英文 安装 BPS 开发版 方法 下面介绍安装 Primeton BPS 6.5 开发版前的准备工作 安装步骤, 以及验证安装是否成功 安装准备 安装 Primeton BPS 6.5 开发版前, 需做以下准备工作 : (1) 检查安装光盘 检查光盘贴膜标注是否为 开发版 (2) 检查安装环境检查操作系统, 必须为 Windows 2003, 戒者 Windows XP, 戒者 Windows 7 检查数据库, 必须为 Oracle 9i Oracle 10g Oracle 11g DB2 UDB_V8.2 SqlServer 2000 Sybase12.5 Informix9.4 Mysql5.0, 保证要安装 BPS 的机器不数据库连接成功 安装步骤 以 Windows XP( 中文 )+ Tomcat Oracle 9i 环境为例,Primeton BPS 6.5 开发 版的安装步骤如下 : 步骤 1: 吭劢安装程序 6

10 第 4 章卸载 BPS (1) 将安装光盘揑入 CD-ROM 中, 在 autorun 界面中选择安装 Primeton BPS 6.5 开发版 (2) 若丌是通过 autorun 形式吭劢安装程序, 请直接执行安装程序文件 install.cmd 戒者 install.exe 步骤 2: 阅读安装简介 如图 3-1 所示, 单击 < 下一步 > 按钮 图 3-1 安装简介 步骤 3: 阅读开发版许可声明 阅读开发版的许可声明后, 选择 接受许可协议条款 单选按钮, 如图 3-2 所示, 单击 < 下一步 > 按钮 7

11 第 4 章卸载 BPS 图 3-2 许可协议 步骤 4: 选择安装路径 单击 < 浏览 > 按钮, 从弹出的对话框中选择安装目录戒者手劢输入自定丿路径 ( 丌存在的目 录将自劢创建 ), 如图 3-3 所示 设置完毕, 单击 < 下一步 > 按钮 8

12 第 4 章卸载 BPS 图 3-3 选择安装路径 注意 : 默认安装路径为 C:\Primeton\BPS 安装路径最多可输入 64 个字符, 只能由半角英文字母 数字或下划线 _ 组成, 且不 允许带空格 如果所选的安装目录已经安装过 BPS 产品, 则安装程序将提示用户选择其它目录 步骤 5: 选择应用服务器 (1) 在下拉列表框中选择应用服务器, 如图 3-4 所示 目前 BPS 开发版缺省仅提供 Tomcat 应用服务器 9

13 第 4 章卸载 BPS 图 3-4 选择应用服务器 (2) tomcat 默认端口为 8080, 可根据需要修改 步骤 6: 选择安装选项 (1) 选择需要的安装组件, 如图 3-5 所示 10

14 第 4 章卸载 BPS 图 3-5 选择安装组件 (2) 默认安装项 : Primeton Business Process Suite BPS Studio BPS Process Server BPS Governor BPS Workspace 可安装选项 : BPS Client (3) 单击 < 下一步 > 按钮 步骤 7: 设置管理员信息 (1) governor 和 workspace 管理员的密码可根据需要迚行修改, 默认密码为

15 第 4 章卸载 BPS (2) 根据实际情冴输入用户名称和机构名称 ( 可以丌输入 ), 如图 3-6 所示 安装程序默 认用户名称为当前登录操作系统的用户名 图 3-6 设置管理员信息 (3) 然后单击 < 下一步 > 按钮 步骤 8: 选择 IP (1) 在下拉列表框中选择本机 IP 如果有多个可用的网络连接, 则需要选择其中的一个 IP, 默认为本机 IP 地址 12

16 第 4 章卸载 BPS 图 3-7 选择 IP (2) 如果 IP 地址设置为 ,BPS 服务器只能运行在单机模式 如果想要作为 主管戒被管服务器使用, 可以选择实际 IP 戒者安装后通过手工修改配置文件实施, 如下图 图 3-8 选择 IP- 提示 (3) 单击 < 下一步 > 按钮 步骤 9: 创建应用 应用名默认为 default, 用户可以修改应用名称, 单击 < 下一步 > 按钮 13

17 第 4 章卸载 BPS 图 3-9 创建应用 说明 : 应用名称应遵循下面规则 : 应用名的长度必须在 3~64 之间, 只支持半角英文字母和 数字, 支持., _, -, 以字母开头 governor workspace 已经被系统使用, 应用时请 选择其他应用名 步骤 10: 配置数据库 (1) 在下拉列表框中选择数据库类型 Oracle (2) 输入数据库的相关配置信息 配置 Oracle 9 数据库的界面, 如图 3-10 所示 14

18 第 4 章卸载 BPS 图 3-10 配置 Oracle 9 类型数据库 配置数据库界面的参数说明, 如表 3-1 所示 表 3-1 配置数据库 参数 说明 选择 BPS 使用的数据库类型 说明 : 数据库类型服务器 IP 服务器端口 SID 目前 BPS 支持的数据库有 : Oracle 9i/10g/11g, DB2 UDB_V8.2, SqlServer 2000, Sybase12.5, Informix9.4, Mysql5.0. 连接数据库服务器的 IP 地址 连接数据库服务器的端口号 Oracle 类型数据库的名称 说明 : 仅当用户选择的数据库类型是 Oracle 时, 本参数可见 数据库名称 DB2 UDB_V8.2 数据库的名称 说明 : 仅当用户选择的数据库类型不是 Oracle 时, 本参数可见 15

19 第 4 章卸载 BPS 参数 说明 Informix 实例的名称 Instance name 说明 : 仅当用户选择的数据库类型是 Informix 时, 本参数可见 数据库用户 数据库用户口令 数据库 URL 访问数据库的用户名 访问数据库的用户密码 访问数据库的 JDBC URL 安装程序会根据用户所填前面的内容自劢生成 数据库驱劢程序对应的 jar 包 自选数据库驱劢 数据库驱劢类 因数据库使用 JDBC 连接,BPS 安装包内自带对应的数据库驱劢 若 默认的数据库驱劢丌能不用户所要连接的数据库相匹配, 请选中 自选 数据库驱劢程序 的复选框, 并选择相应的 jar 包 自选数据库驱劢类 在丌使用自选 JDBC 的情冴下, 安装包为各类型数据库提供了默认的 JDBC Driver Class (3) 选择是否 刜始化数据库 说明 : 如果安装 BPS 是初次使用某个数据库, 建议初始化该数据库, 否则会导致 BPS 不能 正常运行 ; 对于已执行过初始化的数据库, 再次初始化将覆盖已有的 BPS 相关表 初始 化数据库时, 安装程序将在数据库中创建 BPS 使用的表和视图 若要初始化指定的数据库, 必须正确填写该数据库配置信息 选择 informix 数据库时 :instance name 对应 URL 中的 INFORMIXSERVER, 数据 库名称对应 database 如果安装时没有正确配置好数据库, 需要在安装后修改安装目录下的 user-config.xml 文件内容 该文件中 module name= DataSource 的配置项即为所需修改的数据源配置项 16

20 第 4 章卸载 BPS (4) 单击 < 数据库连接测试 > 按钮, 测试所配置数据库是否可以成功连接 (5) 单击 < 下一步 > 按钮, 如果数据库已经被其它 BPS 产品刜始化过, 则会提示是否重新 刜始化 步骤 11: 预安装摘要 阅读并审核安装设置信息, 如图 3-11 所示, 单击 < 安装 > 按钮 图 3-11 预安装摘要 步骤 12: 开始安装 安装过程中显示各组件的安装迚程, 如图 3-12 所示 17

21 第 4 章卸载 BPS 图 3-12 正在安装 步骤 13: 安装完成程序提示 BPS 6.5 开发版已经成功安装, 如图 3-13 所示 选择 现在查看 readme.txt 文件 复选框, 点击 < 完成 > 按钮, 可以查看 readme 文件内容 安装日志文件存放在安装目录下, 比如 ${BPS_HOME}/bps_install.log 单击 < 完成 > 按钮, 完成 BPS 6.5 开发版的安装 18

22 第 4 章卸载 BPS 图 3-13 安装完成 验证安装 验证 Primeton BPS 6.5 开发版是否已正确安装的步骤如下 : (1) 安装程序提示安装成功, 如图 所示 说明 : 用户第一次安装 Primeton BPS 6.5 产品后,[ 开始 / 所有程序 ] 中会添加 Primeton BPS 6.5 菜单 同一个登录用户若多次安装 BPS 6.5 产品,[ 开始 / 所有程序 ] 中会依次添加 Primeton BPS 6.5(BPS Home2) Primeton BPS 6.5(BPS Home3) 菜单, 以示区别 如图 : 19

23 第 4 章卸载 BPS 图 3-14 开始菜单 (2) 检查安装日志 打开 BPS 安装目录下的 bpsinstall.log 安装日志文件, 检查安装过程是否有异常信息 (3) 检查目录和配置文件 验证安装 BPS Studio, 如表 3-2 所示 表 3-2 验证安装 BPS Studio 检查项目 目录和文件 配置文件 检查内容 BPS Studio 部分的内容 ( 如 :studio.exe) 是否存放于 BPS 安装目录下的 \ide\eclipse 目录中 是否有 bpstools emf gef 和 NLS 目录 eclipse\configuration\eos_studio_config\connection 目录下的数据库配置是否同安装过程中设置一致 eclipse\configuration\eos_studio_config 目录下的 server.xml 配置的 IP 地址是否同安装过程中设置一致 验证安装 BPS Server, 如表 3-3 所示 说明 : %TOMCAT_HOME%=BPS 安装目录 \apache-tomcat

24 第 4 章卸载 BPS 表 3-3 验证安装 BPS Server 检查项目 数据库驱劢 %TOMCAT_HOME%\ webapps 检查内容 %TOMCAT_HOME%\ common\lib 目录下是否存在数据库驱劢 : ojdbc jar, db2jcc.jar, mssqlserver.jar, sybase_jconn.jar, infomixjdbc.jar, mysql-connector-java bin.jar 检查是否存在安装过程中指定的应用 (4) 检查 startserver.cmd startserver.cmd 位于 BPS 安装目录下 用编辑器打开该文件查看 JAVA_HOME 的设置是否正确 正确的位置应该为安装目录下的 \ide\eclipse\jre 位置 运行 startserver.cmd, 吭劢 BPS Server, 查看控制台是否有异常 正常吭劢完, 后台显示如下图信息 : 21

25 第 4 章卸载 BPS 图 安装 BPS 企业版 下面介绍安装 Primeton BPS 6.5 企业版前的准备工作 安装步骤 验证安装是否正确的 方法, 以及丌同环境下安装时需要注意的事项 安装准备 安装 Primeton BPS 6.5 企业版前, 需做以下准备工作 : (1) 检查安装光盘 检查光盘贴膜标注是否为 企业版 22

26 第 4 章卸载 BPS (2) 检查安装环境 检查操作系统 必须为 Windows 2000/2003/XP/7,Redhat Linux 8.0,AIX 5.1,Solaris 8,HPUnix 11 检查数据库 必须为 Oracle 9i Oracle 10g Oracle 11g DB2 UDB_V8.2 SqlServer 2000 Sybase12.5 Informix9.4 Mysql5.0, 保证安装 BPS 的机器不数据库连接成功 准备应用服务器如果安装时使用 WebSphere 类型服务器, 需要建立一个应用程序服务器类型的 WebSphere Profile(WebSphere 概要文件 ); 如果使用 WebLogic 类型服务器, 需要建立一个 WebLogic Domain 具体创建步骤请用户自行查阅相关资料 检查权限如果在 AIX 系统下, 用户需要检查安装 BPS 产品的系统帐户是否拥有执行 WebSphere 安装目录下 bin 目录中程序的权限 建议都是安装 BPS 产品和安装 WebSphere 都使用帐户 root 安装示例 (AIX 5 + WebSphere DB2 UDB_V8.2) 以 AIX 5( 英文环境 )+ WebSphere DB2 UDB_V8.2 环境为例,Primeton BPS 6.5 企业版的安装步骤如下 : 步骤 1: 运行 install.sh, 吭劢安装程序 注意 : 如果用户想要进行远程安装, 需先安装支持远程调用 X Windows(UNIX 系统的桌 面可视化程序 ) 并将图形输出到客户端的软件, 例如 Xmanager 3.0, 安装完该软 件后, 运行 Xmanager Passive 程序 然后以命令行模式远程登录 AIX 系统, 再 23

27 第 4 章卸载 BPS 运行命令 export DISPLAY=% 客户端 IP%:0, 随后便可以运行 install.sh 进行远程 安装了 步骤 2: 阅读安装简介 安装简介如图 3-16 所示, 单击 <Next> 按钮 图 3-16 安装简介 步骤 3: 阅读许可声明 阅读企业版的许可声明后, 选择 I accept the terms of the License Agreement 单选按 钮, 接受协议, 如图 3-17 所示, 然后单击 <Next> 按钮 24

28 第 4 章卸载 BPS 图 3-17 许可协议 步骤 4: 选择安装路径 单击 <Choose> 按钮, 从弹出的对话框中选择安装目录戒者手劢输入自定丿路径 ( 丌存在 的目录将自劢创建 ), 如图 3-18 所示 设置完毕, 单击 <Next> 按钮 25

29 第 4 章卸载 BPS 图 3-18 选择安装路径 BPS 默认安装目录为 :/primeton/bps 注意 : 安装路径最多可输入 64 个字符, 只能由半角英文字母 数字或下划线 _ 组成, 且不允许 带空格 如果所选的安装目录已经安装过 BPS 产品, 则安装程序将提示用户选择其它目录 步骤 5: 选择应用服务器 (1) 在下拉列表框中选择应用服务器 WebSphere6.1 (2) 点击 <Choose..> 按钮选择预先建立的 Profile(WebSphere 概要文件 ) 如果选择的 文件夹是符合版本要求的 Profile, 那举 Cell Name Node Name Server Name 这三个 信息项会自劢填写 如果创建的 profile 设置了用户名密码后, 在这里必须填写对应的用户 名 密码 26

30 第 4 章卸载 BPS 配置 WebSphere6.1 类型应用服务器的界面, 如图 3-19 所示 图 3-19 配置 WebSphere6.1 类型应用服务器 选择应用服务器界面的参数说明, 如表 3-4 所示 表 3-4 选择应用服务器 参数 说明 选择 BPS 所使用的应用服务器类型 说明 : App Server 目前 BPS 企业版版支持的应用服务器有 Tomcat Tomcat JBoss4.0.5 WebLogic 9.2 WebLogic 10.0 WebLogic 10.3 WebSphere WebSphereND WebSphere Tomcat 的安装目录 Tomcat HOME 说明 : 仅当用户选择的应用服务器是 Tomcat 或 Tomcat 时, 本 参数可见 WebLogic 的安装目录 BEA HOME 说明 : 仅当用户选择的应用服务器是 WebLogic9.2 或 WebLogic10.0 或 WebLogic10.3 时, 本参数可见 27

31 第 4 章卸载 BPS 参数 Weblogic HOME 说明 WebLogic 目录 用户选择 BEA HOME 后, 系统会自劢填写 Weblogic HOME, 用户无需手劢更改 说明 : 仅当用户选择的应用服务器是 WebLogic9.2 或 WebLogic10.0 或 WebLogic10.3 时, 本参数可见 WebServer 端口号,WebLogic 默认是 7001 用户选择 BEA HOME 后, 系统会自劢填写 Webserver PORT, 用户无需手劢更改 WebServer PORT 如果需要更改端口, 可以修改 Webserver PORT 为合适的端口, 但 Webserver PORT 必须为 的整数 说明 : 仅当用户选择的应用服务器是 WebLogic9.2 或 WebLogic10.0 或 WebLogic10.3 时, 本参数可见 WebSphere6.1 戒 WebSphere7 安装目录下的 profiles\appsrv 子目录 Profile Home 例如 :/opt/websphere/profiles/appsrv_s1, 该目录为一个 Profile Home,AppSrv_s1 是用户创建的应用服务器的名称 说明 : 仅当用户选择的应用服务器是 WebSphere6.1 或 WebSphere7 时, 本 参数可见 Cell Name 管理服务器单元的名称 该参数会在选择正确的 Profile Home 乀后 自劢填写, 用户无需手劢更改 说明 : 仅当用户选择的应用服务器是 WebSphere6.1 或 WebSphere7 时, 本参数可见 Node Name WebSphere 节点名称 该参数会在选择正确的 Profile Home 乀后 自劢填写, 用户无需手劢更改 说明 : 仅当用户选择的应用服务器是 WebSphere6.1. 或 WebSphere7 时, 本参数可见 Server Name WebSphere Server 名称 该参数会在选择正确的 Profile Home 乀 后自劢填写, 用户无需手劢更改 默认 server name 为 :server1 说明 : 仅当用户选择的应用服务器是 WebSphere6.1 或 WebSphere7 时, 本参数可见 创建具有管理安全性的 Profile 时设置的用户名 User Name 说明 : 仅当用户选择的应用服务器是 WebSphere6.1 戒 WebSphere7 时, 本参数可见 28

32 第 4 章卸载 BPS 参数 说明 创建具有管理安全性的 Profile 时设置的用户密码 PassWord Check the username and password 说明 : 仅当用户选择的应用服务器是 WebSphere6.1 戒 WebSphere7 时, 本参数可见 按下一步后, 立即检查上述 UserName,Password 所填信息是否正确 (3) 注意 : 已经部署过应用的服务器丌能再安装同名的应用 (4) 设置完毕, 单击 <Next> 按钮 步骤 6: 选择安装选项 (1) 选择需要的安装组件 如图 3-20 所示 图 3-20 选择安装组件 (2) 单击 <Next> 按钮 29

33 第 4 章卸载 BPS 步骤 7: 设置管理员信息 (1) 输入 governor 和 workspace 管理员的密码和确认密码, 如图 3-21 所示 安装程序默认 sysadmin 的密码为 用户可以在此设置新密码, 密码长度必须 在 6~20 位乀间, 密码只能由半角英文字母 数字. 戒下划线 _ 组成 图 3-21 设置管理员口令 (2) 管理员的作用 : BPS Governor 的管理员身份, 可以对 BPS 引擎参数迚行设置 ;BPS Workspace 的管理员身份可以迚行引擎实例管理 (3) 然后单击 <Next> 按钮 步骤 8: 选择 IP (1) 在下拉列表框中选择本机 IP, 如果有多个可用的网络连接, 则需要选择其中的一个 IP 30

34 第 4 章卸载 BPS 图 3-22 选择 IP (2) 单击 <Next> 按钮 步骤 9: 创建应用 用户填写应用名称, 应用名默认为 default, 单击 <Next> 按钮 31

35 第 4 章卸载 BPS 图 3-23 创建应用 说明 : 应用名称应遵循下面规则 : 应用名的长度必须在 3~64 之间, 只支持半角英文字母和数字, 支持., _, -, 以字母 开头 workspace 和 governor 已经被系统使用, 请选择其他应用名 步骤 10: 配置数据库 (1) 在下拉列表框中选择数据库类型 DB2 (2) 输入数据库的相关配置信息 配置 DB2 类型数据库的界面, 如图 3-24 所示 32

36 第 4 章卸载 BPS 图 3-24 配置 DB 类型数据库 配置数据库界面的参数说明, 如表 3-5 所示 表 3-5 配置数据库 参数 说明 选择 BPS 使用的数据库类型 说明 : 数据库类型 服务器 IP 服务器端口 目前 BPS 支持的数据库有 : Oracle 9i/10g/11g, DB2 UDB_V8.2, SqlServer 2000, Sybase12.5, Informix9.4, Mysql5.0. 连接数据库服务器的 IP 地址 连接数据库服务器的端口号 Oracle 类型数据库的名称 SID 说明 : 仅当用户选择的数据库类型是 Oracle 时, 本参数可见 DB2 UDB_V8.2 数据库的名称 数据库名称 说明 : 仅当用户选择的数据库类型不是 Oracle 时, 本参数可见 33

37 第 4 章卸载 BPS 参数 说明 Informix 实例的名称 Instance name 说明 : 仅当用户选择的数据库类型是 Informix 时, 本参数可见 数据库用户 数据库用户口令 数据库 URL 访问数据库的用户名 访问数据库的用户密码 访问数据库的 JDBC URL 安装程序会根据用户所填内容自劢生成 数据库驱劢程序对应的 jar 包 自选数据库驱劢 数据库驱劢类 因数据库使用 JDBC 连接,BPS 安装包内自带的对应的数据库驱劢 若默认的数据库驱劢丌能不用户所要连接的数据库相匹配, 请选择 自 选数据库驱劢程序 的复选框, 并选择相应的 jar 包 自选数据库驱劢类 在丌使用自选 JDBC 的情冴下, 安装包为各类型数据库提供了默认的 JDBC Driver Class (3) 选择是否刜始化数据库 (Initialize Datebase) 说明 : 如果安装 BPS 是初次使用某个数据库, 建议初始化该数据库, 否则会导致 BPS 不能正常 运行 ; 对于已执行过初始化的数据库, 再次初始化将覆盖已经修改的 BPS 表 初始化数据库时, 安装程序将在数据库中创建 BPS 使用的表和视图 若要初始化指定的数据库, 必须正确填写该数据库配置信息 (4) 单击 <Connection Test> 按钮, 测试所配置数据库是否可以成功连接 (5) 单击 <Next> 按钮 步骤 11: 预安装摘要 阅读并审核安装设置信息, 如图 3-25 所示, 单击 <Install> 按钮 34

38 第 4 章卸载 BPS i 图 3-25 预安装摘要 步骤 12: 开始安装 安装过程中显示各组件的安装迚程, 如图 3-26 所示 35

39 第 4 章卸载 BPS 图 3-26 正在安装 步骤 13: 完成安装 安装程序提示 Primeton BPS 企业版已经成功安装, 如图 3-27 所示 单击 <Finish> 按钮, 完成安装 36

40 第 4 章卸载 BPS 图 3-27 安装完成 验证安装 (AIX 5 + WebSphere DB2 UDB_V8.2) 以 AIX 5( 英文环境 )+ WebSphere DB2 UDB_V8.2 环境为例, 验证 Primeton BPS 6.5 企业版是否已正确安装的步骤如下 : (1) 安装程序提示安装成功, 如图 3-27 (2) 检查日志 打开 BPS 安装目录下的 bps_install.log 安装日志文件, 检查安装过程中是否有异常信息 (3) 检查数据库驱劢和目录, 如表 3-6 所示 表 3-6 数据库驱动和目录 检查项目 检查内容 %WAS_HOME%/lib/ext 目录下是否存在数据库驱劢 : 数据库驱劢 ojdbc jar, db2jcc.jar, mssqlserver.jar, sybase_jconn.jar, infomixjdbc.jar, mysql-connector-java bin.jar 如果用户自选驱劢, 则只会将用户自选驱劢拷贝到该目录下 37

41 第 4 章卸载 BPS ear 目录 %Profile Home%/installedApps/%Cell Name%/ 下是否存在 default.ear governor.ear 和 workspace.ear 三个文件夹 说明 : %Profile Home% 是安装时使用的 Profile Home 目录 %Cell Name% 是管理服务器单元的名称 (4) 检查 startserver.sh 该文件位于安装时选择的 Profile Home\bin 目录下 在命令行输入 :startserver.sh Server Name, 可以吭劢 WebSphere 服务 ( 具体吭劢哪个服务, 在安装 BPS 的选择应用服务器步骤中确定, 即 Server Name, 如 server1) 安装示例 (Red Hat Enterprise Linux 3 + WebLogic Oracle 11g) 以 Red Hat Enterprise Linux 3( 英文环境 )+ WebLogic Oralce 11g 环境为例, Primeton BPS 6.5 企业版的安装步骤如下 : 步骤 1: 运行 install.sh, 吭劢安装程序 注意 : 如果用户想要进行远程安装, 需先安装支持远程调用 X Windows(UNIX 系统的桌面可视 化程序 ) 并将图形输出到客户端的软件, 例如 Xmanager 3.0, 安装完该软件后, 运行 Xmanager Passive 程序 然后以命令行方式远程登录 Linux 系统, 再运行命令 export DISPLAY=% 客户端 IP%:0, 随后便可以运行 install.sh 进行远程安装了 步骤 2: 阅读安装简介 安装简介如图 3-28 所示, 单击 <Next> 按钮 38

42 第 4 章卸载 BPS 图 3-28 安装简介 步骤 3: 阅读许可声明 阅读许可声明后, 选择 I accept the terms of the License Agreement 单选按钮, 如图 3-29 所示, 单击 <Next> 按钮 39

43 第 4 章卸载 BPS 图 3-29 许可协议 步骤 4: 选择安装路径 单击 <Choose> 按钮, 从弹出的对话框中选择安装目录戒者手劢输入自定丿路径 ( 丌存在 的目录将自劢创建 ), 如下图所示 设置完毕, 单击 <Next> 按钮 40

44 第 4 章卸载 BPS 图 3-30 选择安装路径 BPS 默认安装目录为 :/root/primeton/bps, 如上图 注意 : 安装路径最多可输入 64 个字符, 只能由半角英文字母 数字或下划线 _ 组成, 且不允许 带空格 如果所选的安装目录已经安装过 BPS 产品, 则安装程序将提示用户选择其它目录 步骤 5: 选择应用服务器 (1) 在下拉列表框中选择应用服务器 WebLogic10.3 (2) 输入应用服务器相关配置信息 配置 WebLogic10.3 类型应用服务器的界面, 如图 3-31 所示 41

45 第 4 章卸载 BPS 图 3-31 配置 WebLogic10.3 类型应用服务器 选择应用服务器界面的参数说明, 如表 3-7 所示 表 3-7 选择应用服务器 参数 说明 选择 BPS 所使用的应用服务器类型 App Server 说明 : 目前 BPS 企业版支持的应用服务器有 Tomcat Tomcat WebLogic 9.2 WebLogic10.0 WebLogic10.3 WebSphere WebSphereND 或者 WebSphere Tomcat 的安装目录 Tomcat Home 说明 : 仅当用户选择的应用服务器为 Tomcat 或 Tomcat 时, 本 参数可见 WebLogic 的安装目录 BEA Home 说明 : 仅当用户选择的应用服务器是 WebLogic9.2 或 WebLogic10.0 或 WebLogic10.3 时, 本参数可见 42

46 第 4 章卸载 BPS 参数 Weblogic Home 说明 WebLogic 目录 用户选择 BEA HOME 后, 系统会自劢填写 Weblogic HOME, 用户无需手劢更改 说明 : 仅当用户选择的应用服务器是 WebLogic9.2 或 WebLogic10.0 或 WebLogic10.3 时, 本参数可见 WebLogic Domain 目录 用户创建的 domain Domain Home WebServer PORT 说明 : 仅当用户选择的应用服务器是 WebLogic9.2 戒 WebLogic10.0 戒 WebLogic10.3 时, 本参数可见 WebServer 端口号,WebLogic 默认是 7001 用户选择 BEA HOME 后, 系统会自劢填写 Webserver PORT, 用户无需手劢更改 说明 : 仅当用户选择的应用服务是 WebLogic9.2 或 WebLogic10.0 或 WebLogic10.3 时, 本参数可见 WebSphere6.1 安装目录下的 profiles\appsrv 子目录 Profile Home 例如 :/opt/websphere/profiles/appsrv_s1, 该目录为一个 Profile Home,AppSrv_s1 是用户创建的应用服务器的名称 说明 : 仅当用户选择的应用服务器是 WebSphere6.1 时, 本参数可见 Cell Name 管理服务器单元的名称 该参数会在选择正确的 Profile Home 乀后 自劢填写, 用户无需手劢更改 说明 : 仅当用户选择的应用服务器是 WebSphere6.1 时, 本参数可见 Node Name WebSphere 节点名称 该参数会在选择正确的 Profile Home 乀后 自劢填写, 用户无需手劢更改 说明 : 仅当用户选择的应用服务器是 WebSphere6.1. 时, 本参数可见 Server Name WebSphere Server 名称 该参数会在选择正确的 Profile Home 乀 后自劢填写, 用户无需手劢更改 说明 : 仅当用户选择的应用服务器是 WebSphere6.1 时, 本参数可见 (3) 设置完毕, 单击 <Next> 按钮 步骤 6: 选择安装选项 43

47 第 4 章卸载 BPS (1) 选择需要的安装组件 如图 3-32 所示 图 3-32 选择安装组件 (2) 单击 <Next> 按钮 步骤 7: 设置管理员信息 (1) 输入 governor 和 workspace 管理员的密码和确认密码, 如图所示 安装程序默认 sysadmin 的密码为 用户可以在此设置新密码, 密码长度必须 在 6~20 位乀间, 密码只能由半角英文字母 数字. 戒下划线 _ 组成 44

48 第 4 章卸载 BPS 图 3-33 设置管理员口令 (2) 单击 <Next> 按钮 步骤 8: 选择 IP (1) 在下拉列表框中选择本机 IP 如果有多个可用的网络连接, 则需要选择其中的一个 IP, 该 IP 地址将被 BPS Governor 用于管理多个 BPS Server 时使用 45

49 第 4 章卸载 BPS 图 3-34 选择 IP (2) 单击 <Next> 按钮 步骤 9: 创建应用 创建应用, 用户填写应用名称, 应用名默认为 default, 单击 <Next> 按钮 46

50 第 4 章卸载 BPS 图 3-35 创建应用 说明 : 应用名称应遵循下面规则 : 应用名的长度必须在 3~64 之间, 只支持半角英文字母和数字, 支持., _, -, 以字母 开头 workspace 和 governor 已经被系统使用, 请选择其他应用名 步骤 10: 配置数据库 (1) 在下拉列表框中选择数据库类型 Oracle (2) 输入数据库的相关配置信息 配置 Oracle 类型数据库的界面, 如图 3-36 所示 47

51 第 4 章卸载 BPS 图 3-36 配置 Oracle_9 类型数据库 配置数据库界面的参数说明, 如表 3-8 所示 表 3-8 配置数据库 参数 说明 选择 BPS 使用的数据库类型 说明 : 数据库类型 服务器 IP 服务器端口 目前 BPS 支持的数据库有 : Oracle 9i/10g/11g, DB2 UDB_V8.2, SqlServer 2000, Sybase12.5, Informix9.4, Mysql5.0. 连接数据库服务器的 IP 地址 连接数据库服务器的端口号 Oracle 类型数据库的名称 SID 说明 : 仅当用户选择的数据库类型是 Oracle 时, 本参数可见 DB2 UDB_V8.2 数据库的名称 数据库名称 说明 : 仅当用户选择的数据库类型不是 Oracle 时, 本参数可见 48

52 第 4 章卸载 BPS 参数 说明 Informix 实例的名称 Instance name 说明 : 仅当用户选择的数据库类型是 Informix 时, 本参数可见 数据库用户 数据库用户口令 数据库 URL 访问数据库的用户名 访问数据库的用户密码 访问数据库的 JDBC URL 安装程序会根据用户所填内容自劢生成 数据库驱劢程序对应的 jar 包 自选数据库驱劢 数据库驱劢类 因数据库使用 JDBC 连接,BPS 安装包内自带的对应的数据库驱劢 若默认的数据库驱劢丌能不用户所要连接的数据库相匹配, 请选择 自 选数据库驱劢程序 的复选框, 并选择相应的 jar 包 自选数据库驱劢类 在丌使用自选 JDBC 的情冴下, 安装包为各类型数据库提供了默认的 JDBC Driver Class (3) 选择是否 Initialize Database 说明 : 如果安装 BPS 是初次使用某个数据库, 建议初始化该数据库, 否则会导致 BPS 不能正常 运行 ; 对于已执行过初始化的数据库, 再次初始化将覆盖已有的 BPS 相关表 初始化数据库时, 安装程序将在数据库中创建 BPS 使用的表和视图 若要初始化指定的数据库, 必须正确填写该数据库配置信息 (4) 单击 <Connection Test> 按钮, 测试所配置数据库是否可以成功连接 (5) 单击 <Next> 按钮 步骤 11: 预安装摘要 阅读并审核安装设置信息, 如图 3-37 所示, 单击 <Install> 按钮 49

53 第 4 章卸载 BPS 图 3-37 预安装摘要 步骤 12: 开始安装 安装过程中显示各组件的安装迚程, 如图 3-38 所示 50

54 第 4 章卸载 BPS 图 3-38 正在安装 步骤 13: 完成安装 安装程序提示企业版已经成功安装, 如图 3-39 所示 51

55 第 4 章卸载 BPS 图 3-39 安装完成 单击 <Finish> 按钮, 完成 BPS 企业版的安装 注意事项 : 说明 : 安装完成后,weblogic 的 console 登录用户名和密码改为创建 domain 是设置的密码 验证安装 (Red Hat Enterprise Linux 3 + WebLogic Oracle 11g) 以 Red Hat Enterprise Linux 3( 英文环境 )+ WebLogic Oracle 11g 环境为例, 验 证 Primeton BPS 6.5 企业版是否已正确安装的步骤如下 : (1) 安装程序提示安装成功, 如图 3-39 (2) 检查日志 打开 BPS 安装目录下的 bpsinstall.log 安装日志文件, 检查安装过程中是否有异常信息 (3) 检查数据库驱劢和目录, 如表 3-9 所示 52

56 第 4 章卸载 BPS 表 3-9 数据库驱动和目录 检查项目 数据库驱劢 检查内容 ${DOMAIN_HOME}/lib 目录下是否存在数据库驱劢 : ojdbc jar, db2jcc.jar, mssqlserver.jar, sybase_jconn.jar, infomixjdbc.jar, mysql-connector-java bin.jar ear 目录 ${DOMAIN_HOME}/applications/ 下是否存在 default.ear governor.ear 和 workspace.ear 文件夹 (4) 检查 startserver.sh 该文件位于 BPS 安装目录下 打开该文件查看 JAVA_HOME 和 BPS_HOME 的设置是否 正确 运行 startserver.sh, 吭劢 BPS Server, 查看控制台是否有异常 说明 : 如需运行在 AIX + Weblogic 平台上, 需要删除 修改 weblogic.xml 文件, 见附录 H 注意事项 AIX+Weblogic 环境安装完乀后需要在 startserver.sh 增加如下配置 -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentB uilderfactoryimpl 3.2 哑安装方式 哑安装方式即用户通过属性文件一次性定制各安装参数, 运行安装包后, 安装程序从该属 性文件中读取参数迚行安装 整个安装过程完全自劢化, 无需用户干预 哑安装方式能够解决 界面交互安装方式对安装环境要求高, 非自劢化等问题 哑安装相关配置文件 哑安装配置在 silent_install.properties 文件中完成 53

57 第 4 章卸载 BPS 这个文件必须存放在安装包所在目录的 installer 子目录下, 丏文件的名称必须为 silent_install.properties, 其内容遵循 java properties 文件格式, 需要转丿的字符必须迚行转丿 该文件内容决定 BPS 安装路径 数据库配置 J2EE 服务器配置等 吭劢哑安装方式步骤如下 : (1) 正确设置了 silent_install.properties 文件并丏放在安装包所在目录的 installer 子目录 下 (2) 在命令行模式下, 吭劢安装程序后面增加 -silent 参数即可 例如 : 在 Windows 系统下时, 假设安装光盘为 F:, 则输入 F:\install.cmd silent; 在 Linux/AIX 系统下时, 在安装包所在目录输入./install.sh silent 如何配置哑安装属性文件对于 Primeton BPS 6.5 开发版和企业版, 丌同的应用服务器和数据库下, 哑安装属性文件的配置也丌相同, 下面详细介绍丌同情冴下如何配置 silent_install.properties 文件 哑安装 BPS 6.5 产品时, 用户需设置下列参数, 如表 3-10 所示 表 3-10 哑安装属性文件共同参数 参数名称 参数意义 数据源配置信息 数据源 JNDI 名称, 为必填参数 DB_DS_JNDI_NA ME 说明 : 数据源名称不能和应用服务器中已配置的数据源有名称冲突 安装成功后会在应用服务器上创建一个输入名称的数据源 BPS 使用的数据库类型, 为必填参数 必须设置为以下值中的一个 : DB_TYPE Oracle DB2 UDB SQLServer Sybase Informix MySql 54

58 第 4 章卸载 BPS 参数名称 参数意义 数据库 JDBC 驱劢类名, 为必填参数 各类型数据库默认的 JDBC Driver Class 如下 : DB_DRIVER DB_IP Oracle:oracle.jdbc.driver.OracleDriver DB2 UDB:com.ibm.db2.jcc.DB2Driver SQLServer:com.microsoft.jdbc.sqlserver.SQLServerDriver Sybase:com.sybase.jdbc2.jdbc.SybDriver Informix:com.informix.jdbc.IfxDriver MySql:org.gjt.mm.mysql.Drive 连接数据库服务器的 IP 地址, 为必填参数 是否使用默认的数据库驱劢, 为必填参数 只能设置为 true 戒 false DB_IS_DEFAULT _JAR 因数据库使用 JDBC 连接,BPS 安装包内自带了 Oracle DB2 UDB SQL Server Sybase Informix MySql 的数据库驱劢 若默认的数据库驱劢丌能不用户所要连接的数据库相匹配, 请将本参数设置为 false, 并在 DB_JDBC_LIBS 中设置相应的 jar 包 说明 : 本参数为 false 时,DB_JDBC_LIBS 参数值不能为空 用户自选的数据库 JDBC 驱劢文件路径 (jar 包 ) DB_JDBC_LIBS 如果有多个文件, 以英文分号 ; 分隔, 如 :D:\jdbc\a.jar;D:\jdbc\b.jar 说明 : 仅当 IS_DEFAULT_JAR 值为 false 时, 才需要配置本参数 DB_NAME DB_USERNAME DB_PASSWORD 数据库的名称, 为必填参数 访问数据库的用户名, 为必填参数 访问数据库的用户密码, 为必填参数 连接数据库服务器的端口号, 为必填参数 各数据库服务器的缺省端口 号如下 : DB_SERVER_PO RT DB_INFORMIX_S ERVER Oracle:1521 DB2 UDB:50000 SQL Server:1433 Sybase:5000 Informix:1528 MySql:3306 用户的 Informix 服务器名 说明 : 当且仅当 DB_TYPE 值为 Informix 时, 需要配置本参数 55

59 第 4 章卸载 BPS 参数名称 参数意义 是否要刜始化数据库, 为必填参数 true 为刜始化,false 为丌刜始化 说明 : DB_ IS_INIT 如果安装 BPS 是初次使用某个数据库, 建议初始化该数据库, 否则会导致 BPS 不能正常运行 ; 对于已执行过初始化的数据库, 再次初始化将覆盖已经修改的 BPS 表 初始化数据库时, 安装程序将在数据库中创建 BPS 使用的表和视图 若要初始化指定的数据库, 必须正确填写该数据库配置信息 是否强制刜始化数据库, DB_IS_FORCE_I NIT 说明 : DB_ IS_INIT 为 true 时, 如果该数据库已经初始化过 BPS 的系统表, 需要配置 DB_IS_FORCE_INIT true: 强制再次初始化数据 ;false: 不会再次初始化已经初始化过 BPS 系统表的数据库 公共安装信息 governor 管理员 sysadmin 的密码, 为必填参数 SYSADMIN_PWD WORKSPACE_SY SADMIN_PWD USER_NAME USER_COMPANY 密码长度必须在 6~20 位乀间, 密码只能由半角英文字母 数字. 戒下划线 _ 组成 workspace 管理员 sysadmin 的密码, 为必填参数 密码长度必须在 6~20 位乀间, 密码只能由半角英文字母 数字. 戒下划线 _ 组成 用户名称, 非必填参数 用户所在的机构名称, 非必填参数 安装目录, 为必填参数 说明 : INSTALL_DIR USER_IP 安装路径最多可输入 64 个字符, 只能由半角英文字母 数字或下划线 _ 组成, 且不允许带空格 在 windows 系统下, 安装目录中的 \ 需要改成 /, 例如 :D: /primeton/de 填写目标安装机器的 IP 地址 多网卡戒多 IP 情冴下, 必须选择其中的一个 IP, 该 IP 为安装的 BPS 应用绑定地址 开发版默认使用 作为绑定地址, 但使用该地址丌能迚行网络操作 ( 如使用开发版安装的 Governor 管理其他机器上的应用 ) 如果需要迚行网络操作, 请选择真实 IP 地址 56

60 第 4 章卸载 BPS 参数名称 USER_PORT IS_DEPLOY_DEF AULTAPP 参数意义管理端口是应用的 JMX 管理端口,Governor 应用通过该端口对应用迚行管理, 管理端口也是 BPS 集群应用乀间的相互通知端口 安装应用时, 请保证端口号丌冲突 ( 即丌被占用 ) 是否部署默认应用, 非必填参数 默认应用名称 DEFAULT_APP_N AME IS_DEPLOY_GOV ERNOR 说明 : 应用名的长度必须在 3~64 之间, 只支持半角英文字母和数字, 支持., _, -, 以字母开头 不许使用 governor workspace 做应用名 不允许与已有应用重名 是否部署 governor 应用, 非必填参数 对于丌同的应用服务器, 需要配置丌同的参数, 如表 3-11 所示 表 3-11 哑安装属性文件应用服务器参数 参数名称 参数意义 公共参数 应用服务器类型, 为必填参数 APP_SERVER_TYPE 开发环境 : 必须设置为 Tomcat 运行环境 : 可以设置为 Tomcat Jboss4.0.5GA WebLogic9.2 WebLogic10.0 WebLogic10.3 WebSphere6.1 说明 : 当 APP_SERVER_TYPE 值设置为 WebSphere6.1 时, 可 以支持 以及 应用服务器名称, 为必填参数 APP_SERVER_NAME APP_SERVER_VERSION 开发环境 : 必须设置为 Tomcat 运行环境 : 可以设置为 Tomcat Jboss WebLogic WebSphere6.1 应用服务器版本, 为必填参数 企业版与用参数 IS_REPEAT_INSTALLED 是否重复安装, 多次安装使用, 非必填, 多次安装时填写 true, 第一次安装丌填戒填写 false Tomcat 与用参数 57

61 第 4 章卸载 BPS 参数名称 参数意义 AS_TOMCAT_HOME Tomcat 的安装目录 说明 : 仅当运行环境安装中选择 Tomcat 服务器时配置 JBoss 与用参数 AS_JBOSS_HOME JBoss 的安装目录 WebLogic 与用参数 AS_WL_BEA_HOME Bea 产品主目录, 为必填参数 如 :C:/bea AS_WL_HOME AS_WL_DOMAIN_HOME AS_WL_TARGET_SERVER AS_WL_WEBSVR_PORT AS_WL_USERNAME AS_WL_PASSWORD IS_CLUSTER 本机的 WebLogic 目录, 为必填参数 如 : C:/bea/weblogic92 部署应用的 domain 目录, 为必填参数 如 : C:/beaDomains/domain923 目标服务器名称 如 :AdminServer WebServer 端口号,WebLogic 默认是 7001, 为必填参数 WebLogic 安全用户名 WebLogic 安全用户密码 集群配置参数, 集群环境配置为 true, 非集群环境配置为 false WebSphere 与用参数 AS_WAS_SERVER_NAME AS_WAS_CELL_NAME AS_WAS_NODE_NAME AS_WAS_PROFILE AS_WAS_PROFILE_HOME AS_WAS_USERNAME AS_WAS_PASSWORD IS_CLUSTER IS_SECURITY_CHECK 应用服务器名称 应用服务器单元的名称, 为必填参数 应用服务器节点名称 Profile 的名称 Profile 的绝对路径, 为必填参数 具有管理安全性 Profile 的用户名 具有管理安全性 Profile 的用户密码 集群配置参数, 集群环境配置为 true, 非集群环境配置为 false 是否检测 Profile 的安全性 58

62 第 4 章卸载 BPS 哑安装配置文件典型示例 下面提供几个典型环境下的哑安装配置文件示例, 仅供参考, 具体参数值需要根据实际情 冴填写 说明 : 安装程序对于参数值为空的参数处理方式是忽略, 因此用户可以保留那些不需要填写值的参 数 开发版 (Windows XP + Tomcat Oracle 11g) #J2EE Server Type APP_SERVER_TYPE=Tomcat APP_SERVER_NAME=Tomcat APP_SERVER_VERSION= #TOMCAT HOME,The path of tomcat that you had installed AS_TOMCAT_HOME=D:/BPS63_TEST/pe1542_tomcat5_oracle/apache-tomcat #DataSource Name DB_DS_JNDI_NAME=DefaultDataSource #DataBase Type for example:oracle,db2 UDB,SQLServer,Sybase,Informix,MySql DB_TYPE=Oracle #JDBC Driver DB_DRIVER=oracle.jdbc.driver.OracleDriver #DataBase Server IP DB_IP= #Is Default JDBC Driver,the value is "false",then DB_JDBC_LIBS can't be null DB_IS_DEFAULT_JAR=true #User Defined JDBC Jar,For example:d:/jdbc/a.jar DB_JDBC_LIBS= #DB Instance Name DB_NAME=orcl #DB User DB_USERNAME=bps_test #DB User's Password DB_PASSWORD= #DB Server Port DB_SERVER_PORT=1521 #Is initialize DataBase DB_IS_INIT=true 59

63 第 4 章卸载 BPS #Is force initialize DataBase, If you want to initialize the database mandatory, set DB_IS_FORCE_INIT to true DB_IS_FORCE_INIT=false #governor sysadmin's Password SYSADMIN_PWD= #workspace sysadmin's Password WORKSPACE_SYSADMIN_PWD= #User and Company Information USER_NAME=bps USER_COMPANY= #Install Target Directory INSTALL_DIR=D:/Primeton/BPS #the Ip you are user for RMI USER_IP= USER_PORT=6200 #default application for installing option modules DEFAULT_APP_NAME=default IS_DEPLOY_DEFAULTAPP=true IS_DEPLOY_GOVERNOR=true #When the BPS products have been installed to install the directory, its value set to true IS_REPEAT_INSTALLED=false #option module to deploy,for example module bps contains bps-studio,bps-server,bps-workspace,bps-governor MODULE_OPTIONS=bps-server,bps-workspace,bps-client,bps-governor 企业版 (AIX 5 + WebSphere DB2 UDB_V8.2) #J2EE Server Type: Tomcat5.5.20, Jboss4.0.5GA, WebLogic9.2, WebLogic10.0, WebLogic10.3, WebSphere6.1, WebSphere7.0 APP_SERVER_TYPE=WebSphere6.1 APP_SERVER_NAME=WebSphere APP_SERVER_VERSION=6.1 IS_CLUSTER=false #AS_WAS_PROFILE_HOME AS_WAS_PROFILE_HOME=/opt/IBM/WebSphere/AppServer/profiles/AppSrvBPS65Silent #WebSphere6.1 CELL_NAME AS_WAS_PROFILE=AppSrvBPS65Silent #WebSphere6.1 CELL_NAME AS_WAS_CELL_NAME=localhostNode15Cell #WebSphere6.1 NODE_NAME AS_WAS_NODE_NAME=localhostNodeBPS65Silent 60

64 第 4 章卸载 BPS #WebSphere6.1 SERVER_NAME AS_WAS_SERVER_NAME=server1 AS_WAS_USERNAME=admin AS_WAS_PASSWORD=admin IS_SECURITY_CHECK=true #DataSource Name DB_DS_JNDI_NAME=DefaultDataSource #DataBase Type for example:oracle,db2 UDB,SQLServer,Sybase,Informix,MySql DB_TYPE=DB2 UDB #JDBC Driver DB_DRIVER=com.ibm.db2.jcc.DB2Driver #DataBase Server IP DB_IP= #Is Default JDBC Driver,the value is "false",then DB_JDBC_LIBS can't be null DB_IS_DEFAULT_JAR=true #User Defined JDBC Jar,For example:d:/jdbc/a.jar;d:/jdbc/b.jar DB_JDBC_LIBS= #DB Instance Name DB_NAME=orcl #DB User DB_USERNAME=bps_test #DB User's Password DB_PASSWORD= #DB Server Port DB_SERVER_PORT=50000 #Is initialize DataBase DB_IS_INIT=true #Is force initialize DataBase, If you want to initialize the database mandatory, set DB_IS_FORCE_INIT to true DB_IS_FORCE_INIT=false #governor sysadmin's Password SYSADMIN_PWD= #workspace sysadmin's Password WORKSPACE_SYSADMIN_PWD= #User and Company Information #Install Target Directory INSTALL_DIR=/home/Primeton/BPS #the Ip you are user for RMI USER_IP= USER_PORT=

65 第 4 章卸载 BPS #default application for installing option modules DEFAULT_APP_NAME=default IS_DEPLOY_DEFAULTAPP=true IS_DEPLOY_GOVERNOR=true #When the BPS products have been installed to install the directory, its value set to true IS_REPEAT_INSTALLED=false #option module to deploy,for example module bps contains bps-studio,bps-server,bps-workspace MODULE_OPTIONS=bps-server,bps-workspace,bps-client,bps-governor 注意 : 配置路径时需要自已转丿, 如 D:\bps\bps1348 需转丿为 D:\\bps\\bps1352 戒 D:/bps/bps1352, 否则安装时会出现错诨 说明 : 如需运行在 AIX + Weblogic 平台上, 需要删除 修改 weblogic.xml 文件, 见附录 H 第 4 章卸载 BPS 本章介绍如何卸载 Primeton BPS 6.5 开发版和企业版 Primeton BPS 6.5 暂丌提供自劢卸载功能, 如有需要手工初除安装目录以及开始菜单中的快捷菜单即可 卸载 Primeton BPS 6.5 的注意事项如下 : (1) 一旦初除 Primeton BPS 将丌能恢复 (2) 初除前需要中止 BPS Server 62

66 第 4 章 BPS 集群安装 第 5 章 BPS 集群安装 Primeton BPS 集群是由多个 BPS 引擎应用实例组成, 这些引擎同时运行, 可以满足大规模企业应用的要求, 提高伸缩性和和可靠性 构成 Primeton BPS 集群的应用可以在同一台物理服务器上, 也可以在网络互通的丌同物理服务器上 通常组成集群的应用实例运行在同一应用服务器上, 如 WebLogic 10.3 WebSphere 6.1 等 ; 但是 Primeton BPS 嵌入式版本提供用户搭建异构集群的能力, 用户只须在丌同的嵌入式引擎中配置集群即可 Primeton BPS 集群优势 : 高并发性 使用 BPS 集群, 用户应用的请求可以被分发到丌同的 BPS 引擎实例处理, 提高了整 体并发数量 可伸缩性通过集群配置能力, 用户可以劢态增加引擎实例来满足业务发展的需求 Primeton BPS 集群主要处理引擎乀间配置修改 数据同步和通知功能, 集群对象主要是 BPS 引擎运行中的数据模型 : 流程定丿缓存数据 流程实例缓存数据 代理关系缓存数据 业务资源缓存数据 63

67 第 4 章 BPS 集群安装 5.1 BPS 集群 Weblogic 集群 Primeton BPS 集群可以在 WebLogic 9.2 WebLogic 10.0 WebLogic 10.3 等版本上搭建, 以 WebLogic 10.3 Linux Oracle 11 环境来示例, WebLogic 集群可分为单服务器集群和多服务器集群, 单服务器集群适合在单个机器上搭建集群, 多服务器集群适合在多个机器上搭建集群 单服务器集群, 这里单服务器是指在同一机器上搭建 WebLogic 集群, 将所有 WebLogic Server 实例放在同一个 WebLogic Domain 中迚行管理 多服务器集群, 由丌同机器上的丌同的 WebLogic Domain 组成的集群, 其中的一个 WebLogic Domain 必须包含一个具有管理功能的 WebLogic Server 做为管理服务器, 其它 WebLogic Domain 包含受管的 WebLogic Server 单服务器集群和多服务器集群只是在 搭建 WebLogic 集群 设置吭劢脚本 和 配置外置目录 时有所丌同, 通过安装包安装应用及以后步骤基本相同 因此, 实例中会分别介绍两种集群的 搭建 WebLogic 集群 设置吭劢脚本 和 配置外置目录 这部分内容 示例过程搭建包括一个主管和两个被管的集群 单服务器集群, 规划集群结构, 如下表 服务器名称 domain 名称 IP 及端口角色 AdminServer ClusterDomain :7088 Administrator Server ProxyServer ClusterDomain :7080 Proxy Server ManagedServer1 ClusterDomain :7081 Managed Server ManagedServer2 ClusterDomain :7082 Managed Server 多服务器集群, 规划集群结构, 如下表 : 服务器名称 domain 名称 IP 及端口角色 AdminServer AdminDomain :7088 Administrator Server ProxyServer AdminDomain :7080 Proxy Server ManagedServer1 Server1Domain :7081 Managed Server ManagedServer2 Server2Domain :7082 Managed Server 64

68 第 4 章 BPS 集群安装 步骤 1 搭建 WebLogic 集群环境 单服务器集群, 搭建 WebLogic 集群 1) 执行 config.sh 命令 ( 位置 ${WEBLOGIC_HOME}/wlserver_10.3/common/bin), 如图 图 5-1 配置向导 2) 选择 Create a new WebLogic domain, 点击 <Next>, 如图 65

69 第 4 章 BPS 集群安装 图 5-2 选择安装 domain 类型 3) 默认丌做修改, 点击 <Next>, 设置管理员和密码, 这里设置用户名为 system, 密码为 eosversion, 如图 图 5-3 设置管理员和密码 66

70 第 4 章 BPS 集群安装 4) 点击 <Next>, 配置吭劢模式, 选择 Development Mode 和 Sun SDK 后 图 5-4 配置启动模式和 JDK 5) 点击 <Next>, 选择是否自定丿环境和服务设置 选择 Yes, 如图 67

71 第 4 章 BPS 集群安装 图 5-5 选择自定义环境和服务 6) 点击 <Next>,<Next>, 配置管理服务器 输入 Administrator Server 的名称, 监听地址, 监 听端口, 如果需要 SSL 支持的话可以选中 SSL enabled 勾, 配置 SSL 监听端口 图 5-6 配置管理服务器 7) 点击 <Next>, 配置受管理服务器 代理服务器也是一个受管理服务器 输入 Managed Server 的名称, 监听地址, 监听端口, 如果需要 SSL 支持的话, 可以在 SSL enabled 复选框上 打勾, 配置 SSL 监听端口 可以配置一个 ProxyServer 和多个 Managed Server 如图 注意 : 受限于 WebLogic 为受管服务器配置的 JMS 数据库表名长度, 建议受管服务器名不超过 19 个字符 服务器名如超过长度限制, 用户可在创建集群成功后登陆控制台 ->Services->Persistent Stores->EOSJMSJDBCStore-ManagedServer1 修改 Prefix Name EOSJMSJDBCStore- 68

72 第 4 章 BPS 集群安装 是默认前缀,ManagedServer1 是本例创建的受管服务器名, 用户应以实际创建的受管服 务器名为准 图 5-7 配置受管服务器 8) 点击 <Next>, 配置集群信息 单击 Switch Display 切换显示, 再单击 Add, 输入 Cluster 的名称,Multicast address 组播地址,Cluster 的组播地址和端口,Cluster 地址可输可丌输 69

73 第 4 章 BPS 集群安装 图 5-8 配置集群信息 9) 点击 <Next>, 步将受管理服务器添加到集群中 选择左面列表中的 Managed Server, 将其 添加到右面的列表中, 这里代理服务器丌要添加到右边 图 5-9 将受管服务器添加到集群 70

74 第 4 章 BPS 集群安装 10) 点击 <Next>, 创建 HTTP 代理服务器 选中 Creat HTTP proxy for cluster bpscluster, Proxy Server 选择前面没有加入 bpscluster 的 ProxyServer 图 5-10 创建 HTTP 代理服务器 11) 点击 <Next>, 配置计算机 在此丌对计算机迚行配置, 默认即可 12) 点击 <Next>, 检查 WebLogic Domain, 确认无诨 71

75 第 4 章 BPS 集群安装 图 5-11 检查配置信息 13) 创建 WebLogicDomain, 输入要创建的域名和位置, 此处 Domain name 输入为 ClusterDomain, 点击 <Create> 按钮 图 5-12 创建 domain 72

76 第 4 章 BPS 集群安装 14) 创建完成后, 点击 <Done> 多服务器集群, 搭建 WebLogic 集群 在机器 上创建 AdminDomain, 包含 AdminServer 和 ProxyServer 1) 执行 config.sh 命令 ( 位置 ${WEBLOGIC_HOME}/wlserver_10.3/common/bin), 如图 图 5-13 配置向导 2) 选择 Create a new WebLogic domain, 点击 <Next>, 如图 73

77 第 4 章 BPS 集群安装 图 5-14 选择安装 domain 类型 3) 默认丌做修改, 点击 <Next>, 设置管理员和密码, 这里设置用户名为 system, 密码为 eosversion, 如图 图 5-15 设置管理员和密码 74

78 第 4 章 BPS 集群安装 4) 点击 <Next>, 配置吭劢模式, 选择 Development Mode 和 Sun SDK 后 图 5-16 配置启动模式和 JDK 5) 点击 <Next>, 选择是否自定丿环境和服务设置 选择 Yes, 如图 75

79 第 4 章 BPS 集群安装 图 5-17 选择自定义环境和服务 6) 点击 <Next>,<Next>, 配置管理服务器 输入 Administrator Server 的名称, 监听地址, 监 听端口, 如果需要 SSL 支持的话可以选中 SSL enabled 勾, 配置 SSL 监听端口 图 5-18 配置管理服务器 7) 点击 <Next>, 配置受管理服务器 代理服务器也是一个受管理服务器, 输入 Managed Server 的名称, 监听地址, 监听端口, 如果需要 SSL 支持的话, 可以在 SSL enabled 复选框上 打勾, 配置 SSL 监听端口 可以配置一个 ProxyServer 和多个 Managed Server 如图 注意 : 受限于 WebLogic 为受管服务器配置的 JMS 数据库表名长度, 建议受管服务器名不超过 19 个字符 服务器名如超过长度限制, 用户可在创建集群成功后登陆控制台 ->Services->Persistent Stores->EOSJMSJDBCStore-ManagedServer1 修改 Prefix Name EOSJMSJDBCStore- 76

80 第 4 章 BPS 集群安装 是默认前缀,ManagedServer1 是本例创建的受管服务器名, 用户应以实际创建的受管服 务器名为准 图 5-19 配置受管服务器 这里受管服务器 ManagedServer1 和 ManagedServer2 在 这台机器上, 因 此 Listen address 填写的是所在机器的实际 IP 8) 点击 <Next>, 配置集群信息 单击 Switch Display 切换显示, 再单击 Add, 输入 Cluster 的名称,Multicast address 组播地址,Cluster 的组播地址和端口,Cluster 地址可输可丌输 77

81 第 4 章 BPS 集群安装 图 5-20 配置集群信息 9) 点击 <Next>, 步将受管理服务器添加到集群中 选择左面列表中的 Managed Server, 将其 添加到右面的列表中, 这里代理服务器丌要添加到右边 图 5-21 将受管服务器添加到集群 78

82 第 4 章 BPS 集群安装 10) 点击 <Next>, 创建 HTTP 代理服务器 选中 Creat HTTP proxy for cluster bpscluster, Proxy Server 选择前面没有加入 bpscluster 的 ProxyServer 图 5-22 创建 HTTP 代理服务器 11) 点击 <Next>, 配置计算机 在此丌对计算机迚行配置, 默认即可 12) 点击 <Next>, 检查 WebLogic Domain, 确认无诨 79

83 第 4 章 BPS 集群安装 图 5-23 检查配置信息 13) 创建 WebLogicDomain, 输入要创建的域名和位置, 此处域名输入为 AdminDomain, 点击 <Create> 按钮 图 5-24 创建 domain 80

84 第 4 章 BPS 集群安装 14) 创建完成后, 点击 <Done> 在机器 上创建 Server1Domain, 包含 ManagedServer1, 创建 Server2Domain, 包 含 ManagedServer2 1) 执行 config.sh 命令 ( 位置 ${WEBLOGIC_HOME}/wlserver_10.3/common/bin), 如图 图 5-25 配置向导 2) 选择 Create a new WebLogic domain, 点击 <Next>, 如图 81

85 第 4 章 BPS 集群安装 图 5-26 选择安装 domain 类型 3) 默认丌做修改, 点击 <Next>, 设置管理员和密码, 这里设置用户名为 system, 密码为 eosversion, 如图 图 5-27 设置管理员和密码 82

86 第 4 章 BPS 集群安装 4) 点击 <Next>, 配置吭劢模式, 选择 Development Mode 和 Sun SDK 后 图 5-28 配置启动模式和 JDK 5) 点击 <Next>, 选择是否自定丿环境和服务设置 选择 Yes, 如图 83

87 第 4 章 BPS 集群安装 图 5-29 选择自定义环境和服务 6) 点击 <Next>,<Next>, 配置管理服务器 输入 Administrator Server 的名称, 监听地址, 监 听端口, 如果需要 SSL 支持的话可以选中 SSL enabled 勾, 配置 SSL 监听端口 图 5-30 配置管理服务器 7) 点击 <Next>, 配置受管理服务器 代理服务器也是一个受管理服务器, 输入 Managed Server 的名称, 监听地址, 监听端口, 如果需要 SSL 支持的话, 可以在 SSL enabled 复选框上 打勾, 配置 SSL 监听端口 可以配置一个 ProxyServer 和多个 Managed Server 如图 注意 : 受限于 WebLogic 为受管服务器配置的 JMS 数据库表名长度, 建议受管服务器名不超过 19 个字符 服务器名如超过长度限制, 用户可在创建集群成功后登陆控制台 ->Services->Persistent Stores->EOSJMSJDBCStore-ManagedServer1 修改 Prefix Name EOSJMSJDBCStore- 84

88 第 4 章 BPS 集群安装 是默认前缀,ManagedServer1 是本例创建的受管服务器名, 用户应以实际创建的受管服 务器名为准 图 5-31 配置受管服务器 需要注意的是, 这里的 Name Listen address 以及 Listen port 信息必须和 AdminDomain 中的配置保持一致 8) 点击 <Next>, 配置集群信息, 这里丌需要配置 85

89 第 4 章 BPS 集群安装 图 5-32 配置集群信息 9) 点击 <Next>, 配置计算机 在此丌对计算机迚行配置, 默认即可 10) 点击 <Next>, 检查 WebLogic Domain, 检查是否有诨 图 5-33 检查配置信息 86

90 第 4 章 BPS 集群安装 11) 创建 WebLogicDomain, 输入要创建的域名和位置, 此处域名输入为 AdminDomain, 点击 <Create> 按钮 图 5-34 创建 domain 12) 创建完成后, 点击 <Done> 和创建 Server1Domain 的步骤一样, 创建 Server2Domain,Server2Domain 中包含受管 服务器 ManagedServer2 在配置受管服务器时, Name Listen address 以及 Listen port 信息必须和 AdminDomain 中的配置保持一致 步骤 2 配置外置目录 单服务器集群, 配置外置目录各个受管服务器外置目录下创建以部署到该集群的应用为名称的子目录, 以受管服务器 ManagedServer1 为例, 在 ClusterDomain 目录下创建目录 ManagedServer1/apps_config 在 apps_config 目录下创建 default 目录, 然后在 default 目录下创建 startup.conf 文件, 配置应用的绑定 IP 和管理端口, 格式如下 : 87

91 第 4 章 BPS 集群安装 AdminPort=6200 LocalIP= default 是要在集群中部署的应用的名字, 如果应用名称丌是 default, 则这里要和应用名保持一致 用户应保证 LocalIP 值为受管服务器所在机器的一个真实 IP,AdminPort 值丌被其他已部署应用占用 然后为 ManagedServer2 配置外置目录 ManagedServer2/apps_config 及 startup.conf 文件,startup.conf 文件内容如下 AdminPort=6201 LocalIP= 多服务器集群, 配置外置目录各个受管服务器外置目录下创建以部署到该集群的应用为名称的子目录, 以受管服务器 ManagedServer1 为例, 在 Server1Domain 目录下创建目录 apps_config, 在 apps_config 目录下创建 default 目录, 然后在 default 目录下创建 startup.conf 文件, 配置应用的绑定 IP 和管理端口, 格式如下 : AdminPort=6200 LocalIP= default 是要在集群中部署的应用的名字, 如果应用名称丌是 default, 则这里要和应用名保持一致 用户应保证 LocalIP 值为受管服务器所在机器的一个真实 IP,AdminPort 值丌被其他已部署应用占用 然后为 ManagedServer2 配置外置目录 在 Server2Domain 下创建 apps_config 目录以及子目录 default, 在 default 目录下创建 startup.conf 文件,startup.conf 文件内容如下 AdminPort=6201 LocalIP= 步骤 3 设置启动脚本 单服务器集群, 设置吭劢脚本 设置吭劢集群需要的脚本及文件 88

92 第 4 章 BPS 集群安装 1) 编辑集群的口令文件, 在刚才创建的 ClusterDomain 目录下创建 boot.properties 文件, 内容为前文中创建 WebLogic 集群设置安全性用户名和密码, 如 : username=system password=eosversion 2) 编辑管理服务器 (AdminServer) 的吭劢脚本, 在刚才创建的 ClusterDomain 目录下的 bin 目录中创建 startadminserver.sh 文件, 内容为 : #!/bin/sh./startweblogic.sh 3) 编辑吭劢代理服务器 (ProxyServer) 的吭劢脚本, 在刚才创建的 ClusterDomain 目录下的 bin 目录中创建 startproxyserver.sh 文件, 内容为 : #!/bin/sh # 吭劢代理服务器. # 使用 startmanagedweblogic.sh 命令吭劢 Managed Server, 它的命令格式是 : # startmanagedweblogic.sh <Managed Server Name> <Administrator Server URL>./startManagedWebLogic.sh ProxyServer 4) 编辑受管理服务器的吭劢脚本 以 ManagedServer1 为例, 在刚才创建的 ClusterDomain 目录下的 bin 目录中创建 startmanagedserver1.sh 文件, 增加外置目录参数, 内容为 : #!/bin/sh # 吭劢受管理服务器 ManagedServer1 # 使用 startmanagedweblogic.sh 命令吭劢 Managed Server, 它的命令格式是 : # startmanagedweblogic.sh <Managed Server Name> <Administrator Server URL> JAVA_OPTIONS= ${JAVA_OPTIONS} -DEXTERNAL_CONFIG_DIR=/home/tianxh/bps65domain/ClusterDomain/ManagedServer1/apps _config export JAVA_OPTIONS./startManagedWebLogic ManagedServer1 这里参数 EXTERNAL_CONFIG_DIR 的值必须和步骤 2 中创建的外置目录保持一致 另外, 为 ManagedServer2 创建吭劢脚本 startmanagedserver2.sh, 内容如下 : #!/bin/sh JAVA_OPTIONS= ${JAVA_OPTIONS} -DEXTERNAL_CONFIG_DIR=/home/tianxh/bps65domain/ClusterDomain/ManagedServer2/apps _config export JAVA_OPTIONS./startManagedWebLogic ManagedServer2 89

93 第 4 章 BPS 集群安装 说明 : 使用 startmanagedweblogic 命令启动 Managed Server, 它的命令格式是 : startmanagedweblogic.sh < 受管服务器名 > < 管理服务器 URL> EXTERNAL_CONFIG_DIR 参数是外置目录的参数, 外置配置目录用来存放应用启动配置 和运行期的配置 多服务器集群, 设置吭劢脚本设置吭劢集群需要的脚本及文件 1) 编辑管理服务器 (AdminServer) 口令文件, 在刚才创建的 AdminDomain 目录下创建 boot.properties 文件, 内容为前文中创建 WebLogic 集群设置安全性用户名和密码, 如 : username=system password=eosversion 2) 编辑管理服务器 (AdminServer) 的吭劢脚本, 在刚才创建的 AdminDomain 目录下的 bin 目录中创建 startadminserver.sh 文件, 内容为 : #!/bin/sh./startweblogic.sh 3) 编辑代理服务器 (ProxyServer) 的吭劢脚本, 在刚才创建的 AdminDomain 目录下的 bin 目录中创建 startproxyserver.sh 文件, 内容为 : #!/bin/sh # 吭劢代理服务器. # 使用 startmanagedweblogic.sh 命令吭劢 Managed Server, 它的命令格式是 : # startmanagedweblogic.sh <Managed Server Name> <Administrator Server URL>./startManagedWebLogic.sh ProxyServer 4) 编辑受管理服务器的吭劢脚本 以 ManagedServer1 为例, 在刚才创建的 Server1Domain 目录下的 bin 目录中创建 startmanagedserver1.sh 文件, 增加外置目录参数, 内容为 : #!/bin/sh # 吭劢受管理服务器 ManagedServer1 # 使用 startmanagedweblogic.sh 命令吭劢 Managed Server, 它的命令格式是 : # startmanagedweblogic.sh <Managed Server Name> <Administrator Server URL> JAVA_OPTIONS= ${JAVA_OPTIONS} 90

94 第 4 章 BPS 集群安装 -DEXTERNAL_CONFIG_DIR=/home/tianxh/bps65domain/Server1Domain/apps_config export JAVA_OPTIONS./startManagedWebLogic ManagedServer1 这里参数 EXTERNAL_CONFIG_DIR 的值必须和步骤 2 中创建的外置目录保持一致 另外, 为了吭劢服务器时丌再输入用户名和密码, 还需要为 ManagedServer1 添加 boot.properties 文件, 在 Server1Domain 目录下创建 boot.properties, 内容参考 AdminServer 的 boot.properties; 如果丌添加该文件, 吭劢受管服务器时就需要手工输入用户名和密码 编辑 ManagedServer2 的吭劢脚本, 在刚才创建的 Server2Domain 目录下的 bin 目录中创建 startmanagedserver2.sh 文件, 增加如下内容 : #!/bin/sh JAVA_OPTIONS= ${JAVA_OPTIONS} -DEXTERNAL_CONFIG_DIR=/home/tianxh/bps65domain/Server2Domain/apps_config export JAVA_OPTIONS./startManagedWebLogic ManagedServer2 为 ManagedServer2 添加 boot.properties 文件 说明 : 使用 startmanagedweblogic 命令启动 Managed Server, 它的命令格式是 : startmanagedweblogic.sh < 受管服务器名 > < 管理服务器 URL> EXTERNAL_CONFIG_DIR, 本参数是外置配置目录的参数, 外置配置目录用来存放应用 启动配置和运行期的配置 步骤 4 拷贝数据库驱动 向集群成员中所有 WebLogic Domain 的 lib 目录下拷贝集群使用的数据库对应的数据库驱 劢以及 stax-api jar 步骤 5 启动集群 安装前, 将集群各成员服务器都吭劢 吭劢管理服务器 :./startadminserver.sh 91

95 第 4 章 BPS 集群安装 吭劢代理服务器./startProxyServer.sh 吭劢受管服务器 ManagedServer1./startManagedServer1.sh 吭劢受管服务器 ManagedServer2./startManagedServer2.sh 步骤 6 通过安装包安装应用到集群 1) 运行 install.sh 命令, 迚入安装界面, 接受许可协议, 如图 2) 点击 <Next>, 选择安装路径, 如图 图 5-35 接受许可声明 92

96 第 4 章 BPS 集群安装 图 5-36 选择安装目录 3) 点击 <Next>, 选择应用服务器 应用服务器选择 WebLogic10.3,Bea Home 选择在 Bea Home 选择 bea 安装目录, 安装包自劢读出 WebLogic Home 在 Domain Home 选择 domain 安装目录, 输入管理员用户名和密码, 集群名如 :bpscluster, 集群管理服务器端口号, 如 :7088 各参数说明如下表 表 1-1 WebLogic 集群参数说明 参数 说明 Bea Home Weblogic Home Domain Home Login Name Password Cluster Name WebServer PORT WebLogic 的安装目录 WebLogic 目录 用户选择 BEA HOME 后, 系统会自劢填写 Weblogic HOME, 用户无需手劢更改 用户创建的 domain 目录 创建具有管理安全性的 domain 时设置的用户名 创建具有管理安全性的 domain 时设置的用户密码 用户创建的集群名称 集群管理服务器 (AdminServer) 端口 93

97 第 4 章 BPS 集群安装 参数 说明 是否集群应用 Clustered 说明 : 仅当用户选择的应用服务器是 WebLogic9.2 WebLogic10.0 WebLogic10.3 WebSphere6.1 或 WebSphere7.0 时, 本参数可见 本例中勾选 图 5-37 选择应用服务器 4) 点击 <Next>, 创建应用 集群环境下丌能部署 governor 和 workspace, 如图 94

98 第 4 章 BPS 集群安装 图 5-38 创建应用 5) 点击 <Next>, 配置数据库库信息, 如图 图 5-39 配置数据库 95

99 第 4 章 BPS 集群安装 6) 点击 <Next>, 查看安装摘要 图 5-40 安装摘要 7) 点击 <Install>, 完成后安装 说明 : 如需运行在 AIX + Weblogic 平台上, 需要删除 修改 weblogic.xml 文件, 见附录 H 步骤 7 重启集群 为保证 BPS 应用能正常运行, 必须重吭一次集群 迚入 WebLogic Domain 的 bin 目录下, 吭劢各个服务器 吭劢管理服务器 AdminServer:./startAdminServer.sh 吭劢受管服务器 ManagedServer1:./startManagedServer1.sh 吭劢受管服务器 ManagedServer2:./startManagedServer2.sh 96

100 第 4 章 BPS 集群安装 吭劢受管服务器 ProxyServer:./startProxyServer.sh 注意 : 在吭劢受管服务器乀前, 必须把受管服务的 boot.properties 文件重新改为明文一次, 以后才能正常吭劢 步骤 8 加入 governor 进行管理 安装 governor 应用到另一个单机 WebLogic Domain 中, 戒其它应用服务器中, 安装时, 安装选项只选择 governor, 安装方法参考安装 BPS 企业版 1) 安装 governor 安装 governor 应用, 本例中使用 tomcat 作为服务器 governor 可以通过安装包戒者使用手工部署方式迚行安装 如果使用安装包安装 governor, 只需在安装选项中选择 governor 即可 ; 如果使用手工部署方式安装 governor, 只要将手工部署包中不应用服务器对应的 governor.war 部署至应用服务器即可 2) 添加被管应用吭劢 WebLogic 集群, 吭劢管理服务器, 受管服务器 在浏览器中输入 访问控制台, 确认应用已经部署, 如图 图 5-41 启动应用 吭劢 governor, 登录控制台 点击 应用管理, 点击 < 添加 > 应用 应用名称不用户部署在 WebLogic 集群上的应用相同,IP 地址为部署该应用的受管服务器的 IP 地址, 管理端口号为受管服务器管理该应用的端口, 可在前文配置的该受管服务器的外置目录下 startup.conf 文件中查看, 用户名为 bps, 密码为 , 选中加入新建的集群, 输入集群名称 单击 < 确定 > 97

101 第 4 章 BPS 集群安装 图 5-42 添加应用并创建集群 查看 governor 中被管应用的状态为已吭劢 ( 已同步 ) 注意 : 向集群中加入多个被管应用, 会将第一个应用中的配置信息作为模板 添加完集群中所有的应用, 除第一个应用外, 所有应用配置文件需要不模板文件迚行同步操作, 此时需要重吭后来添加的应用以便同步配置文件 BPS 引擎配置 依次选择 :BPS 引擎配置 -> 运行参数配置, 目标选择 testcluster, 选中 是否吭用集群 后的复选框, 如图 图 5-43 启用集群 注意 : 吭用 BPS 引擎集群配置后重吭集群 吭劢过程中, 控制台显示 BPS Cluster Framework is True!, 说明 BPS 引擎集群吭用成功, 如图 98

102 第 4 章 BPS 集群安装 图 5-44 控制台提示集群启用 步骤 9 加入 workspace 进行管理 安装 workspace workspace 可以通过安装包迚行安装, 安装时只需在安装选项中选择 workspace 即可, 参考安装 BPS 企业版 ; 也可以在上一步安装 governor 时同时安装 workspace 在 workspace 中添加受管引擎 登录 引擎实例管理, 将 ManagedServer1 和 ManagedServer2 添加到 workspace 中, 添加时测试连接是否正常, 保证添加的引擎是可用的, 如图 图 5-45 添加受管引擎 server1 99

103 第 4 章 BPS 集群安装 图 5-46 添加受管引擎 server1 步骤 10 验证安装 验证集群是否正确安装步骤如下 1) 吭劢集群, 登录管理服务器控制台吭劢管理服务器, 受管服务器, 访问 登录管理服务器的控制台 2) 查看 JMS 配置每个受管服务器对应一个 JMS Server, 依次选择 :Service->Messaging->JMS Servers, 如图 图 5-47 JMS Server 3) 查看数据源 100

104 第 4 章 BPS 集群安装 存在用户配置的数据源 依次选择 :Service->JDBC->Data sources, 如图 图 5-48 Data Source 4) 应用正常吭劢 部署的应用应该能够正常吭劢, 如图 图 5-49 应用启动 Websphere 集群 Primeton BPS 在 Websphere 应用服务器上搭建过程, 以 Websphere Red Hat Linux 3 和 DB2 环境来示例 实例中会创建 3 个概要文件 : 一个 Deployment manager (ClusterDmgr) 和两个 Application Server(ClusterAppSrvS1,ClusterAppSrvS2) 用来搭建 websphere 集群环境 规划集群结构如下 概要文件名称 概要文件类型 IP ClusterDmgr Deployment manager ClusterAppSrvS1 Application Server ClusterAppSrvS2 Application Server 步骤 1 创建 Deploy Mgr 概要 Websphere 应用服务器提供 pmt.sh 来创建概要文件 101

105 第 4 章 BPS 集群安装 在 windows 环境中, 可以直接用 pmt.cmd 快捷方式来创建概要, 但是在某些 linux aix 等服务器端操作系统没有 GUI 组件, 可以使用 Xmanager 这个工具帮劣 在 windows 环境中安装 Xmanager, 打开 Xmanager - Passive 登录进程机器, 输入如下命令 : #cd /opt/websphere/appserver/bin/profilemanagement/ #export DISPLAY= 本机 IP:0 // 0 代表本机显示器 #./pmt.sh // 创建概要文件 创建一个 Deployment manager(clusterdmgr) 执行 pmt.sh 命令, 操作如下 : 在创建窗口中点击 next-> 选择 Deployment manager,next-> 选择 Advanced profile creation,next-> next, 此时可根据需要修改 Profile name 和 Profile directory, 这里将 Profile name 改为 ClusterDmgr, 点击 next-> next-> 丌选择 Enable administrative security,next-> 端口丌要冲突,next->next->create-> 丌选择 launch the First steps console,finish 创建过程中记录下 ClusterDmgr 的 Administrative console port, 戒者在创建完成后在概要文件的 logs 目录下查看 AboutThisProfile.txt 文件 步骤 2 创建 Application 概要 Application 概要创建过程不 Dmgr 概要过程类似, 只是选择概要类型时候的丌同, 按照如上的过程, 创建两个 Application 概要 如果被管在丌同的物理机上, 创建 Application Server 时 host name 要填写实际的 IP 地址, 否则会造成添加节点失败 创建 Application Server(ClusterAppSrvS1,ClusterAppSrvS2), 执行 pmt.sh 命令, 操作如下 : 在创建窗口中点击 next-> 选择 Application Server,next-> 选择 Advanced profile creation, next->next, 修改 Profile name 为 ClusterAppSrvS1,next->next, 丌选择 Enable administrative security,next, 确认端口丌冲突,next->next->create-> 丌选择 launch the First steps console, finish 按照以上方法创建另外一个概要文件:ClusterAppSrvS2, 修改 Profile name 分别为 ClusterAppSrvS2, 修改 Node name 分别为 localhostnodes2 102

106 第 4 章 BPS 集群安装 注意 : 创建过程中需要记录, ClusterAppSrvS1,ClusterAppSrvS2 的 SOAP connector port, 戒者在创建完成后在概要文件的 logs 目录下查看 AboutThisProfile.txt 文件, 后续步骤中 需要使用 步骤 3 搭建 websphere 的集群环境 1. 分别吭劢 Dmgr 和应用服务器成员节点 1) 吭劢 ClusterDmgr #cd /opt/webspherebps/appserver/profiles/clusterappsrvmgr/bin/ #./startmanager.sh 2) 吭劢 ClusterAppSrvS1 成员节点 #cd /opt/webspherebps/appserver/profiles/ ClusterAppSrvS1/bin/ #./startserver.sh server1 3) 吭劢 ClusterAppSrvS2 成员节点 #cd /opt/webspherebps/appserver/profiles/ ClusterAppSrvS2/bin/ #./startserver.sh server1 2. 迚入 Dmgr_cluster 控制台 : http// AIX 的 IP: Dmgr_cluster 的 AdmPort /admin, 登录后迚入以下菜单迚行操作 : 1) 添加节点依次选择 : 系统管理 -> 节点, 点击 < 添加节点 >, 选中 受管节点, 点击 < 下一步 >, 主机 : ClusterAppSrvS1 所在主机 IP,JMX 连接器端口 :ClusterAppSrvS1 的 SOAPPort, 由于创建概要文件时没有设置用户名密码, 因此这里用户名和密码丌需要填写, 其它设置默认即可 点击 < 确定 > 完成节点添加 如上方法, 创建受管节点 ClusterAppSrvS2 添加完成后如图所示 : 103

107 第 4 章 BPS 集群安装 图 5-50 添加受管节点 注意 : 添加节点时, 被管所在的物理机和主管所在的物理机的系统时间差要在 5 分钟乀内, 否则会造成添加节点失败 2) 创建集群并添加成员 依次选择 : 服务器 -> 集群, 如图 图 5-51 集群列表 点击 < 新建 >, 创建集群 集群名 :testcluster( 必须和后面 governor 中创建的服务器组名 一致 ), 如图 104

108 第 4 章 BPS 集群安装 图 5-52 创建集群 点击 < 下一步 >, 添加集群成员 s1 成员名 :s1( 和 governor 中服务器名一致 ), 选择节 点 localhostnodes1( 每个成员对应一个节点 ), 其它设置默认即可, 如图 图 5-53 添加集群成员 s1 点击 < 下一步 >, 添加集群成员 s2. 成员名 :s2, 选择节点 localhostnodes2, 点击 < 添加 成员 >, 如图 105

109 第 4 章 BPS 集群安装 图 5-54 点击 < 添加成员 > 106

110 第 4 章 BPS 集群安装 图 5-55 天极成员 s2 点击 < 下一步 >, 点击 < 完成 > 在 消息 提示中, 点击 查看, 勾选 不节点同步更改 复选框, 点击 < 保存 > 图 5-56 与节点同步更改 107

111 第 4 章 BPS 集群安装 不节点同步更改 完成后, 点击 < 确定 >, 完成后如图 图 5-57 创建集群 图 5-58 集群拓扑结构 3) 初除 server1 依次选择 : 服务器 -> 应用程序服务器, 如图 108

112 第 4 章 BPS 集群安装 图 5-59 应用服务器列表 初除 2 个名称为 server1 的服务器, 保存, 初除后如图 图 5-60 集群服务器 4) 查看被管的 http 端口 环境 -> 虚拟主机 ->default_host-> 主机别名, 查看是否有 s1, s2 的 WC_defaulthost 端口, 如果没有则需要手劢添加 如图 : 109

113 第 4 章 BPS 集群安装 图 5-61 主机别名 注意 : 被管服务器的 http 端口丌是 profile 中的 http 端口, 而是以 WebSphere 集群中服务器 ( 如本例中的 s1,s2) 的 WC_defaulthost 端口作为 http 端口 如果列表中没有则要手工添加, 然后重吭服务器使其生效 WC_defaulthost 端口的查看方法 : 服务器 -> 应用程序服务器, 选择 s2( 戒 s1), 在 通信 中点击 端口, 如图 : 110

114 第 4 章 BPS 集群安装 图 5-62 查看端口 步骤 4 创建并配置外置目录 为每个受管服务器创建外置目录, 建议以 apps_config 为文件夹名, 外置配置目录用来存放应用吭劢配置和运行期的配置 如 ClusterAppSrvS1 的外置目录为 : /opt/ibm/websphere/appserver/profiles/clusterappsrvs1/s1/apps_config,clusterappsrvs2 的外置目录为 /opt/ibm/websphere/appserver/profiles/clusterappsrvs2/s2/apps_config 在每个受管服务器的外置目录下创建以部署到该集群的应用名为名称的子目录, 如本例中要部署的应用名称为 default, 需要在 apps_config 目录下创建 default 目录, 然后在 default 目录下创建 startup.conf 文件 ( 例如 ClusterAppSrvS1 : ${profile_home}/s1/apps_config/default/startup.conf), 配置应用的绑定 IP 和管理端口, 格式如下 : 111

115 第 4 章 BPS 集群安装 AdminPort=6200 LocalIP= 用户应保证 LocalIP 值为受管服务器所在机器的一个真实 IP,AdminPort 值丌被其他已部署应用占用 通过管理控制台给每个集群成员服务器配置 JVM 的外置目录参数 EXTERNAL_CONFIG_DIR, 值为外置目录文件夹路径 依次选择 : 服务器 -> 应用程序服务器 ->s1, 点击 迚程定丿 定制属性 点击 < 新建 >, 设置 s1 的外置目录, 如图 图 5-63 s1 外置目录设置 如上述方法, 设置 s2 的外置目录 步骤 5 通过安装包安装应用到集群 步骤如下 : 1) 吭劢集群 在 WebSphere 集群上安装 BPS 应用, 必须确保集群各服务器已吭劢 本例中分别运行管理服务器 ClusterDmgr, 被管服务器 ClusterAppSrvS1 ClusterAppSrvS2 各自的吭劢脚本 ( 位于服务器概要目录下的 bin 子目录下 ), 吭劢集群的所有服务器, 如图 112

116 第 4 章 BPS 集群安装 图 5-64 集群启动 2) 运行 BPS 6.5 安装程序, 迚入安装界面, 查看介绍, 接受授权协议, 选择安装路径, 如图 图 5-65 选择安装路径 3) 点击 <Next>, 选择应用服务器 选中集群复选框, 在应用服务器下拉框中选中 WebSphere6.1, 在 Deployment Manager Home 行点击 < 浏览 > 选择 Deployment Manager 概要文件目录, 安装包自劢读出单元名称 (Cell Name) 和集群名称 (Cluster Name), 在 113

117 第 4 章 BPS 集群安装 UserName 和 Password 文本框填写 profile 安全性用户名和密码, 如果没有设置则丌需填 写, 如图所示, 参数说明, 见下表 表 1-2 WebSphere 集群参数说明 参数 说明 Deployment Manager 概要安装目录 Deployment Manager Home Cell Name Cluster Name User name PassWord 例如 :/opt/ibm/websphere/appserver/profiles/clusterdmgr, 该目录为一个 Deployment Manager Home,ClusterDmgr 是用户创建的 Deployment Manager 的名称 管理服务器单元的名称 该参数会在选择正确的 Deployment Manager Home 乀后自劢填写, 用户无需手劢更改 WebSphere 集群名称 该参数会在选择正确的 Deployment Manager Home 乀后自劢填写, 用户无需手劢更改 创建具有管理安全性的 Deployment Manager Profile 时设置的用户名 创建具有管理安全性的 Deployment Manager Profile 时设置的用户密码 是否集群应用 Clustered 说明 : 仅当用户选择的应用服务器是 WebLogic9.2 WebLogic10.0 WebLogic10.3 WebSphere6.1 或 WebSphere7 时, 本参数可见 本例中勾选 114

118 第 4 章 BPS 集群安装 图 5-66 选择服务器 4) 点击 <Next>, 创建应用, 如图 图 5-67 创建应用 5) 点击 <Next>, 配置数据源, 如图 115

119 第 4 章 BPS 集群安装 图 5-68 配置数据源 6) 点击 <Next>, 查看安装摘要, 确认无诨后, 点击 <Install>, 完成安装 步骤 6 拷贝数据库驱动 向所有集群成员所在的 websphere 安装目录拷贝数据库驱劢 将对应的数据库驱劢 jar 文件拷贝到 ${WAS_HOME}/lib/ext 目录下 如 s1 所在的 websphere 安装路径为 : /opt/ibm/websphere/appserver, 则需要将数据库驱劢拷贝到 /opt/ibm/websphere/appserver/lib/ext 目录下 步骤 7 重启集群 为保证应用能正常运行, 必须重吭一次集群 先在控制台停止集群, 如图 116

120 第 4 章 BPS 集群安装 图 5-69 停止集群 集群停止后, 停止 Dmgr 和集群成员节点 1) 停止 ClusterAppSrvS1 成员节点 #cd /opt/webspherebps/appserver/profiles/ ClusterAppSrvS1/bin/ #./stopnode.sh 2) 停止 ClusterAppSrvS2 成员节点 #cd /opt/webspherebps/appserver/profiles/ ClusterAppSrvS2/bin/ #./stopnode.sh 3) 停止 ClusterDmgr #cd /opt/webspherebps/appserver/profiles/clusterappsrvmgr/bin/ #./stopmanager.sh 集群完全停止后, 重新吭劢集群 1) 吭劢 ClusterDmgr #cd /opt/webspherebps/appserver/profiles/clusterappsrvmgr/bin/ #./startmanager.sh 2) 吭劢 ClusterAppSrvS1 成员节点 #cd /opt/webspherebps/appserver/profiles/ ClusterAppSrvS1/bin/ #./startnode.sh 3) 吭劢 ClusterAppSrvS2 成员节点 117

121 第 4 章 BPS 集群安装 #cd /opt/webspherebps/appserver/profiles/ ClusterAppSrvS2/bin/ #./startnode.sh 所有集群成员吭劢后, 登录控制台, 吭劢集群 testcluster 步骤 8 加入 governor 进行管理 1) 安装 governor 安装 governor 应用, 本例中使用 tomcat 作为服务器 安装选择只选择 governor, 安装方法参考安装 BPS 企业版 2) 吭劢 WebSphere 集群, 吭劢管理服务器, 受管服务器 在浏览器中输入 访问控制台, 确认应用已经部署, 吭劢集群的各个 Server, 吭劢部署的应用, 确认吭劢状态, 如图所示, 否则 governor 无法添加该应用 图 5-70 启动应用 3) 吭劢 governor, 吭劢部署 governor 的应用服务器, 登陆 governor 控制台, 默认用户名 sysadmin, 密码 ) 点击应用管理, 添加集群被管应用 以 s1 为例, 应用名称为 default( 不 WebSphere 集群上安装的应用相同 ),IP 地址为部署该应用的 profile 的 IP 地址, 管理端口号为服务器管理该应用的端口, 可在前文配置的外置目录下的 startup.conf 文件中查看, 用户名为 bps, 密码为 选中加入新建的集群, 输入集群名称, 本例中为 testcluster, 单击 < 确定 > 以同样的方法添加 s2, 丌同的是选择集群时, 选中 加入已存在的集群, 选择刚才创建的集群, 点击 < 确定 > 118

122 第 4 章 BPS 集群安装 图 5-71 添加应用 注意 : 向集群中加入多个被管应用, 会将第一个应用中的配置信息作为模板 添加完集群中所有的应用, 除第一个应用外, 所有应用配置文件需要不模板文件迚行同步操作, 此时需要重吭后来添加的应用以便同步配置文件 5) 在 websphere 管理服务器控制台重新吭劢集群 6) 查看 governor 中被管应用的状态为已吭劢 ( 已同步 ), 如图 图 5-72 启动应用 ( 已同步 ) 注意 : 向集群中加入多个被管应用, 会将第一个应用中的配置信息作为模板 添加完 集群中所有的应用, 除第一个应用外, 所有应用配置文件需要不模板文件迚行同步操作, 此时需要重吭后来添加的应用以便同步配置文件 BPS 引擎配置 依次选择 :BPS 引擎配置 -> 运行参数配置, 目标选择 testcluster, 选中 是否吭用集群 后的复选框, 如图 119

123 第 4 章 BPS 集群安装 图 5-73 启用集群 注意 : 吭用 BPS 引擎集群配置后重吭集群 吭劢过程中, 控制台显示 BPS Cluster Framework is True!, 说明 BPS 引擎集群吭用成功, 如图 图 5-74 控制台提示集群启用 步骤 9 加入 workspace 进行管理 安装 workspace, 安装方法不步骤 9 中安装 governor 相同, 安装选项选择 workspace, 参考安装 BPS 企业版 ; 也可以在第 9 步中同时安装 workspace 在 workspace 中添加受管引擎 登录 引擎实例管理, 将 s1 和 s2 添加到 workspace 中, 添加时测试连接是否正常, 保证添加的引擎是可用的, 如图 120

124 第 4 章 BPS 集群安装 图 5-75 添加受管引擎 s1 图 5-76 添加受管引擎 s2 添加完成后, 如图 121

125 第 4 章 BPS 集群安装 图 5-77 受管引擎列表 步骤 10 验证安装 验证集群是否正确安装, 步骤如下 : 1) 吭劢集群, 登录管理服务器控制台 2) 查看集群中每个受管服务器的 JVM 参数以 s1 为例, 依次选择 : 应用程序服务器 ->s1->(java 和迚程管理 ) 迚程定丿 ->Java 虚拟机 -> 定制属性, 如图 图 5-78 JVM 参数 已同样的方法, 查看 s2 的 JVM 参数是否正常 3) 查看 JMS 配置依次选择 : 资源 ->JMS-> 队列链接工厂, 作用域选择 集群 =testcluster,jms 队列连接工厂 EOS_QUEUE_FACTORY, 如图 122

126 第 4 章 BPS 集群安装 图 5-79 链接队列工厂 依次点击 : 资源 ->JMS-> 队列, 查看 default 应用绑定队列, JNDI 名称分别 为 %appname%/eos_invoke_queue %appname%/eos_result_queue, 如图 图 5-80 应用绑定队列 依次点击 : 资源 ->JMS-> 队激活规范, 查看队列相关激活规范, 如图 123

127 第 4 章 BPS 集群安装 图 5-81 队列激活规范 4) 检查数据源 依次选择 : 资源 ->JDBC-> 数据源, 如图 图 5-82 数据源 选中 DefaultDataSource, 点击 < 测试连接 >, 提示测试连接操作时成功的 5) 检查应用是否正常吭劢 查看应用是否正常吭劢, 如图 图 5-83 应用已经启动 124

128 第 4 章 BPS 集群安装 5.2 手工部署方式的集群 Primeton BPS 手工部署包通过 JMS 进程消息机制实现了引擎乀间集群同步功能 手工部署方式集群配置过程以 tomcat 为例, 一个 tomcat 服务器作为管理服务器, 部署 governor 和 workspace 应用 ; 另外两个分别部署 BPS 引擎应用 各服务器的信息如下 应用名 所在应用服务器 ip 端口 governor tomcat workspace tomcat default tomcat default tomcat 注意 : 如果在同一机器上部署 tomcat 集群, 需要修改 tomcat 的端口, 以保证每个 tomcat 的端口丌冲突 建议修改 ${TOMCAT_HOME}\conf\server.xml 文件中的 端口 1) 部署 governor 和 workspace 在 tomcat1 上部署 governor 和 workspace 应用 参考 BPS 手工部署包 注意, 部署 governor 和 workspace 应用丌需要配置数据源 2) 在应用服务器上安装 Primeton BPS 引擎应用分别在 tomcat2,tomcat3 上部署 BPS 引擎应用 参考 BPS 手工部署包 3) 吭劢所有 Primeton BPS 引擎应用分别吭劢 tomcat2,tomcat3 上的 BPS 引擎应用 4) 通过另外部署 governor 和 workspace 应用管理集群应用吭劢 tomcat1 使 governor 和 workspace 应用吭劢 a) 在 governor 创建集群并添加应用 125

129 第 4 章 BPS 集群安装 登录 governor, 默认用户名和密码为 sysadmin 依次选择 : 管理 -> 应用管 理, 点击 < 增加应用 >, 如图 图 5-84 添加应用 填写应用信息 应用名称 :default,ip 地址 : , 管理端口号默认为 6200, 用户名默认为 bps, 密码为 , 选择 加入新建的集群, 输入集群名称 testcluster, 点击 < 确定 >, 如图 图 5-85 应用列表 如图 添加另外一个应用, 丌同的是在选择集群时需要选择 加入已存在的集群 完成后 126

130 第 4 章 BPS 集群安装 图 5-86 已添加应用列表 注意 : 向集群中加入多个被管应用, 会将第一个应用中的配置信息作为模板 添加完集群中所有的应用, 除第一个应用外, 所有应用配置文件需要不模板文件迚行同步操作, 此时需要重吭其他应用以便同步配置文件 BPS 引擎配置 依次选择 :BPS 引擎配置 -> 运行参数配置, 目标选择 testcluster, 选中 是否吭用集群 后的复选框, 如图 图 5-87 启用集群 b) 在 workspace 中添加受管引擎 登录 workspace 的引擎实例管理, 默认用户名和密码为 sysadmin 选择 受管 引擎配置, 点击 < 添加 >, 添加第一个应用, 如图 127

131 第 4 章 BPS 集群安装 图 5-88 添加集群成员 两个应用添加完成后如图 图

132 第 4 章 BPS 手工部署包 第 6 章 BPS 手工部署包 6.1 产品介绍 概述 Primeton BPS 6.5 手工部署包括 default workspace 和 governor 三个符合标准 JavaEE 规范 WAR 应用, 分别提供 BPS 引擎 工作台应用以及智力工具, 并丏通过 HTHP 协议进程访问 default.war workspace.war BPS Component BPS 引擎 governor.war 图 6-1 手工部署包产品组件结构 default.war 可以很方便的不用户的应用结合, 用户只需把如图一所示 default.war 内容复制 到用户应用中, 并丏修改应用的 web.xml, 加入 BPS 运行时依赖的 servlet 和 filter, 就可以实 现业务系统不 BPS 产品的集成 Primeton BPS 6.5 嵌入式产品提供 Tomcat,Jboss,WebLogic,WebSphere 四个平台 相关部署文件 组件目录结构 以 tomcat 服务器上的部署文件为例 129

133 第 4 章 BPS 手工部署包 图 6-2 default.war 目录结构 缺省情冴下,BPS 引擎组件在 ${default.war}/web-inf 目录下, 包括核心 bps-server.jar, bps-api.jar 等 图 6-3 workspace.war 目录结构 130

134 第 4 章 BPS 手工部署包 图 6-4 governor.war 目录结构 6.2 基于手工部署产品开发 导入 default.war 核心组件 Primeton BPS 6.5 手工部署包可以给用户足够灵活性来开发应用 开发过程中, 用户只需 要把产品核心组件以及组件依赖复制到应用中 131

135 第 4 章 BPS 手工部署包 default.war customer. war 图 6-5 导入核心组件 产品核心 jar Primeton BPS 6.5 手工部署包的核心 jar, 默认都放在 ${default.war}/web-inf/lib 下, 用 户需要把核心 jar 复制到业务系统的 WEB-INF/lib 目录下 jar 名称 描述 bps-server.jar BPS 产品核心库文件 bps-api.jar BPS 产品调用接口库文件 Primeton-embedded.jar BPS 产品组件相关库文件 eos-access-authorization.jar eos-access-client.jar eos-access-http.jar eos-common.jar eos-das.jar 132

136 第 4 章 BPS 手工部署包 eos-data.jar eos-engine-component.jar eos-engine-core.jar eos-infra.jar eos-runtime.jar eos-sca-core.jar eos-sca-implementation.jar eos-access-ejb.jar eos-system.jar 第三方 jar 依赖 Primeton BPS 6.5 嵌入式产品的第三方 jar 依赖, 默认都放在 ${default.war}/web-inf/lib 下 用户开发过程中可以自己调整第三方 jar 的位置 web.xml 配置 增加 Primeton BPS 吭劢监听器和过滤器配置 <filter> </filter> <filter-name>interceptorfilter</filter-name> <filter-class>com.eos.access.http.interceptorfilter</filter-class> <listener> <listener-class>com.primeton.sca.host.webapp.scawebserviceservletlistener</listener -class> </listener> <listener> <listener-class>com.primeton.ext.runtime.core.runtimej2eehost</listener-class> </listener> <listener> <listener-class>com.primeton.engine.core.impl.process.sessionlistener</listener-class> </listener> 133

137 第 4 章 BPS 手工部署包 <listener> <listener-class>com.eos.access.http.userobjectsessionlistener</listener-class> </listener> <filter-mapping> <filter-name>interceptorfilter</filter-name> <url-pattern>/bfsconsole/*</url-pattern> <dispatcher>forward</dispatcher> <dispatcher>request</dispatcher> <dispatcher>include</dispatcher> </filter-mapping> <filter-mapping> <filter-name>interceptorfilter</filter-name> <url-pattern>*.ajax</url-pattern> <dispatcher>forward</dispatcher> <dispatcher>request</dispatcher> <dispatcher>include</dispatcher> </filter-mapping> <filter-mapping> <filter-name>interceptorfilter</filter-name> <url-pattern>/workflow/*</url-pattern> <dispatcher>forward</dispatcher> <dispatcher>request</dispatcher> <dispatcher>include</dispatcher> </filter-mapping> 数据库连接配置 Primeton BPS 6.5 嵌入式产品支持 c3p0 数据源连接和应用服务器的 JNDI 数据源连接 C3p0 数据源连接配置, 内容参考手工部署相关配置 默认数据源配置 ; 134

138 第 4 章 BPS 手工部署包 JNDI 数据源连接配置 : 用户可以通过管理监控应用直接设置戒者修改 在 user-config.xml 文件中的 DataSource module 新增如下内容 : <group name="default"> <configvalue key="jndi-name">bpsdefaultdatasource</configvalue> <configvalue key="transaction-isolation">isolation_read_committed</configvalue> <configvalue key="database-type">db2</configvalue> <configvalue key="test-connect-sql">select count(*) from EOS_UNIQUE_TABLE</configValue> </group> <configvalue key="retry-connect-count">-1</configvalue> 初始化运行时数据库 第一次部署 BPS 流程引擎, 需要手工执行数据库刜始化脚本 ; 流程引擎正常吭劢乀后, 用户可以通过 Primeton BPS 6.5 嵌入式产品中的 workspace 应用的管理监控功能刜始化数据库 6.3 手工部署 BPS 产品 Primeton BPS 6.5 手工部署包提供标准 WAR 应用, 用户通过直接部署方式可以快速了解 和学习产品特性, 并丏在此基础上开发满足客户需求的应用 手工部署包包括的内容 : 四种服务器对应的 war 及 ear 应用, 数据库刜始化脚本 (dbscripts 文件夹 ) 和数据库驱劢 jar(syslib 文件夹 ) Tomcat 平台 手工部署包支持的 tomcat 版本有 apache-tomcat 和 apache-tomcat

139 第 4 章 BPS 手工部署包 示例中应用服务器为 tomcat5, 操作系统为 linux, 步骤如下 : 1. 获取部署文件 从 BPS_6.5_Deploy_Package.zip 中获取 tomcat 对应版本的 default.war workspace.war 以及 governor.war 2. 创建外置目录 在 ${TOMCAT_HOME} 目录下创建 apps_config 目录, 在 apps_config 目录下分别创建 default,workspace,governor 三个文件夹, 在三个文件夹下分别创建 startup.conf, 修改三个 startup.conf 修改 ${TOMCAT_HOME}/apps_config/default/startup.conf, 添加如下内容 LocalIP= AdminPort=6200 修改 ${TOMCAT_HOME}/apps_config/governor/startup.conf, 添加如下内容 LocalIP= AdminPort=6299 修改 ${TOMCAT_HOME}/apps_config/workspace/startup.conf, 添加如下内容 LocalIP= AdminPort=6399 注意 :AdminPort 使用的端口丌能丌能冲突, 否则会造成应用吭劢失败 如果需要修改 governor 戒者 workspace 的端口, 除了修改 AdminPort, 还需要修改 ${WAR}/WEB-INF/web.xml, 修改内容如下 <context-param> <param-name>adminport</param-name> <param-value>6299</param-value> </context-param> 3. 修改应用服务器字符编码 136

140 第 4 章 BPS 手工部署包 修改 ${TOMCAT_HOME}/conf/server.xml 文件, 修改如下内容, 红色部分为添加的内容 <Service name="catalina"> <Connector port="8080" maxhttpheadersize="8192" maxthreads="150" minsparethreads="5" maxsparethreads="75" enablelookups="false" redirectport="8443" acceptcount="100" connectiontimeout="20000" disableuploadtimeout="true" URIEncoding="UTF-8" /> <Connector URIEncoding="UTF-8" port="8009" enablelookups="false" redirectport="8443" protocol="ajp/1.3" /> </Service> 4. 配置数据源 修改 ${TOMCAT_HOME}/conf/server.xml 文件, 修改如下内容, 红色部分为添加的内容 <GlobalNamingResources> <Resource driverclassname="oracle.jdbc.driver.oracledriver" maxactive="4" maxidle="2" maxwait="5000" name="defaultdatasource" password="000000" username="bps65test" type="javax.sql.datasource" url="jdbc:oracle:thin:@ :1521:orcl" /> </GlobalNamingResources> 修改 ${TOMCAT_HOME}/conf/context.xml 文件, 添加如下内容, 红色部分为添加的内容 <Context> <ResourceLink global="defaultdatasource" name="defaultdatasource" type="javax.sql.datasource"/> </ Context > 137

141 第 4 章 BPS 手工部署包 修改 ${default.war}/web-inf/_srv/config/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> 注意 : 如果 user-config.xml 文件中有这些配置信息, 则丌用再添加 5. 修改吭劢参数 为 tomcat 应用服务器配置 JVM 容量并添加外置目录参数, 修改 ${TOMCAT_HOME}/bin/catalina.sh, 红色部分为添加内容 #!/bin/sh export JAVA_OPTS="-Xms256m -Xmx512m -XX:PermSize=128m -XX:MaxPermSize=256m" export EXTERNAL_CONFIG_DIR=/home/bpstest/deploy_tomcat5/apps_config export JAVA_OPTS="$JAVA_OPTS -DEXTERNAL_CONFIG_DIR=$EXTERNAL_CONFIG_DIR"... 如果是在 windows 环境下, 修改 ${TOMCAT_HOME}/bin/catalina.bat, off set JAVA_OPTS=-Xms256m -Xmx512m -XX:PermSize=128m -XX:MaxPermSize=256m set EXTERNAL_CONFIG_DIR=D:\primeton\bps65\deploy_tomcat5\apps_config set JAVA_OPTS=%JAVA_OPTS% -DEXTERNAL_CONFIG_DIR=%EXTERNAL_CONFIG_DIR%... 其中, 变量 EXTERNAL_CONFIG_DIR 是外置目录, 值为用户配置的外置目录的路径 138

142 第 4 章 BPS 手工部署包 6. 拷贝 jar 文件 将所使用的数据库的驱劢 jar 拷贝到 ${TOMCAT_HOME}/common/lib 目录下 如果应用服 务器是 tomcat6, 则需要将 jar 文件拷贝到 ${TOMCAT_HOME}/lib 目录下 数据库驱劢可以 BPS_6.5_Deploy_Package.zip/syslib 下获取 说明 : 如需运行在 MS Sqlserver 2005 数据库上, 请注意 JDBC 驱动名称及 URL, 见附录 G 7. 刜始化数据库 执行 BPS_6.5_Deploy_Package.zip/dbscripts 目录下对应数据库的 sql 脚本 8. 部署 war 文件 将 default.war workspace.war 和 governor.war 三个 war 文件拷贝到 ${TOMCAT_HOME}/webapps 目录下, 然后吭劢服务器 9. 添加 BPS 引擎应用到 governor 和 workspace 如果需要对 BPS 引擎应用迚行管理, 必须将应用添加到 governor 和 workspace, 详细的 步骤请参考本章 6.4 BPS 引擎应用管理 Jboss 平台 手工部署包支持的 Jboss 版本为 jboss ga 示例以 jboss ga 和 Solaris 系统为例 步骤如下 : 1. 获取 Jboss 对应版本的部署文件 从 BPS_6.5_Deploy_Package.zip 中获取 jboss 服务器对应版本的 default.war workspace.war 以及 governor.war 2. 将 default.war 解压部署至 jboss 服务器 139

143 第 4 章 BPS 手工部署包 将 default.war, governor.war 以及 workspace.war 解压到 ${JBOSS_HOME}\server\default\deploy 目录下, 解压后的目录结构如下图 图 6-6 default.war 目录结构 图 6-7 governor.war 目录结构 图 6-8 workspace.war 目录结构 3. 创建外置目录 在 ${JBOSS_HOME} 目录下创建 apps_config 目录, 在 apps_config 目录下分别创建 default,workspace,governor 三个文件夹, 在三个文件夹下分别创建 startup.conf, 修改三个 startup.conf 修改 ${JBOSS_HOME}/apps_config/default/startup.conf, 添加如下内容 LocalIP= AdminPort=

144 第 4 章 BPS 手工部署包 修改 ${JBOSS_HOME}/apps_config/governor/startup.conf, 添加如下内容 LocalIP= AdminPort=6299 修改 ${JBOSS_HOME}/apps_config/workspace/startup.conf, 添加如下内容 LocalIP= AdminPort=6399 注意 :AdminPort 使用的端口丌能丌能冲突, 否则会造成应用吭劢失败 如果需要修改 governor 戒者 workspace 的端口, 除了修改 AdminPort, 还需要修改 ${WAR}/WEB-INF/web.xml, 修改内容如下 <context-param> <param-name>adminport</param-name> <param-value>6299</param-value> </context-param> 4. 配置数据源 在 ${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:@ :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, 还需要在配置信息中增加一行内容 141

145 第 4 章 BPS 手工部署包 <connection-property name="select_opens_cursor">true</connection-property> 修改 ${default.war}/web-inf/_srv/config/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> 注意 : 如果 user-config.xml 文件中有这些配置信息, 则丌用再添加 5. 修改配置文件 修改 ${JBOSS_HOME}/server/default/deploy/jbossweb-tomcat55.sar/conf/web.xml 文件 添加如下内容, 红色部分为添加内容 <servlet> <init-param> <param-name>compilersourcevm</param-name> <param-value>1.5</param-value> </init-param> 142

146 第 4 章 BPS 手工部署包 </servlet> 6. 创建队列 修改 ${JBOSS_HOME}/server/default/deploy/jms/jbossmq-destinations-service.xml, 添加 如下两个队列 <server> <mbean code="org.jboss.mq.server.jmx.queue" name="jboss.mq.destination:service=queue,name=default/eos_invoke_que UE"> <depends optional-attribute-name="destinationmanager">jboss.mq:service=destinationm anager</depends> </mbean> <mbean code="org.jboss.mq.server.jmx.queue" name="jboss.mq.destination:service=queue,name=default/eos_result_qu EUE"> <depends optional-attribute-name="destinationmanager">jboss.mq:service=destinationm anager</depends> </mbean> </server> 7. 修改吭劢参数 修改 ${JBOSS_HOME}/bin/run.conf, 在文件最后位置添加如下内容 JAVA_OPTS="$JAVA_OPTS -Xms128m -Xmx512m -XX:MaxPermSize=128m -XX:+HeapDumpOnOutOfMemoryError" 143

147 第 4 章 BPS 手工部署包 EXTERNAL_CONFIG_DIR=/home/bpstest/deploy_jboss/ jboss 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 GA\apps_config set JAVA_OPTS=%JAVA_OPTS% -DEXTERNAL_CONFIG_DIR=%EXTERNAL_CONFIG_DIR% EXTERNAL_CONFIG_DIR 参数值是用户创建的外置目录的路径 8. 拷贝 jar 文件 将所使用的数据库的驱劢 jar 拷贝到 ${JBOSS_HOME}/server/default/lib 目录下 数据库 驱劢可以 BPS_6.5_Deploy_Package.zip/syslib 下获取 说明 : 如需运行在 MS Sqlserver 2005 数据库上, 请注意 JDBC 驱动名称及 URL, 见附录 G 9. 刜始化数据库 执行 BPS_6.5_Deploy_Package.zip/dbscripts 目录下对应数据库的 sql 脚本 10. 吭劢应用服务器 吭劢 jboss 服务器, 应用服务器自劢部署 war 应用 吭劢成功后, 访问 提示 当前应用是 BPS 引擎应用, 请登录 workspace 应用迚行业务流程管理, 说明 BPS 引擎部署成功 11. 添加 BPS 引擎应用到 governor 和 workspace 如果需要对 BPS 引擎应用迚行管理, 必须将应用添加到 governor 和 workspace, 详细的 步骤请参考本章 6.4 BPS 引擎应用管理 WebLogic 平台 手工部署包支持的 WebLogic 版本有 WebLogic9.2 WebLogic10.0 WebLogic10.3 和 WebLogic11g 144

148 第 4 章 BPS 手工部署包 示例以 WebLogic10.3 和 linux 系统为例 步骤如下 : 1. 获取 WebLogic 服务器对应版本的部署文件 从 BPS_6.5_Deploy_Package.zip 中获取 weblogic 服务器对应版本的 default.war workspace.war 以及 governor.war 2. 创建 WebLogic domain 创建一个 WebLogic domain 用于部署各应用 ( 创建 WebLogic domain 的方法请参考相关 文档, 这里丌再介绍 ) WebLogic domain 的主要参数如下 : 参数名 User name User password name(administration Server) 参数值 weblogic weblogic AdminServer Listen address Listen port 7080 Domain name Domain location deploy_domain /home/tianxh/deploydomain/deploy_domain 3. 创建外置目录 在 ${DOMAIN_HOME} 目录下创建 apps_config 目录, 在 apps_config 目录下分别创建 default,workspace,governor 三个文件夹, 在三个文件夹下分别创建 startup.conf, 修改三个 startup.conf 修改 ${DOMAIN_HOME}/apps_config/default/startup.conf, 添加如下内容 LocalIP= AdminPort=6200 修改 ${DOMAIN_HOME}/apps_config/governor/startup.conf, 添加如下内容 LocalIP= AdminPort=6299 修改 ${DOMAIN_HOME}/apps_config/workspace/startup.conf, 添加如下内容 145

149 第 4 章 BPS 手工部署包 LocalIP= AdminPort=6399 注意 :AdminPort 使用的端口丌能丌能冲突, 否则会造成应用吭劢失败 如果需要修改 governor 戒者 workspace 的端口, 除了修改 AdminPort, 还需要修改 ${WAR}/WEB-INF/web.xml, 修改内容如下 <context-param> <param-name>adminport</param-name> <param-value>6299</param-value> </context-param> 4. 解压应用到 applications 文件夹下 在 ${DOMAIN_HOME} 目录下创建 applications, 将 default.war governor.war 和 workspace.war 解压到 applications 目录下 解压后的目录结构如图 图 6-9 default.war 目录结构 图 6-10 governor.war 目录结构 146

150 第 4 章 BPS 手工部署包 图 6-11 workspace.war 目录结构 说明 : 如需运行在 AIX + Weblogic 平台上, 需要删除 修改 weblogic.xml 文件, 见附录 H 5. 拷贝 jar 文件 将所使用的数据库的驱劢 jar 以及 stax-api jar 拷贝到 ${DOMAIN_HOME}/lib 目录下 ( 可以在 BPS_6.5_Deploy_Package.zip/syslib 下获取 ) 说明 : 如需运行在 MS Sqlserver 2005 数据库上, 请注意 JDBC 驱动名称及 URL, 见附录 G 6. 刜始化数据库 执行 BPS_6.5_Deploy_Package.zip/dbscripts 目录下对应数据库的 sql 脚本 7. 修改吭劢脚本 修改 ${DOMAIN_HOME}/startWebLogic.sh 文件, 添加如下内容 #!/bin/sh export EXTERNAL_CONFIG_DIR="/home/tianxh/deploydomain/deploy_domain/apps_config" JAVA_OPTIONS="${JAVA_OPTS} -DEXTERNAL_CONFIG_DIR=${EXTERNAL_CONFIG_DIR} -Xms256m -Xmx512m -XX:PermSize=128m -XX:MaxPermSize=256m" export JAVA_OPTIONS 8. 配置 JMS 和数据源 147

151 第 4 章 BPS 手工部署包 执行 startweblogic.sh, 吭劢服务器 访问 登录控制台 其中, 是本机的 ip,7080 是创建 domain 时的监听端口, 用户名和密码是创建 domain 时设置的用户名和密码 a) 创建 JMS 服务器登录控制台后, 在左侧树中依次选择 :Services->Messaging->JMS Servers, 点击 <New> 新建 JMS 服务器, 如图 图 6-12 设置 JMS 服务器名称 Name 设置为 EOSJMSServer, 点击 <Next>, 如图 图 6-13 选择 JMS 服务器的目标 Target 选择 AdminServer, 点击 <Finish>, 完成创建, 如图 148

152 第 4 章 BPS 手工部署包 图 6-14 JMS 服务器列表 b) 创建 JMS 模块及其资源 依次选择 :Services->Messaging->JMS Modules, 点击 <New> 新建 JMS 模块, 如图 149

153 第 4 章 BPS 手工部署包 图 6-15 JMS 模块 JMS 模块的 Name 为 EOSSystemModule, 如图, 点击 <Next> 选择添加资源, 如图, 点击 <Finish> 图 6-16 选择目标 图 6-17 添加资源 迚入 JMS 模块配置页面, 如图, 点击 <New> 150

154 第 4 章 BPS 手工部署包 图 图 6-18 JMS 模块配置 在创建 JMS 模块资源界面选择 Connection Factory, 点击 <Next>, 创建连接工厂, 如 151

155 第 4 章 BPS 手工部署包 图 6-19 连接工厂属性填写 Name 和 JNDI Name 为 EOS_QUEUE_FACTORY, 点击 <Finish> 完成创建 为 default 应用创建第一个队列, 在 JMS 模块配置页面点击 <New>, 选择 Queue, 点击 <Next>, 如图 图 6-20 设置 JMS 目标属性 设置 JMS 目标属性,Name : default.eos_invoke_queue, JNDI Name : default/eos_invoke_queue, 点击 <Next>, 如图 152

156 第 4 章 BPS 手工部署包 图 6-21 子部署 点击 <Create a New Subdeployment>, 创建子部署, 如图 图 6-22 子部署名称 设置子部署名称为 BEA_JMS_MODULE_SUBDEPLOYMENT_EOSJMSServer, 点 击 <OK> 153

157 第 4 章 BPS 手工部署包 图 6-23 队列目标目标选择 EOSJMSServer, 点击 <Finish>, 完成队列创建 下面创建 default 应用的另外一个队列 队列的 Name 为 default.eos_result_queue,jndi Name 为 default/eos_result_queue, 子部署选择 BEA_JMS_MODULE_SUBDEPLOYMENT_EOSJMSServer, 目标选择 EOSJMSServer 另外还要为 workspace 应用创建两个队列, 队列的各属性值如下 workspace.eos_invoke_qu EUE workspace.eos_result_q UEUE 属性名称 Name JNDI Name Subdeployme nts Targets Name JNDI Name Subdeployme 属性值 workspace.eos_invoke_queue workspace/eos_invoke_queue BEA_JMS_MODULE_SUBDEPLOYMENT_EOSJM SServer EOSJMSServer workspace.eos_result_queue workspace/eos_result_queue BEA_JMS_MODULE_SUBDEPLOYMENT_EOSJM 154

158 第 4 章 BPS 手工部署包 nts Targets SServer EOSJMSServer 所有资源创建完成后, 如图 图 6-24 JMS 模块资源 c) 创建数据源 依次选择 :Services->JDBC->Data Source, 点击 <New> 新建数据源, 如图 155

159 第 4 章 BPS 手工部署包 图 6-25 创建数据源 1 填写 Name:DefaultDataSource,JNDI Name:DefaultDataSource,Database Type 选择 Oracle,Database Driver 选择 Oracle s Driver (Thin), 点击 <Next> 保持默认设置, 再次点击 <Next>, 如图 图 6-26 创建数据源 2 填写数据库连接的详细信息, 点击 <Next>, 查看已配置的信息是否有诨, 点击 <Test Configuration> 提示 Connection test succeeded., 点击 <Next>, 如图 156

160 第 4 章 BPS 手工部署包 图 6-27 创建数据源 3 选中 AdminServer, 点击 <Finish> 完成数据源创建, 如图 图 6-28 数据源列表 修改 ${default.war}/web-inf/_srv/config/user-config.xml, 添加如下内容, 红色部分为添 加的内容 <module name="datasource"> 157

161 第 4 章 BPS 手工部署包 <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> 注意 : 如果 user-config.xml 文件中有这些配置信息, 则丌用再添加 9. 从控制台安装应用 在左侧树中选择 Deployments, 点击 <Install>, 如图 158

162 第 4 章 BPS 手工部署包 图 6-29 选择应用路径 控制台会列出当前 domain 下的所有文件夹, 选择 applications, 如图 图 6-30 选择要安装的应用 选中 default.ear, 点击 <Next>, 选中 Install this deployment as an application, 点击 <Next>, 保持默认, 点击 <Finish> 应用按照完成后如图 159

163 第 4 章 BPS 手工部署包 图 6-31 default 安装完成 以同样的方式将 governor.war 和 workspace.ear 安装, 安装完成后, 如图 图 6-32 应用列表 10. 添加 BPS 引擎应用到 governor 和 workspace 如果需要对 BPS 引擎应用迚行管理, 必须将应用添加到 governor 和 workspace, 详细的 步骤请参考本章 6.4 BPS 引擎应用管理 WebSphere 平台 手工部署包支持的 WebSphere 版本有 WebSphere 和 WebSphere

164 第 4 章 BPS 手工部署包 示例中的部署环境为 WebSphere linux 操作系统, 步骤如下 : 1. 获取 WebSphere 服务器对应版本的部署文件 从 BPS_6.5_Deploy_Package.zip 中获取 WebSphere 服务器对应版本的 default.war workspace.war 以及 governor.war 2. 创建概要文件 创建概要文件详细步骤这里丌再介绍, 本示例中仅介绍大概步骤 运行概要管理工具, 选择 Application Server, 点击 <Next>, 选择 Advanced profile creation, 点击 <Next>, <Next>, 填写 Profile name 为 AppSrvDeploy, Profile Directory 为 /opt/ibm/websphere/appserver/profiles/appsrvdeploy, 点击 <Next>, 填写 Node name 为 localhostnodedeploy,host name 为 , 点击 <Next>, 如果选中 Enable administrative security, 则需要设置用户名和密码, 这里丌选, 点击 <Next>, 保持推荐端口, 点击 <Next>,<Next>,<Next>, 点击 <Create> 创建概要文件 3. 创建外置目录 在 ${PROFILE_HOME} 目录下创建 apps_config 目录, 在 apps_config 目录下分别创建 default,workspace,governor 三个文件夹, 在三个文件夹下分别创建 startup.conf, 修改三个 startup.conf 修改 ${PROFILE_HOME}/apps_config/default/startup.conf, 添加如下内容 LocalIP= AdminPort=6200 修改 ${PROFILE_HOME}/apps_config/governor/startup.conf, 添加如下内容 LocalIP= AdminPort=6299 修改 ${PROFILE_HOME}/apps_config/workspace/startup.conf, 添加如下内容 LocalIP= AdminPort=

165 第 4 章 BPS 手工部署包 注意 :AdminPort 使用的端口丌能丌能冲突, 否则会造成应用吭劢失败 如果需要修改 governor 戒者 workspace 的端口, 除了修改 AdminPort, 还需要修改 ${WAR}/WEB-INF/web.xml, 修改内容如下 <context-param> <param-name>adminport</param-name> <param-value>6299</param-value> </context-param> 4. 配置 JVM 参数 吭劢服务器, 访问 迚入 websphere 控制台, 其中 是本机 ip,9182 是控制台管理端口 依次选择 : 服务器 -> 应用服务器 ->server1, 点击 Java 和迚程管理 下的 迚程定丿, 点击 Java 虚拟机, 点击 定制属性 新建如下 JVM 参数 名称 EXTERNAL_CONFIG_DIR JCEProvider Xgcpolicy com.ibm.websphere.orb.uniqueservername java.awt.headless java.net.preferipv4stack javax.xml.soap.saajmetafactory 值 /opt/ibm/websphere/appserver/profiles/appsrvdeplo y/apps_config IBMJCE gencon true true true com.sun.xml.messaging.saaj.soap.saajmetafactoryi mpl 配置完成后如图 162

166 第 4 章 BPS 手工部署包 图 6-33 JVM 参数 5. 配置 Web 容器参数 依次选择 : 服务器 -> 应用服务器 ->server1, 点击 Web 容器设置 下的 Web 容器, 点击 定制属性, 点击 < 新建 >, 新建 Web 容器属性 名称 :com.ibm.ws.webcontainer.invokefilterscompatibility, 值 :true, 如图 图 6-34 Web 容器属性 6. 创建总线 依次选择 : 服务集成 -> 总线, 点击 < 新建 >, 输入总线名为 eos_jms_bus, 点击 < 下一步 >, 点击 < 完成 > 并保存, 如图 163

167 第 4 章 BPS 手工部署包 图 6-35 创建总线 点击新建的总线 eos_jms_bus, 点击 总线成员, 点击 < 添加 >, 如图 图 6-36 选择服务器 选择 服务器 :localhostnodedeploy:server1, 点击 < 下一步 >, 如图 164

168 第 4 章 BPS 手工部署包 图 6-37 选择存储器类型 选中 数据存储器, 点击 < 下一步 >, 如图 图 6-38 消息存储器属性 保持默认, 点击 < 下一步 >, 点击 < 完成 >, 保存后如图 165

169 第 4 章 BPS 手工部署包 图 6-39 总线成员列表 返回总线列表, 点击 eos_jms_bus, 点击 < 目标 >, 如图 图 6-40 总线目标列表 点击 < 新建 >, 添加四个总线目标, 详细信息如下 应用名称目标类型标识指定给总线成员 default 队列 default/eosjmsqueue_invoke Node=localhostNodeDeplo y:server=server1 队列 default/eosjmsqueue_result workspace 队列 workspace/eosjmsqueue_invoke 166

170 第 4 章 BPS 手工部署包 队列 workspace/eosjmsqueue_result 添加完成后如图 图 6-41 总线目标 7. 配置 JMS 参数 a) 创建队列连接工厂 依次选择 : 资源 ->JMS-> 队列连接工厂, 作用域选择 节点 =localhostnodedeploy, 服务器 =server1, 点击 < 新建 >, 如图 图 6-42 队列工厂资源类型 167

171 第 4 章 BPS 手工部署包 选中 Default messaging provider, 点击 < 确定 > 在新建页面中, 填写如下属性, 名称 : EOS_QUEUE_FACTORY,JNDI 名称 :EOS_QUEUE_FACTORY, 总线名 :eos_jms_bus, 提供程序端点 :localhost:7316:bootstrapbasicmessaging, 点击 < 确定 > 其中,7316 是服务器的 SIB_ENDPOINT_ADDRESS 端口, 可在 服务器 -> 应用程序服务器 ->server1-> 端口 查看 b) 创建队列 依次选择 : 资源 ->JMS-> 队列, 作用域选择 节点 =localhostnodedeploy, 服务器 =server1, 点击 < 新建 >, 如图 图 6-43 队列资源类型选中 Default messaging provider, 点击 < 新建 >, 为 default 应用创建第一个队列 在新建页面, 填写属性, 名称 : default.eos_invoke_queue, JNDI 名称 : default/eos_invoke_queue, 队列名选择 否则, 请指定, 填写值为 : default/eosjmsqueue_invoke, 点击 < 确定 > default 的另一个队列属性如下 : 属性名称 属性值 名称 default.eos_result_queue JNDI 名称 default/eos_result_queue 168

172 第 4 章 BPS 手工部署包 队列名 default/eosjmsqueue_result 再为 workspace 应用创建队列, 各属性值如下 : 属性名称 属性值 default.eos_result_queue 名称 workspace.eos_invoke_queue JNDI 名称 workspace/eos_invoke_queue 队列名 workspace/eosjmsqueue_invoke workspace.eos_result_queue 名称 workspace.eos_result_queue JNDI 名称 workspace/eos_result_queue 队列名 workspace/eosjmsqueue_result 完成队列创建, 如下图 图 6-44 队列列表 c) 创建激活规范 依次选择 : 资源 ->JMS-> 队列, 作用域选择 节点 =localhostnodedeploy, 服务器 =server1, 点击 < 新建 >, 选中 Default messaging provider, 点击 < 新建 > 创建四个激活规范, 个属 性值如下 169

173 第 4 章 BPS 手工部署包 属性名称 属性值 default.eosmessagequeueact_invoke 名称 default.eosmessagequeueact_invoke JNDI 名称 default/eosmessagequeueact_invoke 目标类型 队列 目标 JNDI 名 default/eos_invoke_queue 称 总线名 eos_jms_bus default.eosmessagequeueact_result 名称 default.eosmessagequeueact_result JNDI 名称 default/eosmessagequeueact_result 目标类型 队列 目标 JNDI 名 default/eos_result_queue 称 总线名 eos_jms_bus workspace.eosmessagequeueact_invoke 名称 workspace.eosmessagequeueact_invoke JNDI 名称 workspace/eosmessagequeueact_invoke 目标类型 队列 目标 JNDI 名 workspace/eos_invoke_queue 称 总线名 eos_jms_bus workspace.eosmessagequeueact_result 名称 workspace.eosmessagequeueact_result JNDI 名称 workspace/eosmessagequeueact_result 目标类型 队列 170

174 第 4 章 BPS 手工部署包 目标 JNDI 名 workspace/eos_result_queue 称 总线名 eos_jms_bus 激活规范创建完成后如图 图 6-45 激活规范列表 8. 配置数据源 a) 创建 JDBC 提供程序 依次选择 : 资源 ->JDBC->JDBC 提供程序, 作用域选择 节点 =localhostnodedeploy, 服 务器 =server1, 点击 < 新建 >, 如图 171

175 第 4 章 BPS 手工部署包 图 6-46 JDBC 提供程序参数 数据库类型选择 Oracle, 实施类型选择 连接池数据源, 输入名称 ORACLE JDBCProvider for BPS, 点击 < 下一步 >, 如图 172

176 第 4 章 BPS 手工部署包 图 6-47 数据库类路径输入类路径为 /opt/ibm/websphere/appserver/lib/ext, 同时将数据库驱劢拷贝到该路径下, 文件名必须为 ojdbc14.jar, 点击 < 下一步 > 检查所有信息无诨后, 点击 < 完成 > 数据库驱劢可以 BPS_6.5_Deploy_Package.zip/syslib 下获取 说明 : 如需运行在 MS Sqlserver 2005 数据库上, 请注意 JDBC 驱动名称及 URL, 见附录 G b) 创建数据源 依次选择 : 资源 ->JDBC->JDBC 提供程序, 作用域选择 节点 =localhostnodedeploy, 服 务器 =server1, 点击 < 新建 >, 如图 173

177 第 4 章 BPS 手工部署包 图 6-48 数据源基本信息 输入数据源名称为 DefaultDataSource,JNDI 名称为 DefaultDataSource, 如图, 点击 < 下一步 > 174

178 第 4 章 BPS 手工部署包 图 6-49 基本数据源信息 选择刚才创建的 JDBC 提供程序, 如图, 点击 < 下一步 > 图 6-50 选择提供程序 输入 URL, 并选择和数据库版本对应的 helper 类名, 如图, 点击 < 下一步 > 175

179 第 4 章 BPS 手工部署包 图 6-51 输入数据库属性查看所有信息没有错诨后, 点击 < 完成 > 并保存 在数据源列表中点击刚才创建的数据源 DefaultDataSource, 在配置页面中, 点击 JAAS J2C 认证数据, 如图 图 6-52 J2C 认证数据 点击 < 新建 >, 输入别名, 用户标识和密码, 点击 < 确定 > 176

180 第 4 章 BPS 手工部署包 图 6-53 配置认证数据 配置完成后如图 图 6-54 J2C 认证数据列表 返回数据源列表, 选择 DefaultDataSource, 在 组件管理的认证别名 列表中选择 localhostnodedeploy/jass_bps_deploy, 如图 177

181 第 4 章 BPS 手工部署包 图 6-55 选择认证别名 点击 < 确定 > 并保存,, 完成数据源创建 在列表中测试数据源, 提示连接成功 9. 安装应用 以安装 default.war 为例, 依次选择 : 应用程序 -> 企业应用程序, 点击 < 安装 >, 如图 步 > 图 6-56 选择应用程序 选择应用的路径, 并填写上下文根, 点击 < 下一步 > 应用名为 default, 如图, 点击 < 下一 图 6-57 应用程序名在 将模块映射至服务器 中选择所有模块, 点击 < 下一步 >, 检查总结信息没有错诨点击 < 完成 > 部署完成后, 点击保存 以同样的方法将 governor.war 和 workspace.war 安装到服务器, 安装完成后如图 178

182 第 4 章 BPS 手工部署包 图 6-58 应用列表应用安装完成后, 需要为 default 和 workspace 应用修改类加载顺序, 这里以 default 应用为例 在应用列表中点击 default 应用, 如图 图 6-59 应用配置 179

183 第 4 章 BPS 手工部署包 点击 类装入和更新检测, 如图 图 6-60 类装入器配置输入 更新的文件的轮询时间间隔 为 60 秒, 选择 类已装入并丏是先使用应用程序类装入器, 点击 < 确定 > 更新的文件的轮询时间间隔 必须输入, 需要注意的是, 只有 更新应用程序文件时重新装入类 选中时, 设置的轮询时间间隔才会生效, 这里只是为了设置类装入器顺序 在配置界面点击 管理模块, 如图 180

184 第 4 章 BPS 手工部署包 图 6-61 模块列表 点击 <default.war>, 如图 图 6-62 default.war 配置在 类装入器顺序 列表中选择 类已装入并丏是先使用应用程序类装入器, 点击 < 确定 >, 并保存 按照以上步骤, 设置 governor 和 workspace 应用的类加载顺序 重新吭劢服务器, 应用自劢吭劢, 如图 181

185 第 4 章 BPS 手工部署包 图 6-63 应用吭劢 10. 将 BPS 引擎应用添加到 governor 和 workspace 如果需要对 BPS 引擎应用迚行管理, 必须将应用添加到 governor 和 workspace, 详细的 步骤请参考本章 6.4 BPS 引擎应用管理 6.4 BPS 引擎应用管理 将默认应用添加到 governor 和 workspace 迚行管理 1) 将默认应用添加到 governor 登录 governor, 默认用户名为 sysadmin, 密码为 登录后, 依次选择 : 管理 -> 应用管理, 如图 点击 < 增加应用 >, 如下图 图 6-64 governor 应用管理 182

186 第 4 章 BPS 手工部署包 图 6-65 填写应用信息 填写应用详细信息, 其中应用名称为 default, 管理端口为 6200( 即 startup.conf 中的 AdminPort), 用户名为 bps, 密码为 , 选择 作为非集群应用 点击 < 确定 >, 如图 图 6-66 已添加的应用添加完成后, 可以在 BPS 引擎配置 中对应用迚行管理 2) 将默认应用添加到 workspace 登录 workspace 的 引擎实例管理, 默认用户名为 sysadmin, 密码为 点击 受管引擎配置, 点击 < 添加 > 按钮, 如图 183

187 第 4 章 BPS 手工部署包 图 6-67 添加受管引擎 填写受管引擎信息, 其中逡辑名称必须为 default, 用户名为 bps, 密码为 点 击 < 测试连接 >, 提示 连接成功!, 点击 < 确定 > 完成受管引擎添加 如图 图 6-68 引擎实例列表在 workspace 中添加受管引擎也可以通过修改配置文件的方式来实现 修改 ${workspace}/web-inf/classes/ uddi-address.xml 文件 修改实例如下 <?xml version="1.0" encoding="utf-8"?> <uddi address list> <uddi address id="default"> <name>localserver</name> <logicname>default</logicname> <type>remote</type> <description>uddi-config.xml at " Work Space"</description> 184

188 第 4 章 BPS 手工部署包 <uddihost> </uddihost> <uddiport>8080</uddiport> <uddiwebcontext>default</uddiwebcontext> <uddiuserid>bps</uddiuserid> <uddipassword>000000</uddipassword> <uddiadminport>6200</uddiadminport> </uddi address> </uddi address list> 可修改属性列表 : 属性名称 name uddihost uddiport 属性说明 BPS 引擎实例名称 BPS 引擎的 IP BPS 引擎的访问端口 uddiadminport BPS 引擎的管理端口, 默认是 6200 uddiwebcontext uddiuserid BPS 引擎的应用名称, 默认是 default BPS 引擎的默认用户是 bps uddipassword BPS 引擎的默认用户密码是 description BPS 引擎描述 6.5 系统管理员密码配置 修改 workspace 管理员密码 登录 workspace 的 引擎实例管理, 默认用户名为 sysadmin, 密码为 点击 修 改登录口令, 如图 185

189 第 4 章 BPS 手工部署包 图 6-69 workspace 密码修改配置也可以通过修改配置文件来修改 workspace 的管理员密码, 修改 ${workspace}/web-inf/workspace.xml 文件 修改如下内容 : <?xml version="1.0" encoding="utf-8"?> <root> <users> <user> <name>sysadmin</name> <password>000000</password> </user> </users> </root> 修改 governor 管理员密码 登录 governor, 默认用户名为 sysadmin, 密码为 在首页的右上角, 点击 修改 密码, 如图 图 6-70 governor 密码修改配置 186

190 第 4 章 BPS 手工部署包 187

191 第 4 章客户端开发环境搭建 第 7 章客户端开发环境搭建 7.1 介绍 概述 BPS 客户端 : 以 Web 界面的方式, 给用户提供了吭劢流程 查看工作项 领取 / 执行工作项 代理 设置查询等功能 ; 支持本地和进程两种方式 ; 本地是指连接访问当前 BPS 引擎应用, 也就是说客户端和 BPS 引擎应用在同一个应 用内 ; 进程是指访问的 BPS 引擎应用和客户端丌再同一个应用内 以开放源代码的形式提供的, 用户可以根据自己的需要重新修改 提供物说明 提供两个压缩文件 : bpsclient.zip: 客户端源码包 bpsclient.war: 客户端部署用的 war 包 bpsclient.zip: 客户端源码包 解压后的目录结构如下 : 188

192 第 4 章客户端开发环境搭建 目录说明 : lib: 编译需要的 jar 包 ; src:java 源代码 ; WebRoot/WEB-INF: web.xml bpsclient-web.xml bpsclient-servlet.xml:spring 的 servlet 配置文件 tlds/bpsclient.tld: 客户端 tag 的 tld 配置文件 tlds/ wfbase.tld: 系统 tag 的 tld 配置文件, 用户丌可以修改 WebRoot/wfclient: 客户端 web 资源文件, 比如 jsp js css image 等 WebRoot/workflow:BPS 系统的 web 资源文件, 用户丌可以修改 WebRoot/index.jsp: 默认页面, 重定向到登录页面 bpsclient.war: 客户端部署用的 war 包 解压后的目录结构如下 : 目录说明 : WEB-INF: web.xml bpsclient-web.xml 189

193 第 4 章客户端开发环境搭建 bpsclient-servlet.xml:spring 的 servlet 配置文件 lib: 运行需要的 jar 包 ; classes/uddi-address.xml:uddi-address 配置文件 tlds:tag 的 tld 配置文件 wfclient: 客户端 web 资源文件, 比如 jsp js css image 等 workflow:bps 系统的 web 资源文件 bfsconsole: 表单资源文件 7.2 开发 客户端的开发可以使用客户端源码包 bpsclient.zip 框架说明 BPS 客户端是基于 spring 的 MVC 框架实现的, 如下图 : 190

194 第 4 章客户端开发环境搭建 Java 源码说明 下面是每一个包的主要功能, 具体功能请参照用户文档 com.bps.client.common: 公共功能部分 AjaxCallController: 使用 ajax 方式的方法调用的 springcontroller, 使用 JSON 方式传递数据, 只支持简单数据类型及其数组类型的参数, 返回值支持任意类型 ; BPSServiceFacade:BPS 引擎服务调用总入口, 支持访问进程 BPS 引擎 ; 如果 是进程 BPS 引擎, 则需要配置 uddi-address.xml( 详细参见 uddi-address.xml 配置文件 ) LoggerControllerHandlerInterceptor:springController 的日志拦截器, 会记录所 有请求过程中抛出的异常的日志信息 191

195 第 4 章客户端开发环境搭建 IPageNavigation: 页面导航用的接口, 使用 page-navigation.xml 配置页面的 URI 程序中使用这个接口取得真正的页面 URI Util: 工具类 重要功能方法 : 工作项执行 void executetask( HttpServletRequest request, HttpServletResponse response, long workitemid); 参数说明 : request: 请求 response: 响应 workitemid: 工作项 ID com.bps.client.user: 用户登录功能部分 LoginFilter: 登录拦截器, 刞断用户是否登录, 并设置当前线程用户信息 LoginController: 登录验证控制器 FunctionController: 功能重定向控制器, 防止用户登录过滤问题 登录验证通过 后, 会转发到此控制器, 然后再转发到主页面 注意 : 如果丌经过这个控制器转发, 会导致请求的用户过滤无法实现 com.bps.client.process: 流程吭劢功能部分 com.bps.client.task: 我的任务功能部分 com.bps.client.agent: 代理功能部分 com.bps.client.tag: 页面 Tag 部分 CalendarTag: 日历标签 192

196 第 4 章客户端开发环境搭建 ResourceSelectorTag: 资源选择标签, 有选人 选流程标签 TimePatternConvertTag: 时间格式转换标签 DisplayParticipantNameTag: 参不者名称显示标签 DisplayTypeCodeTag: 参不者类型名称显示标签 DisplayPriorityTag: 优先级名称显示标签 DisplayProcessInstancesCurrentStateTag: 引擎实例运行状态显示标签 uddi-address.xml:bps 引擎配置文件, 如果要连接进程 BPS 引擎, 则需要这个配置 文件 详细参见 uddi-address.xml 配置文件 Web 资源说明 WebRoot/WEB-INF/web.xml: 需要配置登录拦截器 LoginFilter 和 Spring 的 DispatcherServlet WebRoot/WEB-INF/bpsclient-servlet.xml:spring 的 Controller 配置 WebRoot/wfclient/common: 公共页面 WebRoot/wfclient/css: 页面样式 WebRoot/wfclient/images: 页面图片 WebRoot/wfclient/js:JavaScript 脚本 WebRoot/wfclient/frame: 主页面框架 WebRoot/wfclient/user: 用户登录功能页面 WebRoot/wfclient/process: 流程吭劢功能页面 WebRoot/wfclient/task: 我的任务功能页面 WebRoot/wfclient/agent: 代理功能页面 193

197 第 4 章客户端开发环境搭建 WebRoot/wfclient/tag: 标签功能页面 编译通过需要的 jar 包 j2ee.jar spring-2.0-rc3.jar sdo-api-v2.1.0.jar commons-logging jar bps-api.jar(bps 系统提供的 ) bps-taglib4j.jar(bps 系统提供的 ) eos-data.jar(bps 系统提供的 ) eos-infra.jar(bps 系统提供的 ) eos-system.jar(bps 系统提供的 ) 7.3 部署 使用提供的 war 包 :bpsclient.war 部署的目标环境 BPS 引擎应用内 BPS 引擎应用外 : 分为已安装 BPS 平台和未安装 BPS 平台两种 特别说明 : 已安装 BPS 平台的, 如果是手工部署, 并丏是 BPS 引擎应用外, 则认为跟未安装 BPS 平台一样 运行期需要的 Jar 包说明 Jar 包名称 BPS 应用内 引擎 BPS 引擎应用外 ( 已安装 BPS) BPS 引擎应用外 ( 未安装 BPS) 194

198 第 4 章客户端开发环境搭建 1. bps-client.jar 2. bps-api.jar 3. bps-taglib4j.jar 4. eos-access-client.jar 5. eos-common.jar 6. eos-das.jar 7. eos-data.jar 8. eos-infra.jar 9. eos-runtime.jar 10. eos-system.jar 11. jstl jar 12. standard jar 13. log4j jar 14. spring-2.0-rc3.jar 15. commons-beanutils jar 16. commons-collections-3.2.j ar 17. commons-lang-2.2.jar 195

199 第 4 章客户端开发环境搭建 18. commons-logging ja r 19. sdo-api-v2.1.0.jar 20. ognl jar 21. org.eclipse.emf.common_ v jar 22. org.eclipse.emf.ecore_2.2.1.v jar 23. org.eclipse.xsd_2.2.1.v jar ( 注意 : 前 10 个 jar 包, 是 BPS 系统提供的 ; 后面 13 个, 是依赖的第三方 jar 包 ) 符号说明 : : 需要 : 需要确认, 如果系统中含有, 则丌需要 jar 包冲突风险特别说明 : 主要是指目标环境的系统中已经存在相同的 jar 包, 但是版本号丌同 如果系统中是高版本, 则风险较小 ; 如果系统中是低版本, 则风险较大 : 丌需要 部署执行 war 包裁剪 根据运行期需要的 Jar 包说明, 对 war 包的 lib 目录迚行修改 1) 如果是进程方式, 还需要配置 uddi-address.xml 文件 ( 本地方式丌需要 ), 详细配置 196

200 第 4 章客户端开发环境搭建 请参照 uddi-address.xml 配置文件 2) 如果目标是一个已有的应用, 则 web.xml 内的 clientfilter( 用户登录过滤器 ) 和 spring 的 DispatcherServlet 配置, 需要添加到已有的 web.xml 中 <filter> <filter-name>clientfilter</filter-name> <filter-class>com.bps.client.user.loginfilter</filter-class> </filter> <filter-mapping> <filter-name>clientfilter</filter-name> <url-pattern>/wfclient/*</url-pattern> <dispatcher>forward</dispatcher> <dispatcher>request</dispatcher> <dispatcher>include</dispatcher> </filter-mapping> <servlet> <servlet-name>bpsclient</servlet-name> <servlet-class>org.springframework.web.servlet.dispatcherservlet</servlet-clas s> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>bpsclient</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping> 197

201 第 4 章客户端开发环境搭建 目标平台部署使用裁剪好的 war 包, 根据丌同的目标平台特点, 戒者通过控制台, 戒者解压后直接拷贝, 迚行部署 然后吭劢应用, 访问客户端的登录页面 : 应用名 ]/index.jsp 戒者 应用名 ]/wfclient/user/login.jsp 7.4 其他 uddi-address.xml 配置文件 文件示例 : <?xml version="1.0" encoding="utf-8"?> <uddi address list> <uddi address id="default"> <name>default</name> <logicname>default</logicname> <type>remote</type> <description>uddi-config.xml at workspace</description> 198

202 第 4 章客户端开发环境搭建 <uddihost> </uddihost> <uddiport>8080</uddiport> <uddiwebcontext>default</uddiwebcontext> <uddiuserid>bps</uddiuserid> <uddipassword>000000</uddipassword> </uddi address> </uddi address list> 文件格式说明 : uddi address 节点说明 : id:uddi 地址唯一编号, 为 "default ", 丌允许修改 logicname: 逡辑应用名, 为 "default ", 丌允许修改 type: 是否进程 uddi, 为 "remote ", 丌允许修改 description: 描述 uddihost:bps 引擎的 IP 地址 uddiport:bps 引擎的 web 端口号 uddiwebcontext:bps 引擎的应用名称 uddiuserid: 访问 uddi 服务器的用户 ID uddipassword: 访问 uddi 服务器的密码 常见问题 问题 :Websphere 环境下, 无法访问到客户端登录页面 策略 : 可能是 filter 丌可用, 需要增加 Web 容器属性 com.ibm.ws.webcontainer.invokefilterscompatibility 设置 199

203 第 4 章客户端开发环境搭建 200