Solucionar problemas de replicação
Objetivos de aprendizagem
Após concluir esta unidade, você estará apto a:
- Listar três tipos de problemas que você pode encontrar com replicações.
- Listar três passos que você pode seguir quando for solucionar problemas de uma replicação com falha.
- Explicar como a reversão de uma replicação funciona.
- Listar os tipos de registros que podem ajudar na solução de problemas de replicação.
- Descrever três abordagens que você pode utilizar para solucionar problemas de uma replicação travada.
Resolver falhas de replicação
Falhas de replicação podem acontecer. Quando isso ocorrer, o ideal é descobrir o motivo e traçar um plano para resolver a falha. Geralmente, é possível desfazer a replicação e começar novamente.
Se você tiver uma falha de replicação, o melhor ponto de partida para a solução do problema é analisar o status da replicação.
Para analisar o status da replicação.
- No Business Manager, clique em App Launcher (Iniciador de aplicativos) e selecione Administration (Administração) | Replication (Replicação) | Data (or Code) Replication (Replicação de dados [ou código]).
- Veja a lista de processos de replicação e seus respectivos status.
- Se você encontrar uma replicação com falha ou travada, o próximo passo é analisar os registros de replicação.
Analisar registros de replicação
Você pode analisar os registros de replicação nas instâncias de preparação e de destino para localizar mensagens de erro. Entradas que incluam "falha" ou "ORA-" podem fornecer pistas.
- Se os registros de replicação não fornecerem dados úteis, verifique os registros de erro.
- Se a replicação incluir várias tarefas, tente isolar a tarefa que causou o problema executando testes com e sem cada tarefa.
- Se a replicação de múltiplos objetos falhar, tente replicar objetos individuais para facilitar a descoberta da causa.
- Se uma replicação agendada não tiver sido executada, tente executá-la manualmente.
Desfazer uma replicação
Se os dados ou o código não forem transferidos corretamente ou estiverem incompletos, execute uma ação de desfazer. Entre em uma instância PIG para executar ou acessar uma replicação. Execute outro processo de replicação com o tipo de replicação definido como Undo (Desfazer). Isso reverte e restaura a instância de destino ao seu estado anterior. No entanto, você só pode reverter a replicação de dados ou código mais recente.
As replicações de dados e código não afetam as reversões um do outro. Por exemplo, se você executar uma replicação de dados e, em seguida, uma replicação de código, você poderá desfazer ambas as replicações.
A ação de desfazer está indisponível para processos de replicação de dados executados antes de uma versão GA, disponível ao público em geral. Por exemplo, se você executar um processo de replicação na versão 24.7, não poderá reverter a replicação após o sistema estar na versão 24.8.
Reverter uma replicação de dados
Você pode reverter o processo de replicação de dados de transferência e publicação ou apenas de publicação mais recente. Ao desfazer um processo de replicação de dados, você insere uma descrição, configura uma notificação por email e impede que o cache da página da instância de destino seja atualizado. Se quiser ignorar essas etapas, basta clicar em Undo (Desfazer) ao lado de um processo de replicação. Siga estas etapas.
- No Business Manager, clique em App Launcher (Iniciador de aplicativos) e selecione Administration (Administração) | Replication (Replicação) | Data Replication (Replicação de dados).
- Clique em Desfazer junto ao processo. Você só pode desfazer o último processo executado em uma instância.
- Selecione uma instância de destino.
- Insira uma descrição.
- Selecione o Tipo de ativação: Manual
- Select a notification email trigger: When Process Ends.
- Você pode inserir vários endereços de email de destino separados por vírgulas. As notificações por e-mail contêm a hora de início e término do processo, o sistema de destino, o tipo de replicação e as tarefas de replicação incluídas. Se a replicação falhar, a notificação incluirá o código de erro. Cada processo em uma série recorrente envia sua própria notificação.
- Você pode inserir vários endereços de email de destino separados por vírgulas. As notificações por e-mail contêm a hora de início e término do processo, o sistema de destino, o tipo de replicação e as tarefas de replicação incluídas. Se a replicação falhar, a notificação incluirá o código de erro. Cada processo em uma série recorrente envia sua própria notificação.
- Clique em Avançar.
- Selecione o tipo de replicação: Desfazer
- Clique em Avançar e revise os detalhes do processo.
- Clique em Create (Criar).
- Encontre o processo na lista e clique em Iniciar.
Reverter uma replicação de código
Você pode reverter o processo de replicação de código de transferência e ativação ou apenas de ativação mais recente. Quando você desfaz uma replicação de código, a instância de destino reverte para a versão de código anteriormente ativa. Você só pode desfazer o processo de ativação de código ou de transferência e ativação de código mais recente para a instância de destino. Siga estas etapas.
- No Business Manager, clique em App Launcher (Iniciador de aplicativos) e selecione Administration (Administração) | Replication (Replicação) | Code Replication (Replicação de código).
- Clique em Desfazer junto ao processo.
- Selecione uma instância de destino.
- Insira uma descrição.
- Selecione o Tipo de ativação: Manual
- Select a notification email trigger: When Process Ends
- Insira vários endereços de email de destino separados por vírgulas. As notificações por e-mail contêm a hora de início e término do processo, o sistema de destino, o tipo de replicação e as tarefas de replicação incluídas. Se a replicação falhar, a notificação incluirá o código de erro. Cada processo em uma série recorrente envia sua própria notificação.
- Insira vários endereços de email de destino separados por vírgulas. As notificações por e-mail contêm a hora de início e término do processo, o sistema de destino, o tipo de replicação e as tarefas de replicação incluídas. Se a replicação falhar, a notificação incluirá o código de erro. Cada processo em uma série recorrente envia sua própria notificação.
- Clique em Avançar.
- Selecione o tipo de replicação: Desfazer
- Clique em Avançar e revise os detalhes do processo.
- Clique em Create (Criar).
- Encontre o processo na lista e clique em Iniciar.
Localizar e ler registros de replicação
O processo de replicação de registros do Salesforce B2C Commerce cria arquivos de registro nos sistemas de origem e destino. Esses registros são separados dos registros de erros normais. Eles estão em: https://instance_address/on/demandware.servlet/webdav/Sites/Logs/, com nomes de arquivo como staging-blade_name-appserver-yyyymmdd.log.
Você pode monitorar o status na instância de preparação. Se um processo falhar, analise os registros da instância de preparação. Um único registro pode conter vários dias de eventos, portanto, procure um registro com a data do início do processo de replicação. O arquivo de registro tem um carimbo de data/hora semelhante àquele da tarefa de replicação de dados. Todos os nomes dos arquivos de registro contêm a instância de preparação, independentemente do tipo de instância. Veja como analisar os registros.
- No Business Manager, clique em App Launcher (Iniciador de aplicativos) e selecione Administration (Administração) | Site Development (Desenvolvimento do site) | Development Setup (Configuração de desenvolvimento.).
- Clique no link Arquivos de registro.
- Procure os registros da instância de preparação.
Veja um exemplo de uma entrada de registro: [2007-01-15 21:17:12.848 GMT] ISH-CORE-2250: New replication task "1168895828901" in domain "Sites-Site" successfully created ([2007-01-15 21:17:12.848 GMT] ISH-CORE-2250: Nova tarefa de replicação "1168895828901" no domínio "Sites-Site" foi criada com sucesso).
Concentre-se em alguns itens específicos ao analisar o arquivo de registro.
- Percorra o arquivo de registro, que contém as etapas do processo, procurando erros.
- O passo final na instância de preparação é uma entrega ao servidor de destino. O registro da instância de preparação deve ter uma linha semelhante a esta. [2019-01-15 21:27:09.783 GMT] Pipeline de preparação no sistema ativo chamado com sucesso.
- Se faltar a mensagem de sucesso, procure um erro semelhante ao seguinte. ISH-CORE-2491: Definindo estado do processo com uuid='dC8KAANna1111EOTN9h9md4' de “StartingStagingProcess” para “ErrorAcquiringEditingLocks
- Se esse erro de preparação ocorrer, faça login no Centro de controle e, em seguida, pare e reinicie a instância. Em seguida, execute a mesma replicação. O Centro de controle é uma ferramenta do Agentforce Commerce for B2C que permite monitorar o estado das instâncias do Agentforce Commerce for B2C e adotar as medidas apropriadas. Se o registro da instância de preparação não tiver erros, veja o registro de preparação na instância de destino. https://[target_instance_name]/on/demandware.servlet/webdav/Sites/Logs
- Os registros de preparação da instância de destino começam com uma mensagem como a seguinte. 2019-01-15 20:29:30.321 GMT] Copiar processo de preparação com uuid=bcFvkiaalTMxM444667bVYFqBX[2007-01-15 20:29:32.347 GMT] Iniciando StagingResources-Acquire@Sites-Site
- Dependendo de quais dados você replicou, o registro tem uma entrada para o início da cópia do banco de dados. Verifique se há erros.
- Após a replicação, revise todo o registro para ver se há erros. Se o processo for concluído com êxito, a seguinte mensagem será exibida ao final dos registros: [2019-01-15 21:31:17.434 GMT] ReplicationPublication process finished with state 'StagingProcessCompleted’ ([2019-01-15 21:31:17.434 GMT] Processo ReplicationPublication concluído com o estado 'StagingProcessCompleted').
Resolver uma replicação travada
Algumas transações de banco de dados, especialmente aquelas que envolvem dados de catálogo, levam um tempo para serem concluídas. Quando a replicação de dados permanece no estado de execução por mais tempo do que o esperado, verifique se a replicação está travada. Travada significa que a replicação não está mais em execução ou fez pouco ou nenhum progresso. Descubra se a replicação está travada e por quê para poder executá-la com sucesso.
Inspecionar a instância de preparação
Para verificar o registro de replicação mais recente na instância de preparação, siga essas etapas.
- Verifique se ele contém a linha, "Pipeline de preparação no sistema ativo chamado com sucesso." Se essa linha não estiver presente, há um problema.
- Verifique se existe uma entrada na qual um estado está definido como ErrorAcquiringEditingLocks. Caso exista, os bloqueios de recursos de um processo de replicação anterior podem não ter sido liberados, o que pode travar a replicação.
Inspecionar a instância de destino
Verifique o registro de replicação mais recente na instância de destino e role até o fim.
- Atualize a visualização algumas vezes para ver se novas entradas estão sendo adicionadas. Se nenhuma nova entrada aparecer após algum tempo, é provável que a replicação esteja travada.
- Verifique se há uma entrada indicando que o estado está definido como
ErrorAcquiringLivelocs.Essa entrada sugere que o que está bloqueando a replicação são bloqueios de recurso não liberados de um processo de replicação anterior.
- Se a última entrada de registro for uma ação de banco de dados, como INSERT ou ALTER INDEX, verifique os registros anteriores para ver quanto tempo a ação levou e qual foi a próxima entrada.
- Se a última entrada do registro começar com Rsync, o atraso pode ser devido a um grande número de arquivos de conteúdo estático alterados. Arquivos que foram movidos para uma pasta diferente são incluídos, mesmo que seu conteúdo seja o mesmo. Se Rsync estiver travado, entre em contato com o suporte ao cliente para verificar seu status.
- Se o registro mostrar o estado
ErrorLiveStagingProcessKilled, verifique se há uma implantação simultânea ou uma reinicialização da instância, o que pode interromper a replicação.
Comparar ambas as instâncias
Às vezes, você trabalha com ambas as instâncias.
- Se qualquer um dos registros contiver uma linha semelhante a recurso ocupado e obtido com o NOWAIT especificado, abra um tíquete com o suporte ao cliente e informe as etapas que você realizou para tentar solucionar o problema.
- Se o processo de replicação mostrar Completed (Concluído) na instância de destino, mas seu status ainda estiver em espera ou em andamento na instância de preparação, a instância de preparação provavelmente estava inoperante quando a replicação terminou. Reinicie a instância de preparação e verifique o status novamente.
Se você determinar que a replicação está travada, use o Centro de controle para reiniciar a instância de preparação. Certifique-se de que a replicação travada foi interrompida verificando se seu status na instância de preparação está como Failed (Falha). Depois de interrompida, execute novamente a replicação.
Se a replicação travar novamente, tente reiniciar as instâncias de destino e origem e executar a replicação novamente. Reiniciar a instância de destino interrompe todos os trabalhos em execução, retorna erros para todas as solicitações da loja e limpa todos os caches. Reinicie uma instância de produção apenas como último recurso.
Se a replicação ainda estiver travada, abra um tíquete de suporte ao cliente e informe as etapas que você realizou para tentar solucionar o problema.
Solução de problemas de limpeza de cache
Quando houver problemas com o cache da página, considere estas dicas.
- Para garantir que o problema não seja exclusivo do seu sistema, feche o navegador e limpe o cache local. Em seguida, limpe o cache manualmente no Business Manager.
- Para limpar manualmente o cache no CDN incorporado (instâncias de produção e desenvolvimento), clique em Invalidate (Invalidar) para o Entire Page Cache for Site (Cache da página inteira para o site). Você pode ignorar a limpeza do cache estático.
- Caso não veja uma mudança esperada, procure um padrão que indique um problema mais específico. Por exemplo, as imagens não estão sendo atualizadas? Se não estiverem, o provedor de imagens pode estar tendo um problema. Se um ativo de conteúdo estiver causando um problema, certifique-se de que ele foi implantado.
Resumo
Nesta unidade, você aprendeu a executar e solucionar problemas de processos de replicação do B2C Commerce. Você aprendeu a desfazer uma replicação, analisar registros de replicação, lidar com uma replicação travada e solucionar problemas de limpeza do cache.
Este emblema mostrou como executar e solucionar problemas de processos de replicação do Agentforce Commerce para B2C.
Recursos