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 de Package Manager sur votre instance Adobe Experience Manager (AEM) source. 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 de terminaison suivants doivent être accessibles à partir de l’instance 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 accédant à 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 afin d’évaluer votre préparation au passage à 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 Dans Cloud Acceleration Manager, il est possible de créer un maximum de 10 jeux de migration, y compris les jeux expirés, par projet. 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 pour une période donnée, 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 points (…) pour ouvrir la liste déroulante et 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 Adobe Experience Manager (AEM) source. 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 qu'elle 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/audit
est 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
. -
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.
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/etc
dans le CTT)
-
-
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-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 :
-
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 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’apprendre ces processus, vous devez consulter Gestion de 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.