Replicação replication
Os agentes de replicação são fundamentais para o Adobe Experience Manager (AEM), pois o mecanismo usado para:
- Conteúdo do Publish (ativar) de um Autor para um ambiente do Publish.
- Limpar explicitamente o conteúdo do cache do Dispatcher.
- Retorne a entrada do usuário (por exemplo, entrada de formulário) do ambiente do Publish para o ambiente do Autor (sob controle do ambiente do Autor).
As solicitações estão na fila para o agente apropriado para processamento.
Replicação do autor para o Publish replicating-from-author-to-publish
A replicação para uma instância do Publish 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, o indicador de status colorido está definido para páginas individuais.
-
o conteúdo é retirado da fila e transportado para o ambiente do Publish usando o protocolo configurado; geralmente, é HTTP.
-
um servlet no ambiente Publish recebe a solicitação e publica o conteúdo recebido; o servlet padrão é
https://localhost:4503/bin/receive
. -
vários ambientes do Author e do Publish podem ser configurados.
Replicação do Publish para o autor replicating-from-publish-to-author
Alguns recursos permitem que os usuários insiram dados em uma instância do Publish.
À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 do Publish. Devido a considerações de segurança, qualquer tráfego do Publish para o ambiente de Autor deve ser estritamente controlado.
A replicação reversa usa um agente no ambiente Publish que faz referência ao ambiente 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 os recursos do Communities (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 do Publish é difícil de sincronizar com eficiência entre instâncias AEM usando replicação.
As Comunidades AEM nunca usam replicação para UGC. Em vez disso, a implantação das Comunidades requer um armazenamento comum para UGC (consulte Armazenamento de conteúdo da comunidade).
Replicação - pronta para uso replication-out-of-the-box
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, instale o AEM com:
- o ambiente do Autor na porta
4502
- o ambiente Publish na porta
4503
- Agentes sobre Autor : Agente padrão (publicação)
- Agentes no Autor : Agente de replicação reversa (publish_reverse)
- Agentes no Publish: Replicação reversa (caixa de saída)
Consulte Monitoramento de Agentes de Replicação.
Replicação (Autor para o Publish) replication-author-to-publish
- Acesse a página de suporte no ambiente do Autor.
https://localhost:4502/content/we-retail/us/en/experience.html<pi>
- Edite a página para poder adicionar um texto novo.
- Ativar página para publicar as alterações.
- Abra a página de suporte no ambiente Publish:
https://localhost:4503/content/we-retail/us/en/experience.html - 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 padrão do Publish.
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 replication-agents-out-of-the-box
Os seguintes agentes estão disponíveis em uma instalação padrão do AEM:
-
Agente padrão
Usado para replicar do Author para o Publish. -
Liberação do Dispatcher
Isso é usado para gerenciar o cache do Dispatcher. Consulte Invalidação do cache do Dispatcher do 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 do Publish para o Author. 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
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 guiasSettings
eRules
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 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 replication-agents-configuration-parameters
Ao configurar um agente de replicação no console Ferramentas, quatro guias estarão disponíveis na caixa de diálogo:
Configurações settings
-
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 está habilitado, a fila é mostrada como:
- Ativo quando os itens estão sendo processados.
- Ocioso quando a fila está vazia.
- Bloqueado quando itens estiverem na fila, mas não puder ser processado; por exemplo, quando a fila de recebimento estiver desabilitada.
-
Tipo de Serialização
O tipo de serialização:
- Padrão: defina se o agente deve ser selecionado automaticamente.
- Liberação do Dispatcher: selecione esta opção se o agente for usado para liberar o cache do Dispatcher.
-
Repetir 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 do Publish
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
).note caution CAUTION Para um agente no ambiente de Autor, esta conta deve ter acesso de leitura a todos os caminhos que você deseja replicar. note caution CAUTION Para um agente no ambiente Publish, esta conta deve ter o acesso de criação/gravação necessário para replicar o conteúdo. note note NOTE Isso pode ser usado como um mecanismo para selecionar conteúdo específico para replicação. -
Nível de log
Especifica o nível de detalhes a ser usado para mensagens de log.
Error
: somente erros são registrados em logInfo
: erros, avisos e outras mensagens informativas estão registrados em logDebug
: um alto nível de detalhes é usado nas mensagens, principalmente para fins de depuração
Padrão:
Info
-
Usar para replicação reversa
Indica se esse agente é usado para replicação reversa; retorna a entrada do usuário do Publish para o ambiente do Autor.
-
Atualização de alias
Selecionar essa opção permite solicitações de invalidação de alias ou caminho personalizado para o Dispatcher. Além disso, consulte Configurando um Dispatcher Flush Agent.
Transporte transport
-
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 replicar para
https://localhost:4503/bin/receive
- Um agente de limpeza do Dispatcher pode replicar para
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 dewww.mysite.com/path2/*
. Você pode usar uma URL de/path1/invalidate.cache
para direcionar o primeiro farm, e/path2/invalidate.cache
para direcionar o segundo farm. - Um Agente Padrão pode replicar para
-
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 TLM
Domínio para autenticação NTML.
-
Host TLM
Host para autenticação NTML.
-
Habilitar SSL relaxado
Ative se quiser que certificados SSL autocertificados sejam aceitos.
-
Permitir certificados expirados
Ative se quiser que certificados SSL expirados sejam aceitos.
Proxy 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 NTLM de Proxy
O domínio do proxy NTLM.
Estendido extended
-
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 HTTP
Eles são usados para agentes de limpeza do Dispatcher e especificam elementos que devem ser limpos.
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":
note note NOTE 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 triggers
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.
-
Em Distribuir
Se marcado, o agente replicará automaticamente qualquer conteúdo marcado para distribuição quando for modificado.
-
Ativado/Desativado
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.
-
Ao Receber
Se marcado, as cadeias do agente serão replicadas sempre que os eventos de replicação forem recebidos.
-
Nenhuma Atualização de Status
Quando marcado, o agente não força uma atualização do status de replicação.
-
Nenhum 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 configuring-your-replication-agents
Para obter informações sobre como conectar agentes de replicação à instância do Publish usando MSSL, consulte Replicação usando SSL Mútuo.
Configurar os agentes de replicação no ambiente do autor configuring-your-replication-agents-from-the-author-environment
Na guia Ferramentas do ambiente de Autor, é possível configurar agentes de replicação que residam no ambiente de Autor (Agentes do Autor) ou no ambiente Publish (Agentes do Publish). Os procedimentos a seguir ilustram a configuração de um agente para o ambiente de Autor, mas podem ser usados para ambos.
-
Acesse a guia Ferramentas no AEM.
-
Clique em Replicação (painel esquerdo para abrir a pasta).
-
Clique duas vezes em Agentes no Autor (no painel esquerdo ou direito).
-
Clique no nome do agente apropriado (que é um link) para mostrar informações detalhadas sobre esse agente.
-
Clique em Editar para abrir a caixa de diálogo de configuração:
-
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 informações sobre parâmetros individuais).
admin
como usuário para credenciais de transporte nos agentes de replicação padrão.Configuração da replicação reversa configuring-reverse-replication
A replicação reversa é usada para obter o conteúdo do usuário gerado em uma instância do Publish de volta 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 com 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 do Publish geralmente está no DMZ, para retornar o conteúdo 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 do Publish em que 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 do Publish:
Se quiser usar replicação reversa, verifique se esse agente está ativado.
Um agente de replicação inversa no ambiente Publish (uma caixa de saída) - 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.
Configuração da replicação para várias instâncias do Publish configuring-replication-for-multiple-publish-instances
Após a instalação, um agente padrão já está configurado para replicação de conteúdo em uma instância do Publish em execução na porta 4503 do host local.
Para configurar a replicação de conteúdo para uma instância adicional do Publish, crie e configure um novo agente de replicação:
-
Abra a guia Ferramentas no AEM.
-
Selecione Replicação e depois Agentes no autor no painel esquerdo.
-
Selecione Novo….
-
Defina o Título e o Nome e selecione o Agente de Replicação.
-
Clique em Criar para criar o agente.
-
Clique duas vezes no novo item de agente para que o painel de configuração seja aberto.
-
Clique em Editar - a caixa de diálogo Configurações do Agente é aberta - o Tipo de Serialização já está definido como Padrão, e assim deve permanecer.
-
Na guia Configurações:
-
Ativar Habilitado.
-
Insira uma Descrição.
-
Defina Repetir Atraso como
60000
. -
Deixe o Tipo de Serialização como
Default
.
-
-
Na guia Transporte:
-
Insira o URI necessário para a nova instância do Publish; 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.
-
-
-
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 do Publish 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 o Nível de Log como Debug
usando a caixa de diálogo Configurações do Agente como acima.
- Configure um agente de replicação para replicar nesse ambiente Publish.
- Configurar uma conta de usuário; com os direitos de acesso necessários para ler o conteúdo replicado para esse ambiente específico do Publish.
- Atribua a conta de usuário como o ID de Usuário Agente para o agente de replicação.
Configurar um agente de limpeza do Dispatcher configuring-a-dispatcher-flush-agent
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:
-
Abra a guia Ferramentas no AEM.
-
Clique em Implantação.
-
Selecione Replicação e depois Agentes no Publish.
-
Clique duas vezes no item Liberação do Dispatcher para abrir a visão geral.
-
Clique em Editar - a caixa de diálogo Configurações do Agente será aberta:
-
Na guia Configurações:
-
Ativar Habilitado.
-
Insira uma Descrição.
-
Deixe o Tipo de Serialização como
Dispatcher Flush
ou defina-o como tal se estiver criando um agente. -
(Opcional) Selecione Atualização de alias para habilitar solicitações de invalidação de alias ou caminho personalizado para o Dispatcher.
-
-
Na guia Transporte:
-
Insira o URI necessário para a nova instância do Publish; 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 dewww.mysite.com/path2/*
. Você pode usar uma URL de/path1/invalidate.cache
para direcionar o primeiro farm, e/path2/invalidate.cache
para direcionar o segundo farm.note note NOTE Se você instalou o AEM em um contexto diferente do padrão recomendado, configure os Cabeçalhos HTTP na guia Estendido. -
-
Clique em OK.
-
Retorne à guia Ferramentas, onde é possível Ativar o agente Dispatcher Flush (Agentes no Publish).
O agente de replicação Liberação do Dispatcher não está ativo no Autor. Você pode acessar a mesma página no ambiente Publish usando o URI equivalente; por exemplo, https://localhost:4503/etc/replication/agents.publish/flush.html
.
Controle de acesso aos agentes de replicação controlling-access-to-replication-agents
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
.
Configurar os agentes de replicação do CRXDE Lite configuring-your-replication-agents-from-crxde-lite
/etc/replication
. Isso é necessário para que as ACLs associadas sejam manipuladas adequadamente. A criação de um agente de replicação em outro local da árvore pode levar a acesso não autorizado.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
contêm informações de configuração sobre o ambiente apropriado e só estão ativos quando esse ambiente está em execução. Por exemplo, agents.publish
é usado somente no ambiente Publish. A captura de tela a seguir mostra o agente do Publish no ambiente do autor, conforme incluído no WCM do AEM:
Monitoramento dos agentes de replicação monitoring-your-replication-agents
Para monitorar um agente de replicação:
-
Acesse a guia Ferramentas no AEM.
-
Clique em Replicação.
-
Clique duas vezes no link para 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 agentes de replicação para o ambiente do Autor, incluindo o destino e o status.
-
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 Log para acessar o log de quaisquer ações pelo agente de replicação.
-
Testar Conexão com a instância de destino.
-
Forçar nova tentativa em qualquer item da fila, se necessário.
note caution CAUTION Não use o link "Testar conexão" para a Caixa de saída de replicação reversa em uma instância do Publish. 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 batch-replication
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 configuring-batch-replication
- Ir para
http://serveraddress:serverport/siteadmin
- Pressione o ícone Ferramentas no lado superior da tela
- 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 padrão do Publish acessando diretamente
http://serveraddress:serverport/etc/replication/agents.author/publish.html
- Você também pode acessar o agente de replicação padrão do Publish acessando diretamente
- Pressione o botão Editar acima da fila de replicação.
- Na janela a seguir, vá para a guia Lote:
- Configure o agente.
Parâmetros parameters
Enable Batch Mode
- habilita ou desabilita o modo de replicação de loteMax 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 additional-resources
Para obter detalhes sobre solução de problemas, você pode ler a página Solução de problemas de replicação.