Prise en main de l’outil de transfert de contenu getting-started-content-transfer-tool
Disponibilité availability
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 de détails sur la dernière version, voir Notes de mise à jour.
Seules les versions 2.0.0 et ultérieures seront prises en charge. Il est conseillé d’utiliser la version la plus récente.
Connectivité de l’environnement source source-environment-connectivity
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 qui exécute AEM :
- Le service de stockage d’objets blob Azure :
casstorageprod.blob.core.windows.net
Activation de la journalisation SSL enable-ssl-logging
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 AEM source en procédant comme suit :
-
Accédez à la console web Adobe Experience Manager sur votre instance source en sélectionnant Outils > Opérations > Console web ou directement à l’URL à l’adresse https://serveraddress:serverport/system/console/configMgr
-
Recherchez Configuration du service d’extraction de l’outil de transfert de contenu
-
Utilisez le bouton représentant un crayon pour modifier ses valeurs de configuration.
-
Activez la variable Activation de la journalisation SSL pour l’extraction , puis appuyez sur Enregistrer:
Exécution de l’outil de transfert de contenu running-tool
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 extraction-setup-phase
-
Connectez-vous à Cloud Acceleration Manager (CAM) et cliquez sur le projet CAM que vous avez créé précédemment pour évaluer votre préparation à la migration vers 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.
-
Cliquez sur la carte Transfert de contenu pour ouvrir la vue Liste des jeux de migration.
-
Créez un jeu de migration en cliquant sur Créer un jeu de migration.
note note NOTE Il est possible de créer un maximum de 10 jeux de migration, y compris les jeux ayant expiré, par projet dans Cloud Acceleration Manager. 
La boîte de dialogue suivante s’affiche. Notez qu’un jeu de migration expire 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 pendnat un certain temps, le jeu de migration expire et ses données ne sont plus disponibles. Consultez Expiration du jeu de migration pour plus d’informations.
note note NOTE Le nom doit respecter les mêmes conventions qu’un nœud AEM. Il ne peut donc pas contenir les caractères suivants : . / : [ ] | * -
Votre liste de migration doit maintenant apparaître dans la vue Liste. Sélectionnez le symbole des trois petits points (…) pour ouvrir la liste déroulante, puis sélectionnez Copier la clé d’extraction. Vous avez besoin de cette clé pendant la phase d’extraction. Copiez cette clé d’extraction.
note note NOTE 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. 
Renseignement du jeu de migration populating-the-migration-set
Pour renseigner le jeu de migration que vous avez créé dans Cloud Acceleration Manager, installez la dernière version de l’outil de transfert de contenu sur votre instance source Adobe Experience Manager (AEM). Pour savoir comment renseigner le jeu de migration, suivez cette section.
-
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.
-
Cliquez sur Créer un jeu de migration.
-
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 de Cloud Acceleration Manager (CAM) 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. Après avoir ajouté des chemins de contenu, enregistrez le jeu de migration. Vous pouvez exécuter l’extraction en incluant ou en excluant les versions.
note note NOTE 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. 
-
Sélectionnez ensuite les paramètres suivants pour créer un jeu de migration :
-
Inclure les versions : sélectionnez les options requises. Lorsque différentes versions sont incluses, le chemin d’accès
/var/auditest automatiquement inclus pour migrer les événements de contrôle.
note note NOTE 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 formewipe=true.note note NOTE À partir de la version CTT (3.0.24), de nouvelles fonctionnalités ont été incluses dans l’outil de transfert de contenu, ce qui améliore le processus d’inclusion et d’exclusion des chemins d’accès. Auparavant, les chemins d’accès devaient être sélectionnés un par un, ce qui était fastidieux et chronophage. Désormais, les utilisateurs peuvent inclure des chemins d’accès directement à partir de l’interface utilisateur ou charger un fichier CSV en fonction de leurs préférences. -
Chemins à inclure : utilisez le navigateur de chemins pour sélectionner les chemins objets de la migration. Le sélecteur de chemin accepte la saisie par saisie ou par sélection. Les utilisateurs ne peuvent sélectionner qu’une seule option pour inclure des chemins d’accès : dans l’interface utilisateur ou en chargeant un fichier CSV.
note important 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/etcdans le CTT)
-
Seule la sélection d’un chemin est autorisée, et au moins un chemin doit être présent. Si aucun chemin n’est sélectionné, une erreur de serveur se produit.
-
Lors de l’utilisation de l’option de chargement CSV, le fichier CSV doit contenir des chemins d’accès valides.
-
Pour revenir au sélecteur de chemin d’accès, les utilisateurs doivent actualiser la page et recommencer.
-
Si des chemins non valides sont trouvés dans le fichier CSV chargé, une boîte de dialogue distincte affiche les chemins non valides.
-
Les utilisateurs doivent corriger le fichier CSV et le charger à nouveau ou actualiser l’interface utilisateur pour sélectionner des chemins d’accès via le sélecteur de chemin d’accès.
-
Chemins à exclure : une nouvelle fonctionnalité permet aux utilisateurs et utilisatrices d’exclure des chemins spécifiques s’ils ou elles ne souhaitent pas les inclure. Par exemple, si le chemin d’accès dans la section d’inclusion est /content/dam, les utilisateurs peuvent désormais exclure les chemins d’accès tels que /content/dam/catalogs.
-
-
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 migration-set-size
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 pouvez :
- déterminer s’il y a suffisamment d’espace disque dans le sous-référentiel
crx-quickstartpour 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 :
-
Sélectionnez un jeu de migration et cliquez sur Vérifier la taille.
-
Cela ouvre la boîte de dialogue Vérifier la taille.
-
Cliquez sur Check Size (Vérifier la taille) pour lancer le processus. Vous revenez alors à la vue Liste jeu de migration et un message vous indique que Vérifier la taille est en cours d’exécution.
-
Une fois que le processus Vérifier la taille est terminé, le statut passe à 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.
-
Si les résultats du processus Vérifier la taille indiquent qu’il n’y a pas suffisamment d’espace disque et/ou que le jeu de migration dépasse les limites du produit, le statut AVERTISSEMENT s’affiche.
Prochaines étapes whats-next
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.