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.
Téléchargez l’outil de transfert de contenu depuis le portail de distribution de logiciels.
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 :
casstorageprod.blob.core.windows.net
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é.
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 :
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:
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 :
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.
Cliquez sur la carte Transfert de contenu. Vous accédez alors à la vue Liste des jeux de migration.
Créez un jeu de migration en cliquant sur Créer un jeu de migration.
Vous pouvez créer au maximum cinq jeux de migration, y compris les jeux expirés, par projet dans Cloud Acceleration Manager.
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.
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.
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.
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.
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 (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.
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/audit
est automatiquement inclus pour migrer les événements de contrôle.
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
.
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.
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.
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 :
crx-quickstart
pour terminer l’extraction ;Pour exécuter une vérification de taille, procédez comme suit :
Sélectionnez un jeu de migration et cliquez sur Check Size (Vérifier la taille).
Cela ouvrira la boîte de dialogue Check Size (Vérifier la taille).
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.
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.
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.
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.