FileNet P8 Workplace XT, 版本 1.1.5              

Workplace XT 软件进行升级

作为 Workplace XT 软件升级过程的一部分,您必须备份并取消部署现有安装版本。然后,您就可以运行安装程序对此软件进行升级。

注意: 对于安装了 IBM® Production Imaging Edition Viewer Pro 的站点:如果您想要将 Workplace XT V1.1.4 配置升级到 V1.1.5(也要升级 Viewer Pro 软件),那么在运行 Workplace XT 安装程序之前,必须按照此软件的安装指南中说明那样卸载该软件。
要点: 在高可用性集群服务器环境中,在集群中的所有节点上执行相应的步骤。
要对 Workplace XT 软件进行升级,请完成下列步骤:
  1. 登录到 Workplace XT 所安装在的应用程序服务器。
    选项 描述
    UNIX 作为对 /bin 目录拥有写访问权并且对您打算在其中对 Workplace XT 进行升级的目录拥有读、写和执行访问权的用户进行登录。
    Windows 以本地 Administrators 组的成员身份或者以拥有等价许可权的用户身份登录。

    在本文档中,使用 install_path 变量来表示安装目录的路径。此变量的缺省值取决于产品安装的版本和主机操作系统。

    V1.1.3.x 和更低发行版
    UNIX:/opt/FileNet/WebClient
    Windows:C:\Program Files\FileNet\WebClient
    V1.1.4.0 和更高发行版
    UNIX:/opt/IBM/FileNet/WebClient
    Windows:C:\Program Files\IBM\FileNet\WebClient
    提示: 虽然 UNIX 安装用户必须对 /bin 目录拥有写访问权,但是 Workplace XT 安装程序并不会写入该目录。
  2. 如果 Component Manager 正在运行,那么从流程任务管理器中将它停止,然后退出“流程任务管理器”应用程序。
  3. (仅适用于 Windows)从 Windows 服务控制台中,停止 Process WPXT Services Manager 服务。
  4. (仅适用于 Windows)使用 Windows 任务管理器验证是否没有 javaw.exe 进程在运行。

    如果上述步骤中的应用程序正确停止,那么没有与 Workplace XT 相关的 javaw.exe 进程正在运行。如果需要,请使用 Windows 任务管理器或者其他某种进程管理工具来停止 install_path\_WCjvm\bin 目录路径中的所有 javaw.exe 进程。

  5. 备份、取消部署并除去 J2EE 应用程序服务器中的 Workplace XT (web_client) Web 应用程序。
    选项 描述
    WebSphere® Application Server
    1. 备份已部署的 Workplace XT 目录:

      WAS_HOME/profiles/default/installedApps/node_name/WorkplaceXT.ear/application_name.war

    2. WebSphere 管理控制台中停止 Workplace XT 应用程序。
    3. 企业应用程序中卸载 Workplace XT 应用程序。
    4. 保存更改并停止 WebSphere 服务器。
    5. 从以下目录中删除临时 Workplace XT 目录(缺省值:WorkplaceXT):

      WAS_HOME/profiles/default/temp/node_name/instance/

    6. 删除以下位置的 wstemp 目录中的所有文件夹:

      WAS_HOME/profiles/profile_name/wstemp

    WebLogic Server
    1. WebLogic Server 管理控制台中,停止 Workplace XT Web 应用程序模块。
    2. 备份 Workplace XT 文件夹或者已部署的 Workplace XT 目录:
      • install_path/WorkplaceXT
      • install_path/deploy/application_name.war
      • install_path/deploy/web-client.ear

    3. 删除 Workplace XT Web 应用程序模块。
    4. 停止 WebLogic Server
    5. 从以下目录中删除临时 Workplace XT 目录(缺省值:WorkplaceXTweb_client):
      WL_HOME/domain/servers/instance/
      tmp/_WL_usr
    JBoss Application Server
    1. 停止 JBoss Application Server 服务器。
    2. 备份已部署的 Workplace XT 应用程序:

      JBOSS_HOME/server/server_name/deploy/application_name.war or .ear

    3. 从已部署位置删除 Workplace XT 应用程序。
    4. 清除下列临时目录中的所有文件和文件夹:

      JBoss_home/server/server_name/tmp/deploy

      JBoss_home/server/server_name/work/jboss.web/localhost

  6. (对于配置了 IBM Content Manager OnDemand (CMOD) 站点首选项的系统)移动 CMOD 密钥库并更改 web.xml 文件中的 keyStorePath 上下文参数。
    1. 复制 CMOD 密钥库文件 cmodKeyStore。缺省位置位于以下路径中:

      install_path/WorkplaceXT/WEB-INF

    2. cmodKeyStore 文件的副本放入以下路径中的 Config/WebClient 目录:

      install_home/FileNet/Config/WebClient

      变量 install_home 的缺省路径取决于您升级的 Workplace XT 版本以及您使用的操作系统:

      V1.1.3.x 和更低发行版
      UNIX:/opt
      Windows:C:\Program Files
      V1.1.4.0 和更高发行版
      UNIX:/opt/IBM
      Windows:C:\Program Files\IBM
    3. 更改 web.xml 文件中 keyStorePath 参数的值,使它与密钥库文件的新位置相匹配:
      <context-param>
      <param-name>keyStorePath</param-name>
      <param-value>install_home/FileNet/Config/WebClient/cmodKeyStore
      </param-value>
      </context-param>
  7. 可选: 复制现有的配置文件。

    如果您已经对位于已部署位置的配置文件进行了定制更改,那么在对现有 Workplace XT 安装版本进行升级之前,请执行下列操作。

    将下列文件:
    • WcmApiConfig.properties
    • web.xml

    从您在上一个步骤中所创建的备份 Workplace XT 目录下的 /WEB-INF 文件夹复制到以下目录:

    install_path/WorkplaceXT/WEB-INF/

  8. 仅适用于从 JBoss 4.x.x 升级到 JBoss 5.x.x:如果在已经从 JBoss 4.x.x 升级到 JBoss 5.x.x 的系统上升级了 Workplace XT,那么在使用 JBoss 5.x.x 部署 Workplace XT 之前,必须编辑 web.xml 文件并将一个文件复制到 install_path/WorkplaceXT/WEB-INF/
    1. web.xml 文件的相应侦听器部分的末尾输入下列行:
      <listener>
         <listener-class>com.sun.faces.config.ConfigureListener</listener-class> 
      </listener>
    2. 复制 FileNet/WebClient/jboss5 路径中的 jboss-classloading.xml 文件,并将副本放入 install_path/WorkplaceXT/WEB-INF/ 目录中。
  9. 可选: 安装 IBM Production Imaging Edition Viewer Pro 许可证文件。如果您已经购买了 IBM Production Imaging Edition,那么可以在安装 Workplace XT 时安装 Viewer Pro 软件。
    1. 要激活 Viewer Pro 安装,在升级 Workplace XT 之前必须运行许可证安装程序。根据您是要以交互方式还是静默方式进行升级,采用下列其中一种方法来启动 IBM Production Imaging Edition Viewer Pro 许可证安装:
    选项 描述
    要以交互方式安装 IBM Production Imaging Edition Viewer Pro 许可证,请完成下列步骤:
    1. 访问 IBM Production Imaging Edition Viewer Pro 许可证安装软件包。
    2. 启动相应的安装程序(PIEProLic-1.1.5.0-operating_system.bin.exe),并遵循向导屏幕中的提示。
    要以静默方式安装 IBM Production Imaging Edition Viewer Pro 许可证,请完成下列步骤:
    1. 访问 IBM Production Imaging Edition Viewer Pro 许可证安装软件包,并将 PIEsilent_input.txt 文件复制到一个本地目录中。
    2. 参考工作表中的值,访问 IBM Production Imaging Edition Viewer Pro 软件包并编辑静默输入文件,以反映对于安装的适当响应。

      即使您接受 PIEsilent_input.txt 文件中的所有缺省值,也必须编辑此文件以接受许可协议 (-V licenseAccepted="true")。

    3. 从命令提示符浏览到安装程序,并运行该安装程序:
      UNIX
      ./PIEProLic-1.1.5.0-operating_system.bin -options "path_to_edited_input_file/XT_silent_upgrade.txt" -silent
      Windows
      PIEProLic-1.1.5.0-Win.exe -options "path_to_edited_input_file\XT_silent_upgrade.txt" -silent

    查看位于 install_path/IBM/FileNet/PIEProLicense 中的 PIEPro_install_log.txt 文件。在继续升级 Workplace XT 之前,请更正日志文件中所记录的错误或故障。通常,记录问题时,会在相应行的开头添加词汇“错误”。

    注: 有关 IBM Production Imaging Edition Viewer Pro 的更多信息,请参阅 IBM Web 站点上的 Production Imaging Edition
  10. 根据您是要以交互方式还是静默方式进行升级,采用下列其中一种方法来启动升级过程:
    选项 描述
    要以交互方式对 Workplace XT 进行升级,请完成下列步骤:
    1. 访问 Workplace XT 安装软件包。
    2. 启动相应的安装程序(WorkplaceXT-1.1.5.0-operating_system.bin.exe),并遵循向导屏幕中的提示。安装程序将检测并复制先前 Workplace XT 安装版本中的设置。
    要以静默方式对 Workplace XT 进行升级,请完成下列步骤:
    1. 访问 Workplace XT 安装软件包,并将 XT_silent_upgrade.txt 文件复制到一个本地目录中。
    2. 遵循静默输入文件中的指示信息来编辑值,以反映适合于您的安装的响应。

      即使您接受 XT_silent_upgrade.txt 文件中的所有缺省值,也必须编辑此文件以接受许可协议 (-V licenseAccepted="true")。

    3. 从命令提示符浏览到安装程序,并运行该安装程序:
      UNIX
      ./WorkplaceXT-1.1.5.0-operating_system.bin -options "path_to_edited_input_file/XT_silent_upgrade.txt" -silent
      Windows
      WorkplaceXT-1.1.5.0-Win.exe -options "path_to_edited_input_file\XT_silent_upgrade.txt" -silent
  11. 升级程序运行完毕之后,查看位于以下位置的 web_client_install_log_1.1.5.0.txt 文件:install_path/FileNet/WebClient

    请验证是否未记录任何错误或故障。请更正存在的任何错误之后,才继续执行操作。

  12. 可选: 更新文件以支持 Workplace XT 的用户令牌。

    如果在升级之前系统上已经启用了用户令牌,并且您正在使用 Content Engine V4.5.1、V5.0 或 V5.1,那么您必须再次复制 authentication-websphere.jarlog4j-1.2.13.jar 文件。请参阅下面有关配置用户令牌以及复制这些文件所在位置的相应章节:

    选项 描述
    WebSphere
    1. authentication-websphere.jar 文件从以下位置:

      install_path/FileNet/WebClient/WorkplaceXT/authenticationFiles

      复制到以下位置:

      WAS_home/AppServer/lib/ext

    2. log4j-1.2.13.jar 文件从以下位置:

      install_path/FileNet/WebClient/WorkplaceXT/WEB-INF/lib

      复制到以下位置:

      WAS_home/AppServer/lib/ext

    WebLogic
    1. authentication-weblogic.jar 文件从以下位置:

      install_path/FileNet/WebClient/WorkplaceXT/authenticationFiles

      复制到以下位置:

      WL_home/server/lib/mbeantypes

    2. log4j-1.2.13.jar 文件从以下位置:

      install_path/FileNet/WebClient/WorkplaceXT/WEB-INF/lib

      复制到以下位置:

      WL_home/server/lib/mbeantypes

    JBoss

    authentication-utils.jar 文件从以下位置:

    install_path/FileNet/WebClient/WorkplaceXT/authenticationFiles

    复制到以下位置:

    JBOSS_home/server/server_name/lib

  13. 仅适用于从 WebLogic V10.x 升级到 V11g:配置 WebLogic 会话 Cookie 设置。
    1. 切换到 install_path/FileNet/WebClient/WorkplaceXT/WEB-INF 目录。
    2. weblogic.xml 文件备份到 weblogic.xml.bak
    3. weblogic-11g.xml 文件从 WebLogic_install_path/WebClient/weblogicFiles 目录复制到 Workplace XT 安装路径中的 WEB-INF 目录。
    4. weblogic-11g.xml 文件重命名为 weblogic.xml 在使用 WebLogic 11g 部署 Workplace XT 之前,需要将 weblogic-11g.xml 文件复制到新位置并将它重命名。


反馈

最近一次更新时间: 2013 年 3 月
wxtut003.htm

© Copyright IBM Corporation 2013.
本信息中心基于 Eclipse 技术。(http://www.eclipse.org)