Bonnes pratiques et instructions pour l’utilisation de l’outil de transfert de contenu guidelines

Exécutez nettoyage de révision et contrôles de cohérence de l’entrepôt de données sur le référentiel source afin d’identifier les problèmes potentiels et de réduire la taille du référentiel.

Au cours de la phase d’ingestion, Adobe vous recommande d’exécuter l’ingestion en activant le mode effacer où le référentiel existant (Auteur ou Publication) de l’environnement Adobe Experience Manager (AEM) Cloud Service cible est supprimé. Mettez ensuite à jour avec les données du jeu de migration. Ce mode est plus rapide que le mode sans effacement, où le jeu de migration est appliqué au-dessus du contenu actuel.

Une fois l’activité de transfert de contenu terminée, une structure de projet appropriée est nécessaire dans l’environnement Cloud Service pour s’assurer que le contenu s’affiche correctement.

Avant d’exécuter l’outil de transfert de contenu, vous devez vous assurer que l’espace disque disponible dans le sous-répertoire crx-quickstart de l’instance AEM source est suffisant. En effet, l’outil de transfert de contenu crée une copie locale du référentiel, ultérieurement chargée dans l’ensemble de migration.
La formule générale pour calculer l’espace disque disponible requis est la suivante :
data store size + node store size * 1.5

volume de stockage des données : l’outil de transfert de contenu utilise 64 Go, même si l’entrepôt de données en question est plus volumineux.

volume de stockage des nœuds : taille du répertoire de stockage des segments ou taille de la base de données MongoDB.
Ainsi, pour un volume de stockage de segments de 20 Go, l’espace disque disponible requis est de 94 Go.

Un ensemble de migration doit être conservé tout au long de l’activité de transfert de contenu pour prendre en charge les compléments de contenu. Il est possible de créer et de gérer un maximum de 10 jeux de migration par projet dans Cloud Acceleration Manager à la fois pendant l’activité de transfert de contenu. Si plus de 10 jeux de migration sont nécessaires, créez un second projet dans Cloud Acceleration Manager. Toutefois, cela nécessite une gestion de projet supplémentaire et une gouvernance hors produit afin d’éviter le remplacement de contenu sur la cible par plusieurs utilisateurs.

Évitez de modifier le répertoire d’installation de l’outil CTT. Par défaut, l’installation a lieu dans le chemin crx-quickstart/cloud-migration. Cet emplacement spécifique est utilisé en interne par d’autres bibliothèques. La modification de ce chemin d’accès peut entraîner des problèmes d’extraction.

La configuration minimale requise pour l’outil de transfert de contenu est AEM 6.3+ et Java™ 8. Si vous utilisez une version antérieure d’AEM, mettez à niveau votre référentiel de contenu vers AEM 6.5 pour utiliser l’outil de transfert de contenu.

Java doit être configuré dans l’environnement AEM, de sorte que la commande java puisse être exécutée par l’utilisateur ou l’utilisatrice démarrant AEM.

L’outil de transfert de contenu peut être utilisé avec les types de magasin de données suivants : File Data Store, S3 Data Store, Shared S3 Data Store et Azure Blob Store Data Store.

Si vous utilisez un environnement sandbox, assurez-vous que celui-ci est à jour et mis à niveau vers la dernière version. Si vous utilisez un environnement de production, il est automatiquement mis à jour.

Pour démarrer une ingestion, vous devez appartenir au groupe local AEM administrateurs dans l’instance Cloud Service vers laquelle vous transférez du contenu. Les utilisateurs non privilégiés ne peuvent pas démarrer d’ingestions sans fournir manuellement le jeton de migration.

Lorsque l’option Effacer le contenu existant sur l’instance cloud avant l’ingestion est activée, elle supprime l’intégralité du référentiel existant et crée un référentiel dans lequel ingérer du contenu. Cela signifie que tous les paramètres sont réinitialisés, y compris les autorisations relatives à l’instance Cloud Service cible. C’est également vrai pour un utilisateur administrateur ajouté au groupe administrateurs. L’utilisateur doit être rajouté au groupe administrateurs pour récupérer le jeton d’accès à l’outil de transfert de contenu.

La clé d’extraction est valide pendant 14 jours à compter du moment où elle a été créée ou renouvelée. Elle peut être renouvelée à tout moment. Si la clé d’extraction a expiré, vous ne pouvez pas effectuer d’extraction.

L’outil de transfert de contenu (CTT) n’effectue aucune analyse avant de transférer le contenu de l’instance source vers l’instance cible. Par exemple, le CTT ne fait pas de distinction entre le contenu publié et le contenu dépublié lors de l’ingestion de contenu dans un environnement de publication. Quel que soit le contenu spécifié dans l’ensemble de migration, il sera ingéré dans l’instance cible choisie. Un utilisateur peut ingérer un jeu de migration dans une instance de création ou de publication, ou les deux. Adobe recommande, lors du déplacement du contenu vers une instance de production, d’installer le CTT sur l’instance d’auteur source afin de déplacer le contenu vers l’instance d’auteur cible. De même, installez le CTT sur l’instance de publication source pour déplacer le contenu vers l’instance de publication cible. Pour en savoir plus, consultez Exécution de l’outil de transfert de contenu sur une instance de publication.

Les groupes transférés par l’outil de transfert de contenu sont uniquement les groupes requis par le contenu pour respecter les autorisations. Le processus Extraction copie l’intégralité du /home/groups dans le jeu de migration. Pour plus d’informations, voir ​ Migration de groupe ​. Le processus Ingestion copie tous les groupes référencés dans les listes de contrôle d’accès de contenu migrées. Consultez ​ Migration de groupes d’utilisateurs fermés ​ pour en savoir plus sur les groupes utilisés dans une politique de groupe d’utilisateurs fermé (CUG).

Pendant la phase d’extraction, l’outil de transfert de contenu est exécuté sur une instance source AEM active.

La phase d’ingestion de l’auteur réduit l’ensemble du déploiement de l’auteur. Cela signifie que l’AEM de création n’est pas disponible pendant tout le processus d’ingestion. Assurez-vous également qu’aucun pipeline Cloud Manager n’est exécuté pendant que vous exécutez la phase d’ingestion.

Si vous utilisez Amazon S3 ou Azure comme entrepôt de données sur le système AEM source, cet entrepôt doit être configuré de sorte que les objets blob stockés ne puissent pas être supprimés (nettoyage de la mémoire). Cela garantit l’intégrité des données d’index et un échec de ce type de configuration peut entraîner des échecs d’extraction en raison d’un manque d’intégrité de ces données d’index.

Si vous utilisez des index personnalisés, vous devez veiller à les configurer avec le nœud tika avant d’exécuter l’outil de transfert de contenu. Pour plus d’informations, voir Préparation de la nouvelle définition d’index.

Si vous avez l’intention d’effectuer des compléments, la structure de contenu du contenu existant ne doit pas changer entre le moment de l’extraction initiale et l’exécution de l’extraction de complément. Les compléments peuvent pas être exécutés sur du contenu dont la structure a été modifiée depuis l’extraction initiale. Veillez à limiter cette opération pendant le processus de migration.

Si vous envisagez d’inclure différentes versions dans un ensemble 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 ensemble de migration, vous devez effectuer l’ingestion sous la forme wipe=true.

L’outil de transfert de contenu (CTT) ne prend pas en charge les ingestions de fusion. Pour regrouper le contenu de plusieurs systèmes en une seule instance Cloud Service, seules les versions d’un système source peuvent être migrées. Ce processus nécessite l’utilisation de migrations avec le paramètre wipe=false , ce qui peut entraîner des temps d’ingestion étendus en raison de la nature incrémentielle de l’opération. Si possible, consolidez le contenu sur un seul système source avant de commencer la migration afin d’éliminer la nécessité de fusionner le contenu.

Un jeu de migration expire après une longue période d’inactivité, après laquelle ses données ne sont plus disponibles. Pour en savoir plus, veuillez consulter Expiration de l’ensemble de migration.