BPS Platform 7.2 产品安装指南 普元信息技术股份有限公司 BPS Platform 7.2 产品安装指南 二〇一四年十月 I

Transcription

1 普元信息技术股份有限公司 BPS Platform 7.2 产品安装指南 二〇一四年十月 I

2 目录 1. 简介 开发版的安装内容 企业版的安装内容 配置要求 硬件配置 软件配置 安装 界面交互安装方式 安装开发版 安装企业版 哑安装方式 哑安装相关配置文件 如何配置哑安装属性文件 哑安装配置文件典型示例 卸载 卸载开发版 卸载注意 卸载步骤 验证卸载 集群安装 WebLogic 集群安装 搭建 weblogic 集群环境 通过安装包安装应用到集群 加入 Governor 进行管理 加入 Workspace 进行管理 验证安装 Weblogic 集群安装注意事项 WebSphere 集群安装 搭建 Websphere 集群环境 通过安装包安装应用到集群 加入 Governor 进行管理 加入 Workspace 进行管理 验证安装 手工安装 手工安装业务应用 准备应用服务器环境 准备 EAR 应用 拷贝 JDBC 驱动 jar 部署数据源 JMS 等应用绑定资源 部署应用 配置外置目录和启动参数 II

3 修改应用服务器配置 验证部署 部署资源配置文件示例 附录 附录 A 安装目录说明 附录 B FAQ 应用服务器为 JBOSS 时, 启动时报异常 数据库为 mysql 时, 前台出现乱码 Weblogic 新建 domain 未启动过的情况下安装 BPS 会报错, 错误信息为空, 不能 安装 Oracle 9i 环境下, 启动 BPS Server 提示端口被占用 Oracle 9i 环境下, 安装 BPS 过程中, 执行到 配置数据库 步骤时, 数据库连接测 试失败 初始化数据库时报错, 表或视图不存在 WAS 服务器环境下页面乱码 安装包中的 JDK 切换,SQL Server 数据库初始化报驱动类版本问题 附录 C 安装包配置修改 Tomcat 应用服务器 JBoss 应用服务器 WebLogic 应用服务器 WebSphere 应用服务器 附录 D 界面安装应用服务器参数 附录 E 创建表空间 III

4 1. 简介 BPS Platform 产品包括开发版 (Developer Edition) 企业版(Enterprise Edition) 标准版 (Standard Edition) 基础版(Basic Edition) 四种版本, 支持界面交互安装和哑安装两种方式 本章简单介绍开发版 企业版的安装内容 标准版 基础版的安装与企业版相同, 可参考企业版的安装过程, 在文档中不再说明 1.1. 开发版的安装内容 开发版面向 BPS Platform 应用开发人员, 提供集成开发 在线开发 运行 管理一体化的应用开发环境 安装内容包括 : BPS Server( 运行环境 ) BPS Studio( 集成开发环境 ) Governor( 治理工具 ) Component Library( 构件库 ) RichWeb( 富页面框架 ) NUI( 新一代前端开发框架 ) BPS Studio( 可视化流程设计器 ) Process Server( 流程核心引擎 ) Workspace( 流程工作台, 提供流程定制与管控 引擎实例管理 ) SCE( 在线开发平台 ) SEE( 在线运行平台 ) Coframe( 组织机构权限框架 ) SSO Server( 单点登录服务器 ) 1.2. 企业版的安装内容 企业版面向 BPS Platform 应用部署人员和使用人员, 提供应用在线开发 运行 管理的环 境 安装内容包括 : BPS Server( 运行环境 ) 1

5 Governor( 治理工具 ) Component Library( 构件库 ) RichWeb( 富页面框架 ) NUI( 新一代前端开发框架 ) Process Server( 流程核心引擎 ) Workspace( 流程工作台, 提供流程定制与管控 引擎实例管理 ) SCE( 在线开发平台 ) SEE( 在线运行平台 ) Coframe( 组织机构权限框架 ) SSO Server( 单点登录服务器 ) 2

6 2. 配置要求 2.1. 硬件配置 安装产品的硬件配置要求 : 硬件 要求 CPU 内存 硬盘空间 主频 2.0GHz 以上 1G 以上 开发版 : 临时目录空间 :500M 以上 安装目录空间 :2G 以上 企业版 : 临时目录空间 :500M 以上 安装目录空间 :1G 以上 2.2. 软件配置 安装产品的软件配置要求 : 软件操作系统数据库 JavaEE 应用服务器 开发版 : Windows 2003/XP/7/8 企业版 : 要求 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 说明 : 数据库表空间大小需大于 100MB 需要准备一个数据库用户, 用于初始化数据库操作, 且该用户具有创建 修改 删除表的权限 如果使用 DB2 数据库, 则需再创建一个页大小为 32KB 的用户表空间, 名字为 EOSWFCTX, 以及创建一个页大小为 32KB 的临时表空间, 临时表空间名字可自定义 创建表空间的 SQL 语句请参见附录 开发版 : Tomcat7.0.54( 安装包中自带 ) 3

7 软件 要求 企业版 : 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 PAS 6.0 说明 : PAS6.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 28 Chrome 33 4

8 3. 安装 3.1. 界面交互安装方式 本节分别介绍界面交互方式下如何安装开发版 企业版 安装开发版 下面介绍安装开发版前的准备工作, 安装步骤, 以及验证安装是否正确的方法 安装准备 安装开发版前, 需做以下准备工作 : 检查安装光盘, 检查光盘贴膜标注是否为 开发版 检查安装环境, 必须符合软件配置要求 安装步骤 以 Windows7( 中文 )+ MySQL 环境为例, 开发版的安装步骤如下 : 启动安装程序 将安装光盘插入 CD-ROM 中, 在 autorun 界面中选择安装开发环境 若不是通过 autorun 形式启动安装程序, 请直接执行安装程序文件 install.cmd 阅读安装简介, 单击 < 下一步 > 按钮 5

9 阅读开发版的许可声明后, 选择 本人接受许可协议条款 单选按钮, 单击 < 下一步 > 按 钮 6

10 单击 < 浏览 >, 从弹出的对话框中选择安装目录, 单击 < 下一步 > 按钮 7

11 带空格 注意 : 安装路径最多可输入 64 个字符, 只能由半角英文字母 数字 点. 或下划线 _ 组成, 且不允许 选择应用服务器, 端口号 ( 访问应用的端口号 ) 安装选项, 选择安装组件 默认安装组件有 BPS CAP 和 SSO, 都为可选项 由于 CAP 依赖 BPS, 所以如果安装 CAP, 会同时安装 BPS 8

12 设置管理员口令 使用 Governor 管理员用户名和口令可以登录管理监控应用 Governor, 进行应用的管理和监控操作 使用 Workspace 管理员用户名和口令可以登录流程管理应用 workspace 进行流程管理监控 输入管理员的密码和确认密码 安装程序默认 sysadmin 的密码为 用户可以在此设置新密码, 密码长度必须在 6~20 位之间 根据实际情况输入用户名称和机构名称 ( 可以不输入 ) 安装程序默认用户名称为当前登录操作系统的用户名 选择 IP, 管理端口号 开发版会默认安装一个缺省应用 (default) 和一个管理应用 (Governor) 本步骤用来设置缺省应用的绑定 IP 和管理端口号 在下拉列表框中选择目标安装机器的 IP 地址 多网卡或多 IP 情况下, 必须选择其中的一个 IP, 该 IP 为安装的应用绑定地址 开发版默认使用 作为绑定地址, 但使用该地址不能进行网络操作 ( 如部署的默认应用将不能被其他机器上安装的 Governor 管理 ) 如果需要进行网络操作, 请选择真实 IP 地址 9

13 在管理端口文本框中输入端口号 管理端口是应用的管理端口,Governor 应用通过该端口对应用进行管理, 管理端口也是 BPS 集群应用之间的相互通知端口 注意 : 默认端口号为 6200 端口号 6299 为保留端口号, 默认被 governor 使用, 不能使用 端口号 6399 为保留端口号, 默认被 workspace 使用, 不能使用 端口不自动累加, 不做冲突检查, 用户配置端口号时请自己保证端口号不冲突 创建应用, 用户填写应用名称, 应用名默认为 default, 默认部署 governor 应用以及 workspace 应用, 可以选择是否部署 单击 < 下一步 > 按钮 注意 : 应用名称应遵循下面规则 : 应用名的长度必须在 3~64 之间, 只支持半角英文字母和数字, 支持., _, -, 以字母开头 不允许使用 governor,workspace 做应用名 如果 BPS 未选择安装,workspace 应用默认不安装 10

14 配置数据库 配置数据库界面的参数说明 : 11

15 参数数据源名称数据库类型服务器 IP 服务器端口数据库名称数据库用户数据库用户口令数据库 URL 自选数据库驱动 说明 数据源 JNDI 名称, 默认为 DefaultDataSource 此配置在 Tomcat 和 PAS 下没有意义, 因为它们使用的是 C3P0 数据源 选择应用使用的数据库类型 连接数据库服务器的 IP 地址 连接数据库服务器的端口号 各数据库服务器的缺省端口号如下 : Oracle:1521 DB2 UDB:50000 SQL Server:1433 MySql:3306 数据库的名称 访问数据库的用户名 访问数据库的用户密码 访问数据库的 JDBC URL 安装程序会根据用户所填内容自动生成 数据库驱动程序对应的 jar 包 因数据库使用 JDBC 连接, 安装包内自带了 Oracle DB2 UDB SQL Server MySql 的数据库驱动 若默认的数据库驱动不能与用户所要连接的数据库相匹配, 请选择 自选数据库驱动程序 的复选框, 并选择相应的 jar 包 数据库驱动类 选择是否 初始化数据库 自选数据库驱动类 在不使用自选 JDBC 的情况下, 安装包为各类型数据库提供了默认的 JDBC Driver Class: Oracle:oracle.jdbc.driver.OracleDriver DB2 UDB:com.ibm.db2.jcc.DB2Driver SQL Server:com.microsoft.jdbc.sqlserver.SQLServerDriver MySql:org.gjt.mm.mysql.Driver 如果安装 BPS Platform 是初次使用某个数据库, 建议初始化该数据库, 否则会导 致 BPS Platform 不能正常运行, 若出现这种情况, 可于安装成功后通过 Governor 初始化数据库 ; 对于已执行过初始化的数据库, 再次初始化将覆盖已经修改的 BPS 表 初始化数据库时, 安装程序将在数据库中创建 BPS Platform 使用的表 若要初始化指定的数据库, 必须正确填写该数据库配置信息 对于已经初始化过的数据库, 安装包会提示, 用户可以选择再次初始化或者不初 始化 单击 < 数据库连接测试 > 按钮, 测试所配置数据库是否可以成功连接 阅读并审核安装设置信息, 单击 < 安装 > 按钮 12

16 开始安装, 安装过程中显示各组件的安装进程 13

17 程序提示开发环境已经成功安装 单击 < 完成 > 按钮, 完成开发版的安装 验证安装 验证开发版是否已正确安装的步骤如下 : 安装程序提示安装成功 用户第一次安装 BPS Platform 产品后,[ 开始 / 所有程序 ] 中会添加 BPS Platform 7.2 (Platform Home1) 菜单 同一个登录用户若多次安装 BPS Platform 产品,[ 开始 / 所有程序 ] 中会依次添加 BPS Platform 7.2(Platform Home2) BPS Platform 7.2(Platform Home3) 菜单, 以示区别 检查安装日志 安装成功后, 安装目录下存放有 bps_platform_7.2_install.log 安装日志文件, 检查该文 件, 安装过程没有异常信息 检查目录和配置文件 14

18 验证安装 Studio: 检查项目 目录和文件 检查内容 Studio 部分的内容存放于安装目录下的 \ide\eclipse 和 \ide\eclipse\dropins 目录中 \ide\eclipse\configuration\eos_studio_config\connection 目录下的数据库配置与 配置文件 安装时配置一致 \ide\eclipse\configuration\eos_studio_config 目录下的 server.xml 配置正确, 详情可参考附录 验证安装 Server: %EXTERNAL_CONFIG_DIR%= 安装目录 \ apps_config 本参数是外置配置目录的参数, 外置配置目录用来存放应用启动配置和运行期的 配置 %TOMCAT_HOME%= 安装目录 \apache-tomcat 检查项目 数据库驱动 %TOMCAT_HOME%\ webapps 检查内容 %TOMCAT_HOME%\lib 下存在数据库驱动 : Oracle:ojdbc jar DB2 UDB:db2jcc.jar SQL Server:mssqlserver-3.0.jar MySql:mysql-connector-java bin.jar 检查是否存在应用 default( 或在安装过程中输入的应用名 ) governor workspace sso-server 检查数据源配置 配置文件 应用 default 的 war 目录下的 WEB-INF\_srv\config\user-config.xml 文件中的 <module name="datasource"> 节点的 default 的数据源配置 检查应用配置 %EXTERNAL_CONFIG_DIR% 目录下的 default 应用的 startup.conf 的配置应与用户安装时选择的 IP 端口号一致 governor 下的 startup.conf 的端口号应为 6299 检查 startserver.cmd startserver.cmd 位于安装目录下 用编辑器打开该文件查看 JAVA_HOME EXTERNAL_CONFIG_DIR 的设置正确 JAVA_HOME 应设置为安装目录下 ide/eclipse/jre 子目录,EXTERNAL_CONFIG_DIR 应设置为安装目录下 apps_config 子目录 运行 startserver.cmd, 启动 Server, 查看控制台有没有异常 15

19 安装企业版 下面介绍安装企业版前的准备工作, 安装步骤, 验证安装是否正确的方法, 以及不同环境 下安装需要注意的事项 安装准备 安装企业版前, 需做以下准备工作 : 检查安装光盘 检查光盘贴膜标注是否为 企业版 检查安装环境 必须符合软件配置要求 准备应用服务器 : 如果安装时使用 WebLogic 类型服务器, 需要建立一个部署应用的 domain 可通过 WebLogic 的 configuration wizard 创建, 具体创建步骤请用户自行查阅相关资料 如果安装时使用 WebSphere 类型服务器, 需要建立一个应用程序服务器类型的 WebSphere Profile(WebSphere 概要文件 ) 可通过 WebSphere 的概要文件管理工具创建, 具体创建步骤请用户自行查阅相关资料 注意 : 为防止页面乱码, 请将 AppServer/properties/encoding.properties 中的 zh=gb2312 改成 zh=utf 安装步骤 (Linux+WebLogic+Oracle) 以 Red Hat WebLogic Oracle 10g 环境为例, 企业版的安装步骤如下 : 大部分和开发版的安装一样, 下面只对应用服务器选择等不同步骤进行详细说明 运行 install.sh, 启动安装程序 注意 : 如果用户想要进行远程安装, 需先安装支持远程调用 X Windows(UNIX 系统的桌面可视化程序 ) 并将图形输出到客户端的软件, 例如 Xmanager 3.0, 安装完该软件后, 运行 Xmanager Passive 程序 然后以命令行模式远程登录 Linux 系统, 再运行命令 export DISPLAY=% 客户端 IP%:0, 随后便可以运行 install.sh 进行远程安装了 选择应用服务器 16

20 参数 说明 App Server/ 应用服务器 Bea Home Weblogic Home Domain Home Login name/ 用户名 PassWord 选择所使用的应用服务器类型 Bea 产品主目录 WebLogic 目录 用户选择 BEA HOME 后, 系统会自动填写 Weblogic HOME, 用户无需手动更改 用户创建的 domain 目录 创建具有管理安全性的 domain 时设置的用户名 创建具有管理安全性的 domain 时设置的用户密码 Server name WebLogic Server 名称, 默认为 AdminServer WebServer PORT 服务端口, 默认为 7001 Clustered/ 集群 是否集群应用, 如果没有这个选项, 说明不支持集群 安装选项, 选择安装组件 默认安装组件有 EJB,BPS, CAP 和 SSO, 组件都是可选安装的 17

21 创建应用, 用户可以创建默认应用, 并自定义名称, 默认该应用名为 default 默认应用 Governor Workspace 均可以选择性部署 18

22 安装程序提示企业版已经成功安装 验证安装 (Linux+WebLogic+Oracle) 以 (Red Hat WebLogic Oracle 10g) 环境为例, 验证企业版是否已正确安装的步骤如下 : 安装程序提示安装成功 检查日志, 打开安装目录下的 bps_platform_7.2_install.log 安装日志文件, 检查安装过程中是否有异常信息 检查数据库驱动和目录 : 检查项目 数据库驱动 ear 目录 检查内容 %Domain Home%/lib 下存在数据库驱动 : Oracle:ojdbc jar DB2 UDB:db2jcc.jar SQL Server:mssqlserver-3.0.jar MySql:mysql-connector-java bin.jar %Domain Home%/applications 下存在目录 default.ear governor.ear workspace.ear,sso-server.ear 检查 startserver.sh 该文件位于安装目录下 19

23 运行 startserver.sh, 可以启动 WebLogic 服务 登录 domain 管理服务控制台 (Admin server console) 查看数据源 JMS 配置存在 安装步骤 (Linux+WebSphere+DB2) 安装步骤跟 weblogic 类似, 这里只对应用服务器选择进行说明 以 Red Hat ( 英文环境, 部分配置参数将以 english/ 中文的形式加以说明 )+ WebSphere 7+ DB2 UDB_V9.5 环境为例, 企业版的安装步骤如下 : 选择应用服务器 选择 WebSphere 应用服务器界面图示及参数说明表如下 参数 App Server/ 应用服务器 Profile Home Cell Name 说明 选择应用所使用的应用服务器类型 WebSphere7 的概要文件目录 例如 :/opt/webspherend61eos/profiles/appsrv05, 该目录为一个 Profile Home,AppSrv05 是用户创建的应用服务器的名称 管理服务器单元的名称 该参数会在选择正确的 Profile Home 之后自动填写, 用户无需手动更改 20

24 参数 Node Name Server name User name PassWord Clustered/ 集群 说明 WebSphere 节点名称 该参数会在选择正确的 Profile Home 之后自动填写, 用户无需手动更改 WebSphere Server 名称 该参数会在选择正确的 Profile Home 之后自动填写, 用户无需手动更改 创建具有管理安全性的 Profile 时设置的用户名 创建具有管理安全性的 Profile 时设置的用户密码 是否集群应用 验证安装 (Linux+WebSphere+DB2) 以 Red Hat WebSphere7 + DB2 UDB_V9.5 环境为例, 验证企业版是否已正确安装的步骤如下 : 安装程序提示安装成功 检查日志 信息 打开安装目录下的 bps_platform_7.2_install.log 安装日志文件, 检查安装过程中没有异常 检查数据库驱动和目录 : 检查项目 数据库驱动 ear 目录 检查内容 %WebSphere 安装目录 %/lib/ext 下存在数据库驱动 : Oracle:ojdbc jar DB2 UDB:db2jcc.jar SQL Server:mssqlserver-3.0.jar MySql:mysql-connector-java bin.jar %Profile Home%/installedApps/%Cell Name% 下存在目录 default.ear 和 governor.ear,workspace.ear,sso-server.ear( 具体与用户在安装时选择安装的应用有关 ) 检查 startserver.sh 该文件位于安装目录下 运行 startserver.sh, 可以启动 WebSphere 服务 ( 具体启动哪个服务, 在安装时选择应用服务器步骤中确定, 即 Server Name, 如 Server1) 查看 JVM 参数, 用户可在启动服务后登陆 profile 管理控制台 Application Servers -> server1 -> (Java 和进程管理 ) 进程定义 -> Java 虚拟机 -> 定制属性 查看 21

25 查看 web 容器定制参数, 在管理控制台 Application Servers -> server1 -> ( 会话管理 ) Web 容器 -> 定制属性 查看 : com.ibm.ws.webcontainer.invokefilterscompatibility true 3.2. 哑安装方式 哑安装方式即用户通过属性文件一次性定制各安装参数, 运行安装包后, 安装程序从该属性文件中读取参数进行安装 整个安装过程完全自动化, 无需用户干预 哑安装方式能够解决界面交互安装方式对安装环境要求高, 非自动化等问题 哑安装相关配置文件 哑安装配置在 silent_install.properties 文件中完成 这个文件必须存放在安装目录的 installer 子目录下, 文件的名称必须为 silent_install.properties, 其内容遵循 java properties 文件格式, 需要转义的字符必须进行转义 该文件内容决定产品安装路径 数据库配置 JavaEE 服务器配置等 启动哑安装方式步骤如下 : 1. 正确设置了 silent_install.properties 文件并且放在安装包所在目录的 installer 子目录下 22

26 2. 在命令行模式下, 启动安装程序后面增加 -silent 参数即可 例如 : 在 Windows 系统下时, 假设安装光盘为 F:, 则输入 F:\install.cmd silent; 在 Linux/AIX 系统下时, 在安装包所在目录 输入./install.sh silent 如何配置哑安装属性文件 对于开发版和企业版, 不同的应用服务器和数据库下, 哑安装属性文件的配置也不相同, 下面详细介绍不同情况下如何配置 silent_install.properties 文件 哑安装产品时, 用户需设置下列参数 : 参数名称 参数意义 数据源配置信息 DB_DS_JNDI_NA ME DB_TYPE DB_DRIVER DB_IS_DEFAULT_ JAR DB_JDBC_LIBS DB_IP 数据源 JNDI 名称,Tomcat 和 PAS 应用服务器下不需要 使用的数据库类型, 为必填参数 必须设置为以下值中的一个 : Oracle DB2 UDB SQLServer MySql 数据库 JDBC 驱动类名, 为必填参数 各类型数据库默认的 JDBC Driver Class 如下 : Oracle:oracle.jdbc.driver.OracleDriver DB2 UDB:com.ibm.db2.jcc.DB2Driver SQLServer:com.microsoft.sqlserver.jdbc.SQLServerDriver MySql:org.gjt.mm.mysql.Drive 是否使用默认的数据库驱动, 为必填参数 只能设置为 true 或 false 因数据库使用 JDBC 连接, 安装包内自带了 Oracle DB2 UDB SQL Server Sybase Informix MySql 的数据库驱动 若默认的数据库驱动不能与用户所要连接的数据库相匹配, 请将本参数设置为 false, 并在 DB_JDBC_LIBS 中设置相应的 jar 包 说明 : 本参数为 false 时,DB_JDBC_LIBS 参数值不能为空 用户自选的数据库 JDBC 驱动文件路径 (jar 包 ) 如果有多个文件, 以英文分号 ; 分隔, 如 :D:\jdbc\a.jar;D:\jdbc\b.jar 说明 : 仅当 IS_DEFAULT_JAR 值为 false 时, 才需要配置本参数 连接数据库服务器的 IP 地址, 为必填参数 23

27 参数名称 DB_SERVER_POR T DB_NAME DB_USERNAME DB_PASSWORD DB_ IS_INIT DB_IS_FORCE_INI T 公共安装信息 INSTALL_DIR SYSADMIN_PWD WORKSPACE_SY SADMIN_PWD USER_NAME USER_COMPANY 参数意义 连接数据库服务器的端口号, 为必填参数 各数据库服务器的缺省端口号如下 : Oracle:1521 DB2 UDB:50000 SQL Server:1433 Sybase:5000 Informix:1528 MySql:3306 数据库的名称, 为必填参数 访问数据库的用户名, 为必填参数 访问数据库的用户密码, 为必填参数 是否要初始化数据库, 为必填参数 true 为初始化,false 为不初始化 说明 : 如果是初次使用某个数据库, 建议初始化该数据库, 否则会导致应用不能正常运行 ; 对于已执行过初始化的数据库, 再次初始化将覆盖已经修改的 Platform 表 初始化数据库时, 安装程序将在数据库中创建 Platform 使用的表和视图 若要初始化指定的数据库, 必须正确填写该数据库配置信息 是否强制初始化数据库, 说明 : DB_ IS_INIT 为 true 时, 如果该数据库已经初始化过 Primeton Platform 的系统表, 需要配置 DB_IS_FORCE_INIT true: 强制再次初始化数据 ;false: 不会再次初始化已经初始化过 Primeton Platform 系统表的数据库 安装目录, 为必填参数 说明 : 安装路径最多可输入 64 个字符, 只能由半角英文字母 数字或下划线 _ 组成, 且不允许带空格 在 windows 系统下, 安装目录中的 \ 需要改成 /, 例如 :D: /primeton/de governor 管理员 sysadmin 的密码, 为必填参数 密码长度必须在 6~20 位之间, 密码只能由半角英文字母 数字. 或下划线 _ 组成 workspace 管理员 sysadmin 的密码, 为必填参数 密码长度必须在 6~20 位之间, 密码只能由半角英文字母 数字. 或下划线 _ 组成 用户名称, 非必填参数 用户所在的机构名称, 非必填参数 24

28 USER_IP 参数名称 USER_PORT IS_DEPLOY_DEFA ULTAPP DEFAULT_APP_N AME IS_DEPLOY_GOV ERNOR IS_DEPLOY_WOR KSPACE IS_DEPLOY_EJB MODULE_OPTION S 参数意义 填写目标安装机器的 IP 地址 多网卡或多 IP 情况下, 必须选择其中的一个 IP, 该 IP 为安装的应用绑定地址 开发版默认使用 作为绑定地址, 但使用该地址不能进行网络操作 ( 如使用开发版安装的 Governor 管理其他机器上的应用 ) 如果需要进行网络操作, 请选择真实 IP 地址 管理端口是应用的 JMX 管理端口,Governor 应用通过该端口对应用进行管理, 管理端口也是集群应用之间的相互通知端口 是否部署默认应用, 非必填参数 默认应用名称 说明 : 应用名的长度必须在 3~64 之间, 只支持半角英文字母和数字, 支持., _, -, 以字母开头 不许使用 governor workspace 做应用名 不允许与已有应用重名 是否部署 governor 应用, 非必填参数 是否部署 workspace 应用, 非必填参数 应用是否部署 EJB, 应用服务器为非 tomcat 环境时配置 要安装的选件名称, 有 EJB BPS CAP 可选 对于不同的应用服务器, 需要配置不同的参数 : 参数名称 参数意义 公共参数 APP_SERVER_NAME APP_SERVER_VERSION 应用服务器名称, 为必填参数 应用服务器版本, 为必填参数 企业版专用参数 IS_REPEAT_INSTALLED 是否重复安装, 多次安装使用, 非必填, 多次安装时填写 true, 第一次安装不填或填写 false Tomcat 专用参数 AS_TOMCAT_HOME Tomcat 的安装目录 JBoss 专用参数 AS_JBOSS_HOME JBoss 的安装目录 WebLogic 专用参数 AS_WL_BEA_HOME Bea 产品主目录, 为必填参数 如 :C:/bea AS_WL_HOME 本机的 WebLogic 目录, 为必填参数 如 :C:/bea/weblogic92 AS_WL_DOMAIN_HOME 部署应用的 domain 目录, 为必填参数 如 : C:/beaDomains/domain923 25

29 参数名称 AS_WL_TARGET_SERVER AS_WL_WEBSVR_PORT AS_WL_USERNAME AS_WL_PASSWORD IS_CLUSTER 参数意义 目标服务器名称 如 :AdminServer WebServer 端口号,WebLogic 默认是 7001, 为必填参数 WebLogic 安全用户名 WebLogic 安全用户密码 集群配置参数, 集群环境配置为 true, 非集群环境配置为 false WebSphere 专用参数 AS_WAS_SERVER_NAME AS_WAS_CLUSTER_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 的安全性 哑安装配置文件典型示例 下面提供几个典型环境下的哑安装配置文件示例, 仅供参考, 具体参数值根据实际情况填写 安装程序对于参数值为空的参数处理方式是忽略, 因此用户可以保留那些不需要填写值的参数 开发版 (Windows7 + Oracle 11g) #JavaEE Server APP_SERVER_NAME=Tomcat APP_SERVER_VERSION= #DataBase Type for example:oracle,db2 UDB,SQLServer,MySql DB_TYPE=Oracle #JDBC Driver 26

30 DB_DRIVER=oracle.jdbc.driver.OracleDriver #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= #DataBase Server IP DB_IP= #DB Server Port DB_SERVER_PORT=1521 #DB Instance Name DB_NAME=orcl #DB User DB_USERNAME=test #DB User's Password DB_PASSWORD= #Is initialize DataBase DB_IS_INIT=true #Is force initialize DataBase, If you want to initialize the database mandatory, set DB_IS_FORCE_INIT to true DB_IS_FORCE_INIT=false #Install Target Directory INSTALL_DIR=D:/Primeton/Platform #governor sysadmin's Password SYSADMIN_PWD= #workspace sysadmin's Password WORKSPACE_SYSADMIN_PWD= #User and Company Information USER_NAME=yourname USER_COMPANY=yourcompany #the Ip you are user for RMI USER_IP= USER_PORT=6200 #application for installing option DEFAULT_APP_NAME=default IS_DEPLOY_DEFAULTAPP=true IS_DEPLOY_GOVERNOR=true IS_DEPLOY_WORKSPACE=true #option module to deploy(bps,cap,sso) MODULE_OPTIONS=bps,cap,sso #When the Primeton Platform products have been installed to install the directory, its value set to true IS_REPEAT_INSTALLED=false 27

31 企业版 (AIX 5 + WebSphere DB2 UDB_V8.2) #JavaEE Server APP_SERVER_NAME=WebSphere APP_SERVER_VERSION=6.1 IS_CLUSTER=false #AS_WAS_PROFILE_HOME AS_WAS_PROFILE_HOME=/opt/IBM/WebSphere/AppServer/profiles/AppSrv65Silent #WebSphere6.1 CELL_NAME AS_WAS_PROFILE=AppSrv65Silent #WebSphere6.1 CELL_NAME AS_WAS_CELL_NAME=localhostNode15Cell #WebSphere6.1 NODE_NAME AS_WAS_NODE_NAME=localhostNode65Silent #WebSphere6.1 SERVER_NAME AS_WAS_SERVER_NAME=server1 AS_WAS_USERNAME=admin AS_WAS_PASSWORD=admin IS_SECURITY_CHECK=true #DataSource Name DB_DS_JNDI_NAME=DefaultDataSource #DataBase Type for example:oracle,db2 UDB,SQLServer,Sybase,Informix,MySql DB_TYPE=DB2 UDB #JDBC Driver DB_DRIVER=com.ibm.db2.jcc.DB2Driver #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= #DataBase Server IP DB_IP= #DB Server Port DB_SERVER_PORT=50000 #DB Instance Name DB_NAME=orcl #DB User DB_USERNAME= test #DB User's Password DB_PASSWORD= #Is initialize DataBase DB_IS_INIT=true 28

32 #Is force initialize DataBase, If you want to initialize the database mandatory, set DB_IS_FORCE_INIT to true DB_IS_FORCE_INIT=false #Install Target Directory INSTALL_DIR=/home/Primeton/Platform #governor sysadmin's Password SYSADMIN_PWD= #workspace sysadmin's Password WORKSPACE_SYSADMIN_PWD= #the Ip you are user for RMI USER_IP= USER_PORT=6200 #applications for installing option DEFAULT_APP_NAME=default IS_DEPLOY_DEFAULTAPP=true IS_DEPLOY_GOVERNOR=true IS_DEPLOY_WORKSPACE=true #option module to deploy(ejb,bps,cap,sso) MODULE_OPTIONS=bps,cap,sso #When the Primeton Platform products have been installed to install the directory, its value set to true IS_REPEAT_INSTALLED=false 注意 : 配置路径时需要自已转义, 如 D:\platform\platform1352 需转义为 D:\\platform\\platform1352 或 D:/platform/platform1352, 否则安装时会出现错误 29

33 4. 卸载 本章介绍如何卸载开发版 ( 注意 : 企业版不能卸载 ) 4.1. 卸载开发版 本节介绍卸载开发版的注意事项 卸载步骤和验证卸载是否完全的方法 卸载注意 卸载开发版的注意事项如下 : 请慎用卸载程序, 一旦卸载将不能恢复 卸载前需要关闭 Studio, 并停止 Server 卸载时, 请关闭 google 或紫光拼音输入法, 否则卸载后, 点击 < 完成 > 按钮, 界面可能无法正常关闭, 只能手工杀掉卸载进程 卸载步骤 卸载开发版的步骤如下 : 启动卸载程序 启动安装目录 /uninstall 目录下 uninstall.cmd, 或者从 开始菜单 / 所有程序 找到要卸载的 BPS Platform 项, 在弹出菜单上点击 卸载 BPS Platform, 弹出卸载程序面板, 单击 < 下一步 > 30

34 选择是否保留工作区内容, 单击 < 下一步 > 执行卸载 31

35 卸载完成 32

36 验证卸载 卸载完成, 无异常, 无错误提示, 若选择了保留默认工作区, 卸载程序将默认工作空间加 上时间戳保存在安装目录下, 用户可另择目录备份默认工作空间, 再删除安装目录 33

37 5. 集群安装 5.1. WebLogic 集群安装 以应用服务器 WebLogic9.2 为例进行集群安装说明 搭建 weblogic 集群环境 选择 Tool Configuration Wizard, 单击 < Next > 按钮 选择安装域源 选择安装 WebLogic server, 单击 < Next > 34

38 配置管理员和密码, 输入 Weblogic 管理员管理服务器 (AdminServer) 的用户名和密 码, 确认密码, 单击 < Next > 按钮 配置域启动模式和 JDK 选择 Development Mode/ 开发模式 和 Sun SDK 后, 单击 < Next > 按钮 35

39 选择是否自定义环境和服务设置 选择 Yes, 单击 < Next > 配置管理服务器 输入 Administrator Server 的名称, 监听地址, 监听端口, 如果需要 SSL 支持的话可以在 SSL enabled 复选取框上打勾, 配置 SSL 监听端口, 单击 < Next > 按钮 36

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

41 配置集群信息 单击 Switch Display/ 切换显示, 再单击 Add/ 添加, 输入 Cluster 的 名称,Multicast address 组播地址,Cluster 的组播地址和端口,Cluster 地址可输可不 输 单击 < Next > 按钮 将受管理服务器添加到集群中 选择左面列表中的 Managed Server, 将其添加到右面 38

42 的列表中, 这里代理服务器不要添加到右边, 单击 < Next > 按钮 创建 HTTP 代理服务器 选中 Creat HTTP proxy for cluster Cluster_1,Proxy Server/ 代理服务器选择前面没有加入 Cluster_1 的 ProxyServer, 单击 < Next > 按钮 配置计算机 在此不对计算机进行配置, 单击 <Next> 按钮 39

43 检查 WebLogic 域, 如果没有问题单击 <Next> 按钮 创建 WebLogic 域, 输入要创建的域名和位置, 此处域名输入为 Cluster_1_domain, 单 击 <Create> 按钮 40

44 创建域 创建无误后, 单击 < Done > 为每个受管服务器创建外置目录, 建议以 apps_config 为文件夹名, 外置配置目录用来 存放应用启动配置和运行期的配置 41

45 编辑口令文件, 在刚才创建的域目录下创建 boot.properties 文件, 内容为前文中创建 WebLogic 集群设置安全性用户名和密码, 如 : username=weblogic password=weblogic 编辑启动管理服务器的文件, 在刚才创建的域目录下的 bin 目录中创建 startadminserver.cmd 文件, 内容为 启动管理服务器. start.\startweblogic 编辑启动代理服务器的文件, 在刚才创建的域目录下的 bin 目录中创建 startproxyserver.cmd 文件, 内容为 使用 startmanagedweblogic 命令启动 Managed Server, 它的命令格式是 startmanagedweblogic.cmd Managed Server 的名称 Administrator Server startmanagedweblogic 受管理服务器名称管理服务器 URL start.\startmanagedweblogic ProxyServer 编辑受管理服务器的文件 以 ManagedServer_1 为例, 在刚才创建的域目录下的 bin 目录中创建 startmanagedserver_1.cmd 文件, 增加外置目录参数, 内容为 启动受管理服务器 启动 Managed 使用 startmanagedweblogic 命令启动 Managed Server, 它的命令格式是 startmanagedweblogic.cmd Managed Server 的名称 Administrator Server startmanagedweblogic 受管理服务器名称管理服务器 URL Set JAVA_OPTIONS=%JAVA_OPTIONS% -DEXTERNAL_CONFIG_DIR=C:/ cluster_1_domain/managedserver_1/apps_config start.\startmanagedweblogic ManagedServer_1 说明 : 1. 使用 startmanagedweblogic 命令启动 Managed Server, 它的命令格式是 :startmanagedweblogic.cmd < 受管服务器名 > < 管理服务器 URL> 42

46 2.%EXTERNAL_CONFIG_DIR% 参数是外置配置目录的参数, 外置配置目录用来存放应用启动配置和运 行期的配置 外置目录, 在各个受管服务器外置目录下创建以部署到该集群的应用为名称的子目录, 如 default, 在该应用配置子目录下创建 startup.conf 文件, 配置应用的绑定 IP 和管理端口, 格式如下 : AdminPort=6200 LocalIP= 用户应保证 LocalIP 值为受管服务器所在机器的一个真实 IP,AdminPort 值不被其他已部署应用占用 通过安装包安装应用到集群 下面仅对应用服务器选择步骤进行说明, 安装步骤如下 : 选择应用服务器, 选中集群复选框, 在应用服务器下拉框中选中 WebLogic9.2, 在 Bea Home 选择 bea 安装目录, 安装包自动读出 WebLogic Home 在 Domain Home 选择 domain 安装目录, 输入管理员用户名和密码, 集群名如 :Cluster_1, 集群管理服务器端口号, 如 :

47 参数 说明 Bea Home Weblogic Home Domain Home 用户名密码 Cluster Name WebServer PORT 集群 WebLogic 的安装目录 WebLogic 目录 用户选择 BEA HOME 后, 系统会自动填写 Weblogic HOME, 用户无需手动更改 用户创建的 domain 目录 创建具有管理安全性的 domain 时设置的用户名 创建具有管理安全性的 domain 时设置的用户密码 用户创建的集群名称 集群服务端口 是否集群应用 安装完成后, 重启集群 保证应用能正常运行必须重启一次集群, 至此安装完毕 加入 Governor 进行管理 安装 governor 应用到一个 domain 中, 或其他类型的应用服务器中, 安装过程请参考 安装企业版 本例中采用 tomcat 作为应用服务器 启动 WebLogic 集群, 启动管理服务器 受管服务器, 通过 URL: 登陆控制台确认部署的应用如 default 已启动 启动 governor, 启动部署 governor 的应用服务器, 登陆 governor 控制台 点击应用管理, 添加集群被管应用 应用名称与用户部署在 WebLogic 集群上的应用相同,IP 地址为部署该应用的受管服务器的 IP 地址, 管理端口号为受管服务器管理该应用的端口, 可在前文配置的该受管服务器的外置目录下 startup.conf 文件中查看, 选中加入新建的集群, 输入集群名称 单击 < 确定 > 44

48 察看 governor 中被管应用, 已启动, 已同步 向集群中加入多个被管应用, 会将第一个应用中的 BPS 配置信息作为模板 添加完毕集群中所有应用, 除第一个应用外, 所有应用配置文件需要与模板文件进行同步操作, 此时需要重启其他应用以便同步 BPS 配置文件 如果选择了 BPS, 则需要对 BPS 引擎进行配置 依次选择 :BPS 引擎配置 -> 运行参数配置, 目标选择 testcluster, 选中 是否启用集群 后的复选框, 如图 注意 : 启用 BPS 引擎集群配置后重启集群 启动过程中, 控制台显示 BPS Cluster Framework is True!, 说明 BPS 引擎集群启用成功, 如图 45

49 加入 Workspace 进行管理 如果选择了 BPS, 则需要安装 workspace workspace 可以通过安装包进行安装, 安装时只需在安装选项中选择 workspace 即可, 也可以在上一步安装 governor 时同时安装 workspace 在 workspace 中添加受管引擎 登录 引擎实例管理, 将 ManagedServer1 和 ManagedServer2 添加到 workspace 中, 添加时测试连接是否正常, 保证添加的引擎是可用的, 如图 验证安装 以 Win7 + WebLogic Oracle 9i 环境为例, 验证集群环境是否已正确安装的步骤如下 : 启动集群, 启动管理服务器 受管服务器, 通过 URL: 登陆 WebLogic 管理控制台 查看 JMS 配置 每一个 ManagedServer 对应一个 JMS server 46

50 查看数据源, 用户配置数据源存在, 用户可进一步查看各项属性如 JNDI 名称, 连接 池配置和用户创建该数据源时的输入一致 应用能够启动, 启动时没有异常 Weblogic 集群安装注意事项 WebLogic 集群应用安装后, 需要将应用的 stage 模式手工更改为 nostage 模式才支持通过 Governor 部署 ECD 方式来升级应用, 否则只能使用集群管理服务器更新 EAR 的方式解决 通过安装包 WebLogic 集群是使用 stage 模式的, 这也是 Weblogic 默认的模式, 使用该模式是为了保证部署的 ear 应用可以同步到远程服务器的集群节点上 stage 模式的特点是集群节点重启后, 会强制从 Weblogic 的主管服务器上重新同步 EAR 应用, 这样会造成集群应用安装后, 通过 Governor 向集群应用通过 ECD 部署方式更新 ( 升级 ) 应用后, 再集群节点重启后又被覆盖为旧的 ( 集群管理服务器上的 EAR), 另外, 通过 governor 修改集群应用的配置 ( 一般会修改 user-config.xml 等 ), 也存在集群重启后配置文件被覆盖问题 为了避免通过 Governor 部署 ECD 的结果被集群重启后覆盖, 在通过安装 WebLogic 集群应用后, 需要手工将应用的 stage 模式更改为 nostage, 具体步骤如下 : 1) 找到集群的管理服务器的 domain 的 config/config.xml 文件, 修改下面的内容 ( 参见红色字体 ), 如下 : <app-deployment> 47

51 <name>default</name> <target>cluster</target> <module-type>ear</module-type> <source-path>applications/ default.ear</source-path> <security-dd-model>ddonly</security-dd-model> <staging-mode>nostage</staging-mode> </app-deployment> 2) 将 ear 应用目录放在在被管服务器的 applicatons 目录下 首先确保集群节点重启, 被管 Server 目录的 stage 目录下已经同步了 ear 文件, 如下面的目录 ( 假设 domain 为 domain1, 应用名称为 default): domain1 servers servers ManagedServer_1 stage default default.ear ( 可能是目录, 或是一个 ear 压缩文件 ) 找到上图红色部分的 ear 文件或目录, 如果是目录直接 copy 到 domain 的 applications 目录下, 如果是 ear 文件, 将文件解压成 ear 目录 ( 要注意, 里面是.war 目录而不是.war 文件 ), 最后形成的目录如下 : domain1 applications default.ear ( 目录 ) default.war ( 目录 ) WEB-INF ) 重启整个集群, 包括集群的主管服务器, 集群的被管服务器 48

52 注意 : 这种手工配置成 nostage 模式的方法, 适合于后续通过 governor 部署 ECD 来升级应用的场景, 但不支持新增加集群节点场景, 如果要新增加集群节点, 建议还是采取 stage 模式, 但以后更新或升级应用只能采取通过 Weblogic 管理服务器对集群重新部署 EAR 来进行应用升级 5.2. WebSphere 集群安装 以应用服务器 WebSphere 6.1 为例进行集群安装说明 搭建 Websphere 集群环境 安装 Deployment 管理服务器节点和联合应用程序服务器 运行 WebSphere\AppServer\firststeps\firststeps.bat, 点击概要文件管理工具 或者进入 $WAS_HOME$\AppServer\bin\ProfileManagement> 目录运行 pmt.bat 命令 选择功能部件, 选中 单元 (Deployment Manager 和联合应用程序服务器 ) 即可, 如 下图所示 系统将创建一个 Deployment Manager 和一个 Node 节点 49

53 指定概要文件位置 节点名 主机名 单机名选择高级概要文件创建, 缺省部署管理控制台和缺省应用程序 在输入节点名和主机名时必须正确, 主机名区分大小写, 建议不要填写 IP 地址 节点名和单元名取默认值即可, 但是要保证集群中的节点名不可重复 在本例中新建 Manager 概要为 Dmgr02, 新建 node 概要为 Managed1 50

54 安全性 端口和服务指定用户自定义安全性, 集群各节点的端口不能出现冲突, 不将 Deployment Manager 进程作为 Windows 服务运行 安装第二个应用程序服务器节点, 运行 WebSphere\AppServer\firststeps\firststeps.bat, 点击概要文件管理工具 : 51

55 选择功能部件只需选中 应用程序服务器 即可, 如下图所示 系统将创建一个应用程 序服务器节点 指定概要文件位置 节点名 主机名 单机名选择高级概要文件创建, 部署管理控制台和缺省应用程序 在输入节点名和主机名时必须正确, 主机名区分大小写, 建议不要填写 IP 地址 节点名和单元名取默认值即可, 但须保证节点名不可重复 本例中新建概要名为 Managed2 52

56 安全性 端口和服务指定 IBM HTTP Server 自定义安全性设置, 集群各节点的端口 不能出现冲突, 不将 Application Server 进程作为 Windows 服务运行 注意 : 建议记住创建时的 SOAP 端口号, 在将该节点和集群节点联合时需要输入, 这是和 WebSphere 5.1 不同的 启动 Deployment 管理服务器, 进入 Deployment 管理服务器的安装目录 WebSphere\AppServer\profiles\Dmgr02\bin, 执行命令 : startmanager.bat Deployment 管理服务器启动后, 即可使用浏览器通过 URL 地址 访问 Deployment 管理服务器的管理控制台 在同一目录下使用 stopmanager.bat 命令可以停止 ND 服务 说明 : URL 地址 中的管理控制台访问端 9047 可能在不同的机器上会有变化, 可以进入 WebSphere\AppServer\profiles\Dmgr01\logs\ 目录下的 AboutThisProfile.txt 来查看管理控制台访问端口 将 WebSphere 节点加入 ND, 增加节点 Node02, 进入应用程序服务器的安装目录 WebSphere\AppServer\profiles\Managed2\bin, 执行命令 : addnode.bat

57 说明 : 是主管服务器的 IP 地址,8884 是主管服务器的 SOAP 管理端口, 如下图所示, 您可以登录 ND 的管理控制台查看 SOAP 端口 系统开始在集群单元中添加节点, 添加成功后注销并重新登录控制台查看节点信息, 集群节点和两个应用程序节点全部联合 如下图所示 : 通过以下步骤, 可以建立 WebSphere 6.1 集群 : 登录 Deployment 管理服务器的控制台, 单击导航树中的 服务器 \ 群集, 进入 服务器 集群 页面 单击 < 新建 > 按钮, 进入 创建新集群 页面 54

58 输入集群名称, 单击 < 下一步 > 按钮, 进入 创建新的群集成员 页面 通过 选择节点 下拉列表框选择 Node001, 如下图所示 单击 < 下一步 > 按钮, 创建 Node001 上的群集服务器 回到 创建新的群集成员 页面 中, 通过 选择节点 下拉列表框选择 Node002, 如下图所示 55

59 单击 < 添加成员 > 按钮, 创建 Node002 上的群集服务器 至此, 已新建了 Node001 和 Node002 上的群集服务器, 如下图所示 单击 < 完成 > 按钮, 返回 服务器群集 页面, 如下图所示 56

60 单击 查看 超链接, 系统提示 保存到主配置 选中 与节点同步更改 复选框后, 单 击 < 保存 > 按钮, 如下图所示 单击导航树中的 服务器 \ 应用程序服务器, 进入 应用程序服务器 页面, 查看新建的集群服务器, 如下图所示 其中, Managed1_Server1 和 Managed2_Server1 是新创建的群集服务器, 两个 server1 分别是 Node1 和 Node2 节点默认的服务器 选中两个 server1 左侧的复选框, 单击 < 删除 > 按钮, 删除默认服务器 ( 集群中不需要这两个默认服务器 ) 结果如下: 57

61 为每个受管服务器创建外置目录, 建议以 apps_config 为文件夹名, 外置配置目录用来存放应用启动配置和运行期的配置 通过管理控制台给每个受管服务器配置 JVM 的外置目录参数 EXTERNAL_CONFIG_DIR, 值为外置目录文件夹路径, 该路径需要用户在步骤 7 中手工创建如 :D:/IBM/WebSphere61/AppServer/profiles/Managed1 /Managed1_server1/apps_config, 如图所示 : 启动集群 在 WebSphere 集群上安装 EOS 应用, 必须确保集群各服务器已启动 本例 中分别运行管理服务器 Dmgr02, 被管服务器 Managed1 Managed2 各自的启动脚本 ( 位于服务器概要目录下的 bin 子目录下 ), 启动集群的所有服务器, 如图所示 58

62 通过安装包安装应用到集群 下面仅对应用服务器选择步骤进行说明, 安装步骤如下 : 选择应用服务器 选中集群复选框, 在应用服务器下拉框中选中 WebSphere6.1, 在 Deployment Manager Home 行点击 < 浏览 > 选择 Deployment Manager 概要文件目录, 安装包自动读出单元名称 (Cell Name) 和集群名称 (Cluster Name), 在 UserName 和 Password 文本框填写 profile 安全性用户名和密码 参数 Deployment Manager Home Cell Name Cluster Name User name PassWord 集群 说明 Deployment Manager 概要安装目录 例如 :/opt/webspherend61eos/profiles/dmgr02, 该目录为一个 Deployment Manager Home,Dmgr02 是用户创建的 Deployment Manager 的名称 管理服务器单元的名称 该参数会在选择正确的 Deployment Manager Home 之后自动填写, 用户无需手动更改 WebSphere 集群名称 该参数会在选择正确的 Deployment Manager Home 之后自动填写, 用户无需手动更改 创建具有管理安全性的 Deployment Manager Profile 时设置的用户名 创建具有管理安全性的 Deployment Manager Profile 时设置的用户密码 是否集群应用 59

63 安装完成后, 关闭集群, 在 搭建 Websphere 集群环境 创建的各个受管服务器的外置目录下创建以部署到该集群的应用名为名称的子目录, 如本例中 default, 在该应用配置子目录下创建 startup.conf 文件, 配置应用的绑定 IP 和管理端口, 格式如下 : AdminPort=6200 LocalIP= 用户应保证 LocalIP 值为受管服务器所在机器的一个真实 IP,AdminPort 值不被其他已部署应用占用 重启集群 保证 EOS 应用能正常运行必须重启一次集群, 至此安装完毕 加入 Governor 进行管理 安装 Governor 应用到另一个单机 profile 中, 或其他类型的应用服务器中, 安装过程请参考 安装企业版 本例中采用 tomcat 作为应用服务器 启动集群的各个 Server, 登陆管理控制台, 启动部署的应用, 确认启动状态, 如图所示, 否则 Governor 无法添加该应用 启动 Governor, 启动部署 Governor 的应用服务器, 登陆 Governor 控制台 点击应用管理, 添加集群被管应用 应用名称与 WebSphere 集群上的受管应用相同, IP 地址为部署该应用的 profile 的 IP 地址, 管理端口号为服务器管理该应用的端口, 可在前文配置的外置目录下的 startup.conf 文件中查看 选中加入新建的集群, 输入集群名称 单击 < 确定 > 重启集群, 察看 Governor 中被管应用, 已启动, 已同步 60

64 向集群中加入多个被管应用, 会将第一个应用中的 EOS 配置信息作为模板 添加完毕集群中所有应用, 除第一个应用外, 所有应用配置文件需要与模板文件进行同步操作, 此时需要重启其他应用以便同步 EOS 配置文件 如果选择了 BPS, 则需要对 BPS 引擎进行配置 依次选择 :BPS 引擎配置 -> 运行参数配置, 目标选择 testcluster, 选中 是否启用集群 后的复选框, 如图 注意 : 启用 BPS 引擎集群配置后重启集群 启动过程中, 控制台显示 BPS Cluster Framework is True!, 说明 BPS 引擎集群启用成功, 如图 加入 Workspace 进行管理 如果选择了 BPS, 则需要安装 workspace workspace 可以通过安装包进行安装, 安装时只需在安装选项中选择 workspace 即可, 也可以在上一步安装 governor 时同时安装 workspace 在 workspace 中添加受管引擎 登录 引擎实例管理, 将 ManagedServer1 和 ManagedServer2 添加到 workspace 中, 添加时测试连接是否正常, 保证添加的引擎是可用的, 如图 61

65 验证安装 以 Win7 + WebSphere DB2 UDB_V9.5 环境为例, 验证 Primeton EOS Platform 7.2 集群环境是否已正确安装的步骤如下 : 启动集群, 登陆管理服务器控制台 查看集群中每个受管服务器的 JVM 参数, 路径如 Application Servers -> Managed1_Server1 -> (Java 和进程管理 ) 进程定义 -> Java 虚拟机 -> 定制属性 62

66 如果组件选择部署 EJB 安装, 查看 JMS 配置, 查看 JMS 队列连接工厂 EOS_QUEUE_FACTORY, 作用域为集群 ; 查看 default 应用绑定队列,JNDI 名称分别为 %appname%/eos_invoke_queue %appname%/eos_result_queue, 队列名称分别为 default.eos_invoke_queue default.eos_result_queue, 作用域为集群 ; 查看队列相关激活规范 63

67 检查数据源 配置数据源存在, 测试连接成功 应用能够启动, 启动时无异常, 64

68 6. 手工安装 BPS Platform 支持标准 EAR 的部署方式, 用户可以用非常灵活的方式来安装应用, 除了通 过运行安装程序来一站式的安装部署之外, 还可以借助脚本工具的帮助来手工安装应用, 本章 主要介绍如何以手工方式安装应用 6.1. 手工安装业务应用 手工安装业务应用支持的应用服务器环境包括单机和集群, 以下描述了在单机和集群环境 下手工安装应用的详细步骤 准备应用服务器环境 应用服务器可以是未安装过 BPS Platform 应用的应用服务器, 也可以是已经安装过 BPS Platform 应用的应用服务器, 如果要支持集群, 需要搭建应用服务器的集群环境 ( 请参考 集群 安装 章节 ) 准备 EAR 应用 1. 安装 BPS Platform 开发版 2. 导出现有应用的 ear 文件通过 Studio, 将现有业务应用项目导出为 ear 文件, 具体导出步骤用户可参考 studio 的联机帮助文档的 产品介绍 / 使用参考 / 导出 / 导出 EAR 部分内容 拷贝 JDBC 驱动 jar 对于未安装过 BPS Platform 应用的应用服务器, 应拷贝 JDBC 驱动 jar, 针对不同的应用服 务器, 其 jar 拷贝的目标位置也不同, 分别如下 : Tomcat: 将 [ 安装光盘根目录 ]/syslib 下的 jar:ojdbc jar 65

69 mysql-connector-java bin.ja db2jcc.jar mssqlserver-3.0.jar 拷贝至 [TOMCAT_HOME]/lib 下 JBoss: 将 [ 安装光盘根目录 ]/syslib 下的 jar:ojdbc jar mysql-connector-java bin.ja db2jcc.jar mssqlserver-3.0.jar 拷贝至 [JBOSS_HOME]/server/default/lib 下 ( 如果是 JBoss6.1.0, 则还需要拷贝 jdom-1.0.jar) Weblogic: 将 [ 安装光盘根目录 ]/syslib 下的 jar:ojdbc jar mysql-connector-java bin.ja db2jcc.jar mssqlserver-3.0.jar 及 [ 安装光盘根目录 ]/syslib/weblogic/stax-api jar 拷贝至 [DOMAIN _HOME]/lib 下 在集群环境下, 需要将 jar 拷贝到每个被管服务器的 [DOMAIN _HOME]/lib 目录下 WebSphere: 将 [ 安装光盘根目录 ]/syslib 下的 jar:ojdbc jar mysql-connector-java bin.ja db2jcc.jar mssqlserver-3.0.jar 拷贝至 [PROFILE_HOME]/AppServer/lib/ext 下 在集群环境下, 需要将 jar 拷贝到每个被管服务器的 [PROFILE _HOME]/AppServer/lib/ext 目录下 对于已经安装过 EOS Platform 应用的应用服务器, 则不用拷贝上述 jar 部署数据源 JMS 等应用绑定资源 通过 studio 导出的标准 EAR 部署在应用服务器中, 其 EAR 本身还需要依赖应用服务器中配置的一些资源, 如数据源 JMS 等, 为方便用户快速创建这些资源, 屏蔽不同应用服务器配置方式上的差异, 安装包提供了用于部署应用绑定资源的工具, 该工具可以通过两种方式获取 : 1 安装企业版之后, 会在安装目录下创建工具, 位于 [ 安装目录 ]/tools 目录下 2 [ 安装光盘根目录 ]/tools 目录下该工具能快速帮助用户完成如下任务 : 1 配置 JNDI 数据源如果是 Tomcat 和 PAS, 需要自己配置 C3P0 数据源 ; 其他应用服务器需要配置 JNDI 数据源 2 配置 JMS 对于 JBoss, 会创建两个队列, 名称分别为 :[ 应用名 ]/EOS_INVOKE_QUEUE 和 [ 应用名 ]/EOS_RESULT_QUEUE; 对于 WebLogic, 会配置 JMS 系统持久性存储 JMS 服务器和基 66

70 本 JMS 系统模块等 ; 对于 WebSphere, 则会创建服务总线 连接工厂 队列 激活规范等 说明 : 如果导出的 EAR 没有选择 EJB, 则不用配置 JMS 资源 3 对于 WebSphere, 设置一些 JVM 参数具体的设置值参见 安装包配置修改 / WebSphere 应用服务器 如何使用资源部署脚本工具? 步骤 1: 修改 deployresources.properties 文件 deployresources.properties 文件位于 tools/bin 目录下, 该文件内容决定了 JNDI 数据源配置 JMS 配置 JavaEE 服务器配置等 不同的应用服务器和数据库下, 部署资源属性文件的配置也不相同, 其中数据源配置 JavaEE 服务器配置可参考 哑安装方式, 下面主要介绍部署应用相关属性的配置, 完整的配置示例可参考 部署资源配置文件示例 参数名称 参数意义 APP_NAME INSTALL_DIR IS_DEPLOY_DATASOURCE IS_DEPLOY_JMSQUEUE IS_SET_WAS_JVM WEBLOGIC_CLUSTER_JMS_DS_NAME IS_CLUSTER CLUSTER_NAME 应用名, 为必填参数 安装目录, 可选参数 是否配置数据源, 选择 true 则需填写相关数据源属性 是否配置 JMS, 为 true, 则为配置 JMS 是否配置 JVM 参数, 仅当应用服务器类型为 WebSphere 该值有效, 为 true, 配置 JVM 参数 当 weblogic 集群环境下配置 JMS 时,JMS 持久性存储使用的数据源名称 是否集群,weblogic 和 WebSphere 时该值有效, 为 true, 需按集群方式配置服务器, 设置集群名称 配置 Weblogic 或 websphere 集群的名称 步骤 2: 执行 deployresources.cmd 或 deployresources.sh 工具会根据 deployresources.properties 的配置项完成对资源的配置, 在配置之前, 会对配置项的值作一些基本的校验, 校验不通过, 将不能部署 对于 WebLogic 和 WebSphere 应用服务器, 如果在工具执行之前, 服务器已处于启动状态, 则工具执行完后, 不会停止服务器, 否则, 在工具执行过程中, 会启动服务器, 执行完成后, 会停止服务器 67

71 部署应用 标准 EAR/WAR 支持两种部署方式, 分别是文件方式和目录方式 文件形式的 EAR/WAR 是一个后缀名为.ear 或.war 的单个文件, 其结构为 : App1.ear( 文件 ) - META-INF - eos-access-ejb.jar - default.war( 文件 ) -... 目录形式的 EAR/WAR 是一个名称为 [ 应用名 ].EAR 或 [ 应用名 ].WAR 的目录, 其结构为 : App1.ear( 目录 ) - META-INF - eos-access-ejb.jar - default.war( 目录 ) - WEB-INF( 目录 ) -... 除 WebSphere 只能采用文件方式部署之外, 其它应用服务器两种部署方式都支持, 但采用目录方式部署, 可以使增量部署 (ECD 方式部署 ) 更加方便, 所以推荐采用目录方式部署 下面分别介绍在不同应用服务器部署应用的步骤 : 1 Tomcat 1) 文件方式 : 将 WAR 文件, 如 app1.war 复制到 [TOMCAT_HOME]/webapps 目录下, 服务器启动后会自动部署 WAR 应用 2) 目录方式 : 将 WAR 目录, 如将 app1.war 解压至目录 app1, 将 app1 目录复制到 [TOMCAT_HOME]/webapps 目录下 2 JBoss 1) 文件方式 : 将 EAR/WAR 文件复制到 [JBOSS_HOME]/server/default/deploy 目录下, 服务器启动后会自动部署 EAR 应用 2 ) 目录方式 : 将 EAR/WAR 目录, 如 app1.ear 或 app1.war 目录复制到 [JBOSS_HOME]/server/default/deploy 目录下 3 WebLogic 以 WebLogic 10.3 为例 : 1) 文件方式 : 68

72 步骤 1: 登录 WebLogic 控制台, 点击左侧资源树 [DOMAIN_NAME]/Deployments 步骤 2: 点击 Install, 定位到 EAR 文件所在目录, 选择 EAR 文件步骤 3: 点击 Next, 选择 Install this deployment as an application 步骤 4: 点击 Next, 选择目标服务器 ( 如果域中存在多于一个服务器或集群 ) 步骤 5: 点击 Next, 设置应用部署选项步骤 6: 点击 Finish, 完成部署 2) 目录方式 : 目录方式与文件方式步骤相同, 只是在步骤 2, 选择 EAR 目录即可 4 WebSphere WebSphere 只支持文件方式部署, 以 WebSphere 6.1 为例 : 步骤 1: 登录 WebSphere 控制台, 点击左侧资源树 应用程序 / 企业应用程序 步骤 2: 点击 安装, 在 完整路径 中选择 EAR 文件的路径步骤 3: 点击 下一步, 直至 完成 注意 : 在 WebLogic 和 WebSphere 部署应用时, 尽量不要修改默认的应用上下文路径 配置外置目录和启动参数 一 创建外置目录用户需要手工创建外置目录, 外置配置目录用来存放应用启动配置和运行期的配置, 外置目录建议以 apps_config 为文件夹名, 其目录结构为 : apps_config - default - startup.conf 在该目录下需要手工创建应用子目录, 目录名称和已经部署的应用名称一致, 如 default, 在该应用配置子目录下创建 startup.conf 文件, 配置应用的绑定 IP 和管理端口, 格式如下 : AdminPort=6200 LocalIP= 用户应保证 LocalIP 值为目标机器的一个真实 IP 在多网卡多 IP 系统中,IP 设置不正确会 69

73 因网段划分问题而导致应用无法被访问和管理 AdminPort 值不被其他已部署应用占用 二 修改应用服务器启动脚本 EOS 应用启动需要 JVM 参数 EXTERNAL_CONFIG_DIR, 其值是外置目录的路径, 所以需要修改应用服务器的启动脚本, 以添加该参数 有两种方式可以实现 : 方式 1: 创建新的启动脚本对于 Tomcat JBoss WebLogic 应用服务器, 用户可以新建启动脚本, 如在 windows 环境下为 startserver.cmd, 类 UNIX 环境下为 startserver.sh, 增加 JVM 参数, -DEXTERNAL_CONFIG_DIR 参数, 调用应用服务器的启动脚本 如 windows 环境下, 关键行如下 : set EXTERNAL_CONFIG_DIR=D:/primeton/platform/apps_config set JAVA_OPTIONS=%JAVA_OPTIONS% -DEXTERNAL_CONFIG_DIR="%EXTERNAL_CONFIG_DIR%" 对于 WebSphere 应用服务器环境, 用户需要登陆 profile 管理控制台, 进入 Application Servers -> server1 -> (Java 和进程管理 ) 进程定义 -> Java 虚拟机 -> 定制属性, 增加 EXTERNAL_CONFIG_DIR 参数 WebLogic WebSphere 集群环境下需要为集群每个受管服务器配置外置目录 EXTERNAL_CONFIG_DIR 参数 更多内容详见第 5 章集群安装 附录中提供几个典型环境下的启动脚本文件示例, 仅供参考 方式 2: 手工修改应用服务器启动脚本用户也可以手工修改应用服务器的启动脚本, 以增加 JVM 参数 针对不同的应用服务器, 其配置文件的修改如下 : 1)Tomcat: 修改 [TOMCAT_HOME]/bin/catalina.bat 或 catalina.sh, 在 catalina.bat 的开始位置增加如下内容 ( 示例 ): set EXTERNAL_CONFIG_DIR=D:/primeton/platform/apps_config set JAVA_OPTS=%JAVA_OPTS%... -DEXTERNAL_CONFIG_DIR="%EXTERNAL_CONFIG_DIR%" 在 catalina.sh 的开始位置增加如下内容 ( 示例 ): export EXTERNAL_CONFIG_DIR=/usr/primeton/platform/apps_config export JAVA_OPTS= ${JAVA_OPTS}... -DEXTERNAL_CONFIG_DIR="${EXTERNAL_CONFIG_DIR}" 2)JBoss: 70

74 修改 [JBOSS_HOME]/bin/run.bat 或 run.sh, 在 run.bat 的开始位置增加如下内容 ( 示例 ): set EXTERNAL_CONFIG_DIR=D:/primeton/platform/apps_config set JAVA_OPTS= %JAVA_OPTS%... -DEXTERNAL_CONFIG_DIR="%EXTERNAL_CONFIG_DIR%" 在 run.sh 的开始位置增加如下内容 ( 示例 ): export EXTERNAL_CONFIG_DIR=/usr/primeton/platform/apps_config export JAVA_OPTS= ${JAVA_OPTS} -DEXTERNAL_CONFIG_DIR="${EXTERNAL_CONFIG_DIR}"... 3)Weblogic 修改 [DOMAIN_HOME]/startWebLogic.cmd 或 startweblogic.sh,startweblogic.cmd 修改如下 ( 示例 ):... set EXTERNAL_CONFIG_DIR=D:/primeton/platform/apps_config set JAVA_OPTIONS=%JAVA_OPTIONS% -DEXTERNAL_CONFIG_DIR="%EXTERNAL_CONFIG_DIR%" call "%DOMAIN_HOME%/bin/startWebLogic.cmd" %* startweblogic.sh 修改如下 ( 示例 ):... export EXTERNAL_CONFIG_DIR=/usr/primeton/platform/apps_config export JAVA_OPTIONS= ${JAVA_OPTIONS} -DEXTERNAL_CONFIG_DIR="${EXTERNAL_CONFIG_DIR}" call "%DOMAIN_HOME%/bin/startWebLogic.cmd" %* 4)WebSphere 登录 WebSphere 管理控制台, 增加 JVM 参数, 步骤参见上述方式 1 创建新的启动脚本 中 WebSphere 的添加方法 WebLogic WebSphere 集群环境下需要为集群每个受管服务器配置外置目录 EXTERNAL_CONFIG_DIR 参数 另外, 推荐在启动脚本中添加如下 JVM 调优参数 : Windows 下为 : set JAVA_OPTIONS=%JAVA_OPTIONS% -Xms128m -Xmx512m -XX:MaxPermSize=128m -XX:+HeapDumpOnOutOfMemoryError Unix 下为 : export JAVA_OPTIONS= ${JAVA_OPTIONS} -Xms128m -Xmx512m -XX:MaxPermSize=128m -XX:+HeapDumpOnOutOfMemoryError 71

75 修改应用服务器配置 1)Tomcat 服务器 : 修改 [TOMCAT_HOME]/conf/ server.xml 文件, 红色部分为新增内容 ( 下同 )... <Service name="catalina">... <Connector URIEncoding="UTF-8" port="8080" maxhttpheadersize="8192" maxthreads="150" minsparethreads="25" maxsparethreads="75" enablelookups="false" redirectport="8443" acceptcount="100" connectiontimeout="20000" disableuploadtimeout="true" /> <Connector URIEncoding="UTF-8" port="8009" enablelookups="false" redirectport="8443" protocol="ajp/1.3" /> </Service>... 2)JBoss4.0.5 服务器修改 [JBOSS_HOME]/server/default/deploy/jbossweb-tomcat55.sar/conf/web.xml 文件 : <servlet> <servlet-name>jsp</servlet-name> <servlet-class>org.apache.jasper.servlet.jspservlet</servlet-class>... <init-param> <param-name>compilersourcevm</param-name> <param-value>1.5</param-value> </init-param>... </servlet> 修改 [JBOSS_HOME]/server/default/deploy/ear-deployer.xml 文件 : <server> <mbean code="org.jboss.deployment.eardeployer" name="jboss.j2ee:service=eardeployer"> <attribute name="isolated">true</attribute> <attribute name="callbyvalue">true</attribute> </mbean> </server> 3)JBoss6.1.0 服务器修改 [JBOSS_HOME]/server/default/deploy/jbossweb.sar/web.xml 文件 : <servlet> 72

76 <servlet-name>jsp</servlet-name> <servlet-class>org.apache.jasper.servlet.jspservlet</servlet-class>... <init-param> <param-name>compilersourcevm</param-name> <param-value>1.5</param-value> </init-param>... </servlet> 修改 [JBOSS_HOME]/server/default/deployers/ear-deployer-jboss-beans.xml 文件 : <bean name="jbossappparsingdeployer" class="org.jboss.deployment.jbossappparsingdeployer"> <property name="callbyvalue">true</property> <bean name="earclassloaderdeployer" class="org.jboss.deployment.earclassloaderdeployer"> <property name="isolated">true</property> </bean> 4)WebSphere 需要修改应用的类装入器顺序, 具体步骤如下 : 1 登陆 profile 管理控制台, 进入 应用程序 -> 企业应用程序 ->default-> 类装入和更新检测, 选择 类已装入并且是先使用应用程序类装入器 2 进入 应用程序 -> 企业应用程序 ->default-> 管理模块 -> default.war-> 类装入器, 选择 类已装入并且是先使用应用程序类装入器 注意 : 对于 Tomcat JBoss, 如果选择的应用服务器已经通过安装包安装过了 EOS 应用, 则上述配置的修改可以省 略 验证部署 1 资源部署脚本文件成功运行, 无异常 2 正常运行修改后的启动脚本, 启动应用服务器 3 登录服务器管理控制台查看 JVM 参数 数据源 JMS 配置正确 73

77 6.2. 部署资源配置文件示例 下面提供不同应用服务中部署资源工具配置文件 (deployresources.properties) 示例, 仅供参考, 具体参数值需要根据实际情况填写, 红色字体部分是每种应用服务器的不同配置之处 1 WebSphere6.1 # application name APP_NAME=default # EOS install Home, For example: C:/primeton/eos INSTALL_DIR=D:/IBM/WebSphere61/AppServer/profiles/AppSrv01/server1 # datasource name DB_DS_JNDI_NAME=TestDataSource #DataBase Type, for example: Oracle,DB2 UDB,SQLServer,Sybase,Informix,MySql DB_TYPE=MySql #JDBC Driver DB_DRIVER=org.gjt.mm.mysql.Driver #DataBase Server IP DB_IP= #Is Default JDBC Driver,the value is "false",then DB_JDBC_LIBS can't be null DB_IS_DEFAULT_JAR=true #User Defined JDBC Jar,For example:d:/jdbc/a.jar;d:/jdbc/b.jar DB_JDBC_LIBS= #DB Instance Name DB_NAME=chenjian #DB User DB_USERNAME=root #DB User's Password DB_PASSWORD=123 #DB Server Port DB_SERVER_PORT=3306 #JDBC Url, DB_URL=jdbc:microsoft:sqlserver:// x.x:1433;DatabaseName=xxx;SelectMethod=Curso r DB_URL=jdbc:mysql:// :3306/chenjian # Application server type name, value must be one of: Tomcat / JBoss / WebLogic / WebSphere APP_SERVER_TYPE=WebSphere #Configuration WebSphere information AS_WAS_PROFILE_HOME=D:/IBM/WebSphere61/AppServer/profiles/AppSrv01 74

78 AS_WAS_CELL_NAME=dnzj cfNode01Cell AS_WAS_NODE_NAME=dnzj cfNode01 AS_WAS_SERVER_NAME=server1 AS_WAS_USERNAME=chenjian AS_WAS_PASSWORD=chenjian #If you do not want to deploy data source,set IS_DEPLOY_DATASOURCE to false IS_DEPLOY_DATASOURCE=true #If you do not want to deploy JMS queues,set IS_DEPLOY_JMSQUEUE to false IS_DEPLOY_JMSQUEUE=true #If you do not want to set websphere jvm, set IS_SET_WASCLUSTER_JVM to false IS_SET_WAS_JVM=true # uncomment the following if you want to deploy resources to cluster, and set iscluster to true IS_CLUSTER=false # cluster name CLUSTER_NAME= 2 WebLogic # application name APP_NAME=default # EOS install Home, For example: C:/primeton/eos INSTALL_DIR=D:/IBM/WebSphere61/AppServer/profiles/AppSrv01/server1 # datasource name DB_DS_JNDI_NAME=TestDataSource #DataBase Type, for example: Oracle,DB2 UDB,SQLServer,Sybase,Informix,MySql DB_TYPE=MySql #JDBC Driver DB_DRIVER=org.gjt.mm.mysql.Driver #DataBase Server IP DB_IP= #Is Default JDBC Driver,the value is "false",then DB_JDBC_LIBS can't be null DB_IS_DEFAULT_JAR=true #User Defined JDBC Jar,For example:d:/jdbc/a.jar;d:/jdbc/b.jar DB_JDBC_LIBS= #DB Instance Name DB_NAME=chenjian #DB User DB_USERNAME=root #DB User's Password DB_PASSWORD=123 75

79 #DB Server Port DB_SERVER_PORT=3306 #JDBC Url, DB_URL=jdbc:microsoft:sqlserver:// x.x:1433;DatabaseName=xxx;SelectMethod=Curso r DB_URL=jdbc:mysql:// :3306/chenjian # Application server type name, value must be one of: Tomcat / JBoss / WebLogic / WebSphere APP_SERVER_TYPE=WebLogic #Configuration WebLogic information AS_WL_BEA_HOME=d:/bea AS_WL_HOME=D:/bea/wlserver_10.3 AS_WL_DOMAIN_HOME=D:/bea/user_projects/domains/eos_domain AS_WL_TARGET_SERVER=Cluster-0 AS_WL_USERNAME=weblogic AS_WL_PASSWORD=weblogic USER_IP= AS_WL_WEBSVR_PORT=7001 #If you do not want to deploy data source,set IS_DEPLOY_DATASOURCE to false IS_DEPLOY_DATASOURCE=true #If you do not want to deploy JMS queues,set IS_DEPLOY_JMSQUEUE to false IS_DEPLOY_JMSQUEUE=true #If you do not want to set websphere jvm, set IS_SET_WASCLUSTER_JVM to false IS_SET_WAS_JVM=false # uncomment the following if you want to deploy resources to cluster, and set iscluster to true IS_CLUSTER=false # cluster name CLUSTER_NAME= 3 JBoss # application name APP_NAME=default # EOS install Home, For example: C:/primeton/eos INSTALL_DIR=D:/IBM/WebSphere61/AppServer/profiles/AppSrv01/server1 # datasource name DB_DS_JNDI_NAME=TestDataSource #DataBase Type, for example: Oracle,DB2 UDB,SQLServer,Sybase,Informix,MySql DB_TYPE=MySql 76

80 #JDBC Driver DB_DRIVER=org.gjt.mm.mysql.Driver #DataBase Server IP DB_IP= #Is Default JDBC Driver,the value is "false",then DB_JDBC_LIBS can't be null DB_IS_DEFAULT_JAR=true #User Defined JDBC Jar,For example:d:/jdbc/a.jar;d:/jdbc/b.jar DB_JDBC_LIBS= #DB Instance Name DB_NAME=chenjian #DB User DB_USERNAME=root #DB User's Password DB_PASSWORD=123 #DB Server Port DB_SERVER_PORT=3306 #JDBC Url, DB_URL=jdbc:microsoft:sqlserver:// x.x:1433;DatabaseName=xxx;SelectMethod=Curso r DB_URL=jdbc:mysql:// :3306/chenjian # Application server type name, value must be one of: Tomcat / JBoss / WebLogic / WebSphere APP_SERVER_TYPE=JBoss #JBOSS HOME AS_JBOSS_HOME=D:/appserver/jboss GA #If you do not want to deploy data source,set IS_DEPLOY_DATASOURCE to false IS_DEPLOY_DATASOURCE=true #If you do not want to deploy JMS queues,set IS_DEPLOY_JMSQUEUE to false IS_DEPLOY_JMSQUEUE=true #If you do not want to set websphere jvm, set IS_SET_WASCLUSTER_JVM to false IS_SET_WAS_JVM=false # uncomment the following if you want to deploy resources to cluster, and set iscluster to true IS_CLUSTER=false # cluster name CLUSTER_NAME= 77

81 注意 : 工具中提供的 deployresources.properties 文件同时包含了以上应用服务器的配置项, 在实际使用时, 只需要根 据 APP_SERVER_TYPE 的值, 设置其对应的应用服务器配置项, 其它应用服务器设置项可以忽略 78

82 附录 附录 A 安装目录说明 安装目录下的各个子目录及其说明如下表所示 目录 说明 开发版 企业版公共目录 apps_config apps_config\governor apps_config\default apps_config\workspace tools ico 应用配置目录 governor 应用配置目录 用户创建的默认应用配置目录, 本例为 default, 应以用户实际创建的应用名为准 Workspace 应用配置目录 脚本工具目录 说明 : 开发版该目录下提供 apache-ant 工具 企业版该目录下提供部署资源脚本工具, 配置文件及 相关 jar 文件 图标目录 开发版目录 apache-tomcat apache-tomcat \webapps apache-tomcat \webapps\def ault apache-tomcat \webapps\wor kspace apache-tomcat \webapps\gov ernor apache-tomcat \webapps\sso -server apache-tomcat \logs ide ide\eclipse\dropins\platform_ \plugins ide\eclipse\workspace Tomcat 相关文件目录 Server 部署目录 default 应用目录 workspace 应用目录 Governor 应用目录 SSO Server 应用目录 tomcat 日志文件目录 Studio 相关文件目录插件目录缺省的工作区目录, 存放各个项目 79

83 目录 ide\eclipse\configuration\eos_studi o_config uninstall 企业版目录 Studio 配置文件目录 卸载目录 说明 jdk 应用服务器类型为 Tomcat JBoss 时提供 80

84 附录 B FAQ 本部分列举产品安装过程中的常见问题, 以及问题出现的可能原因和解决方法, 仅供参考 1. 应用服务器为 JBOSS 时, 启动时报异常 解决策略 : 修改 jboss 目录 server\default\deploy\sso-server.war\web-inf 下的 web.xml 文件, 将其中 <context-param> <param-name>log4jconfiglocation</param-name> <param-value>classpath:log4j.properties</param-value> </context-param> <context-param> <param-name>log4jexposewebapproot</param-name> <param-value>false</param-value> </context-param> <listener> <listener-class> org.springframework.web.util.log4jconfiglistener </listener-class> </listener> 这三段注释掉 同时, 删除 jboss ga\server\default\deploy\sso-server.war\web-inf\lib 下的 log4j jar 2. 数据库为 mysql 时, 前台出现乱码 解决策略 : 新建 mysql 数据库时, 将编码设置为 UTF-8 3. Weblogic 新建 domain 未启动过的情况下安装 EOS 会报错, 错误信息为空, 不能安装 解决策略 : 安装 EOS 前需手动启动 Weblogic 81

85 Primeton Platform 7.2 产品安装指南 4. Oracle 9i 环境下, 启动 EOS Server 提示端口被占用 可能原因 : Oracle9i 占用了 TOMCAT 的默认端口 8080 解决方法 : 方法 1: 在 Oracle Enterprise Console 中 [xml 数据库 / 配置 ], 修改 Oracle xdb 端口 方法 2: 修改 %TOMCAT_HOME%\conf\server.xml 文件中 TOMCAT 的端口号, 修改部分如下 <Connector port="8080" maxthreads="150" minsparethreads="25" maxsparethreads="75" enablelookups="false" redirectport="8443" acceptcount="100" debug="0" connectiontimeout="20000" disableuploadtimeout="true" URIEncoding="GBK" /> 方法 3: 若 Oracle 并非为 EOS 所用, 可以先启动 EOS Server, 再启动 Oracle,Oracle 将动态分配端口 5. Oracle 9i 环境下, 安装 EOS 过程中, 执行到 配置数据库 步骤时, 数据库连接测试失败 可能原因 : 原因 1: 由于只能提供一个版本的 JDBC 驱动程序, 而数据库不同版本之间存在 JDBC 的差异, 因此导致出现数据库连接的问题 原因 2: 另外一个可能原因是由于防火墙导致无法连接 解决方法 : 方法 1: 安装时若不能连接数据库,tomcat JBoss 环境下可以先取消初始化数据库选项, 继续安装 在安装完成后通过启动 EOS Server, 登录 EOS GOVERNOR, 单击导航树中 管理 / 数据库初始化 节点, 输入数据库相关信息 ( 需要替换合适的 JDBC 驱动或者使用合适的 Driver Class) 进行数据库的初始化 WebLogic WebSphere 环境下安装时必须能连接数据库, 否则安装不能成功完成 方法 2: 关闭防火墙 82

86 Primeton Platform 7.2 产品安装指南 6. 初始化数据库时报错, 表或视图不存在 可能原因 : 数据库初始化脚本未做表是否存在的校验, 此错误不影响初始化效果 解决方法 : 再对数据库进行一次初始化 启动 Server, 登录 Governor, 单击导航树中 管理 / 数据库初始化 节点, 输入数据库相关信息后进行数据库的初始化 7. WAS 服务器环境下页面乱码 可能原因 : 除了常规的页面编码设置等, 还可能是 WAS 控制台配置问题解决方法 : 确保 WAS 安装目录下 AppServer/properties/encoding.properties 中的 zh 属性为 UTF-8 另外, 在 WAS 控制台如下目录 :Application servers > server1 > Process definition > Java Virtual Machine( 视实际环境该路径略有差别 ) 中增加 Generic JVM arguments, 如下 : -Ddefault.client.encoding=UTF-8 -Dfile.encoding= UTF-8 -Duser.language=Zh -Duser.region=CN 8. 安装包中的 JDK 切换,SQL Server 数据库初始化报驱动 类版本问题 可能原因 : SQL Server 的 jdbc 驱动区分 JDK 版本解决方法 : 从安装包的 resources/as_comps/lib/jdbc 目录下拷贝相应的 jar 包 mssqlserver-3.0.jar: 用于 jdk1.6 以上环境 ; mssqlserver-3.0-jdk15.jar: 用于 jdk1.5 环境 83

87 Primeton Platform 7.2 产品安装指南 附录 C 安装包配置修改 安装时, 对应不同的应用服务器, 会修改相关的应用服务器配置文件 下面罗列了安装 时对应修改的应用服务器配置文件列表 1. Tomcat 应用服务器 文件名称文件说明操作说明存放位置 server.xml 应用服务器描述文件 Resource 节点配置了数据源相关参数 \%TOMCAT_HOME% \conf\server.xml context.xml 应用上下文描述文件 ResourceLink 节点配置数据源引用 \%TOMCAT_HOME% \conf\context.xml 2. JBoss 应用服务器 文件名称文件说明操作说明存放位置 web.xml Web 应用服务器描述文件 增加了 compilersourcevm 参数, 值为 1.5 \%JBOSS_HOME%\ser ver/default/deploy/jboss web-tomcat55.sar/conf/ web.xml web.xml sso-server 应用配置文件 注释其中有关于 log4j listener 的配置 \%JBOSS_HOME%\ser ver/default/deploy/sso-se rver.war/web-inf/web. xml ear-deployer.xml EAR 部署配置文件 修改了 Isolated=true 和 CallByValue=true \%JBOSS_HOME%\ser ver/default/deploy/ear-d eployer.xml DefaultDataSource-ds.x ml 数据源配置文件 配置应用数据源 \%JBOSS_HOME%\ser ver/default/deploy/ DefaultDataSource-ds.x ml 3. WebLogic 应用服务器 文件名称文件说明操作说明存放位置 DefaultDataS ource-3718-j dbc.xml 数据源配置文件 配置数据源 \%DOMAIN_HOME% \config\jdbc config.xml 应用服务器配置信息 配置 Admin Server 配置发布 EOS 应用的服务器 EOS 相关的 jms 配 \%DOMAIN_HOME% \config\config.xml 84

88 Primeton Platform 7.2 产品安装指南 文件名称文件说明操作说明存放位置 eossystemmo dule-jms.xml Jms 配置信息 置 配置 EOS 相关的数据源配置 EOS 的 jms 配置 \%DOMAIN_HOME% \config\jms 4. WebSphere 应用服务器 由于 WebSphere 的配置是通过 jacl 脚本自动配置的, 因此无法确定实际修改的配置文件, 这里只能列出修改的配置项, 这些配置项可以通过 WebSphere 的管理控制台看到 配置项 配置说明 操作说明 EXTERNAL_CONFIG_DIR JVM 参数 应用程序服务器 >server1> 进程定义 >Java 虚拟机 > 定制属性, 值为外置目录 JCEProvider JVM 参数 应用程序服务器 >server1> 进程定义 >Java 虚拟机 > 定制属性, 值为 IBMJCE Xgcpolicy JVM 参数 应用程序服务器 >server1> 进程定义 >Java 虚拟机 > 定制属性, 值为 gencon com.ibm.websphere.orb.uniqueserver 应用程序服务器 >server1> 进程定 JVM 参数 Name 义 >Java 虚拟机 > 定制属性, 值为 true java.awt.headless JVM 参数 应用程序服务器 >server1> 进程定义 >Java 虚拟机 > 定制属性, 值为 true java.net.preferipv4stack JVM 参数 应用程序服务器 >server1> 进程定义 >Java 虚拟机 > 定制属性, 值为 true javax.xml.soap.saajmetafactory JVM 参数 应用程序服务器 >server1> 进程定义 >Java 虚拟机 > 定制属性, 值为 com.sun.xml.messaging.saaj.soap.saa JMetaFactoryImpl com.sun.xml.messaging.saaj.soap.sa 应用程序服务器 >server1> 进程定 JVM 参数 AJMetaFactoryImpl 义 >Java 虚拟机 > 定制属性, 值为 true com.ibm.ws.webcontainer.invokefilter scompatibility Web 容器定制属性 应用程序服务器 > server1 > Web 容器 > 定制属性 eos_jms_bus jms 配置 服务集成 > 总线 >eos_jms_bus EOS_QUEUE_FACTORY jms 配置 资源 >JMS> 队列连接工厂 > EOS_QUEUE_FACTORY default.eos_invoke_queue 同上 资源 >JMS> 队列 default.eos_result_queue 同上 资源 >JMS> 队列 default.eos_invoke_queue 同上 资源 >JMS> 激活规范 default.eos_result_queue 同上 资源 >JMS> 激活规范 85