應用程式伺服器安裝的升級步驟(WLP) upgrade-steps-for-application-server-installations-wlp
升級前步驟 pre-upgrade-steps
在執行升級之前,必須完成數個步驟。 如需詳細資訊,請參閱升級程式碼和自訂和升級前維護工作。 此外,請確定您的系統符合AEM 6.5 LTS🔗的需求。
檢查規劃升級,以及AEM Analyzer如何協助您評估升級AEM的複雜性。
移轉先決條件 migration-prerequisites
- 最低必要的Java版本:請確定您已在WLP伺服器上安裝IBM® Sumeru JRE 17/21。
執行升級 performing-the-upgrade
-
在執行任何升級活動之前,請確定您已完成預先升級步驟,例如備份AEM 6.5伺服器
-
根據您的需求,選擇下列其中一個升級路徑:
- 就地升級:如果目前的WLP伺服器支援Servlet 6,您可以執行就地升級並繼續步驟3。
- Sidegrade:如果您偏好全新的設定,或您的WLP伺服器不支援Servlet 6,請設定含AEM 6.5 LTS的新WLP執行個體,並按照AEM 6.5 Content Migration Using Oak-upgrade指南中的指示,將內容移轉至AEM 6.5 LTS,然後跳至Deploy Upgraded Codebase區段
-
停止AEM執行個體。 通常可使用此命令來完成:
code language-shell <path-to-wlp-directory>/bin/server stop server_name
-
移除不再需要的檔案和資料夾。 您需要明確移除的專案包括:
-
來自
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
-
-
備份
sling.properties
檔案(通常出現在crx-quickstart/conf/
中)並刪除它 -
將
server.xml
檔案中的servlet版本變更為 6.0 -
安裝Java 17/Java 21,並透過執行以下指令來確保正確安裝:
code language-shell java -version
-
請檢閱AEM伺服器的啟動引數,並確保根據您的需求更新引數。 如需詳細資訊,請參閱Java 17/Java 21考量事項。
-
下載新的6.5 LTS WAR並將其複製到以下位置的資料夾:
/<path-to-aem-server>/dropins/
-
啟動AEM執行個體:通常可使用此命令來完成:
code language-shell <path-to-wlp-directory>/bin/server start server_name
-
如果您在
sling.properties
中有自訂變更,請遵循下列指示:- 執行
<path-to-wlp-directory>/bin/server stop server_name
以停止AEM執行個體 - 將您的自訂
sling.properties
變更套用至新產生的sling.properties
檔案(參考在步驟5建立的備份檔案) - 啟動AEM執行個體。 通常可以透過執行:
<path-to-wlp-directory>/bin/server start server_name
來完成
- 執行
部署升級的程式碼基底 deploy-upgraded-codebase
升級程式完成後,應部署更新的程式碼基底。 您可以在升級程式碼和自訂頁面中找到更新程式碼基底以在AEM目標版本中運作的步驟。
執行升級後檢查和疑難排解 perform-post-upgrade-checks-and-troubleshooting
請參閱升級後檢查及疑難排解。