v7 On-premise et hybride

Upgrade vers un nouveau build (On-Premise)

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

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

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

   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.

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 à niveau, respectez les étapes suivantes :

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

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

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

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.

Obtenir les packages à jour

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

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
  

Redémarrer le serveur Web

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

Puis redémarrez Apache :

/etc/init.d/apache start

Résoudre les conflits d’upgrade

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 les conflits

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.

  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 :

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

Windows

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.

Linux

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.