Upgrade vers un nouveau build (On-Premise)

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 .

IMPORTANT

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.

REMARQUE

Reportez-vous également au guide d'installation et au guide de prise en main sur l'upgrade de build.

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

    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 à jour, 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.
REMARQUE

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

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.

REMARQUE

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

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

Cette opération est nécessaire afin qu'Apache prenne en compte la nouvelle bibliothèque.

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.

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

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 **[chemin de l’application]**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.

REMARQUE

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

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.

REMARQUE

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.

Sur cette page