FileNet P8 Application Engine, V 5.2.1              

准备升级 Application Engine

在升级 Application Engine 安装版本之前,必须为执行升级而准备现有配置。此准备工作包括备份现有文件以及取消部署 Web 应用程序。

关于此任务

  • 复查Plan and Prepare Your Environment for IBM FileNet P8指南中有关 Application Engine 的详细信息。
  • 复查保留 Application Engine V3.5 或 V4.0.1 配置所需执行的步骤。如果您由于任何原因而想要撤销此安装,那么将需要使用此信息。
  • 验证是否已记录所有必需设置。

    (最佳备份实践)如果要保留现有的 Application Engine 设置,那么必须在开始执行升级安装之前记录所有必需设置。

    • 在升级过程中,您将备份所有重要的 V3.5 或 V4.0.1 配置文件。
    • 在升级期间,会将多个现有的配置文件移至新创建的 AE_install_path/Config/AE 目录。High availability在高可用性环境中,如果您正在使用一个共享配置目录,那么需要将这些配置文件复制到此目录中。
    • 在升级过程中,安装程序将自动创建现有 Application Engine V3.5 或 V4.0.1 配置文件的备份(通过对文件名追加 .old 后缀)。
    • 在升级期间,现有的 V3.5 或 V4.0.1 Actions.xmlweb.xml 文件将与 V4.0.2 版本合并。
    • 另外,在合并期间,所有添加到 Actions.xml 文件的注释都将丢失。
  • 如果已安装 IBM® FileNet® P8 eForms 扩展产品,请将其卸载。

请参阅 IBM FileNet P8 eForms Installation and Upgrade Guide 中有关除去软件的主题。

High availability要点: 在高可用性集群式服务器环境中,您需要在集群中的所有节点上执行相应的步骤。
要准备升级 Application Engine,请执行下列操作:

过程

  1. 登录到 Application Engine 服务器:
    选项 描述
    AIX®、HPUX、Linux、Linux on System z® 和 Solaris 作为对您计划将 Application Engine 安装到的目录拥有读、写和执行访问权的用户身份登录。
    Windows 以本地管理员组的成员身份或者以拥有相应许可权的用户身份登录。
  2. (Windows) 使用 Windows 任务管理器来验证没有 javaw.exe 进程正在运行。如果上述步骤中的应用程序正确地停止,那么应该没有任何与 Application Engine 相关的 javaw.exe 进程正在运行。
    1. 使用 Windows 中的“服务”来停止 Process Application Engine Services Manager 服务。请选择开始 > 程序 > 管理工具 > 服务。如果 Process Application Engine Services Manager 的状态为“已启动”,请用鼠标右键单击该项,然后单击停止
    2. 如果停止 Process Application Engine Services Manager 之后仍有正在运行的 javaw.exe 进程,请使用 Windows 任务管理器来停止任何与 Application Engine 相关的 javaw.exe 进程。
  3. 备份、取消部署并除去 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
    1. 备份已部署的 Workplace 目录 (deploy_backup):WAS_HOME/profiles/default/installedApps/node_name/app_engine_war.ear/app_engine.war

      如果您已创建新概要文件或者将 WAR 文件重命名,那么路径可能会有所变化。

    2. WebSphere 管理控制台中停止 Workplace 应用程序。
    3. 企业应用程序中卸载 Workplace 应用程序。
    4. 保存更改并停止 WebSphere Application Server 实例。
    5. WAS_HOME/profiles/default/temp/node_name/instance/app_engine.war 中删除临时 Workplace 目录(缺省目录为 app_engine_war
    WebLogic Server
    1. WebLogic Server 管理控制台中,停止 Workplace Web 应用程序模块。
    2. 备份 Workplace 文件夹 (deploy_backup):AE_install_path/Workplace
    3. 删除 Workplace Web 应用程序模块。
    4. 停止 WebLogic Server 实例。
    JBoss Application Server
    1. 停止 JBoss Application Server 实例。
    2. 备份已部署的 Workplace 目录 (deploy_backup):JBoss_HOME/server/default/deploy/Workplace.war
    3. 删除已部署的 Workplace 目录:JBoss_HOME/server/default/deploy/Workplace.war
    4. 删除 JBoss 的临时 Workplace 目录:JBoss_HOME/server/default/work/jboss.web/localhost/Workplace
  4. 将修改后的文件复制到已安装的 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

  5. High availability如果您正在高可用性环境中升级,请执行下列附加备份步骤。
    • 备份位于共享网络位置的共享 bootstrap.properties 文件。
    • 如果您正在使用一个共享配置目录,那么将所有配置文件复制到此目录中。
    • (仅限于 Application Engine 3.5 升级)将在 bootstrap 文件的原始位置下创建一个共享配置目录。

      示例:如果 V3.5.x 共享引导程序位置为 Z:,那么新创建的共享配置目录将为 Z:\AE\



最近一次更新时间: 2016 年 3 月
p8pup068.htm

© Copyright IBM Corporation 2013, 2016.