應用程式伺服器安裝的升級步驟(WLP) upgrade-steps-for-application-server-installations-wlp

NOTE
本頁面概述WLP (WebSphere® Liberty)上AEM 6.5 LTS的升級程式。

升級前步驟 pre-upgrade-steps

在執行升級之前,必須完成數個步驟。 如需詳細資訊,請參閱升級程式碼和自訂升級前維護工作。 此外,請確定您的系統符合AEM 6.5 LTS🔗的需求。

檢查規劃升級,以及AEM Analyzer如何協助您評估升級AEM的複雜性。

移轉先決條件 migration-prerequisites

  • 最低必要的Java版本:請確定您已在WLP伺服器上安裝IBM® Sumeru JRE 17/21。

執行升級 performing-the-upgrade

  1. 在執行任何升級活動之前,請確定您已完成預先升級步驟,例如備份AEM 6.5伺服器

  2. 根據您的需求,選擇下列其中一個升級路徑:

    1. 就地升級:如果目前的WLP伺服器支援Servlet 6,您可以執行就地升級並繼續步驟3。
    2. Sidegrade:如果您偏好全新的設定,或您的WLP伺服器不支援Servlet 6,請設定含AEM 6.5 LTS的新WLP執行個體,並按照AEM 6.5 Content Migration Using Oak-upgrade指南中的指示,將內容移轉至AEM 6.5 LTS,然後跳至Deploy Upgraded Codebase區段
  3. 停止AEM執行個體。 通常可使用此命令來完成:

    code language-shell
    <path-to-wlp-directory>/bin/server stop server_name
    
  4. 移除不再需要的檔案和資料夾。 您需要明確移除的專案包括:

    • 來自dropins資料夾的​ cq-quickstart-65.war ​和expanded資料夾通常分別位於<path-to-aem-server>/dropins/cq-quickstart-65.war<path-to-aem-server>/apps/expanded/cq-quickstart-65.war

    • launchpad/startup資料夾。 假設您位於伺服器資料夾中,您可以在終端機中執行以下命令來刪除它:

      code language-shell
      rm -rf crx-quickstart/launchpad/startup
      
    • base.jar檔案。 您可以執行下列命令來達成此目的:

      code language-shell
      find crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \;
      
    • BootstrapCommandFile_timestamp.txt檔案:

      code language-shell
      rm -f crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt
      
    • 執行,移除sling.options檔案:

      code language-shell
      find crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf {} \;
      
    • 移除sling.bootstrap.txt檔案:

      code language-shell
      rm -rf crx-quickstart/launchpad/sling_bootstrap.txt
      
  5. 備份sling.properties檔案(通常出現在crx-quickstart/conf/中)並刪除它

  6. server.xml檔案中的servlet版本變更為​ 6.0

  7. 安裝Java 17/Java 21,並透過執行以下指令來確保正確安裝:

    code language-shell
    java -version
    
  8. 請檢閱AEM伺服器的啟動引數,並確保根據您的需求更新引數。 如需詳細資訊,請參閱Java 17/Java 21考量事項

  9. 下載新的6.5 LTS WAR並將其複製到以下位置的資料夾: /<path-to-aem-server>/dropins/

  10. 啟動AEM執行個體:通常可使用此命令來完成:

    code language-shell
    <path-to-wlp-directory>/bin/server start server_name
    
  11. 如果您在sling.properties中有自訂變更,請遵循下列指示:

    1. 執行<path-to-wlp-directory>/bin/server stop server_name以停止AEM執行個體
    2. 將您的自訂sling.properties變更套用至新產生的sling.properties檔案(參考在步驟5建立的備份檔案)
    3. 啟動AEM執行個體。 通常可以透過執行: <path-to-wlp-directory>/bin/server start server_name來完成

部署升級的程式碼基底 deploy-upgraded-codebase

升級程式完成後,應部署更新的程式碼基底。 您可以在升級程式碼和自訂頁面中找到更新程式碼基底以在AEM目標版本中運作的步驟。

執行升級後檢查和疑難排解 perform-post-upgrade-checks-and-troubleshooting

請參閱升級後檢查及疑難排解

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2