文件AEM 6.5 LTS使用手冊

執行就地升級 performing-an-in-place-upgrade

Last update: Wed Sep 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 適用對象：
  • Experience Manager 6.5 LTS
  • 主題：

建立對象：

  • 管理員
NOTE
本頁面概述AEM 6.5 LTS的就地升級程式。 如果安裝已部署到應用程式伺服器，請參閱應用程式伺服器安裝的升級步驟。

升級前步驟 pre-upgrade-steps

在執行升級之前，必須完成數個步驟。 如需詳細資訊，請參閱升級程式碼和自訂和升級前維護工作。 此外，請確定您的系統符合AEM 6.5 LTS 的需求，並檢視升級計畫考量事項以及分析器如何協助您估計複雜性。

移轉先決條件 migration-prerequisites

  • 最低必要的Java版本： ​請確定您的系統上已安裝Oracle的Java™ 17/21。

準備AEM Quickstart jar檔案 prep-quickstart-file

  1. 下載新的AEM 6.5 LTS jar檔案

  2. 判斷正確的升級啟動命令

  3. 如果執行個體正在執行，請停止執行個體

  4. 使用新的AEM 6.5 LTS jar取代crx-quickstart資料夾之外的舊的

  5. 備份sling.properties檔案（通常出現在crx-quickstart/conf/中），然後刪除它

  6. 透過執行以下動作將新的quickstart jar解壓縮：

    code language-shell 
    java -Xmx4096m -jar aem-quickstart.jar -unpack

  7. 如果需要套用自訂sling.properties，請建立新的本機AEM執行個體，並從其crx-quickstart/conf目錄中擷取sling.properties檔案。 套用必要的自訂變更至此檔案，然後將其複製到要升級之AEM執行個體的crx-quickstart/conf目錄。 如果沒有自訂屬性，可以跳過此步驟。

執行升級 performing-the-upgrade

如果使用S3：

  1. 移除crx-quickstart/install底下與舊版S3聯結器關聯的所有jar。

  2. 從https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/ 下載1.60.2 S3聯結器的最新版本

  3. 解壓縮S3聯結器（1.60.2版）並複製crx-quickstart/install下下列資料夾的內容，如下所示：

    1. 複製com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/1下的crx-quickstart/install/1
    2. 複製com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/15下的crx-quickstart/install/15

現在，使用決定正確的升級啟動命令區段下的資訊，使用新命令來啟動AEM執行個體。

正在判斷正確的升級開始命令 determining-the-correct-upgrade-start-command

NOTE
Java 17/21中已移除對部分Java 8/11引數的支援，請參閱Oracle Java™ 17檔案、Oracle Java™ 21檔案以及AEM 6.5 LTS的Java&trade引數考量事項。

若要執行升級，重要的是使用jar檔案啟動AEM以啟動執行個體。

請注意，從啟動指令碼啟動AEM將不會開始升級。 大部分客戶都是使用啟動指令碼啟動AEM，並已自訂此啟動指令碼，以納入環境設定（例如記憶體設定、安全性憑證等）的開關。 因此，Adobe建議依照此程式來決定正確的升級命令：

  1. 在執行中的AEM執行個體上，從命令列執行以下命令：

    code language-shell 
    ps -ef | grep java

  2. 尋找AEM程式。 它看起來會像這樣：

    code language-shell 
    /usr/bin/java -server -Xmx1024m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.5.0-standalone-quickstart.jar start -c crx-quickstart -i launchpad -p 4502 -Dsling.properties=conf/sling.properties

  3. 將現有jar的路徑（在此案例中為crx-quickstart/app/aem-quickstart*.jar）取代為crx-quickstart資料夾同層級的新AEM 6.5 LTS jar，以修改命令。 以我們先前的指令為例，我們的指令會是：

    code language-shell 
    /usr/bin/java -server -Xmx4096m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar <AEM-6.5-LTS.jar> -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties

    這將確保所有適當的記憶體設定、自訂執行模式和其他環境引數都套用於升級。 升級完成後，執行個體可在未來啟動時從啟動指令碼啟動。

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

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

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

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

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