執行就地升級

上次更新： 2023-11-07
  • 主題：
  • Upgrading
    檢視有關此主題的更多資訊
  • 建立對象：
  • Developer
注意

本頁面概述AEM 6.5的升級程式。如果您有部署至應用程式伺服器的安裝，請參閱 應用程式伺服器安裝的升級步驟.

升級前步驟

在執行升級之前，必須完成數個步驟。 另請參閱 升級程式碼和自訂 和 升級前維護任務 以取得詳細資訊。 此外，請確認您的系統符合新版AEM的需求。 請參閱模式偵測器如何協助您評估升級的複雜性，另請參閱的升級範圍和需求一節 規劃升級 以取得詳細資訊。

移轉必要條件

  • 最低必要Java版本： 移轉工具僅適用於Java版本7及更高版本。 請注意，AEM 6.3及更高版本僅支援Oracle的JRE 8和IBM的JRE 7及8。

  • 升級的執行個體： 如果您要從版本升級 早於5.6，請依照升級說明檔案6.0版中說明的程式，確認您已執行就地升級至AEM 6.0。

準備AEM Quickstart jar檔案

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

  2. 下載新的AEM jar檔案，並使用它來取代 crx-quickstart 資料夾。

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

    java -Xmx4096m -jar aem-quickstart.jar -unpack

內容存放庫移轉

如果您從AEM 6.3升級，則不需要進行此移轉。對於6.3之前的版本，Adobe提供了一個工具，可用來將存放庫移轉至AEM 6.3中存在的新版Oak Segment Tar。這是快速入門套件的一部分，且是任何將使用TarMK的升級的必要專案。 升級使用MongoMK的環境不需要移轉存放庫。 如需新的區段Tar格式好處詳細資訊，請參閱 移轉至Oak區段Tar常見問題集.

實際移轉是使用標準AEM快速入門jar檔案執行，並以新檔案執行 -x crx2oak 可執行crx2oak工具以簡化升級並使其更強大的選項。

注意

如果您使用CRX2Oak Quickstart擴充功能執行TarMK存放庫內容移轉，您可以移除 samplecontent 將下列專案新增至移轉命令列，即可執行：

  • --promote-runmode nosamplecontent

若要決定應該執行的命令，請使用下列命令：

java -Xmx4096m -jar aem-quickstart.jar -v -x crx2oak -xargs -- --load-profile <<YOUR_PROFILE>> <<ADDITIONAL_FLAGS>>

位置 <<YOUR_PROFILE>> 和 <<ADDITIONAL_FLAGS>> 的設定檔和標幟會取代為下表所列的設定檔：

來源存放庫 目標存放庫 設定檔 其他旗標
crx2或TarMK，使用 FileDataStore tarmk segment-fds 請參閱下方的疑難排解一節
crx2 MongoMk mongo-from-crx2 -T mongo-uri=mongo://mongo-host:mongo-port -T mongo-db=mongo-database-name
TarMK或crx2，帶 S3DataStore tarmk segment-custom-ds 請參閱下方的疑難排解一節
沒有資料存放區的TarMK tarmk segment-no-ds
MongoMk MongoMk 不需要移轉

其中：

  • mongo-host 是MongoDB伺服器IP （例如127.0.0.1）

  • mongo-port 是MongoDB伺服器連線埠(例如：27017)

  • mongo-database-name 代表資料庫的名稱（例如：aem-author）

對於以下情況，您可能還需要其他開關：

  • 如果您是在未正確處理Java記憶體對應的Windows系統上執行升級，請新增 --disable-mmap 引數到命令。

如需使用crx2oak工具的其他指示，請參閱使用 CRX2Oak移轉工具. 如果需要，可以手動升級crx2oak helper JAR，方法是在解壓縮快速入門後，以較新的版本手動將其取代。 它在AEM安裝資料夾中的位置為： <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar. 您可以從Adobe存放庫下載最新版本的CRX2Oak移轉工具，網址為： https://repo1.maven.org/maven2/com/adobe/granite/crx2oak/

如果移轉成功完成，工具將會以零的退出代碼結束。 此外，檢查中的WARN和ERROR訊息 upgrade.log 檔案，位於 crx-quickstart/logs 在AEM安裝目錄中，因為這些可能會指出移轉期間發生的非嚴重錯誤。

檢查下方的設定檔 crx-quickstart/install 資料夾。 如果需要進行移轉，這些將會更新以反映目標存放庫。

資料存放區的注意事項：

當 FileDataStore 是AEM 6.3安裝的新預設值，不需要使用外部資料存放區。 雖然我們建議使用外部資料存放區作為生產部署的最佳實務，但這並非升級的先決條件。 由於升級AEM中已存在的複雜性，Adobe建議執行升級而不執行資料存放區移轉。 如有需要，資料存放區移轉可以在之後作為單獨的工作執行。

疑難排解移轉問題

如果您從6.3升級，請略過本節。雖然提供的crx2oak設定檔應符合大部分客戶的需求，但有時仍需要其他引數。 如果您在移轉期間發生錯誤，可能是環境的某些方面需要提供額外的設定選項。 若是如此，您可能會遇到下列錯誤：

將不會複製查核點，因為未指定外部資料存放區。 這將導致在第一次啟動時完整的存放庫重新索引。 使用 — skip-checkpoints強制移轉，或參閱https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration以取得詳細資訊。

由於某種原因，移轉程式需要存取資料存放區中的二進位檔案，但找不到該二進位檔案。 若要指定資料存放區組態，請在以下欄位中加入下列標幟： <<ADDITIONAL_FLAGS>> 移轉命令的一部分：

對於S3資料存放區：

--src-s3config=/path/to/SharedS3DataStore.config --src-s3datastore=/path/to/datastore

位置 /path/to/SharedS3DataStore.config 代表您的S3資料存放區設定檔案的路徑，而且 /path/to/datastore 代表S3資料存放區的路徑。

針對檔案資料存放區：

--src-datastore=/path/to/datastore

位置 /path/to/datastore 代表檔案資料存放區的路徑。

執行升級

若使用S3：

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

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

  3. 將套件解壓縮至暫存資料夾，並複製其內容 jcr_root/libs/system/install 至 crx-quickstart/install 資料夾。

正在判斷正確的升級開始命令

若要執行升級，重要的是使用jar檔案啟動AEM以啟動執行個體。 如需升級至6.5版，請參閱以下內容中的其他內容重組和移轉選項： 緩慢的內容移轉 可以使用upgrade指令進行選擇。

重要

如果您執行OracleJava 11 （或通常是8以上的Java版本），啟動AEM時必須在命令列新增其他引數。 如需詳細資訊，請參閱 Java 11考量事項.

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

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

    ps -ef | grep java

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

    /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 資料夾。 以我們先前的指令為例，我們的指令會是：

    /usr/bin/java -server -Xmx1024m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar cq-quickstart-6.5.0.jar -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties

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

部署升級的程式碼基底

就地升級程式完成後，應部署更新的程式碼基底。 若要將程式碼庫更新為可在AEM的目標版本中運作的步驟，請參閱 升級程式碼和自訂頁面.

執行升級後檢查和疑難排解

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

上一頁
Next page

此頁面上的