FileNet P8 Workplace XT, 版本 1.1.5              

升級 Workplace XT 軟體

在升級 Workplace XT 軟體的過程中,您必須備份並解除部署現有的安裝。 然後,您可以執行安裝程式來升級軟體。

小心: 如果網站已安裝 IBM® Production Imaging Edition Viewer Pro:如果您想將 Workplace XT 1.1.4 版配置升級至包含 Viewer Pro 軟體的 1.1.5 版,在執行 Workplace XT 安裝程式之前,您必須先按照其《安裝手冊》的說明來解除安裝軟體。
重要: 在高可用性叢集伺服器中,在您叢集中的所有節點上執行步驟。
如果要升級 Workplace XT 軟體,請執行下列動作:
  1. 登入安裝 Workplace XT 的應用程式伺服器。
    選項 敘述
    UNIX 以具備 /bin 目錄寫入權,以及對您打算升級其中之 Workplace XT 的目錄具備讀取、寫入和執行權的使用者身分登入。
    Windows 以本端「管理者」群組成員或具備對等許可權的使用者身分登入。

    在本說明文件中,會用 install_path 變數來參照安裝目錄的路徑。這個變數的預設值,取決於產品安裝架構的版本和主機作業系統:

    1.1.3.x 版和更舊的版本
    UNIX:/opt/FileNet/WebClient
    Windows:C:\Program Files\FileNet\WebClient
    1.1.4.0 版和更新的版本
    UNIX:/opt/IBM/FileNet/WebClient
    Windows:C:\Program Files\IBM\FileNet\WebClient
    提示: 雖然 UNIX 的安裝使用者必須具備 /bin 目錄的寫入權,但是 Workplace XT 安裝程式不會寫入該目錄。
  2. 從「程序作業管理程式」,停止「元件管理程式」(如果正在執行的話),然後結束「程序作業管理程式」應用程式。
  3. (僅限 Windows)從「Windows 服務」主控台,停止「程序 WPXT 服務管理程式」服務。
  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 伺服器
    1. WebLogic 伺服器 管理主控台,停止 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 伺服器
    5. Workplace XT 暫存目錄(預設值:WorkplaceXTweb_client)從下列位置刪除:
      WL_HOME/domain/servers/instance/tmp/_WL_usr
    JBoss 應用程式伺服器
    1. 停止 JBoss 應用程式伺服器 伺服器。
    2. 備份已部署的 Workplace XT 應用程式:

      JBOSS_HOME/server/server_name/deploy/application_name.war.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) 網站喜好設定)在 web.xml 檔中移動 CMOD 金鑰儲存庫,並且變更 keyStorePath 環境定義參數。
    1. 複製 CMOD 金鑰儲存庫檔 cmodKeyStore。預設位置位於下列路徑:

      install_path/WorkplaceXT/WEB-INF

    2. cmodKeyStore 檔的副本放到位於下列路徑的 Config/WebClient 目錄中:

      install_home/FileNet/Config/WebClient

      install_home 變數的預設路徑,取決於您要升級的 Workplace XT 版本以及您的作業系統:

      1.1.3.x 版和更舊的版本
      UNIX:/opt
      Windows:C:\Program Files
      1.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 升級之前,請先更正日誌檔所記載的錯誤或失敗。通常會在字行開頭用 "ERROR" 一詞來記載問題。

    註: 如需 IBM Production Imaging Edition Viewer Pro 的相關資訊,請參閱 IBM 網站中的 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 的使用者記號。

    在升級之前,如果已在系統上啟用使用者記號,且您使用的是 4.5.1、5.0 或 5.1 版 Content Engine,必須重新複製 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 10.x 版移至 11g 版的升級:配置 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 Corp. 2013.
這個資訊中心採用 Eclipse 技術。(http://www.eclipse.org)