Validar transferências de conteúdo validating-content-transfers

Introdução getting-started

Os usuários podem determinar com confiança se todo o conteúdo que foi extraído pela ferramenta Transferência de conteúdo foi assimilado com êxito na instância de destino. Esse recurso de validação funciona comparando um resumo dos caminhos de todos os nós envolvidos durante a extração, com um resumo dos caminhos de todos os nós envolvidos durante a assimilação. Se houver caminhos de nó incluídos no resumo de extração que estejam ausentes no resumo de assimilação, a validação será considerada como tendo falhado, e talvez seja necessária uma validação manual adicional.

A validação de uma transferência de conteúdo é um recurso opcional. Habilitar esse recurso aumentará o tempo necessário para executar uma extração e uma assimilação. Para usar o recurso, ative-o no Console do sistema do ambiente AEM de origem seguindo estas etapas:

Com essa configuração ativada e o ambiente AEM Cloud Service de destino executando uma versão compatível, a validação da migração ocorrerá durante toda a extração e assimilação seguintes.

Para obter mais informações sobre como instalar a Ferramenta de transferência de conteúdo, consulte Introdução à Ferramenta de transferência de conteúdo.

Como validar uma transferência de conteúdo how-to-validate-a-content-transfer

Com a validação da migração ativada no ambiente AEM de origem, comece uma extração.

Se Substituir o contêiner de preparação durante a extração estiver habilitado, todos os nós envolvidos na extração serão registrados no resumo do caminho de extração. Quando essa configuração é usada, é importante habilitar a configuração Limpar conteúdo existente na instância da nuvem antes de assimilar durante a assimilação, caso contrário, pode parecer que faltam nós no resumo da assimilação. Esses são os nós que já estão presentes no target nas assimilações anteriores.

Para obter uma ilustração gráfica, consulte os seguintes exemplos:

Exemplo 1 example-1

Exemplo 2 example-2

Quando a extração estiver concluída, comece a assimilação.

A parte superior do log de assimilação conterá uma entrada, semelhante a aem-ethos/tools:1.2.438. Verifique se o número da versão é 1.2.438 ou superior; caso contrário, a versão do AEM as a Cloud Service que você está usando não oferece suporte à validação.

Depois que a assimilação estiver concluída e a validação estiver começando, a seguinte entrada de log será anotada no log de assimilação:

Gathering artifacts for migration validation...

Os detalhes da validação seguirão esta entrada. Encontre um exemplo de uma grande migração abaixo:

Beginning publish migration validation. Migration job id=[3aba1f96-84b6-4bd0-8642-c61c0d528387]
Extraction path digest is being processed...
Extraction path digest processing took 982 seconds
Ingestion path digest is being processed...
Ingestion path digest processing took 999 seconds
Comparing the Extraction and Ingestion path digests...
----------------------------------------------------------
EXTRACTION: Number of nodes extracted: 51674784
INGESTION: Number of nodes ingested: 51674784
----------------------------------------------------------
Validation succeeded! No entries were detected to be missing from the ingestion digest.
----------------------------------------------------------
Comparing the path digests took 29 seconds
Migration validation took 33 minutes

Este é um exemplo de validação bem-sucedida, pois não havia entradas ausentes no resumo de assimilação presentes no resumo da extração.

Para comparar, veja a seguir como um relatório de validação seria exibido se a validação falhasse (ou se uma migração complementar fosse executada):

Beginning publish migration validation. Migration job id=[ac217e5a-a08d-4e81-cbd6-f39f88b174ce]
Extraction path digest is being processed...
Extraction path digest processing took 0 seconds
Ingestion path digest is being processed...
Ingestion path digest processing took 0 seconds
Comparing the Extraction and Ingestion path digests...
----------------------------------------------------------
EXTRACTION: Number of nodes extracted: 4635
INGESTION: Number of nodes ingested: 0
----------------------------------------------------------
Validation failed. However, the following nodes may already be present in the target environment.
See our Migration Validation FAQ (https://www.adobe.com/go/aem_cloud_ctt_validation_en) or open a ticket with Customer Care.
There are 4635 entries present in the extraction digest that are missing from the ingestion digest.
/content/dam/bruce
/content/dam/bruce-assets
... more paths listed (up to 10k) ...
----------------------------------------------------------
Comparing the path digests took 0 seconds
Migration validation took 0 minutes

O exemplo de falha acima foi obtido executando uma assimilação e, em seguida, executando novamente a mesma assimilação com Limpar desativado, de modo que nenhum nó estivesse envolvido durante a assimilação — tudo já estava presente no destino.

Além de ser incluído no log de assimilação, o relatório de validação também pode ser acessado da interface do usuário Trabalhos de assimilação no Cloud Acceleration Manager. Para fazer isso, clique nos três pontos (…) e clique em Relatório de validação no menu suspenso para exibir o relatório de validação.

Como validar a migração principal how-to-validate-group-migration

Consulte Migração de Grupos para ler os detalhes da migração principal e por que ela é necessária.

Depois que a extração e a assimilação forem concluídas com êxito, um resumo e um relatório da migração principal estarão disponíveis. Essas informações podem ser usadas para validar quais grupos foram migrados com êxito e, talvez, para determinar por que alguns não foram migrados.

Para exibir essas informações, acesse Cloud Acceleration Manager. Clique no cartão do projeto e no cartão Transferência de conteúdo. Navegue até Trabalhos de assimilação e localize a assimilação que você deseja verificar. Clique nos três pontos (…) dessa assimilação e clique em Exibir resumo da entidade na lista suspensa.

Você verá uma caixa de diálogo com as informações de resumo. Use os ícones de ajuda para ler uma descrição mais completa. Clique no botão Baixar relatório para baixar o relatório completo separado por vírgula (CSV). Observe também que no final deste relatório está o Relatório do usuário, que pode ser usado para o gerenciamento de usuários após a migração.

O relatório de migração principal indicará:

Resolução de problemas troubleshooting

Falha na validação. E agora? validation-fail

A primeira etapa é determinar se a assimilação realmente falhou ou se o conteúdo extraído já está presente no ambiente de destino. Isso pode ocorrer se uma assimilação for repetida com a opção Limpar conteúdo existente na instância da nuvem antes de assimilar desabilitada.

Para verificar, escolha um caminho no relatório de validação e verifique se ele está presente no ambiente de destino. Se esse for um ambiente de publicação, talvez você esteja limitado a verificar as páginas e os ativos diretamente. Abra um tíquete no Atendimento ao cliente se precisar de assistência com esta etapa.

A contagem de nós é menor do que eu esperava. Por que isso ocorre? node-count-lower-than-expected

Alguns caminhos dos resumos de extração e assimilação são excluídos de propósito para manter o tamanho desses arquivos gerenciável, com o objetivo de poder calcular o resultado da validação de migração dentro de duas horas após a conclusão da assimilação.

Os caminhos que excluímos atualmente dos resumos incluem: cqdam.text.txt representações, nós dentro de /home e nós dentro de /jcr:system.

Grupos de usuários fechados validating-cugs

Consulte Migrando Grupos de Usuários Fechados para considerações adicionais ao usar uma política de Grupo de Usuários Fechado (CUG).