[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

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 :

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.

  1. 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.
  2. Vérifiez qu’aucune tâche n’est active en exécutant la commande nlserver pdump. Voici ce qui devrait apparaître :

    code language-none
    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 :

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

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

NOTE
À partir du build 8757, la bibliothèque tierce n’est plus nécessaire.

Obtenir les packages à 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

Effectuer la mise à jour perform-an-update

  • Distribution basée sur RPM (RedHat, SuSe)

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

    code language-none
    $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 :

    code language-none
    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 :

    code language-none
    dpkg -i 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 :

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

  • Dans l'interface de ligne de commande, les erreurs sont matérialisées par un triple chevron "> et la synchronisation est arrêtée automatiquement. Les avertissements sont signalés par un double chevron " et doit être résolu une fois la synchronisation terminée. A la fin du postupgrade, un résumé est affiché dans l'invite de commande. Il peut ressembler à ceci :

    code language-none
    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 resolving-conflicts

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.

    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 :

  1. Dans la section inférieure de la fenêtre, recherchez le conflit chaîne pour localiser les entités avec des conflits. 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.

  2. Supprimez la version que vous ne souhaitez pas conserver. Supprimez le conflict_argument chaîne de l’entité que vous conservez.

  3. Accédez au conflit que vous avez résolu. Cliquez sur le bouton Actions et sélectionnez Déclarer comme résolu .

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