Prise en main de l’outil de transfert de contenu

Disponibilité

Il est possible de télécharger l’outil de transfert de contenu dans un fichier zip à partir du portail de distribution de logiciels. Vous pouvez installer le package par le biais du Gestionnaire de packages sur votre instance source Adobe Experience Manager (AEM). Veillez à télécharger la dernière version. Pour plus d’informations sur la dernière version, consultez les Notes de mise à jour.

Seules les versions 2.0.0 et ultérieures seront prises en charge et il est conseillé d’utiliser la version la plus récente.

REMARQUE

Téléchargez l’outil de transfert de contenu depuis le portail de distribution de logiciels.

Connectivité de l’environnement source

REMARQUE

Une erreur de connexion peut également se produire si un jeu de migration a été supprimé de Cloud Acceleration Manager.

L’instance d’AEM source peut se trouver derrière un pare-feu d’où elle ne peut atteindre que certains hôtes qui ont été ajoutés à une liste autorisée. Pour réussir l’exécution d’une extraction, les points d’entrée suivants doivent être accessibles à partir de l’instance AEM en cours d’exécution :

  • Le service d’enregistrement blob Azure : casstorageprod.blob.core.windows.net
REMARQUE

Si l’extraction échoue en raison de l’erreur suivante : "javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target", cela peut être résolu en important le certificat d’autorité de certification approprié.

Activation de la journalisation SSL

Comprendre les problèmes de connexion SSL/TLS peut parfois être difficile. Pour résoudre les problèmes de connexion lors d’un processus d’extraction, vous pouvez activer la journalisation SSL via la console système de l’environnement d’AEM source en procédant comme suit :

  1. Accédez à la console web Adobe Experience Manager sur votre instance source en accédant à Outils - Opérations - Console web ou directement à l’URL à l’adresse https://serveraddress:serverport/system/console/configMgr

  2. Recherchez Configuration du service d’extraction de l’outil de transfert de contenu

  3. Utilisez le bouton représentant un crayon pour modifier ses valeurs de configuration.

  4. Activez la variable Activation de la journalisation SSL pour l’extraction , puis appuyez sur Enregistrer:

    image

Exécution de l’outil de transfert de contenu

La section suivante s’applique à la nouvelle version de l’outil de transfert de contenu. Consultez cette section pour effectuer une migration du contenu vers AEM as a Cloud Service à l’aide de l’outil de transfert de contenu :

Phase de configuration de l’extraction

  1. Connectez-vous à Cloud Acceleration Manager (CAM) et cliquez sur le projet CAM que vous avez créé précédemment pour évaluer votre préparation à AEM as a Cloud Service. Si vous n’avez pas créé de projet CAM, reportez-vous à la section Création et gestion d’un projet dans CAM.

  2. Cliquez sur la carte Transfert de contenu. Vous accédez alors à la vue Liste des jeux de migration.

    image

  3. Créez un jeu de migration en cliquant sur Créer un jeu de migration.

    REMARQUE

    Vous pouvez créer au maximum cinq jeux de migration, y compris les jeux expirés, par projet dans Cloud Acceleration Manager.

    image

    La boîte de dialogue suivante sera présentée. Notez qu’un jeu de migration expirera après une longue période d’inactivité. Une fois les avertissements affichés sur la carte du projet et les lignes du tableau des tâches de migration pour une période donnée, le jeu de migration expirera et ses données ne seront plus disponibles. Réviser Expiration du jeu de migration pour plus d’informations.

    image

  4. Votre liste de migration doit maintenant apparaître dans la vue Liste. Cliquez sur le symbole des trois petits points () pour ouvrir la liste déroulante, puis cliquez sur Copier la clé d’extraction. Vous aurez besoin de cette clé pendant la phase d’extraction. Copiez cette clé d’extraction.

    REMARQUE

    La clé d’extraction permet à votre environnement AEM source de se connecter en toute sécurité au jeu de migration. Traitez cette clé avec le même soin que vous le feriez avec un mot de passe et ne la partagez jamais sur un support non sécurisé comme un e-mail.

    image

Renseignement du jeu de migration

Pour renseigner le jeu de migration que vous avez créé dans Cloud Acceleration Manager, vous devez installer la dernière version de l’outil de transfert de contenu sur votre instance source Adobe Experience Manager (AEM). Consultez cette section pour savoir comment renseigner le jeu de migration.

  1. Après avoir installé la dernière version de l’outil de transfert de contenu sur votre instance Adobe Experience Manager source, accédez à Opérations - Migration de contenu.

  2. Cliquez sur Créer un jeu de migration.

    image

  3. Collez la clé d’extraction qui a été copiée à partir de l’instance CAM plus tôt dans le champ d’entrée Clé d’extraction du formulaire Créer un jeu de migration. Une fois que vous avez effectué cette opération, les champs Nom du jeu de migration et Nom du projet (CAM) de Cloud Acceleration Manager sont automatiquement renseignés. Ils doivent correspondre au nom du jeu de migration dans CAM et au nom du projet CAM que vous avez créé. Vous pouvez maintenant ajouter des chemins de contenu. Une fois que vous avez ajouté des chemins de contenu, vous pouvez enregistrer le jeu de migration. Vous pouvez exécuter l’extraction en incluant ou en excluant les versions.

    REMARQUE

    Assurez-vous que la clé d’extraction est valide et n’est pas proche de son expiration. Vous pouvez obtenir ces informations dans la boîte de dialogue Créer un jeu de migration après avoir collé la clé d’extraction. Si vous obtenez une erreur de connexion, reportez-vous à Connectivité de l’environnement source pour plus d’informations.

    image

  4. Sélectionnez ensuite les paramètres suivants pour créer un jeu de migration :

    1. Inclure les versions : sélectionnez les options requises. Lorsque différentes versions sont incluses, le chemin d’accès /var/audit est automatiquement inclus pour migrer les événements de contrôle.

      image

      REMARQUE

      Si vous envisagez d’inclure différentes versions dans un jeu de migration et effectuez des compléments avec wipe=false, vous devez désactiver la purge des versions en raison d’une restriction actuelle de l’outil de transfert de contenu. Si vous préférez conserver la purge de version activée et effectuer des compléments dans un jeu de migration, vous devez effectuer l’ingestion sous la forme wipe=true.

    2. Chemins à inclure : utilisez le navigateur de chemins pour sélectionner les chemins objets de la migration. Le sélecteur de chemin accepte les entrées effectuées par saisie ou par sélection.

      IMPORTANT

      Les chemins suivants sont restreints lors de la création d’un jeu de migration :

      • /apps
      • /libs
      • /home
      • /etc (il est possible de sélectionner certains chemins /etc dans le CTT)
  5. Cliquez sur Enregistrer après avoir rempli tous les champs de l’écran Créer un jeu de migration.

Vérification de la taille du jeu de migration

Après la création d’un jeu de migration, il est vivement recommandé d’exécuter une vérification de taille sur le jeu de migration avant de lancer un processus d’extraction.
En effectuant une vérification de taille sur le jeu de migration, vous pourrez :

  • déterminer s’il y a suffisamment d’espace disque dans le sous-référentiel crx-quickstart pour terminer l’extraction ;
  • déterminer si la taille du jeu de migration est conforme aux restrictions concernant les produits pris en charge et éviter les échecs d’ingestion de contenu.

Pour exécuter une vérification de taille, procédez comme suit :

  1. Sélectionnez un jeu de migration et cliquez sur Check Size (Vérifier la taille).

    image

  2. Cela ouvrira la boîte de dialogue Check Size (Vérifier la taille).

    image

  3. Cliquez sur Check Size (Vérifier la taille) pour démarrer le processus. Vous revenez alors à la vue Liste des jeux de migration et un message vous indique que Check Size (Vérifier la taille) est en cours d’exécution.

    image

  4. Une fois que le processus Vérifier la taille est terminé, le statut passe sur TERMINÉ. Sélectionnez le même jeu de migration et cliquez sur Vérifier la taille pour afficher les résultats. Voici ci-dessous un exemple de résultats de Check Size (Vérifier la taille) sans avertissement.

    image

  5. Si les résultats de Check Size (Vérifier la taille) indiquent qu’il n’y a pas suffisamment d’espace disque ou que le jeu de migration dépasse les limites du produit, le statut WARNING (AVERTISSEMENT) s’affiche.

Prochaines étapes

Maintenant que vous avez appris à créer un jeu de migration, vous êtes prêt à en apprendre plus sur les processus d’extraction et d’ingestion dans l’outil de transfert de contenu. Avant d’en apprendre plus sur ces processus, vous devez consulter la section Gestion des référentiels de contenu volumineux pour accélérer considérablement les phases d’extraction et d’ingestion de l’activité de transfert de contenu afin de déplacer le contenu vers AEM as a Cloud Service.

Sur cette page