DocumentaçãoAEM 6.5Guia do usuário

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

Última atualização: 9 de junho de 2026
  • Aplica-se a:
  • Experience Manager 6.5

Criado para:

  • Admin

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? Caso CONTRÁRIO, faça o seguinte:

  1. Vá para /crx/explorer e faça logon como admin.
  2. Abra o “Content Explorer”
  3. Veja se um nó /bin/replicate ou /bin/replicate.json existe. 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 até /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 travadas:

  1. A fila mostra o status bloqueado? Em caso afirmativo, a instância de publicação não está em execução ou não está respondendo? Verifique a instância de publicação para ver o que há de errado com ela. Ou seja, verifique os registros e veja se há um erro OutOfMemory ou algum outro problema. Se estiver apenas lento, então pegue os despejos de thread e analise-os.

  2. O status da fila mostra A fila está ativa - nº pendente? 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á sobrecarregada ou travada em um bloqueio. Obtenha despejos de thread do autor e da publicação neste caso.

    • Abra os despejos de thread do autor em um analisador de despejo de thread. Verifique se ele mostra que o trabalho de evento sling do agente de replicação está preso em um socketRead.
    • Abra os despejos de thread de publicar em um analisador de despejo de thread e 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. Esse é o thread que recebe a replicação do autor.

Se todas as filas do agente estiverem travadas

  1. É possível que um conteúdo específico não possa ser serializado em /var/replication/data devido à corrupção do repositório ou a algum outro problema. Consulte o site logs/error.log para verificar se há um erro relacionado. Para limpar o item de replicação inválido, faça o seguinte:

    1. Vá para https://<host>:<port>/crx/de e faça logon como usuário administrador.
    2. Clique em “Ferramentas” no menu superior.
    3. Clique no botão de lupa.
    4. Selecione “XPath” como Type.
    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 evento do sling mais recentes. Clique em cada uma e localize as replicações paralisadas correspondentes 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 em /system/console.

  3. Pode ser que o processamento de trabalhos esteja desativado. Você pode verificar isso no Felix Console na guia Evento do Sling. Verifique se exibido - Evento do Apache Sling (O PROCESSAMENTO DE TRABALHO ESTÁ DESATIVADO!)

    • Em caso positivo, marque Manipulador de eventos de trabalho do Apache Sling na guia Configuração no Console Felix. A caixa de seleção ‘Processamento de trabalho ativado’ não pôde ser desmarcada. Se essa opção estiver marcada e ainda exibir que ‘o processamento do trabalho está desabilitado’, verifique se há alguma sobreposição em /apps/system/config que esteja desabilitando o processamento do trabalho. Tente criar um nó osgi:config para jobmanager.enabled com um valor booleano de true e verifique novamente se a ativação foi iniciada e se não há mais trabalhos na fila.

  4. Também pode ocorrer que a configuração de DefaultJobManager entre em um estado inconsistente. Isso pode acontecer quando alguém modifica manualmente a configuração do “Manipulador de eventos de trabalho do Apache Sling” por meio do console OSGi (por exemplo, desative e reative a propriedade “Processamento de trabalho ativado” e salve a configuração).

    • Neste ponto, a configuração DefaultJobManager 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 eventos de trabalho do Apache Sling” mostre “Processamento de trabalho ativado” para estar no estado marcado, quando alguém navega até a guia Evento do Sling, ela mostra a mensagem - O PROCESSAMENTO DE TRABALHO ESTÁ DESATIVADO e a replicação não funciona.
    • Para resolver esse problema, navegue até a página Configuração do console OSGi e exclua a configuração “Manipulador de eventos de trabalho do Apache Sling”. Em seguida, reinicie o nó Principal do cluster para colocar a configuração de volta em um estado consistente. Isso deve corrigir o problema e fazer com que a replicação comece a funcionar novamente.

Criar um replication.log

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

  1. Vá para https://<host>:<port>/system/console/configMgr e faça logon como o usuário administrador.

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

  3. Defina a configuração desta forma:

    • Nível de Log: DEBUG
    • Caminho do Arquivo de Log: logs/replication.log
    • Categorias: com.day.cq.replication

  4. Se você suspeitar que o problema está relacionado a eventos/trabalhos do sling, também poderá adicionar este pacote do 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 criação, sem desabilitá-la. Atualmente, isso só é possível por um hack de configuração temporária de uma porta inválida. A partir da versão 5.4, houve um botão Pausar na fila do agente de replicação com algumas limitações:

  1. O estado não é persistente. Ou seja, se você reiniciar um servidor ou um pacote de replicação for reciclado, ele retornará ao estado em execução.
  2. A pausa fica ociosa por um período mais curto (OOB 1 hora depois de nenhuma atividade com replicação por outros threads). Isso ocorre porque há um recurso no Sling que evita threads ociosas. Verifique se um thread da fila de trabalhos está sem ser usado há muito tempo. Em caso afirmativo, ele inicia ciclos de limpeza. Devido ao ciclo de limpeza, ele interrompe a thread e, portanto, a configuração pausada é perdida. Como as tarefas são persistentes, ele inicia um novo thread para processar a fila, que não tem os detalhes da configuração pausada. Devido a isso, a fila entra 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 publicar e não são usadas por padrão. Isso ocorre porque os direitos de acesso devem ser diferentes nesses dois ambientes. Portanto, a Adobe recomenda configurar ACLs em publicação, separadamente do autor.

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

Às vezes, a fila de replicação é bloqueada ao tentar replicar informações de 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 o privilégio jcr:namespaceManagement. Para evitar esse problema, verifique se:

  • O usuário de replicação (conforme configurado na guia Transporte>Usuário) também existe na instância de Publicação.
  • O usuário tem privilégios de leitura e gravação no caminho em que o conteúdo está instalado.
  • O usuário tem privilégio de jcr:namespaceManagement no nível do repositório. Você pode conceder o privilégio da seguinte maneira:
  1. Faça logon no CRX/DE ( https://<host>:<port>/crx/de/index.jsp) como administrador.
  2. Clique na guia Controle de acesso.
  3. Selecione Repositório.
  4. Clique em Adicionar entrada (o ícone de adição).
  5. Insira o nome do usuário.
  6. Selecione jcr:namespaceManagement na lista de privilégios.
  7. Clique em OK.
recommendation-more-help
experience-manager-65-help-main-toc