疑難排解AEM MSM問題
本文會說明疑難排解任何AEM MSM問題的方式。 此外,它討論下列內容:
- 尋找有關您的Blueprint和即時副本狀態的進階資訊
- 檢查存放庫中的MSM特定資訊
- 提出MSM支援票證時要提供的資訊
說明 description
環境
Experience Manager
問題/症狀
要開始的基本驗證:
- 請檢視MSM常見問答集,以檢視您的問題或疑問尚未在該處解決
- 檢視MSM最佳實務檔案頁面
- 安裝最新Service Pack後,請確定問題可重複發生
解決方法 resolution
尋找有關您的Blueprint和即時副本狀態的進階資訊
多站點管理員(MSM)會在資源URL上註冊數個可使用選取器請求的servlet。
它們由UI使用,也可以直接請求以直接檢視頁面的其他進階計算MSM狀態:
-
http://host:port/content/path/to/bluprint/page.blueprint.json?&maxSize=500&advancedStatus=true&returnRelationships=true&msm%3Atrigger=ROLLOUT
在Blueprint頁面上使用,以擷取連結至該頁面之所有即時副本的清單,並具備進階LC狀態。 -
http://host:port/content/path/to/livecopy/page.msm.json
在Livecopy頁面上使用,以取得有關其與Blueprint頁面連線的進階資訊。如果頁面不是Livecopy,則不會傳回任何專案。
這些servlet會透過com.day.cq.wcm.msm記錄器產生值得檢查的DEBUG記錄訊息。
檢查存放庫中的MSM特定資訊
上述servlet會根據MSM特定節點和Mixin傳回計算資訊。
資訊的儲存方式如下。
-
cq:LiveSyncmixin型別
這是在jcr:content節點上設定,並定義 根Livecopy頁面。這些頁面將具有
cq:LiveSyncConfig型別cq:LiveCopy的子節點,這些子節點將透過下列屬性包含有關Livecopy的基本和必要資訊:cq:master— 指向Livecopy的Blueprint頁面cq:rolloutConfigs— 表示在Livecopy上套用的作用中轉出設定cq:isDeep— 如果此根Livecopy頁面的子頁面包含在Livecopy中,則為true。
-
cq:LiveRelationshipmixin型別
任何livecopy頁面的jcr:content節點都有此類mixin型別。如果沒有,頁面在某個時間點已分離,或在Livecopy動作(建立或轉出)之外透過編寫介面手動建立。
-
cq:LiveSyncCancelledmixin型別
已新增至已暫停的Livecopy頁面的jcr:content節點。如果暫停對子頁面也有效:
cq:isCancelledForChildren=true屬性已新增到相同節點上。
此處顯示的資訊當然應該反映在UI中,不過,在您可能遇到的異常狀況中,您可以詢問UI或MSM行為,超級使用者可以直接驗證這些節點,以瞭解其MSM頁面的狀態。
瞭解這些屬性對於查詢您的存放庫並找出處於特定狀態的頁面集也很有用。
範例: 從cq:LiveSync 選取*將傳回所有Livecopy根頁面。
提出MSM支援票證時要提供的資訊。
您最終可能會需要AEM支援協助。
在支援入口網站中提出支援票證時,請依照如何在Experience League上提交支援票證中的准則,儘量使問題符合資格。
針對MSM問題,您應在理想情況下新增這些額外精確度:
- 在附加記錄檔之前:啟用
com.day.cq.wcm.msm中記錄器/system/console/slinglog的DEBUG層級,並重複有問題的MSM動作。 - 附加組態
http://<host>:<port>/libs/wcm/msm/content/commands/rolloutconfigs.json的輸出 - 傳達附加至即時副本的轉出設定
- 如果問題似乎來自UI (出現瀏覽器主控台錯誤或UI錯誤快顯視窗):產生HAR檔案,以在執行有問題的MSM動作時從使用者角度擷取完整流量:請參閱此連結以取得HAR檔案產生的詳細資訊
重現問題是支援人員快速分析和判斷行為是否正常的最簡單方法,並據此採取相應行動。
為此,請嘗試:
- 根據We-Retail頁面在類似設定上重現您的問題
- 如果不可能,請嘗試建立包含您內容範例的內容套件,讓支援工程師將其安裝在空白的AEM執行個體(與您的執行個體具有相同修補程式層級),並重現問題。