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

Last update: Wed Dec 13 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

可用性 availability

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

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

NOTE

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

來源環境連線能力 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主控台 或直接前往位於的URL https://serveraddress:serverport/system/console/configMgr
搜尋 內容轉移工具提取服務設定
使用鉛筆圖示按鈕來編輯其設定值
啟用 為擷取啟用SSL記錄 設定，然後按儲存：

NOTE

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

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

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

提取設定階段 extraction-setup-phase

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

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

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

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

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
請確定擷取金鑰有效且不在到期日附近。您可於以下網址取得此資訊：建立移轉集對話方塊。如果您收到連線錯誤，請參閱來源環境連線能力以取得詳細資訊。

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

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

note note
NOTE
如果您打算將版本納入移轉集，並使用執行增補 `wipe=false`，則由於「內容轉移工具」目前的限制，您必須停用版本清除功能。如果您偏好啟用版本整個清除，並且要在移轉集中執行增補，則必須依照以下方式執行內嵌 `wipe=true`.

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

note important
IMPORTANT
建立移轉集時會限制下列路徑：
`/apps` `/libs` `/home` `/etc` (部分 `/etc` 允許在CTT中選取路徑)

按一下儲存填入 建立移轉集 詳細資訊畫面。

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

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

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

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

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