Duplication d’environnements duplicating-environments
Introduction introduction
Vue d’ensemble overview
L’utilisation d’Adobe Campaign requiert l’installation et le paramétrage d’un ou plusieurs environnements : développement, test, pré-production, recette, production, etc.
Chaque environnement contient une instance Adobe Campaign et chaque instance Adobe Campaign est liée à une ou plusieurs bases de données. Le serveur d’applications peut exécuter un ou plusieurs processus : la quasi totalité de ces processus accèdent directement à la base de données de l’instance.
Cette section présente les procédures à appliquer pour dupliquer un environnement Adobe Campaign, c’est-à-dire pour restaurer un environnement source dans un environnement cible, et ainsi disposer de deux environnements de travail identiques.
Pour cela, les étapes sont les suivantes :
-
Créer une copie des bases de données de toutes les instances de l’environnement-source,
-
Restaurer ces copies sur toutes les instances de l’environnement-cible,
-
Exécutez le script de cautérisation nms:freezeInstance.js sur l’environnement cible avant de le démarrer.
Les serveurs et leur configuration ne sont pas impactés par cette procédure.
note NOTE Dans Adobe Campaign, une cautérisation regroupe les actions qui permettent l'arrêt des processus qui interagissent avec l'extérieur : logs, tracking, diffusions, workflows de campagnes, etc.
Cette étape est nécessaire afin de ne pas diffuser des messages plusieurs fois (une fois depuis l'environnement nominal, une fois depuis l'environnement dupliqué).note important IMPORTANT Un environnement peut contenir plusieurs instances. Chaque instance Adobe Campaign est soumise à un contrat de licence. Consultez votre contrat de licence pour connaître le nombre d’environnements dont vous disposez.
La procédure proposée ci-après vous permet de transférer un environnement sans pour autant impacter le nombre d'environnements et d'instances installées.
Avant de commencer before-you-start
Pour que le processus fonctionne, les environnements source et cible doivent comporter le même nombre d’instances, elles doivent avoir la même finalité (instance marketing, de diffusion) et des configurations similaires. La configuration technique doit correspondre aux prérequis logiciels. Les mêmes composants doivent être installés dans les deux environnements.
Mise en œuvre implementation
Procédure de transfert transfer-procedure
Nous vous proposons ici de comprendre les étapes de transfert d’un environnement-source vers un environnement-cible à travers un cas pratique : l’objectif est de restaurer un environnement de production (instance prod) dans un environnement de développement (instance recette) afin de travailler dans un contexte qui soit le plus proche possible de la plateforme ‘live’.
Les étapes ci-dessous doivent être réalisées avec précaution : certains processus peuvent être en cours lors de la copie des bases de données de l’environnement source. La procédure de cautérisation (étape 3 ci-après) permet de ne pas diffuser les messages plusieurs fois aux mêmes personnes destinataires et de conserver la cohérence des données.
- La procédure suivante est valide en langage PostgreSQL. Si le langage SQL est différent (Oracle, par exemple), les requêtes SQL doivent être adaptées.
- Dans les exemples de commandes proposés ci-après, on considère une instance prod et une instance recette existantes sous PostgreSQL.
Etape 1 - Sauvegarder les données de l’environnement-source (prod) step-1---make-a-backup-of-the-source-environment--prod--data
Copier les bases de données
Copiez tout d’abord toutes les bases de données de l’environnement source. L’opération dépend du moteur de base de données et est sous la responsabilité de l’administrateur ou de l’administratrice des bases de données.
Sous PostgreSQL, la commande est la suivante :
pg_dump mydatabase > mydatabase.sql
Etape 2 - Exporter la configuration de l’environnement cible (recette) step-2---export-the-target-environment-configuration--dev-
La plupart des éléments de configuration diffèrent d’un environnement à l’autre : comptes externes (mid-sourcing, routing, etc.), options techniques (nom de la plateforme, DatabaseId, adresses email et URL par défaut, etc.).
Avant de restaurer la base source sur la base cible, vous devez exporter la configuration de l’environnement cible (recette). Vous devez exporter le contenu des deux tables suivantes : xtk:option et nms:extaccount.
Cet export permet de conserver la configuration de la recette et de ne rafraîchir que les données de la recette (workflows, modèles, applications Web, detinataires, etc.).
Pour cela, effectuez un export de package pour les deux éléments suivants :
- Exportez la table xtk:option dans un fichier « options_dev.xml », sans les enregistrements avec les noms internes suivants : « WdbcTimeZone », « NmsServer_LastPostUpgrade » et « NmsBroadcast_RegexRules ».
- Dans un fichier « extaccount_dev.xml », exportez la table nms:extAccount pour tous les enregistrements dont l’ID n’est pas 0 (@id <> 0).
Vérifiez dans chaque fichier que le nombre d’options/de comptes exportés est égal au nombre de lignes à exporter.
Etape 3 - Arrêter l’environnement cible (recette) step-3---stop-the-target-environment--dev-
Vous devez arrêter les processus Adobe Campaign sur tous les serveurs de l’environnement cible. Cette opération dépend de votre système d’exploitation.
Vous pouvez arrêter tous les processus ou seulement ceux qui écrivent dans la base de données.
Pour arrêter tous les processus, les commandes sont les suivantes :
-
Sous Windows :
code language-none net stop nlserver6 -
Sous Linux :
code language-none /etc/init.d/nlserver6 stop
Vérifiez que tous les processus sont bien arrêtés via la commande suivante :
nlserver pdump
Vous pouvez également vérifier qu’aucun processus système ne subsiste.
Pour cela :
- Sous Windows : ouvrez le Gestionnaire des tâches et vérifiez l’absence de tout processus nlserver.exe.
- Sous Linux : exécutez la commande ps aux | grep nlserver et vérifiez l’absence de tout processus nlserver.
Etape 4 - Restaurer les bases de données dans l’environnement-cible (recette) step-4---restore-the-databases-in-the-target-environment--dev-
Pour restaurer les bases de données-sources dans l’environnement-cible, la commande est la suivante :
psql mydatabase < mydatabase.sql
Etape 5 - Cautériser l’environnement-cible (recette) step-5---cauterize-the-target-environment--dev-
Afin d’éviter tout dysfonctionnement, les processus relatifs à l’envoi des diffusions et à l’exécution des workflows ne doivent pas s’exécuter automatiquement au moment de l’activation de l’environnement-cible.
Pour cela, exécutez la commande suivante :
nlserver javascript nms:freezeInstance.js -instance:<dev> -arg:run
Etape 6 - Vérifier la cautérisation step-6---check-cauterization
-
Vérifier que le seul deliverypart est celui dont l’ID est égal à 0 :
code language-none SELECT * FROM neolane.nmsdeliverypart; -
Vérifiez que la mise à jour des statuts des diffusions est correcte :
code language-none SELECT iState, count(*) FROM neolane.nmsdelivery GROUP BY iState; -
Vérifiez que la mise à jour des statuts des workflows est correcte :
code language-none SELECT iState, count(*) FROM neolane.xtkworkflow GROUP BY iState; SELECT iStatus, count(*) FROM neolane.xtkworkflow GROUP BY iStatus;
Etape 7 - Redémarrer le processus Web de l’environnement-cible (recette) step-7---restart-the-target-environment-web-process--dev-
Sur l’environnement-cible, redémarrez les processus Adobe Campaign sur tous les serveurs.
Exécuter la commande suivant afin de démarrer le processus web :
nlserver start web
Vérifier que seul le processus web est démarré à l’aide de la commande suivante :
nlserver pdump
Vérifer visuellement que l’accès à la console client fonctionne.
Etape 8 - Importer les options et les comptes externes dans l’environnement-cible (recette) step-8---import-options-and-external-accounts-into-the-target-environment--dev-
Vérifier avant toutes choses les valeurs de plusieurs lignes des fichiers avant l’import (par exemple : ‘NmsTracking_Pointer’ pour la table des options et les comptes d’envoi ou de mid-sourcing pour la table des comptes externes).
Pour importer la configuration de la base de données de l’environnement-cible (recette) :
-
Ouvrez la console d’administration de la base de données et purgez les comptes externes (table nms:extAccount) dont l’identifiant n’est pas 0 (@id <> 0).
-
Au niveau de la console Adobe Campaign, importer le package options_recette.xml précédemment créé via la fonctionnalité d’import de package.
Vérifier que les options ont bien été mises à jour dans le noeud Administration > Plateforme > Options.
-
Au niveau de la console Adobe Campaign, importer le package extaccount_recette.xml précédemment créé via la fonctionnalité d’import de package.
Vérifier que les comptes externes ont bien été importés dans le noeud Administration > Plateforme > Comptes externes .
Etape 9 - Redémarrer l’ensemble des processus et changer les utilisateurs (recette) step-9---restart-all-processes-and-change-users--dev-
Pour démarrer les processus Adobe Campaign, les commandes sont les suivantes :
-
Sous Windows :
code language-none net start nlserver6 -
Sous Linux :
code language-none /etc/init.d/nlserver6 start
Vérifier que les processus sont bien démarrés via la commande suivante :
nlserver pdump
Changer les utilisateurs pour retrouver les utilisateurs qui existaient auparavant sur la plateforme de recette.