內容轉移工具快速入門 getting-started-content-transfer-tool

Last update: Wed Aug 28 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

管理員

可用性 availability

內容轉移工具可以從 Software Distribution 入口網站下載其 zip 檔。您可以在來源Adobe Experience Manager (AEM)執行個體上透過封裝管理員安裝封裝。請務必下載最新版本。如需最新版本的詳細資訊，請參閱發行說明。

僅支援2.0.0版及更新版本，建議您使用最新版本。

NOTE

從軟體發佈入口網站下載內容轉移工具。

Source環境連線 source-environment-connectivity

NOTE

如果移轉集已從Cloud Acceleration Manager中刪除，也可能會發生連線錯誤。

來源AEM執行個體可能正在防火牆後面執行，而它只能連線至已新增至允許清單的特定主機。若要成功執行擷取，下列端點必須可從執行AEM的執行個體存取：

Azure Blob儲存服務： casstorageprod.blob.core.windows.net

NOTE

如果擷取因下列錯誤而失敗：「javax.net.ssl.SSLHandshakeException： sun.security.validator.ValidatorException： PKIX路徑建置失敗： sun.security.provider.certpath.SunCertPathBuilderException：找不到請求目標的有效憑證路徑」，則可透過匯入相關的CA憑證來解決此問題。

啟用SSL記錄 enable-ssl-logging

瞭解SSL/TLS連線問題有時很困難。若要在擷取程式期間疑難排解連線問題，您可以透過來源AEM環境的「系統主控台」啟用SSL記錄，步驟如下：

導覽至來源執行個體上的Adobe Experience Manager Web Console，方法是前往 工具>作業> Web Console，或直接導覽至 https://serveraddress:serverport/system/console/configMgr 的URL
搜尋 內容轉移工具擷取服務組態
使用鉛筆圖示按鈕來編輯其設定值
啟用 啟用SSL記錄以供擷取 設定，然後按儲存：

NOTE

此標幟僅用於偵錯SSL問題。在執行擷取之前，請確定旗標已停用，因為它可能需要大量的磁碟空間。這可能會填滿磁碟機容量，導致擷取程式失敗。

執行「內容轉移工具」 running-tool

下一節適用於新版的「內容轉移工具」。請詳閱本節，瞭解如何使用「內容轉移工具」將內容移轉至AEM as a Cloud Service：

提取設定階段 extraction-setup-phase

登入Cloud Acceleration Manager (CAM)，然後按一下您先前建立的CAM專案，以評估您移至AEM as a Cloud Service的準備程度。如果尚未建立CAM專案，請參閱在CAM中建立和管理專案。
按一下 內容轉移 卡片以開啟移轉集清單檢視。

按一下 建立移轉集 以建立移轉集。

note note
NOTE
在Cloud Acceleration Manager中，每個專案最多可以建立10個移轉集，包括過期的集。

下列對話方塊隨即顯示。請注意，移轉集將在長時間不活動後過期。在專案卡片和移轉工作表格列顯示一段時間的警告後，移轉集將會到期，其資料將不再可用。檢閱移轉集到期日以取得詳細資料。

note note
NOTE
名稱必須遵循與AEM節點相同的慣例，因此不能包含以下任一字元： . / ： [ ] \| *

您現在應該會在清單檢視中看到移轉清單。選取三點符號(…)以開啟下拉式清單，並選取 複製擷取金鑰。在提取階段您需要此金鑰。複製此擷取金鑰。

note note
NOTE
擷取金鑰可讓您的來源AEM環境安全地連線至移轉集。請謹慎處理此金鑰，就像輸入密碼一樣，切勿透過不安全的媒體（例如電子郵件）共用密碼。

填入移轉集 populating-the-migration-set

若要填入您在Cloud Acceleration Manager中建立的移轉集，請在來源Adobe Experience Manager (AEM)例項上安裝最新版的「內容轉移工具」。若要瞭解如何填入移轉集，請遵循本節。

在您的來源Adobe Experience Manager執行個體上安裝最新版的內容轉移工具後，請移至 作業 — 內容移轉
按一下 建立移轉集。

將先前從CAM複製的擷取金鑰貼到 建立移轉集 表單的擷取金鑰輸入欄位。執行此操作後，會自動填入移轉集名稱和Cloud Acceleration Manager (CAM)專案名稱欄位。這些名稱應與CAM中的「移轉集」名稱及您建立的CAM專案名稱相符。您現在可以新增內容路徑。新增內容路徑後，請儲存移轉集。您可以使用包含或排除的版本來執行擷取。

note note
NOTE
請確定擷取金鑰有效且不在到期日附近。貼上擷取金鑰後，您可以在建立移轉集對話方塊中取得此資訊。如果發生連線錯誤，請參閱Source環境連線以取得詳細資訊。

接著，選取下列引數以建立移轉集：

包含版本：視需要選取。包含版本時，會自動包含路徑/var/audit以移轉稽核事件。

note note
NOTE
如果您打算將版本納入移轉集，並使用`wipe=false`執行追加作業，則由於「內容轉移工具」目前的限制，您必須停用版本清除功能。如果您偏好啟用版本清除，並且正在移轉集中執行追加作業，則必須以`wipe=true`身分執行內嵌。

要包含的路徑：使用路徑瀏覽器來選取需要移轉的路徑。路徑選擇器透過輸入或選取來接受輸入。

note important
IMPORTANT
建立移轉集時會限制下列路徑：
`/apps` `/libs` `/home` `/etc` （在CTT中允許選取某些`/etc`路徑）

填入 建立移轉集 詳細資訊畫面中的所有欄位後，請按一下儲存。

正在決定移轉集大小 migration-set-size

建立移轉集後，強烈建議先對移轉集執行大小檢查，然後再開始提取程式。
透過對移轉集執行大小檢查，您可以：

判斷crx-quickstart子目錄是否有足夠的磁碟空間可以成功完成擷取。
判斷移轉集大小是否在支援的產品限制內，並避免失敗的內容擷取。

請依照下列步驟執行大小檢查：

選取移轉集並按一下 檢查大小。
這會開啟 檢查大小 對話方塊。
按一下 檢查大小 以啟動程式。然後，您將返回移轉集清單檢視，而且您應該會看到一則訊息，指出 檢查大小 正在執行。
檢查大小 程式完成後，狀態會變更為 已完成。選取相同的移轉集，然後按一下 檢查大小 以檢視結果。以下是 檢查大小 結果無警告的範例。
如果 檢查大小 結果指出磁碟空間不足，或移轉集超過產品限制，或兩者皆超過，則會顯示警告狀態。