Introdução à ferramenta Transferência de conteúdo getting-started-content-transfer-tool

Disponibilidade availability

O Content Transfer Tool pode ser baixado como arquivo zip no Portal de distribuição de software. Você pode instalar o pacote por meio do Gerenciador de Pacotes na instância do Adobe Experience Manager de origem (AEM). Baixe a versão mais recente. Para obter mais detalhes sobre a versão mais recente, consulte as Notas de versão.

Somente a versão 2.0.0 e superior é compatível, e é aconselhável usar a versão mais recente.

NOTE
Baixe a ferramenta Transferência de conteúdo no Portal de distribuição de software.

Conectividade de ambiente do Source source-environment-connectivity

NOTE
Um erro de conexão também poderá ocorrer se um conjunto de migração tiver sido excluído do Cloud Acceleration Manager.

A instância do AEM de origem pode estar sendo executada por trás de um firewall, em que ela só pode alcançar determinados hosts que foram adicionados a uma Lista de permissões. Para executar uma extração com êxito, os seguintes endpoints precisam estar acessíveis na instância que está executando o AEM:

  • O serviço de armazenamento de blobs do Azure: casstorageprod.blob.core.windows.net
NOTE
Se a extração falhar devido ao seguinte erro: "javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: falha na criação do caminho PKIX: sun.security.provider.certpath.SunCertPathBuilderException: não é possível localizar o caminho de certificação válido para o destino solicitado", isso poderá ser resolvido com a importação do certificado CA relevante.

Habilitar o registro SSL enable-ssl-logging

Às vezes, pode ser difícil entender os problemas de conexão SSL/TLS. Para solucionar problemas de conexão durante um processo de extração, você pode ativar o registro SSL por meio do Console do sistema do ambiente AEM de origem seguindo estas etapas:

  1. Navegue até o Console da Web do Adobe Experience Manager na instância de origem, indo até Ferramentas > Operações > Console da Web ou diretamente para a URL em https://serveraddress:serverport/system/console/configMgr

  2. Pesquisar por Configuração do serviço de extração da ferramenta de transferência de conteúdo

  3. Use o botão de ícone de lápis para editar seus valores de configuração

  4. Habilite a configuração Habilitar log ssl para extração e pressione Salvar:

    imagem

NOTE
Esse sinalizador é apenas para depurar problemas de SSL. Verifique se o sinalizador está desativado antes de executar a extração, pois pode exigir uma grande quantidade de espaço em disco. Isso poderia preencher a capacidade da unidade e causar falha no processo de extração.

Execução da ferramenta Transferência de conteúdo running-tool

A seção a seguir se aplica à nova versão da ferramenta Transferência de conteúdo. Siga esta seção para saber como usar a ferramenta Transferência de conteúdo para migrar conteúdo para o AEM as a Cloud Service:

Fase de configuração da extração extraction-setup-phase

  1. Faça logon no Cloud Acceleration Manager (CAM) e clique no projeto CAM criado anteriormente para avaliar sua prontidão para migrar para o AEM as a Cloud Service. Se você ainda não criou um projeto CAM, consulte Criação e gerenciamento de um projeto no CAM.

  2. Clique no cartão Transferência de conteúdo para abrir a exibição da Lista de conjuntos de migração.

    imagem

  3. Crie um Conjunto de migração clicando em Criar conjunto de migração.

    note note
    NOTE
    No máximo 10 conjuntos de migração, incluindo conjuntos expirados, podem ser criados por projeto no Cloud Acceleration Manager.

    imagem

    A caixa de diálogo a seguir é apresentada. Observe que um conjunto de migração expirará após um período prolongado de inatividade. Depois que avisos forem exibidos no cartão do projeto e as linhas da tabela de trabalhos de migração por um período, o conjunto de migração expirará e seus dados não estarão mais disponíveis. Revise a Expiração do Conjunto de Migração para obter detalhes.

    imagem

    note note
    NOTE
    O nome deve seguir as mesmas convenções de um nó AEM, portanto, não pode conter nenhum destes caracteres: . / : [ ] | *
  4. Agora você deve ver sua lista de migração na exibição de lista. Selecione o símbolo de três pontos () para abrir o menu suspenso e selecione Copiar chave de extração. Essa chave é necessária durante a fase de Extração. Copie essa chave de Extração.

    note note
    NOTE
    A chave de extração permite que o ambiente AEM de origem se conecte com segurança ao conjunto de migração. Trate essa chave com o mesmo cuidado com que você usaria uma senha e nunca a compartilhe em uma mídia não segura, como email.

    imagem

Preencher o conjunto de migração populating-the-migration-set

Para preencher o conjunto de migração criado no Cloud Acceleration Manager, instale a versão mais recente da ferramenta Transferência de conteúdo na instância de origem do Adobe Experience Manager (AEM). Para saber como preencher o conjunto de migração, siga esta seção.

  1. Depois de instalar a versão mais recente da ferramenta Transferência de conteúdo na sua instância do Adobe Experience Manager de origem, vá para Operações - Migração de conteúdo

  2. Clique em Criar Conjunto de Migração.

    imagem

  3. Cole a chave de extração que foi copiada do CAM anteriormente no campo de entrada Chave de extração do formulário Criar conjunto de migração. Depois disso, os campos Nome do conjunto de migração e Nome do projeto do Cloud Acceleration Manager (CAM) serão preenchidos automaticamente. Eles devem corresponder ao nome do Conjunto de migração no CAM e ao nome do projeto CAM que você criou. Agora é possível adicionar caminhos de conteúdo. Depois de adicionar caminhos de conteúdo, salve o conjunto de migração. Você pode executar a extração com as versões incluídas ou excluídas.

    note note
    NOTE
    Verifique se a chave de extração é válida e se não está próxima de sua expiração. Você pode obter essas informações na caixa de diálogo Criar conjunto de migração depois de colar a chave de extração. Se você receber um erro de conexão, consulte Conectividade do ambiente Source para obter mais informações.

    imagem

  4. Em seguida, selecione os seguintes Parâmetros para criar um Conjunto de Migração:

    1. Incluir versão: selecione conforme necessário. Quando as versões são incluídas, o caminho /var/audit é incluído automaticamente para migrar eventos de auditoria.

      imagem

      note note
      NOTE
      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.
    2. Caminhos a serem incluídos: use o navegador de caminhos para selecionar os caminhos que precisam ser migrados. O seletor de caminhos aceita a entrada digitando ou selecionando.

      note important
      IMPORTANT
      Os seguintes caminhos estão restritos ao criar um conjunto de migração:
      • /apps
      • /libs
      • /home
      • /etc (alguns caminhos /etc podem ser selecionados na CTT)
  5. Clique em Salvar depois de preencher todos os campos na tela de detalhes Criar conjunto de migração.

Determinação do tamanho do conjunto de migração migration-set-size

Depois de criar um conjunto de migração, é altamente recomendável executar uma verificação de tamanho no conjunto de migração antes de iniciar um processo de Extração.
Ao executar uma verificação de tamanho no conjunto de migração, é possível:

  • Determine se há espaço em disco suficiente no subdiretório crx-quickstart para concluir a extração com êxito.
  • Determine se o tamanho do conjunto de migração se enquadra nos limites do produto compatível e evite assimilações de conteúdo com falha.

Siga as etapas abaixo para executar uma verificação de tamanho:

  1. Selecione um conjunto de migração e clique em Verificar tamanho.

    imagem

  2. Isso abre a caixa de diálogo Verificar Tamanho.

    imagem

  3. Clique em Verificar Tamanho para iniciar o processo. Você retornará para a exibição da lista de conjuntos de migração e verá uma mensagem indicando que Verificar Tamanho está em execução.

    imagem

  4. Após a conclusão do processo Verificar Tamanho, o status será alterado para CONCLUÍDO. Selecione o mesmo conjunto de migração e clique em Verificar tamanho para ver os resultados. Veja abaixo um exemplo dos resultados Verificar Tamanho sem avisos.

    imagem

  5. Se os resultados da Verificação de Tamanho indicarem que há espaço em disco insuficiente, ou o conjunto de migração excede os limites do produto, ou ambos, um status de AVISO será exibido.

O que vem a seguir whats-next

Depois de aprender a criar um conjunto de migração, você estará pronto para aprender sobre os processos de extração e assimilação na ferramenta Transferência de conteúdo. Antes de aprender esses processos, você deve revisar Lidar com grandes repositórios de conteúdo para acelerar significativamente as fases de extração e assimilação da atividade de transferência de conteúdo e mover o conteúdo para o AEM as a Cloud Service.

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