Tests de migration

Dernière mise à jour : 21 janvier 2025
  • Rubriques :

Procédure générale

Les tests de migration peuvent être effectués de différentes manières, en fonction de votre configuration.

Vous devez disposer d’un environnement de test/développement pour effectuer les tests de migration. Les environnements Adobe Campaign sont soumis à une licence : vérifiez votre contrat de licence ou contactez votre représentant Adobe.

  1. Arrêtez tous les développements en cours et reportez-les sur l'environnement de production.

  2. Effectuez une sauvegarde de la base de données correspondant à l'environnement de développement.

  3. Arrêtez tous les processus Adobe Campaign sur l'instance de développement.

  4. Effectuez une sauvegarde de la base de données de l'environnement de production et restaurez-la en tant qu'environnement de développement.

  5. Avant de redémarrer les services Adobe Campaign, exécutez le script de cautérisation freezeInstance.js permettant de nettoyer la base de données de tous les objets qui étaient en cours d'exécution au moment de la sauvegarde :

    nlserver javascript nms:freezeInstance.js -instance:<instance> -arg:<run|dry>
    NOTE
    Par défaut la commande se lance en mode dry, et liste l'ensemble des requêtes qui seront exécutées par la commande, mais sans les lancer. Pour exécuter les requêtes de cautérisation, utilisez l'argument run dans la commande.

  6. Assurez-vous que vos sauvegardes sont intègres en tentant de les restaurer. Vérifiez que vous avez bien accès à votre base de données, vos tables, vos données, etc.

  7. Testez la procédure de migration sur l'environnement de développement.

  8. Si la migration de l'environnement de développement s'est effectuée sans erreur, migrez l'environnement de production.

CAUTION
En raison de modifications effectuées sur la structure des données, l'import et l'export de packages de données entre une plateforme v5 et une plateforme v7 ne sont pas possibles.

Outils d'aide à la migration

Plusieurs options permettent de mesurer les impacts d'une migration et d'identifier les problèmes potentiels. Ces options sont à exécuter :

  • dans la commande config  :

    nlserver.exe config <option> -instance:<instance-name>

  • ou au niveau du postupgrade :

    nlserver.exe config -postupgrade <option> -instance:<instance-name>
NOTE
  • Vous devez utiliser l’option -instance:<instanceame>. Il est déconseillé d’utiliser l’option -allinstances.
  • La commande de mise à jour d’Adobe Campaign (postupgrade) permet de synchroniser les ressources, et de mettre à jour les schémas et la base de données. Cette opération ne peut être effectuée qu'une seule fois et uniquement sur le serveur applicatif. Suite à la synchronisation des ressources, la commande postupgrade permet de détecter si la synchronisation génère des erreurs ou des avertissements.

Objets non standard ou manquants

  • L'option -showCustomEntities affiche la liste de tous les objets non-standards :

    nlserver.exe config -showCustomEntities -instance:<instance-name>

    Exemple de message renvoyé :

    xtk_migration:opsecurity2 xtk:entity

  • L'option -showDeletedEntities affiche la liste de tous les objets standards manquants dans la base de données ou le système de fichiers. Pour chaque objet manquant, le chemin est indiqué.

    nlserver.exe config -showDeletedEntities -instance:<instance-name>

    Exemple de message renvoyé :

    Out of the box object 'nms:deliveryCustomizationMdl' belonging to the 'xtk:srcSchema' schema has not been found in the file system.