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 desfazer uma replicação.
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.

O que fazer com as falhas

Desde que soube da replicação, Linda Rosenberg tem executado muitos processos de replicação de dados e de código para a Cloud Kicks.

Ela encontrou alguns problemas que testaram suas habilidades de solução de problemas. Ela teve que desfazer replicações por diversos motivos. Ela teve algumas falhas e uma replicação travada. Ela também precisava de ajuda para limpar o cache. Vejamos como ela resolveu esses problemas.

O primeiro passo a ser dado com qualquer falha é ver o status de replicação.

Abra o Business Manager.
Selecione Administração > Replicação > Replicação de dados (ou de código).
Veja a lista de processos de replicação e seus respectivos status.

Vamos ver o que a Linda faz a seguir.

Problemas pós-replicação

Quando a Linda encontra um problema com uma replicação de dados, ela verifica os registros de replicação nas instâncias de preparação e de destino para ver se há mensagens de erro. Entradas que incluam "falha" ou "ORA-" podem fornecer pistas.

Se os registros de replicação não fornecerem dados úteis, ela verificará os registros de erro.
Se a replicação incluía várias tarefas, ela tenta isolar a tarefa que causou o problema executando testes com e sem cada tarefa.
Se a replicação de múltiplos objetos falhar, ela tenta replicar objetos individuais para facilitar a descoberta da causa.
Se uma replicação agendada não foi executada, ela tenta executá-la manualmente.

Desfazer uma replicação

Se o código ou os dados não foram transferidos corretamente, não foram transferidos totalmente ou estão com algum bug (no caso do código), ela pode desfazer a operação. Lembre-se, você deve estar em uma instância PIG para executar ou acessar uma replicação.

Desfazer replicação de dados

Linda 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ê pode inserir uma descrição, configurar uma notificação por e-mail e impedir que o cache da página da instância de destino seja atualizado. Se você não quiser fazer nenhuma dessas coisas, basta clicar em Desfazer ao lado de um processo de replicação. Veja como.

Abra o Business Manager.
Selecione Administração > Replicação > 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
Selecione um acionador de e-mail de notificação: Quando o processo termina
Você pode inserir vários endereços de e-mail 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 tiver ocorrido uma falha, um código de erro também será incluído. Cada processo em uma série recorrente envia sua própria notificação.
Clique em Próximo.
Selecione o tipo de replicação: Desfazer
Clique em Avançar e revise os detalhes do processo.
Clique em Criar.
Encontre o processo na lista e clique em Iniciar.

Desfazer replicação de código

Linda 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. Veja como.

Abra o Business Manager.
Selecionar Administração > Replicação > 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
Selecione um acionador de e-mail de notificação: Quando o processo termina
Você pode inserir vários endereços de e-mail 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 tiver ocorrido uma falha, um código de erro também será incluído. Cada processo em uma série recorrente envia sua própria notificação.
Clique em Próximo.
Selecione o tipo de replicação: Desfazer
Clique em Avançar e revise os detalhes do processo.
Clique em Criar.
Encontre o processo na lista e clique em Iniciar.

Registros de replicação

O Salesforce B2C Commerce grava arquivos de registro do processo de replicação nos sistemas de origem e destino. Eles 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, por exemplo, staging-blade_name-appserver-yyyymmdd.log.

Linda monitora o status na instância de preparação. Se um processo falhar, ela revisa os registros da instância de preparação. Um único registro pode conter vários dias de eventos, então ela procura 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 Linda analisa os registros.

Abra o Business Manager.
Selecione Administração > Desenvolvimento do site > Configuração de desenvolvimento.
Clique no link Arquivos de registro.
Procure os registros da instância de preparação.

Este é 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.

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 B2C Commerce que permite monitorar o estado das instâncias do B2C Commerce e tomar 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 sucesso, a seguinte mensagem será exibida no final dos registros. [2019-01-15 21:31:17.434 GMT] Processo ReplicationPublication concluído com o estado 'StagingProcessCompleted'.

Corrigir uma replicação travada

Algumas transações de banco de dados, especialmente aquelas que envolvem dados de catálogo, podem levar um tempo para serem concluídas. Quando a replicação de dados permanece no estado de execução por mais tempo do que ela espera, Linda verifica se a replicação está travada. Isso significa que a replicação não está mais em execução ou fez pouco ou nenhum progresso. Linda deve descobrir se a replicação está travada e por quê, para que ela possa executá-la com sucesso.

Verificar a instância de preparação

Ela verifica o registro de replicação mais recente na instância de preparação. Veja como.

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.

Verificar a instância de destino

Ela verifica o registro de replicação mais recente na instância de destino e rola até o fim.

Atualize a visualização algumas vezes para ver se novas entradas estão sendo adicionadas. Se nenhuma nova entrada aparecer depois de um tempo, a replicação pode estar travada.
Verifique se existe uma entrada na qual um estado está definido como ErrorAcquiringLivelocs. 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.
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 de 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, a replicação provavelmente está travada devido a uma implantação simultânea ou uma reinicialização de instância.

Verificar ambas as instâncias

Às vezes, ela 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 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 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 Linda tem problemas com o cache da página, ela considera as dicas a seguir.

Feche o navegador e limpe o cache local para garantir que o problema não seja local no seu sistema antes de limpar manualmente o cache no Business Manager.
Para limpar manualmente o cache no CDN incorporado (instâncias de produção e desenvolvimento), clique em Invalidar para o Cache de página inteira para o site. Você não precisa limpar o cache estático.
Caso não veja uma mudança esperada, procure um padrão que possa indicar 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.

Resumindo

Nesta unidade, Linda aprendeu como solucionar problemas de replicação. Ela aprendeu a desfazer uma replicação, analisar registros de replicação, lidar com uma replicação travada e solucionar problemas de limpeza de cache.

Este módulo mostrou como executar e solucionar problemas de processos de replicação do B2C Commerce. Agora responda este último teste e ganhe seu emblema!