普元信息技术股份有限公司

Transcription

1 普元信息技术股份有限公司 EOS Platform 7.6 产品安装指南 I

2 文档修订记录 序号版本号修订日期修订概述修订人审批人备注 II

3 目录 1. 概述 开发版的安装内容 企业版的安装内容 配置要求 硬件配置 软件配置 安装 界面交互安装 安装开发版 安装企业版 哑安装 哑安装相关配置文件 如何配置哑安装属性文件 哑安装配置文件典型示例 集群安装 集群安装典型场景 WebLogic 集群安装 WebSphere 集群安装 手工部署安装 手工安装业务应用 部署资源配置文件示例 卸载 卸载开发版 卸载注意 卸载步骤 验证卸载 卸载企业版 附录 附录 A 安装目录说明 附录 B FAQ 应用服务器为 JBOSS 时, 启动时报异常 数据库为 mysql 时, 前台出现乱码 Weblogic 新建 domain 未启动过的情况下安装 EOS 会报错, 错误信息为空, 不能 安装 Oracle 9i 环境下, 启动 EOS Server 提示端口被占用 Oracle 9i 环境下, 安装 EOS 过程中, 执行到 配置数据库 步骤时, 数据库连接测 试失败 初始化数据库时报错, 表或视图不存在 WAS 服务器环境下页面乱码 安装包中的 JDK 切换,SQL Server 数据库初始化报驱动类版本问题 Weblogic 服务器安装包安装过程中, 出现数据库驱动类加载异常 III

4 10. 在 Win10 环境下安装产品时创建快捷方式失败 在 macos sierra 系统下 Server 启动非常慢 在 Websphere 应用服务器下安装产品时报找不到数据库驱动的错误 部分用户 Mac 开发版安装时会出现 HeadlessException 附录 C 安装包配置修改 JBoss 应用服务器 WebLogic 应用服务器 WebSphere 应用服务器 附录 D 界面安装应用服务器参数 附录 E 创建表空间 附录 F MySQL5.6 的配置 附录 E 企业版安装在 Tomcat8.5.5 的配置 IV

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

6 1.2. 企业版的安装内容 企业版面向 EOS Platform 应用部署人员和使用人员, 提供应用在线开发 运行 管理的环境 安装内容包括 : EOS Server( 运行环境 ) Governor( 治理工具 ) Component Library( 构件库 ) RichWeb( 富页面框架 ) NUI( 新一代前端开发框架 ) Process Server( 流程核心引擎 ) Workspace( 流程工作台, 提供流程定制与管控 引擎实例管理 ) Coframe( 组织机构权限框架 ) SSO Server( 单点登录服务器 ) 2

7 2. 配置要求 2.1. 硬件配置 安装产品的硬件配置要求 : 硬件 要求 CPU 内存 硬盘空间 主频 2.0GHz 以上 1G 以上 开发版 : 临时目录空间 :500M 以上 安装目录空间 :2G 以上 企业版 : 临时目录空间 :500M 以上 安装目录空间 :1G 以上 2.2. 软件配置 安装产品的软件配置要求 : 软件操作系统数据库 JavaEE 应用服务器 开发版 : 要求 Windows 2003/XP/7/8/10(32 位或者 64 位 ) Mac OS X EI Capitan (64 位 ) 企业版 : Windows 2003/XP/7/8/10 Red Hat Enterprise Linux 3/7.2 AIX 6.1 HPUX Solaris 8 Oracle 9i/10g/11g/12c DB2 8.2/9.5/9.7 SqlServer 2000/2005/2008/2012 MySQL /5.5.40/ DM V7 KingbaseES V7 GBase 8s Oscar V7 说明 : 数据库表空间大小需大于 100MB 需要准备一个数据库用户, 用于初始化数据库操作, 且该用户具有创建 修改 删除表的权限 如果使用 DB2 数据库, 则需再创建一个页大小为 32KB 的用户表空间, 名字为 EOSWFCTX, 以及创建一个页大小为 32KB 的临时表空间, 临时表空间名字可自定义 创建表空间的 SQL 语句请参见附录 E 如果使用 MySQL5.6., 则需要在 MySQL 的安装目录中进行配置, 否则初始化数据库时会失败,MySQL 的具体配置请参见附录 F 开发版 : Tomcat7.0.54( 安装包中自带 ) 3

8 软件 要求 企业版 : Tomcat /6.0.18/6.0.41/7.0.54/8.5.5 JBoss GA/6.1.0.Final WebLogic 9.2/10.0/10.3/10.3.5/ WebSphere6.1/7.0/8.5 TongWeb5.0 说明 : WebLogic9.2/10.0/10.3/ WebSphere6.1/7.0 支持集群安装 开发版 : 默认使用安装包中自带的 JDK, 不使用本地 JDK 企业版 : 如果安装时选择 WebSphere Weblogic 应用服务器, 则使用 WebSphere Weblogic 自带的 JDK 如果安装时选择 JBoss Tomcat TongWeb 应用服务器时, 则需 要用户自己选择 JAVA_HOME JDK 说明 : 用户可以修改安装启动程序 install.cmd/install.sh 中的 JAVA_HOME 变量来更换 JDK; 同样也可以修改卸载程序中的 JAVA_HOME 变量来更换 JDK 如果很少使用 RMI, 在启动脚本中, 请手工调整相关的 jvm 参数, 例如 :-Dsun.rmi.dgc.client.gcInterval= Dsun.rmi.dgc.server.gcInterval= 即改参数设置 rmigc 间隔为 10 分钟, 以提高性能 ( 安装时的默认值为 1 分钟 ) 如果较少使用 RMI, 该时间可以设置较长 ; 反之, 如果较多使用 RMI, 该时间可以设置较短 浏览器 IE 7/8/9/10/11 Firefox 31/50 Chrome 40/56 注 : 安装包自带 JDK 版本为 1.6.0_45 3. 安装 4

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

10 步骤 3: 阅读开发版的许可声明后, 选择 本人接受许可协议条款 单选按钮, 单击 < 下一步 > 按钮 步骤 4: 单击 < 浏览 >, 从弹出的对话框中选择安装目录, 单击 < 下一步 > 按钮 6

11 带空格 注意 : 安装路径最多可输入 64 个字符, 只能由半角英文字母 数字 点. 或下划线 _ 组成, 且不允许 步骤 5: 选择端口号 ( 访问应用的端口号 ) 7

12 步骤 6: 安装选项, 选择安装组件 安装组件有 COFRAME BPS 和 SSO, 都为可选项 步骤 7: 设置管理员口令 使用 Governor 管理员用户名和口令可以登录管理监控应用 Governor, 进行应用的管理 8

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

14 默认端口号为 6200 端口号 6299 为保留端口号, 默认被 governor 使用, 不能使用 端口号 6399 为保留端口号, 默认被 workspace 使用, 不能使用 端口不自动累加, 不做冲突检查, 用户配置端口号时请自己保证端口号不冲突 步骤 9: 创建应用, 用户填写应用名称, 应用名默认为 default, 可选部署 governor 应用以 及 workspace 应用 单击 < 下一步 > 按钮 注意 : 应用名称应遵循下面规则 : 应用名的长度必须在 3~64 之间, 只支持半角英文字母和数字, 支持., _, -, 以字母开头 不允许使用 governor,workspace 做应用名 如果 BPS 未选择安装,workspace 应用默认不安装 10

15 步骤 10: 配置数据库 配置数据库界面的参数说明 : 11

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

17 对于已经初始化过的数据库, 安装包会提示, 用户可以选择再次初始化或者不初始化单击 < 数据库连接测试 > 按钮, 测试所配置数据库是否可以成功连接 步骤 11: 阅读并审核安装设置信息, 单击 < 安装 > 按钮 步骤 12: 开始安装, 安装过程中显示各组件的安装进程 13

18 步骤 13: 程序提示开发环境已经成功安装 步骤 14: 单击 < 完成 > 按钮, 完成开发版的安装 14

19 验证安装 验证开发版是否已正确安装的步骤如下 : 步骤 1: 安装程序提示安装成功 步骤 2: 用户第一次安装 EOS Platform 产品后,[ 开始 / 应用 ] 中会添加 EOS Platform 7.6 (Platform Home1) 菜单 同一个登录用户若多次安装 EOS Platform 产品,[ 开始 / 应用 ] 中会依次添加 EOS Platform 7.6(Platform Home2) EOS Platform 7.6(Platform Home3) 菜单, 以示区别 步骤 3: 检查安装日志 安装成功后, 安装目录 ( 比如 D:\primeton\platform3) 下存放有 eos_platform_7.6_install.log 安装日志文件, 检查该文件, 安装过程没有异常信息 步骤 4: 检查目录和配置文件 验证安装 Studio: 检查项目 目录和文件 检查内容 Studio 部分的内容存放于安装目录下的 \ide\eclipse 和 \ide\eclipse\dropins 目录中 配置文件 验证安装 Server: \ide\eclipse\configuration\eos_studio_config\connection 目录下的数据库配置与 安装时配置一致 \ide\eclipse\configuration\eos_studio_config 目录下的 server.xml 配置正确, 详情可参考附录 %EXTERNAL_CONFIG_DIR%= 安装目录 \ apps_config 本参数是外置配置目录的参数, 外置配置目录用来存放应用启动配置和运行期的 配置 %TOMCAT_HOME%= 安装目录 \apache-tomcat 检查项目 数据库驱动 检查内容 %TOMCAT_HOME%\lib 下存在数据库驱动 : Oracle:oracle.jdbc.driver.OracleDriver DB2 UDB:com.ibm.db2.jcc.DB2Driver SQL Server:com.microsoft.sqlserver.jdbc.SQLServerDriver MySql:com.mysql.jdbc.Driver KingbaseES:com.kingbase.Driver DM:dm.jdbc.driver.DmDriver GBase:com.gbase.jdbc.Driver Oscar:com.oscar.Driver 15

20 检查项目 %TOMCAT_HOME%\ webapps 配置文件 检查内容检查是否存在应用 default( 或在安装过程中输入的应用名 ) 已选择安装应用 (governor workspace sso-server) 检查数据源配置应用 default 目录下的 WEB-INF\_srv\config\user-config.xml 文件中的 <module name="datasource"> 节点的 default 的数据源配置 检查应用配置 %EXTERNAL_CONFIG_DIR% 目录下的 default 应用的 startup.conf 的配置应与用户安装时选择的 IP 端口号一致 governor 下的 startup.conf 的端口号应为 6299 步骤 5: 检查 startserver.cmd startserver.cmd 位于安装目录下 用编辑器打开该文件查看 JAVA_HOME EXTERNAL_CONFIG_DIR 的设置正确 JAVA_HOME 应设置为安装目录下 ide/eclipse/jre 子目录,EXTERNAL_CONFIG_DIR 应设置为安装目录下 apps_config 子目录 运行 startserver.cmd, 启动 Server, 查看控制台有没有异常 注意 : 1. 如果是在 macos sierra 下安装开发版, 由于 Mac 版 JDK1.8 获取本地 IP 的问题导致启动 Server 会非常慢 可以在 /etc/hosts 文件中添加如下配置 : localhost yourpcname.local 2. 如果是在 Windows 下安装开发版, 且开发版使用的 JDK 版本是 1.7 及以上, 可以在启动脚本 startserver.cmd 中添加如下 JVM 参数来提升启动 Server 的速度 : -XX:+TieredCompilation -XX:TieredStopAtLevel=1 -Xverify:none 16

21 步骤 6: 验证登陆 server 检查是否成功登陆 default 应用 如果部署了 Governor 应用, 检查是否成功登陆 并且在首页检查 产品名称 是否为 Primeton Platform 及 产品版本号 是否为

22 如果部署了 Workspace 应用, 检查是否成功登陆 安装企业版 下面介绍安装企业版前的准备工作, 安装步骤, 验证安装是否正确的方法, 以及不同环境 下安装需要注意的事项 注 : 标准版和基础班安装步骤与企业版安装步骤一致 18

23 安装准备 安装企业版前, 需做以下准备工作 : 步骤 1: 检查安装光盘 检查光盘贴膜标注是否为 企业版 步骤 2: 检查安装环境 必须符合软件配置要求 步骤 3: 准备应用服务器 : 如果安装时使用 WebLogic 类型服务器, 需要建立一个部署应用的 domain 可通过 WebLogic 的 configuration wizard 创建, 具体创建步骤请用户自行查阅相关资料 Weblogic 中安装 JDK 应该是 1.8,Weblogic 和 Weblogic 必须启动 AdminServer 之后才能正常安装 不建议将应用安装在 AdminServer 下 如果安装时使用 WebSphere 类型服务器, 需要建立一个应用程序服务器类型的 WebSphere Profile(WebSphere 概要文件 ) 可通过 WebSphere 的概要文件管理工具创建, 具体创建步骤请用户自行查阅相关资料 注意 : 为防止页面乱码, 请将 AppServer/properties/encoding.properties 中的 zh=gb2312 改成 zh=utf-8 步骤 4: 检查权限如果在 AIX 系统下, 用户需要检查安装产品的系统帐户是否拥有执行 WebSphere 安装目录下 bin 目录中程序的权限 建议都是安装产品和安装 WebSphere 都使用帐户 root 安装步骤 (Linux +WebLogic+ Oracle) 以 Red Hat WebLogic Oracle 12c 环境为例, 企业版的安装步骤如下 : 步骤 1: 运行 install.sh, 启动安装程序 注意 : 如果用户想要进行远程安装, 需先安装支持远程调用 X Windows(UNIX 系统的桌面可视化程序 ) 并将图形输出到客户端的软件, 例如 Xmanager 3.0, 安装完该软件后, 运行 Xmanager Passive 程序 然后以命令行模式远程登录 Linux 系统, 再运行命令 export DISPLAY=% 客户端 IP%:0, 随后便可以运行 install.sh 进行远程安装了 步骤 2: 阅读安装简介, 单击 <Next> 按钮 19

24 步骤 3: 阅读企业版的许可声明后, 选择 I accept the terms of the License Agreement 单选按 钮, 单击 <Next> 按钮 步骤 4: 单击 <Choose>, 从弹出的对话框中选择安装目录, 单击 <Next> 按钮 20

25 注意 : 安装路径最多可输入 64 个字符, 只能由半角英文字母 数字 点. 或下划线 _ 组成, 且不允 许带空格 步骤 5: 选择应用服务器 21

26 参数 说明 App Server/ 应用服务器 Bea Home Weblogic Home Domain Home Login name/ 用户名 PassWord 选择所使用的应用服务器类型 Bea 产品主目录 WebLogic 目录 用户选择 BEA HOME 后, 系统会自动填写 Weblogic HOME, 用户无需手动更改 用户创建的 domain 目录 创建具有管理安全性的 domain 时设置的用户名 创建具有管理安全性的 domain 时设置的用户密码 Target ServerName 需要安装的 Server 名称 不建议安装到 AdminServer 下 AdminServer PORT 主管服务器端口, 默认为 7001 Clustered/ 集群 是否集群应用, 如果没有这个选项, 说明不支持集群 步骤 6: 安装选项, 选择安装组件 安装组件有 EJB COFRAME BPS 和 SSO, 都为可 选项 步骤 7: 设置管理员口令 使用 Governor 管理员用户名和口令可以登录管理监控应用 Governor, 进行应用的管理 和监控操作 使用 Workspace 管理员用户名和口令可以登录流程管理应用 workspace 进行 流程管理监控 22

27 输入管理员的密码和确认密码 安装程序默认 sysadmin 的密码为 用户 可以在此设置新密码, 密码长度必须在 6~20 位之间 步骤 8: 选择 IP, 管理端口号 企业版会默认安装一个缺省应用 (default) 本步骤用来设置缺省应用的绑定 IP 和管理端口号 在下拉列表框中选择本机 IP, 如果有多个可用的网络连接, 则需要选择其中的一个 IP 该 IP 为安装的 EOS 应用绑定地址 企业版安装请使用真实 IP 地址 在管理端口文本框中输入端口号 管理端口是应用的管理端口,Governor 应用通过该端口对应用进行管理, 管理端口也是 EOS 集群应用之间的相互通知端口 注意 : 默认端口号为 6200 端口号 6299 为保留端口号, 默认被 governor 使用, 不能使用 端口号 6399 为保留端口号, 默认被 workspace 使用, 不能使用 端口不自动累加, 不做冲突检查, 用户配置端口号时请自己保证端口号不冲突 23

28 步骤 9: 创建应用, 用户可以创建默认应用, 并自定义名称, 默认该应用名为 default 默 认应用 Governor Workspace 均可以选择性部署 单击 < 下一步 > 按钮 注意 : 应用名称应遵循下面规则 : 应用名的长度必须在 3~64 之间, 只支持半角英文字母和数字, 支持., _, -, 以字母开头 不允许使用 governor,workspace 做应用名 不允许与已有应用重名 24

29 步骤 10: 配置数据库 配置数据库界面的参数说明 : 25

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

31 对于已经初始化过的数据库, 安装包会提示, 用户可以选择再次初始化或者不初始化单击 <Connection Test> 按钮, 测试所配置数据库是否可以成功连接 步骤 11: 阅读并审核安装设置信息, 单击 <Install> 按钮 步骤 12: 开始安装, 安装过程中显示各组件的安装进程 步骤 13: 程序提示已经安装完成 27

32 步骤 14: 单击 <Finish> 按钮, 完成企业版的安装 验证安装 (Linux+WebLogic+Oracle) 以 (Red Hat WebLogic Oracle 12c) 环境为例, 验证企业版是否已正确安 装的步骤如下 : 步骤 1: 安装程序提示安装成功 步骤 2 : 检查日志, 打开安装目录 ( 比如 : /root/primeton/platform ) 下的 eos_platform_7.6_install.log 安装日志文件, 检查安装过程中是否有异常信息 步骤 3: 检查数据库驱动和目录 : 检查项目 检查内容 %Domain Home%/lib 下存在数据库驱动 : 数据库驱动 Oracle:oracle.jdbc.driver.OracleDriver DB2 UDB:com.ibm.db2.jcc.DB2Driver SQL Server:com.microsoft.sqlserver.jdbc.SQLServerDriver MySql:com.mysql.jdbc.Driver KingbaseES:com.kingbase.Driver DM:dm.jdbc.driver.DmDriver GBase:com.gbase.jdbc.Driver Oscar:com.oscar.Driver 28

33 ear 目录 %Domain Home%/applications 下存在目录 default.ear( 或者是安装时输入的应用名 ) governor.war workspace.ear sso-server.ear 步骤 4: 检查 startserver.sh 该文件位于安装目录下 运行 startserver.sh, 可以启动 WebLogic 服务 步骤 5: 登录 domain 管理服务控制台 (Admin server console) 查看数据源配置存在 安装步骤 (Linux+WebSphere+DB2) 以 Red Hat ( 英文环境, 部分配置参数将以 English/ 中文的形式加以说明 )+ WebSphere 8.5+ DB2 UDB_V9.7 环境为例, 企业版的安装步骤如下 : 步骤 1: 运行 install.sh, 启动安装程序 注意 : 如果用户想要进行远程安装, 需先安装支持远程调用 X Windows(UNIX 系统的桌面可视化程序 ) 并将图形输出到客户端的软件, 例如 Xmanager 3.0, 安装完该软件后, 运行 Xmanager Passive 程序 然后以命令行模式远程登录 Linux 系统, 再运行命令 export DISPLAY=% 客户端 IP%:0, 随后便可以运行 install.sh 进行远程安装了 步骤 2: 阅读安装简介, 单击 <Next> 按钮 步骤 3: 阅读企业版的许可声明后, 选择 I accept the terms of the License Agreement 单选按 钮, 单击 <Next> 按钮 29

34 步骤 4: 单击 <Choose>, 从弹出的对话框中选择安装目录, 单击 <Next> 按钮 注意 : 安装路径最多可输入 64 个字符, 只能由半角英文字母 数字 点. 或下划线 _ 组成, 且不允 许带空格 30

35 步骤 5: 选择应用服务器 选择 WebSphere 应用服务器界面图示及参数说明表如下 参数 App Server/ 应用服务器 Profile Home Cell Name Node Name Server name User name PassWord Clustered/ 集群 说明 选择应用所使用的应用服务器类型 WebSphere 的概要文件目录 管理服务器单元的名称 该参数会在选择正确的 Profile Home 之后自动填写, 用户无需手动更改 WebSphere 节点名称 该参数会在选择正确的 Profile Home 之后自动填写, 用户无需手动更改 WebSphere Server 名称 该参数会在选择正确的 Profile Home 之后自动填写, 用户无需手动更改 创建具有管理安全性的 Profile 时设置的用户名 创建具有管理安全性的 Profile 时设置的用户密码 是否集群应用 步骤 6: 安装选项, 选择安装组件 安装组件有 EJB COFRAME BPS 和 SSO, 都为可 选项 31

36 步骤 7: 设置管理员口令 使用 Governor 管理员用户名和口令可以登录管理监控应用 Governor, 进行应用的管理和监控操作 使用 Workspace 管理员用户名和口令可以登录流程管理应用 workspace 进行流程管理监控 输入管理员的密码和确认密码 安装程序默认 sysadmin 的密码为 用户可以在此设置新密码, 密码长度必须在 6~20 位之间 32

37 步骤 8: 选择 IP, 管理端口号 企业版会默认安装一个缺省应用 (default) 本步骤用来设置缺省应用的绑定 IP 和管理端口号 在下拉列表框中选择本机 IP, 如果有多个可用的网络连接, 则需要选择其中的一个 IP 该 IP 为安装的 EOS 应用绑定地址 企业版安装请使用真实 IP 地址 在管理端口文本框中输入端口号 管理端口是应用的管理端口,Governor 应用通过该端口对应用进行管理, 管理端口也是 EOS 集群应用之间的相互通知端口 注意 : 默认端口号为 6200 端口号 6299 为保留端口号, 默认被 governor 使用, 不能使用 端口号 6399 为保留端口号, 默认被 workspace 使用, 不能使用 端口不自动累加, 不做冲突检查, 用户配置端口号时请自己保证端口号不冲突 33

38 步骤 9: 创建应用, 用户可以创建默认应用, 并自定义名称, 默认该应用名为 default 默 认应用 Governor Workspace 均可以选择性部署 单击 <Next> 按钮 注意 : 应用名称应遵循下面规则 : 应用名的长度必须在 3~64 之间, 只支持半角英文字母和数字, 支持., _, -, 以字母开头 不允许使用 governor,workspace 做应用名 不允许与已有应用重名 34

39 步骤 10: 配置数据库 配置数据库界面的参数说明 : 35

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

41 对于已经初始化过的数据库, 安装包会提示, 用户可以选择再次初始化或者不初始化单击 <Connection Test> 按钮, 测试所配置数据库是否可以成功连接 步骤 11: 阅读并审核安装设置信息, 单击 <Install> 按钮 步骤 12: 开始安装, 安装过程中显示各组件的安装进程 步骤 13: 程序提示已经安装完成 37

42 步骤 14: 单击 <Finish> 按钮, 完成企业版的安装 验证安装 (Linux+WebSphere+DB2) 以 Red Hat WebSphere8.5 + DB2 UDB_V9.7 环境为例, 验证企业版是否已正确安装的步骤如下 : 步骤 1: 安装程序提示安装成功 步骤 2: 检查日志 打开安装目录 ( 比如 :/root/primeton/platform) 下的 eos_platform_7.6_install.log 安装日 志文件, 检查安装过程中没有异常信息 步骤 3: 检查数据库驱动和目录 : 检查项目 检查内容 38

43 数据库驱动 ear 目录 %WebSphere 安装目录 %/lib/ext 下存在数据库驱动 : Oracle:oracle.jdbc.driver.OracleDriver DB2 UDB:com.ibm.db2.jcc.DB2Driver SQL Server:com.microsoft.sqlserver.jdbc.SQLServerDriver MySql:com.mysql.jdbc.Driver KingbaseES:com.kingbase.Driver DM:dm.jdbc.driver.DmDriver GBase:com.gbase.jdbc.Driver Oscar:com.oscar.Driver %Profile Home%/installedApps/%Cell Name% 下存在目录 default.ear 和 governor.ear,workspace.ear,sso-server.ear( 具体与用户在安装时选择安装的应用有关 ) 步骤 4: 检查 startserver.sh 该文件位于安装目录下 运行 startserver.sh, 可以启动 WebSphere 服务 ( 具体启动哪个服务, 在安装时选择应用服务器步骤中确定, 即 Server Name, 如 Server1) 查看 JVM 参数, 用户可在启动服务后登陆 profile 管理控制台 Application Servers -> server1 -> (Java 和进程管理 ) 进程定义 -> Java 虚拟机 -> 定制属性 查看 查看 web 容器定制参数, 在管理控制台 Application Servers -> server1 -> ( 会话管理 ) Web 容器 -> 定制属性 查看 : com.ibm.ws.webcontainer.invokefilterscompatibility true 39

44 3.2. 哑安装 哑安装方式即用户通过属性文件一次性定制各安装参数, 运行安装包后, 安装程序从该属性文件中读取参数进行安装 整个安装过程完全自动化, 无需用户干预 哑安装方式能够解决界面交互安装方式对安装环境要求高, 非自动化等问题 哑安装相关配置文件 哑安装配置在 silent_install.properties 文件中完成 这个文件必须存放在安装目录的 installer 子目录下, 文件的名称必须为 silent_install.properties, 其内容遵循 java properties 文件格式, 需要转义的字符必须进行转义 该文件内容决定产品安装路径 数据库配置 JavaEE 服务器配置等 启动哑安装方式步骤如下 : 1. 正确设置了 silent_install.properties 文件并且放在安装包所在目录的 installer 子目录下 2. 在命令行模式下, 启动安装程序后面增加 -silent 参数即可 例如 : 在 Windows 系统下时, 假设安装光盘为 F:, 则输入 F:\install.cmd silent; 在 Linux/AIX 系统下时, 在安装包所在目录输入./install.sh silent 如何配置哑安装属性文件 对于开发版和企业版, 不同的应用服务器和数据库下, 哑安装属性文件的配置也不相同, 下面详细介绍不同情况下如何配置 silent_install.properties 文件 哑安装产品时, 用户需设置下列参数 : 参数名称 参数意义 数据源配置信息 DB_DS_JNDI_NA ME 数据源 JNDI 名称,Tomcat TongWeb 应用服务器下不需要 40

45 参数名称 参数意义 使用的数据库类型, 为必填参数 DB_TYPE DB_DRIVER DB_VERSION 必须设置为以下值中的一个 : Oracle DB2 UDB SQLServer MySql KingbaseES DM GBase Oscar 数据库 JDBC 驱动类名, 为必填参数 各类型数据库默认的 JDBC Driver Class 如下 : Oracle:oracle.jdbc.driver.OracleDriver DB2 UDB:com.ibm.db2.jcc.DB2Driver SQL Server:com.microsoft.sqlserver.jdbc.SQLServerDriver MySql:com.mysql.jdbc.Driver KingbaseES:com.kingbase.Driver DM:dm.jdbc.driver.DmDriver GBase:com.gbase.jdbc.Driver Oscar:com.oscar.Driver 数据库版本, 如果使用 DB2_9.7 需要写添加这个参数 :DB_VERSION=9.7 是否使用默认的数据库驱动, 为必填参数 只能设置为 true 或 false DB_IS_DEFAULT_ JAR 因数据库使用 JDBC 连接, 安装包内自带了 Oracle DB2 UDB SQL Server MySql KingbaseES DM GBase Oscar 的数据库驱动 若默认的数据库驱动不能与用户所要连接的数据库相匹配, 请将本参数设置为 false, 并在 DB_JDBC_LIBS 中设置相应的 jar 包 说明 : 本参数为 false 时,DB_JDBC_LIBS 参数值不能为空 用户自选的数据库 JDBC 驱动文件路径 (jar 包 ) DB_JDBC_LIBS DB_IP 如果有多个文件, 以英文分号 ; 分隔, 如 :D:\jdbc\a.jar;D:\jdbc\b.jar 说明 : 仅当 IS_DEFAULT_JAR 值为 false 时, 才需要配置本参数 连接数据库服务器的 IP 地址, 为必填参数 连接数据库服务器的端口号, 为必填参数 各数据库服务器的缺省端口号如下 : DB_SERVER_POR T DB_NAME DB_USERNAME DB_PASSWORD Oracle:1521 DB2 UDB:50000 SQL Server:1433 MySql:3306 KingbaseES:54321 DM:5236 GBase:5258 Oscar:2003 数据库的名称 访问数据库的用户名, 为必填参数 访问数据库的用户密码, 为必填参数 41

46 参数名称 DB_ IS_INIT DB_IS_FORCE_INI T 公共安装信息 INSTALL_DIR SYSADMIN_PWD WORKSPACE_SY SADMIN_PWD USER_NAME USER_COMPANY USER_IP USER_PORT IS_DEPLOY_DEFA ULTAPP DEFAULT_APP_N AME 参数意义 是否要初始化数据库, 为必填参数 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 位之间, 密码只能由半角英文字母 数字. 或下划线 _ 组成 用户名称, 非必填参数 用户所在的机构名称, 非必填参数 填写目标安装机器的 IP 地址 多网卡或多 IP 情况下, 必须选择其中的一个 IP, 该 IP 为安装的应用绑定地址 开发版默认使用 作为绑定地址, 但使用该地址不能进行网络操作 ( 如使用开发版安装的 Governor 管理其他机器上的应用 ) 如果需要进行网络操作, 请选择真实 IP 地址 管理端口是应用的 JMX 管理端口,Governor 应用通过该端口对应用进行管理, 管理端口也是集群应用之间的相互通知端口 是否部署默认应用, 非必填参数 默认应用名称 说明 : 应用名的长度必须在 3~64 之间, 只支持半角英文字母和数字, 支持., _, -, 以字母开头 不许使用 governor workspace 做应用名 不允许与已有应用重名 42

47 参数名称 IS_DEPLOY_GOV ERNOR IS_DEPLOY_WOR KSPACE IS_DEPLOY_EJB MODULE_OPTION S 参数意义是否部署 governor 应用, 非必填参数 是否部署 workspace 应用, 非必填参数 应用是否部署 EJB, 应用服务器为非 tomcat 环境时配置 要安装的选件名称, 有 EJB BPS COFRAME 可选 对于不同的应用服务器, 需要配置不同的参数 : 参数名称 参数意义 公共参数 APP_SERVER_NAME APP_SERVER_VERSION 应用服务器名称, 为必填参数 应用服务器版本, 为必填参数 企业版专用参数 IS_REPEAT_INSTALLED 是否重复安装, 多次安装使用, 非必填, 多次安装时填写 true, 第一次安装不填或填写 false Tomcat 专用参数 AS_TOMCAT_HOME TOMCAT_JAVA_HOME Tomcat 的安装目录 Tomcat 安装的 java_home 目录 JBoss 专用参数 AS_JBOSS_HOME JBOSS_JAVA_HOME JBoss 的安装目录 Jboss 安装的 java_home 目录 WebLogic 专用参数 AS_WL_BEA_HOME Bea 产品主目录, 为必填参数 如 :C:/bea AS_WL_HOME 本机的 WebLogic 目录, 为必填参数 如 :C:/bea/weblogic92 AS_WL_DOMAIN_HOME AS_WL_TARGET_SERVER AS_WL_WEBSVR_PORT AS_WL_USERNAME AS_WL_PASSWORD IS_CLUSTER 部署应用的 domain 目录, 为必填参数 如 : C:/beaDomains/domain923 目标服务器名称 如 :server1 WebServer 端口号,WebLogic 默认是 7001, 为必填参数 WebLogic 安全用户名 WebLogic 安全用户密码 集群配置参数, 集群环境配置为 true, 非集群环境配置为 false WebSphere 专用参数 AS_WAS_SERVER_NAME AS_WAS_CLUSTER_NAME 应用服务器名称, 非集群环境时配置 集群名称, 集群环境时配置 43

48 参数名称 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_JAVA_HOME TongWeb 的安装目录 TongWeb 安装的 java_home 目录 哑安装配置文件典型示例 下面提供几个典型环境下的哑安装配置文件示例, 仅供参考, 具体参数值根据实际情况填写 安装程序对于参数值为空的参数处理方式是忽略, 因此用户可以保留那些不需要填写值的参数 注意 : 配置路径时需要自已转义, 如 D:\platform\platform1352 需转义为 D:\\platform\\platform1352 或 D:/platform/platform1352, 否则安装时会出现错误 开发版 (Windows7 + 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 44

49 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= #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 ejb or Not IS_DEPLOY_EJB=false #Deploy bps or Not IS_DEPLOY_BPS=true 45

50 #Deploy cap or Not IS_DEPLOY_CAP=false #Deploy coframe or Not IS_DEPLOY_COFRAME=true #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_V9.7) #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 IS_CLUSTER=false #AS_WAS_PROFILE_HOME AS_WAS_PROFILE_HOME=/opt/WebSphereND61EOS/AppServer/profiles/AppSrv01 46

51 #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 #DataBase Version DB_VERSION=9.7 #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 #DB User's Password DB_PASSWORD=test 47

52 #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 ejb or Not IS_DEPLOY_EJB=false #Deploy bps or Not IS_DEPLOY_BPS=true #Deploy coframe or Not IS_DEPLOY_COFRAME=true #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=

53 #workspace sysadmin's Password WORKSPACE_SYSADMIN_PWD= #if repeat install set it true IS_REPEAT_INSTALLED=false 3.3. 集群安装 集群安装典型场景 governor workspace default 集群 1 default 管理 server 被管 server1 被管 server2 集群环境应用部署典型场景 如上图, 管理控制台应用 governor 和 workspace 安装部署在管理服务器上, 而业务应用安装部 署在集群的被管服务器上,governor 和 workspace 管理集群上的应用 集群环境的控制台应用 和业务应用必须分开安装部署 WebLogic 集群安装 在 win10 上以应用服务器 WebLogic 为例进行集群安装说明 默认已经成功安装 Weblogic 搭建 weblogic 集群环境 步骤 1: 打开 { 安装目录 }wlserver\common\bin\config.cmd 49

54 步骤 2: 选择创建新域 选择域安装位置, 单击 < 下一步 > 步骤 3: 选择产品模板, 单击 < 下一步 > 按钮 50

55 步骤 4: 配置管理员和密码, 输入 Weblogic 管理员管理服务器 (AdminServer) 的用户名和 密码, 确认密码, 单击 < 下一步 > 按钮 51

56 步骤 5: 配置域模式和 JDK 选择 生产模式 和 JDK 后, 单击 < 下一步 > 按钮 步骤 6: 选择 管理服务器 和 受管服务器, 集群和 Coherence 单击 < 下一步 > 52

57 步骤 7: 配置管理服务器 输入 Administrator Server 的名称, 监听地址, 监听端口, 如果 需要 SSL 支持的话可以在 SSL enabled 复选取框上打勾, 配置 SSL 监听端口, 单击 < 下一 步 > 按钮 53

58 步骤 8: 配置受管理服务器 代理服务器也是一个受管理服务器 输入 Managed Server 的名称, 监听地址, 监听端口, 如果需要 SSL 支持的话, 可以在 SSL enabled 复选框上打勾, 配置 SSL 监听端口 可以配置一个 ProxyServer 和多个 Managed Server 如图所示, 单击 < Next > 按钮 注意 : 受限于 WebLogic 为受管服务器配置的 JMS 数据库表名长度, 建议受管服务器名不超过 19 个字符 server1 和 server2 是本例创建的受管服务器名, 用户应以实际创建的受管服务器名为准 步骤 9: 配置集群信息 单击 添加, 输入 Cluster 的名称, 集群地址, 前端主机, 前端 HTTP 端口, 前端 HTPPS 端口 填写集群名称与集群地址, 其余可输可不输 单击 < 下一步 > 按钮 54

59 步骤 10: 将受管理服务器添加到集群中 选择左面列表中的 Managed Server, 将其添加到 右面的列表中, 这里代理服务器不要添加到右边, 单击 < Next > 按钮 55

60 步骤 11: 配置计算机 在此不对计算机进行配置, 单击 < 下一步 > 按钮 步骤 12: 检查 WebLogic 域, 如果没有问题单击 < 下一步 > 按钮 56

61 步骤 13: 创建域 创建无误后, 单击 < 创建 > 步骤 14: 为每个受管服务器创建外置目录, 建议以 apps_config 为文件夹名, 外置配置目 57

62 录用来存放应用启动配置和运行期的配置 编辑口令文件, 在之前创建的域目录 servers/adminserver/security 下创建 boot.properties 文件, 内容为前文中创建 WebLogic 集群设置安全性用户名和密码, 如 : username=weblogic password=weblogic 编辑启动管理服务器的文件, 在创建的域目录下的 bin 目录中创建 startadminserver.cmd 文件, 内容为 启动管理服务器. start.\startweblogic 编辑受管理服务器的文件 以 server1 为例, 在刚才创建的域目录下的 bin 目录中创建 startserver1.cmd 文件, 增加外置目录参数, 内容为 启动受管理服务器 启动 Managed 使用 startmanagedweblogic 命令启动 Managed Server, 它的命令格式是 startmanagedweblogic.cmd Managed Server 的名称 Administrator Server startmanagedweblogic 受管理服务器名称管理服务器 URL Set JAVA_OPTIONS=%JAVA_OPTIONS% -DEXTERNAL_CONFIG_DIR=C:/ceshiwel/server1/apps_config start.\startmanagedweblogic server1 说明 : 1. 使用 startmanagedweblogic 命令启动 Managed Server, 它的命令格式是 :startmanagedweblogic.cmd < 受管服务器名 > < 管理服务器 URL> 2.%EXTERNAL_CONFIG_DIR% 参数是外置配置目录的参数, 外置配置目录用来存放应用启动配置和运行期的配置 外置目录, 在各个受管服务器外置目录下创建以部署到该集群的应用为名称的子目录, 如 default, 在该应用配置子目录下创建 startup.conf 文件, 配置应用的绑定 IP 和管理端口, 格式如下 : AdminPort=6201 LocalIP=

63 用户应保证 LocalIP 值为受管服务器所在机器的一个真实 IP,AdminPort 值不被其他已部署 应用占用 通过安装包安装应用到集群 下面仅对应用服务器选择步骤进行说明, 安装步骤如下 : 步骤 1: 选择应用服务器, 选中集群复选框, 在应用服务器下拉框中选中 WebLogic , 在 Bea Home 选择 bea 安装目录, 选择 WebLogic Home 在 Domain Home 选择 domain 安装目录, 输入管理员用户名和密码, 集群名如 :cluster, 集群管理服务器端口号, 如 :7001 参数 说明 Bea Home Weblogic Home Domain Home 用户名密码 Cluster Name WebLogic 的安装目录 Weblogic HOME 为 Weblogic 安装下面的 wlserver 目录用户创建的 domain 目录 创建具有管理安全性的 domain 时设置的用户名 创建具有管理安全性的 domain 时设置的用户密码 用户创建的集群名称 59

64 参数 说明 AdminServer PORT 集群 集群服务端口 是否集群应用 步骤 2: 安装完成后, 重启集群 保证应用能正常运行必须重启一次集群, 至此安装完毕 加入 Governor 进行管理 步骤 1: 安装 governor 应用到一个 domain 中, 或其他类型的应用服务器中, 安装过程请参考 安装企业版 本例中采用 tomcat 作为应用服务器 步骤 2: 启动 WebLogic 集群, 启动管理服务器 受管服务器, 通过 URL: 登陆控制台确认部署的应用如 default 已启动 步骤 3: 启动 governor, 启动部署 governor 的应用服务器, 登陆 governor 控制台 步骤 4: 点击应用管理, 添加集群被管应用 应用名称与用户部署在 WebLogic 集群上的应用相同,IP 地址为部署该应用的受管服务器的 IP 地址, 管理端口号为受管服务器管理该应用的端口, 可在前文配置的该受管服务器的外置目录下 startup.conf 文件中查看, 选中加入新建的集群, 输入集群名称 单击 < 确定 > 步骤 5: 查看 governor 中被管应用, 已启动, 已同步 60

65 步骤 6: 向集群中加入多个被管应用, 会将第一个应用中的 EOS 配置信息作为模板 添加完毕集群中所有应用, 除第一个应用外, 所有应用配置文件需要与模板文件进行同步操作, 此时需要重启其他应用以便同步 EOS 配置文件 步骤 7: 如果选择了 BPS, 则需要对 BPS 引擎进行配置 依次选择 :BPS 引擎配置 -> 运行参数配置, 目标选择 cluster, 选中 是否启用集群 后的复选框, 如图 注意 : 启用 BPS 引擎集群配置后重启集群 加入 Workspace 进行管理 步骤 1: 如果选择了 BPS, 则需要安装 workspace workspace 可以通过安装包进行安装, 安装时只需在安装选项中选择 workspace 即可, 也可以在上一步安装 governor 时同时安装 workspace 步骤 2: 在 workspace 中添加受管引擎 登录 引擎实例管理, 将 server1 和 server2 添加到 workspace 中, 添加时测试连接是否正常, 保证添加的引擎是可用的, 如图 61

66 验证安装 以 Win10 + WebLogic Mysql5.5 环境为例, 验证集群环境是否已正确安装的步骤如下 : 步骤 1: 启动集群, 启动管理服务器 受管服务器, 通过 URL: 登陆 WebLogic 管理控制台 步骤 2: 查看服务器 步骤 3: 查看数据源, 用户配置数据源存在, 用户可进一步查看各项属性如 JNDI 名称, 连 接池配置和用户创建该数据源时的输入一致 步骤 4: 应用能够启动, 启动时没有异常 Weblogic 集群安装注意事项 WebLogic 集群应用安装后, 需要将应用的 stage 模式手工更改为 nostage 模式才支持通过 Governor 部署 ECD 方式来升级应用, 否则只能使用集群管理服务器更新 EAR 的方式解决 通过安装包 WebLogic 集群是使用 stage 模式的, 这也是 Weblogic 默认的模式, 使用该模式是为了保证部署的 ear 应用可以同步到远程服务器的集群节点上 stage 模式的特点是集群节点重启后, 会强制从 Weblogic 的主管服务器上重新同步 EAR 应用, 这样会造成集群应用安装后, 通过 Governor 向集群应用通过 ECD 部署方式更新 ( 升级 ) 应用后, 再集群节点重启后又被覆 62

67 盖为旧的 ( 集群管理服务器上的 EAR), 另外, 通过 governor 修改集群应用的配置 ( 一般会修改 user-config.xml 等 ), 也存在集群重启后配置文件被覆盖问题 为了避免通过 Governor 部署 ECD 的结果被集群重启后覆盖, 在通过安装 WebLogic 集群应用后, 需要手工将应用的 stage 模式更改为 nostage, 具体步骤如下 : 1) 找到集群的管理服务器的 domain 的 config/config.xml 文件, 修改下面的内容 ( 参见红色字体 ), 如下 : <app-deployment> <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 63

68 applications default.ear ( 目录 ) default.war ( 目录 ) WEB-INF ) 重启整个集群, 包括集群的主管服务器, 集群的被管服务器 注意 : 这种手工配置成 nostage 模式的方法, 适合于后续通过 governor 部署 ECD 来升级应用的场景, 但不支持新增加集群节点场景, 如果要新增加集群节点, 建议还是采取 stage 模式, 但以后更新或升级应用只能采取通过 Weblogic 管理服务器对集群重新部署 EAR 来进行应用升级 WebSphere 集群安装 以应用服务器 WebSphere 6.1 为例进行集群安装说明 搭建 Websphere 集群环境 安装 Deployment 管理服务器节点和联合应用程序服务器 步骤 1: 运行 WebSphere\AppServer\firststeps\firststeps.bat, 点击概要文件管理工具 或者进 入 $WAS_HOME$\AppServer\bin\ProfileManagement> 目录运行 pmt.bat 命令 64

69 步骤 2: 选择功能部件, 选中 单元 (Deployment Manager 和联合应用程序服务器 ) 即可, 如下图所示 系统将创建一个 Deployment Manager 和一个 Node 节点 步骤 3: 指定概要文件位置 节点名 主机名 单机名选择高级概要文件创建, 缺省部署管理控制台和缺省应用程序 在输入节点名和主机名时必须正确, 主机名区分大小写, 建议不要填写 IP 地址 节点名和单元名取默认值即可, 但是要保证集群中的节点名不可重复 在本例中新建 Manager 概要为 Dmgr02, 新建 node 概要为 Managed1 65

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

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

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

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

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

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

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

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

78 通过安装包安装应用到集群 下面仅对应用服务器选择步骤进行说明, 安装步骤如下 : 步骤 1: 选择应用服务器 选中集群复选框, 在应用服务器下拉框中选中 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 时设置的用户密码 是否集群应用 步骤 2: 安装完成后, 关闭集群, 在 搭建 Websphere 集群环境 创建的各个受管服务器的外 74

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

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

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

82 步骤 3: 如果组件选择部署 EJB 安装, 查看 JMS 配置, 查看 JMS 队列连接工厂 EOS_QUEUE_FACTORY, 作用域为集群 ; 查看 default 应用绑定队列,JNDI 名称分别为 %appname%/eos_invoke_queue %appname%/eos_result_queue, 队列名称分别为 default.eos_invoke_queue default.eos_result_queue, 作用域为集群 ; 查看队列相关激活规范 步骤 4: 检查数据源 配置数据源存在, 测试连接成功 步骤 5: 应用能够启动, 启动时无异常, 78

83 3.4. 手工部署安装 EOS Platform 支持标准 EAR 的部署方式, 用户可以用非常灵活的方式来安装应用, 除了通 过运行安装程序来一站式的安装部署之外, 还可以借助脚本工具的帮助来手工安装应用, 本章 主要介绍如何以手工方式安装应用 79

84 手工安装业务应用 手工安装业务应用支持的应用服务器环境包括单机和集群, 以下描述了在单机和集群环境 下手工安装应用的详细步骤 准备应用服务器环境 应用服务器可以是未安装过 EOS Platform 应用的应用服务器, 也可以是已经安装过 EOS Platform 应用的应用服务器, 如果要支持集群, 需要搭建应用服务器的集群环境 ( 请参考 集群 安装 章节 ) 准备 EAR 应用 1. 安装 EOS Platform 开发版 2. 导出现有应用的 ear 文件通过 Studio, 将现有业务应用项目导出为 ear 文件, 具体导出步骤用户可参考 studio 的联机帮助文档的 产品介绍 / 使用参考 / 导出 / 导出 EAR 部分内容 拷贝 JDBC 驱动 jar 对于未安装过 EOS Platform 应用的应用服务器, 应拷贝 JDBC 驱动 jar, 针对不同的应用服务器, 其 jar 拷贝的目标位置也不同, 分别如下 : 注 : 如果使用 DB2 9.7 将 db2jcc-0.x.jar 替换为 db2jcc jar Tomcat: 将 [ 安装光盘根目录 ]/syslib 下的 jar:ojdbc jar mysql-connector-java jar db2jcc-0.x.jar mssqlserver-3.0.jar kingbasejdbc jar dm7jdbcdriver jar gbase-connector-java-8s.jar oscarjdbc-7.0.jar 拷贝至 [TOMCAT_HOME]/lib 下 JBoss: 将 [ 安装光盘根目录 ]/syslib 下的 jar:ojdbc jar 80

85 mysql-connector-java jar db2jcc-0.x.jar mssqlserver-3.0.jar kingbasejdbc jar dm7jdbcdriver jar gbase-connector-java-8s.jar oscarjdbc-7.0.jar 拷贝至 [JBOSS_HOME]/server/default/lib 下 ( 如果是 JBoss6.1.0, 则还需要拷贝 jdom-1.0.jar bcprov-jdk jar) Weblogic: 将 [ 安装光盘根目录 ]/syslib 下的 jar:ojdbc jar mysql-connector-java jar db2jcc-0.x.jar mssqlserver-3.0.jar kingbasejdbc jar dm7jdbcdriver jar gbase-connector-java-8s.jar oscarjdbc-7.0.jar 及 [ 安装光盘根目录 ]/syslib/weblogic/stax-api jar 拷贝至 [DOMAIN _HOME]/lib 下 在集群环境下, 需要将 jar 拷贝到每个被管服务器的 [DOMAIN _HOME]/lib 目录下 WebSphere: 将 [ 安装光盘根目录 ]/syslib 下的 jar:ojdbc jar mysql-connector-java jar db2jcc-0.x.jar mssqlserver-3.0.jar kingbasejdbc jar dm7jdbcdriver jar gbase-connector-java-8s.jar oscarjdbc-7.0.jar 拷贝至 [PROFILE_HOME]/AppServer/lib/ext 下 在集群环境下, 需要将 jar 拷贝到每个被管服务器的 [PROFILE _HOME]/AppServer/lib/ext 目录下 TongWeb: 将 [ 安装光盘根目录 ]/syslib 下的 jar:ojdbc jar mysql-connector-java jar db2jcc-0.x.jar mssqlserver-3.0.jar kingbasejdbc jar dm7jdbcdriver jar gbase-connector-java-8s.jar oscarjdbc-7.0.jar 拷贝至 [TONGWEB_HOME]/ lib/ext 下 对于已经安装过 EOS Platform 应用的应用服务器, 则不用拷贝上述 jar 部署数据源 JMS 等应用绑定资源 通过 studio 导出的标准 EAR 部署在应用服务器中, 其 EAR 本身还需要依赖应用服务器中配置的一些资源, 如数据源 JMS 等, 为方便用户快速创建这些资源, 屏蔽不同应用服务器配置方式上的差异, 安装包提供了用于部署应用绑定资源的工具, 该工具可以通过两种方式获取 : 1 安装企业版之后, 会在安装目录下创建工具, 位于 [ 安装目录 ]/tools 目录下 2 [ 安装光盘根目录 ]/tools 目录下该工具能快速帮助用户完成如下任务 : 81

86 1 配置 JNDI 数据源如果是 Tomcat TongWeb, 需要自己配置 C3P0 数据源 ; 其他应用服务器需要配置 JNDI 数据源 2 配置 JMS 对于 JBoss, 会创建两个队列, 名称分别为 :[ 应用名 ]/EOS_INVOKE_QUEUE 和 [ 应用名 ]/EOS_RESULT_QUEUE; 对于 WebLogic, 会配置 JMS 系统持久性存储 JMS 服务器和基本 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 82

87 工具会根据 deployresources.properties 的配置项完成对资源的配置, 在配置之前, 会对配置项的值作一些基本的校验, 校验不通过, 将不能部署 对于 WebLogic 和 WebSphere 应用服务器, 如果在工具执行之前, 服务器已处于启动状态, 则工具执行完后, 不会停止服务器, 否则, 在工具执行过程中, 会启动服务器, 执行完成后, 会停止服务器 部署应用 标准 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 目录复制到 83

88 [JBOSS_HOME]/server/default/deploy 目录下 3 WebLogic 以 WebLogic 10.3 为例 : 1) 文件方式 : 步骤 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

89 在该目录下需要手工创建应用子目录, 目录名称和已经部署的应用名称一致, 如 default, 在该应用配置子目录下创建 startup.conf 文件, 配置应用的绑定 IP 和管理端口, 格式如下 : AdminPort=6200 LocalIP= 用户应保证 LocalIP 值为目标机器的一个真实 IP 在多网卡多 IP 系统中,IP 设置不正确会因网段划分问题而导致应用无法被访问和管理 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%" 85

90 在 catalina.sh 的开始位置增加如下内容 ( 示例 ): export EXTERNAL_CONFIG_DIR=/usr/primeton/platform/apps_config export JAVA_OPTS= ${JAVA_OPTS}... -DEXTERNAL_CONFIG_DIR="${EXTERNAL_CONFIG_DIR}" 2)JBoss: 修改 [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 下为 : 86

91 export JAVA_OPTIONS= ${JAVA_OPTIONS} -Xms128m -Xmx512m -XX:MaxPermSize=128m -XX:+HeapDumpOnOutOfMemoryError 修改应用服务器配置 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 服务器 87

92 修改 [JBOSS_HOME]/server/default/deploy/jbossweb.sar/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/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> 修改启动脚本, 增对 CLASSPATH 增加配置 : Windows:%JBOSS_HOME%\server\default\lib\bcprov-jdk jar 非 Windows:${JBOSS_HOME}/server/default/lib/bcprov-jdk jar 4)WebSphere 需要修改应用的类装入器顺序, 具体步骤如下 : 1 登陆 profile 管理控制台, 进入 应用程序 -> 企业应用程序 ->default-> 类装入和更新检测, 选择 类已装入并且是先使用应用程序类装入器 2 进入 应用程序 -> 企业应用程序 ->default-> 管理模块 -> default.war-> 类装入器, 选择 类已装入并且是先使用应用程序类装入器 注意 : 对于 Tomcat JBoss, 如果选择的应用服务器已经通过安装包安装过了 EOS 应用, 则上述配置的修改可以省 略 88

93 验证部署 1 资源部署脚本文件成功运行, 无异常 2 正常运行修改后的启动脚本, 启动应用服务器 3 登录服务器管理控制台查看 JVM 参数 数据源 JMS 配置正确 部署资源配置文件示例 下面提供不同应用服务中部署资源工具配置文件 (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, MySql,KingbaseES,DM DB_TYPE=MySql DB_VERSION= #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, 89

94 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 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=false #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, MySql,KingbaseES,DM DB_TYPE=MySql DB_VERSION= #JDBC Driver DB_DRIVER=org.gjt.mm.mysql.Driver #DataBase Server IP DB_IP=

95 #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=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=false #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= 91

96 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,MySql,KingbaseES,DM DB_TYPE=MySql DB_VERSION= #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=false 92

97 #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= 注意 : 工具中提供的 deployresources.properties 文件同时包含了以上应用服务器的配置项, 在实际使用时, 只需要根据 APP_SERVER_TYPE 的值, 设置其对应的应用服务器配置项, 其它应用服务器设置项可以忽略 如果需要系统 EJB,IS_DEPLOY_JMSQUEUE 需要设置为 true 93

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

99 步骤 2: 选择是否保留工作区内容, 单击 < 下一步 > 步骤 3: 执行卸载 95

100 步骤 4: 卸载完成 96