Tests de migration testing-the-migration

Procédure générale general-procedure

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 :

    code language-none
    nlserver javascript nms:freezeInstance.js -instance:<instance> -arg:<run|dry>
    
    note note
    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 migration-tools

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  :

    code language-none
    nlserver.exe config <option> -instance:<instance-name>
    
  • ou au niveau du postupgrade :

    code language-none
    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 :

    code language-none
    nlserver.exe config -showCustomEntities -instance:<instance-name>
    

    Exemple de message renvoyé :

    code language-none
    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é.

    code language-none
    nlserver.exe config -showDeletedEntities -instance:<instance-name>
    

    Exemple de message renvoyé :

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

Processus de vérification verification-process

Intégré en standard dans la commande de postupgrade, ce processus permet d'afficher les avertissements et erreurs qui pourraient faire échouer la migration. Si des erreurs s’affichent, la migration n’a pas été exécutée. Si cela se produit, corrigez toutes les erreurs, puis relancez l’opération de postupgrade.

Il est possible de lancer la vérification seule (sans migration) à l'aide de la commande :

nlserver.exe config -postupgrade -check -instance:<instance-name>
NOTE
Vous pouvez ignorer tous les avertissements et erreurs avec le code JST-310040.

Les expressions suivantes sont recherchées (sensibilité à la casse) :

Expression
Code erreur
Type de log
Commentaires
.@
PU-0001
Avertissement
Ce type de syntaxe n’est plus pris en charge dans la personnalisation de la diffusion.
common.js
PU-0002
Avertissement
Cette librairie ne doit pas être utilisée.
logon(
PU-0003
Avertissement
Cette méthode de connexion ne doit plus être utilisée.
new SoapMethodCall(
PU-0004
Avertissement
Cette fonction est supportée uniquement lorsqu'elle est utilisée dans du code Javascript exécuté depuis une zone de sécurité en mode sessionTokenOnly.
sql=
PU-0005
Erreur
Ce type d’erreur entraîne un échec de la migration.
crmDeploymentType="onpremise"
PU-0007
Erreur
Ce type de déploiement n’est plus pris en charge. Le type de déploiement connecteur Microsoft CRM On-premise et Office 365 est désormais obsolète.
Si vous utilisez l’un de ces types de déploiement obsolètes dans un compte externe, ce compte externe doit être supprimé et vous devez par la suite exécuter la commande postupgrade.
Pour passer au déploiement des API Web, voir la section Applications Web.
CRM v1(mscrmWorkflow/sfdcWorkflow)
PU-0008
Erreur
Les activités d’action Microsoft CRM, Salesforce, Oracle CRM On Demand ne sont plus disponibles. Pour paramétrer la synchronisation des données entre Adobe Campaign et un système CRM, vous devez utiliser l’activité de ciblage du Connecteur CRM.

Une vérification de la cohérence de la base de données et des schémas est également effectuée.

Option de restauration restoration-option

Cette option permet de restaurer les objets d'usine dans le cas où ceux-ci auraient été modifiés. Pour chaque objet restauré, une sauvegarde de vos modifications est conservée dans le dossier choisi :

nlserver.exe config -postupgrade -restoreFactory:<backupfolder> -instance:<instance-name>
NOTE
Nous vous recommandons fortement d'utiliser des chemins de dossiers absolus et de conserver l'arborescence de dossiers. Par exemple : backupFolder\nms\srcSchema\billing.xml

Reprise de la migration resuming-migration

Si vous relancez l’opération de postupgrade à la suite d’un échec de migration, celle-ci reprend là où elle s’était arrêtée.

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1