使用Oak將AEM 6.5移轉至AEM 6.5 LTS內容 — 升級 aem-65-to-aem-65lts-content-migration-using-oak-upgrade
本檔案提供將Adobe Experience Manager從 6.5 版升級為 6.5 LTS 版的全方位指南，著重於使用Oak-upgrade工具的內容存放庫移轉，這是功能強大的公用程式，可精確控制在不同存放庫之間傳輸內容。
先決條件 prerequisites
開始移轉之前，請先確認是否符合下列要求：
- Java相容性：必須安裝並設定AEM 6.5 LTS，才能與Java™ 17一起執行。 設定後，請啟動AEM執行個體，確認所有套件組合皆有效且執行中沒有任何問題
- 系統資源：確保有足夠的磁碟空間和記憶體可在移轉過程中處理這兩個存放庫
- Oak-upgrade工具：從
oak-upgrade官方Maven存放庫下載 jar。 確保版本符合AEM 6.5 LTS中使用的Oak-core版本。 Oak-upgrade工具會在Oracle® Java™ 11或更新版本上執行
逐步移轉程式 step-by-step-migration-process
停止AEM 6.5和AEM 6.5 LTS stopping-aem65-and-aem65lts
在起始移轉之前，請停止AEM 6.5和AEM 6.5 LTS執行個體。 這可確儲存放庫處於穩定狀態，並且在移轉期間不會發生額外的寫入。
備份AEM 6.5執行個體 backing-up-the-aem65-instance
對您的AEM 6.5執行個體進行完整備份（如果尚未進行）。
使用Oak升級工具進行內容移轉 using-the-oak-upgrade-tool-for-content-migration
Oak-Upgrade工具會透過命令列執行，如下所示：
java -jar oak-upgrade-*.jar [options] /path/to/source/repository /path/to/destination/repository
以下是必要的命令和選項：
金鑰選項
-
--include-paths：指定要包含在移轉中的子樹狀結構。 如需命令使用方式的詳細資訊，請參閱此範例：code language-none java -jar oak-upgrade-*.jar --include-paths=/content/site /old/repository /new/repository -
--exclude-paths：從移轉中排除特定路徑。 使用此選項時請務必小心 — 如果路徑存在於目標系統上，則會將其移除。 如需命令使用方式的詳細資訊，請參閱此範例：code language-none java -jar oak-upgrade-*.jar --exclude-paths=/content/old_site /old/repository /new/repository -
--copy-binaries：根據預設，oak-upgrade只會移轉對二進位檔的參考，將實際檔案留在原始blob/資料存放區。 因此，新的存放庫仍然依賴二進位檔的來源存放區。 若要移轉二進位檔與存放庫內容，請使用--copy-binaries引數將所有二進位檔資料複製到新存放區，如下所示：code language-none java -jar oak-upgrade-*.jar \ --copy-binaries \ --src-datastore=/old/repository/datastore \ --datastore=/new/repository/datastore \ /old/repository \ /new/repository
移轉查核點 migratiing-checkpoints
將舊的SegmentMK存放庫(Oak 1.6以前版本)移轉至新的SegmentMK (Oak版本大於或等於1.6版本)時，查核點也會一併移轉。 如此一來，在新存放庫上首次執行Oak時，便可避免重新索引。 不過，下列情況下不會移轉查核點：
- 已指定自訂包含 — 、排除 — 或合併 — 路徑，或
- 二進位檔是由參考所複製，未指定來源資料存放區，且兩個不同的查核點在相同路徑下包含不同的二進位檔。
在第二個案例中，Oak-upgrade會傳送下列警告和中斷訊息：
Checkpoints won't be copied, because no external datastore has been specified. This will result in the full repository reindexing on the first start. Use --skip-checkpoints to force the migration or see https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration for more info.
解決此問題最簡單的方法是在命令列選項（例如--src-datastore或--src-s3datastore）中指定來源資料存放區。
也可以忽略警告，但在這種情況下，儲存庫將在第一次啟動時完全重新索引。 這可能是一個漫長的過程，尤其是對於大型執行個體而言。 在重新索引過程完成之前，存放庫將不可用。 使用--skip-checkpoints選項隱藏警告。
您也可以使用離線重新索引，在啟動AEM之前先離線重新索引存放庫，避免在第一次啟動時完全重新索引。
如需Oak-upgrade工具和進階使用方式的詳細資訊，請參閱正式檔案。