Show Menu
SUJETS×

Mise à jour de version

Avant de commencer la mise à jour, déterminez et confirmez la version d'Adobe Campaign vers laquelle s'effectue la mise à jour et consultez les notes de mises à jour .
Nous vous recommandons vivement d’effectuer une sauvegarde de base de données sur chaque instance avant de procéder à la mise à jour. Voir à ce sujet Sauvegarde . Pour effectuer une mise à jour, vérifiez que vous avez la possibilité et les permissions d'accéder aux instances et aux logs.
Reportez-vous également au guide d'installation et au guide de prise en main sur l' upgrade de build .

Sous Windows

Pour mettre à jour Adobe Campaign dans une nouvelle version lors de la diffusion d'un nouveau build, la procédure sous Windows est la suivante :
Pour connaître la procédure de mise à jour de la console cliente, reportez-vous à cette section .

Arrêter les 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.
  1. Arrêtez les services suivants :
    • services Web (IIS) :
      iisreset /stop
    • service Adobe Campaign : net stop nlserver6
    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.
  2. Vérifiez qu’aucune tâche n’est active en exécutant la commande nlserver pdump . Voici ce qui devrait apparaître :
    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,

Pour exécuter le fichier de mise à jour, respectez les étapes suivantes :
  1. Exécutez setup.exe .
    Ce fichier peut être téléchargé depuis la page du support Adobe Campaign ( https://support.neolane.net/ ) en cliquant sur le lien Centre de téléchargement .
  2. Sélectionnez le mode d'installation : choisissez Mise à jour ou réparation
  3. Cliquez sur Suivant .
  4. Cliquez sur Terminer .
    Le programme d'installation copie alors les nouveaux fichiers.
  5. Lorsque l'opération est terminée, cliquez sur Terminer .

synchroniser les ressources,

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.
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

Les services à redémarrer sont :
  • services Web (IIS) :
    iisreset /start
  • service Adobe Campaign : net start nlserver6

Sous Linux

Pour mettre à jour Adobe Campaign dans une nouvelle version lors de la diffusion d'un nouveau build, la procédure sous Linux est la suivante :
Pour connaître la procédure de mise à jour de la console cliente, reportez-vous à cette section .
A partir du build 8757, la bibliothèque tierce n'est plus nécessaire.

Obtenir les packages à jour

Commencez par récupérer les deux packages mis à jour d'Adobe Campaign : accédez à la page du support Adobe Campaign ( https://support.neolane.net/ ) via le lien du Centre de téléchargement .
Le fichier est nlserver6-v7-XXX.rpm

Effectuer la mise à jour

  • Distribution basée sur RPM (RedHat, SuSe)
    Pour les installer, exécutez en tant que root :
    $rpm -Uvh nlserver6-v7-XXXX.rpm
    
    
    où XXX correspond à la version du fichier.
    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 :
    rpm --nodeps -Uvh nlserver6-v7-XXXX-0.x86_64.rpm
    
    
  • Distribution basée sur DEB (Debian)
    Pour les installer, exécutez en tant que root :
    dpkg -i nlserver6-v7-XXXX-amd64_debX.deb
    
    
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 de mise à jour .

Redémarrer le serveur web

Vous devez arrêter Apache afin que la nouvelle librairie soit prise en compte.
Pour cela exécutez la commande :
/etc/init.d/apache stop

  • 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 : Cette opération est nécessaire afin qu'Apache prenne en compte la nouvelle librairie.
Puis redémarrez Apache :
/etc/init.d/apache start

Résoudre les conflits de mise à jour

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

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 :
    2013-04-09 07:48:39.749Z 00002E7A 1 info log =========Summary of the update==========
    2013-04-09 07:48:39.749Z 00002E7A 1 info log <instance name> instance, 6 warning(s) and 0 error(s) during the update.
    2013-04-09 07:48:39.749Z 00002E7A 1 warning log The document with identifier 'mobileAppDeliveryFeedback' and type 'xtk:report' is in conflict with the new version.
    2013-04-09 07:48:39.749Z 00002E7A 1 warning log The document with identifier 'opensByUserAgent' and type 'xtk:report' is in conflict with the new version.
    2013-04-09 07:48:39.750Z 00002E7A 1 warning log The document with identifier 'deliveryValidation' and type 'nms:webApp' is in conflict with the new version.
    2013-04-09 07:48:39.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 un conflit

Pour résoudre un conflit, procédez de la manière suivante :
  1. Dans l'arborescence d'Adobe Campaign, positionnez-vous dans Administration > Paramétrage > Gestion des packages > Edition des conflits .
  2. 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.
    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 :
  1. 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 l’argument new , l’entité correspondant à la version précédente contient l’argument cus .
  2. Supprimez la version que vous ne souhaitez pas conserver. Effacez la chaîne conflict_argument de l’entité que vous gardez.
  3. 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 .
  4. Enregistrez vos modifications : le conflit est désormais résolu.

Bonnes pratiques

L'échec d'une mise à jour peut être lié à la configuration de la base de données. Vérifiez que les paramétrages réalisés par l'administrateur technique et l'administrateur de 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

Sous Windows

Sur la machine sur laquelle est installé le serveur applicatif Adobe Campaign ( nlserver web ), téléchargez puis copiez le fichier.
setup-client-6. XXXX .exe
dans ** #**datakitnlengjsp
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.
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.

Sous Linux

Sur la machine sur laquelle est installé le serveur applicatif Adobe Campaign ( nlserver web) , récupérez le package suivant :
setup-client-6. XXXX .exe
et copiez-le sous /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.
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.