Guide de migration des ressources assets-migration-guide
Lors de la migration des ressources vers AEM, plusieurs étapes sont à prendre en compte. L’extraction de ressources et de métadonnées en dehors de leur page d’accueil actuelle ne fait pas partie du cadre de ce document, car il varie considérablement d’une mise en oeuvre à l’autre. Au lieu de cela, ce document décrit comment importer ces ressources dans AEM, appliquer leurs métadonnées, générer des rendus et activer ou publier les ressources.
Prérequis prerequisites
Avant d’exécuter l’une des étapes décrites ci-dessous, passez en revue et appliquez les instructions de la section Conseils sur l’optimisation des performances des ressources. De nombreuses étapes, telles que la configuration de tâches simultanées maximales, améliorent la stabilité et les performances du serveur en charge. D’autres étapes, telles que la configuration de l’entrepôt de données basé sur les fichiers, sont difficiles à exécuter une fois le système chargé avec des ressources.
- ACS Experience Manager Tools Tag Maker
- ACS Experience Manager Outils Importateur de ressources CSV
- Gestionnaire de processus en bloc ACS Commons
- ACS Commons Fast Action Manager
- Processus syntaxique
Migrer vers Experience Manager migrate-to-aem
La migration des ressources vers Experience Manager se déroule en plusieurs étapes et doit être considérée comme un processus échelonné. Les phases de migration sont les suivantes :
- Désactivation des workflows.
- Chargement des balises.
- Assimilation des ressources.
- Traitement des rendus.
- Activation des ressources.
- Activation des workflows.
Désactivation des workflows disable-workflows
Avant de commencer une migration, désactivez les lanceurs de la DAM Update Asset
workflow. Il est préférable d’ingérer toutes les ressources dans le système, puis d’exécuter les workflows par lots. Si vous êtes déjà en ligne pendant la migration, vous pouvez planifier l’exécution de ces activités en dehors des heures de bureau.
Chargement des balises load-tags
Vous avez peut-être déjà mis en place une taxonomie de balises que vous appliquez à vos images. Des outils tels que l’importateur de ressources CSV et la fonctionnalité de profils de métadonnées peuvent aider à automatiser l’application de balises aux ressources. Avant cela, ajoutez les balises dans Experience Manager. La fonctionnalité Experience Manager Tag Maker des outils d’ACS permet de renseigner les balises à l’aide d’une feuille de calcul Microsoft Excel chargée dans le système.
Assimilation des ressources ingest-assets
Les performances et la stabilité sont des préoccupations importantes lors de l’ingestion de ressources dans le système. Lors du chargement de nombreuses données dans Experience Manager, assurez-vous que le système fonctionne correctement. Cela a réduit le temps nécessaire à l’ajout des données et permet d’éviter de surcharger le système. Cela permet d’éviter les blocages du système, en particulier dans les systèmes déjà en production.
Le chargement des ressources dans le système peut se faire de deux façons : une approche basée sur les notifications push utilisant HTTP ou une approche basée sur les tirages utilisant les API JCR.
Pousser via HTTP push-through-http
L’équipe Managed Services d’Adobe utilise un outil appelé Glutton pour charger les données dans les environnements clients. Glutton est une petite application Java qui charge toutes les ressources d’un répertoire dans un autre sur un Experience Manager instance. À la place de Glutton, vous pouvez également utiliser des outils tels que les scripts Perl pour publier les ressources dans le référentiel.
L’utilisation de l’approche Push à l’aide du protocole HTTPS présente deux inconvénients :
- Transmettez les ressources via HTTP au serveur. Cela nécessite pas mal de temps et est chronophage, ce qui rallonge le temps nécessaire à la migration.
- Si des balises et des métadonnées personnalisées doivent être appliquées aux ressources, cette approche nécessite un deuxième processus personnalisé que vous devez exécuter pour appliquer ces métadonnées aux ressources après leur importation.
L’autre méthode d’ingestion de ressources consiste à extraire des ressources du système de fichiers local. Cependant, si vous ne pouvez pas obtenir un lecteur externe ou un partage réseau monté sur le serveur pour effectuer une approche basée sur l’extraction, la publication des ressources sur HTTP est la meilleure option.
Extraction à partir du système de fichiers local pull-from-the-local-file-system
Le ACS Experience Manager Outils Importateur de ressources CSV extrait les ressources du système de fichiers et des métadonnées des ressources à partir d’un fichier CSV pour l’importation des ressources. Le Experience Manager L’API Asset Manager est utilisée pour importer les ressources dans le système et appliquer les propriétés de métadonnées configurées. Idéalement, les ressources sont montées sur le serveur via un montage de fichiers réseau ou via un lecteur externe.
Lorsque les ressources ne sont pas transmises sur un réseau, les performances globales s’améliorent considérablement. Cette méthode est généralement la méthode la plus efficace pour charger des ressources dans le référentiel. En outre, vous pouvez importer toutes les ressources et métadonnées en une seule étape, car l’outil prend en charge l’ingestion des métadonnées. Aucune autre étape n’est nécessaire pour appliquer les métadonnées, par exemple à l’aide d’un outil distinct.
Traitement des rendus process-renditions
Après avoir chargé les ressources dans le système, vous devez les traiter via le workflow Ressources de mise à jour de gestion des actifs numériques, afin d’extraire les métadonnées et de générer les rendus. Avant d’effectuer cette étape, vous devez dupliquer et modifier le workflow Ressources de mise à jour de gestion des actifs numériques pour l’adapter à vos besoins. Certaines étapes du workflow par défaut peuvent ne pas être nécessaires, comme la génération PTIFF Dynamic Media Classic ou l’intégration du serveur d’InDesign.
Après avoir configuré le workflow en fonction de vos besoins, vous disposez de deux options pour l’exécuter :
- L’approche la plus simple consiste à utiliser l’outil Bulk Workflow Manager d’ACS Commons. Cet outil permet d'exécuter une requête et de traiter les résultats de la requête via un workflow. Il existe également des options pour définir les tailles de lots.
- Vous pouvez utiliser l’outil Fast Action Manager d’ACS Commons en association avec Synthetic Workflows. Bien que cette approche soit beaucoup plus impliquée, elle vous permet de supprimer la surcharge du moteur de processus Experience Manager, tout en optimisant l’utilisation des ressources du serveur. De plus, Fast Action Manager améliore les performances en surveillant de manière dynamique les ressources du serveur et en réduisant la charge placée sur le système. Des exemples de scripts ont été fournis sur la page de fonctionnalités d’ACS Commons.
Activation des ressources activate-assets
Pour les déploiements comportant un niveau de publication, vous devez activer les ressources vers la ferme de publication. Bien qu’Adobe recommande d’exécuter plusieurs instances de publication, il est plus efficace de répliquer toutes les ressources sur une seule instance de publication, puis de cloner cette instance. Lors de l’activation d’un grand nombre de ressources, après le déclenchement d’une activation d’arborescence, vous devrez peut-être intervenir. En effet, lors du déclenchement des activations, les éléments sont ajoutés à la file d’attente des tâches et des événements Sling. Une fois que la taille de cette file d’attente commence à dépasser environ 40 000 éléments, le traitement ralentit considérablement. Une fois que la taille de cette file d’attente dépasse 100 000 éléments, la stabilité du système commence à en pâtir.
Pour contourner ce problème, vous pouvez utiliser la variable Fast Action Manager pour gérer la réplication des ressources. Cela fonctionne sans utiliser les files d’attente Sling, réduisant la surcharge, tout en réduisant la charge de travail pour empêcher le serveur d’être surchargé. Un exemple d’utilisation de FAM pour gérer la réplication est présenté sur la page de documentation de la fonctionnalité.
D’autres options permettant de transférer des ressources vers la batterie de serveurs de publication incluent l’utilisation de vlt-rcp ou oak-run, qui sont fournis en tant qu’outils dans le cadre de Jackrabbit. Une autre option consiste à utiliser un outil open-source pour votre infrastructure Experience Manager, à savoir Grabbit, qui se targue d’être plus rapide que vlt.
Pour toutes ces approches, notez que les ressources de l’instance de création ne s’affichent pas comme ayant été activées. Pour gérer le marquage de ces ressources avec l’état d’activation correct, vous devez également exécuter un script pour les marquer comme activées.
Clonage de la publication clone-publish
Une fois les ressources activées, vous pouvez cloner votre instance de publication pour créer autant de copies que nécessaire pour le déploiement. Le clonage d’un serveur est relativement simple, mais il y a quelques étapes importantes à retenir. Pour cloner la publication :
- Sauvegardez l’instance source et la banque de données.
- Restaurez la sauvegarde de l’instance et de la banque de données à l’emplacement cible. Les étapes suivantes font toutes référence à cette nouvelle instance.
- Recherchez un système de fichiers sous
crx-quickstart/launchpad/felix
poursling.id
. Supprimez ce fichier. - Sous le chemin d’accès racine du magasin de données, recherchez et supprimez les fichiers
repository-XXX
. - Modifiez
crx-quickstart/install/org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config
etcrx-quickstart/launchpad/config/org/apache/jackrabbit/oak/plugins/blob/datastore/FileDataStore.config
pour qu’ils pointent sur l’emplacement du magasin de données sur le nouvel environnement. - Démarrez l’environnement.
- Mettez à jour la configuration de tous les agents de réplication sur le ou les auteurs pour qu’ils pointent vers les instances de publication ou les agents de vidage du dispatcher corrects sur la nouvelle instance afin qu’ils pointent vers les dispatchers appropriés pour le nouvel environnement.
Activation des workflows enable-workflows
Une fois la migration terminée, les lanceurs des workflows Ressources de mise à jour de gestion des actifs numériques doivent être réactivés pour prendre en charge la génération des rendus et l’extraction des métadonnées pour une utilisation quotidienne continue du système.
Migration des ressources à travers Experience Manager déploiements migrate-between-aem-instances
Bien que ce ne soit pas aussi courant, il est parfois nécessaire de migrer de grandes quantités de données à partir d’une seule Experience Manager à une autre instance ; par exemple, lorsque vous effectuez une Experience Manager effectuez une mise à niveau, mettez à niveau votre matériel ou migrez vers un nouveau centre de données, par exemple avec une migration AMS.
Dans ce cas, vos ressources sont déjà renseignées avec des métadonnées et des rendus sont déjà générés. Vous pouvez simplement vous concentrer sur le déplacement de ressources d’une instance à une autre. Lors de la migration entre Experience Manager vous effectuez les étapes suivantes :
-
Désactiver les workflows : Puisque vous migrez des rendus avec nos ressources, vous souhaitez désactiver les lanceurs de workflow pour les ressources de mise à jour de gestion des actifs numériques.
-
Migration des balises : Parce que des balises sont déjà chargées dans la source. Experience Manager vous pouvez les créer dans un module de contenu et installer le module sur l’instance cible.
-
Migration des ressources : Il existe deux outils recommandés pour déplacer des ressources d’une Experience Manager à une autre instance :
- Vault Remote Copy ou
vlt rcp
, vous permet d’utiliser vlt sur un réseau. Vous pouvez indiquer des répertoires source et de destination pour que vlt télécharge toutes les données du référentiel d’une instance et les charge dans l’autre. Vlt rcp est documenté à l’adresse https://jackrabbit.apache.org/filevault/rcp.html - Grabbit est un outil de synchronisation de contenu open-source développé par Time Warner Cable dans le cadre de la mise en œuvre d’Experience Manager. Comme il utilise des flux de données continus, en comparaison avec vlt rcp, sa latence est inférieure et il annonce une vitesse de deux à dix fois plus rapide que vlt rcp. Grabbit prend également en charge la synchronisation du contenu delta uniquement, ce qui lui permet de synchroniser les modifications une fois la migration initiale terminée.
- Vault Remote Copy ou
-
Activation des ressources : Suivez les instructions de la rubrique activation des ressources documenté pour la migration initiale vers AEM.
-
Clonage de la publication : comme pour une nouvelle migration, il est plus efficace de charger une seule instance de publication et de la cloner que d’activer le contenu sur les deux nœuds. Consultez Clonage de la publication.
-
Activation des workflows : Une fois la migration terminée, réactivez les lanceurs pour les workflows Ressources de mise à jour de gestion des actifs numériques afin de prendre en charge la génération de rendus et l’extraction de métadonnées pour une utilisation quotidienne continue du système.