설명서

AEM MSM 문제 해결

Last update: Thu Sep 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

이 문서에서는 AEM MSM 문제를 해결하는 방법에 대해 설명합니다. 또한 다음 사항에 대해 설명합니다.

  • 블루프린트 및 라이브 카피 상태에 대한 고급 정보 찾기
  • 저장소에서 MSM 관련 정보 확인
  • MSM 지원 티켓을 제기할 때 제공할 정보

설명 description

환경

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 로거를 통해 확인할 만한 디버그 로그 메시지도 생성합니다.

저장소에서 MSM 관련 정보 확인

위의 서블릿은 MSM 특정 노드 및 믹스인을 기반으로 계산된 정보를 반환했습니다.
정보는 다음과 같은 방법으로 저장됩니다.

  • cq:LiveSync mixin 형식

    jcr:content 노드에 대해 설정되며 루트 Livecopy 페이지 를 정의합니다.

    해당 페이지에는 다음 속성을 통해 Livecopy에 대한 기본 정보 및 필수 정보를 포함하는 cq:LiveSyncConfig 유형의 cq:LiveCopy 하위 노드가 있습니다.

    • cq:master - 라이브 카피의 블루프린트 페이지를 가리킵니다.
    • cq:rolloutConfigs - 라이브 카피에 적용된 활성 롤아웃 구성을 나타냅니다.
    • cq:isDeep - 이 루트 Livecopy 페이지의 하위 페이지가 Livecopy에 포함된 경우 true입니다.

  • cq:LiveRelationship mixin 유형
    모든 Livecopy 페이지의 jcr:content 노드에 이러한 믹스인 유형이 있습니다.

    그렇지 않은 경우 페이지는 어느 시점에서 분리되었거나 라이브 카피 작업(만들기 또는 롤아웃) 외부의 작성 인터페이스를 통해 수동으로 생성되었습니다.

  • cq:LiveSyncCancelled mixin 유형
    일시 중단된 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에 대해 디버그 수준을 사용하도록 설정하고 문제가 있는 MSM 작업을 반복합니다.
  • 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