在升级 Application Engine 安装版本之前,必须为执行升级而准备现有配置。此准备工作包括备份现有文件以及取消部署 Web 应用程序。
请参阅 IBM FileNet P8 eForms Installation and Upgrade Guide 中的“Removing Software”主题。
要点: 在高可用性集群服务器环境中,您需要在集群中的所有节点上执行相应的步骤。
要准备升级
Application Engine,请完成下列步骤:
- 登录到 Application Engine 服务器:
选项 |
描述 |
UNIX |
作为对您计划将 Application Engine 安装到的目录拥有读、写和执行访问权的用户身份登录。 |
Windows |
以本地 Administrators 组的成员身份或者以拥有相应许可权的用户身份登录。 |
- (仅限于从 V3.5 进行的升级)验证流程路由器是否已停止。
提示: 虽然已在 Process Engine 升级过程中删除了 Application Engine 路由器,但在服务器上可能仍在运行处于断开连接状态的本地实例。
- 从 AE_install_path/Router 中启动流程任务管理器:
- UNIX
- ./routercmd.sh
- Windows
- routercmd.bat
- 如果路由器正在运行,请将其停止。
这是在 FileNet P8 Platform V3.5 安装过程中配置和启动的路由器。有关更多信息,请参阅
IBM FileNet P8 Platform 3.5 Installation and Upgrade Guide
中的任务“Start the Process Router”。
- 退出流程任务管理器。
- (Windows) 通过使用 Windows 任务管理器,验证是否没有 javaw.exe
进程正在运行。如果上述步骤中的应用程序正确地停止,那么应该没有任何与 Application Engine 相关的 javaw.exe 进程正在运行。
- 使用 Windows 中的“服务”来停止 Process Application Engine Services Manager Service。请选择。如果
Process Application Engine Services Manager 的状态为“已启动”,请用鼠标右键单击该项,然后单击停止。
- 如果停止 Process Application Engine Services Manager 之后仍有运行中的
javaw.exe 进程,请使用 Windows 任务管理器来停止任何与 Application Engine
相关的 javaw.exe 进程。
- 备份、取消部署并除去 J2EE 应用程序服务器中的 Workplace Web 应用程序。
在此步骤中,您将备份已部署的 Web 应用程序,此备份包含 WEB-INF 目录中存储的所有定制文件和所有配置文件。
尽管安装程序将自动创建现有的 Application Engine V3.5 或 V4.0.1
配置文件的备份,但您最好备份下列目录以便创建已部署的系统的完整备份。在以后的步骤中,您可能需要这些文件以保留
V3.5 或 V4.0.1 设置。例如,在升级和配置 Application Engine 期间将修改后的文件复制到已安装的
Workplace 目录时,您可能需要这些文件。
选项 |
描述 |
WebSphere® Application Server |
- 备份已部署的 Workplace 目录(部署备份):WAS_HOME/profiles/default/installedApps/节点名/app_engine_war.ear/app_engine.war
如果您已创建新概要文件或者将 WAR 文件重命名,那么路径可能会有所变化。
- 从 WebSphere 管理控制台中停止 Workplace 应用程序。
- 从企业应用程序中卸载 Workplace 应用程序。
- 保存更改并停止 WebSphere Application Server。
- 从 WAS_HOME/profiles/default/temp/节点名/实例/app_engine.war 中删除临时
Workplace 目录(缺省目录为 app_engine_war)
|
WebLogic Server |
- 从 WebLogic Server 管理控制台中,停止 Workplace Web 应用程序模块。
- 备份 Workplace 文件夹(部署备份):AE_install_path/Workplace
- 删除 Workplace Web 应用程序模块。
- 停止 WebLogic Server。
|
JBoss Application Server |
- 停止 JBoss Application Server。
- 备份已部署的 Workplace 目录(部署备份):JBoss_HOME/server/default/deploy/Workplace.war
- 删除已部署的 Workplace 目录:JBoss_HOME/server/default/deploy/Workplace.war
- 删除 JBoss 的临时 Workplace 目录:JBoss_HOME/server/default/work/jboss.web/localhost/Workplace
|
- 将修改后的文件复制到已安装的 Workplace 目录。 在升级期间,将把配置文件从以下目录:
AE_install_path/Workplace/WEB-INF
移动到:
AE_install_path/Config/AE
如果您已直接在 V3.5 或 V4.0.1 环境中部署的
Workplace 目录(对于
WebSphere Application Server 而言是
app_engine.war,对于 JBoss 而言是
Workplace.war)中对下列任何文件进行修改,那么在运行安装程序之前,必须将修改后的文件版本从
deploy_backup 目录复制到所安装的
AE_install_path/Workplace/WEB-INF 目录。
- actions.xml
- bootstrap.properties
- ClassFilter.xml
- ConfigurableLabels.xml
- containericons.properties
- content_redir.properties
- customobjecticons.properties
- download_redir.properties
- fnsoap.xml
- icons.properties
- InfoPages.xml
- PagingConfiguration.xml
- PolicyProcessors.xml
- PrimaryViews.xml
- PropertiesPages.xml
- SimpleSearch.xml
- SystemsPropertiesView.xml
在升级过程中,安装程序将自动创建现有
Application Engine V3.5 或 V4.0.1 配置文件的备份(通过对文件名追加 .old 后缀)。
- actions.xml.old
- ClassFilter.xml.old
- ConfigurableLabels.xml.old
- containericons.properties.old
- content_redir.properties.old
- icons.properties.old
- SystemsPropertiesView.xml.old
- UpdateActions.xml.old
- UpdateClassFilter.xml.old
- UpdateConfigurableLabels.xml.old
- UpdateProps.xml.old
- UpdateSystemPropertiesView.xml.old
- UpdateWeb.xml.old
- web.xml.old
所备份的文件位于以下位置:AE_install_path/backup-4_0_2
如果您正在高可用性环境中升级,请执行下列附加备份步骤。