Replicação

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

• Publicar (ativar) conteúdo de um Autor para um ambiente de Publicação.
• Limpar explicitamente o conteúdo do cache do Dispatcher.
• Retorne a entrada do usuário (por exemplo, entrada de formulário) do ambiente de Publicação para o ambiente do Autor (sob controle do ambiente do Autor).

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

Replicação do autor para a publicação

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

• o Autor solicita que determinado conteúdo seja Publicado (ativado); isso pode ser iniciado por uma solicitação manual ou por acionadores automáticos que foram pré-configurados.

• a solicitação é passada para o agente de replicação padrão apropriado; um ambiente pode ter vários agentes padrão que são sempre selecionados para essas ações.

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

• na guia Sites, a variável indicador de status colorido é definido para páginas individuais.

• o conteúdo é retirado da fila e transportado para o ambiente de publicação usando o protocolo configurado; geralmente, é 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 publicação para autor

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

Às vezes, 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 do ambiente Publicar para o Autor deve ser estritamente controlado.

A replicação reversa usa um agente no ambiente de publicação que faz referência ao ambiente de 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 sondam as caixas de saída para coletar todos os dados inseridos e distribuí-los conforme necessário. Isso garante que o ambiente de Autor controle todo o tráfego.

Em outros casos, como em recursos das 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 replicação para UGC. Em vez disso, a implantação do Communities requer um armazenamento comum para UGC (consulte Armazenamento de conteúdo da comunidade).

Replicação - pronta para uso

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

Para seguir este exemplo e usar os agentes de replicação padrão, instalar AEM com:

• o ambiente do autor na porta 4502
• o Ambiente de publicação na porta 4503

Replicação (Autor para publicar)

1. Acesse 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 poder adicionar um texto novo.
3. Ativar página para que você possa 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 em Autor.

Essa replicação é ativada no ambiente do Autor pelo:

• Agente padrão (publicação)
  Esse agente replica o conteúdo na instância de publicação padrão.
  Detalhes disso (configuração e logs) podem ser acessados no console Ferramentas do ambiente Autor ou:
  https://localhost:4502/etc/replication/agents.author/publish.html.

Agentes de replicação - prontos para uso

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

• Agente padrão
  Usado para replicar de Autor para Publicação.

• Limpeza do Dispatcher Usada para gerenciar o cache do Dispatcher. Consulte Invalidação do cache do Dispatcher no ambiente de criação e Invalidação do cache do Dispatcher de uma instância de publicação para obter mais informações.

• Replicação reversa
  Usado para replicação de Publicar 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 uma configuração personalizada.

• Agente estático: é 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 a Settings e Rules para a configuração.
  Isso foi solicitado para que, quando a página for solicitada diretamente do servidor de aplicativos, o conteúdo possa ser visto. Esse é um agente especializado e (provavelmente) não é necessário para a maioria das instâncias.

Agentes de replicação - Parâmetros de configuração

Ao configurar um agente de replicação no console Ferramentas, quatro guias estarão disponíveis na caixa de diálogo:

Configurações

• Nome

  Nome exclusivo do agente de replicação.

• Descrição

  Uma descrição da finalidade deste agente de replicação.

• Habilitado

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

  Quando o agente estiver habilitado, a fila será exibida como:

  • Ativo quando os itens estão sendo processados.
  • Ocioso quando a fila estiver vazia.
  • Bloqueado quando 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.
  • Limpeza do Dispatcher: 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 seja encontrado um problema.

  Padrão: 60000

• ID de usuário agente

  Dependendo do ambiente, o agente usa 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).

  ATENÇÃO

  Para um agente no ambiente de Autor, esta conta deve ter acesso de leitura a todos os caminhos que deseja replicar.

  ATENÇÃO

  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 erros são registrados em log
  • Info: erros, avisos e outras mensagens informativas são registrados em log
  • Debug: um alto nível de detalhes é usado nas mensagens, principalmente para fins de depuração

  Padrão: Info

• Use para replicação reversa

  Indica se esse agente é usado para replicação reversa; retorna a entrada do usuário do ambiente Publicar para autor.

• Atualização do alias

  Selecionar essa opção permite solicitações de invalidação de alias ou caminho personalizado para o Dispatcher. Consulte também Configuração de um agente de limpeza do Dispatcher.

Transporte

• URI

  Especifica o servlet de recebimento no local de destino. Especificamente, você pode especificar o nome do host (ou alias) e o caminho do contexto para a instância de destino aqui.

  Por exemplo:

  • Um agente padrão pode ser replicado para https://localhost:4503/bin/receive
  • Um agente de limpeza do Dispatcher pode replicar em https://localhost:8000/dispatcher/invalidate.cache

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

  Para agentes de limpeza do Dispatcher, a propriedade do URI é usada somente se você usar entradas de hosts virtuais baseadas em caminho para diferenciar entre farms. Use esse campo para direcionar o farm a ser invalidado. Por exemplo, o farm nº 1 tem um host virtual de www.mysite.com/path1/*, e o farm nº 2 tem um host virtual de www.mysite.com/path2/*. Você pode usar um URL de /path1/invalidate.cache para direcionar o primeiro farm, e /path2/invalidate.cache para direcionar o segundo farm.

• Usuário

  O 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 quiser que certificados SSL autocertificados sejam aceitos.

• Permitir certificados expirados

  Ative se quiser que certificados SSL expirados sejam aceitos.

Proxy

As seguintes configurações só serão necessárias 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

  O 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 do proxy NTLM.

• Host do proxy NTLM

  O domínio do proxy NTLM.

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 locais ou em cluster.

• Método HTTP

  O método HTTP a ser usado.

  Para um agente de limpeza do Dispatcher, 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 agentes de limpeza do Dispatcher e especificam elementos que devem ser removidos.

  Para um agente de limpeza do Dispatcher, as três entradas padrão não devem precisar ser alteradas:

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

  Eles são usados, conforme apropriado, para indicar a ação a ser usada ao limpar a alça 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 a solicitação e, portanto, não precisam ser "codificados":

  OBSERVAÇÃO

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

• Fechar conexão

  Ative para que você possa fechar a conexão após cada solicitação.

• Tempo limite da 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 pelo tráfego após uma conexão ser 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 não será usado se um autor de conteúdo emitir uma ação de replicação.

• Em modificação

  Aqui, uma replicação por esse agente é acionada automaticamente quando uma página é modificada. Usado para agentes de limpeza do Dispatcher, mas também para replicação reversa.

• Durante roll-out

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

• Horário Ligado/Desligado atingido

  Isso aciona a replicação automática (para ativar ou desativar uma página, conforme apropriado) quando ocorrem o tempo online ou offline definido para uma página. Isso é usado principalmente para agentes de limpeza do Dispatcher.

• No recebimento

  Se marcado, as cadeias do agente serão replicadas sempre que os eventos de replicação forem recebidos.

• Sem atualização de status

  Quando marcado, o agente não força uma atualização do status de replicação.

• Sem controle de versão

  Quando marcado, o agente não força o controle da versão das páginas ativadas.

Configurar os agentes de replicação

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

Configurar os agentes de replicação no ambiente do autor

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

1. Acesse o Ferramentas no AEM.

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

3. Clique duas vezes Agentes sobre o autor (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 assim, a caixa de diálogo de configuração é aberta:

   

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

Configuração da replicação reversa

A replicação reversa é usada para obter o conteúdo do usuário gerado em uma instância de Publicação de volta para uma instância de 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 sub-rede que expõe os serviços externos a uma rede não confiável, como a Internet).

Como o ambiente de publicação geralmente está no DMZ, para retornar o conteúdo ao ambiente de autor, a conexão deve ser iniciada a partir da instância do autor. Isso é feito com:

• um caixa de saída no ambiente de Publicação onde o conteúdo é colocado.
• um agente (publicação) no ambiente Autor que pesquisa periodicamente a caixa de saída em busca de novo conteúdo.

Para fazer isso, é necessário:

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

Se quiser usar 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) - O elemento passivo, uma vez que atua como uma "caixa de saída". A entrada do usuário é colocada aqui, de onde é coletada pelo agente no ambiente do Autor.

Configuração da replicação para várias instâncias de publicação

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

Para configurar a replicação de conteúdo para uma instância de publicação adicional, crie e configure um novo agente de replicação:

1. Abra o Ferramentas no AEM.

2. Selecionar Replicação, depois Agentes sobre o autor no painel esquerdo.

3. Selecionar Novo….

4. Defina o Título e Nome e selecione Agente de replicação.

5. Clique em Criar para criar o agente.

6. Clique duas vezes no novo item de agente para que o painel de configuração seja aberto.

7. Clique em Editar - o Configurações do agente caixa de diálogo é aberta - a Tipo de serialização já estiver definido como Padrão, assim deverá permanecer.

   • No Configurações guia:

     • Ativar Ativado.

     • Insira um Descrição.

     • Defina o Tentar novamente o atraso para 60000.

     • Deixe a Tipo de serialização as Default.

   • No Transporte guia:

     • 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.

Você pode testar a operação atualizando e publicando uma página no ambiente do Autor.

As atualizações são exibidas em todas as instâncias de Publicação que foram configuradas como acima.

Se encontrar problemas, verifique os logs na instância do Author. Dependendo do nível de detalhes necessário, você também pode definir a variável Nível de registro para Debug usando o Configurações do agente como acima.

Configuração de um agente de limpeza do Dispatcher

Os agentes padrão estão incluídos na instalação. No entanto, uma determinada configuração ainda é necessária e o mesmo se aplica se você estiver definindo um novo agente:

1. Abra o Ferramentas no AEM.

2. Clique em Implantação.

3. Selecionar Replicação e depois Agentes na publicação.

4. Clique duas vezes no ícone Limpeza do Dispatcher item para abrir a visão geral.

5. Clique em Editar - o Configurações do agente caixa de diálogo se abre:

   • No Configurações guia:

     • Ativar Ativado.

     • Insira um Descrição.

     • Deixe a Tipo de serialização as Dispatcher Flushou defina-o como tal se estiver criando um agente.

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

   • No Transporte guia:

     • 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 agentes de limpeza do Dispatcher, a propriedade do URI é usada somente se você usar entradas de hosts virtuais baseadas em caminho para diferenciar entre farms. Use esse campo para direcionar o farm a ser invalidado. Por exemplo, o farm nº 1 tem um host virtual de www.mysite.com/path1/*, e o farm nº 2 tem um host virtual de www.mysite.com/path2/*. Você pode usar um URL de /path1/invalidate.cache para direcionar o primeiro farm, e /path2/invalidate.cache para direcionar o segundo farm.

   OBSERVAÇÃO

   Se você instalou o AEM em um contexto diferente do contexto padrão recomendado, configure o Cabeçalhos HTTP no Estendido guia.

6. Clique em OK.

7. Retorne para a Ferramentas , daqui é possível Ativar o Limpeza do Dispatcher agente (Agentes na publicação).

A variável Limpeza do Dispatcher O agente de replicação não está ativo no Autor. É possível 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.

Controle de 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 etc/replication nó.

Configurar os agentes de replicação do CRXDE Lite

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

Se você navegar até /etc/replication, você pode 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 só estão ativas quando esse ambiente está em execução. Por exemplo, agents.publish é usado somente no ambiente de Publicação. A captura de tela a seguir mostra o Agente de publicação no ambiente de autor, conforme incluído no WCM do AEM:

Monitoramento dos agentes de replicação

Para monitorar um agente de replicação:

1. Acesse o Ferramentas no AEM.

2. Clique em Replicação.

3. Clique duas vezes no link para agentes do ambiente apropriado (no painel esquerdo ou direito). Por exemplo, Agentes sobre o autor.

   A janela resultante mostra uma visão geral de todos os agentes de replicação para o ambiente do Autor, incluindo o destino e o status.

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

   

   Aqui você pode fazer o seguinte:

   • Veja se o agente está ativado.

   • Visualizar o destino de qualquer replicação.

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

   • Verificar se há itens na fila.

   • Atualizar ou Limpar para atualizar a exibição de entradas da fila. Isso ajuda a ver que os itens entram e saem da fila.

   • Exibir registro para acessar o registro de qualquer ação pelo agente de replicação.

   • Testar conexão para a instância de destino.

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

   ATENÇÃO

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

   Se um teste de replicação for executado para uma fila da Caixa de saída, quaisquer itens mais antigos que a replicação de teste serão reprocessados com cada replicação reversa.

   Se esses itens existirem em uma fila, poderão ser encontrados com a seguinte consulta XPath JCR e deverão 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 que o primeiro limite dos dois, com base no tempo ou tamanho, seja acionado.

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

O Editor desempacota todos os itens, salva-os e relata ao Autor.

Configuração da replicação em lote

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

Parâmetros

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

Recursos adicionais

Para obter detalhes sobre a solução de problemas, leia o Solução de problemas de replicação página.