Documentação

Solução de problemas de MSM AEM

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Este artigo descreve maneiras de solucionar problemas de MSM AEM. Além disso, discute o seguinte:

  • Encontrar informações avançadas sobre seu status de Blueprint e Live Copies
  • Verificar as informações específicas do MSM no repositório
  • Informações a serem fornecidas ao gerar um tíquete de Suporte do MSM

Descrição description

Ambiente

Experience Manager

Problema/Sintomas

Verificações básicas para começar com:

Resolução resolution

Encontrar informações avançadas sobre seu status de Blueprint e Live Copies

O Gerenciador de vários sites (MSM) registra vários servlets que podem ser solicitados com seletores nos URLs do recurso.

Eles são usados pela interface do usuário, mas também podem ser solicitados diretamente para ver os status de MSM computados avançados adicionais para suas páginas:

  1. http://host:port/content/path/to/bluprint/page.blueprint.json?&maxSize=500&advancedStatus=true&returnRelationships=true&msm%3Atrigger=ROLLOUT
    Use em uma página do Blueprint para recuperar a lista de todas as live copies vinculadas a ela, com status LC avançado.

  2. http://host:port/content/path/to/livecopy/page.msm.json
    Use nas páginas do Livecopy para obter informações avançadas sobre suas conexões com a página do Blueprint.

    Se a página não for uma Live Copy, nada será retornado.

Esses servlets geram mensagens de log DEBUG por meio do logger com.day.cq.wcm.msm, que também merecem ser verificadas.

Verificar as informações específicas do MSM no repositório

Os servlets acima retornavam informações computadas com base nos nós e mixins específicos do MSM.
As informações são armazenadas da seguinte maneira.

  • cq:LiveSync Tipo de mixin

    Isso é definido nos nós jcr:content e define páginas raiz do Livecopy.

    Essas páginas terão um nó filho cq:LiveSyncConfig do tipo cq:LiveCopy, que conterá informações básicas e obrigatórias sobre a Live Copy por meio das seguintes propriedades:

    • cq:master - aponta para a página Blueprint da Live Copy
    • cq:rolloutConfigs - indica Configurações de implantação ativas aplicadas na Live Copy
    • cq:isDeep - é verdadeiro se as páginas secundárias desta página raiz da Live Copy estiverem incluídas na Live Copy.

  • cq:LiveRelationship tipo de mixin
    Qualquer página do livecopy tem um tipo de mixin em seu nó jcr:content.

    Caso contrário, a página foi em algum momento desconectada ou criada manualmente por meio da interface de criação fora de uma ação do Live Copy (criar ou implantar).

  • cq:LiveSyncCancelled tipo de mixin
    Adicionados aos nós jcr:content de páginas Live Copy que foram suspensas.

    Se a suspensão também for eficaz para páginas secundárias: uma propriedade cq:isCancelledForChildren=true é adicionada no mesmo nó.

As informações presentes lá devem ser refletidas na interface do usuário, no entanto, em situações anormais em que você pode encontrar e questionar o Comportamento da interface do usuário ou do MSM, os superusuários podem verificar diretamente esses nós para entender o status de suas Páginas do MSM.

Conhecer essas propriedades também pode ser útil para consultar seu repositório e descobrir conjuntos de páginas que estão em estados específicos.

Exemplo: selecionar * de cq:LiveSync retornará todas as páginas raiz da Live Copy.

Informações a serem fornecidas ao gerar um tíquete de Suporte do MSM.

Você pode eventualmente precisar de assistência ao suporte do AEM.

Ao levantar um tíquete de suporte no portal de suporte, qualifique o problema da melhor maneira possível, seguindo as diretrizes no seguinte artigo de KB

Para as emissões MSM, essas precisões adicionais devem ser adicionadas idealmente:

  • Antes de anexar logs: habilite o nível DEBUG para o agente de log com.day.cq.wcm.msm em /system/console/slinglog e repita a Ação do MSM problemática.
  • Anexar a saída da configuração http://<host>:<port>/libs/wcm/msm/content/commands/rolloutconfigs.json
  • Comunicar as configurações de implantação anexadas às Live Copies
  • Se o problema parece vir da interface do usuário (erro do console do navegador ou pop-up de erro da interface do usuário aparece): Gere um arquivo HAR para capturar o fluxo completo da perspectiva do usuário ao executar a ação problemática do MSM: consulte este link para obter detalhes sobre a geração do arquivo HAR

Reproduzir o problema é a maneira mais fácil para que o suporte analise e determine rapidamente se o comportamento é normal ou não e aja de acordo.

Para esse fim, tente:

  1. Reproduza o problema em uma configuração semelhante baseada em páginas We-Retail
  2. Se não for possível, tente criar um pacote de conteúdo que inclua um conteúdo de amostra seu, para que um engenheiro de suporte o instale em uma instância do AEM em branco com o mesmo nível de correção da sua e reproduza o problema.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f