Documentation Campaign Documentation de Campaign Classic v7

[On-Premise/hybride uniquement]{class="badge yellow" title="S’applique uniquement aux déploiements on-premise et hybrides"}

Upgrade vers un nouveau build (On-Premise) upgrading

Last update: Thu Oct 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :

Avant de commencer la mise à jour, déterminez et confirmez la version d’Adobe Campaign vers laquelle elle s’effectue et consultez les notes de mises à jour

IMPORTANT

Adobe recommande vivement d’effectuer une sauvegarde de base de données sur chaque instance avant de procéder à la mise à jour. Pour plus d’informations, consultez cette section.
Pour effectuer une mise à niveau, vérifiez que vous avez la possibilité et les autorisations d’accéder aux instances et aux logs.
Lisez cette section et le chapitre Upgrade de build avant de commencer.

Windows in-windows

Dans un environnement Windows, procédez comme suit pour mettre à jour Adobe Campaign vers un nouveau build :

Arrêter les services,
Mettre à niveau le serveur d’applications,
synchroniser les ressources,
Redémarrer les services.

Pour connaître la procédure de mise à jour de la console cliente, reportez-vous à cette section.

Arrêter les services shut-down-services

Il est nécessaire d'arrêter toutes les instances du service nlserver afin de pouvoir remplacer tous les fichiers avec la nouvelle version.

Arrêtez les services suivants :

services Web (IIS) :

iisreset /stop
service Adobe Campaign : net stop nlserver6

note important
IMPORTANT
Vous devez également vous assurer 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.

Vérifiez qu’aucune tâche n’est active en exécutant la commande nlserver pdump. Voici ce qui devrait apparaître :

code language-sql
`C:<installation path>Adobe Campaign v7bin>nlserver pdump HH:MM:SS > Application Server for Adobe Campaign Classic (7.X YY.R build XXX@SHA1) of DD/MM/YYYY No tasks`

Vous pouvez éventuellement utiliser le Gestionnaire de tâches de Windows afin de vous assurer que tous les processus sont inactifs.

mettre à niveau l'application serveur Adobe Campaign, upgrade-the-adobe-campaign-server-application

Pour exécuter le fichier de mise à niveau, respectez les étapes suivantes :

Exécutez setup.exe.

Pour télécharger ce fichier, connectez-vous au portail de distribution de logiciels à l’aide de vos informations d’identification d’utilisateur. En savoir plus sur la distribution des logiciels sur cette page.
Sélectionnez le mode d'installation : choisissez 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 synchronize-resources

Utilisez la commande :

nlserver config -postupgrade -allinstances

Vous pourrez ainsi effectuer les opérations suivantes :

synchroniser les ressources,
mettre à jour les schémas,
mettre à jour la base de données

NOTE

Cette opération n'est à effectuer qu'une seule fois et uniquement sur un serveur applicatif (nlserver web).

Vérifiez ensuite si la synchronisation a généré des erreurs ou des avertissements. Voir à ce sujet la section Résoudre les conflits de mise à jour.

Redémarrer les services restart-services

Les services à redémarrer sont :

services Web (IIS) :

iisreset /start
service Adobe Campaign : net start nlserver6

Linux in-linux

Dans un environnement Linux, procédez comme suit pour mettre à jour Adobe Campaign vers un nouveau build :

Télécharger les packages mis à jour,
Effectuer la mise à jour,
Redémarrer le serveur Web.

En savoir plus sur la disponibilité de la console client.

Installer des packages mis à jour obtain-updated-packages

Commencez par récupérer les deux packages d’Adobe Campaign mis à jour : connectez-vous au portail de distribution de logiciels à l'aide de vos informations d'identification d'utilisateur. En savoir plus sur la distribution de logiciels dans cette page.

Le fichier est nlserver6-v7-XXX.rpm

AVAILABILITY

À compter de la version 7.4.1, les bibliothèques XML pour les packages RPM Linux ne sont plus incluses dans Campaign. Vous devez installer ces bibliothèques.

Vous pouvez ensuite installer les packages requis, comme indiqué ci-dessous :

Distribution basée sur RPM (RedHat, SuSe)

Si le package epel-release n’est pas installé, installez-le. Pour ce faire, saisissez la commande suivante en tant que root :

code language-none
`yum install epel-release`

Pour installer le kit de campagne, exécutez en tant que root :

code language-none
`yum update ./nlserver6-v7-XXXX.rpm`

Avant de confirmer la mise à jour, vérifiez que la sortie ressemble à ce qui suit :

code language-none

code language-none
`==================================================================================================== Package Architecture Version Repository Size ==================================================================================================== Upgrading: nlserver6-v7 x86_64 XXXX.0.0-1 @commandline 63 M`

====================================================================================================
Package                         Architecture  Version                    Repository           Size
====================================================================================================
Upgrading:
nlserver6-v7                    x86_64        XXXX.0.0-1                 @commandline         63 M

note important
IMPORTANT
Si vous lisez `Removing:` au lieu de `Upgrading:`, annulez la commande. Des erreurs (répertoriées ci-dessus) sont probablement à l’origine de la suppression. Dans ce cas, corrigez ces erreurs en mettant à jour ou en installant les dépendances manquantes répertoriées, puis réexécutez la commande.

Le fichier rpm possède des dépendances dans les packages des distributions CentOS/Red Hat. Si vous ne souhaitez pas employer certaines de ces dépendances, vous devrez peut-être utiliser l'option "nodeps" du fichier rpm :

code language-none
`rpm --nodeps -Uvh nlserver6-v7-XXXX-0.x86_64.rpm`

Notez que la plupart des dépendances sont obligatoires et que nlserver ne peut pas démarrer si elles ne sont pas installées. La seule exception est openjdk. Vous pouvez installer un autre JDK si nécessaire.

Distribution basée sur DEB (Debian)

Pour les installer, exécutez en tant que root :

code language-none
`apt install ./nlserver6-v7-XXXX-amd64_debX.deb`

NOTE

Les procédures complètes d’installation sont décrites dans cette section. La synchronisation des ressources se fait automatiquement. En revanche, vous devez vérifier qu’elle s’est déroulée sans erreur. Voir à ce sujet la section Résoudre les conflits d’upgrade.

Redémarrer le serveur Web reboot-the-web-server

Vous devez arrêter Apache afin que la nouvelle bibliothèque soit prise en compte.

Pour cela exécutez la commande :

/etc/init.d/apache stop

IMPORTANT

Il est possible que votre script porte le nom httpd plutôt que apache.
Vous DEVEZ impérativement exécuter cette commande jusqu'à obtenir la réponse suivante :

This operation is required in order for Apache to apply the new library.

Puis redémarrez Apache :

/etc/init.d/apache start

Résoudre les conflits d’upgrade resolving-upgrade-conflicts

Lors de la synchronisation des ressources, la commande postupgrade permet de détecter si la synchronisation génère des erreurs ou des avertissements.

Consulter le résultat de la synchronisation view-the-synchronization-result

Le résultat de la synchronisation peut être consulté de deux manières :

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é. A la fin du postupgrade, un résumé est affiché dans l'invite de commande. Par exemple :

code language-none

code language-none
AAAA-MM-DD HH:MM:SS.749Z 00002E7A 1 info log =========Summary of the update========== AAAA-MM-DD HH:MM:SS.749Z 00002E7A 1 info log <instance name> instance, 6 warning(s) and 0 error(s) during the update. AAAA-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. AAAA-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. AAAA-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. AAAA-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.

AAAA-MM-DD HH:MM:SS.749Z 00002E7A 1 info log =========Summary of the update==========
AAAA-MM-DD HH:MM:SS.749Z 00002E7A 1 info log <instance name> instance, 6 warning(s) and 0 error(s) during the update.
AAAA-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.
AAAA-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.
AAAA-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.
AAAA-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 log post-upgrade_<server version number>_<time of postupgrade>.log contient le résultat de la synchronisation. Il est disponible par défaut dans le répertoire suivant : <installation directory>/var/<instance/postupgrade. Les erreurs et les avertissements sont indiqués par les attributs d’erreur et d’avertissement.

Résoudre les conflits resolving-conflicts

Pour résoudre un conflit, procédez de la manière suivante :

Dans l'arborescence d'Adobe Campaign, positionnez-vous dans Administration > Paramétrage > Gestion des packages > Edition des conflits .
Sélectionnez le conflit que vous souhaitez résoudre dans la liste.

Il existe trois possibilités de résoudre un conflit :

Déclarer comme résolu : requiert une intervention de l'utilisateur au préalable.
Accepter la nouvelle version : recommandé si les ressources livrées avec Adobe Campaign n'ont pas été modifiées par l'utilisateur.

Conserver la version actuelle : a pour conséquence de refuser la mise à jour de la version.

note important
IMPORTANT
Si vous sélectionnez ce mode de résolution, vous risquez de perdre des correctifs inclus dans la nouvelle version.

Si vous choisissez de résoudre le conflit manuellement, procédez comme suit :

Dans la partie inférieure de la fenêtre, effectuez une recherche sur la chaîne conflit pour localiser les entités en conflit. L'entité installée avec la nouvelle version contient le nouvel argument. L'entité qui correspond à la version précédente contient l'argument cus.
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.

Bonnes pratiques best-practices

L’échec d’une mise à jour peut être lié à la configuration de la base de données. Assurez-vous que les configurations effectuées par l’administrateur technique et l’administrateur de la base de données sont compatibles.

Par exemple, une base de données unicode ne doit pas autoriser uniquement le stockage de données en LATIN1, etc.

Notifier les postes clients de la disponibilité de la mise à jour warn-the-client-consoles-of-the-available-update

Windows in-windows-1

Sur l’ordinateur sur lequel est installé le serveur d’applications Adobe Campaign (nlserver web), téléchargez et copiez le fichier setup-client-6.XXXX.exe dans le [chemin d’accès de l’application]/datakit/nl/eng/jsp.

Ainsi, à la prochaine connexion des postes clients, une fenêtre indiquera aux utilisateurs la disponibilité d'une mise à jour et leur proposera de la télécharger et de l'installer.

NOTE

Assurez-vous que l'utilisateur IIS_WPG a bien les droits d'accès en lecture à ce fichier d'installation et reportez-vous au guide d'installation pour plus d'informations.

Linux in-linux-1

Sur l’ordinateur sur lequel est installé le serveur d’applications Adobe Campaign (nlserver web), récupérez le package setup-client-6.XXXX.exe, copiez-le et enregistrez-le dans /usr/local/neolane/nl6/datakit/nl/eng/jsp :

cp setup-client-6.XXXX.exe /usr/local/neolane/nl6/datakit/nl/eng/jsp

Ainsi, à la prochaine connexion des postes clients, une fenêtre indiquera aux utilisateurs la disponibilité d'une mise à jour et leur proposera de la télécharger et de l'installer.

NOTE

Assurez-vous que l'utilisateur Apache a bien les droits d'accès en lecture à ce fichier d'installation et reportez-vous au guide d'installation pour plus d'informations.

recommendation-more-help

601d79c3-e613-4db3-889a-ae959cd9e3e1