产品安装文档

Transcription

1 普元信息技术股份有限公司 Primeton BPS 7.5 产品安装指南 1

2 目录 第 1 章简介 Primeton BPS 7.5 开发版的安装内容 Primeton BPS 7.5 企业版的安装内容...1 第 2 章配置要求 硬件配置 软件配置...2 第 3 章安装 BPS 界面交互安装 安装 BPS 开发版 安装 BPS 企业版 哑安装 哑安装相关配置文件 如何配置哑安装属性文件 哑安装配置文件典型示例 插件安装 集群安装 BPS 集群 手工部署方式的集群 手工部署安装 产品介绍 基于手工部署产品开发 手工部署 BPS 产品 BPS 引擎应用管理 系统管理员密码配置 第 4 章卸载 BPS 卸载开发版 卸载企业版 第 5 章客户端开发环境搭建 介绍 概述 提供物说明 bpsclient.zip: 客户端源码包 Bpsclient_remote.war: 客户端部署用的 war 包

3 5.2 开发 框架说明 Java 源码说明 Web 资源说明 编译通过需要的 jar 包 部署 部署的目标环境 运行期需要的 Jar 包说明 部署执行 其他 uddi-address.xml 配置文件 常见问题 第 6 章嵌入式客户端部署 介绍 概述 本地方式 远程调用方式 第 7 章高性能集群搭建 概述 环境要求 拓扑结构 安装步骤 安装准备 配置 License 配置前端机 配置执行机 安装检查 参数配置说明 前端机配置 执行机配置

4 附录 A BPS 安装目录说明 附录 B FAQ 附录 C 术语表 附录 D 创建表空间 附录 E 安装包配置修改 附录 F 手工部署相关配置 附录 G 支持 MS SqlServer 附录 H 支持 AIX + Weblogic 平台 附录 I Weblogic11g 数据库驱动的类路径 附录 J 初始化 informix 后台报错

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

6 Primeton BPS 7.5 产品安装指南第 2 章配置要求 第 2 章配置要求 本章介绍安装 Primeton BPS 7.5 产品的硬件和软件配置要求 2.1 硬件配置 安装产品的硬件配置要求 : 硬件 要求 CPU 内存 主频 2.0GHz 以上 1G 以上 开发版 : 临时目录空间 :500M 以上 硬盘空间 安装目录空间 :2G 以上 企业版 : 临时目录空间 :500M 以上 安装目录空间 :1G 以上 注意 : 用户选择安装目录时, 若安装目录下的空间不足, 安装程序会弹出提示框 推荐配置 2G 以上的内存 2.2 软件配置 安装产品的软件配置要求 : 软件 要求 开发版 : Windows 2003/XP/7/8(32 位或者 64 位 ) 操作系统 数据库 企业版 : Windows 2003/XP/7/8 Red Hat Enterprise Linux 3 AIX 6.1 HPUX Solaris 8 Oracle 9i/10g/11g DB2 8.2/9.5 SqlServer 2000/2005/2008/2012 MySQL / DM V7 KingbaseES V7 GBase 8s Oscar V7 2

7 Primeton BPS 7.5 产品安装指南第 2 章配置要求 软件 要求 说明 : 数据库表空间大小需大于 100MB 需要准备一个数据库用户, 用于初始化数据库操作, 且该用户具有创建 修改 删除表的权限 如果使用 DB2 数据库, 则需再创建一个页大小为 32KB 的用户表空间, 名字为 EOSWFCTX, 以及创建一个页大小为 32KB 的临时表空间, 临时表空间名字可自定义 创建表空间的 SQL 语句请参见附录 开发版 : Tomcat7.0.54( 安装包中自带 ) JavaEE 应用服务器 企业版 : Tomcat /6.0.18/6.0.41/ JBoss GA/6.1.0 WebLogic 9.2/10.0/10.3/ WebSphere6.1/7.0/8.5 Primeton PAS 6.0 TongWeb5.0 说明 : WebLogic9.2/10.0/10.3 WebSphere6.1/7.0 支持集群安装 开发版 : 默认使用安装包中自带的 JDK, 不使用本地 JDK 企业版 : JDK 如果安装时选择 WebSphere 应用服务器, 则不论什么操作系统, 均使用 WebSphere 自带的 JDK 如果是 Windows 操作系统, 则选择非 WebSphere 类型应用服务器时使用安装包中自带的 JDK 如果是 LINUX 操作系统 : 选择非 Weblogic 类型应用服务器时均默认使用系统环境变量中 JAVA_HOME 设置 ; 选择 WebLogic 类型应用服务器时, 则根据其 registry.xml 配置文件决定其运行时使用的的 JDK 如果以上另行指定的 JDK 版本不符合要求时, 系统会使用安装包中自带的 JDK 说明 : 用户可以修改安装启动程序 install.cmd/install.sh 中的 JAVA_HOME 变量来更换 JDK; 同样也可以修改卸载程序中的 JAVA_HOME 变量来更换 JDK WebLogic 的 registry.xml 文件在 WebLogic 安装根目录下 如果很少使用 RMI, 请手工调整相关的 jvm 参数, 例如 : -Dsun.rmi.dgc.client.gcInterval= Dsun.rmi.dgc.server.gcInterval= 即改参数设置 rmi gc 间隔为 10 分钟, 以提高性能 ( 安装时的默认值为 1 分钟 ) 如果较少使用 RMI, 该时间可以设置较长 ; 反之, 如果较多使用 RMI, 该时间可以设置较短 浏览器 IE 7/8/9/10 Firefox 31 Chrome 40 3

8 第 3 章安装 BPS 本章分别介绍 Primeton BPS 7.5 产品的界面交互安装方式和哑安装方式 3.1 界面交互安装 本节分别介绍界面交互方式下如何安装 Primeton BPS 7.5 开发版 企业版 说明 : 安装程序会根据操作系统的语言环境自动显示中文或英文 安装 BPS 开发版下面介绍安装 Primeton BPS 7.5 开发版前的准备工作 安装步骤, 以及验证安装是否成功方法 安装准备安装 Primeton BPS 开发版前, 需做以下准备工作 : 检查安装光盘, 检查光盘贴膜标注是否为 开发版 检查安装环境, 必须符合软件配置要求 安装步骤以 Windows 8( 中文 )+ Tomcat Oracle 10g 环境为例,Primeton BPS 7.5 开发版的安装步骤如下 : 步骤 1: 启动安装程序 (1) 将安装光盘插入 CD-ROM 中, 在 autorun 界面中选择安装 Primeton BPS 7.5 开发版 (2) 若不是通过 autorun 形式启动安装程序, 请直接执行安装程序文件 install.cmd 或者 install.exe 步骤 2: 阅读安装简介如图 3-1 所示, 单击 < 下一步 > 按钮 4

9 图 3-1 安装简介 步骤 3: 阅读开发版许可声明 阅读开发版的许可声明后, 选择 接受许可协议条款 单选按钮, 如图 3-2 所示, 单击 < 下一步 > 按钮 5

10 图 3-2 许可协议 步骤 4: 选择安装路径 单击 < 浏览 > 按钮, 从弹出的对话框中选择安装目录或者手动输入自定义路径 ( 不存在的目 录将自动创建 ), 如图 3-3 所示 设置完毕, 单击 < 下一步 > 按钮 6

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

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

13 图 3-5 选择安装组件 (2) 默认安装项 : Primeton Business Process Suite BPS Studio BPS Process Server BPS Governor BPS Workspace BPS Client (3) 单击 < 下一步 > 按钮 步骤 7: 设置管理员信息 (1) governor 和 workspace 管理员的密码可根据需要进行修改, 默认密码为 (2) 根据实际情况输入用户名称和机构名称 ( 可以不输入 ), 如图 3-6 所示 安装程序默认用户名称为当前登录操作系统的用户名 9

14 图 3-6 设置管理员信息 (3) 然后单击 < 下一步 > 按钮 步骤 8: 选择 IP (1) 在下拉列表框中选择本机 IP 如果有多个可用的网络连接, 则需要选择其中的一个 IP, 默认为本机 IP 地址 10

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

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

17 图 3-9 配置 Oracle 10g 类型数据库 配置数据库界面的参数说明, 如表 3-1 所示 表 3-1 配置数据库 参数 说明 数据库类型服务器 IP 服务器端口 SID 数据库名称数据库用户数据库用户口令数据库 URL 自选数据库驱动数据库驱动类 选择 BPS 使用的数据库类型 连接数据库服务器的 IP 地址 连接数据库服务器的端口号 Oracle 类型数据库的名称 数据库的名称 访问数据库的用户名 访问数据库的用户密码 访问数据库的 JDBC URL 安装程序会根据用户所填前面的内容自动生成 数据库驱动程序对应的 jar 包 因数据库使用 JDBC 连接,BPS 安装包内自带对应的数据库驱动 若默认的数据库驱动不能与用户所要连接的数据库相匹配, 请选中 自选数据库驱动程序 的复选框, 并选择相应的 jar 包 自选数据库驱动类 在不使用自选 JDBC 的情况下, 安装包为各类型数据库提供了默认的 JDBC Driver Class 13

18 (3) 选择是否 初始化数据库 说明 : 如果安装 BPS 是初次使用某个数据库, 建议初始化该数据库, 否则会导致 BPS 不能正常运行 ; 对于已执行过初始化的数据库, 再次初始化将覆盖已有的 BPS 相关表 初始化数据库时, 安装程序将在数据库中创建 BPS 使用的表和视图 若要初始化指定的数据库, 必须正确填写该数据库配置信息 如果安装时没有正确配置好数据库, 需要在安装后修改安装目录下的 user-config.xml 文件内容 该文件中 module name= DataSource 的配置项即为所需修改的数据源配置项 (4) 单击 < 数据库连接测试 > 按钮, 测试所配置数据库是否可以成功连接 (5) 单击 < 下一步 > 按钮, 如果数据库已经被其它 BPS 产品初始化过, 则会提示是否重新初始化 步骤 11: 预安装摘要阅读并审核安装设置信息, 如图 3-10 所示, 单击 < 安装 > 按钮 图 3-10 预安装摘要 步骤 12: 开始安装 安装过程中显示各组件的安装进程, 如图 3-11 所示 14

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

20 图 3-12 安装完成 验证安装验证 Primeton BPS 7.5 开发版是否已正确安装的步骤如下 : (1) 安装程序提示安装成功, 如图 3-12 所示 说明 : 用户第一次安装 Primeton BPS 7.5 产品后,[ 开始 / 应用 ] 中会添加 Primeton BPS 7.5 菜单 同一个登录用户若多次安装 BPS 7.5 产品,[ 开始 / 所有程序 ] 中会依次添加 Primeton BPS 7.5(BPS Home2) Primeton BPS 7.5(BPS Home3) 菜单, 以示区别 (2) 检查安装日志 打开 BPS 安装目录 (c:/primeton/bps) 下的 bps_7.5_install.log 安装日志文件, 检查安装过程是否有异常信息 (3) 检查目录和配置文件 验证安装 BPS Studio, 如表 3-2 所示 16

21 表 3-2 验证安装 BPS Studio 检查项目 目录和文件 配置文件 检查内容 BPS Studio 部分的内容 ( 如 :studio.exe) 是否存放于 BPS 安装目录 ( 参考路径 :c:/primeton/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 表 3-3 验证安装 BPS Server 检查项目 检查内容 数据库驱动 %TOMCAT_HOME%\ webapps (4) 检查 startserver.cmd %TOMCAT_HOME%\lib 目录下是否存在数据库驱动 : Oracle:ojdbc jar DB2 UDB:db2jcc.jar SQL Server:mssqlserver-3.0.jar MySql:mysql-connector-java jar KingbaseES:kingbasejdbc jar DM:dm7jdbcdriver jar GBase:gbase-connector-java-8s.jar Oscar:oscarJDBC-7.0.jar 检查是否存在安装过程中指定的应用 startserver.cmd 位于 BPS 安装目录下 用编辑器打开该文件查看 JAVA_HOME 的设置是 否正确 正确的位置应该为安装目录下的 \ide\eclipse\jre 位置 运行 startserver.cmd, 启动 BPS Server, 查看控制台是否有异常 正常启动完, 后台显 示如下图信息 : 17

22 图 安装 BPS 企业版下面介绍安装 Primeton BPS 7.5 企业版前的准备工作 安装步骤 验证安装是否正确的方法, 以及不同环境下安装时需要注意的事项 安装准备安装 Primeton BPS 7.5 企业版前, 需做以下准备工作 : 检查安装光盘 检查光盘贴膜标注是否为 企业版 检查安装环境 必须符合软件配置要求 准备应用服务器 : 如果安装时使用 WebLogic 类型服务器, 需要建立一个部署应用的 domain 可通过 WebLogic 的 configuration wizard 创建, 具体创建步骤请用户自行查阅相关资料 如果安装时使用 WebSphere 类型服务器, 需要建立一个应用程序服务器类型的 WebSphere Profile(WebSphere 概要文件 ) 可通过 WebSphere 的概要文件管理工具创建, 具体创建步骤请用户自行查阅相关资料 检查权限 18

23 如果在 AIX 系统下, 用户需要检查安装 BPS 产品的系统帐户是否拥有执行 WebSphere 安装目录下 bin 目录中程序的权限 建议都是安装 BPS 产品和安装 WebSphere 都使用帐户 root 安装示例 (AIX 5 ( 英文环境 )+ WebSphere 6.1+ DB2 UDB_V8.2) 以 AIX 5( 英文环境 )+ WebSphere DB2 UDB_V8.2 环境为例,Primeton BPS 7.5 企业版的安装步骤如下 : 步骤 1: 运行 install.sh, 启动安装程序 注意 : 如果用户想要进行远程安装, 需先安装支持远程调用 X Windows(UNIX 系统的桌面可视化程序 ) 并将图形输出到客户端的软件, 例如 Xmanager 3.0, 安装完该软件后, 运行 Xmanager Passive 程序 然后以命令行模式远程登录 AIX 系统, 再运行命令 export DISPLAY=% 客户端 IP%:0, 随后便可以运行 install.sh 进行远程安装了 步骤 2: 阅读安装简介 安装简介如图 3-14 所示, 单击 <Next> 按钮 图 3-14 安装简介 19

24 步骤 3: 阅读许可声明 阅读企业版的许可声明后, 选择 I accept the terms of the License Agreement 单选按 钮, 接受协议, 如图 3-15 所示, 然后单击 <Next> 按钮 图 3-15 许可协议 步骤 4: 选择安装路径 单击 <Choose> 按钮, 从弹出的对话框中选择安装目录或者手动输入自定义路径 ( 不存在 的目录将自动创建 ), 如图 3-16 所示 设置完毕, 单击 <Next> 按钮 20

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

26 图 3-17 配置 WebSphere6.1 类型应用服务器 选择应用服务器界面的参数说明, 如表 3-4 所示 表 3-4 选择应用服务器 参数 App Server Tomcat HOME BEA HOME Weblogic HOME WebServer PORT Profile Home 说明 选择 BPS 所使用的应用服务器类型 Tomcat 的安装目录 WebLogic 的安装目录 WebLogic 目录 用户选择 BEA HOME 后, 系统会自动填写 Weblogic HOME, 用户无需手动更改 WebServer 端口号,WebLogic 默认是 7001 用户选择 BEA HOME 后, 系统会自动填写 Webserver PORT, 用户无需手动更改 如果需要更改端口, 可以修改 Webserver PORT 为合适的端口, 但 Webserver PORT 必须为 的整数 WebSphere6.1 或 WebSphere7 安装目录下的 profiles\appsrv 子目录 例如 :/opt/websphere/profiles/appsrv_s1, 该目录为一个 Profile Home,AppSrv_s1 是用户创建的应用服务器的名称 Cell Name 管理服务器单元的名称 该参数会在选择正确的 Profile Home 之后自动填写, 用户无需手动更改 22

27 参数 Node Name Server Name User Name PassWord Check the username and password 说明 WebSphere 节点名称 该参数会在选择正确的 Profile Home 之后自动填写, 用户无需手动更改 WebSphere Server 名称 该参数会在选择正确的 Profile Home 之后自动填写, 用户无需手动更改 默认 server name 为 :server1 创建具有管理安全性的 Profile 时设置的用户名 创建具有管理安全性的 Profile 时设置的用户密码 按下一步后, 立即检查上述 UserName,Password 所填信息是否正确 (3) 注意 : 已经部署过应用的服务器不能再安装同名的应用 (4) 设置完毕, 单击 <Next> 按钮 步骤 6: 选择安装选项 (1) 选择需要的安装组件 如图 3-19 所示 图 3-18 图 3-19 选择安装组件 (2) 默认安装项 23

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

29 图 3-21 选择 IP (2) 单击 <Next> 按钮 步骤 9: 创建应用 用户填写应用名称, 应用名默认为 default, 单击 <Next> 按钮 25

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

31 图 3-23 配置 DB 类型数据库 注意 : 如果用户使用 DB2 数据库时, 请在初始化之前对 DB2 数据库进行创建表空间, 详见附录 D 创建表空间 配置数据库界面的参数说明, 如表 3-5 所示 表 3-5 配置数据库 参数 说明 数据库类型服务器 IP 服务器端口 SID 数据库名称数据库用户数据库用户口令数据库 URL 选择 BPS 使用的数据库类型 连接数据库服务器的 IP 地址 连接数据库服务器的端口号 Oracle 类型数据库的名称 数据库的名称 访问数据库的用户名 访问数据库的用户密码 访问数据库的 JDBC URL 安装程序会根据用户所填内容自动生成 27

32 参数 说明 数据库驱动程序对应的 jar 包 自选数据库驱动 数据库驱动类 因数据库使用 JDBC 连接,BPS 安装包内自带的对应的数据库驱动 若默认的数据库驱动不能与用户所要连接的数据库相匹配, 请选择 自选数据库驱动程序 的复选框, 并选择相应的 jar 包 自选数据库驱动类 在不使用自选 JDBC 的情况下, 安装包为各类型数据库提供了默认的 JDBC Driver Class (3) 选择是否初始化数据库 (Initialize Datebase) 说明 : 如果安装 BPS 是初次使用某个数据库, 建议初始化该数据库, 否则会导致 BPS 不能正常运行 ; 对于已执行过初始化的数据库, 再次初始化将覆盖已经修改的 BPS 表 初始化数据库时, 安装程序将在数据库中创建 BPS 使用的表和视图 若要初始化指定的数据库, 必须正确填写该数据库配置信息 (4) 单击 <Connection Test> 按钮, 测试所配置数据库是否可以成功连接 (5) 单击 <Next> 按钮 步骤 11: 预安装摘要阅读并审核安装设置信息, 如图 3-24 所示, 单击 <Install> 按钮 28

33 图 3-24 预安装摘要 步骤 12: 开始安装 安装过程中显示各组件的安装进程, 如图 3-25 所示 29

34 图 3-25 正在安装 步骤 13: 完成安装 安装程序提示 Primeton BPS 企业版已经成功安装, 如图 3-26 所示 单击 <Finish> 按钮, 完成安装 30

35 图 3-26 安装完成 验证安装 (AIX 5 + WebSphere DB2 UDB_V8.2) 以 AIX 5( 英文环境 )+ WebSphere DB2 UDB_V8.2 环境为例, 验证 Primeton BPS 7.5 企业版是否已正确安装的步骤如下 : (1) 安装程序提示安装成功, 如图 3-26 (2) 检查日志 打开 BPS 安装目录下的 bps_7.5_install.log 安装日志文件, 检查安装过程中是否有异常信息 (3) 检查数据库驱动和目录, 如表 3-6 所示 表 3-6 数据库驱动和目录 检查项目 检查内容 %WAS_HOME%/lib/ext 目录下是否存在数据库驱动 : 数据库驱动 Oracle:ojdbc jar DB2 UDB:db2jcc.jar SQL Server:mssqlserver-3.0.jar MySql:mysql-connector-java jar KingbaseES:kingbasejdbc jar DM:dm7jdbcdriver jar GBase:gbase-connector-java-8s.jar Oscar:oscarJDBC-7.0.jar 如果用户自选驱动, 则只会将用户自选驱动拷贝到该目录下 31

36 ear 目录 %Profile Home%/installedApps/%Cell Name%/ 下是否存在 default.ear governor.ear 和 workspace.ear 三个文件夹 说明 : %WAS_HOME% 是安装 WAS 的目录 %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 10g) 以 Red Hat Enterprise Linux 3 + WebLogic Oralce 10g 环境为例,Primeton BPS 7.5 企业版的安装步骤如下 : 步骤 1: 运行 install.sh, 启动安装程序 注意 : 如果用户想要进行远程安装, 需先安装支持远程调用 X Windows(UNIX 系统的桌面可视化程序 ) 并将图形输出到客户端的软件, 例如 Xmanager 3.0, 安装完该软件后, 运行 Xmanager Passive 程序 然后以命令行方式远程登录 Linux 系统, 再运行命令 export DISPLAY=% 客户端 IP%:0, 随后便可以运行 install.sh 进行远程安装了 步骤 2: 阅读安装简介 安装简介如图 3-27 所示, 单击 <Next> 按钮 32

37 图 3-27 安装简介 步骤 3: 阅读许可声明 阅读许可声明后, 选择 I accept the terms of the License Agreement 单选按钮, 如图 3-28 所示, 单击 <Next> 按钮 33

38 图 3-28 许可协议 步骤 4: 选择安装路径 单击 <Choose> 按钮, 从弹出的对话框中选择安装目录或者手动输入自定义路径 ( 不存在 的目录将自动创建 ), 如下图所示 设置完毕, 单击 <Next> 按钮 34

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

40 图 3-30 配置 WebLogic10.3 类型应用服务器 选择应用服务器界面的参数说明, 如表 3-7 所示 表 3-7 选择应用服务器 参数 App Server Tomcat Home BEA Home Weblogic Home 说明 选择 BPS 所使用的应用服务器类型 Tomcat 的安装目录 WebLogic 的安装目录 WebLogic 目录 用户选择 BEA HOME 后, 系统会自动填写 Weblogic HOME, 用户无需手动更改 Domain Home WebLogic Domain 目录 用户创建的 domain WebServer PORT Profile Home Cell Name Node Name WebServer 端口号,WebLogic 默认是 7001 用户选择 BEA HOME 后, 系统会自动填写 Webserver PORT, 用户无需手动更改 WebSphere6.1 安装目录下的 profiles\appsrv 子目录 例如 :/opt/websphere/profiles/appsrv_s1, 该目录为一个 Profile Home,AppSrv_s1 是用户创建的应用服务器的名称 管理服务器单元的名称 该参数会在选择正确的 Profile Home 之后自动填写, 用户无需手动更改 WebSphere 节点名称 该参数会在选择正确的 Profile Home 之后自动填写, 用户无需手动更改 36

41 参数 Server Name 说明 WebSphere Server 名称 该参数会在选择正确的 Profile Home 之后自动填写, 用户无需手动更改 (3) 设置完毕, 单击 <Next> 按钮 步骤 6: 选择安装选项 (1) 选择需要的安装组件 如图 3-31 所示 图 3-31 选择安装组件 (2) 单击 <Next> 按钮 步骤 7: 设置管理员信息 (1) 输入 governor 和 workspace 管理员的密码和确认密码, 如图所示 安装程序默认 sysadmin 的密码为 用户可以在此设置新密码, 密码长度必须在 6~20 位之间, 密码只能由半角英文字母 数字. 或下划线 _ 组成 37

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

43 图 3-33 选择 IP (2) 单击 <Next> 按钮 步骤 9: 创建应用 创建应用, 用户填写应用名称, 应用名默认为 default, 单击 <Next> 按钮 39

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

45 图 3-35 配置 Oracle_9 类型数据库 配置数据库界面的参数说明, 如表 3-8 所示 表 3-8 配置数据库 参数 说明 数据库类型服务器 IP 服务器端口 SID 数据库名称数据库用户数据库用户口令数据库 URL 自选数据库驱动 选择 BPS 使用的数据库类型 连接数据库服务器的 IP 地址 连接数据库服务器的端口号 Oracle 类型数据库的名称 数据库的名称 访问数据库的用户名 访问数据库的用户密码 访问数据库的 JDBC URL 安装程序会根据用户所填内容自动生成 数据库驱动程序对应的 jar 包 因数据库使用 JDBC 连接,BPS 安装包内自带的对应的数据库驱动 若默认的数据库驱动不能与用户所要连接的数据库相匹配, 请选择 自选数据库驱动程序 的复选框, 并选择相应的 jar 包 41

46 参数 数据库驱动类 自选数据库驱动类 说明 在不使用自选 JDBC 的情况下, 安装包为各类型数据库提供了默认的 JDBC Driver Class (3) 选择是否 Initialize Database 说明 : 如果安装 BPS 是初次使用某个数据库, 建议初始化该数据库, 否则会导致 BPS 不能正常运行 ; 对于已执行过初始化的数据库, 再次初始化将覆盖已有的 BPS 相关表 初始化数据库时, 安装程序将在数据库中创建 BPS 使用的表和视图 若要初始化指定的数据库, 必须正确填写该数据库配置信息 (4) 单击 <Connection Test> 按钮, 测试所配置数据库是否可以成功连接 (5) 单击 <Next> 按钮 步骤 11: 预安装摘要阅读并审核安装设置信息, 如图 3-36 所示, 单击 <Install> 按钮 图 3-36 预安装摘要 步骤 12: 开始安装 42

47 安装过程中显示各组件的安装进程, 如图 3-37 所示 图 3-37 正在安装 步骤 13: 完成安装 安装程序提示企业版已经成功安装, 如图 3-38 所示 43

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

49 表 3-9 数据库驱动和目录 检查项目 数据库驱动 ear 目录 检查内容 ${DOMAIN_HOME}/lib 目录下是否存在数据库驱动 : Oracle:ojdbc jar DB2 UDB:db2jcc.jar SQL Server:mssqlserver-3.0.jar MySql:mysql-connector-java jar KingbaseES:kingbasejdbc jar DM:dm7jdbcdriver jar GBase:gbase-connector-java-8s.jar Oscar:oscarJDBC-7.0.jar ${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 文件中完成 这个文件必须存放在安装包所在目录的 installer 子目录下, 且文件的名称必须为 silent_install.properties, 其内容遵循 java properties 文件格式, 需要转义的字符必须进行转义 该文件内容决定 BPS 安装路径 数据库配置 J2EE 服务器配置等 启动哑安装方式步骤如下 : 45

50 (1) 正确设置了 silent_install.properties 文件并且放在安装包所在目录的 installer 子目录下 (2) 在命令行模式下, 启动安装程序后面增加 -silent 参数即可 例如 : 在 Windows 系统下时, 假设安装光盘为 F:, 则输入 F:\install.cmd silent; 在 Linux/AIX 系统下时, 在安装包所在目录输入./install.sh silent 如何配置哑安装属性文件对于 Primeton BPS 7.5 开发版和企业版, 不同的应用服务器和数据库下, 哑安装属性文件的配置也不相同, 下面详细介绍不同情况下如何配置 silent_install.properties 文件 哑安装 BPS 7.5 产品时, 用户需设置下列参数, 如表 3-10 所示 表 3-10 哑安装属性文件共同参数 参数名称 参数意义 数据源配置信息 DB_DS_JNDI_NA ME DB_TYPE DB_DRIVER DB_IP 数据源 JNDI 名称, 为必填参数 说明 : 数据源名称不能和应用服务器中已配置的数据源有名称冲突 安装成功后会在应用服务器上创建一个输入名称的数据源 BPS 使用的数据库类型, 为必填参数 必须设置为以下值中的一个 : Oracle DB2 UDB SQLServer MySql KingbaseES DM GBase Oscar 数据库 JDBC 驱动类名, 为必填参数 各类型数据库默认的 JDBC Driver Class 如下 : Oracle:ojdbc jar DB2 UDB:db2jcc.jar SQL Server:mssqlserver-3.0.jar MySql:mysql-connector-java jar KingbaseES:kingbasejdbc jar DM:dm7jdbcdriver jar GBase:gbase-connector-java-8s.jar Oscar:oscarJDBC-7.0.jar 连接数据库服务器的 IP 地址, 为必填参数 是否使用默认的数据库驱动, 为必填参数 只能设置为 true 或 false DB_IS_DEFAULT _JAR 因数据库使用 JDBC 连接,BPS 安装包内自带了 Oracle DB2 UDB SQL Server MySql KingbaseES DM GBase Oscar 的数据库驱动 若默认的数据库驱动不能与用户所要连接的数据库相匹配, 请将本参数设置为 false, 并在 DB_JDBC_LIBS 中设置相应的 jar 包 说明 : 本参数为 false 时,DB_JDBC_LIBS 参数值不能为空 46

51 参数名称 DB_JDBC_LIBS DB_NAME DB_USERNAME DB_PASSWORD DB_SERVER_PO RT DB_ IS_INIT DB_IS_FORCE_I NIT 公共安装信息 SYSADMIN_PWD WORKSPACE_SY SADMIN_PWD USER_NAME USER_COMPANY 参数意义 用户自选的数据库 JDBC 驱动文件路径 (jar 包 ) 如果有多个文件, 以英文分号 ; 分隔, 如 :D:\jdbc\a.jar;D:\jdbc\b.jar 说明 : 仅当 IS_DEFAULT_JAR 值为 false 时, 才需要配置本参数 数据库的名称, 为必填参数 访问数据库的用户名, 为必填参数 访问数据库的用户密码, 为必填参数 连接数据库服务器的端口号, 为必填参数 各数据库服务器的缺省端口号如下 : Oracle:1521 DB2 UDB:50000 SQL Server:1433 MySql:3306 KingbaseES:54321 DM:5236 GBase:5258 Oscar:2003 是否要初始化数据库, 为必填参数 true 为初始化,false 为不初始化 说明 : 如果安装 BPS 是初次使用某个数据库, 建议初始化该数据库, 否则会导致 BPS 不能正常运行 ; 对于已执行过初始化的数据库, 再次初始化将覆盖已经修改的 BPS 表 初始化数据库时, 安装程序将在数据库中创建 BPS 使用的表和视图 若要初始化指定的数据库, 必须正确填写该数据库配置信息 是否强制初始化数据库, 说明 : DB_ IS_INIT 为 true 时, 如果该数据库已经初始化过 BPS 的系统表, 需要配置 DB_IS_FORCE_INIT true: 强制再次初始化数据 ;false: 不会再次初始化已经初始化过 BPS 系统表的数据库 governor 管理员 sysadmin 的密码, 为必填参数 密码长度必须在 6~20 位之间, 密码只能由半角英文字母 数字. 或下划线 _ 组成 workspace 管理员 sysadmin 的密码, 为必填参数 密码长度必须在 6~20 位之间, 密码只能由半角英文字母 数字. 或下划线 _ 组成 用户名称, 非必填参数 用户所在的机构名称, 非必填参数 47

52 参数名称 INSTALL_DIR USER_IP USER_PORT IS_DEPLOY_DEF AULTAPP DEFAULT_APP_N AME IS_DEPLOY_GOV ERNOR 安装目录, 为必填参数 说明 : 参数意义 安装路径最多可输入 64 个字符, 只能由半角英文字母 数字或下划线 _ 组成, 且不允许带空格 在 windows 系统下, 安装目录中的 \ 需要改成 /, 例如 :D: /primeton/de 填写目标安装机器的 IP 地址 多网卡或多 IP 情况下, 必须选择其中的一个 IP, 该 IP 为安装的 BPS 应用绑定地址 开发版默认使用 作为绑定地址, 但使用该地址不能进行网络操作 ( 如使用开发版安装的 Governor 管理其他机器上的应用 ) 如果需要进行网络操作, 请选择真实 IP 地址 管理端口是应用的 JMX 管理端口,Governor 应用通过该端口对应用进行管理, 管理端口也是 BPS 集群应用之间的相互通知端口 安装应用时, 请保证端口号不冲突 ( 即不被占用 ) 是否部署默认应用, 非必填参数 默认应用名称 说明 : 应用名的长度必须在 3~64 之间, 只支持半角英文字母和数字, 支持., _, -, 以字母开头 不许使用 governor workspace 做应用名 不允许与已有应用重名 是否部署 governor 应用, 非必填参数 对于不同的应用服务器, 需要配置不同的参数, 如表 3-11 所示 表 3-11 哑安装属性文件应用服务器参数 参数名称 参数意义 公共参数 APP_SERVER_TYPE APP_SERVER_NAME APP_SERVER_VERSION 应用服务器类型, 为必填参数 应用服务器名称, 为必填参数 应用服务器版本, 为必填参数 企业版专用参数 IS_REPEAT_INSTALLED 是否重复安装, 多次安装使用, 非必填, 多次安装时填写 true, 第一次安装不填或填写 false Tomcat 专用参数 AS_TOMCAT_HOME JBoss 专用参数 Tomcat 的安装目录 说明 : 仅当运行环境安装中选择 Tomcat 服务器时配置 48

53 参数名称 参数意义 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 AS_WL_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 的安全性 TongWeb 专用参数 AS_TONGWEB_HOME TongWeb 的安装目录 PAS 专用参数 AS_PAS_HOME PAS 的安装目录 哑安装配置文件典型示例 下面提供几个典型环境下的哑安装配置文件示例, 仅供参考, 具体参数值需要根据实际情 况填写 49

54 说明 : 安装程序对于参数值为空的参数处理方式是忽略, 因此用户可以保留那些不需要填写值的参 数 开发版 (Windows XP + Tomcat Oracle 11g) #Install Target Directory INSTALL_DIR=D:/install-dir #JavaEE Server Type APP_SERVER_NAME=Tomcat APP_SERVER_VERSION= #tomcat http port for http request APP_SERVER_PORT_DE=8080 #DataBase Type,for example:oracle,db2 UDB,SQLServer,MySql DB_TYPE=Oracle #JDBC Driver DB_DRIVER=oracle.jdbc.driver.OracleDriver #DataBase Server IP DB_IP= #DB Server Port DB_SERVER_PORT=1521 #DB Instance Name DB_NAME=test #DB User DB_USERNAME=test #DB User's Password DB_PASSWORD=test #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= 50

55 #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=true #DEFAULTAPP IS_DEPLOY_DEFAULTAPP=true DEFAULT_APP_NAME=default #Deploy Governor or Not IS_DEPLOY_GOVERNOR=true #Deploy Workspace or Not IS_DEPLOY_WORKSPACE=true #User and Company Information USER_NAME=username USER_COMPANY=yourcompany #Management IP and Port USER_IP= USER_PORT=6200 #sysadmin's Password SYSADMIN_PWD= #workspace sysadmin's Password WORKSPACE_SYSADMIN_PWD= 企业版 (AIX 5 + WebSphere DB2 UDB_V8.2) #Install Directory INSTALL_DIR=/opt/WebSphere/AppServer/profiles/AppSrv01/server1 #JavaEE Server Name APP_SERVER_NAME=WebSphere #6.1/7.0 APP_SERVER_VERSION=6.1 #cluster or not 51

56 IS_CLUSTER=false #AS_WAS_PROFILE_HOME AS_WAS_PROFILE_HOME=/opt/WebSphereND61EOS/AppServer/profiles/AppSrv01 #WebSphere6.1 CELL_NAME AS_WAS_PROFILE=AppSrv01 #WebSphere6.1 CELL_NAME AS_WAS_CELL_NAME=loopbackNode01Cell #WebSphere6.1 NODE_NAME AS_WAS_NODE_NAME=loopbackNode01 #WebSphere6.1 SERVER_NAME AS_WAS_SERVER_NAME=server1 #WAS security AS_WAS_USERNAME=wasuser AS_WAS_PASSWORD=userpw IS_SECURITY_CHECK=false #DataBase Type DB_TYPE=DB2 UDB #JDBC Driver>>silent_install.properties DB_DRIVER=com.ibm.db2.jcc.DB2Driver #DataBase JNDI Name DB_DS_JNDI_NAME=DefaultDataSource #DataBase Server IP DB_IP= #DB Server Port DB_SERVER_PORT=50000 #DB Instance Name DB_NAME=test #DB User DB_USERNAME=test 52

57 #DB User's Password DB_PASSWORD=test #Is Default JDBC Driver DB_IS_DEFAULT_JAR=true #User Defined JDBC Jar DB_JDBC_LIBS= #Is initialize DataBase,if value is true" do init,if value is other not inition 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=true #DEFAULTAPP IS_DEPLOY_DEFAULTAPP=true DEFAULT_APP_NAME=default #Deploy Governor or Not IS_DEPLOY_GOVERNOR=false #Deploy Workspace or Not IS_DEPLOY_WORKSPACE=false #optional USER_NAME=username USER_COMPANY=yourcompany #the Ip you are user for RMI USER_IP= USER_PORT=6200 #sysadmin's Password SYSADMIN_PWD= #workspace sysadmin's Password WORKSPACE_SYSADMIN_PWD= #if repeat install set it true IS_REPEAT_INSTALLED=false 53

58 注意 : 配置路径时需要自已转义, 如 D:\bps\bps1352 需转义为 D:\\bps\\bps1352 或 D:/bps/bps1352, 否则安装时会出现错误 说明 : 如需运行在 AIX + Weblogic 平台上, 需要删除 修改 weblogic.xml 文件, 见附录 H 3.3 插件安装 本节主要介绍 BPS 插件和 eclipse ee 版本的集成 普元提供的 BPS 插件可以和标准的 eclipse ee 版本以及 eclipse 标准版本进行集成 说明 : BPS 插件的安装介质可以直接从产品发布平台下载 BPS 插件既可以和 eclipse ee 版本集成, 也可以支持 eclipse 标准版本集成, 且安装方式是一致的 BPS 插件可以支持 eclipse 的 3.6.2, 3.7.2,4.2.2, 版本 BPS 插件版本和 eclipse 的版本一致才能进行集成 下面以一个特定的版本如 eclipse ee4.3.2 版本为例进行集成 : 下载 eclipse 介质 从 eclipse 官网下载 eclipse ee4.3.2 标准版本, 官网参考地址 : 例如下载的介质是 :eclipse-jee-kepler-sr2-win32.zip eclipse 安装 将介质 eclipse-jee-kepler-sr2-win32.zip 解压即可完成 eclipse 的安装 下载 BPS 插件介质 下载 BPS 插件介质 Primeton_BPS_Tools_7.5_for_Eclipse4.3.2.zip 安装 BPS 插件 将 Primeton_BPS_Tools_7.5_for_Eclipse4.3.2.zip 里面的所有资源全部复制到 eclipse 安 装目录的 dropins 文件夹下 54

59 3.3.5 重启 eclipse 清除 eclipse 缓存, 重启 eclipse 即可 清除 eclipse 缓存, 只需要在启动的时候添加 clean 参数 具体方法 : (1) 打开 cmd (2) 执行命令 :cd 安装目录 \eclipse (3) 执行命令 :eclipse -clean 验证集成启动 eclipse 之后, 查看所有透视图, 如果可以看到 BPS 开发透视图即集成成功 配置 BPS 引擎 BPS 集成的开发版本不自带开发的服务器, 一般需要远程的 BPS 引擎支持, 例如开发环境需要提交流程等, 需要配置 BPS 引擎, 具体的配置方法是 : 窗口 > 首选项 -- >BPS >BPS 引擎配置即可新增或修改远程的 BPS 引擎, 如下图所示 : j2ee 和 bps 集成开发模式 BPS 集成开发模式和 J2EE 标准开发模式类似, 只是在原来的标准版本上增加开发 BPS 流程的能力 具体的业务应用和流程引擎物理部署结构可参考第 7 章以及第 8 章 55

60 3.4 集群安装 Primeton BPS 集群是由多个 BPS 引擎应用实例组成, 这些引擎同时运行, 可以满足大规模企业应用的要求, 提高伸缩性和和可靠性 构成 Primeton BPS 集群的应用可以在同一台物理服务器上, 也可以在网络互通的不同物理服务器上 通常组成集群的应用实例运行在同一应用服务器上, 如 WebLogic 10.3 WebSphere 6.1 等 ; 但是 Primeton BPS 嵌入式版本提供用户搭建异构集群的能力, 用户只须在不同的嵌入式引擎中配置集群即可 Primeton BPS 集群优势 : 高并发性使用 BPS 集群, 用户应用的请求可以被分发到不同的 BPS 引擎实例处理, 提高了整体并发数量 可伸缩性通过集群配置能力, 用户可以动态增加引擎实例来满足业务发展的需求 Primeton BPS 集群主要处理引擎之间配置修改 数据同步和通知功能, 集群对象主要是 BPS 引擎运行中的数据模型 : 流程定义缓存数据 流程实例缓存数据 代理关系缓存数据 业务资源缓存数据 BPS 集群 Weblogic 集群 Primeton BPS 集群可以在 WebLogic 9.2 WebLogic 10.0 WebLogic 10.3 等版本上搭建, 以 WebLogic 10.3 Linux Oracle 10g 环境来示例, WebLogic 集群可分为单服务器集群和多服务器集群, 单服务器集群适合在单个机器上搭建集群, 多服务器集群适合在多个机器上搭建集群 单服务器集群, 这里单服务器是指在同一机器上搭建 WebLogic 集群, 将所有 WebLogic Server 实例放在同一个 WebLogic Domain 中进行管理 多服务器集群, 由不同机器上的不同的 WebLogic Domain 组成的集群, 其中的一个 WebLogic Domain 必须包含一个具有管理功能的 WebLogic Server 做为管理服务器, 其它 WebLogic Domain 包含受管的 WebLogic Server 56

61 单服务器集群和多服务器集群只是在 搭建 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 步骤 1. 搭建 WebLogic 集群环境 单服务器集群, 搭建 WebLogic 集群 1) 执行 config.sh 命令 ( 位置 ${WEBLOGIC_HOME}/wlserver_10.3/common/bin), 如图 57

62 图 3-39 配置向导 2) 选择 Create a new WebLogic domain, 点击 <Next>, 如图 58

63 图 3-40 选择安装 domain 类型 3) 默认不做修改, 点击 <Next>, 设置管理员和密码, 这里设置用户名为 system, 密码为 bpsversion, 如图 59

64 图 3-41 设置管理员和密码 4) 点击 <Next>, 配置启动模式, 选择 Development Mode 和 Sun SDK 后 60

65 图 3-42 配置启动模式和 JDK 5) 点击 <Next>, 选择是否自定义环境和服务设置 选择 Yes, 如图 61

66 图 3-43 选择自定义环境和服务 6) 点击 <Next>,<Next>, 配置管理服务器 输入 Administrator Server 的名称, 监听地址, 监听端口, 如果需要 SSL 支持的话可以选中 SSL enabled 勾, 配置 SSL 监听端口 62

67 图 3-44 配置管理服务器 7) 点击 <Next>, 配置受管理服务器 代理服务器也是一个受管理服务器 输入 Managed Server 的名称, 监听地址, 监听端口, 如果需要 SSL 支持的话, 可以在 SSL enabled 复选框上 打勾, 配置 SSL 监听端口 可以配置一个 ProxyServer 和多个 Managed Server 如图 注意 : 受限于 WebLogic 为受管服务器配置的 JMS 数据库表名长度, 建议受管服务器名不超过 19 个字符 服务器名如超过长度限制, 用户可在创建集群成功后登陆控制台 ->Services->Persistent Stores->BPSJMSJDBCStore-ManagedServer1 修改 Prefix Name BPSJMSJDBCStore- 是默认前缀,ManagedServer1 是本例创建的受管服务器名, 用户应以实际创建的受管服务器名为准 63

68 图 3-45 配置受管服务器 8) 点击 <Next>, 配置集群信息 单击 Switch Display 切换显示, 再单击 Add, 输入 Cluster 的名称,Multicast address 组播地址,Cluster 的组播地址和端口,Cluster 地址可输可不输 64

69 图 3-46 配置集群信息 9) 点击 <Next>, 步将受管理服务器添加到集群中 选择左面列表中的 Managed Server, 将其添加到右面的列表中, 这里代理服务器不要添加到右边 65

70 图 3-47 将受管服务器添加到集群 10) 点击 <Next>, 创建 HTTP 代理服务器 选中 Creat HTTP proxy for cluster bpscluster, Proxy Server 选择前面没有加入 bpscluster 的 ProxyServer 66

71 图 3-48 创建 HTTP 代理服务器 11) 点击 <Next>, 配置计算机 在此不对计算机进行配置, 默认即可 12) 点击 <Next>, 检查 WebLogic Domain, 确认无误 67

72 图 3-49 检查配置信息 13) 创建 WebLogicDomain, 输入要创建的域名和位置, 此处 Domain name 输入为 ClusterDomain, 点击 <Create> 按钮 68

73 图 3-50 创建 domain 14) 创建完成后, 点击 <Done> 多服务器集群, 搭建 WebLogic 集群 在机器 上创建 AdminDomain, 包含 AdminServer 和 ProxyServer 1) 执行 config.sh 命令 ( 位置 ${WEBLOGIC_HOME}/wlserver_10.3/common/bin), 如图 69

74 图 3-51 配置向导 2) 选择 Create a new WebLogic domain, 点击 <Next>, 如图 70

75 图 3-52 选择安装 domain 类型 3) 默认不做修改, 点击 <Next>, 设置管理员和密码, 这里设置用户名为 system, 密码为 bpsversion, 如图 71

76 图 3-53 设置管理员和密码 4) 点击 <Next>, 配置启动模式, 选择 Development Mode 和 Sun SDK 后 72

77 图 3-54 配置启动模式和 JDK 5) 点击 <Next>, 选择是否自定义环境和服务设置 选择 Yes, 如图 73

78 图 3-55 选择自定义环境和服务 6) 点击 <Next>,<Next>, 配置管理服务器 输入 Administrator Server 的名称, 监听地址, 监听端口, 如果需要 SSL 支持的话可以选中 SSL enabled 勾, 配置 SSL 监听端口 74

79 图 3-56 配置管理服务器 7) 点击 <Next>, 配置受管理服务器 代理服务器也是一个受管理服务器, 输入 Managed Server 的名称, 监听地址, 监听端口, 如果需要 SSL 支持的话, 可以在 SSL enabled 复选框上 打勾, 配置 SSL 监听端口 可以配置一个 ProxyServer 和多个 Managed Server 如图 注意 : 受限于 WebLogic 为受管服务器配置的 JMS 数据库表名长度, 建议受管服务器名不超过 19 个字符 服务器名如超过长度限制, 用户可在创建集群成功后登陆控制台 ->Services->Persistent Stores->BPSJMSJDBCStore-ManagedServer1 修改 Prefix Name BPSJMSJDBCStore- 是默认前缀,ManagedServer1 是本例创建的受管服务器名, 用户应以实际创建的受管服务器名为准 75

80 图 3-57 配置受管服务器 这里受管服务器 ManagedServer1 和 ManagedServer2 在 这台机器上, 因 此 Listen address 填写的是所在机器的实际 IP 8) 点击 <Next>, 配置集群信息 单击 Switch Display 切换显示, 再单击 Add, 输入 Cluster 的名称,Multicast address 组播地址,Cluster 的组播地址和端口,Cluster 地址可输可不输 76

81 图 3-58 配置集群信息 9) 点击 <Next>, 步将受管理服务器添加到集群中 选择左面列表中的 Managed Server, 将其添加到右面的列表中, 这里代理服务器不要添加到右边 77

82 图 3-59 将受管服务器添加到集群 10) 点击 <Next>, 创建 HTTP 代理服务器 选中 Creat HTTP proxy for cluster bpscluster, Proxy Server 选择前面没有加入 bpscluster 的 ProxyServer 78

83 图 3-60 创建 HTTP 代理服务器 11) 点击 <Next>, 配置计算机 在此不对计算机进行配置, 默认即可 12) 点击 <Next>, 检查 WebLogic Domain, 确认无误 79

84 图 3-61 检查配置信息 13) 创建 WebLogicDomain, 输入要创建的域名和位置, 此处域名输入为 AdminDomain, 点击 <Create> 按钮 80

85 图 3-62 创建 domain 14) 创建完成后, 点击 <Done> 在机器 上创建 Server1Domain, 包含 ManagedServer1, 创建 Server2Domain, 包 含 ManagedServer2 1) 执行 config.sh 命令 ( 位置 ${WEBLOGIC_HOME}/wlserver_10.3/common/bin), 如图 81

86 图 3-63 配置向导 2) 选择 Create a new WebLogic domain, 点击 <Next>, 如图 82

87 图 3-64 选择安装 domain 类型 3) 默认不做修改, 点击 <Next>, 设置管理员和密码, 这里设置用户名为 system, 密码为 bpsversion, 如图 83

88 图 3-65 设置管理员和密码 4) 点击 <Next>, 配置启动模式, 选择 Development Mode 和 Sun SDK 后 84

89 图 3-66 配置启动模式和 JDK 5) 点击 <Next>, 选择是否自定义环境和服务设置 选择 Yes, 如图 85

90 图 3-67 选择自定义环境和服务 6) 点击 <Next>,<Next>, 配置管理服务器 输入 Administrator Server 的名称, 监听地址, 监听端口, 如果需要 SSL 支持的话可以选中 SSL enabled 勾, 配置 SSL 监听端口 86

91 图 3-68 配置管理服务器 7) 点击 <Next>, 配置受管理服务器 代理服务器也是一个受管理服务器, 输入 Managed Server 的名称, 监听地址, 监听端口, 如果需要 SSL 支持的话, 可以在 SSL enabled 复选框上 打勾, 配置 SSL 监听端口 可以配置一个 ProxyServer 和多个 Managed Server 如图 注意 : 受限于 WebLogic 为受管服务器配置的 JMS 数据库表名长度, 建议受管服务器名不超过 19 个字符 服务器名如超过长度限制, 用户可在创建集群成功后登陆控制台 ->Services->Persistent Stores->BPSJMSJDBCStore-ManagedServer1 修改 Prefix Name BPSJMSJDBCStore- 是默认前缀,ManagedServer1 是本例创建的受管服务器名, 用户应以实际创建的受管服务器名为准 87

92 图 3-69 配置受管服务器 需要注意的是, 这里的 Name Listen address 以及 Listen port 信息必须和 AdminDomain 中的配置保持一致 8) 点击 <Next>, 配置集群信息, 这里不需要配置 88

93 图 3-70 配置集群信息 9) 点击 <Next>, 配置计算机 在此不对计算机进行配置, 默认即可 10) 点击 <Next>, 检查 WebLogic Domain, 检查是否有误 89

94 图 3-71 检查配置信息 11) 创建 WebLogicDomain, 输入要创建的域名和位置, 此处域名输入为 AdminDomain, 点击 <Create> 按钮 90

95 图 3-72 创建 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 和管理端口, 格式如下 : AdminPort=6200 LocalIP=

96 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. 设置启动脚本单服务器集群, 设置启动脚本设置启动集群需要的脚本及文件 1) 编辑集群的口令文件, 在刚才创建的 ClusterDomain 目录下创建 boot.properties 文件, 内容为前文中创建 WebLogic 集群设置安全性用户名和密码, 如 : username=system password=eosversion 2) 编辑管理服务器 (AdminServer) 的启动脚本, 在刚才创建的 ClusterDomain 目录下的 bin 目录中创建 startadminserver.sh 文件, 内容为 : #!/bin/sh./startweblogic.sh 92

97 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 说明 : 使用 startmanagedweblogic 命令启动 Managed Server, 它的命令格式是 : startmanagedweblogic.sh < 受管服务器名 > < 管理服务器 URL> EXTERNAL_CONFIG_DIR 参数是外置目录的参数, 外置配置目录用来存放应用启动配置和运行期的配置 多服务器集群, 设置启动脚本设置启动集群需要的脚本及文件 1) 编辑管理服务器 (AdminServer) 口令文件, 在刚才创建的 AdminDomain 目录下创建 boot.properties 文件, 内容为前文中创建 WebLogic 集群设置安全性用户名和密码, 如 : 93

98 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} -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> 94

99 EXTERNAL_CONFIG_DIR, 本参数是外置配置目录的参数, 外置配置目录用来存放应用 启动配置和运行期的配置 步骤 4. 拷贝数据库驱动向集群成员中所有 WebLogic Domain 的 lib 目录下拷贝集群使用的数据库对应的数据库驱动以及 stax-api jar 步骤 5. 启动管理服务器安装前, 将集群的管理服务器启动 启动管理服务器 :./startadminserver.sh 步骤 6. 通过安装包安装应用到集群 1) 运行 install.sh 命令, 进入安装界面, 接受许可协议, 如图 2) 点击 <Next>, 选择安装路径, 如图 图 3-73 接受许可声明 图 3-74 选择安装目录 95

100 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 Clustered WebLogic 的安装目录 WebLogic 目录 用户选择 BEA HOME 后, 系统会自动填写 Weblogic HOME, 用户无需手动更改 用户创建的 domain 目录 创建具有管理安全性的 domain 时设置的用户名 创建具有管理安全性的 domain 时设置的用户密码 用户创建的集群名称 集群管理服务器 (AdminServer) 端口 是否集群应用 说明 : 仅当用户选择的应用服务器是 WebLogic9.2 WebLogic10.0 WebLogic10.3 WebSphere6.1 或 WebSphere7.0 时, 本参数可见 本例中勾选 96

101 图 3-75 选择应用服务器 4) 点击 <Next>, 创建应用 集群环境下不能部署 governor 和 workspace, 如图 97

102 图 3-76 创建应用 5) 点击 <Next>, 配置数据库库信息, 如图 98

103 图 3-77 配置数据库 6) 点击 <Next>, 查看安装摘要 99

104 图 3-78 安装摘要 7) 点击 <Install>, 完成后安装 说明 : 如需运行在 AIX + Weblogic 平台上, 需要删除 修改 weblogic.xml 文件, 见附录 H 步骤 7. 启动集群为保证 BPS 应用能正常运行, 必须重启一次集群 进入 WebLogic Domain 的 bin 目录下, 启动各个服务器 启动管理服务器 AdminServer:./startAdminServer.sh 启动受管服务器 ManagedServer1:./startManagedServer1.sh 启动受管服务器 ManagedServer2:./startManagedServer2.sh 启动受管服务器 ProxyServer:./startProxyServer.sh 100

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

106 查看 governor 中被管应用的状态为已启动 ( 已同步 ) 注意 : 向集群中加入多个被管应用, 会将第一个应用中的配置信息作为模板 添加完集群中所有的应用, 除第一个应用外, 所有应用配置文件需要与模板文件进行同步操作, 此时需要重启后来添加的应用以便同步配置文件 BPS 引擎配置 依次选择 :BPS 引擎配置 -> 运行参数配置, 目标选择 testcluster, 选中 是否启用集群 后的复选框, 如图 图 3-81 启用集群 注意 : 启用 BPS 引擎集群配置后重启集群 启动过程中, 控制台显示 BPS Cluster Framework is True!, 说明 BPS 引擎集群启用成功, 如图 图 3-82 控制台提示集群启用 步骤 9. 加入 workspace 进行管理安装 workspace workspace 可以通过安装包进行安装, 安装时只需在安装选项中选择 workspace 即可, 参考安装 BPS 企业版 ; 也可以在上一步安装 governor 时同时安装 workspace 在 workspace 中添加受管引擎 登录 引擎实例管理, 将 ManagedServer1 和 ManagedServer2 添加到 workspace 中, 添加时测试连接是否正常, 保证添加的引擎是可用的, 如图 102

107 图 3-83 添加受管引擎 server1 图 3-84 添加受管引擎 server1 步骤 10. 验证安装 验证集群是否正确安装步骤如下 103

108 1) 启动集群, 登录管理服务器控制台启动管理服务器, 受管服务器, 访问 登录管理服务器的控制台 2) 查看数据源存在用户配置的数据源 依次选择 :Service->JDBC->Data sources, 如图 图 3-85 Data Source 3) 应用正常启动 部署的应用应该能够正常启动, 如图 图 3-86 应用启动 Websphere 集群 Primeton BPS 在 Websphere 应用服务器上搭建过程, 以 Websphere6.1 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 来创建概要文件 104

109 在 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 命令, 创建 Deployment manager, 概要文件名称 ClusterDmgr 创建过程中记录下 ClusterDmgr 的 Administrative console port, 或者在创建完成后在概要文件的 logs 目录下查看 AboutThisProfile.txt 文件 步骤 2. 创建 Application 概要 Application 概要创建过程与 Dmgr 概要过程类似, 只是选择概要类型时候的不同, 按照如上的过程, 创建两个 Application 概要 如果被管在不同的物理机上, 创建 Application Server 时 host name 要填写实际的 IP 地址, 否则会造成添加节点失败 创建 Application server(clusterappsrvs1,clusterappsrvs2), 执行 pmt.sh 命令, 创建两个 Application server, 如下 : 概要文件名称节点名主机名 ClusterAppSrvS1 localhostnodes ClusterAppSrvS2 localhostnodes 注意 : 创建过程中需要记录, 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/ 105

110 #./startserver.sh server1 2. 进入 Dmgr_cluster 控制台 : http// AIX 的 IP: Dmgr_cluster 的 AdmPort /admin, 登录后进入以下菜单进行操作 : 1) 添加节点依次选择 : 系统管理 -> 节点, 点击 < 添加节点 >, 选中 受管节点, 点击 < 下一步 >, 主机 : ClusterAppSrvS1 所在主机 IP,JMX 连接器端口 :ClusterAppSrvS1 的 SOAPPort, 由于创建概要文件时没有设置用户名密码, 因此这里用户名和密码不需要填写, 其它设置默认即可 点击 < 确定 > 完成节点添加 如上方法, 创建受管节点 ClusterAppSrvS2 添加完成后如图所示 : 图 3-87 添加受管节点 注意 : 添加节点时, 被管所在的物理机和主管所在的物理机的系统时间差要在 5 分钟之内, 否则会造成添加节点失败 2) 创建集群并添加成员依次选择 : 服务器 -> 集群, 如图 图 3-88 集群列表 点击 < 新建 >, 创建集群 集群名 :testcluster( 必须和后面 governor 中创建的服务器组名 一致 ), 如图 106

111 图 3-89 创建集群 点击 < 下一步 >, 添加集群成员 s1 成员名 :s1( 和 governor 中服务器名一致 ), 选择节 点 localhostnodes1( 每个成员对应一个节点 ), 其它设置默认即可, 如图 图 3-90 添加集群成员 s1 点击 < 下一步 >, 添加集群成员 s2. 成员名 :s2, 选择节点 localhostnodes2, 点击 < 添加 成员 >, 如图 107

112 图 3-91 点击 < 添加成员 > 108

113 图 3-92 天极成员 s2 点击 < 下一步 >, 点击 < 完成 > 在 消息 提示中, 点击 查看, 勾选 与节点同步更改 复选框, 点击 < 保存 > 图 3-93 与节点同步更改 109

114 与节点同步更改 完成后, 点击 < 确定 >, 完成后如图 图 3-94 创建集群 查看集群拓扑, 如图 图 3-95 集群拓扑结构 3) 删除 server1 依次选择 : 服务器 -> 应用程序服务器, 如图 110

115 图 3-96 应用服务器列表 删除 2 个名称为 server1 的服务器, 保存, 删除后如图 图 3-97 集群服务器 4) 查看被管的 http 端口 环境 -> 虚拟主机 ->default_host-> 主机别名, 查看是否有 s1, s2 的 WC_defaulthost 端口, 如果没有则需要手动添加 如图 : 111

116 图 3-98 主机别名 注意 : 被管服务器的 http 端口不是 profile 中的 http 端口, 而是以 WebSphere 集群中服务器 ( 如本例中的 s1,s2) 的 WC_defaulthost 端口作为 http 端口 如果列表中没有则要手工添加, 然后重启服务器使其生效 WC_defaulthost 端口的查看方法 : 服务器 -> 应用程序服务器, 选择 s2( 或 s1), 在 通信 中点击 端口, 如图 : 112

117 图 3-99 查看端口 步骤 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 和管理端口, 格式如下 : AdminPort=6200 LocalIP=

118 用户应保证 LocalIP 值为受管服务器所在机器的一个真实 IP,AdminPort 值不被其他已部署应用占用 通过管理控制台给每个集群成员服务器配置 JVM 的外置目录参数 EXTERNAL_CONFIG_DIR, 值为外置目录文件夹路径 依次选择 : 服务器 -> 应用程序服务器 ->s1, 点击 进程定义 定制属性 点击 < 新建 >, 设置 s1 的外置目录, 如图 图 s1 外置目录设置 如上述方法, 设置 s2 的外置目录 步骤 5. 通过安装包安装应用到集群步骤如下 : 1) 启动集群 在 WebSphere 集群上安装 BPS 应用, 必须确保集群各服务器已启动 本例中分别运行管理服务器 ClusterDmgr, 被管服务器 ClusterAppSrvS1 ClusterAppSrvS2 各自的启动脚本 ( 位于服务器概要目录下的 bin 子目录下 ), 启动集群的所有服务器, 如图 图 集群启动 2) 运行 BPS 7.5 安装程序, 进入安装界面, 查看介绍, 接受授权协议, 选择安装路径, 如图 114

119 图 选择安装路径 3) 点击 <Next>, 选择应用服务器 选中集群复选框, 在应用服务器下拉框中选中 WebSphere6.1, 在 Deployment Manager Home 行点击 < 浏览 > 选择 Deployment Manager 概要文件目录, 安装包自动读出单元名称 (Cell Name) 和集群名称 (Cluster Name), 在 UserName 和 Password 文本框填写 profile 安全性用户名和密码, 如果没有设置则不需填写, 如图所示, 参数说明, 见下表 表 1-2 WebSphere 集群参数说明 参数 Deployment Manager Home Cell Name Cluster Name User name 说明 Deployment Manager 概要安装目录 例如 :/opt/ibm/websphere/appserver/profiles/clusterdmgr, 该目录为一个 Deployment Manager Home,ClusterDmgr 是用户创建的 Deployment Manager 的名称 管理服务器单元的名称 该参数会在选择正确的 Deployment Manager Home 之后自动填写, 用户无需手动更改 WebSphere 集群名称 该参数会在选择正确的 Deployment Manager Home 之后自动填写, 用户无需手动更改 创建具有管理安全性的 Deployment Manager Profile 时设置的用户名 115

120 参数 PassWord Clustered 说明 创建具有管理安全性的 Deployment Manager Profile 时设置的用户密码 是否集群应用 说明 : 仅当用户选择的应用服务器是 WebLogic9.2 WebLogic10.0 WebLogic10.3 WebSphere6.1 或 WebSphere7 时, 本参数可见 本例中勾选 图 选择服务器 4) 点击 <Next>, 创建应用, 如图 116

121 图 创建应用 5) 点击 <Next>, 配置数据源, 如图 117

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

123 图 停止集群 集群停止后, 停止 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 成员节点 #cd /opt/webspherebps/appserver/profiles/ ClusterAppSrvS2/bin/ #./startnode.sh 所有集群成员启动后, 登录控制台, 启动集群 testcluster 119

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

125 注意 : 向集群中加入多个被管应用, 会将第一个应用中的配置信息作为模板 添加完集群中所有的应用, 除第一个应用外, 所有应用配置文件需要与模板文件进行同步操作, 此时需要重启后来添加的应用以便同步配置文件 5) 在 websphere 管理服务器控制台重新启动集群 6) 查看 governor 中被管应用的状态为已启动 ( 已同步 ), 如图 图 启动应用 ( 已同步 ) 注意 : 向集群中加入多个被管应用, 会将第一个应用中的配置信息作为模板 添加完集群中所有的应用, 除第一个应用外, 所有应用配置文件需要与模板文件进行同步操作, 此时需要重启后来添加的应用以便同步配置文件 BPS 引擎配置 依次选择 :BPS 引擎配置 -> 运行参数配置, 目标选择 testcluster, 选中 是否启用集群 后的复选框, 如图 图 启用集群 注意 : 启用 BPS 引擎集群配置后重启集群 启动过程中, 控制台显示 BPS Cluster Framework is True!, 说明 BPS 引擎集群启用成功, 如图 图 控制台提示集群启用 步骤 9. 加入 workspace 进行管理 121

126 安装 workspace, 安装方法与步骤 9 中安装 governor 相同, 安装选项选择 workspace, 参考安装 BPS 企业版 ; 也可以在第 9 步中同时安装 workspace 在 workspace 中添加受管引擎 登录 引擎实例管理, 将 s1 和 s2 添加到 workspace 中, 添加时测试连接是否正常, 保证添加的引擎是可用的, 如图 图 添加受管引擎 s1 122

127 图 添加受管引擎 s2 添加完成后, 如图 图 受管引擎列表 步骤 10. 验证安装验证集群是否正确安装, 步骤如下 : 1) 启动集群, 登录管理服务器控制台 2) 查看集群中每个受管服务器的 JVM 参数以 s1 为例, 依次选择 : 应用程序服务器 ->s1->(java 和进程管理 ) 进程定义 ->Java 虚拟机 -> 定制属性, 如图 图 JVM 参数 已同样的方法, 查看 s2 的 JVM 参数是否正常 3) 检查数据源 依次选择 : 资源 ->JDBC-> 数据源, 如图 123

128 图 数据源 选中 DefaultDataSource, 点击 < 测试连接 >, 提示测试连接操作时成功的 4) 检查应用是否正常启动 查看应用是否正常启动, 如图 图 应用已经启动 手工部署方式的集群 Primeton BPS 手工部署包通过 JMS 远程消息机制实现了引擎之间集群同步功能 手工部署方式集群配置过程 以 tomcat 为例, 一个 tomcat 服务器作为管理服务器, 部署 governor 和 workspace 应用 ; 另外两个分别部署 BPS 引擎应用 各服务器的信息如下 应用名 所在应用服务器 ip 端口 governor tomcat workspace tomcat bps tomcat bps tomcat 注意 : 如果在同一机器上部署 tomcat 集群, 需要修改 tomcat 的端口, 以保证每个 tomcat 的端口不冲突 建议修改 ${TOMCAT_HOME}\conf\server.xml 文件中的 端口 1) 部署 governor 和 workspace 124

129 在 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 创建集群并添加应用 登录 governor, 默认用户名和密码为 sysadmin 依次选择 : 管理 -> 应用管理, 点击 < 增加应用 >, 如图 图 添加应用 填写应用信息 应用名称 :bps,ip 地址 : , 管理端口号默认为 6200, 用户名默认为 bps, 密码为 , 选择 加入新建的集群, 输入集群名称 testcluster, 点击 < 确定 >, 如图 125

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

131 127

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

133 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 图 6-2 bps.war 目录结构 缺省情况下,BPS 引擎组件在 ${bps.war}/web-inf 目录下, 包括核心 bps-server.jar 等 图 6-3 workspace.war 目录结构 129

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

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

136 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 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 7.5 嵌入式产品的第三方 jar 依赖, 默认都放在 ${bps.war}/web-inf/lib 下 用户开发过程中可以自己调整第三方 jar 的位置 web.xml 配置 增加 Primeton BPS 启动监听器和过滤器配置 <filter> <filter-name>interceptorfilter</filter-name> <filter-class>com.bps.client.user.wfinterceptorfilter</filter-class> </filter> <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> <listener> <listener-class>com.eos.access.http.userobjectsessionlistener</listener-class> 132

137 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 </listener> <filter-mapping> <filter-name>interceptorfilter</filter-name> <url-pattern>/*</url-pattern> <dispatcher>forward</dispatcher> <dispatcher>request</dispatcher> <dispatcher>include</dispatcher> </filter-mapping> <servlet> <servlet-name>controllerservlet</servlet-name> <servlet-class> com.eos.access.http.controllerservlet </servlet-class> <load-on-startup>10</load-on-startup> </servlet> <servlet> <servlet-name>bpsclient</servlet-name> <servlet-class>org.springframework.web.servlet.dispatcherservlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>/wsactivityinstmanagerservice</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>/wsagentmanagerservice</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>/wsappointactivitymanagerservice</url-pattern> </servlet-mapping> 133

138 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>/wsbackactivitymanagerservice</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>/wsdefinitionquerymanagerservice</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>/wsdelegatemanagerservice</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>/wsfreeflowmanagerservice</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>/wsprocessinstmanagerservice</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>/wsrelativedatamanagerservice</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>/wsworkitemdrawbackmanagerservice</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>/wsworkitemmanagerservice</url-pattern> </servlet-mapping> <servlet-mapping> 134

139 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 <servlet-name>controllerservlet</servlet-name> <url-pattern>/wsworklistquerymanagerservice</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>*.flow</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>*.flowx</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>*.gzip</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>*.ajax</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>*.beanx</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>*.debug</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>/common.remote</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> 135

140 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 <url-pattern>*.precompile</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>*.ext</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>controllerservlet</servlet-name> <url-pattern>*.terminate</url-pattern> </servlet-mapping> <servlet> <servlet-name>rifserverservlet</servlet-name> <servlet-class> com.primeton.component.rif.server.http.rifserverservlet </servlet-class> <load-on-startup>11</load-on-startup> </servlet> <servlet-mapping> <servlet-name>rifserverservlet</servlet-name> <url-pattern>/taskpool.service</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>bpsclient</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping> <session-config> <session-timeout>30</session-timeout> </session-config> <welcome-file-list> 136

141 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 <welcome-file>index.jsp</welcome-file> </welcome-file-list> <mime-mapping> <extension>xml</extension> <mime-type>application/xml</mime-type> </mime-mapping> <mime-mapping> <extension>war</extension> <mime-type>application/zip</mime-type> </mime-mapping> <mime-mapping> <extension>ear</extension> <mime-type>application/zip</mime-type> </mime-mapping> <mime-mapping> <extension>zip</extension> <mime-type>application/zip</mime-type> </mime-mapping> <error-page> <error-code>404</error-code> <location>/common/notfound.jsp</location> </error-page> 数据库连接配置 Primeton BPS 7.5 嵌入式产品支持 c3p0 数据源连接和应用服务器的 JNDI 数据源连接 C3p0 数据源连接配置, 内容参考手工部署相关配置 默认数据源配置 ; JNDI 数据源连接配置 : 用户可以通过管理监控应用直接设置或者修改在 user-config.xml 文件中的 DataSource module 新增如下内容 : <group name="default"> <configvalue 137

142 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 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 流程引擎, 需要手工执行数据库初始化脚本 ; 流程引擎正常启动之后, 用户可以通过 Prime ton BPS 7.5 嵌入式产品中的 workspace 应用的管理监控功能初始化数据库 手工部署 BPS 产品 Primeton BPS 7.5 手工部署包提供标准 WAR 应用, 用户通过直接部署方式可以快速了解和学习产品特性, 并且在此基础上开发满足客户需求的应用 手工部署包包括的内容 : 六种服务器对应的 war 及 ear 应用, 数据库初始化脚本 (dbscripts 文件夹 ) 和数据库驱动 jar(syslib 文件夹 ) Tomcat 平台手工部署包支持的 tomcat 版本有 apache-tomcat apache-tomcat Apache-tomcat 和 Apache-tomcat 示例中操作系统为 Windows ( IP : ), 进行手工部署之前需要准备好干净的 tomcat 环境 获取部署包 从 BPS_7.5_Deploy_Package.zip 中获取 Tomcat 对应版本的 bps.war, governor.war, workspace.war bps.ear 部署包 功能 包括 BPS Process Server(BPS 流程引擎 ),BPS Rule Engine(BPS 规则引擎 ) 138

143 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 workspace.ear governor.war 包括 BPS Process Composer(BPS 业务流程定制 ),BPS Rule Composer(BPS 业务规则定制 ), BPS Admin & Monitor(BPS 流程管理监控台 ) 包括 BPS Governor(BPS 引擎治理工具 ) 它是集成 BPS 提供的系统管理工具, 系统管理员可以通过它对 BPS 流程引擎进行配置和管理 创建外置目录在 ${TOMCAT_HOME} 目录下创建 apps_config 目录, 在 apps_config 目录下分别创建 bps, governor,workspace 三个目录, 在三个目录下分别创建 startup.conf 文件, 并分别修改 修改 ${TOMCAT_HOME}/apps_config/bps/startup.conf, 添加如下内容 : AdminPort=6200 LocalIP= 修改 ${TOMCAT_HOME}/apps_config/governor/startup.conf, 添加如下内容 : AdminPort=6299 LocalIP= 修改 ${TOMCAT_HOME}/apps_config/workspace/startup.conf, 添加如下内容 : AdminPort=6399 LocalIP= 注意 :LocalIP 及 AdminPort 需要根据实际情况进行修改, 如果 LocalIP 设为 应用只能在本机访问,AdminPort 使用的端口不能冲突, 否则会造成应用启动失败 修改字符编码修改 ${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" /> 139

144 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 </Service> 配置数据源 本示例中使用的数据库为 mysql5.5 修改 ${TOMCAT_HOME}/conf/server.xml 文件, 修 改如下内容, 红色部分为添加的内容 <GlobalNamingResources> <Resource driverclassname="com.mysql.jdbc.driver" maxactive="4" maxidle="2" maxwait="5000" name="defaultdatasource" password="zhangqin" username="zhangqin" type="javax.sql.datasource" url="jdbc:mysql:// :3306/zhangqin" /> </GlobalNamingResources> 修改 ${TOMCAT_HOME}/conf/context.xml 文件, 添加如下内容, 红色部分为添加的内容 <Context> <ResourceLink global="defaultdatasource" name="defaultdatasource" type="javax.sql.datasource"/> </ Context > 修改 ${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> 140

145 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 </module> 将所用数据库的驱动 jar 拷贝到 ${TOMCAT_HOME}/lib 目录下 如果应用服务器是 tomcat6 以下, 则需要将 jar 文件拷贝到 ${TOMCAT_HOME}/common/lib 目录下 数据库驱动可以 BPS_7.5_Deploy_Package.zip/syslib 下获取 修改启动参数为 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= F:\work\apache-tomcat \apps_config set JAVA_OPTS=%JAVA_OPTS% -DEXTERNAL_CONFIG_DIR=%EXTERNAL_CONFIG_DIR%... 其中, 变量 EXTERNAL_CONFIG_DIR 是外置目录, 值为用户配置的外置目录的路径 初始化数据库执行 BPS_7.5_Deploy_Package.zip/dbscripts 目录下对应数据库的 sql 脚本, 如果是 oracle 数据库, 不需要对 oracle 目录下 etl 目录下的 sql 初始化 部署 war 文件将 BPS_7.5_Deploy_Package/tomcat 下的 bps.war workspace.war 和 BPS_7.5_Deploy_Package/governor.war 三个 war 文件放到 ${TOMCAT_HOME}/webapps 下 配置 license 需要将准备的 primetonlicense.xml 文件放到如下外置目录下 ( 需要创建目录 ): ${ TOMCAT _HOME}/apps_config/bps/license ${ TOMCAT _HOME}/apps_config/governor/license ${ TOMCAT _HOME}/apps_config/workspace/license 141

146 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 注 : 不自己创建目录也可以, 服务器启动后会自动生成目录, 但是启动服务会报错缺少 license, 所以可以提前放入 license 启动服务运行 ${TOMCAT_HOME}/bin/startup.bat 启动服务器, 可以正常启动, 对应外置目录 apps_config 下对应应用的目录结构, 如图 : Jboss 平台 获取部署包从 BPS_7.5_Deploy_Package.zip 中获取 jboss 对应版本的 bps.ear,governor.war, workspace.ear 部署包 bps.ear workspace.ear governor.war 功能包括 BPS Process Server(BPS 流程引擎 ),BPS Rule Engine(BPS 规则引擎 ) 包括 BPS Process Composer(BPS 业务流程定制 ),BPS Rule Composer(BPS 业务规则定制 ), BPS Admin & Monitor(BPS 流程管理监控台 ) 包括 BPS Governor(BPS 引擎治理工具 ) 它是集成 BPS 提供的系统管理工具, 系统管理员可以通过它对 BPS 流程引擎进行配置和管理 创建外置目录在 ${JBOSS_HOME} 目录下创建 apps_config 目录, 在 apps_config 目录下分别创建 bps,governor,workspace 三个目录, 在三个目录下分别创建 startup.conf 文件, 并分别修改 修改 ${JBOSS_HOME}/apps_config/bps/startup.conf, 添加如下内容 : AdminPort=

147 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 LocalIP= 修改 ${JBOSS_HOME}/apps_config/governor/startup.conf, 添加如下内容 : AdminPort=6299 LocalIP= 修改 ${JBOSS_HOME}/apps_config/workspace/startup.conf, 添加如下内容 : AdminPort=6399 LocalIP= 注意 :LocalIP 及 AdminPort 需要根据实际情况进行修改, 如果 LocalIP 设为 应用只能在本机访问,AdminPort 使用的端口不能冲突, 否则会造成应用启动失败 配置数据源本示例中使用的数据库为 mysql5.5 在 ${JBOSS_HOME}/server/default/deploy 目录下创建 *-ds.xml 文件, 这里创建的文件名为 DefaultDataSource-ds.xml, 添加如下内容 <?xml version="1.0" encoding="utf-8"?> <local-tx-datasource> <jndi-name>defaultdatasource</jndi-name> <connection-url>jdbc:mysql:// :3306/zhangqin</connection-url> <driver-class>com.mysql.jdbc.driver</driver-class> <connection-property name="user">zhangqin</connection-property> <connection-property name="password">zhangqin</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"> 143

148 Primeton BPS 7.5 产品安装指南第 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> 将所用数据库的驱动 jar 拷贝到 ${JBOSS_HOME}/server/default/lib 目录下 数据库驱动可以 BPS_7.5_Deploy_Package.zip/syslib 下获取 修改启动参数修改 ${JBOSS_HOME}/bin/run.conf, 在文件最后位置添加如下内容 JAVA_OPTS="$JAVA_OPTS -Xms128m -Xmx512m -XX:MaxPermSize=128m -XX:+HeapDumpOnOutOfMemoryError" 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= F:\work\jboss\jboss GA\apps_config set JAVA_OPTS=%JAVA_OPTS% -DEXTERNAL_CONFIG_DIR=%EXTERNAL_CONFIG_DIR% 其中, 变量 EXTERNAL_CONFIG_DIR 是外置目录, 值为用户配置的外置目录的路径 初始化数据库执行 BPS_7.5_Deploy_Package.zip/dbscripts 目录下对应数据库的 sql 脚本 如果是 oracle 数据库的话, 不需要对该目录下 etl 目录下的 sql 进行初始化 部署 war 文件在 ${JBOSS_HOME}/server/default/deploy 下创建文件夹 bps.ear workspace.ear 和 governor.war, 将 Primeton_BPS_7.5_Deploy_Package\jboss 中的 bps.ear 和 workspace.ear 中的文件分别解压到 bps.ear 和 workspace.ear 目录下, 然后将 workspace.ear 文件下的 workspace.war 解压成 workspace.war 文件, 还有将 bps.ear 文件下的 bps.war 解压成 bps.war 144

149 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 文件 ; 同样将 Primeton_BPS_7.5_Deploy_Package/governor.war 中的文件解压到 ${JBOSS_HOME}/server/default/deploy 下的 governor.war 目录中 解压后, 还需要对 war 包中 WEB-INF\lib 目录下文件稍做修改, 做如下操作 jboss4 应用 需要删除的 jar (WEB-INF\lib) Governor.war xercesimpl jar xml-apis jar log4j jar JBOSS 5 做如下操作 应用 需要删除的 jar 需要添加的 jar 需要修改的 jar(web-inf\lib) ((WEB-INF\lib)) ( 从 BPS_7.5_Deploy_ Package.zip/syslib/jb oss 下获取 ) bps.war xalan jar stax-api jar cglib jar 删除 eos-server-access-ejb jar \META-INF 下的 ejb-jar.xml 和 jboss.xml Workspace.wa r 同上 cglib jar 同上 Governor.war xalan jar stax-api jar xercesimpl jar xml-apis jar 同上 JBOSS 6( 需要将 jdom-1.0.jar 放到 ${JBOSS_HOME}/server/default/lib 下 ) 145

150 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 应用 需要删除的 jar 需要添加的 jar( 从 需要修改的 jar(web-inf\lib) (WEB-INF\lib) BPS_7.5_Deploy_Packa ge.zip/syslib/jboss 获 取 ) bps.war xalan jar cglib jar 删除 stax-api jar jaxen jar eos-server-access-ejb j ar \META-INF 下的 ejb-jar.xml 和 jboss.xml jdom-1.0.jar workspace.war xalan jar cglib jar 删除 stax-api jar jaxen jar eos-server-access-ejb j ar \META-INF 下的 ejb-jar.xml 和 jboss.xml jdom-1.0.jar Governor.war xalan jar 删除 stax-api jar xercesimpl jar eos-server-access-ejb j ar\meta-inf 下的 ejb-jar.xml 和 jboss.xml xml-apis j ar 修改配置文件 JBOSS4: 修改 ${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> 146

151 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 <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">true</attribute> <attribute name="callbyvalue">true</attribute> </mbean> </server> JBOSS 5: 修改 ${JBOSS_HOME}/server/default/deployers/ear-deployer-jboss-beans.xml 文件, 将 Isolated 和 CallByValue 的值改为 true <property name="callbyvalue">true</property> <property name="isolated">true</property> JBOOS6: 修改 ${JBOSS_HOME}/server/default/deployers/ear-deployer-jboss-beans.xml 文件, 将 Isolated 和 CallByValue 的值改为 true 147

152 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 <property name="callbyvalue"> true </property> <property name="isolated"> true </property> 分别删除 bps.ear/bps.war governor.war workspace.ear/workspace.war 的 \WEB-INF\_srv\work 目录下所有以的 *.class 结尾的文件 配置 license 将准备的 primetonlicense.xml 文件放到如下外置目录下 ( 目录需要创建 ): ${ JBOSS _HOME}/apps_config/bps/license ${ JBOSS _HOME}/apps_config/governor/license ${ JBOSS _HOME}/apps_config/workspace/license 注 : 不自己创建目录也可以, 服务器启动后会自动生成目录, 但是启动服务会报错缺 少 license, 所以可以提前放入 license 启动服务器 运行 ${JBOSS_HOME}/bin/run.bat 启动服务器, 可以正常启动, 对应外置目录 apps_config 下对应应用的目录结构, 如图 : WebLogic 平台手工部署包支持的 WebLogic 版本有 WebLogic9.2 WebLogic10.0 WebLogic10.3 和 WebLogic11g(10.3.5) 示例使用 WebLogic 10.3 linux(ip= ) 操作系统, 步骤如下 : 148

153 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 获取部署文件 从 BPS_7.5_Deploy_Package.zip 中获取 WebLogic 对应版本的 bps.ear,governor.war, workspace.ear 部署包 bps.ear workspace.ear governor.war 功能包括 BPS Process Server(BPS 流程引擎 ), BPS Rule Engine(BPS 规则引擎 ) 包括 BPS Process Composer(BPS 业务流程定制 ),BPS Rule Composer(BPS 业务规则定制 ),BPS Admin & Monitor(BPS 流程管理监控台 ) 包括 BPS Governor(BPS 引擎治理工具 ) 它是集成 BPS 提供的系统管理工具, 系统管理员可以通过它对 BPS 流程引擎进行配置和管理 创建 WebLogic domain 创建一个 WebLogic domain 用于部署各应用 ( 创建 WebLogic domain 的方法请参考相关文 档, 这里不再介绍 ) WebLogic domain 的主要参数如下 : 参数名 User name 参数值 Package_domain User password name(administration Server) AdminServer Listen address Listen port 7001 Domain name Domain location weblogic /opt/bea1035_gc/user_projects/domains/weblogic 创建外置目录在 ${DOMAIN_HOME} 目录下创建 apps_config 目录, 在 apps_config 目录下分别创建 bps,workspace,governor 三个文件夹, 在三个文件夹下分别创建 startup.conf 文件 修改 ${DOMAIN_HOME}/apps_config/bps/startup.conf, 添加如下内容 LocalIP= AdminPort=6200 修改 ${DOMAIN_HOME}/apps_config/governor/startup.conf, 添加如下内容 149

154 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 LocalIP= AdminPort=6299 修改 ${DOMAIN_HOME}/apps_config/workspace/startup.conf, 添加如下内容 LocalIP= AdminPort=6399 注意 :LocalIP 及 AdminPort 需要根据实际情况进行修改, 如果 LocalIP 设为 应用只能在本机访问,AdminPort 使用的端口不能冲突, 否则会造成应用启动失败 配置 license 将准备的 primetonlicense.xml 文件放到如下外置目录下 : ${ DOMAIN _HOME}/apps_config/bps/license ${ DOMAIN _HOME}/apps_config/governor/license ${ DOMAIN _HOME}/apps_config/workspace/license 解压应用到 applications 文件夹下在 ${DOMAIN_HOME} 目录下创建 applications 目录, 将 bps.ear governor.war 和 workspace.ear 解压到 applications 目录下 解压后的目录结构如图 : 图 1 bps.ear 目录结构 图 2 workspace.war 目录结构 150

155 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 图 3 governor.war 目录结构 如果是部署在 AIX + Weblogic 平台上, 请参见附录 H 拷贝 jar 文件将所使用的数据库的驱动 jar 拷贝到 ${DOMAIN_HOME}/lib 目录下 ( 可以在 BPS_7.5_Deploy_Package.zip/syslib 下获取 ) 如果使用 SqlServer2000 或 2005, 请参见附录 G 注意 : 如果应用服务器是 weblogic11g, 需要将 ${WEBLOGIC_HOME}/modules/ 目录下的 commonj.sdo_ _1-0.jar 删除, 并将 org.eclipse.persistence_ _2-1.jar 中的 commonj 包删除 修改启动脚本修改 ${DOMAIN_HOME}/bin/startWebLogic.sh 文件, 添加如下内容 其中, 变量 EXTERNAL_CONFIG_DIR 是外置目录, 值为用户配置的外置目录的路径 #!/bin/sh #!/bin/sh export EXTERNAL_CONFIG_DIR="/opt/bea1035_gc/user_projects/domains/package_domain/apps_c onfig" JAVA_OPTIONS="${JAVA_OPTIONS} -DEXTERNAL_CONFIG_DIR=${EXTERNAL_CONFIG_DIR}" export JAVA_OPTIONS 如果操作系统是 windows 系统, 修改 ${DOMAIN_HOME}/startWebLogic.cmd 文件, 添加如下内容 OFF set EXTERNAL_CONFIG_DIR=C:\bea103\user_projects\domains\base_domain\apps_config set JAVA_OPTIONS=%JAVA_OPTIONS% -DEXTERNAL_CONFIG_DIR=%EXTERNAL_CONFIG_DIR% 配置数据源 151

156 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 执行 startweblogic.sh, 启动服务器 ( 如果操作系统为 windows 系统, 执行 startweblogic.cmd) 访问 登录控制台 其中, 是本机的 ip,7001 是创建 domain 时的监听端口, 用户名和密码是创建 domain 时设置的用户名和密码 创建数据源 : 依次选择 :Services->JDBC->Data Source, 点击 <New> 新建数据源, 如图 图 4 创建数据源 1 填写 Name:DefaultDataSource,JNDI Name:DefaultDataSource,Database Type 选择 Oracle,Database Driver 选择 Oracle s Driver (Thin), 点击 <Next> 保持默认设置, 再次点击 <Next> 152

157 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 图 5 创建数据源 2 填写数据库连接的详细信息, 点击 <Next>, 查看已配置的信息是否有误, 点击 <Test Configuration> 提示 Connection test succeeded., 点击 <Next>, 如图 图 6 创建数据源 3 选中 AdminServer, 点击 <Finish> 完成数据源创建, 如图 153

158 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 图 7 数据源列表 修改 ${bps.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 文件中有这些配置信息, 则不用再添加 对应用修改 ${ DOMAIN_HOME}/applications/governor.war 下还需要对 governor.war 中 WEB-INF\lib 目录下文件稍做修改 154

159 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 应用 Governor.war 需要删除的 jar (WEB-INF\lib) xml-apis jar 在控制台安装应用在左侧树中选择 Deployments, 点击 <Install> 控制台会列出当前 domain 下的所有文件夹, 选择 applications 选中 bps.ear, 点击 <Next>, 选中 Install this deployment as an application, 点击 <Next>, 保持默认, 点击 <Finish> 以同样的方式安装 governor.war 和 workspace.ear 初始化数据库执行 BPS_7.5_Deploy_Package.zip/dbscripts 目录下对应数据库的 sql 脚本 如果是 oracle 数据库不需要初始化其目录下的 etl 文件下的 sql WebSphere 平台手工部署包支持的 WebSphere 版本有 WebSphere WebSphere 和 WebSphere 示例中的部署环境为 WebSphere linux(ip= ) 操作系统, 步骤如下 : 获取部署文件从 BPS_7.5_Deploy_Package.zip 中获取 WebSphere 对应版本的 bps.ear, governor.war,workspace.ear bps.ear 部署包 workspace.ear 功能包括 BPS Process Server(BPS 流程引擎 ), BPS Rule Engine(BPS 规则引擎 ) 包括 BPS Process Composer(BPS 业务流程定制 ),BPS Rule Composer(BPS 业务规则定制 ),BPS Admin & Monitor(BPS 流程管理监控台 ) 155

160 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 governor.war 包括 BPS Governor(BPS 引擎治理工具 ) 它是集成 BPS 提供的系统管理工具, 系统管理员可以通过它对 BPS 流程引擎进行配置和管理 创建概要文件请用户提前准备好概要文件 (Application server), 创建概要文件详细步骤这里不再介绍 创建外置目录在 ${PROFILE_HOME} 目录下创建 apps_config 目录, 在 apps_config 目录下分别创建 bps,workspace,governor 三个文件夹, 在三个文件夹下分别创建 startup.conf, 修改三个 startup.conf 修改 ${PROFILE_HOME}/apps_config/bps/startup.conf, 添加如下内容 LocalIP= AdminPort=6200 修改 ${PROFILE_HOME}/apps_config/governor/startup.conf, 添加如下内容 LocalIP= AdminPort=6299 修改 ${PROFILE_HOME}/apps_config/workspace/startup.conf, 添加如下内容 LocalIP= AdminPort=6399 注意 :LocalIP 及 AdminPort 需要根据实际情况进行修改, 如果 LocalIP 设为 应用只能在本机访问,AdminPort 使用的端口不能冲突, 否则会造成应用启动失败 配置 JVM 参数启动服务器, 访问 进入 websphere 控制台, 其中 是本机 ip,9071 是控制台管理端口 依次选择 : 服务器 -> 应用服务器 ->server1, 点击 Java 和进程管理 下的 进程定义, 点击 Java 虚拟机, 点击 定制属性 新建如下 JVM 参数 名称 EXTERNAL_CONFIG_DIR JCEProvider 值 /opt/ibm/websphere/appserver/profiles/ap psrvdeploy/apps_config IBMJCE 156

161 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 Xgcpolicy com.ibm.websphere.orb.uniqueserve rname java.awt.headless java.net.preferipv4stack javax.xml.soap.saajmetafactory gencon true true true com.sun.xml.messaging.saaj.soap.saajmeta FactoryImpl 配置完成后如图 图 8 配置 JVM 参数 配置 Web 容器参数依次选择 : 服务器 -> 应用服务器 ->server1, 点击 Web 容器设置 下的 Web 容器, 点击 定制属性, 点击 < 新建 >, 新建 Web 容器属性 名称 :com.ibm.ws.webcontainer.invokefilterscompatibility, 值 :true, 如图 图 9 配置 Web 容器参数 157

162 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 配置数据源 a) 创建 JDBC 提供程序依次选择 : 资源 ->JDBC->JDBC 提供程序, 作用域选择 节点 =localhostnodebps, 服务器 =server1, 点击 < 新建 >, 示例中数据库类型选择 Oracle, 提供程序类型选择 Oracle JDBC Driver, 实施类型选择 连接池数据源, 输入名称 Oracle JDBC Driver ( 可根据需要修改 ), 如图 图 10 JDBC 提供程序参数 158

163 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 点击 < 下一步 >, 输入类路径为 /opt/ibm/websphere/appserver/lib/ext, 同时将数 据库驱动拷贝到该路径下, 如图 图 11 数据库类路径点击 < 下一步 >, 检查所有信息无误后, 点击 < 完成 > 并保存 数据库驱动可以 BPS_7.5_Deploy_Package.zip/syslib 下获取 创建好之后, 点击创建好的 Oracle JDBC Driver, 进入界面, 将类路径的 /ojdbc14.jar 去掉 说明 : 如需运行在 MS Sqlserver 2005 数据库上, 请注意 JDBC 驱动名称及 URL, 参见附录 G b) 创建 J2C 认证数据 159

164 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 依次选择 : 安全性 -> 安全管理 应用程序和基础结构, 选择 Java 认证和授权服务 下的 J2C 认证数据, 如图 图 12 J2C 认证数据 1 点击 < 新建 >, 输入如下信息, 其中别名是为该数据认证的名称, 用户标识是数据库 的用户名, 密码为数据库的密码 图 13 J2C 认证数据 2 160

165 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 点击确定并保存, 如图 图 14 J2C 认证数据 3 c) 创建数据源依次选择 : 资源 ->JDBC-> 数据源, 作用域选择 节点 =localhostnodebps, 服务器 =server1, 点击 < 新建 >, 输入数据源名称为 DefaultDataSource,JNDI 名称为 DefaultDataSource, 认证别名选择选择之前创建的认证数据 jass_oracle, 如图 图 15 数据源基本信息 161

166 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 这里 DefaultDataSource 是对应 bps.war/web-inf/_srv/config/user-config.xml 里的 Jndi-Name 如果用户使用自定义数据源名称, 请同时修改 user-config.xml 里的 Jndi-Name 如下所示 : <!--system default datasouce --> <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> 点击 < 下一步 >, 选择之前创建的 JDBC 提供程序 Oracle JDBC Driver, 如图 图 16 选择提供程序 162

167 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 点击 < 下一步 >, 输入 URL, 并选择和数据库版本对应的 helper 类名, 如图 图 17 输入数据库属性 点击 < 下一步 >, 查看所有信息没有错误后, 点击 < 完成 > 并保存 创建完成后, 数据源如图 安装应用 图 18 数据源列表 163

168 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 以安装 governor.war 为例, 依次选择 : 应用程序 -> 企业应用程序, 点击 < 安装 >, 选 择应用的路径, 并填写上下文根为 governor, 如图 图 19 选择应用程序 点击 < 下一步 >, 修改应用名为 governor, 如图 图 20 应用程序名 在 将模块映射至服务器 中选择所有模块, 如图 图 21 将模块映射至服务器 164

169 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 点击 < 下一步 >, 检查总结信息没有错误点击 < 完成 > 部署完成后, 点击保存 以同样的方法将 workspace.ear 和 bps.ear 安装到服务器,bps 和 workspace 不需要 输入上下文, 如下图, 一直默认点击 < 下一步 > 直至完成安装 修改类装载顺序 应用安装完成后, 需要为 governor bps 和 workspace 应用修改类加载顺序, 这里 以 bps 应用为例 165

170 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 在应用列表中点击 bps 应用, 如图 点击 类装入和更新检测, 如图 图 22 应用配置 图 23 类装入器配置 166

171 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 输入 更新的文件的轮询时间间隔 为 60 秒, 选择 类已装入并且是先使用应用程序类装入器, 点击 < 确定 > 更新的文件的轮询时间间隔 必须输入, 需要注意的是, 只有 更新应用程序文件时重新装入类 选中时, 设置的轮询时间间隔才会生效, 这里只是为了设置类装入器顺序 在配置界面点击 管理模块, 如图 点击 <bps.war>, 如图 图 24 模块列表 图 25 bps.war 配置 167

172 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 在 类装入器顺序 列表中选择 类已装入并且是先使用应用程序类装入器, 点击 < 确定 >, 并保存 按照以上步骤, 设置 governor 和 workspace 应用的类加载顺序 重新启动服务器, 应用自动启动 初始化数据库执行 BPS_7.5_Deploy_Package.zip/dbscripts 目录下对应数据库的 sql 脚本 oracle 数据库不需要执行其目录下 etl 文件里的 sql 对应用修改 ${ PROFILE _HOME}/installedApps/localhostNode02Cell/governor.war 下还需要对 governor.war 中 WEB-INF\lib 目录下文件稍做修改 应用 需要删除的 jar (WEB-INF\lib) Governor.war xercesimpl jar xml-apis jar 启动服务器, 添加 license 启动服务后, 会看到相关 license 的错, 需要将准备的 primetonlicense.xml 文件放到如下外置目录下 : ${ PROFILE _HOME}/apps_config/bps/license ${ PROFILE _HOME}/apps_config/governor/license ${ PROFILE _HOME}/apps_config/workspace/license 重启服务, 可以正常启动 Pas 平台手工部署包支持的 pas6.0 版本 示例中的 pas 版本为 pas6.0, 操作系统为 windows(ip: ), 进行手工部署之前需要准备好干净的 pas 环境, 以及申请所需 license 文件 primetonlicense.xml 获取部署文件从 BPS_7.5_Deploy_Package.zip 中获取 pas 对应版本的 bps.ear,governor.war, workspace.ear 168

173 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 部署包 bps.ear workspace.ear governor.war 功能包括 BPS Process Server(BPS 流程引擎 ), BPS Rule Engine(BPS 规则引擎 ) 包括 BPS Process Composer(BPS 业务流程定制 ),BPS Rule Composer(BPS 业务规则定制 ),BPS Admin & Monitor(BPS 流程管理监控台 ) 包括 BPS Governor(BPS 引擎治理工具 ) 它是集成 BPS 提供的系统管理工具, 系统管理员可以通过它对 BPS 流程引擎进行配置和管理 创建外置目录在 ${PAS_HOME} 目录下创建 apps_config 目录, 在 apps_config 目录下分别创建 bps, governor,workspace 三个目录, 在三个目录下分别创建 startup.conf 文件, 并分别修改 修改 ${ PAS _HOME}/apps_config/bps/startup.conf, 添加如下内容 : AdminPort=6200 LocalIP= 修改 ${ PAS _HOME}/apps_config/governor/startup.conf, 添加如下内容 : AdminPort=6299 LocalIP= 修改 ${ PAS _HOME}/apps_config/workspace/startup.conf, 添加如下内容 : AdminPort=6399 LocalIP= 注意 :LocalIP 及 AdminPort 需要根据实际情况进行修改, 如果 LocalIP 设为 , 那应用只能在本机访问,AdminPort 使用的端口不能冲突, 否则会造成应用启动失败 配置数据源为应用配置数据源, 修改 bps.ear/bps.war/web-inf/_srv/config/user-config.xml 中 default 数据源配置, 将 JNDI 数据源修改为如下 c3p0 数据源, 并 BPS_7.5_Deploy_Package/syslib 下对应数据库驱动包拷贝到 ${PAS_HOME}/pas-6.0/var/shared/lib 文件夹中 <group name="default"> <configvalue key="database-type">oracle</configvalue> 169

174 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 <configvalue key="jdbc-type"/> <configvalue key="c3p0-driverclass">oracle.jdbc.driver.oracledriver</configvalue> <configvalue key="c3p0-url">jdbc:oracle:thin:@ :1521:eos</configvalue> <configvalue key="c3p0-username">fengye</configvalue> <configvalue key="c3p0-password">fengye</configvalue> <configvalue key="c3p0-poolsize">5</configvalue> <configvalue key="c3p0-maxpoolsize">5</configvalue> <configvalue key="c3p0-minpoolsize">5</configvalue> <configvalue key="transaction-isolation">isolation_default</configvalue> <configvalue key="test-connect-sql">select count(*) from EOS_UNIQUE_TABLE</configValue> <configvalue key="retry-connect-count">-1</configvalue> </group> 修改启动参数为 pas 配置 JVM 参数并添加外置目录参数, 修改 ${PAS_HOME}/startServer.sh, 红色部分为添加内容 #!/bin/sh export EXTERNAL_CONFIG_DIR= /feng/pas6.0/apps_config export JAVA_OPTS="${JAVA_OPTS} ${GC_OPTS} -DEXTERNAL_CONFIG_DIR=$EXTERNAL_CONFIG_DIR"... 如果是在 windows 环境下, 修改 ${ PAS _HOME}/startServer.cmd, off set EXTERNAL_CONFIG_DIR=C:\feng\pas6.0\apps_config set JAVA_OPTS=%JAVA_OPTS% %GC_OPTS% -DEXTERNAL_CONFIG_DIR=%EXTERNAL_CONFIG_DIR%... 其中, 变量 EXTERNAL_CONFIG_DIR 是外置目录, 值为用户配置的外置目录的路径 初始化数据库执行 Primeton_BPS_7.5_Deploy_Package.zip/dbscripts 目录下对应数据库的 sql 脚本, 如果是 oracle 数据库, 不需要初始化其目录下 etl 下的 sql 配置 license 将准备的 primetonlicense.xml 文件放到如下外置目录下 : 170

175 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 ${ PAS _HOME}/apps_config/bps/license ${ PAS _HOME}/apps_config/governor/license ${ PAS _HOME}/apps_config/workspace/license 部署应用 部署之前对 governor.war,web-inf\lib 目录下文件稍做修改 应用 Governor.war 需要删除的 jar (WEB-INF\lib) xml-apis jar 运行 ${PAS_HOME}/startup.bat 启动服务器, 打开浏览器输入地址 输入正确端口号,8080 为默认端口号, 用户名 system, 密码 manager) 登录 pas 控制台, 点击 应用 > 部署应用, 选择归档文件部署 governor.war bps.ear workspace.ear, 部署成功后外置目录 spps_config 对应应用下目录结构如图 : Tongweb 平台手工部署包支持的 TongWeb 版本为 TongWeb5.0 示例中的 TongWeb 版本 TongWeb , 操作系统为 win8(ip: ), 进行手工部署之前需要准备好干净的 TongWeb 环境 创建外置目录在 ${TONGWEB_HOME} 目录下创建 apps_config 目录, 在 apps_config 目录下分别创建 bps_war,governor,workspace_war 三个目录, 在三个目录下分别创建 startup.conf 文件, 并分别修改 修改 ${TONGWEB_HOME}/apps_config/bps_war/startup.conf, 添加如下内容 : AdminPort=6200 LocalIP=

176 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 修改 ${TONGWEB_HOME}/apps_config/governor/startup.conf, 添加如下内容 : AdminPort=6299 LocalIP= 修改 ${TONGWEB_HOME}/apps_config/workspace_war/startup.conf, 添加如下内容 : AdminPort=6399 LocalIP= 注意 :LocalIP 及 AdminPort 需要根据实际情况进行修改, 如果 LocalIP 设为 应用只能在本机访问,AdminPort 使用的端口不能冲突, 否则会造成应用启动失败 修改启动脚本修改 ${TONGWEB_HOME}/bin/startserver.bat 文件, 添加如下内容 其中, 变量 EXTERNAL_CONFIG_DIR 是外置目录, 值为用户配置的外置目录的路径 set EXTERNAL_CONFIG_DIR=D:\primetonTest\bpstest\TongWeb5.0\apps_config set JAVA_OPTS=%JAVA_OPTS% -DEXTERNAL_CONFIG_DIR=%EXTERNAL_CONFIG_DIR% 如果操作系统是 Linux 系统, 修改 ${TONGWEB_HOME}/bin/startserver.sh 文件, 添加 如下内容 : export EXTERNAL_CONFIG_DIR="/tongweb5.0/apps_config" JAVA_OPTS="${JAVA_OPTS} -DEXTERNAL_CONFIG_DIR=${EXTERNAL_CONFIG_DIR} export JAVA_OPTS 配置数据源启动服务器, 访问 用户名 :twns 密码 :twns, 进入 TongWeb 控制台, 其中 9060 是控制台管理端口 依次选择 : 资源 ->JDBC->JDBC 连接池, 点击 < 创建 >, 创建 JDBC 连接池, 在该实例中名称设置 oracle, 资源类型选择 javax.sql.datasource, 数据库类型选择 Oracle Type 4 Driver for Oracle 8.1.7,9.0.1,9.2.0 ( 可根据需要修改 ), 如图 172

177 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 点击 < 下一步 >, 分别输入数据库连接 驱动包文件的路径 ( 具体指到驱动 jar) 用 户名及密码 点击 < 创建 >, 建立连接池完毕 数据库驱动可以 Primeton_BPS_7.5_Deploy_Package.zip/syslib 下获取 依次选择 : 资源 ->JDBC->JDBC 资源, 点击 < 创建 >, 创建 JDBC 资源,JNDI 名称设 置 DefaultDataSource, 连接池名称选择刚刚创建的对应的连接池名称, 点击 < 创建 >, 如图 这里 DefaultDataSource 需对应 bps.ear/bps.war/web-inf/_srv/config/user-config.xml 里的 Jndi-Name 当用户 使用自定义数据源名称时, 需同时修改 user-config.xml 里的 Jndi-Name 173

178 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 配置 license 将准备的 primetonlicense.xml 文件放到如下外置目录下 ( 需要创建目录 ): ${ TONGWEB _HOME}/apps_config/bps_war/license ${ TONGWEB _HOME}/apps_config/governor/license ${ TONGWEB _HOME}/apps_config/workspace_war/license 注 : 不自己创建目录也可以, 服务器启动后会自动生成目录, 但是启动服务会报错 缺少 license, 所以可以提前放入 license 部署 war 文件 以安装 bps.ear 为例, 依次选择 : 应用 -> 应用管理 -> 企业应用, 点击 < 部署 >, 选择 本地部署, 点击 < 浏览文件 >, 选择 bps.ear 文件后点击 < 部署 >, 如图 174

179 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 部署完成后如下图所示 workspace.ear 的部署方式与 bps.ear 相同,governor.war 使用 Web 应用部署, 操作相同 部署完成后可通过点击 <http 访问 > 验证部署是否成功, 两种应用的访问方式分别如 下 初始化数据库执行 BPS_7.5_Deploy_Package.zip/dbscripts 目录下对应数据库的 sql 脚本, 如果是 oracle 数据库, 则不需要对其下 etl 文件下的 sql 初始化 启动服务运行 ${TONGWEB _HOME}/bin/startserver.bat 启动服务器, 外置目录 spps_config 对应应用下目录结构如图 : BPS 引擎应用管理将默认应用添加到 governor 和 workspace 进行管理 1) 将默认应用添加到 governor 登录 governor, 默认用户名为 sysadmin, 密码为 登录后, 依次选择 : 管理 -> 应用管理, 如图 175

180 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 图 6-6 governor 应用管理 点击 < 增加应用 >, 如下图 图 6-7 填写应用信息 填写应用详细信息, 其中应用名称为 bps, 管理端口为 6200( 即 startup.conf 中的 AdminPort), 用户名为 bps, 密码为 , 选择 作为非集群应用 点击 < 确定 >, 如图 图 6-8 已添加的应用 添加完成后, 可以在 governor 中对应用进行管理 176

181 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 2) 将默认应用添加到 workspace 登录 workspace 的 引擎实例管理, 默认用户名为 sysadmin, 密码为 点击 受 管引擎配置, 点击 < 添加 > 按钮, 如图 图 6-9 添加受管引擎 填写受管引擎信息, 其中逻辑名称必须为 default, 用户名为 bps, 密码为 点 击 < 测试连接 >, 提示 连接成功!, 点击 < 确定 > 完成受管引擎添加 如图 图 6-10 引擎实例列表在 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> 177

182 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 <description></description> <uddihost> </uddihost> <uddiport>7001</uddiport> <uddiwebcontext>bps</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 引擎的应用名称 BPS 引擎的默认用户是 bps uddipassword BPS 引擎的默认用户密码是 description BPS 引擎描述 系统管理员密码配置修改 workspace 管理员密码登录 workspace 的 引擎实例管理, 默认用户名为 sysadmin, 密码为 点击 修改登录口令, 如图 178

183 Primeton BPS 7.5 产品安装指南第 4 章 BPS 手工部署包 图 6-11 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-12 governor 密码修改配置 179

184 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 第 4 章卸载 BPS 卸载 Primeton BPS 7.5 的注意事项如下 : 1) 一旦删除 Primeton BPS 将不能恢复 2) 删除前需要中止 BPS Server 4.1 卸载开发版 Primeton BPS 7.5 开发版的卸载, 步骤如下 : 1) 运行 ${BPS_HOME}\uninstall\uninstall.cmd, 如图 图 4-1 卸载简介 2) 点击 < 下一步 >, 如果要保留默认工作区的内容, 需要勾选 保留开发环境默认工作区 的内容, 如图 180

185 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 3) 点击 < 下一步 >, 开始卸载, 如图 图 4-2 卸载选项 181

186 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 图 4-3 卸载中 4) 卸载完成, 如图 182

187 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 图 4-4 卸载完成 4.2 卸载企业版 企业版的卸载, 由于企业版是和应用服务器装在一起的, 所以产品没有提供卸载工具 如 果想卸载企业版, 可以通过下面三步 : 1) 通过应用服务器的控制台停止并卸载应用 2) 通过数据库客户端工具删除相应的表或者数据库表空间 3) 删除企业版安装目录 ( 如果是手工部署安装, 则删除外置配置目录 ) 183

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

189 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 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_remote.war: 客户端部署用的 war 包 解压后的目录结构如下 : 目录说明 : WEB-INF: web.xml bpsclient-web.xml 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: 表单资源文件 185

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

191 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 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: 日历标签 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: 页面图片 187

192 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 WebRoot/wfclient/js:JavaScript 脚本 WebRoot/wfclient/frame: 主页面框架 WebRoot/wfclient/user: 用户登录功能页面 WebRoot/wfclient/process: 流程启动功能页面 WebRoot/wfclient/task: 我的任务功能页面 WebRoot/wfclient/agent: 代理功能页面 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 系统提供的 ) 5.3 部署 使用提供的 war 包 :bpsclient.war 部署的目标环境 BPS 引擎应用内 BPS 引擎应用外 : 分为已安装 BPS 平台和未安装 BPS 平台两种特别说明 : 已安装 BPS 平台的, 如果是手工部署, 并且是 BPS 引擎应用外, 则认为跟未安装 BPS 平台一样 运行期需要的 Jar 包说明 Jar 包名称 BPS 应用内 引擎 BPS 引擎应用外 ( 已安装 BPS) BPS 引擎应用外 ( 未安装 BPS) 1. bps-client.jar 188

193 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 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 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 189

194 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 23. org.eclipse.xsd_2.2.1.v jar ( 注意 : 前 10 个 jar 包, 是 BPS 系统提供的 ; 后面 13 个, 是依赖的第三方 jar 包 ) 符号说明 : : 需要 : 需要确认, 如果系统中含有, 则不需要 jar 包冲突风险特别说明 : 主要是指目标环境的系统中已经存在相同的 jar 包, 但是版本号不同 : 不需要 如果系统中是高版本, 则风险较小 ; 如果系统中是低版本, 则风险较大 部署执行 war 包裁剪 根据运行期需要的 Jar 包说明, 对 war 包的 lib 目录进行修改 1) 如果是远程方式, 还需要配置 uddi-address.xml 文件 ( 本地方式不需要 ), 详细配置请参照 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> 190

195 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 </filter-mapping> <servlet> <servlet-name>bpsclient</servlet-name> <servlet-class>org.springframework.web.servlet.dispatcherservlet</servlet-cla ss> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>bpsclient</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping> 目标平台部署使用裁剪好的 war 包, 根据不同的目标平台特点, 或者通过控制台, 或者解压后直接拷贝, 进行部署 然后启动应用, 访问客户端的登录页面 : 应用名 ]/index.jsp 或者 应用名 ]/wfclient/user/login.jsp 191

196 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 5.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> <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 服务器的密码 192

197 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 常见问题 问题 :Websphere 环境下, 无法访问到客户端登录页面 策略 : 可能是 filter 不可用, 需要增加 Web 容器属性 com.ibm.ws.webcontainer.invokefilterscompatibility 设置 第 6 章嵌入式客户端部署 6.1 介绍 概述本文仅用于说明如何部署 BPS 提供的客户端 (bpsclient.war 和 bpsclient_remote.war) 如果客户在使用安装包安装未选择安装客户端或使用手工部署方式部署 BPS 引擎和 Workspace 时, 如果需要使用 BPS 提供的客户端 (bpsclient.war 和 bpsclient_remote.war), 则需要进行手工部署 BPS 提供了两种方式部署客户端, 一种是本地部方式, 另外一种是远程调用方式 本地方式本地部署就是指将客户端应用 (bpsclient.war) 和引擎应用 (bps.war) 放在同一个应用中 将 bpsclient.war 和 bps.war 裁剪 示例如下, 其中 bpsclient.war 为客户端应用,bps.war 为 BPS 引擎 : 1) bps.war 中的文件覆盖如图中所示 : 193

198 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 2) bps.war/web-inf 中的文件覆盖如图中所示 : 3) web.xml 文件的裁剪将 bpsclient.war/web-inf/bpsclient-web.xml 文件中的如下内容拷贝到 bps.war/web-inf/web.xml 文件中, 保存即可 : <filter> <filter-name>interceptorfilter</filter-name> <filter-class>com.bps.client.user.wfinterceptorfilter</filter-class> </filter> <servlet> <servlet-name>bpsclient</servlet-name> <servlet-class>org.springframework.web.servlet.dispatcherservlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>bpsclient</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping> 注意 : 需要在 bps.war/web-inf/web.xml 文件中删除原先定义的 InterceptorFilter 完成以上操作, 就可以将 bps.war 部署了 194

199 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 远程调用方式远程调用方式是把 bpsclient_remote.war 独立部署到 BPS 引擎应用服务器之外的服务器上 这种方式部署只需要修改 ${blsclient_remote.war }\WEB-INF\classes 目录下的 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 "Server workspace"</description> <uddihost> </uddihost> <uddiport>8080</uddiport> <uddiwebcontext>default</uddiwebcontext> <uddiuserid>bps</uddiuserid> <uddipassword>000000</uddipassword> </uddi address> </uddi address list> 以上的配置信息如表所示 : 属性 uddi address id="default" uddihost uddiport uddiadminport logicname uddiwebcontext uddiuserid 属性值 id 的值必须为 default BPS 引擎的 ip BPS 引擎的 http 端口 BPS 引擎的管理端口 BPS 引擎应用名 BPS 引擎应用名 bps uddipassword 配置完成后, 将 bpsclient_remote.war 部署即可 195

200 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 第 7 章高性能集群搭建 7.1 概述 高性能的 BPS 是为了满足客户对流程引擎响应时间和单位时间内吞吐量的流程引擎 如果 使用高性能的 BPS 版本, 则客户实施系统的拓扑结构如下 : 典型的使用方式, 用户部署前端机 +N 台执行机的方式, 从而实现业务流程引擎在极端情况下的横向可扩展性 这种异步消息架构中, 作为前端机的 BPS 引擎的工作变得很简单, 处理的事情比较少, 大幅提高了效率和响应速度 执行机则可以通过修改系统配置来决定执行机一次处理能力, 根据业务特点充分调优, 使每台执行机的性能达到最佳状态 可以根据硬件条件 应用系统的访问量等来决定执行机的个数 性能方面可以通过扩展多个执行机来实现, 并且这种扩展机制理论上可以支撑任何压力 如果出现了应用系统中压力较大, 系统性能无法支撑的情况, 则可以通过增加执行机的方式来解决 理论上只要数据库 硬件不存在瓶颈, 我们就可以通过增加执行机个数的方式持续增强 BPS 引擎的处理能力 本章主要介绍如何搭建高性能消息调用集群的安装步骤和注意事项 可选择使用 BPS7.5 企业版安装或者手工部署 BPS7.5 部署包 环境要求三台独立的机器 BPS7.5 企业版或手工部署包数据库账号 196

201 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 说明 : 实际上通过修改冲突端口, 在一台机器上也能安装高级企业版, 但是这样无法发挥高性能 的优势 拓扑结构 BPS 高级企业版消息调用集群可以明显提高流程引擎响应时间和单位时间内吞吐量 具 体拓扑结构如下 : 1. 其典型的使用方式, 部署一台前置机 +N 台执行机, 从而实现业务流程引擎在极端情况下的可扩展性 2. 与通常提升性能的解决方案不同, 高级企业版将用户调用存放到消息队列中, 执行机访问队列并异步处理 由于增加了消息超时处理策略与失败转移策略, 在提高性能的同时, 提升了系统的稳定性 说明 : 前置机与执行机必须配置相同的数据库, 前置机接收请求并放入消息队列, 执行机从队列中取得请求并处理, 在流程引擎无法满足大业务量时, 可以增加执行机数量, 提高单位时间的执行数量 失败转移策略 : 在执行机 X 无法处理消息的情况下 ( 断电, 死机等 ), 前置机会根据执行机的负载情况, 选择一台执行机 N 接管处理消息 7.2 安装步骤 安装准备 (1) 申请支持高性能消息调用的 License 197

202 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 (2) 安装 BPS 企业版或者手工部署包到各结点上, 所有节点的数据源配置相同 (3) 启动所有节点 (4) 搭建 BPS 集群, 搭建方式参见 BPS7.5 产品安装指南 第五章第二节 : 手工部署方式的集群 说明 : 这里的 BPS 集群不是常规意义上的 JavaEE 应用器集群, 而是 BPS 内部缓存的 JMS 消息同步机制, 参见 手工部署的集群 章节即可 配置 License 启动服务器, 进入 governor 选择管理 --- 许可证管理 : 点击更新许可证, 替换为支持消息调用的 license; 重复以上步骤, 替换所有节点的 license, 然后重启 server 配置前端机 访问前置机 (Front) 的 governor 应用 : 点击 BPS 引擎配 置 消息调用, 目标选择 default 应用 198

203 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 勾选启用前端机, 并根据实际情况输入执行机数量 配置执行机 分别访问执行机 (NodeA,NodeB) 服务器的 governor, 点击 BPS 引擎配置 消息调用, 勾选为启用执行机 ; 执行机编号范围是按照前端机设置的执行机数量来确定的, 一般为 :0~( n-1) ; 输入执行机编号, 须保证唯一, 点击确定 199

204 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 安装检查 1. 重启前端机 执行机, 启动过程中, 控制台显示 BPS Message Framework is True!, 说明消息调用启用成功 ; 2. 重新启动前端机, 会在数据库中创建以下三张表, 进入数据库中检查是否创建成功 ; 3. 重新启动执行机, 各执行机会将自身状态信息更新到 WFMESSAGE_EXECUTOR 中 7.3 参数配置说明 对用户具体部署硬件环境 操作系统环境 软件环境 网络环境等不同特点, 需要在测试阶段对性能参数进行优化和调整到最佳状态 通过 Governor 统一管理前端机和执行机, 用户可以通过 Web 界面灵活配置高级企业版的性能参数 前端机配置 前端机负责发起流程操作, 具有非常强的接入能力, 能够满足响应时间的要求 在部署之 后通过配置前端机的参数来调整, 如下图所示 : 200

205 Primeton BPS 7.5 产品安装指南第 5 章客户端开发环境搭建 配置项 解释 前端机 备注 : 启动前端机 执行机数量 消息表名前缀 配置引擎是否为前端机 配置前端机对应的执行机数量 消息表的前缀, 默认是 WFMESSAGE_ 执行机数量 : 执行机数量需要与真实部署的执行机数目相同 ; 修改参数需要重启引擎应用 ; 具体步骤 : 登录 Governor 应用 ; 选择 BPS 引擎配置的消息调用配置功能 ; 选择启用消息调用 ; 选择启用前端机, 并且根据系统部署情况, 配置执行机数量 ; 配置消息表前缀名, 如 WFMESSAGE_ ; 201