Assimilar conteúdo no Cloud Service ingesting-content

Processo de assimilação no Cloud Acceleration Manager ingestion-process

Siga as etapas abaixo para assimilar seu conjunto de migração usando o Cloud Acceleration Manager:

Ingestão complementar top-up-ingestion-process

A ferramenta Transferência de conteúdo tem um recurso que permite a extração de conteúdo diferencial executando um complemento do conjunto de migração. Isso permite que o conjunto de migração seja modificado para incluir somente o conteúdo que foi alterado desde a extração anterior, sem precisar extrair todo o conteúdo novamente.

Para assimilar conteúdo diferencial depois que algumas assimilações forem concluídas, execute uma Extração complementar e use o método de assimilação com a opção Apagar desabilitada. Leia a explicação Apagar acima para evitar a perda do conteúdo que já está no destino.

Comece criando uma tarefa de assimilação e verifique se Apagar está desativado durante a assimilação, conforme mostrado abaixo:

Resolução de problemas troubleshooting

O CAM não consegue recuperar o token de migração cam-unable-to-retrieve-the-migration-token

A recuperação automática do token de migração pode falhar por diferentes motivos, incluindo você configurar uma lista de permissões IP via Cloud Manager no ambiente Cloud Service de destino. Nesses cenários, você verá a seguinte caixa de diálogo ao tentar iniciar uma assimilação:

Recupere o token de migração manualmente clicando no link "Obter token" na caixa de diálogo. Outra guia é aberta exibindo o token. Em seguida, você pode copiar o token e colá-lo no campo Entrada do token de migração. Agora, você pode começar a assimilação.

Não foi possível iniciar a assimilação unable-to-start-ingestion

Você pode iniciar uma assimilação no ambiente de destino somente se pertencer ao grupo local administradores de AEM no serviço de autor do Cloud Service de destino. Se você não pertence ao grupo de administradores do AEM, você vê um erro como mostrado abaixo ao tentar iniciar uma assimilação. Você pode pedir ao administrador para adicioná-lo aos administradores do AEM local ou solicitar o token propriamente dito, que você pode colar no campo Entrada do token de migração.

Não é possível acessar o serviço de migração unable-to-reach-migration-service

Depois que uma assimilação é solicitada, uma mensagem como a seguinte pode ser apresentada ao usuário: "O serviço de migração no ambiente de destino está inacessível. Em caso afirmativo, tente novamente mais tarde ou entre em contato com o suporte do Adobe."

Esta mensagem indica que o Cloud Acceleration Manager não conseguiu acessar o serviço de migração do ambiente de destino para iniciar a assimilação. Essa situação pode ocorrer por vários motivos.

Atualizações e assimilações de versão do AEM aem-version-updates-and-ingestions

As Atualizações de Versão do AEM são aplicadas automaticamente aos ambientes para mantê-los atualizados com a versão mais recente do AEM as a Cloud Service. Se a atualização for acionada quando uma assimilação for executada, poderá causar resultados imprevisíveis, incluindo a corrupção do ambiente.

Se as "Atualizações de versão do AEM" estiverem integradas no programa de destino, o processo de assimilação tentará desativar sua fila antes de ser iniciado. Quando a assimilação é concluída, o estado do atualizador de versão retorna ao estado em que estava antes de as assimilações começarem.

Se "Atualizações de versão do AEM" estiver ativo (ou seja, as atualizações estão em execução ou estão na fila para execução), a assimilação não será iniciada e a interface do usuário apresentará a seguinte mensagem. Quando as atualizações estiverem concluídas, a assimilação poderá ser iniciada. O Cloud Manager pode ser usado para ver o estado atual dos pipelines do programa.

Falha na ingestão complementar devido a uma violação da restrição de exclusividade top-up-ingestion-failure-due-to-uniqueness-constraint-violation

Uma causa comum de uma falha de Assimilação complementar é um conflito nas IDs do nó. Para identificar esse erro, baixe o log de assimilação usando a interface do usuário do Cloud Acceleration Manager e procure uma entrada como a seguinte:

java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakConstraint0030: Propriedade violada de restrição de exclusividade [jcr:uuid] com valor a1a1a1a1-b2b2-c3c3-d4d4-e5e5e5e5e5e5: /some/path/jcr:content, /some/other/path/jcr:content

Cada nó no AEM deve ter um uuid exclusivo. Esse erro indica que um nó que está sendo assimilado tem a mesma uuid que existe em um caminho diferente na instância de destino. Essa situação pode ocorrer por dois motivos:

Este conflito deve ser resolvido manualmente. Alguém familiarizado com o conteúdo deve decidir qual dos dois nós deve ser excluído, tendo em mente outro conteúdo que faça referência a ele. A solução pode exigir que a extração complementar seja feita novamente sem o nó ofensivo.

Falha na ingestão complementar devido à impossibilidade de excluir o nó referenciado top-up-ingestion-failure-due-to-unable-to-delete-referenced-node

Outra causa comum de uma falha de Assimilação complementar é um conflito de versão para um determinado nó na instância de destino. Para identificar esse erro, baixe o log de assimilação usando a interface do usuário do Cloud Acceleration Manager e procure uma entrada como a seguinte:

java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakIntegrity0001: não é possível excluir o nó referenciado: 8a2289f4-b904-4bd0-8410-15e41e0976a8

Isso poderá acontecer se um nó no destino for modificado entre uma assimilação e uma assimilação Não apagável subsequente, de modo que uma nova versão tenha sido criada. Se o conjunto de migração foi extraído com a opção "incluir versões" ativada, pode ocorrer um conflito, pois o destino agora tem uma versão mais recente que está sendo referenciada pelo histórico de versões e outro conteúdo. O processo de assimilação não pode excluir o nó de versão incorreto porque ele está sendo referenciado.

A solução pode exigir que a extração complementar seja feita novamente sem o nó ofensivo. Ou criar um pequeno conjunto de migração do nó incorreto, mas com a opção "incluir versões" desativada.

As práticas recomendadas indicam que, se uma assimilação de Não apagável precisar ser executada usando um conjunto de migração que inclua versões, é fundamental que o conteúdo no destino seja modificado o mínimo possível, até que a jornada de migração seja concluída. Caso contrário, esses conflitos poderão ocorrer.

Falha na ingestão devido a valores grandes de propriedade de nó ingestion-failure-due-to-large-node-property-values

Os valores de propriedade do nó armazenados no MongoDB não podem exceder 16 MB. Se um valor de nó exceder o tamanho compatível, a assimilação falhará e o log conterá:

Essa é uma restrição MongoDB.

Consulte a observação Node property value in MongoDB em Pré-requisitos da Ferramenta de Transferência de Conteúdo para obter mais informações e um link para uma ferramenta Oak que possa ajudar a encontrar todos os nós grandes. Depois que todos os nós com tamanhos grandes forem corrigidos, execute a extração e a assimilação novamente.

Para evitar possivelmente essa restrição, execute o Analisador de Práticas Recomendadas na instância do AEM de origem e revise os achados apresentados, especialmente o padrão "Estrutura de Repositório Sem Suporte" (URS).

Falha de assimilação devido a erros intermitentes inesperados ingestion-failure-due-to-unexpected-intermittent-errors

Às vezes, questões intermitentes inesperadas podem se prestar a assimilações fracassadas, onde infelizmente o único recurso é tentar novamente a assimilação. Investigue o log de assimilação para descobrir a causa da falha e ver se ele está alinhado a qualquer um dos erros listados abaixo, onde uma nova tentativa deve ser feita.

Problemas do MongoDB mongo-db-issues

Ingestão cancelada ingestion-rescinded

Uma assimilação criada com uma extração em execução, à medida que seu conjunto de migração de origem aguarda pacientemente até que a extração seja bem-sucedida, e nesse ponto começa normalmente. Se a extração falhar ou for interrompida, a assimilação e seu trabalho de indexação não serão iniciados, mas serão rescindidos. Nesse caso, verifique a extração para determinar por que ela falhou, corrija o problema e comece a extrair novamente. Uma vez que a extração fixa estiver em execução, uma nova assimilação pode ser programada.

O ativo excluído não está presente após executar a assimilação novamente

Em geral, não é recomendado modificar os dados do ambiente de nuvem entre as assimilações.

Quando um ativo é excluído do destino Cloud Service usando a interface para toque do Assets, os dados do nó são excluídos, mas o blob de ativos com a imagem não é excluído imediatamente. Ele é marcado para exclusão para que não apareça mais na interface do usuário; no entanto, permanece no armazenamento de dados até que a coleta de lixo ocorra e o blob seja removido.

No cenário em que um ativo migrado anteriormente é excluído e a próxima assimilação é executada antes que o coletor de lixo conclua a exclusão do ativo, a assimilação do mesmo conjunto de migração não restaurará o ativo excluído. Quando a assimilação verifica o ambiente de nuvem para o ativo, não há dados de nó; portanto, a assimilação copiará os dados do nó para o ambiente de nuvem. No entanto, quando ele verifica o armazenamento de blob, ele vê que o blob está presente e ignora a cópia do blob. É por isso que os metadados estão presentes após a assimilação quando você observa o ativo da interface para toque, mas a imagem não está. Lembre-se de que os conjuntos de migração e a assimilação de conteúdo não foram projetados para lidar com esse caso. Eles têm como objetivo adicionar novo conteúdo ao ambiente de nuvem e não restaurar o conteúdo migrado anteriormente.

O que vem a seguir whats-next

Quando a assimilação for bem-sucedida, a indexação do AEM será iniciada automaticamente. Consulte Indexação após Migrar Conteúdo para obter mais informações.

Depois de concluir a assimilação de conteúdo no Cloud Service, você pode visualizar os registros de cada etapa (extração e assimilação) e procurar erros. Consulte Exibir Logs de um Conjunto de Migração para saber mais.