DocumentaçãoAEM 6.5Guia do usuário

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

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador

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. Acesse /crx/explorer e faça logon como administrador.
  2. Abra o "Content Explorer"
  3. Consulte 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 acessando /etc/replication/agents.author.html e clicando 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? Basicamente, o trabalho de replicação pode ficar 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 em 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 uma thread com POST /bin/receive em seu nome, que é a 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. Acesse 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 ordem de consulta /jcr:root/var/eventing/jobs//element(*,slingevent:Job) por @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 no/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. Pode ser que a caixa de seleção 'Processamento de trabalho ativado' esteja desmarcada. Se essa opção estiver marcada e ainda exibir "o processamento do trabalho está desativado", 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 como 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 OSGiconsole (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 a replicação começa 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. Acesse https://host:port/system/console/configMgr e faça logon como 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 esteja relacionado a eventos/trabalhos do sling de alguma forma, também será possível adicionar esse pacote do Java™ em categorias: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, você pode ver o botão Pausar na fila do agente de replicação. Ele tem algumas limitações

  1. O estado não é persistente, o que significa que, se você reiniciar um servidor ou um pacote de replicação for reciclado, ele voltará 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) e não por um tempo mais longo. Porque há um recurso no sling que evita threads ociosos. Basicamente, verifique se uma thread da fila de trabalhos está sem uso há mais tempo. Nesse caso, ela inicia os ciclos de limpeza. Devido ao ciclo de limpeza, ele interrompe a 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 esta fila se transforma 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, o Adobe recomenda que você configure ACLs em publicação, separadamente do autor.

Fila de replicação bloqueada ao replicar informações de namespace de Autor para Publish 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 do Publish.
  • 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://localhost:4502/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
19ffd973-7af2-44d0-84b5-d547b0dffee2