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:

  1. Acesse o Cloud Acceleration Manager. Clique no cartão do projeto e no cartão Transferência de conteúdo. Navegue até Tarefas de assimilação e clique em Nova assimilação

    imagem

  2. Revise a lista de verificação de assimilação e verifique se todas as etapas foram concluídas. Essas etapas são necessárias para garantir uma assimilação bem-sucedida. Vá para a página Próxima etapa somente se a lista de verificação estiver concluída.

    imagem

  3. Forneça as informações necessárias para criar uma assimilação.

    • Conjunto de migração: Selecione o conjunto de migração que contém os dados extraídos como Origem.
      • Os conjuntos de migração expirarão após um período prolongado de inatividade, de modo que é esperado que a assimilação ocorra relativamente logo após a extração ter sido realizada. Revisão Expiração do conjunto de migração para obter detalhes.
    note tip
    TIP
    Se a extração estiver em execução, a caixa de diálogo a indicará. Depois que a extração for concluída com sucesso, a assimilação será iniciada automaticamente. Se a extração falhar ou for interrompida, o trabalho de assimilação será rescindido.
    • Destino: Selecione o ambiente de destino. É nesse ambiente que o conteúdo do conjunto de migração é assimilado.

      • As assimilações não são compatíveis com destinos do tipo RDE (Rapid Development Environment, ambiente de desenvolvimento rápido) ou pré-visualização e não aparecem como uma possível escolha de destino, mesmo que o usuário tenha acesso a elas.
      • Embora um conjunto de migração possa ser assimilado em vários destinos simultaneamente, um destino pode ser o destino de apenas um em execução ou aguardando assimilação por vez.
    • Camada: Selecione a camada. (Autor/Publicação).

      • Se a origem foi Author, é recomendável assimilá-lo na Author no target. Da mesma forma, se a origem foi Publish, o target deve ser Publish também.
    note note
    NOTE
    Se a camada de destino for Author, a instância do autor é encerrada durante a duração da assimilação e fica indisponível para os usuários (por exemplo, autores ou qualquer pessoa que esteja executando a manutenção). O motivo é proteger o sistema e evitar quaisquer alterações que possam ser perdidas ou causar um conflito de assimilação. Confirme se sua equipe está ciente desse fato. Observe também que o ambiente parece hibernado durante a assimilação do autor.
    • Apagar: Escolha o Wipe value

      • A variável Limpar define o ponto inicial do destino da assimilação. Se Limpar estiver ativado, o destino, incluindo todo o conteúdo, será redefinido para a versão do AEM especificada no Cloud Manager. Se não estiver ativado, o destino mantém o conteúdo atual como ponto de partida.
      • Essa opção não NOT afetam como a assimilação do conteúdo será realizada. A assimilação sempre usa uma estratégia de substituição de conteúdo e não uma estratégia de mesclagem de conteúdo para que, em ambos Limpar e Não-apagamento nos casos, a assimilação de um conjunto de migração substituirá o conteúdo no mesmo caminho no destino. Por exemplo, se o conjunto de migração contiver /content/page1 e o destino já contém /content/page1/product1, a assimilação remove todo o page1 caminho e suas subpáginas, incluindo product1e substitua-o pelo conteúdo no conjunto de migração. Isso significa que é necessário fazer um planejamento cuidadoso ao executar um Não-apagamento assimilação para um destino que contém qualquer conteúdo que deve ser mantido.
    note important
    IMPORTANT
    Se a configuração Limpar estiver ativado para a assimilação, ele redefinirá todo o repositório existente, incluindo as permissões do usuário na instância do Cloud Service de destino. Essa redefinição também é verdadeira para um usuário administrador adicionado à variável administradores e esse usuário deverá ser adicionado ao grupo de administradores novamente para iniciar uma assimilação.
    • Pré-cópia: Escolha o Pre-copy value

      • Você pode executar a etapa opcional de pré-cópia para acelerar significativamente a assimilação. Consulte Assimilar com AzCopy para obter mais detalhes.
      • Se a assimilação com pré-cópia for usada (para S3 ou Azure Data Store), é recomendável executar Author ingestão primeiro sozinha. Isso acelera o Publish assimilação quando executada mais tarde.
    note important
    IMPORTANT
    Você pode iniciar uma assimilação no ambiente de destino somente se pertencer ao local Administradores do AEM grupo no serviço de autor do Cloud Service de destino. Se não conseguir iniciar uma assimilação, consulte Não foi possível iniciar a assimilação para obter mais detalhes.
  4. Clique em Assimilar.

    imagem

  5. Em seguida, é possível monitorar a assimilação na exibição de lista dos Trabalhos de assimilação e usar o menu de ação da assimilação para exibir as durações e registrar o progresso da assimilação.

    imagem

  6. Clique em i) botão na linha para obter mais informações sobre o trabalho de assimilação. É possível ver a duração de cada etapa da assimilação quando ela está em execução ou concluída clicando em e clicando em Exibir durações. As informações da extração também são mostradas para perceber o que está sendo assimilado.

    imagem

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 uma complementar 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.

NOTE
Após a transferência inicial do conteúdo, é recomendável fazer atualizações complementares frequentes de conteúdo diferencial para reduzir o período de congelamento de conteúdo para a transferência final de conteúdo diferencial antes de entrar online no Cloud Service. Se você tiver usado a etapa de pré-cópia para a primeira assimilação, poderá ignorar a pré-cópia para assimilações complementares subsequentes (se o tamanho do conjunto de migração complementar for menor que 200 GB). O motivo é que isso pode adicionar tempo a todo o processo.

Para assimilar conteúdo diferencial depois que algumas assimilações forem concluídas, execute um Extração complementare, em seguida, use o método de assimilação com a variável Limpar opção desabilitado. Leia as Limpar acima para evitar a perda de conteúdo que já está no destino.

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

imagem

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ê configuração de 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:

imagem

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 na Entrada do token de migração campo. Agora, você pode começar a assimilação.

NOTE
O token está disponível para usuários que pertencem ao local Administradores do AEM grupo no serviço de autor do Cloud Service de destino.

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 local Administradores do AEM grupo 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 ao local Administradores do AEM ou solicite o token propriamente dito, que você pode colar na Entrada do token de migração campo.

imagem

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."

imagem

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.

NOTE
O campo "Token de migração" é exibido porque, em alguns casos, a recuperação desse token é o que realmente não é permitido. Ao permitir que seja fornecido manualmente, ele pode permitir que o usuário inicie a assimilação rapidamente, sem nenhuma ajuda adicional. Se o token for fornecido e a mensagem ainda for exibida, a recuperação do token não foi o problema.
  • O AEM as a Cloud Service mantém o estado do ambiente e, ocasionalmente, deve reiniciar o serviço de migração por vários motivos normais. Se esse serviço estiver sendo reiniciado, ele não poderá ser acessado, mas estará disponível no futuro.
  • É possível que outro processo esteja sendo executado na instância. Por exemplo, se Atualizações de versão do AEM estiver aplicando uma atualização, o sistema poderá estar ocupado e o serviço de migração poderá ficar indisponível regularmente. Quando esse processo estiver concluído, o início da assimilação poderá ser tentado novamente.
  • Se um A Inclui na lista de permissões IP foi aplicada Por meio do Cloud Manager, ele impede que o Cloud Acceleration Manager chegue ao serviço de migração. Um endereço IP não pode ser adicionado para assimilações porque seu endereço é dinâmico. Atualmente, a única solução é desativar a inclui na lista de permissões de IP durante o processo de assimilação e indexação.
  • Pode haver outros motivos que precisem de investigação. Se a assimilação ou indexação continuar a falhar, entre em contato com o Atendimento ao cliente da Adobe.

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

Atualizações de versão do AEM são automaticamente aplicados a 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.

NOTE
Não é mais necessário registrar um tíquete de suporte para desativar a opção "Atualizações de versão do AEM".

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.

NOTE
"Atualizações de versão do AEM" é executado no pipeline do ambiente e aguarda até que o pipeline esteja limpo. Se as atualizações forem enfileiradas por mais tempo do que o esperado, verifique se um fluxo de trabalho personalizado não tem o pipeline bloqueado involuntariamente.

imagem

Falha na assimilação complementar devido à violação de restrição de exclusividade top-up-ingestion-failure-due-to-uniqueness-constraint-violation

Uma causa comum de Assimilação complementar a falha é um conflito nas ids do nó. Para identificar esse erro, baixe o log de assimilação usando a interface 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:

  • Um nó é movido na origem entre uma extração e uma Extração complementar
    • LEMBRAR: para extrações complementares, o nó ainda existirá no conjunto de migração, mesmo que não exista mais na origem.
  • Um nó no destino é movido entre uma assimilação e uma assimilação complementar subsequente.

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 assimilação complementar devido à não exclusão do nó referenciado top-up-ingestion-failure-due-to-unable-to-delete-referenced-node

Outra causa comum de uma Assimilação complementar falha é 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 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 pode acontecer se um nó no destino for modificado entre uma assimilação e uma subsequente Não-apagamento assimilação, 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 Não-apagamento a assimilação deve ser executada usando um conjunto de migração que inclua versões. é crucial 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 de assimilação devido a valores de propriedade de nós grandes 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 permitido, a assimilação falhará e o log conterá um BSONObjectTooLarge e especificar qual nó excedeu o máximo. Essa é uma restrição MongoDB.

Consulte a Node property value in MongoDB observação em Pré-requisitos para a ferramenta Transferência de conteúdo para obter mais informações e um link para uma ferramenta Oak que pode 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.

Assimilaçã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 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 a migração do 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 Visualização de logs para um conjunto de migração para saber mais.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab