Replicação

Os agentes de replicação são fundamentais para a Adobe Experience Manager (AEM) como mecanismo usado para:

• Publique (ative) conteúdo de um autor em um ambiente de publicação.
• Limpe explicitamente o conteúdo do cache do Dispatcher.
• Retorna a entrada do usuário (por exemplo, a entrada de formulário) do ambiente publish para o ambiente author (sob controle do ambiente author).

As solicitações estão na fila para o agente apropriado para processamento.

Replicando do autor para publicar

A replicação, para uma instância ou despachante de publicação, ocorre em várias etapas:

• o autor solicita que certos conteúdos sejam publicados (ativados); isso pode ser iniciado por uma solicitação manual ou por acionadores automáticos que foram pré-configurados.

• A solicitação é transmitida ao agente de replicação padrão adequado; um ambiente pode ter vários agentes padrão que sempre serão selecionados para essas ações.

• o agente de replicação "agrupa" o conteúdo e o coloca na fila de replicação.

• na guia Sites, o indicador de status colorido é definido para as páginas individuais.

• O conteúdo é retirado da fila e transportado para o ambiente de publicação usando o protocolo configurado; normalmente, isso é HTTP.

• um servlet no ambiente de publicação recebe a solicitação e publica o conteúdo recebido; o servlet padrão é https://localhost:4503/bin/receive.

• vários ambientes de autor e publicação podem ser configurados.

Replicação de Publicar para Autor

Alguns recursos permitem que os usuários digitem dados em uma instância de publicação.

Em alguns casos, um tipo de replicação conhecido como replicação reversa é necessário para retornar esses dados ao ambiente do autor de onde são redistribuídos para outros ambientes de publicação. Devido a considerações de segurança, qualquer tráfego da publicação para o ambiente do autor deve ser rigorosamente controlado.

A replicação reversa usa um agente no ambiente de publicação que faz referência ao ambiente do autor. Esse agente coloca os dados em uma caixa de saída. Essa caixa de saída corresponde aos ouvintes de replicação no ambiente do autor. Os ouvintes pesquisam as caixas de saída para coletar os dados digitados e depois distribuí-los conforme necessário. Isso garante que o ambiente do autor controle todo o tráfego.

Em outros casos, como nos recursos de Comunidades (por exemplo, fóruns, blogs, comentários e revisões), a quantidade de conteúdo gerado pelo usuário (UGC) que está sendo inserida no ambiente de publicação é difícil de sincronizar com eficiência entre instâncias AEM usando replicação.

AEM Communities nunca usa a replicação para UGC. Em vez disso, a implantação para Comunidades requer uma loja comum para UGC (consulte Armazenamento de conteúdo da comunidade).

Replicação - Fora da caixa

O site de varejo incluído em uma instalação padrão de AEM pode ser usado para ilustrar a replicação.

Para seguir este exemplo e usar os agentes de replicação padrão, é necessário Instalar AEM com:

• o ambiente author na porta 4502
• o ambiente publish na porta 4503

Replicação (Autor para publicar)

1. Navegue até a página de suporte no ambiente do autor.
   https://localhost:4502/content/we-retail/us/en/experience.html <pi>
2. Edite a página para adicionar um texto novo.
3. Ative a página para publicar as alterações.
4. Abra a página de suporte no ambiente de publicação:
   https://localhost:4503/content/we-retail/us/en/experience.html
5. Agora você pode ver as alterações inseridas no autor.

Essa replicação é acionada a partir do ambiente do autor pelo:

• Agente padrão (publicar)
  Esse agente replica o conteúdo para a instância de publicação padrão.
  Os detalhes (configuração e registros) podem ser acessados no console Ferramentas do ambiente do autor; ou:

  https://localhost:4502/etc/replication/agents.author/publish.html.

Agentes de Replicação - Fora da Caixa

Os seguintes agentes estão disponíveis em uma instalação padrão AEM:

• Agente padrão
  Usado para replicar do autor para publicar.

• Dispatcher Flush
  Isso é usado para gerenciar o cache do Dispatcher. Consulte Invalidando o Cache do Dispatcher do Ambiente de Criação e Invalidando o Cache do Dispatcher de uma Instância de Publicação para obter mais informações.

• Replicação reversaUsada para replicação de publicação para autor.
  A replicação reversa não é usada para recursos das Comunidades, como fóruns, blogs e comentários. Ela é efetivamente desativada, pois a caixa de saída não está ativada. O uso da replicação reversa exigiria configuração personalizada.

• Agente estático
  Este é um "Agente que armazena uma representação estática de um nó no sistema de arquivos."
  Por exemplo, com as configurações padrão, as páginas de conteúdo e os ativos dam são armazenados em /tmp, como HTML ou o formato de ativo apropriado. Consulte as guias Settings e Rules para obter a configuração.
  Isso foi solicitado para que, quando a página for solicitada diretamente do servidor de aplicativos, o conteúdo possa ser visualizado. Este é um agente especializado e (provavelmente) não será necessário para a maioria das instâncias.

Agentes de Replicação - Parâmetros de Configuração

Ao configurar um agente de replicação a partir do console Ferramentas, quatro guias estão disponíveis na caixa de diálogo:

Configurações

• Nome

  Um nome exclusivo para o agente de replicação.

• Descrição

  Uma descrição da finalidade que este agente de replicação servirá.

• Ativado

  Indica se o agente de replicação está ativado no momento.

  Quando o agente for ativado, a fila será mostrada como:

  • Ativar quando os itens estão sendo processados.
  • Quando a fila estiver vazia.
  • Bloqueado quando os itens estão na fila, mas não podem ser processados; por exemplo, quando a fila de recebimento está desativada.

• Tipo de serialização

  O tipo de serialização:

  • Padrão: Defina se o agente deve ser selecionado automaticamente.
  • Dispatcher Flush: Selecione essa opção se o agente for usado para liberar o cache do dispatcher.

• Tentar novamente o atraso

  O atraso (tempo de espera em milissegundos) entre duas tentativas, caso algum problema seja encontrado.

  Padrão: 60000

• ID de usuário agente

  Dependendo do ambiente, o agente usará essa conta de usuário para:

  • coletar e empacotar o conteúdo do ambiente do autor
  • criar e gravar o conteúdo no ambiente de publicação

  Deixe este campo vazio para usar a conta de usuário do sistema (a conta definida no sling como o usuário administrador; por padrão, é admin).

  CUIDADO

  Para um agente no ambiente do autor, essa conta must tem acesso de leitura a todos os caminhos que você deseja que sejam replicados.

  CUIDADO

  Para um agente no ambiente de publicação, essa conta deve ter o acesso de criação/gravação necessário para replicar o conteúdo.

  OBSERVAÇÃO

  Isso pode ser usado como um mecanismo para selecionar conteúdo específico para replicação.

• Nível de registro

  Especifica o nível de detalhes a ser usado para mensagens de log.

  • Error: somente os erros serão registrados
  • Info: serão registrados erros, avisos e outras mensagens informativas
  • Debug: um alto nível de detalhes será usado nas mensagens, principalmente para fins de depuração

  Padrão: Info

• Use para replicação reversa

  Indica se este agente será usado para replicação reversa; retorna a entrada do usuário do ambiente de publicação para o autor.

• Atualização do alias

  A seleção dessa opção ativa solicitações de invalidação de caminho de alias ou vanity para o Dispatcher. Além disso, consulte Configurando um Dispatcher Flush Agent.

Transporte

• URI

  Isso especifica o servlet de recebimento no local do público alvo. Em particular, você pode especificar o nome do host (ou alias) e o caminho do contexto para a instância do público alvo aqui.

  Por exemplo:

  • Um Agente Padrão pode replicar para https://localhost:4503/bin/receive
  • Um agente do Dispatcher Flush pode replicar para https://localhost:8000/dispatcher/invalidate.cache

  O protocolo especificado aqui (HTTP ou HTTPS) determinará o método de transporte.

  Para os agentes do Dispatcher Flush, a propriedade URI será usada somente se você usar entradas de host virtual baseadas em caminho para diferenciar entre farm, você usará esse campo para público alvo do farm para invalidar. Por exemplo, o farm #1 tem um host virtual de www.mysite.com/path1/* e o farm #2 tem um host virtual de www.mysite.com/path2/*. Você pode usar um URL de /path1/invalidate.cache para público alvo do primeiro farm e /path2/invalidate.cache para público alvo do segundo farm.

• Usuário

  Nome de usuário da conta a ser usada para acessar o público alvo.

• Senha

  Senha da conta a ser usada para acessar o público alvo.

• Domínio NTLM

  Domínio para autenticação NTML.

• Host NTLM

  Host para autenticação NTML.

• Ativar SSL relaxado

  Ative se desejar que certificados SSL autocertificados sejam aceitos.

• Permitir certificados expirados

  Ative se desejar que certificados SSL expirados sejam aceitos.

Proxy

As seguintes configurações são necessárias somente se um proxy for necessário:

• Host do proxy

  Nome do host do proxy usado para transporte.

• Porta de proxy

  Porta do proxy.

• Usuário de proxy

  Nome de usuário da conta a ser usada.

• Senha do proxy

  Senha da conta a ser usada.

• Domínio do proxy NTLM

  O domínio NTLM proxy.

• Host do proxy NTLM

  O domínio NTLM proxy.

Estendido

• Interface

  Aqui você pode definir a interface de soquete à qual se vincular.

  Isso define o endereço local a ser usado ao criar conexões. Se isso não for definido, o endereço padrão será usado. Isso é útil para especificar a interface a ser usada em sistemas com vários pontos ou em cluster.

• Método HTTP

  O método HTTP a ser usado.

  Para um agente do Dispatcher Flush, isso é quase sempre GET e não deve ser alterado (POST seria outro valor possível).

• Cabeçalhos de HTTP

  Eles são usados para os agentes do Dispatcher Flush e especificam elementos que devem ser liberados.

  Para um agente do Dispatcher Flush, as três entradas padrão não precisam ser alteradas:

  • CQ-Action:{action}
  • CQ-Handle:{path}
  • CQ-Path:{path}

  Estes são utilizados, conforme apropriado, para indicar a ação a ser utilizada ao lavar a pega ou o caminho. Os subparâmetros são dinâmicos:

  • {action} indica uma ação de replicação

  • {path} indica um caminho

  Eles são substituídos pelo caminho/ação relevante para o pedido e, portanto, não precisam ser "codificados":

  OBSERVAÇÃO

  Se você instalou o AEM em um contexto diferente do padrão recomendado, será necessário registrar o contexto nos Cabeçalhos HTTP. Por exemplo:
  CQ-Handle:/<*yourContext*>{path}

• Fechar conexão

  Ative para fechar a conexão após cada solicitação.

• Tempo limite de conexão

  Tempo limite (em milissegundos) a ser aplicado ao tentar estabelecer uma conexão.

• Tempo limite do soquete

  Tempo limite (em milissegundos) a ser aplicado ao aguardar tráfego após uma conexão ter sido estabelecida.

• Versão do protocolo

  Versão do protocolo; por exemplo 1.0 para HTTP/1.0.

Acionadores

Essas configurações são usadas para definir acionadores para replicação automatizada:

• Ignorar padrão

  Se marcado, o agente será excluído da replicação padrão; isso significa que ele não será usado se um autor de conteúdo executar uma ação de replicação.

• Em modificação

  Aqui, uma replicação por esse agente será acionada automaticamente quando uma página for modificada. Isso é usado principalmente para agentes do Dispatcher Flush, mas também para replicação reversa.

• Durante roll-out

  Se marcada, o agente replicará automaticamente qualquer conteúdo marcado para distribuição quando for modificado.

• Tempo de ativação/desativação atingido

  Isso acionará a replicação automática (para ativar ou desativar uma página, conforme o caso) quando ocorrer o tempo de funcionamento ou o tempo de inatividade definidos para uma página. Esta é utilizada principalmente para agentes do Dispatcher Flush.

• No recebimento

  Se marcado, o agente fará a replicação em cadeia sempre que receber eventos de replicação.

• Sem atualização de status

  Quando marcado, o agente não forçará uma atualização de status de replicação.

• Sem controle de versão

  Quando marcado, o agente não forçará o controle de versão de páginas ativadas.

Configurando seus Agentes de Replicação

Para obter informações sobre como conectar agentes de replicação à instância de publicação usando MSSL, consulte Replicando usando SSL Mútuo.

Configuração dos Agentes de Replicação a partir do Ambiente Autor

Na guia Ferramentas, no ambiente do autor, é possível configurar agentes de replicação que residem no ambiente do autor (Agentes no autor) ou no ambiente de publicação (Agentes no publish). Os procedimentos a seguir ilustram a configuração de um agente para o ambiente autor, mas podem ser usados para ambos.

1. Acesse a guia Ferramentas no AEM.

2. Clique em Replicação (painel esquerdo para abrir a pasta).

3. Clique com o duplo Agentes no autor (no painel esquerdo ou direito).

4. Clique no nome do agente apropriado (que é um link) para mostrar informações detalhadas sobre esse agente.

5. Clique em Editar para abrir a caixa de diálogo de configuração:

   

6. Os valores fornecidos devem ser suficientes para uma instalação padrão. Se você fizer alterações, clique em OK para salvá-las (consulte Agentes de Replicação - Parâmetros de Configuração para obter mais detalhes sobre os parâmetros individuais).

Configurando Replicação Inversa

A replicação reversa é usada para gerar o conteúdo do usuário em uma instância de publicação para uma instância do autor. Isso é comumente usado para recursos como pesquisas e formulários de registro.

Por motivos de segurança, a maioria das topologias de rede não permite conexões de a "Zona Desmilitarizada" (uma subrede que expõe os serviços externos a uma rede não confiável, como a Internet).

Como o ambiente publish costuma estar no DMZ, para obter conteúdo de volta ao ambiente do autor, a conexão deve ser iniciada a partir da instância do autor. Isso é feito com:

• uma caixa de saída no ambiente de publicação onde o conteúdo é colocado.
• um agente (publicar) no ambiente do autor que consulta periodicamente a caixa de saída para novo conteúdo.

Para fazer isso, você precisa:

Um agente de replicação reversa no ambiente do autorFunciona como o componente ativo para coletar informações da caixa de saída no ambiente de publicação:

Se quiser usar a replicação reversa, verifique se esse agente está ativado.

Um agente de replicação reversa no ambiente de publicação (uma caixa de saída) Esse é o elemento passivo, pois atua como uma "caixa de saída". A entrada do usuário é colocada aqui, de onde é coletada pelo agente no ambiente do autor.

Configurando a Replicação para Várias Instâncias de Publicação

Durante a instalação, um agente padrão já está configurado para replicação de conteúdo para uma instância de publicação executada na porta 4503 do host local.

Para configurar a replicação de conteúdo para uma instância de publicação adicional, é necessário criar e configurar um novo agente de replicação:

1. Abra a guia Ferramentas no AEM.

2. Selecione Replicação e Agentes no autor no painel esquerdo.

3. Selecione Novo….

4. Defina Título e Nome, em seguida selecione Agente de Replicação.

5. Clique em Criar para criar o novo agente.

6. Clique com o duplo no novo item do agente para abrir o painel de configuração.

7. Clique em Editar - a caixa de diálogo Configurações do Agente será aberta - o Tipo de Serialização já está definido como Padrão, isso deve continuar.

   • Na guia Configurações:

     • Ativar Ativado.

     • Digite um Description.

     • Defina Retry Delay como 60000.

     • Deixe Tipo de serialização como Default.

   • Na guia Transporte:

     • Insira o URI necessário para a nova instância de publicação; por exemplo,

       https://localhost:4504/bin/receive.

     • Insira a conta de usuário específica do site usada para replicação.

     • Você pode configurar outros parâmetros, conforme necessário.

8. Clique em OK para salvar as configurações.

Em seguida, você pode testar a operação atualizando e publicando uma página no ambiente do autor.

As atualizações serão exibidas em todas as instâncias de publicação configuradas como acima.

Se encontrar algum problema, você pode verificar os registros na instância do autor. Dependendo do nível de detalhe necessário, também é possível definir Nível de Log como Debug usando a caixa de diálogo Configurações do Agente como descrito acima.

Configurar um agente do Dispatcher Flush

Os agentes padrão são incluídos na instalação. No entanto, determinadas configurações ainda são necessárias e o mesmo se aplica se você estiver definindo um novo agente:

1. Abra a guia Ferramentas no AEM.

2. Clique em Implantação.

3. Selecione Replicação e Agentes ao publicar.

4. Clique com o duplo no item Dispatcher Flush para abrir a visão geral.

5. Clique em Editar - a caixa de diálogo Configurações do Agente abrirá:

   • Na guia Configurações:

     • Ativar Ativado.

     • Digite um Description.

     • Deixe Tipo de serialização como Dispatcher Flush, ou defina-o como tal se estiver criando um novo agente.

     • (opcional) Selecione Atualização de alias para ativar solicitações de invalidação de alias ou caminho vanity para o Dispatcher.

   • Na guia Transporte:

     • Insira o URI necessário para a nova instância de publicação; por exemplo,

       https://localhost:80/dispatcher/invalidate.cache.

     • Insira a conta de usuário específica do site usada para replicação.

     • Você pode configurar outros parâmetros, conforme necessário.

   Para os agentes do Dispatcher Flush, a propriedade URI será usada somente se você usar entradas de host virtual baseadas em caminho para diferenciar entre farm, você usará esse campo para público alvo do farm para invalidar. Por exemplo, o farm #1 tem um host virtual de www.mysite.com/path1/* e o farm #2 tem um host virtual de www.mysite.com/path2/*. Você pode usar um URL de /path1/invalidate.cache para público alvo do primeiro farm e /path2/invalidate.cache para público alvo do segundo farm.

   OBSERVAÇÃO

   Se você instalou AEM em um contexto diferente do padrão recomendado, é necessário configurar os Cabeçalhos HTTP na guia Extended.

6. Clique em OK para salvar as alterações.

7. Retorne à guia Ferramentas, a partir daí você pode Ativar o agente Dispatcher Flush (Agentes ao publicar).

O agente de replicação Dispatcher Flush não está ativo no autor. Você pode acessar a mesma página no ambiente de publicação usando o URI equivalente; por exemplo, https://localhost:4503/etc/replication/agents.publish/flush.html.

Controlando o Acesso aos Agentes de Replicação

O acesso às páginas usadas para configurar os agentes de replicação pode ser controlado usando permissões de página de usuário e/ou grupo no nó etc/replication.

Configuração dos Agentes de Replicação a partir de CRXDE Lite

Vários parâmetros dos agentes de replicação podem ser configurados usando o CRXDE Lite.

Se você navegar até /etc/replication, poderá ver os três nós a seguir:

• agents.author
• agents.publish
• treeactivation

Os dois agents mantêm informações de configuração sobre o ambiente apropriado e estão ativos somente quando esse ambiente está em execução. Por exemplo, agents.publish será usado somente no ambiente publish. A seguinte captura de tela mostra o agente de publicação no ambiente do autor, conforme incluído AEM WCM:

Monitorando seus Agentes de Replicação

Para monitorar um agente de replicação:

1. Acesse a guia Ferramentas no AEM.

2. Clique em Replicação.

3. Clique com o duplo no link para os agentes do ambiente apropriado (no painel esquerdo ou direito); por exemplo, Agentes no autor.

   A janela resultante mostra uma visão geral de todos os seus agentes de replicação para o ambiente do autor, incluindo seu público alvo e status.

4. Clique no nome do agente apropriado (que é um link) para mostrar informações detalhadas sobre esse agente:

   

   Aqui você pode:

   • Veja se o agente está ativado.

   • Veja o público alvo de qualquer replicação.

   • Veja se a fila de replicação está ativa no momento (ativada).

   • Veja se há algum item na fila.

   • ​​Refreshor ​​Clearto atualizar a exibição das entradas da fila; isso ajuda você a ver os itens entrando e saindo da fila.

   • Logon de visualização para acessar o log de quaisquer ações pelo agente de replicação.

   • Teste a conexão com a instância do público alvo.

   • Forçar nova tentativa em qualquer item da fila, se necessário.

   CUIDADO

   Não use o link "Testar conexão" para a caixa de saída de replicação inversa em uma instância de publicação.

   Se um teste de replicação for executado para uma fila de caixa de saída, todos os itens mais antigos que a replicação de teste serão processados novamente com cada replicação reversa.

   Se esses itens já existirem em uma fila, eles podem ser encontrados com o seguinte query XPath JCR e devem ser removidos.

   /jcr:root/var/replication/outbox//*[@cq:repActionType='TEST']

Replicação em lote

A replicação em lote não replica páginas ou ativos individuais, mas aguarda o primeiro limite dos dois, com base no tempo ou no tamanho, a ser acionado.

Em seguida, ele compacta todos os itens de replicação em um pacote, que é replicado como um único arquivo para o editor.

O editor descompactará todos os itens, salvá-los e retornará ao autor.

Configurando a Replicação em Lote

1. Ir para http://serveraddress:serverport/siteadmin
2. Pressione o ícone Ferramentas no lado superior da tela
3. No painel de navegação esquerdo, vá para Replicação - Agentes no Autor e clique no duplo Agente Padrão.
   • Você também pode acessar o agente de replicação de publicação padrão indo diretamente para http://serveraddress:serverport/etc/replication/agents.author/publish.html
4. Pressione o botão Editar acima da fila de replicação.
5. Na seguinte janela, vá para a guia Lote:
   
6. Configure o agente.

Parâmetros

• [!UICONTROL Enable Batch Mode] - ativa ou desativa o modo de replicação em lote
• [!UICONTROL Max Wait Time] - Tempo máximo de espera até que uma solicitação em lote seja iniciada, em segundos. O padrão é 2 segundos.
• [!UICONTROL Trigger Size] - Replicação em lote de Start quando este limite de tamanho

Recursos adicionais

Para obter detalhes sobre a solução de problemas, você pode ler a página Solução de problemas de replicação.