ドキュメント

AEM MSM の問題のトラブルシューティング

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

この文書では、AEM MSM の問題のトラブルシューティング方法を説明します。 さらに、次の点についても説明します。

  • ブループリントとライブコピーに関する詳細な情報を見つける
  • リポジトリ内の MSM 固有の情報を確認する
  • MSM サポートチケットを発行する際に提供する情報

説明 description

環境

Adobe Experience Manager

問題/症状

最初に行う基本検証：

解決策 resolution

ブループリントとライブコピーに関する詳細な情報を見つける

マルチサイトマネージャー（MSM）は、リソース URL のセレクターと共にリクエストできる複数のサーブレットを登録します。

これらは UI で使用されますが、ページに対する高度な計算済み MSM ステータスを追加で直接表示するために、直接要求することもできます。

  1. http://host:port/content/path/to/bluprint/page.blueprint.json?&maxSize=500&advancedStatus=true&returnRelationships=true&msm%3Atrigger=ROLLOUT
    ブループリントページでを使用して、リンクされているすべてのライブコピーのリストと、詳細な LC ステータスを取得します。

  2. http://host:port/content/path/to/livecopy/page.msm.json
    ライブコピーページでを使用して、ブループリントページとの接続に関する詳細情報を取得します。

    ページがライブコピーでない場合は、何も返されません。

これらのサーブレットは、com.day.cq.wcm.msm ロガーを介して DEBUG ログメッセージを生成します。このロガーも確認する価値があります。

リポジトリ内の MSM 固有の情報を確認する

上記のサーブレットは、MSM 固有のノードと Mixin に基づいて計算済みの情報を返しました。
情報は次のように保存されます。

  • cq:LiveSync の mixin タイプ

    jcr:content ノードで設定され、 ルートのライブコピーページ を定義します。

    これらのページには、以下のプロパティを介してライブコピーの基本情報と必須情報が含まれるタイプ cq:LiveSyncConfig の cq:LiveCopy しい子ノードがあります。

    • cq:master - ライブコピーのブループリントページを指します
    • cq:rolloutConfigs - ライブコピーに適用されたアクティブなロールアウト設定を示します
    • cq:isDeep – このルートライブコピーページの子ページが、ライブコピーに含まれる場合は true。

  • cq:LiveRelationship mixin タイプ
    すべてのライブコピーページの jcr:content ノードにこのような mixin タイプがあります。

    そうでない場合は、ライブコピーアクション（作成またはロールアウト）以外のオーサリングインターフェイスを使用して、ページがある時点でデタッチされているか、手動で作成されています。

  • cq:LiveSyncCancelled mixin タイプ
    中断されたライブコピーページの jcr:content ノードに追加されました。

    サスペンションが子ページに対しても有効な場合、同じノードに cq:isCancelledForChildren=true プロパティが追加されます。

存在する情報は、もちろん UI に反映されます ただし、UI や MSM の動作に疑問を抱く異常な状況が発生する場合は、スーパーユーザーがこれらのノードを直接検証して、MSM ページのステータスを把握できます。

また、リポジトリに対してクエリを実行し、特定の状態にあるページのセットを見つけるためにも、これらのプロパティを知ることが役立ちます。

例：select * from cq:LiveSync は、すべてのライブコピーのルートページを返します。

MSM サポートチケットを発行する際に提供する情報。

最終的には、AEM サポートの支援が必要になる場合があります。

サポートポータルでサポートチケットを発行する場合は、Experience Leagueでサポートチケットを送信する方法 ​ に記載されているガイドラインに従って、できる限り問題を検証します。

MSM の問題の場合は、次の場所に精度を追加するのが理想的です。

  • ログを添付する前に、com.day.cq.wcm.msm でロガー /system/console/slinglog ードの DEBUG レベルを有効にし、問題のある MSM アクションを繰り返します。
  • config http://<host>:<port>/libs/wcm/msm/content/commands/rolloutconfigs.json の出力を添付
  • ライブコピーに添付されているロールアウト設定の伝達
  • 問題の原因が UI にあると思われる場合（ブラウザーコンソールエラーまたは UI エラーポップアップが表示される）：問題のある MSM アクションを実行する際の、ユーザーの観点から完全なフローを取得するための HAR ファイルを生成します。HAR ファイルの生成について詳しくは、この ​ リンク ​ を参照してください

問題を再現することは、サポート部門が動作が正常かどうかを迅速に分析し、それに応じて対処するための最も簡単な方法です。

この目的のために、次の操作を試みます。

  1. We-Retail ページに基づいた同様の設定で問題を再現します
  2. 不可能な場合は、サポートエンジニアが、お客様と同じパッチレベルで、空のAEM インスタンスにインストールするために、お客様のサンプルコンテンツを含むコンテンツパッケージをビルドし、問題を再現してみてください。
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f