請跟隨以下章節,了解執行「內容轉移工具」時的重要考量:
「內容轉移工具」的最低系統需求為 AEM 6.3 + 和 JAVA 8。如果您使用較舊版本的 AEM,您必須將內容存放庫升級至 AEM 6.5 才能使用「內容轉移工具」。
Java必須在AEM環境上設定,如此java
命令就可由啟動AEM的使用者執行。
內容傳輸工具可與下列類型的資料儲存區搭配使用:檔案資料儲存、S3資料儲存、共用S3資料儲存和Azure Blob儲存資料儲存。
如果您使用沙盒環境,請確定您的環境是最新的,並升級至最新的版本。 如果您使用生產環境,則會自動更新。
若要使用「內容傳輸工具」,您必須是來源例項的管理員使用者,且屬於您要傳輸內容至之Cloud服務例項中的本機AEM管理員群組。 無權限的使用者將無法擷取能使用「內容轉移工具」的存取 Token。
存取Token可在特定時段後或雲端服務環境升級後定期到期。 如果存取Token已過期,您將無法連線至Cloud Service實例,而您必須擷取新的存取Token。 與現有移轉集相關聯的狀態圖示將變更為紅色雲端,並會在您將滑鼠暫留在紅色雲端時顯示訊息。
內容傳輸工具所傳輸的使用者和群組僅是內容滿足權限所需的使用者和群組。 Extraction進程將整個/home
複製到遷移集中,而Ingestion進程複製遷移內容ACL中引用的所有用戶和組。 若要自動將現有使用者和群組對應至其IMS ID,請參閱使用使用者對應工具。
在提取階段中,「內容轉移工具」會在作用中的 AEM 來源例項上執行。
在完成內容傳輸程式的Extraction階段後,以及開始Ingestion Phase將內容以雲端服務Stage或Production執行個體形式收錄至AEM之前,您將需要記錄支援票證以通知Adobe執行Ingestion,讓Adobe可以確保在Ingestion程式期間不會發生中斷。 您需要在計畫的Ingestion日期前1週記錄支援票證。 一旦您提交了支援票證,支援團隊將提供後續步驟的指導。
製作的擷取階段將縮小整個製作部署。這表示在整段擷取程序中,將無法使用製作 AEM。此外,請確保在運行Ingestion階段時不執行Cloud Manager管道。
內容傳輸工具可從軟體散發入口網站下載為zip檔案。 您可以透過「封裝管理程式」,在來源 Adobe Experience Manager AEM) 例項上安裝封裝。請確定下載最新版本。 有關最新版本的詳細資訊,請參閱發行說明。
從軟體發佈入口網站下載內容轉移工具。
請依照以下章節了解如何使用「內容轉移工具」,將內容移轉至 AEM as a Cloud Service (製作/發佈):
選擇 Adobe Experience Manager 並導覽至工具 -> 操作 -> 內容轉移。
當您建立第一個移轉集時,會顯示下列主控台。 按一下建立移轉集以建立新的移轉集。
如果您有現有的移轉集,主控台將顯示現有移轉集的清單,其目前狀態為。
請依照下方敘述,填入內容移轉集詳細資訊畫面中的欄位。
名稱:輸入移轉集名稱。
移轉集名稱不允許使用特殊字元。
Cloud Service 設定:輸入目標 AEM as a Cloud Service 製作 URL。
在內容轉移活動期間,您一次最多可以建立並維護四個移轉集。
此外,您還須針對每個特定環境 (預備、開發或生產) 分別建立移轉。
存取 Token:輸入存取 Token。
您可以使用開啟存取Token按鈕來擷取存取Token。 您必須確定您屬於目標Cloud服務例項中的AEM管理員群組。
參數:選取以下參數以建立移轉集:
包含版本:視需要選取。
欲包含的路徑:使用路徑瀏覽器來選取需要移轉的路徑。路徑選擇器可通過輸入或選擇接受輸入。
建立移轉集時會限制下列路徑:
/apps
/libs
/home
/etc
在填入內容移轉集詳細資訊畫面中的所有欄位後,請按一下儲存。
您的移轉集會顯示在綜覽頁面中。
「綜覽」頁面中將顯示此畫面中上的所有現有移轉集,以及它們的目前狀態與狀態資訊。您可能會看到以下說明的部分圖示。
從「綜覽」頁面選取移轉集,然後按一下屬性以檢視或編輯移轉集屬性。編輯屬性時,無法變更容器名稱或服務URL。
請依照下列步驟,從「內容轉移工具」中提取您的移轉集:
從「綜覽」頁面選取一個移轉集,然後按一下提取即可開始提取。將顯示遷移集抽取對話框,然後按一下抽取以啟動抽取階段。
您可以選擇在提取階段中覆寫預備容器。
EXTRACTION欄位現在顯示RUNNING狀態,以指示正在進行抽取。
提取一旦完成,移轉集的狀態會更新為已完成,而資訊欄位下會顯示一個實心綠色的雲朵圖示。
UI有自動重新載入功能,每30秒重新載入一次概述頁面。
提取階段開始時將建立寫入鎖定,並在 60 秒後釋放。因此,如果提取停止,則需等待一分鐘才能釋放鎖定並重新開始提取。
「內容轉移工具」具備支援追加差異內容的功能,可以只轉移在上一次內容轉移活動後所進行的變更。
初始轉移內容後,建議您先頻繁地執行追加差異內容,以縮短最終差異化內容轉移的內容凍結時間,然後再於雲端服務上線。
提取程序一旦完成,您即可使用追加提取方法來轉移差異內容。請遵循下列步驟:
導覽至綜覽頁面,並選取您要執行追加提取的移轉集。按一下提取即可開始追加提取。移轉集提取對話框隨即顯示。
您必須停用在提取期間覆寫預備容器選項。
請依照下列步驟,從「內容轉移工具」中擷取您的移轉集:
從綜覽頁面選取一個移轉集,然後按一下擷取即可開始擷取。移轉集擷取對話框隨即顯示。按一下Ingest以開始接收階段。 為了示範,已停用將內容擷取至製作例項。您可以同時將內容擷取至「製作」和「發佈」。
啟用在擷取選項前擦除雲端例項上的現有內容時,它會刪除整個現有儲存庫並建立新儲存庫,以將內容擷取至。 這表示它會重設目標Cloud服務例項的所有設定,包括權限。
擷取完成後,PUBLISH INGESTION欄位中的狀態會更新為FINISHED。
「內容轉移工具」具備支援追加差異內容的功能,可以只轉移在上一次內容轉移活動後所進行的變更。
初始轉移內容後,建議您先頻繁地執行追加差異內容,以縮短最終差異化內容轉移的內容凍結時間,然後再於雲端服務上線。
擷取程序一旦完成,您即可使用追加擷取方法來轉移差異內容。請遵循下列步驟:
導覽至綜覽頁面,並選取您要執行追加擷取的移轉集。按一下擷取即可開始追加提取。移轉集擷取對話框隨即顯示。
您應停用「擷取之前先擦除雲端例項上的現有內容」選項,以防止從先前的擷取活動中刪除現有內容。
您可以在綜覽頁面中檢視現有移轉集記錄。
請遵循下列步驟:
導覽至綜覽頁面,並選取您要刪除的移轉集,然後按一下動作列中的檢視記錄。
記錄對話框隨即顯示。按一下提取記錄,即可在新索引標籤中檢視記錄。
或者,
您也可以在綜覽畫面中檢視移轉集記錄。請選取移轉集,然後按一下提取欄位下的狀態。在這個情況下,按一下已完成即可在新索引標籤中檢視記錄。
若要追蹤記錄而不使用使用者介面,您可以透過 SSH 連線至來源 AEM 環境,並追蹤 crx-quickstart/cloud-migration/extraction-XXXXX/output.log file
。
您可以在綜覽頁面中刪除移轉集。
請遵循下列步驟:
導覽至綜覽頁面,並選取您要刪除的移轉集,然後按一下動作列中的刪除。
在刪除移轉集對話框中按一下刪除以確認刪除。
如有回報指出遺失 Blob ID (如下所述),則需要在現有存放庫中執行一致性檢查,並還原遺失的 Blob。
ERROR o.a.j.o.p.b.AbstractSharedCachingDataStore - Error retrieving record [ba45c53f8b687e7056c85dceebf8156a0e6abc7e]
以下命令將會執行
如果要回報引用 Blob 的節點路徑,則須使用 --verbose
旗標。
存放庫 AEM 6.5 (Oak 1.8 及以下的版本)
java -jar oak-run.jar datastorecheck --consistency --store [<SEGMENT_STORE_PATH>|<MONGO_URI>] --[s3ds|fds] <DATASTORE_CFG> --verbose <OUT_DIR> --dump
具有 Oak > 1.10 的存放庫
java -jar oak-run.jar datastore --check-consistency [<SEGMENT_STORE_PATH>|<MONGO_URI>] --[s3ds|fds|azureds] <DATASTORE_CFG> --out-dir <OUT_DIR> --work-dir <TEMP_DIR> --verbose
如需詳細資訊,請參考 Oak Runnable Jar。
接著,即可針對上述在 OUT_DIR 中建立、有一致性問題的檔案,檢查是否有路徑遺失二進位檔案,以及是否有採取適當操作如透過備份還原、刪除路徑、重新索引等等。
身為使用者,您可能會在「內容轉移工具」的使用者介面 (UI) 中看到下列行為變更: