在升级 Application Engine 安装版本之前,必须为执行升级而准备现有配置。此准备工作包括备份现有文件以及取消部署 Web 应用程序。
关于此任务
请参阅 IBM FileNet P8 eForms Installation and Upgrade Guide 中有关除去软件的主题。
要点: 在高可用性集群式服务器环境中,您需要在集群中的所有节点上执行相应的步骤。
要准备升级
Application Engine,请执行下列操作:
过程
- 登录到 Application Engine 服务器:
选项 |
描述 |
AIX®、HPUX、Linux、Linux on System z® 和 Solaris |
作为对您计划将 Application Engine 安装到的目录拥有读、写和执行访问权的用户身份登录。 |
Windows |
以本地管理员组的成员身份或者以拥有相应许可权的用户身份登录。 |
- (Windows) 使用 Windows 任务管理器来验证没有 javaw.exe 进程正在运行。如果上述步骤中的应用程序正确地停止,那么应该没有任何与 Application Engine 相关的 javaw.exe 进程正在运行。
- 使用 Windows 中的“服务”来停止 Process Application Engine Services Manager 服务。请选择。如果
Process Application Engine Services Manager 的状态为“已启动”,请用鼠标右键单击该项,然后单击停止。
- 如果停止 Process Application Engine Services Manager 之后仍有正在运行的 javaw.exe 进程,请使用 Windows 任务管理器来停止任何与 Application Engine 相关的 javaw.exe 进程。
- 备份、取消部署并除去 Java™ EE 应用程序服务器中的 Workplace Web 应用程序。
在此步骤中,您将备份已部署的 Web 应用程序,此副本包含 WEB-INF 目录中存储的所有定制文件和所有配置文件。
尽管安装程序将自动创建现有的 Application Engine V3.5 或 V4.0.1
配置文件的备份,但您最好备份下列目录以便创建已部署的系统的完整备份。在以后的步骤中,您可能需要这些文件以保留
V3.5 或 V4.0.1 设置。例如,在升级和配置 Application Engine 期间将修改后的文件复制到已安装的
Workplace 目录时,您可能需要这些文件。
选项 |
描述 |
WebSphere® Application Server |
- 备份已部署的 Workplace 目录 (deploy_backup):WAS_HOME/profiles/default/installedApps/node_name/app_engine_war.ear/app_engine.war
如果您已创建新概要文件或者将 WAR 文件重命名,那么路径可能会有所变化。
- 从 WebSphere 管理控制台中停止 Workplace 应用程序。
- 从企业应用程序中卸载 Workplace 应用程序。
- 保存更改并停止 WebSphere Application Server 实例。
- 从 WAS_HOME/profiles/default/temp/node_name/instance/app_engine.war 中删除临时
Workplace 目录(缺省目录为 app_engine_war)
|
WebLogic Server |
- 从 WebLogic Server 管理控制台中,停止 Workplace Web 应用程序模块。
- 备份 Workplace 文件夹 (deploy_backup):AE_install_path/Workplace
- 删除 Workplace Web 应用程序模块。
- 停止 WebLogic Server 实例。
|
JBoss Application Server |
- 停止 JBoss Application Server 实例。
- 备份已部署的 Workplace 目录 (deploy_backup):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
如果您正在高可用性环境中升级,请执行下列附加备份步骤。