Réalisation d'un upgrade de build performing-a-build-upgrade
Cette section présente la procédure détaillée pour réaliser un upgrade et les étapes nécessaires pour identifier et résoudre les conflits.
L'upgrade du build doit être effectué avec précaution. Les effets de l'upgrade doivent être entièrement étudiés au préalable et la procédure doit être suivie à la lettre. Pour garantir la réussite d'un upgrade, veillez à ce que seuls les utilisateurs experts effectuent la procédure décrite ci-dessous. De plus, il est vivement recommandé de contacter l'Assistance clientèle d'Adobe avant de commencer un upgrade.
Les prérequis suivants doivent être remplis :
- maîtrise de l'architecture de Campaign ;
- connaissances des systèmes et du côté serveur,
- Autorisations et droits administratifs.
Vous trouverez plus d’informations dans ces sections : Mise à jour d’Adobe Campaign, Migration vers une nouvelle version.
Pour les instances hybrides et hébergées, vous devez demander une mise à niveau de version à l'équipe d'exploitation technique Adobe. Pour plus d'informations, reportez-vous à la section Questions fréquentes située au bas de cette page. Consultez également le FAQ sur la mise à niveau des builds.
Préparer l'upgrade
Avant de commencer l'upgrade de build, vous devez effectuer une préparation complète, comme décrit ci-après.
Une fois le système prêt, un upgrade de build dure au moins 2 heures.
L'upgrade de build requiert les ressources suivantes :
- Un architecte Adobe : pour comprendre les structures de base de données (schémas d'usine et autres schémas ajoutés, conceptions de campagnes et fonctionnalités de chemin critique devant être démarrées et testées dans un ordre spécifique).
- Un chef de projet : dans le cas où l'upgrade de build implique plusieurs instances différentes (production, staging, test) et d'autres serveurs et applications tiers (bases de données, sites SFTP, fournisseurs de services de messagerie), il est recommandé de faire appel à un chef de projet pour coordonner tous les tests.
- Un administrateur Adobe Campaign : votre administrateur connaît la configuration du serveur, notamment : la sécurité, la disposition des dossiers, le reporting et les exigences en matière d'import et d'export. N'effectuez pas d'upgrade de build sans l'aide de votre administrateur.
- Un opérateur Adobe Campaign (utilisateur marketing) : la réussite d'un upgrade dépend de la capacité d'un utilisateur à effectuer correctement ses tâches quotidiennes. Pour cette raison. incluez , toujours au moins un de vos opérateurs quotidiens dans vos tests des serveurs mis à jour.
Planification
Voici les points essentiels pour planifier un upgrade de build :
- Réservez au moins deux heures à l'upgrade.
- Communiquez les coordonnées de l'équipe Adobe et du personnel du client.
- Pour les instances hébergées : l'équipe Adobe et le personnel du client coordonneront l'heure et le responsable de l'exécution de l'upgrade.
- Pour les instances on-premise : le personnel du client gère la totalité du processus. S'il a besoin d'aide pour les tests des workflows personnalisés et la logique des diffusions, il doit faire appel aux services de consulting.
- Déterminez et confirmez la version vers laquelle vous souhaitez mettre à jour Adobe Campaign. Consultez les notes de mise à jour d'Adobe Campaign Classic.
- Vérifiez que vous possédez les exécutables pour l'upgrade.
Acteurs clés
L'upgrade de build requiert l'implication des personnes suivantes :
-
Architecte Adobe : l’architecte doit se charger de la coordination avec l’assistance clientèle d’Adobe Campaign en cas d’architecture hébergée ou hybride.
-
Chef de projet :
-
Pour les installations On Premise : le chef de projet interne du client dirige l'upgrade et gère les tests de cycle de vie.
-
pour les installations hébergées : l'équipe d'hébergement s'associera à l'équipe de l'Assistance clientèle d’Adobe Campaign et au client pour coordonner le calendrier de l’upgrade pour toutes les instances.
-
-
Administrateur Adobe Campaign :
-
Pour les installations On-Premise : l'administrateur effectue l'upgrade.
-
Pour les installations hébergées : l'équipe chargée de l'hébergement effectue l'upgrade.
-
-
Opérateur Adobe Campaign\utilisateur marketing : l'opérateur effectue des tests sur les instances de développement, de test et de production.
Préparer l'upgrade de build
Avant de commencer l'upgrade de build, les clients On-Premise doivent effectuer la préparation suivante :
-
Vérifiez que tout travail de développement peut être exporté avant l'upgrade. Exportez-le sous la forme de packages.
-
Effectuez une sauvegarde complète des bases de données pour toutes les instances des environnements source et cible.
-
Obtenez la dernière version du fichier de configuration du serveur.
Vous devez également connaître toutes les lignes de commande utiles avant de commencer un upgrade de build :
- nlserver pdump : répertorie les processus en cours d'exécution.
- nlserver pdump -who : répertorie les sessions clientes actives.
- nlserver monitor -missing : répertorie les propriétés manquantes.
- nlserver start process@instance-name : démarre un processus.
- nlserver stop process@instance-name : arrête un processus.
- nlserver restart process@instance-name : redémarre un processus.
- nlserver shutdown : arrête tous les processus de Campaign.
- nlserver watchdog -svc : démarre le processus watchdog (UNIX uniquement).
Réaliser l'upgrade
Seuls les clients On-Premise doivent suivre ces procédures. Pour les clients hébergés, elles sont gérées par l'équipe d'hébergement. Pour mettre à jour Adobe Campaign vers un nouveau build, les étapes suivantes doivent être effectuées.
Dupliquer l'environnement
Cette section décrit comment dupliquer un environnement Adobe Campaign, afin de restaurer un environnement-source dans un environnement-cible, et ainsi disposer de deux environnements de travail identiques.
Pour ce faire, procédez comme suit :
-
Créez une copie des bases de données de toutes les instances de l'environnement-source.
-
Restaurez 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 sa mise en route (cela permettra l'arrêt de tous les processus qui interagissent avec l'extérieur : logs, tracking, diffusions, workflows de campagne, etc.).
code language-none nlserverjavacsriptnms:freezeInstance.js–instance:<dev> -arg:run -
Vérifiez la cautérisation, comme suit :
-
Vérifiez que le seul fragment de diffusion (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 iSate, count(*) FROM neolane.nmsdeliveryGroup By iProd; -
Vérifiez que la mise à jour des statuts des workflows est correcte :
code language-none SELECT iState, count (*) FROM neolane.xtkworkflowGROUP BY iState; SELECT iStatus, count (*) FROM neolane.xtkworkflowGROUP BY iStatus;
-
Arrêter les services
Afin de pouvoir remplacer tous les fichiers par la nouvelle version, il est nécessaire d'arrêter toutes les instances du service nlserverservice.
-
Arrêtez les services suivants :
- Services web (IIS) : iisreset /stop
- service Adobe Campaign : net stop nlserver6
note note NOTE Assurez-vous que le serveur de redirection (webmdl) est arrêté afin que le fichier nlsrvmod.dll, qui est utilisé par IIS, puisse être remplacé par la nouvelle version. -
Assurez-vous qu'aucune tâche n'est active à l'aide de la commande nlserver pdump. Si aucune tâche n'est active, la sortie doit ressembler à celle-ci :
code language-none C:\<installation path>\bin>nlserverpdump HH:MM:SS > Application Server for Adobe Campaign version x.x (build xxx) dated xx/xx/xxxx No tasks -
Vérifiez le Gestionnaire de tâches de Windows afin de vous assurer que tous les processus sont arrêtés.
Mettre à jour l'application serveur Adobe Campaign
-
Exécutez le fichier Setup.exe. Si vous devez télécharger ce fichier, accédez au Centre de téléchargement.
-
Sélectionnez le mode d'installation : Mise à jour ou Réparation.
-
Cliquez sur Suivant.
-
Cliquez sur Terminer : le programme d'installation copie alors les nouveaux fichiers.
-
Lorsque l'opération est terminée, cliquez sur Terminer.
Synchroniser les ressources
-
Ouvrez la ligne de commande.
-
Exécutez la commande nlserver config -postupgrade -allinstances afin d'effectuer les opérations suivantes :
- synchroniser les ressources,
- mettre à jour les schémas,
- mettre à jour la base de données.
note note NOTE Cette opération n'est à effectuer qu'une seule fois et uniquement sur un serveur applicatif nlserverweb. Pour n'effectuer la synchronisation que sur une seule base, utilisez la commande suivante :
code language-none nlserver config -postupgrade -instance: <instance_name> -
Vérifiez si la synchronisation a généré des erreurs ou des avertissements.
Redémarrer les services
Les services suivants doivent être redémarrés :
- services web (IIS) : issreset /start
- service Adobe Campaign : net start nlserver6
Mise à jour des consoles clientes
La console cliente doit présenter le même build que l'instance de serveur.
Sur la machine sur laquelle est installé le serveur applicatif Adobe Campaign (nlserverweb), téléchargez puis copiez le fichier suivant :
Setup-client-7.xxxx.exe in [path of the application]\datakit\nl\en\jsp
Ainsi, à la prochaine connexion des postes clients, une fenêtre indiquera aux utilisateurs la disponibilité d'une nouvelle mise à jour et leur proposera de la télécharger et de l'installer.
Tâches supplémentaires spécifiques
Pour effectuer la mise à jour vers un nouveau build, certaines configurations impliquent des tâches supplémentaires spécifiques.
Messages transactionnels
Si les messages transactionnels (Message Center) sont activés sur votre instance Campaign, vous devez effectuer les étapes supplémentaires ci-après dans le cadre de l'upgrade :
-
Mettez à jour le serveur de production Message Center vers la version choisie.
-
Exécutez le script de postupgrade.
-
Effectuez des tests et vérifiez que les emails sont bien reçus par le biais de l'instance de production Message Center.
-
Mettez à niveau les clients et effacez le cache.
-
Exportez les packages :
- Exportez les packages à l'aide de l'outil d'export de package client
- Importez le package de schémas
- Déconnectez le client et reconnectez-le
- Mettez à jour la base de données
- Déconnectez-vous puis reconnectez-vous
- Importez le package Admin
- Importez le package Content
- Importez le package Content Management
- Déconnectez-vous puis reconnectez-vous
- Réalisez un contrôle d'intégrité rapide des workflows
-
Publiez les modèles de Message Center pour vous assurer que l'interface entre les serveurs et l'instance Message Center fonctionne.
-
Effectuez des tests pour vérifier que les emails sont bien reçus par le biais de l'instance de production Message Center.
-
Effectuez des tests de workflow en production pour vérifier que les diffusions sont bien reçues.
Mid-sourcing
Dans le contexte d'un environnement de mid-sourcing, vous devez effectuer les étapes supplémentaires ci-après dans le cadre de l'upgrade :
-
Contactez l'Assistance clientèle d'Adobe pour coordonner l'upgrade du serveur de mid-sourcing.
-
Vérifiez que la version a été mise à jour en exécutant un lien de test, par exemple :
code language-none http://[InsertServerURL]/r/test
En cas de conflits
Identifier les conflits
Vous devez vérifier le résultat de la synchronisation. Cette procédure ne doit être suivie que par les clients on-premise. Pour les clients hébergés, elle est gérée par l'équipe d'hébergement. Le résultat de la synchronisation peut être consulté de deux manières différentes :
Depuis l'invite de commandes, les erreurs sont matérialisées par un triple chevron '>>>' et la synchronisation s'interrompt immédiatement. Les avertissements sont signalés par un double chevron '>>' et doivent être résolus lorsque le processus de synchronisation est terminé. À la fin du postupgrade, un résumé est affiché dans l'invite de commande. Par exemple :
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 info log =========Summary of the update==========
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 info log <instance name> instance, 6 warning(s) and 0 error(s) during the update.
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 warning log The document with identifier 'mobileAppDeliveryFeedback' and type 'xtk:report' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 warning log The document with identifier 'opensByUserAgent' and type 'xtk:report' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.750Z 00002E7A 1 warning log The document with identifier 'deliveryValidation' and type 'nms:webApp' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.750Z 00002E7A 1 warning log Document of identifier 'nms:includeView‘ and type 'xtk:srcSchema' updated in the database and found in the file system. You will have to merge the two versions manually.
Si l'avertissement concerne un conflit de ressources, il requiert l'intervention de l'utilisateur pour être résolu.
Le fichier de postupgrade_ServerVersionNumber_TimeOfPostupgrade.log contient le résultat de la synchronisation. Il est disponible par défaut dans le répertoire suivant : installationDirectory/var/<instance-name>/postupgrade. Les erreurs et les avertissements sont indiqués par les attributs d'erreur et d'avertissement.
Analyser les conflits
Comment un conflit est-il détecté ?
Il est possible de détecter des conflits dans le fichier postupgrade.log situé sur le serveur en question ou dans l'interface du client Campaign (Administration > Paramétrage > Gestion des packages > Edition des conflits).
Le document ayant l'identifiant ‘stockOverview' et le type ‘nms:webApp' est en conflit avec la nouvelle version.
Lorsqu'un conflit est détecté, vérifiez si les conditions suivantes sont remplies :
- L'objet a-t-il été modifié ou personnalisé par le client ?
- L'objet a-t-il changé dans le produit ?
Si aucune de ces deux conditions n'est applicable, il s'agit d'un faux positif. Si ces deux conditions sont applicables, un conflit réel a été détecté.
L'objet a-t-il été modifié par le client ?
- Identifiez l'objet en conflit.
- Demandez au client s'il a modifié l'objet.
- L'examen de l'objet relève-t-il une anomalie ?
- La date de dernière modification est-elle définie dans le code de l'objet ?
- Examinez le code XML depuis le conflit pour les attributs “_conflict”. Peut-il s'agir d'une personnalisation ?
L'objet a-t-il changé dans le nouveau build ?
- Existe-t-il des « suspects habituels » tels que des applications web ou des rapports intégrés ('deliveryValidation', 'deliveryOverview' ou 'budget', par exemple).
- Recherchez des mises à jour dans les journaux des modifications.
- Renseignez-vous auprès des utilisateurs experts d’Adobe Campaign.
- Comparez les versions du code pour rechercher des différences avec la commande diff.
Résoudre un conflit
Pour résoudre un conflit, procédez de la manière suivante :
-
Dans l'explorateur d'Adobe Campaign, accédez à Administration > Paramétrage > Gestion des packages > Edition des conflits.
-
Sélectionnez le conflit que vous souhaitez résoudre dans la liste.
Il existe trois façons de résoudre un conflit : accepter la nouvelle version, conserver la version actuelle, fusionner le code (et déclarer le conflit comme résolu), ignorer le conflit (non recommandé).
Dans quels cas accepter la nouvelle version ?
- Lorsque vous souhaitez utiliser les fonctionnalités standards.
- Lorsque vous ne disposez pas de personnalisations (toutes les personnalisations seront supprimées).
Dans quels cas conserver la version actuelle ?
- Lorsque vous disposez de personnalisations.
- Lorsque vous ne souhaitez pas effectuer de fusion.
- Lorsque vous n'avez pas besoin de correctifs pour l'objet en conflit depuis l'upgrade.
Dans quels cas effectuer une fusion ?
- Seuls les formulaires, les rapports et les applications web peuvent être fusionnés.
- Certaines fusions mineures peuvent être réalisées sans maîtriser le code.
- Les fusions plus complexes doivent être réalisées par une personne qui dispose des compétences adéquates.
- Voir Réaliser une fusion.
Que se passe-t-il si vous ignorez les conflits ?
- Le conflit existe toujours.
- L'objet n'est pas mis à niveau.
- Effets à long terme : incompatibilités de versions, client ne tirant pas parti des correctifs.
Réaliser une fusion perform-a-merge
Il existe différents types de fusions :
- Fusion simple : les éléments nouveaux et personnalisés sont petits et non liés, et aucun code n'est nécessaire.
- Aucune modification : acceptation de la nouvelle version, seule la date de dernière mise à jour a été modifiée, seuls les commentaires, les onglets, les espaces et les nouvelles lignes ont été changés (enregistrement accidentel, par exemple).
- Modifications négligeables : seule une ligne a été modifiée, par exemple xpathToLoad.
- Fusion complexe : lorsque du code est requis. Des compétences en développement sont nécessaires. Voir Fusion complexes.
Comment fusionner ?
- Procurez-vous les trois versions : la version d'origine, la nouvelle version et la version personnalisée.
- Comparez la nouvelle version à celle d'origine pour rechercher les différences.
- Isolez les modifications.
- S'il n'existe aucune modification, résolvez le conflit en conservant la version actuelle.
Où trouver le code ?
- Le code intégré est stocké dans des fichiers XML dans le dossier datakit. Recherchez le fichier XML qui correspond à l'objet en conflit, par exemple : DossierInstallation\datakit\nms\fra\form\recipient.xml
- Récupérez la version d'origine : via le centre de téléchargement ou une autre installation non mise à niveau du produit.
- Récupérez la nouvelle version : via le centre de téléchargement ou les fichiers installés par le client.
- Récupérez la version personnalisée : récupérez le code source de l'objet depuis le client Campaign.
Comment créer une comparaison de fichiers
- Installez un éditeur de texte ou de fusion tel que Notepad++, AraxisMerge ou WinMerge.
- Ouvrez le fichier d'origine et le nouveau fichier dans l'éditeur.
- Comparez les deux fichiers (recherchez les différences).
- Identifiez les différences.
Comment fusionner ?
- Commencez à partir de la version personnalisée.
- Appliquez les modifications.
- Résolvez le conflit en le déclarant comme résolu.
- Effectuez un test de non-régression.
Si vous choisissez de résoudre le conflit manuellement, procédez comme suit :
- Dans la partie inférieure de la fenêtre, faites une recherche sur la conflict_string pour localiser les entités en conflit. L'entité installée avec la nouvelle version contient l'argument new, l'entité correspondant à la version précédente contient l'argument custom.
- Supprimez la version que vous ne souhaitez pas conserver. Effacez la chaîne conflict_argument de l'entité que vous gardez.
- Positionnez-vous sur le conflit que vous venez de résoudre. Cliquez sur l'icône Actions et sélectionnez Déclarer comme résolu.
- Enregistrez vos modifications : le conflit est désormais résolu.
Fusions complexes complex-merges
- Comprendre l'impact de la modification : effectuez une rétroconception des modifications, examinez les logs des modifications, renseignez-vous auprès des experts Adobe Campaign.
- Décider de ce qu'il faut faire de la modification.
- Comprendre l'impact des personnalisations : effectuez une rétroconception des modifications
Voici la procédure pour effectuer une fusion complexe :
- Copiez des blocs de code depuis l'ensemble de modifications
- Collez-les dans la version personnalisée
- Testez la non-régression de la personnalisation
- Vérifiez le fonctionnement des modifications
- Réalisez des tests d'acceptation des utilisateurs
- Effectuez les tests dans un environnement de test.
Rubriques connexes :