欢迎使用普元产品知识库,本知识库包含普元应用开发平台EOSPlatform,流程平台BPS,企业服务总线ESB,微服务平台Microservice,运维管理平台Devops,数据集成平台DI
欢迎使用普元文档库
普元信息技术股份有限公司
EOS Platform 7.6
产品 安装 指南
文档修订记录
序号 | 版本号 | 修订日期 | 修订概述 | 修订人 | 审批人 | 备注 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
目录
3. Weblogic 新建 domain 未启动过的情况下安装 EOS 会报错,错误信息为空,不能安装。
4. Oracle 9i 环境下,启动 EOS Server 提示端口被占用。
5. Oracle 9i 环境下,安装 EOS 过程中,执行到 “ 配置数据库 ” 步骤时,数据库连接测试失败。
8. 安装包中的 JDK 切换, SQL Server 数据库初始化报驱动类版本问题
9. Weblogic 服务器安装包安装过程中,出现数据库驱动类加载异常
11. 在 macOS sierra 10.12.1 系统下 Server 启动非常慢
EOS Platform 产品包括开发版( Developer Edition ) 、企业版( Enterprise Edition )、标准版( Standard Edition )、基础版( Basic Edition )四种版本,支持界面交互安装 、 哑安装 、 集群安装和手工安装 , 具体如下表所示 :
类型 | 单机 / 集群安装 | 安装包介质安装 | 手工部署安装 | |
界面安装 | 哑安装 | |||
开发版 | 单机 | 支持 | 支持 | 不支持 |
企业版 | 单机 | 支持 | 支持 | 支持 |
集群 | 支持 | 支持 | 支持 |
本章 主要 介绍开发版、企业版的安装内容。标准版、基础版的安装与企业版相同,可参考企业版的安装过程,在文档中不再说明。
开发版面向 EOS Platform 应用开发人员,提供集成开发、运行、管理一体化的应用开发环境。安装内容包括:
EOS Server (运行环境)
EOS Studio (集成开发环境)
Governor (治理工具)
Component Library (构件库)
RichWeb (富页面框架)
NUI (新一代前端开发框架)
BPS Studio (可视化流程设计器)
Process Server (流程核心引擎)
Workspace ( 流程工作台,提供流程定制与管控、引擎实例管理 )
Coframe (组织机构权限框架)
SSO Server (单点登录服务器)
企业版面向 EOS Platform 应用部署人员和使用人员,提供应用在线开发、运行、管理的环境。安装内容包括:
EOS Server (运行环境)
Governor (治理工具)
Component Library (构件库)
RichWeb (富页面框架)
NUI (新一代前端开发框架)
Process Server (流程核心引擎)
Workspace (流程工作台,提供流程定制与管控、引擎实例管理)
Coframe (组织机构权限框架)
SSO Server (单点登录服务器)
安装产品的硬件配置要求:
硬件 | 要求 |
CPU | 主频 2.0GHz 以上。 |
内存 | 1G 以上。 |
硬盘空间 | 开发版: 临时目录空间: 500M 以上。 安装目录空间: 2G 以上。 |
企业版: 临时目录空间: 500M 以上。 安装目录空间: 1G 以上。 |
安装产品的软件配置要求:
软件 | 要求 |
操作系统 | 开发版: 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 11.23 、 Solaris 8 | |
数据库 | Oracle 9i/10g/11g /12c 、 DB2 8.2/9.5/9.7 、 SqlServer 2000/2005/2008/2012 、 MySQL 5.0.22/5.5.40/5.6.33 、 DM V7 、KingbaseES V7 、 G Base 8s 、 Oscar V7 说明: 数据库表空间大小需大于 100MB 。 需要准备一个数据库用户,用于初始化数据库操作,且该用户具有创建、修改、删除表的权限。 如果使用 DB2 数据库,则需再创建一个页大小为 32KB 的用户表空间,名字为 “EOSWFCTX” ,以及创建一个页大小为 32KB 的临时表空间,临时表空间名字可自定义。创建表空间的 SQL 语句请参见附录 E 。 如果使用 MySQL5.6. ,则需要在 MySQL 的安装目录中进行配置,否则初始化数据库时会失败, MySQL 的具体配置请参见附录F 。 |
JavaEE 应用服务器 | 开发版: Tomcat7.0.54 (安装包中自带) |
企业版: Tomcat 5.5.20/6.0.18/6.0.41/7.0.54 /8.5.5 、 JBoss 4.0.5 GA/6.1.0.Final 、WebLogic 9.2/10.0/10.3/10.3.5 /12.2.1.0 、 We bSphere6.1/7.0/8.5 、Primeton PAS 6.0 、 TongWeb5.0 说明: WebLogic9.2/10.0/10.3 /12.2.1.0 、 WebSphere6.1/7.0 支持集群安装。 | |
JDK | 开发版: 默认使用安装包中自带的 JDK ,不使用 本地 JDK |
企业版: 如果安装时选择 WebSphere 、 Weblogic 应用服务器,则使用WebSphere 、 Weblogic 自带的 JDK 。 如果安装时选择 Tomcat 应用服务器时 ,则需要用户自己选择JAVA_HOME 。 如果 安装时选择 JBoss 、 PAS 等应用服务器 时,系统会使用安装包中自带的 JDK 。 说明: 用户可以修改安装启动程序 install.cmd/install.sh 中的 JAVA_HOME变量来更换 JDK ;同样也可以修改卸载程序中的 JAVA_HOME 变量来更换 JDK 。 如果很少使用 RMI , 在启动脚本中, 请手工调整相关的 jvm 参数,例如: -Dsun.rmi.dgc.client.gcInterval=600000 | |
浏览器 | IE 7/8/9/10 /11 、 Firefox 31 /50 、 Chrome 40/56 |
注:安装包自带 JDK 版本为 1.6.0_45
本节分别介绍界面交互方式下如何安装开发版、企业版。
下面介绍安装开发版前的准备工作,安装步骤,以及验证安装是否正确的方法。
安装开发版前,需做以下准备工作:
检查安装光盘,检查光盘贴膜标注是否为 “ 开发版 ” 。
检查安装环境,必须符合软件配置要求。
以 Windows 10 (中文) + MySQL 5. 6 环境为例,开发版的安装步骤如下:
MAC 开发版与 Windows 开发版安装步骤一致。
注:使用 MySQL5.6 在安装之前请参考附录 F 配置数据库
步骤 1 : 启动安装程序。
将安装光盘插入 CD-ROM 中,在 autorun 界面中选择安装开发环境。若不是通过 autorun 形式启动安装程序,请直接执行安装程序文件 install.cmd 。
步骤 2 : 阅读安装简介,单击 < 下一步 > 按钮。
步骤 3 : 阅读开发版的许可声明后,选择 “ 本人接受许可协议条款 ” 单选按钮,单击 < 下一步 > 按钮。
步骤 4 : 单击 < 浏览 > ,从弹出的对话框中选择安装目录,单击 < 下一步 > 按钮。
注意:安装路径最多可输入 64 个字符,只能由半角英文字母、数字、点 “.” 或下划线 “_” 组成,且不允许带空格。
步骤 5 : 选择端口号(访问应用的端口号)。
步骤 6 : 安装选项,选择安装组件。安装组件有 COFRAME 、 BPS 和 SSO ,都为可选项 。
步骤 7 : 设置管理员口令。
使用 Governor 管理员用户名和口令可以登录管理监控应用 Governor ,进行应用的管理和监控操作。使用 Workspace 管理员用户名和口令可以登录流程管理应用 workspace 进行流程管理监控。
输入管理员的密码和确认密码。安装程序默认 sysadmin 的密码为 “000000” 。用户可以在此设置新密码,密码长度必须在 6 ~ 20位之间。
根据实际情况输入用户名称和机构名称(可以不输入)。安装程序默认用户名称为当前登录操作系统的用户名。
步骤 8 : 选择 IP ,管理端口号。
开发版会默认安装一个缺省应用( default )和一个管理应用( Governor )。本步骤用来设置缺省应用的绑定 IP 和管理端口号。
在下拉列表框中选择目标安装机器的 IP 地址。多网卡或多 IP 情况下,必须选择其中的一个 IP ,该 IP 为安装的应用绑定地址。开发版默认使用 127.0.0.1 作为绑定地址,但使用该地址不能进行网络操作(如部署的默认应用将不能被其他机器上安装的 Governor 管理)。如果需要进行网络操作,请选择真实 IP 地址。
在管理端口文本框中输入端口号。管理端口是应用的管理端口, Governor 应用通过该端口对应用进行管理,管理端口也是 EOS 集群应用之间的相互通知端口。
注意:
默认端口号为 6200 。
端口号 6299 为保留端口号,默认被 governor 使用,不能使用。
端口号 6399 为保留端口号,默认被 workspace 使用,不能使用。
端口不自动累加,不做冲突检查,用户配置端口号时请自己保证端口号不冲突。
步骤 9 : 创建应用,用户填写应用名称,应用名默认为 “default” , 可选 部署 governor 应用以及 workspace 应用。单击 < 下一步 > 按钮。
注意:
应用名称应遵循下面规则:
应用名的长度必须在 3~64 之间,只支持半角英文字母和数字,支持 “.” , “_” , “-” ,以字母开头。
不允许使用 governor , workspace 做应用名。
如果 BPS 未选择安装, workspace 应用默认不安装。
步骤 10 : 配置数据库。
配置数据库界面的参数说明:
参数 | 说明 |
数据源名称 | 数据源 JNDI 名称,默认为 DefaultDataSource 。此配置在 Tomcat 、PAS 、 Tongweb 下没有意义,因为它们使用的是 C3P0 数据源。 |
数据库类型 | 选择应用使用的数据库类型。 |
服务器 IP | 连接数据库服务器的 IP 地址。 |
服务器端口 | 连接数据库服务器的端口号。各数据库服务器的缺省端口号如下: Oracle : 1521 DB2 UDB : 50000 SQL Server : 1433 MySql : 3306 KingbaseES : 54321 DM : 5236 GBase : 5258 Oscar : 2003 |
数据库名称 | 数据库的名称。 |
数据库用户 | 访问数据库的用户名。 |
数据库用户口令 | 访问数据库的用户密码。 |
数据库 URL | 访问数据库的 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 使用的表。
若要初始化指定的数据库,必须正确填写该数据库配置信息。
对于已经初始化过的数据库,安装包会提示,用户可以选择再次初始化或者不初始化
单击 < 数据库连接测试 > 按钮,测试所配置数据库是否可以成功连接。
步骤 11 : 阅读并审核安装设置信息,单击 < 安装 > 按钮。
步骤 12 : 开始安装,安装过程中显示各组件的安装进程。
步骤 13 : 程序提示开发环境已经成功安装。
步骤 14 : 单击 < 完成 > 按钮,完成开发版的安装。
验证开发版是否已正确安装的步骤如下:
步骤 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 目录中。 |
配置文件 | \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-7.0.54
检查项目 | 检查内容 |
数据库驱动 | %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 |
%TOMCAT_HOME%\ webapps | 检查是否存在应用 default( 或在安装过程中输入的应用名 ) 已选择安装应用( governor 、 workspace 、 sso-server ) 。 |
配置文件 | 检查数据源配置 检查应用配置 |
步骤 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 10.12.1 下安装开发版,由于 Mac 版 JDK 1.8 获取本地 IP 的问题导致启动 Server 会非常慢。可以在/etc/hosts 文件中添加如下配置:
127.0.0.1 localhost yourPCname.local
2 .如果是在 Windows 下安装开发版,且开发版使用的 JDK 版本是 1.7 及以上,可以在启动脚本 startServer.cmd 中添加如下 JVM参数来提升启动 Server 的速度:
-XX:+TieredCompilation -XX:TieredStopAtLevel=1 -Xverify:none
步骤 6 :验证登陆 server 。
检查是否成功登陆 default 应用。
如果部署了 Governor 应用,检查是否成功登陆。并且在首页检查“ 产品名称 ”是否为“ Primeton Platform ”及“产品版本号”是否为“ 7.6.0.0 ”。
如果部署了 Workspace 应用,检查是否成功登陆
下面介绍安装企业版前的准备工作,安装步骤,验证安装是否正确的方法,以及不同环境下安装需要注意的事项。
注:标准版和基础班安装步骤与企业版安装步骤一致。
安装企业版前,需做以下准备工作:
步骤 1 : 检查安装光盘。检查光盘贴膜标注是否为 “ 企业版 ” 。
步骤 2 : 检查安装环境。必须符合软件配置要求。
步骤 3 : 准备应用服务器:
如果安装时使用 WebLogic 类型服务器,需要建立一个部署应用的 domain 。可通过 WebLogic 的 configuration wizard 创建,具体创建步骤请用户自行查阅相关资料。 Weblogic 12.2.1.0 中安装 JDK 应该是 1.8 , Weblogic10.3.5 和 Weblogic12.2.1.0 必须启动AdminServer 之后才能正常安装。不建议将应用安装在 AdminServer 下。
如果安装时使用 WebSphere 类型服务器,需要建立一个应用程序服务器类型的 WebSphere Profile ( WebSphere 概要文件)。可通过 WebSphere 的概要文件管理工具创建,具体创建步骤请用户自行查阅相关资料。
注意:为防止页面乱码,请将 AppServer/properties/encoding.properties 中的 zh=GB2312 改成 zh=UTF-8 。
步骤 4 :检查权限
如果在 AIX 系统下,用户需要检查安装产品的系统帐户是否拥有执行 WebSphere 安装目录下 bin 目录中程序的权限。建议都是安装产品和安装 WebSphere 都使用帐户“ root ”。
以 Red Hat 3.4.6-9 + WebLogic 1 2.2.1.0 + Oracle 1 2c 环境为例,企业版的安装步骤如下:
步骤 1 : 运行 install.sh ,启动安装程序。
注意:如果用户想要进行远程安装,需先安装支持远程调用 X Windows ( UNIX 系统的桌面可视化程序)并将图形输出到客户端的软件。然后以命令行模式远程登录 Linux 系统,再运行命令 “export DISPLAY=% 客户端 IP%:0” ,随后便可以运行 install.sh 进行远程安装了。
步骤 2 : 阅读安装简介,单击 < Next > 按钮。
步骤 3 : 阅读企业版的许可声明后,选择 “ I accept the terms of the License Agreement ” 单选按钮,单击 < Next > 按钮。
步骤 4 : 单击 < Choose > ,从弹出的对话框中选择安装目录,单击 < Next > 按钮。
注意:安装路径最多可输入 64 个字符,只能由半角英文字母、数字、点 “.” 或下划线 “_” 组成,且不允许带空格。
步骤 5 : 选择应用服务器。
参数 | 说明 |
App Server/ 应用服务器 | 选择所使用的应用服务器类型。 |
Bea Home | Bea 产品主目录。 |
Weblogic Home | WebLogic 目录。用户选择 “BEA HOME” 后,系统会自动填写 “Weblogic HOME” ,用户无需手动更改。 |
Domain Home | 用户创建的 domain 目录。 |
Login name/ 用户名 | 创建具有管理安全性的 domain 时设置的用户名。 |
PassWord | 创建具有管理安全性的 domain 时设置的用户密码。 |
Target Server N ame | 需要安装的 Server 名称 。 不建议安装到 AdminServer 下。 |
Admin Server PORT | 主管 服务 器 端口,默认为 7001 。 |
Clustered/ 集群 | 是否集群应用,如果没有这个选项,说明不支持集群。 |
步骤 6 : 安装选项,选择安装组件。安装组件有 EJB 、 COFRAME 、 BPS 和 SSO ,都为可选项。
步骤 7 : 设置管理员口令。
使用 Governor 管理员用户名和口令可以登录管理监控应用 Governor ,进行应用的管理和监控操作。使用 Workspace 管理员用户名和口令可以登录流程管理应用 workspace 进行流程管理监控。
输入管理员的密码和确认密码。安装程序默认 sysadmin 的密码为 “000000” 。用户可以在此设置新密码,密码长度必须在 6 ~ 20位之间。
步骤 8 : 选择 IP ,管理端口号。
企业版会默认安装一个缺省应用( default )。本步骤用来设置缺省应用的绑定 IP 和管理端口号。
在下拉列表框中选择本机 IP ,如果有多个可用的网络连接,则需要选择其中的一个 IP 。该 IP 为安装的 EOS 应用绑定地址。 企业版安装请使用真实 IP 地址。
在管理端口文本框中输入端口号。管理端口是应用的管理端口, Governor 应用通过该端口对应用进行管理,管理端口也是 EOS 集群应用之间的相互通知端口。
注意:
默认端口号为 6200 。
端口号 6299 为保留端口号,默认被 governor 使用,不能使用。
端口号 6399 为保留端口号,默认被 workspace 使用,不能使用。
端口不自动累加,不做冲突检查,用户配置端口号时请自己保证端口号不冲突。
步骤 9 : 创建应用,用户可以创建默认应用,并自定义名称,默认该应用名为 default 。默认应用、 Governor 、 Workspace 均可以选择性部署。单击 < 下一步 > 按钮。
注意:
应用名称应遵循下面规则:
应用名的长度必须在 3~64 之间,只支持半角英文字母和数字,支持 “.” , “_” , “-” ,以字母开头。
不允许使用 governor , workspace 做应用名。
不允许与已有应用重名 。
步骤 10 : 配置数据库。
配置数据库界面的参数说明:
参数 | 说明 |
数据源名称 | 数据源 JNDI 名称,默认为 DefaultDataSource 。此配置在 Tomcat 和PAS 下没有意义,因为它们使用的是 C3P0 数据源。 |
数据库类型 | 选择应用使用的数据库类型。 |
服务器 IP | 连接数据库服务器的 IP 地址。 |
服务器端口 | 连接数据库服务器的端口号。各数据库服务器的缺省端口号如下: Oracle : 1521 DB2 UDB : 50000 SQL Server : 1433 MySql : 3306 KingbaseES : 54321 DM : 5236 GBase : 5258 Oscar : 2003 |
数据库名称 | 数据库的名称。 |
数据库用户 | 访问数据库的用户名。 |
数据库用户口令 | 访问数据库的用户密码。 |
数据库 URL | 访问数据库的 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 使用的表。
若要初始化指定的数据库,必须正确填写该数据库配置信息。
对于已经初始化过的数据库,安装包会提示,用户可以选择再次初始化或者不初始化
单击 < Connection Test > 按钮,测试所配置数据库是否可以成功连接。
步骤 11 : 阅读并审核安装设置信息,单击 < Install > 按钮。
步骤 12 : 开始安装,安装过程中显示各组件的安装进程。
步骤 13 : 程序提示已经安装完成。
步骤 14 : 单击 < Finish > 按钮,完成企业版的安装。
以( Red Hat 3.4.6-9 + WebLogic 1 2.2.1.0 + Oracle 1 2c )环境为例,验证企业版是否已正确安装的步骤如下:
步骤 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 |
ear 目录 | %Domain Home%/applications 下存在目录 default.ear (或者是安装时输入的应用名) 、 governor. war 、 workspace.ear 、 sso-server.ear 。 |
步骤 4 : 检查 startServer.sh 。该文件位于安装目录下。
运行 startServer.sh ,可以启动 WebLogic 服务。
步骤 5 : 登录 domain 管理服务控制台( Admin server console )查看数据源配置存在。
以 Red Hat 3.4.6-9 (英文环境,部分配置参数将以 English/ 中文的形式加以说明) + WebSphere 8.5 + DB2 UDB_V9. 7 环境为例,企业版的安装步骤如下:
步骤 1 : 运行 install.sh ,启动安装程序。
注意:如果用户想要进行远程安装,需先安装支持远程调用 X Windows ( UNIX 系统的桌面可视化程序)并将图形输出到客户端的软件。然后以命令行模式远程登录 Linux 系统,再运行命令 “export DISPLAY=% 客户端 IP%:0” ,随后便可以运行 install.sh 进行远程安装了。
步骤 2 : 阅读安装简介,单击 < Next > 按钮。
步骤 3 : 阅读企业版的许可声明后,选择 “ I accept the terms of the License Agreement ” 单选按钮,单击 < Next > 按钮。
步骤 4 : 单击 < Choose > ,从弹出的对话框中选择安装目录,单击 < Next > 按钮。
注意:安装路径最多可输入 64 个字符,只能由半角英文字母、数字、点 “.” 或下划线 “_” 组成,且不允许带空格。
步骤 5 : 选择应用服务器。
选择 WebSphere 应用服务器界面图示及参数说明表如下。
参数 | 说明 |
App Server/ 应用服务器 | 选择应用所使用的应用服务器类型。 |
Profile Home | WebSphere 的概要文件目录。 |
Cell Name | 管理服务器单元的名称。该参数会在选择正确的 “Profile Home” 之后自动填写,用户无需手动更改。 |
Node Name | WebSphere 节点名称。该参数会在选择正确的 “Profile Home” 之后自动填写,用户无需手动更改。 |
Server name | WebSphere Server 名称。该参数会在选择正确的 “Profile Home” 之后自动填写,用户无需手动更改。 |
User name | 创建具有管理安全性的 Profile 时设置的用户名。 |
PassWord | 创建具有管理安全性的 Profile 时设置的用户密码。 |
Clustered/ 集群 | 是否集群应用。 |
步骤 6 : 安装选项,选择安装组件。安装组件有 EJB 、 COFRAME 、 BPS 和 SSO ,都为可选项。
步骤 7 : 设置管理员口令。
使用 Governor 管理员用户名和口令可以登录管理监控应用 Governor ,进行应用的管理和监控操作。使用 Workspace 管理员用户名和口令可以登录流程管理应用 workspace 进行流程管理监控。
输入管理员的密码和确认密码。安装程序默认 sysadmin 的密码为 “000000” 。用户可以在此设置新密码,密码长度必须在 6 ~ 20位之间。
步骤 8 : 选择 IP ,管理端口号。
企业 版会默认安装一个缺省应用( default )。本步骤用来设置缺省应用的绑定 IP 和管理端口号。
在下拉列表框中选择本机 IP ,如果有多个可用的网络连接,则需要选择其中的一个 IP 。该 IP 为安装的 EOS 应用绑定地址。 企业版安装请使用真实 IP 地址。
在管理端口文本框中输入端口号。管理端口是应用的管理端口, Governor 应用通过该端口对应用进行管理,管理端口也是 EOS 集群应用之间的相互通知端口。
注意:
默认端口号为 6200 。
端口号 6299 为保留端口号,默认被 governor 使用,不能使用。
端口号 6399 为保留端口号,默认被 workspace 使用,不能使用。
端口不自动累加,不做冲突检查,用户配置端口号时请自己保证端口号不冲突。
步骤 9 : 创建应用,用户可以创建默认应用,并自定义名称,默认该应用名为 default 。默认应用、 Governor 、 Workspace 均可以选择性部署。单击 < Next > 按钮。
注意:
应用名称应遵循下面规则:
应用名的长度必须在 3~64 之间,只支持半角英文字母和数字,支持 “.” , “_” , “-” ,以字母开头。
不允许使用 governor , workspace 做应用名。
不允许与已有应用重名 。
步骤 10 : 配置数据库。
配置数据库界面的参数说明:
参数 | 说明 |
数据源名称 | 数据源 JNDI 名称,默认为 DefaultDataSource 。此配置在 Tomcat 和PAS 下没有意义,因为它们使用的是 C3P0 数据源。 |
数据库类型 | 选择应用使用的数据库类型。 |
服务器 IP | 连接数据库服务器的 IP 地址。 |
服务器端口 | 连接数据库服务器的端口号。各数据库服务器的缺省端口号如下: Oracle : 1521 DB2 UDB : 50000 SQL Server : 1433 MySql : 3306 KingbaseES : 54321 DM : 5236 GBase : 5258 Oscar : 2003 |
数据库名称 | 数据库的名称。 |
数据库用户 | 访问数据库的用户名。 |
数据库用户口令 | 访问数据库的用户密码。 |
数据库 URL | 访问数据库的 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 使用的表。
若要初始化指定的数据库,必须正确填写该数据库配置信息。
对于已经初始化过的数据库,安装包会提示,用户可以选择再次初始化或者不初始化
单击 < Connection Test > 按钮,测试所配置数据库是否可以成功连接。
步骤 11 : 阅读并审核安装设置信息,单击 < Install > 按钮。
步骤 12 : 开始安装,安装过程中显示各组件的安装进程。
步骤 13 : 程序提示已经安装完成。
步骤 14 : 单击 < Finish > 按钮,完成企业版的安装。
以 Red Hat 3.4.6-9 + WebSphere8.5 + DB2 UDB_V9. 7 环境为例,验证企业版是否已正确安装的步骤如下:
步骤 1 : 安装程序提示安装成功。
步骤 2 : 检查日志。
打开安装目录 (比如: /root/primeton/platform ) 下的 eos_ platform_7.6_install.log 安装日志文件,检查安装过程中没有异常信息。
步骤 3 : 检查数据库驱动和目录:
检查项目 | 检查内容 |
数据库驱动 | %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 |
ear 目录 | %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
哑安装方式即用户通过属性文件一次性定制各安装参数,运行安装包后,安装程序从该属性文件中读取参数进行安装。整个安装过程完全自动化,无需用户干预。哑安装方式能够解决界面交互安装方式对安装环境要求高,非自动化等问题。
哑安装配置在 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_NAME | 数据源 JNDI 名称, Tomcat 、 PAS 、 TongWeb 应用服务器下不需要。 |
DB_TYPE | 使用的数据库类型,为必填参数。 必须设置为以下值中的一个: Oracle DB2 UDB SQLServer MySql KingbaseES DM GBase Oscar |
DB_DRIVER | 数据库 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 |
DB_VERSION | 数据库版本,如果使用 DB2_9.7 需要写添加这个参数 :DB_VERSION=9.7 |
DB_IS_DEFAULT_JAR | 是否使用默认的数据库驱动,为必填参数。只能设置为 true 或 false 。 因数据库使用 JDBC 连接,安装包内自带了 Oracle 、 DB2 UDB 、 SQL Server 、 MySql 、 KingbaseES 、 DM 、 GBase 、 Oscar 的数据库驱动。若默认的数据库驱动不能与用户所要连接的数据库相匹配,请将本参数设置为 false ,并在 DB_JDBC_LIBS 中设置相应的 jar 包。 说明:本参数为false时,DB_JDBC_LIBS参数值不能为空。 |
DB_JDBC_LIBS | 用户自选的数据库 JDBC 驱动文件路径( jar 包)。 如果有多个文件,以英文分号 “;” 分隔,如: D:\jdbc\a.jar;D:\jdbc\b.jar 说明:仅当IS_DEFAULT_JAR值为false时,才需要配置本参数。 |
DB_IP | 连接数据库服务器的 IP 地址,为必填参数。 |
DB_SERVER_PORT | 连接数据库服务器的端口号,为必填参数。各数据库服务器的缺省端口号如下: Oracle : 1521 DB2 UDB : 50000 SQL Server : 1433 MySql : 3306 KingbaseES : 54321 DM : 5236 GBase : 5258 Oscar : 2003 |
DB_NAME | 数据库的名称。 |
DB_USERNAME | 访问数据库的用户名,为必填参数。 |
DB_PASSWORD | 访问数据库的用户密码,为必填参数。 |
DB_ IS_INIT | 是否要初始化数据库,为必填参数。 true 为初始化, false 为不初始化。 说明: 如果是初次使用某个数据库,建议初始化该数据库,否则会导致应用不能正常运行;对于已执行过初始化的数据库,再次初始化将覆盖已经修改的 Platform 表。 初始化数据库时,安装程序将在数据库中创建 Platform 使用的表和视图。 若要初始化指定的数据库,必须正确填写该数据库配置信息。 |
DB_IS_FORCE_INIT | 是否强制初始化数据库, 说明: DB_ IS_INIT 为 true 时,如果该数据库已经初始化过 Primeton Platform 的系统表,需要配置 DB_IS_FORCE_INIT 。 true :强制再次初始化数据; false :不会再次初始化已经初始化过Primeton Platform 系统表的数据库。 |
公共安装信息 | |
INSTALL_DIR | 安装目录,为必填参数。 说明: 安装路径最多可输入 64 个字符,只能由半角英文字母、数字或下划线“_” 组成,且不允许带空格。 在 windows 系统下,安装目录中的 “\” 需要改成 “/” ,例如: D :/primeton/de 。 |
SYSADMIN_PWD | governor 管理员 sysadmin 的密码,为必填参数。 密码长度必须在 6 ~ 20 位之间,密码只能由半角英文字母、数字、 “.”或下划线 “_” 组成。 |
WORKSPACE_SYSADMIN_PWD | workspace 管理员 sysadmin 的密码,为必填参数。 密码长度必须在 6 ~ 20 位之间,密码只能由半角英文字母、数字、 “.”或下划线 “_” 组成。 |
USER_NAME | 用户名称,非必填参数。 |
USER_COMPANY | 用户所在的机构名称,非必填参数。 |
USER_IP | 填写目标安装机器的 IP 地址。多网卡或多 IP 情况下,必须选择其中的一个 IP ,该 IP 为安装的应用绑定地址。 |
USER_PORT | 管理端口是应用的 JMX 管理端口, Governor 应用通过该端口对应用进行管理,管理端口也是集群应用之间的相互通知端口。 |
IS_DEPLOY_DEFAULTAPP | 是否部署默认应用,非必填参数。 |
DEFAULT_APP_NAME | 默认应用名称。 说明: 应用名的长度必须在 3~64 之间,只支持半角英文字母和数字,支持“.” , “_” , “-” ,以字母开头。 不许使用 governor 、 workspace 做应用名。 不允许与已有应用重名。 |
IS_DEPLOY_GOVERNOR | 是否部署 governor 应用,非必填参数。 |
IS_DEPLOY_WORKSPACE | 是否部署 workspace 应用,非必填参数。 |
IS_DEPLOY_EJB | 应用是否部署 EJB ,应用服务器为非 tomcat 环境时配置。 |
MODULE_OPTIONS | 要安装的选件名称,有 EJB 、 BPS 、 C OFRAME 可选。 |
对于不同的应用服务器,需要配置不同的参数:
参数名称 | 参数意义 |
公共参数 | |
APP_SERVER_NAME | 应用服务器名称,为必填参数。 |
APP_SERVER_VERSION | 应用服务器版本,为必填参数。 |
企业版专用参数 | |
IS_REPEAT_INSTALLED | 是否重复安装,多次安装使用,非必填,多次安装时填写true ,第一次安装不填或填写 false 。 |
Tomcat 专用参数 | |
AS_TOMCAT_HOME | Tomcat 的安装目录。 |
TOMCAT_JAVA_HOME | Tomcat 安装的 java_home 目录。 |
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 |
AS_WL_TARGET_SERVER | 目标服务器名称。如: server1 |
AS_WL_WEBSVR_PORT | WebServer 端口号, WebLogic 默认是 7001 ,为必填参数。 |
AS_WL_USERNAME | WebLogic 安全用户名。 |
AS_WL_PASSWORD | WebLogic 安全用户密码。 |
IS_CLUSTER | 集群配置参数,集群环境配置为 true ,非集群环境配置为false 。 |
WebSphere 专用参数 | |
AS_WAS_SERVER_NAME | 应用服务器名称,非集群环境时配置。 |
AS_WAS_CLUSTER_NAME | 集群名称,集群环境时配置。 |
AS_WAS_CELL_NAME | 应用服务器单元的名称,为必填参数。 |
AS_WAS_NODE_NAME | 应用服务器节点名称。 |
AS_WAS_PROFILE | Profile 的名称。 |
AS_WAS_PROFILE_HOME | Profile 的绝对路径,为必填参数。 |
AS_WAS_USERNAME | 具有管理安全性 Profile 的用户名。 |
AS_WAS_PASSWORD | 具有管理安全性 Profile 的用户密码。 |
IS_CLUSTER | 集群配置参数,集群环境配置为 true ,非集群环境配置为false 。 |
IS_SECURITY_CHECK | 是否检测 Profile 的安全性。 |
TongWeb 专用参数 | |
AS_TONGWEB_HOME | TongWeb 的安装目录。 |
PAS 专用参数 | |
AS_PAS_HOME | PAS 的安装目录。 |
下面提供几个典型环境下的哑安装配置文件示例,仅供参考,具体参数值根据实际情况填写。
安装程序对于参数值为空的参数处理方式是忽略,因此用户可以保留那些不需要填写值的参数。
注意:配置路径时需要自已转义,如“ D:\platform\platform1352 ”需转义为“ D:\\platform\\platform1352 ” 或“D:/platform/platform1352 ”,否则安装时会出现错误。
#Install Target Directory
INSTALL_DIR=D:/install-dir
#JavaEE Server Type
APP_SERVER_NAME=Tomcat
APP_SERVER_VERSION=7.0.54
#tomcat http port for http request
APP_SERVER_PORT_DE=8080
#DataBase Type , for example : Oracle,DB2 UDB,SQLServer,MySql
DB_TYPE=Oracle
#JDBC Driver
DB_DRIVER=oracle.jdbc.driver.OracleDriver
#DataBase Server IP
DB_IP=192.168.1.251
#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
#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=127.0.0.1
USER_PORT=6200
#sysadmin's Password
SYSADMIN_PWD=000000
#workspace sysadmin's Password
WORKSPACE_SYSADMIN_PWD=000000
#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
#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=127.0.0.1
#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
#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=127.0.0.1
USER_PORT=6200
#sysadmin's Password
SYSADMIN_PWD=000000
#workspace sysadmin's Password
WORKSPACE_SYSADMIN_PWD=000000
#if repeat install set it true
IS_REPEAT_INSTALLED=false
集群环境应用部署典型场景
如上图,管理控制台应用 governor 和 workspace 安装部署在管理服务器上,而业务应用安装部署在集群的被管服务器上, governor 和workspace 管理集群上的应用。集群环境的控制台应用和业务应用必须分开安装部署。
在 win10 上 以应用服务器 WebLogic 12.2.1.0 为例进行集群安装说明。
默认已经成功安装 Weblogic12.2.1.0 。
步骤 1 :打开 { 安装目录 } wlserver\common\bin \config.cmd 。
步骤 2 : 选择 创建新域 。选择 域 安装 位置 ,单击 < 下一步 > 。
步骤 3 :选择产品模板 ,单击 < 下一步 > 按钮。
步骤 4 : 配置管理员和密码,输入 Weblogic 管理员管理服务器( AdminServer )的用户名和密码,确认密码,单击 < 下一步 > 按钮。
步骤 5 : 配置域模式和 JDK 。选择 “ 生产 模式 ” 和 “ JDK ” 后,单击 < 下一步 > 按钮。
步骤 6 : 选择 “管理服务器”和“受管服务器,集群和 Coherence ” 。单击 < 下一步 > 。
步骤 7 : 配置管理服务器。输入 Administrator Server 的名称,监听地址,监听端口,如果需要 SSL 支持的话可以在 “SSL enabled” 复选取框上打勾,配置 SSL 监听端口,单击 < 下一步 > 按钮。
步骤 8 : 配置受管理服务器。代理服务器也是一个受管理服务器。输入 Managed Server 的名称,监听地址,监听端口,如果需要 SSL支持的话,可以在 “SSL enabled” 复选框上打勾,配置 SSL 监听端口。可以配置一个 ProxyServer 和多个 Managed Server 。如图所示,单击 < Next > 按钮。
注意 :
受限于 WebLogic 为受管服务器配置的 JMS 数据库表名长度,建议受管服务器名不超过 19 个字符。
server1 和 server2 是本例创建的受管服务器名,用户应以实际创建的受管服务器名为准。
步骤 9 : 配置集群信息。单击 “ 添加 ” ,输入 Cluster 的名称, 集群 地址, 前端主机,前端 HTTP 端口,前端 HTPPS 端口。填写集群名称与集群地址 , 其余 可输可不输。单击 < 下一步 > 按钮。
步骤 1 0 : 将受管理服务器添加到集群中。选择左面列表中的 Managed Server ,将其添加到右面的列表中,这里代理服务器不要添加到右边,单击 < Next > 按钮。
步骤 1 1 : 配置计算机。在此不对计算机进行配置,单击 < 下一步 > 按钮。
步骤 1 2 : 检查 WebLogic 域,如果没有问题单击 < 下一步 > 按钮。
步骤 1 3 : 创建域。创建无误后,单击 < 创建 > 。
步骤 1 4 : 为每个受管服务器创建外置目录,建议以 apps_config 为文件夹名,外置配置目录用来存放应用启动配置和运行期的配置。
编辑口令文件,在 之前 创建的域目录 servers/adminServer/security 下创建 boot.properties 文件,内容为前文中创建 WebLogic 集群设置安全性用户名和密码,如:
username=weblogic
password=weblogic
编辑启动管理服务器的文件,在创建的域目录下的 bin 目录中创建 startAdminServer.cmd 文件,内容为:
@ECHO OFF
@REM 启动管理服务器 .
start .\startWebLogic
编辑受管理服务器的文件。
以 server 1 为例,在刚才创建的域目录下的 bin 目录中创建 start Server1 .cmd 文件,增加外置目录参数,内容为:
@ECHO OFF
@REM 启动受管理服务器 ManagedServer_1.
@REM 启动 Managed Server
@REM 使用 startManagedWeblogic 命令启动 Managed Server ,它的命令格式是:
@REM startManagedWeblogic.cmd Managed Server 的名称 Administrator Server 地址
@REM startManagedWeblogic 受管理服务器名称 管理服务器 URL
Set JAVA_OPTIONS=%JAVA_OPTIONS% -DEXTERNAL_CONFIG_DIR=C: / ceshiwel / server1 / apps_config
start .\startManagedWebLogic server1 http://192.168. 16.109 :7001
说明:
1. 使用 startManagedWeblogic 命令启动 Managed Server ,它的命令格式是: startManagedWeblogic.cmd < 受管服务器名 > < 管理服务器 URL> 。
2.%EXTERNAL_CONFIG_DIR% 参数是外置配置目录的参数,外置配置目录用来存放应用启动配置和运行期的配置。
外置目录,在各个受管服务器外置目录下创建以部署到该集群的应用为名称的子目录,如 default ,在该应用配置子目录下创建startup.conf 文件,配置应用的绑定 IP 和管理端口,格式如下:
AdminPort=620 1
LocalIP=192.168. 16.109
用户应保证 LocalIP 值为受管服务器所在机器的一个真实 IP , AdminPort 值不被其他已部署应用占用。
下面仅对应用服务器选择步骤进行说明,安装步骤如下:
步骤 1 : 选择应用服务器,选中集群复选框,在应用服务器下拉框中选中 WebLogic 12.2.1.0 ,在 Bea Home 选择 bea 安装目录 , 选择WebLogic Home 。在 Domain Home 选择 domain 安装目录,输入管理员用户名和密码,集群名如: c luster ,集群管理服务器端口号,如: 7001 。
参数 | 说明 |
Bea Home | WebLogic 的安装目录。 |
Weblogic Home | Weblogic HOME 为 Weblogic 安装下面的 wlserver 目录 |
Domain Home | 用户创建的 domain 目录。 |
用户名 | 创建具有管理安全性的 domain 时设置的用户名。 |
密码 | 创建具有管理安全性的 domain 时设置的用户密码。 |
Cluster Name | 用户创建的集群名称。 |
Admin Server PORT | 集群服务端口。 |
集群 | 是否集群应用。 |
步骤 2 : 安装完成后,重启集群。保证应用能正常运行必须重启一次集群,至此安装完毕。
步骤 1 : 安装 governor 应用到一个 domain 中,或其他类型的应用服务器中,安装过程请参考 “ 安装企业版 ” 。本例中采用 tomcat 作为应用服务器。
步骤 2 : 启动 WebLogic 集群,启动管理服务器、受管服务器,通过 URL : http://%AdminserverIP%:%AdminserverPort%/console 登陆控制台确认部署的应用如 default 已启动。
步骤 3 : 启动 governor ,启动部署 governor 的应用服务器,登陆 governor 控制台。
步骤 4 : 点击应用管理,添加集群被管应用。应用名称与用户部署在 WebLogic 集群上的应用相同, IP 地址为部署该应用的受管服务器的 IP 地址,管理端口号为受管服务器管理该应用的端口,可在前文配置的该受管服务器的外置目录下 startup.conf 文件中查看,选中加入新建的集群,输入集群名称。单击 < 确定 > 。
步骤 5 :查 看 governor 中被管应用,已启动,已同步。
步骤 6 : 向集群中加入多个被管应用,会将第一个应用中的 EOS 配置信息作为模板。添加完毕集群中所有应用,除第一个应用外,所有应用配置文件需要与模板文件进行同步操作,此时需要重启其他应用以便同步 EOS 配置文件。
步骤 7 :如果选择 了 BPS , 则需要对 BPS 引擎进行配置。依次选择: BPS 引擎配置 -> 运行参数配置,目标选择“ cluster ”,选中“是否启用集群”后的复选框,如图。
注意:启用 BPS 引擎集群配置后重启集群。
步骤 1 :如果 选择了 BPS ,则需要 安装 workspace 。 workspace 可以通过安装包进行安装,安装时只需在安装选项中选择 workspace 即可,也可以在上一步安装 governor 时同时安装 workspace 。
步骤 2 :在 workspace 中添加受管引擎。登录“引擎实例管理”,将 server1 和 server2 添加到 workspace 中,添加时测试连接是否正常,保证添加的引擎是可用的,如图。
以 Win 10 + WebLogic 12.2.1.0 + Mysql5.5 环境为例,验证集群环境是否已正确安装的步骤如下:
步骤 1 : 启动集群,启动管理服务器、受管服务器,通过 URL:http://AdminserverIP:AdminserverPort/console 登陆 WebLogic 管理控制台。
步骤 2 : 查看 服务器 。
步骤 3 : 查看数据源,用户配置数据源存在,用户可进一步查看各项属性如 JNDI 名称,连接池配置和用户创建该数据源时的输入一致。
步骤 4 : 应用能够启动,启动时没有异常。
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> <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
|__... ...
3 )重启整个集群,包括集群的主管服务器,集群的被管服务器。
注意:
这种手工配置成 nostage 模式的方法,适合于后续通过 governor 部署 ECD 来升级应用的场景,但不支持新增加集群节点场景,如果要新增加集群节点,建议还是采取 stage 模式,但以后更新或升级应用只能采取通过 Weblogic 管理服务器对集群重新部署 EAR 来进行应用升级。
以应用服务器 WebSphere 6.1 为例进行集群安装说明。
安装 Deployment 管理服务器节点和联合应用程序服务器
步骤 1 : 运行 WebSphere\AppServer\firststeps\firststeps.bat ,点击概要文件管理工具。或者进入$WAS_HOME$\AppServer\bin\ProfileManagement> 目录运行 pmt.bat 命令。
步骤 2 : 选择功能部件 , 选中 “ 单元( Deployment Manager 和联合应用程序服务器) ” 即可,如下图所示。系统将创建一个Deployment Manager 和一个 Node 节点。
步骤 3 : 指定概要文件位置、节点名、主机名、单机名选择高级概要文件创建,缺省部署管理控制台和缺省应用程序。在输入节点名和主机名时必须正确,主机名区分大小写,建议不要填写 IP 地址。节点名和单元名取默认值即可,但是要保证集群中的节点名不可重复。在本例中新建 Manager 概要为 Dmgr02 ,新建 node 概要为 Managed1 。
步骤 4 : 安全性、端口和服务指定用户自定义安全性,集群各节点的端口不能出现冲突,不将 Deployment Manager 进程作为 Windows服务运行。
步骤 5 : 安装第二个应用程序服务器节点 , 运行 WebSphere\AppServer\firststeps\firststeps.bat ,点击概要文件管理工具:
步骤 6 : 选择功能部件只需选中 “ 应用程序服务器 ” 即可,如下图所示。系统将创建一个应用程序服务器节点。
步骤 7 : 指定概要文件位置、节点名、主机名、单机名选择高级概要文件创建,部署管理控制台和缺省应用程序。在输入节点名和主机名时必须正确,主机名区分大小写,建议不要填写 IP 地址。节点名和单元名取默认值即可,但须保证节点名不可重复。本例中新建概要名为 Managed2 。
步骤 8 : 安全性、端口和服务指定、 IBM HTTP Server 自定义安全性设置,集群各节点的端口不能出现冲突,不将 Application Server进程作为 Windows 服务运行。
注意:
建议记住创建时的 SOAP 端口号,在将该节点和集群节点联合时需要输入,这是和 WebSphere 5.1 不同的。
步骤 9 : 启动 Deployment 管理服务器 , 进入 Deployment 管理服务器的安装目录 WebSphere\AppServer\profiles\Dmgr02\bin ,执行命令:
startManager.bat
步骤 1 0 : Deployment 管理服务器启动后,即可使用浏览器通过 URL 地址 http://localhost:9047/admin 访问 Deployment 管理服务器的管理控制台。在同一目录下使用 stopManager.bat 命令可以停止 ND 服务。
说明:
URL 地址 http://localhost:9047/admin 中的管理控制台访问端 “9047” 可能在不同的机器上会有变化,可以进入 WebSphere\AppServer\profiles\Dmgr01\logs\ 目录下的AboutThisProfile.txt 来查看管理控制台访问端口。
步骤 1 1 : 将 WebSphere 节点加入 ND , 增加节点 Node02, 进入应用程序服务器的安装目录 WebSphere\AppServer\profiles\Managed2\bin,执行命令:
addNode.bat 192.168.0.54 8884
说明:
192.168.0.54 是主管服务器的 IP 地址, 8884 是主管服务器的 SOAP 管理端口,如下图所示,您可以登录 ND 的管理控制台查看 SOAP 端口。
步骤 1 2 : 系统开始在集群单元中添加节点,添加成功后注销并重新登录控制台查看节点信息,集群节点和两个应用程序节点全部联合。如下图所示:
通过以下步骤,可以建立 WebSphere 6.1 集群 :
步骤 1 3 : 登录 Deployment 管理服务器的控制台,单击导航树中的 “ 服务器 \ 集群 ” ,进入 “ 服务器集群 ” 页面。
步骤 1 4 : 单击 < 新建 > 按钮,进入 “ 创建新集群 ” 页面。
步骤 1 5 : 输入集群名称,单击 < 下一步 > 按钮,进入 “ 创建新的 集群 成员 ” 页面。
通过 “ 选择节点 ” 下拉列表框选择 “Node001” ,如下图所示。
步骤 1 6 : 单击 < 下一步 > 按钮,创建 “Node001” 上的 集群 服务器。回到 “ 创建新的 集群 成员 ” 页面中,通过 “ 选择节点 ” 下拉列表框选择 “Node002” ,如下图所示。
步骤 1 7 : 单击 < 添加成员 > 按钮,创建 “Node002” 上的 集群 服务器。至此,已新建了 “Node001” 和 “Node002” 上的 集群 服务器,如下图所示。
步骤 1 8 : 单击 < 完成 > 按钮,返回 “ 服务器 集群 ” 页面,如下图所示。
步骤 1 9 : 单击 “ 查看 ” 超链接,系统提示 “ 保存到主配置 ” 。选中 “ 与节点同步更改 ” 复选框后,单击 < 保存 > 按钮,如下图所示。
步骤 20 : 单击导航树中的 “ 服务器 \ 应用程序服务器 ” ,进入 “ 应用程序服务器 ” 页面,查看新建的集群服务器,如下图所示。其中, “Managed1_Server1” 和 “Managed2_Server1” 是新创建的 集群 服务器,两个 “server1” 分别是 “Node1” 和 “Node2” 节点默认的服务器。
步骤 21 : 选中两个 “server1” 左侧的复选框,单击 < 删除 > 按钮,删除默认服务器(集群中不需要这两个默认服务器)。结果如下:
步骤 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 子目录下),启动集群的所有服务器,如图所示。
下面仅对应用服务器选择步骤进行说明,安装步骤如下:
步骤 1 : 选择应用服务器。选中集群复选框,在应用服务器下拉框中选中 WebSphere6.1 ,在 Deployment Manager Home 行点击 < 浏览> 选择 Deployment Manager 概要文件目录 , 安装包自动读出单元名称 (Cell Name) 和集群名称 (Cluster Name) ,在 UserName 和 Password文本框填写 profile 安全性用户名和密码。
参数 | 说明 |
Deployment Manager Home | Deployment Manager 概要安装目录。 例如: /opt/WebSphereND61EOS/profiles/Dmgr02 ,该目录为一个Deployment Manager Home , Dmgr02 是用户创建的 Deployment Manager 的名称。 |
Cell Name | 管理服务器单元的名称。该参数会在选择正确的 “Deployment Manager Home” 之后自动填写,用户无需手动更改。 |
Cluster Name | WebSphere 集群名称。该参数会在选择正确的 “Deployment Manager Home” 之后自动填写,用户无需手动更改。 |
User name | 创建具有管理安全性的 Deployment Manager Profile 时设置的用户名。 |
PassWord | 创建具有管理安全性的 Deployment Manager Profile 时设置的用户密码。 |
集群 | 是否集群应用。 |
步骤 2 : 安装完成后,关闭集群,在 “ 搭建 Websphere 集群环境 ” 创建的各个受管服务器的外置目录下创建以部署到该集群的应用名为名称的子目录,如本例中 default ,在该应用配置子目录下创建 startup.conf 文件,配置应用的绑定 IP 和管理端口,格式如下:
AdminPort=6200
LocalIP=192.168.0.54
步骤 3 : 用户应保证 LocalIP 值为受管服务器所在机器的一个真实 IP , AdminPort 值不被其他已部署应用占用。重启集群。保证 EOS应用能正常运行必须重启一次集群,至此安装完毕。
步骤 1 : 安装 Governor 应用到另一个单机 profile 中,或其他类型的应用服务器中,安装过程请参考 “ 安装企业版 ” 。本例中采用tomcat 作为应用服务器。
步骤 2 : 启动集群的各个 Server ,登陆管理控制台,启动部署的应用,确认启动状态,如图所示,否则 Governor 无法添加该应用。
步骤 3 : 启动 Governor ,启动部署 Governor 的应用服务器,登陆 Governor 控制台。
步骤 4 : 点击应用管理,添加集群被管应用。应用名称与 WebSphere 集群上的受管应用相同, IP 地址为部署该应用的 profile 的 IP 地址,管理端口号为服务器管理该应用的端口,可在前文配置的外置目录下的 startup.conf 文件中查看。选中加入新建的集群,输入集群名称。单击 < 确定 > 。
步骤 4 : 重启集群,察看 Governor 中被管应用,已启动,已同步。
步骤 5 : 向集群中加入多个被管应用,会将第一个应用中的 EOS 配置信息作为模板。添加完毕集群中所有应用,除第一个应用外,所有应用配置文件需要与模板文件进行同步操作,此时需要重启其他应用以便同步 EOS 配置文件。
步骤 6 :如果选择 了 BPS , 则需要对 BPS 引擎进行配置。依次选择: BPS 引擎配置 -> 运行参数配置,目标选择“ testCluster ”,选中“是否启用集群”后的复选框,如图。
注意:启用 BPS 引擎集群配置后重启集群。
步骤 1 :如果 选择了 BPS ,则需要 安装 workspace 。 workspace 可以通过安装包进行安装,安装时只需在安装选项中选择 workspace 即可,也可以在上一步安装 governor 时同时安装 workspace 。
步骤 2 :在 workspace 中添加受管引擎。登录“引擎实例管理”,将 ManagedServer1 和 ManagedServer2 添加到 workspace 中,添加时测试连接是否正常,保证添加的引擎是可用的,如图。
以 Win7 + WebSphere 6.1.0.17 + DB2 UDB_V9. 7 环境为例,验证 Primeton EOS Platform 集群环境是否已正确安装的步骤如下:
步骤 1 : 启动集群,登陆管理服务器控制台。
步骤 2 : 查看集群中每个受管服务器的 JVM 参数,路径如 “Application Servers -> Managed1_Server1 -> ( Java 和进程管理)进程定义 -> Java 虚拟机 -> 定制属性 ” 。
步骤 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 : 应用能够启动,启动时无异常,
EOS Platform 支持标准 EAR 的部署方式,用户可以用非常灵活的方式来安装应用,除了通过运行安装程序来一站式的安装部署之外,还可以借助脚本工具的帮助来手工安装应用,本章主要介绍如何以手工方式安装应用。
手工安装业务应用支持的应用服务器环境包括单机和集群,以下描述了在单机和集群环境下手工安装应用的详细步骤。
应用服务器可以是未安装过 EOS Platform 应用的应用服务器,也可以是已经安装过 EOS Platform 应用的应用服务器,如果要支持集群,需要搭建应用服务器的集群环境(请参考 “ 集群安装 ” 章节)。
1. 安装 EOS Platform 开发版
2. 导出现有应用的 ear 文件
通过 Studio ,将现有业务应用项目导出为 ear 文件,具体导出步骤用户可参考 studio 的联机帮助文档的 “ 产品介绍 / 使用参考 / 导出 /导出 EAR” 部分内容。
对于未安装过 EOS Platform 应用的应用服务器,应拷贝 JDBC 驱动 jar ,针对不同的应用服务器,其 jar 拷贝的目标位置也不同,分别如下:
注:如果使用 DB2 9.7 将 db2jcc-0.x.jar 替换为 db2jcc-4.8.86.jar
Tomcat :将 [ 安装光盘根目录 ]/syslib 下的 jar : ojdbc14-10.2.0.2.0.jar 、 mysql-connector-java- 5.1.40 .jar 、 db2jcc-0.x.jar 、mssqlserver-3.0.jar 、 kingbasejdbc4-7.1.2.0250.jar 、 dm7jdbcdriver-7.1.3.130.jar 、 gbase-connector-java-8s.jar 、 oscarJDBC-7.0.jar 拷贝至 [TOMCAT_HOME]/lib 下。
JBoss :将 [ 安装光盘根目录 ]/syslib 下的 jar : ojdbc14-10.2.0.2.0.jar 、 mysql-connector-java- 5.1.4.0 .jar 、 db2jcc-0.x.jar 、mssqlserver-3.0.jar 、 kingbasejdbc4-7.1.2.0250.jar 、 dm7jdbcdriver-7.1.3.130.jar 、 gbase-connector-java-8s.jar 、 oscarJDBC-7.0.jar 拷贝至 [JBOSS_HOME]/server/default/lib 下 ( 如果是 JBoss6.1.0 , 则 还需要拷贝 jdom-1.0.jar 、 bcprov-jdk15-1.41.0.jar)
Weblogic :将 [ 安装光盘根目录 ]/syslib 下的 jar : ojdbc14-10.2.0.2.0.jar 、 mysql-connector-java- 5.1.40 .jar 、 db2jcc-0.x.jar 、mssqlserver-3.0.jar 、 kingbasejdbc4-7.1.2.0250.jar 、 dm7jdbcdriver-7.1.3.130.jar 、 gbase-connector-java-8s.jar 、 oscarJDBC-7.0.jar 及 [安装光盘根目录 ]/syslib/weblogic/stax-api-1.0.1.jar 拷贝至 [DOMAIN _HOME]/lib 下。在集群环境下,需要将 jar 拷贝到每个被管服务器的 [DOMAIN _HOME]/lib 目录下。
WebSphere :将 [ 安装光盘根目录 ]/syslib 下的 jar : ojdbc14-10.2.0.2.0.jar 、 mysql-connector-java- 5.1.40 .ja r 、 db2jcc-0.x.jar 、mssqlserver-3.0.jar 、 kingbasejdbc4-7.1.2.0250.jar 、 dm7jdbcdriver-7.1.3.130.jar 、 gbase-connector-java-8s.jar 、 oscarJDBC-7.0.jar 拷贝至 [PROFILE_HOME]/AppServer/lib/ext 下。在集群环境下,需要将 jar 拷贝到每个被管服务器的 [PROFILE _HOME]/AppServer/lib/ext 目录下。
TongWeb :将 [ 安装光盘根目录 ]/syslib 下的 jar : ojdbc14-10.2.0.2.0.jar 、 mysql-connector-java- 5.1.40 .ja r 、 db2jcc-0.x.jar 、mssqlserver-3.0.jar 、 kingbasejdbc4-7.1.2.0250.jar 、 dm7jdbcdriver-7.1.3.130.jar 、 gbase-connector-java-8s.jar 、 oscarJDBC-7.0.jar 拷贝至 [TONGWEB_HOME]/ lib/ext 下。
PAS :将 [ 安装光盘根目录 ]/syslib 下的 jar : ojdbc14-10.2.0.2.0.jar 、 mysql-connector-java- 5.1.40 .ja r 、 db2jcc-0.x.jar 、mssqlserver-3.0.jar 、 kingbasejdbc4-7.1.2.0250.jar 、 dm7jdbcdriver-7.1.3.130.jar 、 gbase-connector-java-8s.jar 、 oscarJDBC-7.0.jar 拷贝至 [ PAS _HOME]/var / shared/lib 下。
对于已经安装过 EOS Platform 应用的应用服务器,则不用拷贝上述 jar 。
通过 studio 导出的标准 EAR 部署在应用服务器中,其 EAR 本身还需要依赖应用服务器中配置的一些资源,如数据源、 JMS 等,为方便用户快速创建这些资源,屏蔽不同应用服务器配置方式上的差异,安装包提供了用于部署应用绑定资源的工具,该工具可以通过两种方式获取:
1 、安装企业版之后,会在安装目录下创建工具,位于 [ 安装目录 ]/tools 目录下
2 、 [ 安装光盘根目录 ]/tools 目录下
该工具能快速帮助用户完成如下任务:
1 、配置 JNDI 数据源
如果 是 Tomcat 、 PAS 、 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 | 是否配置数据源,选择 true 则需填写相关数据源属性 |
IS_DEPLOY_JMSQUEUE | 是否配置 JMS ,为 true ,则为配置 JMS |
IS_SET_WAS_JVM | 是否配置 JVM 参数,仅当应用服务器类型为WebSphere 该值有效,为 true ,配置 JVM 参数 |
WEBLOGIC_CLUSTER_JMS_DS_NAME | 当 weblogic 集群环境下配置 JMS 时, JMS持久性存储使用的数据源名称 |
IS_CLUSTER | 是否集群, weblogic 和 WebSphere 时该值有效,为 true ,需按集群方式配置服务器,设置集群名称 |
CLUSTER_NAME | 配置 Weblogic 或 websphere 集群的名称 |
步骤 2 :执行 deployResources.cmd 或 deployResources.sh
工具会根据 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 目录复制到 [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
|- ...
|- ...
在该目录下需要手工创建应用子目录,目录名称和已经部署的应用名称一致,如 default ,在该应用配置子目录下创建 startup.conf 文件,配置应用的绑定 IP 和管理端口,格式如下:
AdminPort=6200
LocalIP=192.168.0.54
用户应保证 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%"
...
在 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 下为:
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 服务器
修改 [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-jdk15-1.41.0.jar 非 Windows : ${JBOSS_HOME} / server/default/lib/bcprov-jdk15-1.41.0.jar |
4 ) WebSphere
需要修改应用的类装入器顺序,具体步骤如下:
1 、登陆 profile 管理控制台,进入 “ 应用程序 -> 企业应用程序 ->default-> 类装入和更新检测 ” ,选择 “ 类已装入并且是先使用应用程序类装入器 ”
2 、进入 “ 应用程序 -> 企业应用程序 ->default-> 管理模块 -> default.war-> 类装入器 ” ,选择 “ 类已装入并且是先使用应用程序类装入器 ”
注意:
对于 Tomcat 、 JBoss ,如果选择的应用服务器已经通过安装包安装过了 EOS 应用,则上述配置的修改可以省略。
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=192.168.0.131
#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://192.168.x.x:1433;DatabaseName=xxx;SelectMethod=Cursor
DB_URL=jdbc:mysql://192.168.0.131: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=dnzj006-67352cfNode01Cell
AS_WAS_NODE_NAME=dnzj006-67352cfNode01
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=192.168.0.131
#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://192.168.x.x:1433;DatabaseName=xxx;SelectMethod=Cursor
DB_URL=jdbc:mysql://192.168.0.131: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=127.0.0.1
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=
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=192.168.0.131
#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://192.168.x.x:1433;DatabaseName=xxx;SelectMethod=Cursor
DB_URL=jdbc:mysql://192.168.0.131: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-4.0.5.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
#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 。
本节介绍卸载开发版的注意事项、卸载步骤和验证卸载是否完全的方法。
卸载开发版的注意事项如下:
请慎用卸载程序,一旦卸载将不能恢复。
卸载前需要关闭 Studio ,并停止 Server 。
卸载时,请关闭 google 或紫光拼音输入法,否则卸载后,点击 < 完成 > 按钮,界面可能无法正常关闭,只能手工杀掉卸载进程。
卸载开发版的步骤如下:
步骤 1 : 启动卸载程序。启动安装目录 /uninstall 目录下 uninstall.cmd ,或者从【开始菜单 / 所有程序】找到要卸载的 “ EOS Platform”项,在弹出菜单上点击 “ 卸载 EOS Platform” ,弹出卸载程序面板,单击 < 下一步 > 。
步骤 2 : 选择是否保留工作区内容,单击 < 下一步 > 。
步骤 3 : 执行卸载。
步骤 4 : 卸载完成。
卸载完成,无异常,无错误提示,若选择了保留默认工作区,卸载程序将默认工作空间加上时间戳保存在安装目录下,用户可另择目录备份默认工作空间,再删除安装目录。
企业版的卸载,由于企业版是和应用服务器装在一起的,所以产品没有提供卸载工具。如果想卸载企业版,可以通过下面三步:
1) 通过应用服务器的控制台停止并卸载应用
2) 通过数据库客户端工具删除相应的表或者数据库表空间
3) 删除企业版安装目录 (如果是手工部署安装,则删除外置配置目录)
附录
安装目录下的各个子目录及其说明如下表所示。
目录 | 说明 |
开发版、企业版公共目录 | |
apps_config | 应用配置目录 |
apps_config\governor | governor 应用配置目录 |
apps_config\default | 用户创建的默认应用配置目录 , 本例为 default ,应以用户实际创建的应用名为准 |
apps_config\workspace | Workspace 应用配置目录 |
tools | 脚本工具目录 说明: 开发版该目录下提供 apache-ant-1.6.5 工具。 企业版该目录下提供部署资源脚本工具,配置文件及相关 jar 文件。 |
ico | 图标目录 |
开发版目录 | |
apache-tomcat-7.0.54 | Tomcat7.0.54 相关文件目录 |
apache-tomcat-7.0.54\webapps | Server 部署目录 |
apache-tomcat-7.0.54\webapps\default | default 应用目录 |
apache-tomcat-7.0.54\webapps\workspace | workspace 应用目录 |
apache-tomcat-7.0.54\webapps\governor | Governor 应用目录 |
apache-tomcat-7.0.54\webapps\sso-server | SSO Server 应用目录 |
apache-tomcat-7.0.54\logs | tomcat 日志文件目录 |
ide | Studio 相关文件目录 |
ide\eclipse\dropins\PLATFORM_7.6.0.0\plugins | 插件目录 |
ide\eclipse\workspace | 缺省的工作区目录,存放各个项目 |
ide\eclipse\configuration\eos_studio_config | Studio 配置文件目录 |
uninstall | 卸载目录 |
企业版目录 | |
jdk | 应用服务器类型为 JBoss /TongWeb/PAS 时提供 |
本部分列举产品安装过程中的常见问题,以及问题出现的可能原因和解决方法,仅供参考。
解决策略:
修改 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-4.0.5.GA\server\default\deploy\sso-server.war\WEB-INF\lib
下的 log4j-1.2.14.jar 。
解决策略:新建 mysql 数据库时,将编码设置为 UTF-8 。
解决策略:安装 EOS 前需手动启动 Weblogic 。
可能原因:
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 将动态分配端口。
可能原因:
原因 1 :由于只能提供一个版本的 JDBC 驱动程序,而数据库不同版本之间存在 JDBC 的差异,因此导致出现数据库连接的问题。
原因 2 :由于防火墙导致无法连接。
解决方法:
方法 1 :安装时若不能连接数据库, tomcat 、 JBoss 环境下可以先取消初始化数据库选项,继续安装。在安装完成后通过启动 EOS Server ,登录 EOS GOVERNOR ,单击导航树中 “ 管理 / 数据库初始化 ” 节点,输入数据库相关信息(需要替换合适的 JDBC 驱动或者使用合适的 Driver Class )进行数据库的初始化。 WebLogic 、 WebSphere 环境下安装时必须能连接数据库,否则安装不能成功完成。
方法 2 :关闭防火墙。
可能原因:
数据库初始化脚本未做表是否存在的校验,此错误不影响初始化效果。
解决方法:
再对数据库进行一次初始化。启动 Server ,登录 Governor ,单击导航树中 “ 管理 / 数据库初始化 ” 节点,输入数据库相关信息后进行数据库的初始化。
可能原因:
除了常规的页面编码设置等,还可能是 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
可能原因:
SQL Server 的 jdbc 驱动区分 JDK 版本
解决方法:
从 安装包的 resources/as_comps/lib/jdbc 目录下拷贝 相应的 jar 包。
mssqlserver-3.0.jar : 用于 jdk1.6 以上环境;
mssqlserver-3.0-jdk15.jar : 用于 jdk1.5 环境。
可能原因:
安装产品时 Target Server Name 指定为 AdminServer
解决办法:
设置 Target Server Name 为被管 server 的名称。
如果一定要安装应用到 AdminServer 下,那么需要从 安装包的 resources/as_comps/lib/jdbc 目录下拷贝数据库对应 的 驱动 jar 包 到$domain/lib 下,并且删除 resource/as_comps/lib/jdbc 中相应的 jar 包 。
可能原因:
安装时没用以管理员权限进行安装
解决办法:
以管理员权限安装
可能原因 :
由于 Mac 版 JDK 1.8 获取本地 IP 的问题导致启动 Server 会非常慢。
解决办法 :
在 /etc/hosts 文件中添加主机名,示例如下:
127.0.0.1 localhost yourPCname.local
安装时,对应不同的应用服务器,会修改相关的应用服务器配置文件。下面罗列了安装时对应修改的应用服务器配置文件列表。
文件名称 | 文件说明 | 操作说明 | 存放位置 |
web.xml | Web 应用服务器描述文件 | 增加了compilerSourceVM 参数,值为 1.5 | \%JBOSS_HOME%\server/default/deploy/jbossweb-tomcat55.sar/conf/web.xml |
ear-deployer.xml | EAR 部署配置文件 | 修改了 Isolated=true 和CallByValue=true | \%JBOSS_HOME%\server/default/deploy/ear-deployer.xml |
DefaultDataSource-ds.xml | 数据源配置文件 | 配置应用数据源 | \%JBOSS_HOME%\server/default/deploy/ DefaultDataSource-ds.xml |
文件名称 | 文件说明 | 操作说明 | 存放位置 |
DefaultDataSource-3718-jdbc.xml | 数据源配置文件 | 配置数据源 | \%DOMAIN_HOME% \config\jdbc |
config.xml | 应用服务器配置信息 | 配置 Admin Server 配置发布 EOS 应用的服务器 EOS 相关的 jms 配置 配置 EOS 相关的数据源配置 | \%DOMAIN_HOME% \config\config.xml |
eossystemmodule-jms.xml | Jms 配置信息 | EOS 的 jms 配置 | \%DOMAIN_HOME% \config\jms |
由于 WebSphere 的配置是通过 jacl 脚本自动配置的,因此无法确定实际修改的配置文件,这里只能列出修改的配置项,这些配置项可以通过 WebSphere 的管理控制台看到。
配置项 | 配置说明 | 操作说明 |
EXTERNAL_CONFIG_DIR | JVM 参数 | 应用程序服务器 >server1> 进程定义 >Java 虚拟机 >定制属性,值为外置目录 |
JCEProvider | JVM 参数 | 应用程序服务器 >server1> 进程定义 >Java 虚拟机 >定制属性,值为 IBMJCE |
Xgcpolicy | JVM 参数 | 应用程序服务器 >server1> 进程定义 >Java 虚拟机 >定制属性,值为 gencon |
com.ibm.websphere.orb.uniqueServerName | JVM 参数 | 应用程序服务器 >server1> 进程定义 >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.SAAJMetaFactoryImpl |
com.sun.xml.messaging.saaj.soap.SAAJMetaFactoryImpl | JVM 参数 | 应用程序服务器 >server1> 进程定义 >Java 虚拟机 >定制属性,值为 true |
com.ibm.ws.webcontainer.invokefilterscompatibility | 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> 激活规范 |
ORACLE JDBCProvider for EOS | JDBC 驱动配置 | 资源 >JDBC 提供程序 > ORACLE JDBCProvider for EOS |
DefaultDataSource | 数据源( EOS 默认数据源) | 资源 > 数据源 > DefaultDataSource |
_${cellName}.{serverName}-eos_jms_bus | 数据源( JMS 存储器数据源,使 JMS以文件形式存储数据) | 资源 > 数据源 >_${cellName}.{serverName}-eos_jms_bus |
选择应用服务器参数列表,
参数 | 说明 |
App Server/ 应用服务器 | 选择 EOS 所使用的应用服务器类型。 |
WebSphere 服务器参数 | |
Profile Home | WebSphere6.1 安装目录下的 profiles/AppSrv 子目录。 例如: /opt/WebSphereND61EOS/profiles/AppSrv01 ,该目录为一个Profile Home , AppSrv01 是用户创建的应用服务器的名称。 |
Cell Name | 管理服务器单元的名称。该参数会在选择正确的 “Profile Home” 之后自动填写,用户无需手动更改。 |
Node Name | WebSphere 节点名称。该参数会在选择正确的 “Profile Home” 之后自动填写,用户无需手动更改。 |
Server name | WebSphere Server 名称。该参数会在选择正确的 “Profile Home” 之后自动填写,用户无需手动更改。 |
User name | 创建具有管理安全性的 Profile 时设置的用户名。 |
PassWord | 创建具有管理安全性的 Profile 时设置的用户密码。 |
Clustered/ 集群 | 是否集群应用。 |
WebLogic 服务器参数 | |
Bea Home | Bea 产品主目录。 |
Weblogic Home | WebLogic 目录。用户选择 “BEA HOME” 后,系统会自动填写“Weblogic HOME” ,用户无需手动更改。 |
Domain Home | 用户创建的 domain 目录。 |
Login name | 创建具有管理安全性的 domain 时设置的用户名。 |
PassWord | 创建具有管理安全性的 domain 时设置的用户密码。 |
Server name | WebLogic Server 名称,默认为 AdminServer 。 |
WebServer PORT | 服务端口,默认为 7001 |
Clustered/ 集群 | 是否集群应用。 |
JBoss 服务器参数 | |
JBoss HOME | JBoss 的安装目录。 |
Tomcat 服务器参数 | |
Tomcat HOME | Tomcat 的安装目录。 |
TongWeb 服务器参数 | |
TongWeb HOME | TongWeb 的安装目录。 |
PAS 服务器参数 | |
PAS HOME | PAS 的安装目录。 |
创建用户表空间: EOSWFCTX
CREATE TABLESPACE "EOSWFCTX"
PAGESIZE 32K
MANAGED BY DATABASE
USING
(File '/opt/IBM/db2data/eos32k.dbf' 65536,
File '/opt/IBM/db2data/eos32kp.dbf' 65536
)
EXTENTSIZE 32
PREFETCHSIZE 32
BUFFERPOOL "BP32K"
OVERHEAD 12.67
TRANSFERRATE 0.18
DROPPED TABLE RECOVERY ON;
创建临时表空间: TEMP32K
CREATE TEMPORARY TABLESPACE "TEMP32K"
PAGESIZE 32K
MANAGED BY DATABASE
USING
(File '/opt/IBM/db2data/temp32k.dbf' 16384
)
EXTENTSIZE 32
PREFETCHSIZE 32
BUFFERPOOL "BP32K"
OVERHEAD 12.67
TRANSFERRATE 0.18
DROPPED TABLE RECOVERY OF
M ysql5.6 较之前的版本,修改点比较多,更新跨度比较大,在安装 Platform7 .6 之前,需要对 M ysql 的配置文件进行配置,否则初始化数据库时会报错: Specified key was too long; max key length is 767 bytes 。
具体配置方法:找到 Mysql 5.6 的配置文件, Windows 环境下默认配置文件是 my .ini , Linux 环境下默认配置文件是 my. cnf ,在 配置文件的末尾,添加如下配置:
sql_mode=NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES
default-storage-engine=INNODB
character-set-server=utf8
innodb_large_prefix = on
innodb_file_format = Barracuda
innodb_file_format_check = ON
innodb_file_format_max = Barracuda
innodb_file_per_table = ON
transaction-isolation = READ-COMMITTED
保存 , 重启 mysql 服务
使用命令行 : show variables like '%innodb%'; 查看 上述 配置是否生效。
在 {tomcat}/conf/context.xml 中添加如下参数:
<Resources cachingAllowed="true" cacheMaxSize="100000" />
否则启动服务会报 Unable to add the resource