Diretrizes e práticas recomendadas para usar a ferramenta Transferência de conteúdo guidelines

Diretrizes e práticas recomendadas best-practices

Uma nova versão da ferramenta de Transferência de conteúdo está disponível para integrar o processo de transferência de conteúdo ao Cloud Acceleration Manager. É altamente recomendável mudar para essa nova versão para usar todos os benefícios que ela oferece:

  • Sistema de autoatendimento para extrair um conjunto de migração uma vez e assimilá-lo em vários ambientes em paralelo
  • Experiência do usuário aprimorada por meio de melhores estados de carregamento, medidas de proteção e tratamento de erros
  • Os logs de assimilação são persistentes e sempre estão disponíveis para solução de problemas

Para começar a usar a nova versão, desinstale as versões anteriores da ferramenta Transferência de conteúdo. Isso é necessário porque a nova versão vem com uma grande mudança arquitetônica. Com a versão 2.x, você cria conjuntos de migração e executa novamente a extração e a assimilação nos conjuntos.
As versões anteriores à 2.0.0 não são compatíveis e recomenda-se usar a versão mais recente.

As diretrizes e práticas recomendadas a seguir se aplicam à nova versão da ferramenta Transferência de conteúdo:

  • Execute a Limpeza de Revisão e as verificações de consistência do repositório de dados no repositório origem para que você possa identificar possíveis problemas e reduzir o tamanho do repositório.

  • Na fase de assimilação, o Adobe recomenda que você execute a assimilação usando o modo wipe ativado, no qual o repositório existente (autor ou publicação) no ambiente de Cloud Service do Adobe Experience Manager (AEM) de destino é excluído. Em seguida, atualize com os dados do conjunto de migração. Esse modo é mais rápido que o modo sem limpeza, no qual o conjunto de migração é aplicado sobre o conteúdo atual.

  • Após a conclusão da atividade de transferência de conteúdo, a estrutura correta do projeto é necessária no ambiente do Cloud Service para garantir que o conteúdo seja renderizado com êxito no ambiente do Cloud Service.

  • Antes de executar a ferramenta Transferência de conteúdo, verifique se há espaço em disco suficiente no subdiretório crx-quickstart da instância de origem do AEM. Isso ocorre porque a ferramenta Transferência de conteúdo cria uma cópia local do repositório que depois é carregada no conjunto de migração.
    A fórmula geral para calcular o espaço livre em disco necessário é a seguinte:
    data store size + node store size * 1.5

    • tamanho do armazenamento de dados: a ferramenta Transferência de conteúdo usa 64 GB, mesmo que o armazenamento de dados real seja maior.
    • tamanho do armazenamento do nó: tamanho do diretório do repositório de segmentos ou tamanho do banco de dados MongoDB.
      Assim, para um tamanho de armazenamento de segmentos de 20 GB, o espaço livre em disco necessário seria de 94 GB.
  • Um conjunto de migração deve ser mantido em toda a atividade de transferência de conteúdo para oferecer suporte a atualizações complementares de conteúdo. No máximo 20 conjuntos de migração por projeto no Cloud Acceleration Manager podem ser criados e mantidos por vez durante a atividade de transferência de conteúdo. Se mais de 20 conjuntos de migração forem necessários, crie um segundo projeto no Cloud Acceleration Manager. No entanto, isso requer gerenciamento de projetos adicional e governança fora do produto para evitar a substituição do conteúdo no público-alvo por vários usuários.

  • Evite alterar o diretório de instalação da ferramenta CTT. Por padrão, a instalação ocorre no caminho crx-quickstart/cloud-migration. Essa localização específica é usada internamente por outras bibliotecas da. A modificação desse caminho pode resultar em problemas de extração.

Considerações importantes antes de usar a ferramenta Transferência de conteúdo important-considerations

Siga a seção abaixo para entender as considerações importantes ao executar a ferramenta Transferência de conteúdo:

  • O requisito mínimo do sistema para a ferramenta Transferência de conteúdo é AEM 6.3 + e Java™ 8. Se você estiver em uma versão inferior de AEM, atualize seu repositório de conteúdo para AEM 6.5 para usar a ferramenta Transferência de conteúdo.

  • O Java™ deve ser configurado no ambiente AEM, para que o comando java possa ser executado pelo usuário que inicia o AEM.

  • A Ferramenta de transferência de conteúdo pode ser usada com os seguintes tipos de armazenamento de dados: Armazenamento de dados de arquivo, Armazenamento de dados S3, Armazenamento de dados S3 compartilhado e Armazenamento de dados do Azure Blob Store.

  • Se você estiver usando um Ambiente de sandbox, verifique se ele está atualizado e atualizado para a versão mais recente. Se você estiver usando um Ambiente de produção, ele será atualizado automaticamente.

  • Para iniciar uma assimilação, você deve pertencer ao grupo local de administradores do AEM na instância Cloud Service para a qual você está transferindo conteúdo. Usuários sem privilégios não podem iniciar assimilações sem fornecer manualmente o token de migração.

  • Se a opção Limpar conteúdo existente na instância da nuvem antes da assimilação estiver habilitada, ela excluirá todo o repositório existente e criará um novo repositório para assimilar conteúdo. Isso significa que ele redefine todas as configurações, incluindo permissões na instância do Cloud Service de destino. Também é verdadeiro para um usuário administrador adicionado ao grupo administradores. O usuário deve ser lido no grupo administradores para recuperar o token de acesso para a ferramenta Transferência de conteúdo.

  • As assimilações não são compatíveis com a mesclagem de conteúdo de várias fontes na instância do Cloud Service de destino se o conteúdo das duas fontes for movido para os mesmos caminhos no destino. Para mover o conteúdo de várias fontes para uma única ocorrência de Cloud Service de destino, certifique-se de que não haja sobreposição dos caminhos de conteúdo das fontes.

  • A chave de extração é válida por 14 dias a partir do momento em que foi criada ou renovada. Ele pode ser renovado a qualquer momento. Se a chave de extração tiver expirado, não será possível executar uma extração.

  • A ferramenta Transferência de conteúdo (CTT) não executa nenhum tipo de análise de conteúdo antes de transferir o conteúdo da instância de origem para a instância de destino. Por exemplo, a CTT não diferencia entre conteúdo publicado e não publicado enquanto assimila conteúdo em um ambiente do Publish. Qualquer conteúdo especificado no conjunto de migração é assimilado na instância de destino escolhida. O usuário pode assimilar um conjunto de migração em uma instância do Autor ou do Publish, ou em ambas. O Adobe recomenda que, ao mover o conteúdo para uma instância de Produção, a CTT seja instalada na instância do Autor de origem para mover o conteúdo para a instância do Autor de destino. E, da mesma forma, instale a CTT na instância do Publish de origem para mover o conteúdo para a instância do Publish de destino. Consulte Executando a Ferramenta de Transferência de Conteúdo em uma instância do Publish para obter mais detalhes.

  • Os usuários e grupos transferidos pela ferramenta Transferência de conteúdo são apenas aqueles exigidos pelo conteúdo para atender às permissões. O processo Extração copia a /home inteira para o conjunto de migração e faz o Mapeamento de usuários adicionando um campo feito do endereço de email de cada usuário. Para obter mais informações, consulte Mapeamento de Usuário e Migração de Entidade de Segurança. O processo Assimilação copia todos os usuários e grupos referenciados nas ACLs de conteúdo migradas. Consulte Migrando Grupos de Usuários Fechados para considerações adicionais sobre grupos usados em uma política de Grupo Fechado de Usuários (CUG).

  • Durante a fase de extração, a ferramenta Transferência de conteúdo é executada em uma instância de origem do AEM ativa.

  • A Fase de assimilação do autor reduz toda a implantação do autor. Significa que o AEM do autor não está disponível durante todo o processo de ingestão. Além disso, certifique-se de que nenhum pipeline do Cloud Manager seja executado enquanto você estiver executando a fase Assimilação.

  • Ao usar Amazon S3 ou Azure como o armazenamento de dados no sistema AEM de origem, o armazenamento de dados deve ser configurado para que os blobs armazenados não possam ser excluídos (coleta de lixo). Isso garante a integridade dos dados do índice, e a falha na configuração dessa maneira pode resultar em extrações com falha devido à falta de integridade desses dados de índice.

  • Se estiver usando índices personalizados, certifique-se de configurar os índices personalizados com o nó tika antes de executar a Ferramenta de transferência de conteúdo. Consulte Preparando a Nova Definição de Índice para obter mais detalhes.

  • Se você pretende fazer atualizações complementares, a estrutura de conteúdo do conteúdo existente não deve mudar do momento em que a extração inicial é realizada até quando a extração complementar é executada. Os complementos não podem ser executados em um conteúdo cuja estrutura foi alterada desde a extração inicial. Restrinja isso durante o processo de migração.

  • Se você pretende incluir versões como parte de um conjunto de migração e estiver executando atualizações com wipe=false, desative a limpeza de versões devido a uma limitação atual na Ferramenta de transferência de conteúdo. Se preferir manter a limpeza de versão habilitada e estiver executando atualizações complementares em um conjunto de migração, você deve executar a assimilação como wipe=true.

  • Um conjunto de migração expira após um período prolongado de inatividade, após o qual seus dados não estarão mais disponíveis. Revise a Expiração do Conjunto de Migração para obter mais detalhes.

O que vem a seguir whats-next

Depois de conhecer as diretrizes, as práticas recomendadas e as considerações importantes sobre o uso da ferramenta Transferência de conteúdo, você estará pronto para instalar e usar a ferramenta, começando com a criação de um conjunto de migração. Consulte Introdução à ferramenta de transferência de conteúdo.

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