DocumentaçãoAEM 6.4Guia de implementação

Solução de problemas de replicação troubleshooting-replication

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Desenvolvedor
CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Esta página fornece informações sobre como solucionar problemas de replicação.

Problema problem

A replicação (replicação não reversa) está falhando por algum motivo.

Resolução resolution

Há vários motivos para a replicação falhar. Este artigo explica a abordagem que pode ser adotada ao analisar esses problemas.

As replicações estão sendo acionadas ao clicar no botão Ativar? Se NÃO, faça o seguinte:

  1. Vá para /crx/explorer (CQ5.5) e faça logon como administrador.
  2. Abra o "Explorador de Conteúdo"
  3. Veja se existe um nó /bin/replicate ou /bin/replicate.json. Se o nó existir, exclua-o e salve.

As replicações estão sendo enfileiradas nas filas do agente de replicação?

Verifique isso indo para /etc/replication/agents.author.html e clique nos agentes de replicação para verificar.

Se uma fila de agente ou algumas filas de agente estiverem presas:

  1. A fila aparece bloqueado status? Em caso afirmativo, a instância de publicação não está em execução ou não responde totalmente? Verifique a instância de publicação para ver o que há de errado com ela (ou seja, verifique os logs e veja se há um erro OutOfMemory ou algum outro problema. Em seguida, se estiver apenas lento, pegue os despejos de encadeamento e analise-os.

  2. O status da fila é exibido A fila está ativa - # pendente? Basicamente, o trabalho de replicação pode estar preso em uma leitura de soquete aguardando a instância de publicação ou o dispatcher responder. Isso pode significar que a instância de publicação ou o dispatcher está sob alta carga ou preso em um bloqueio. Pegue despejos de encadeamento do autor e publique neste caso.

    • Abra os dumps de encadeamento do autor em um analisador de despejo de encadeamento, verifique se ele mostra que o trabalho de evento de sling do agente de replicação está preso em um socketRead.
    • Abra os dumps de encadeamento da publicação em um analisador de dump de encadeamento, analise o que pode estar fazendo com que a instância de publicação não responda. Você deve ver um thread com POST /bin/receive em seu nome, que é o thread que recebe a replicação do autor.

Se todas as filas de agente estiverem presas

  1. É possível que um determinado conteúdo não possa ser serializado em /var/replication/data devido a corrupção do repositório ou algum outro problema. Verifique se há um erro relacionado no logs/error.log. Para limpar o item de replicação incorreto, faça o seguinte:

    1. Vá para https://<host>:<port>/crx e fazer logon como usuário administrador. No CQ5.5, acesse https://<host>:<port>/crx/explorer em vez disso.
    2. Clique em "Explorador de conteúdo".
    3. Na janela "Content Explorer", clique no botão de lupa na parte superior direita da janela e uma caixa de diálogo de pesquisa será exibida.
    4. Selecione o botão de opção "XPath".
    5. Na caixa "Consulta", digite esta consulta /jcr:root/var/eventing/jobs//element(*,slingevent:Job) order by @slingevent:created
    6. Clique em "Pesquisar"
    7. Nos resultados, os itens principais são os trabalhos de eventos de sling mais recentes. Clique em cada uma e localize as replicações presas que correspondem ao que aparece na parte superior da fila.

  2. Pode haver algo errado com as filas de trabalho da estrutura de eventos do sling. Tente reiniciar o pacote org.apache.sling.event no /system/console.

  3. Pode ser que o processamento de trabalho esteja completamente desligado. Você pode verificar isso no Felix Console na guia Eventos do Sling. Verifique se é exibido - Apache Sling Eventing (O PROCESSAMENTO DE TAREFA ESTÁ DESATIVADO!)

    • Se sim, marque Apache Sling Job Event Handler na guia Configuração no Felix Console. Pode ser que a caixa de seleção 'Processamento de trabalho ativado' esteja desmarcada. Se essa opção estiver marcada e ainda assim exibir que "o processamento de tarefas está desativado", verifique se há alguma sobreposição em /apps/system/config que esteja desativando o processamento de tarefas. Tente criar um nó osgi:config para jobmanager.enabled com um valor booleano para true e verifique novamente se a ativação foi iniciada e se não há mais tarefas na fila.

  4. Também pode ser o caso em que a configuração DefaultJobManager fica em um estado inconsistente. Isso pode acontecer quando alguém modifica manualmente a configuração do "Manipulador de evento do trabalho do Apache Sling" por meio do console OSG (por exemplo, desative e reative a propriedade "Processamento de trabalho ativado" e salve a configuração).

    • Neste ponto, a configuração DefaultJobManager que é armazenada em crx-quickstart/launchpad/config/org/apache/sling/event/impl/jobs/DefaultJobManager.config entra em um estado inconsistente. E mesmo que a propriedade 'Manipulador de Evento de Trabalho do Apache Sling' mostre 'Processamento de Trabalho Ativado' para estar no estado marcado, quando se navega até a guia Evento do Sling, ela mostra a mensagem - O PROCESSAMENTO DO JOB ESTÁ DESATIVADO e a replicação não funciona.
    • Para resolver esse problema, seria necessário navegar até a página Configuração do console OSGi e excluir a configuração "Manipulador de evento do trabalho do Apache". Em seguida, reinicie o nó Principal do cluster para obter a configuração de volta a um estado consistente. Isso deve corrigir o problema e a replicação começará a funcionar novamente.

Criar um replication.log

Às vezes, pode ser muito útil definir todos os logs de replicação a serem adicionados em um arquivo de log separado no nível DEBUG. Para fazer isso:

  1. Ir para https://host:port/system/console/configMgr e faça logon como administrador.

  2. Encontre a fábrica do Apache Sling Logging Logger e crie uma instância clicando no botão + à direita da configuração de fábrica. Isso criará um novo logger de registro.

  3. Defina a configuração desta forma:

    • Nível de registro: DEPURAR
    • Caminho do arquivo de log: (CQ5.4 e 5.3) …/logs/replication.log (CQ5.5) logs/replication.log
    • Categorias: com.day.cq.replication

  4. Se você suspeitar que o problema esteja relacionado a eventos/trabalhos do sling de alguma forma, também poderá adicionar este pacote java em categories:org.apache.sling.event

Pausando Fila do Agente de Replicação pausing-replication-agent-queue

Às vezes, pode ser adequado pausar a fila de replicação para reduzir a carga no sistema de autor, sem desativá-la. Atualmente, isso só é possível por meio de uma pilha de configuração temporária de uma porta inválida. A partir da 5.4, você pode ver o botão pausar na fila do agente de replicação, ele tem alguma limitação

  1. O estado não é persistente, o que significa que se você reiniciar um servidor ou um pacote de replicação for reciclado, ele retornará ao estado de execução.
  2. A pausa fica inativa por um período mais curto (OOB 1 hora após nenhuma atividade com replicação por outros threads) e não por um tempo mais longo. Porque há um recurso no sling que evita threads ociosos. Basicamente, verifique se um encadeamento de fila de trabalhos foi usado por um tempo maior, se assim for, ele inicia os ciclos de limpeza. Devido ao ciclo de limpeza, ele interrompe o thread e, portanto, a configuração pausada é perdida. Como os trabalhos são persistentes, ele inicia um novo thread para processar a fila que não tem detalhes da configuração pausada. Devido a essa fila, o fica em estado de execução.

As permissões de página não são replicadas na ativação do usuário page-permissions-are-not-replicated-on-user-activation

As permissões de página não são replicadas porque são armazenadas nos nós aos quais o acesso é concedido, não com o usuário.

Em geral, as permissões de página não devem ser replicadas do autor para publicação e não são por padrão. Isso ocorre porque os direitos de acesso devem ser diferentes nesses dois ambientes. Portanto, é recomendável configurar ACLs na publicação separadamente do autor.

Fila de replicação bloqueada ao replicar informações de namespace do Autor para Publicação replication-queue-blocked-when-replicating-namespace-information-from-author-to-publish

Em alguns casos, a fila de replicação é bloqueada ao tentar replicar informações do namespace da instância do autor para a instância de publicação. Isso acontece porque o usuário de replicação não tem jcr:namespaceManagement privilégio. Para evitar esse problema, verifique se:

  • O usuário de replicação (conforme configurado no Transportes tab>User) também existe na instância Publish .
  • O usuário tem privilégios de leitura e gravação no caminho em que o conteúdo é instalado.
  • O usuário tem jcr:namespaceManagement privilégio no nível do repositório. É possível conceder o privilégio da seguinte maneira:
  1. Faça logon no CRX/DE ( http://localhost:4502/crx/de/index.jsp) como administrador.
  2. Clique no botão Controle de acesso guia .
  3. Selecionar Repositório.
  4. Clique em Adicionar entrada (o ícone de mais).
  5. Insira o nome do usuário.
  6. Selecionar jcr:namespaceManagement na lista de privilégios.
  7. Clique em OK.
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56