Migration sous Linux pour Adobe Campaign v7

Procédure générale

Les étapes de migration sous Linux sont les suivantes :

1. Arrêter les services : voir la section Arrêt des services.
2. Enregistrer la base de données : voir Sauvegarde de la base et de l'installation existante.
3. Désinstaller les packages de version précédente d'Adobe Campaign : voir Désinstallation des packages de version précédente d'Adobe Campaign.
4. Effectuer la migration de la plateforme : voir la section Déploiement d’Adobe Campaign v7.
5. Redémarrer le service : voir la section Redémarrage des services.

Arrêt des services

Arrêtez d'abord tous les processus accédant à la base de données, sur toutes les machines concernées.

1. Connectez-vous en tant que root.

2. Les serveurs utilisant le module de redirection (service webmdl) doivent être arrêtés. Pour Apache, exécutez la commande suivante :

   /etc/init.d/apache2 stop
   

3. Reconnectez-vous en tant que root.

4. Arrêtez les services de la version précédente d'Adobe Campaign sur tous les serveurs.

   /etc/init.d/nlserver6 stop
   

   Si vous migrez à partir de la version v5.11, exécutez la commande suivante :

   /etc/init.d/nlserver5 stop
   

5. Sur chaque serveur, vérifiez que les services Adobe Campaign ont bien été arrêtés.

   ps waux | grep nlserver
   

   La liste des processus actifs ainsi que leur identifiant (PID) correspondant apparaît.

6. Si un ou plusieurs processus Adobe Campaign sont encore actifs ou bloqués au bout de quelques minutes, forcez leur arrêt.

   killall nlserver
   

7. Si certains processus sont toujours actifs au bout de quelques minutes, vous pouvez forcer leur fermeture à l'aide de la commande :

   killall -9 nlserver
   

Sauvegarde de la base et de l'installation existante

La procédure dépend de votre version précédente d'Adobe Campaign :

Migration à partir d'Adobe Campaign v5.11

1. Sauvegardez la base de données Adobe Campaign.

2. Connectez-vous en tant que neolane et sauvegardez le répertoire nl5 à l'aide de la commande suivante :

   su - neolane
   mv nl5 nl5.back
   

   IMPORTANT

   Par mesure de précaution, nous vous recommandons vivement de zipper le dossier nl5.back, et de le conserver à un autre emplacement que le serveur, sur un support sécurisé.

3. Éditez le fichier config-<instance name>.xml (dans le dossier nl5.back), pour éviter le démarrage automatique des services mta, wfserver, stat, etc. Par exemple, remplacez autoStart par _autoStart (comme pour neolane).

   <?xml version='1.0'?>
   <serverconf>
     <shared>
       <dataStore hosts="myServer*" lang="en_US">
         <dataSource name="default">
           <dbcnx encrypted="1" login="myLogin" password="myPassword"  provider="postgresql" server="myServer"/>
         </dataSource>
       </dataStore>
     </shared>
   
     <mta _autoStart="true" statServerAddress="myStatServer"/>
     <stat _autoStart="true"/>
     <wfserver _autoStart="true"/>
     <inMail _autoStart="true"/>
     <sms _autoStart="false"/>
   </serverconf>
   

Migration à partir d'Adobe Campaign v6.02

1. Sauvegardez la base de données Adobe Campaign.

2. Connectez-vous en tant que neolane et sauvegardez le répertoire nl6 à l'aide de la commande suivante :

   su - neolane
   mv nl6 nl6.back
   

   IMPORTANT

   Par mesure de précaution, nous vous recommandons vivement de zipper le dossier nl6.back, et de le conserver à un autre emplacement que le serveur, sur un support sécurisé.

3. Éditez le fichier config-<instance name>.xml (dans le dossier nl6.back), pour éviter le démarrage automatique des services mta, wfserver, stat, etc. Par exemple, remplacez autoStart par _autoStart (comme pour Adobe Campaign).

   <?xml version='1.0'?>
   <serverconf>
     <shared>
       <dataStore hosts="myServer*" lang="en_US">
         <dataSource name="default">
           <dbcnx encrypted="1" login="myLogin" password="myPassword"  provider="postgresql" server="myServer"/>
         </dataSource>
       </dataStore>
     </shared>
   
     <mta _autoStart="true" statServerAddress="myStatServer"/>
     <stat _autoStart="true"/>
     <wfserver _autoStart="true"/>
     <inMail _autoStart="true"/>
     <sms _autoStart="false"/>
   </serverconf>
   

Migration à partir d'Adobe Campaign v6.1

1. Sauvegardez la base de données Adobe Campaign.

2. Connectez-vous en tant que neolane et sauvegardez le répertoire nl6 à l'aide de la commande suivante :

   su - neolane
   mv nl6 nl6.back
   

   IMPORTANT

   Par mesure de précaution, nous vous recommandons vivement de zipper le dossier nl6.back, et de le conserver à un autre emplacement que le serveur, sur un support sécurisé.

Désinstallation des packages de version précédente d'Adobe Campaign

La procédure dépend de votre version précédente d'Adobe Campaign :

Désinstallation des packages Adobe Campaign v5

1. Connectez-vous en tant que root.

2. Identifiez les packages Adobe Campaign installés à l'aide de la commande suivante.

   • Sous Debian :

     dpkg -l | grep nl
     

     La liste des packages installés apparaît :

     ii  nlserver5                       5762                     nlserver5-5762
     ii  nlthirdparty5                   5660                     nlthirdparty5-5660
     

   • Sous Red Hat :

     rpm -qa | grep nl
     

3. Désinstallez les packages Adobe Campaign v5.

   • Sous Debian :

     dpkg --purge nlserver5 nlthirdparty5
     

   • Sous Red Hat :

     rprm -ev nlserver5 nlthirdparty5
     

Désinstallation des packages Adobe Campaign v6

Cette section montre comment désinstaller les packages Adobe Campaign v6.02 ou v6.1.

1. Connectez-vous en tant que root.

2. Identifiez les packages Adobe Campaign installés à l'aide de la commande suivante.

   • Sous Debian :

     dpkg -l | grep nl
     

     La liste des packages installés apparaît :

     ii  nlserver6                       XXXX                     nlserver6-XXXX
     ii  nlthirdparty6                   XXXX                     nlthirdparty6-XXXX
     

   • Sous Red Hat :

     rpm -qa | grep nl
     

3. Désinstallez les packages Adobe Campaign v6.

   • Sous Debian :

     dpkg --purge nlserver6 nlthirdparty6
     

   • Sous Red Hat :

     rprm -ev nlserver6 nlthirdparty6
     

Déploiement d'Adobe Campaign v7

La procédure dépend de votre version précédente d'Adobe Campaign :

Migration à partir d'Adobe Campaign v5.11

Le déploiement d'Adobe Campaign se déroule en deux parties :

• L'installation des packages Adobe Campaign v7 : cette opération doit être effectuée sur chaque serveur.
• Le postupgrade : cette commande doit être lancée sur chaque instance.

Les étapes de déploiement d'Adobe Campaign sont les suivantes :

1. Installez les packages Adobe Campaign v7 les plus récents à l'aide de la commande suivante :

   • Sous Debian :

     dpkg -i nlserver6-XXXX-linux-2.6-intel.deb
     

   • Sous Red Hat :

     rpm -Uvh nlserver6-XXXX-0.x86_64.rpm
     

   IMPORTANT

   Il est impératif que l'installation des packages réussisse pour passer à l'étape suivante.

   REMARQUE

   Lors de la migration depuis une v5.11, Adobe Campaign est installé par défaut dans le répertoire : /usr/local/neolane/nl6/.

   Après l'installation des packages, le message suivant apparaît : 'WdbcTimeZone' option is missing. L'apparition de ce message à ce stade est normale.

2. Pour mettre à disposition le programme d'installation de la console cliente, copiez-le dans le répertoire d'installation d'Adobe Campaign :

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

   REMARQUE

   Pour plus d'informations sur l'installation d'Adobe Campaign sous Linux, consultez cette section.

3. Modifiez le fichier .bashrd correspondant à l'utilisateur neolane. Connectez-vous en tant que neolane et exécutez la commande suivante :

   su - neolane
   vim ~/.bashrc
   

   REMARQUE

   Lorsque vous vous connectez en tant que neolane, le message suivant apparaît : nl5/env.sh : No such file or directory. L'apparition de ce message à ce stade est normale.

   A la fin du fichier, remplacez nl5/env.sh par nl6/env.sh.

4. Reconnectez-vous en tant que root et préparez l'instance à sa première utilisation à l'aide des commandes suivantes :

   /etc/init.d/nlserver6 start   
   Starting nlserver6: [  OK  ]
   

   /etc/init.d/nlserver6 stop
   Stopping nlserver6: [  OK  ]
   

   REMARQUE

   Ces commandes permettent de créer le système de fichiers interne d'Adobe Campaign v6 : répertoire conf (avec les fichiers config-default.xml et serverConf.xml), répertoire var.

5. Effectuez une copie (par écrasement), depuis le dossier de sauvegarde nl5.back, des fichiers de configuration et des sous-dossiers de chaque instance. Connectez-vous en tant que neolane et exécutez la commande suivante :

   IMPORTANT

   Pour la première des commandes ci-dessous, ne copiez pas le fichier config-default.xml.

   su - neolane
   
   cp nl5.back/conf/config-<instance name>.xml nl6/conf/
   cp nl5.back/customer.sh nl6/
   cp -r nl5.back/customers/* nl6/customers/
   cp -r nl5.back/var/* nl6/var/
   

6. Dans les fichiers serverConf.xml et config-default.xml d'Adobe Campaign v7, appliquez les configurations spécifiques dont vous disposiez pour Adobe Campaign v5. Pour le fichier serverConf.xml, utilisez le fichier nl5/conf/serverConf.xml.diff.

   REMARQUE

   Lors du report des paramétrages Adobe Campaign v5 vers Adobe Campaign v7, assurez-vous que les chemins vers les répertoires physiques pointent bien vers Adobe Campaign v7 et pas Adobe Campaign v5.

7. La migration n'étant pas une installation générique, vous devez forcer le redémarrage du service trackinglogd. Pour cela, ouvrez le fichier nl6/conf/config-default.xml et assurez-vous que le service trackinglogd est bien activé (uniquement sur le ou les serveurs de tracking/redirection) :

   <trackinglogd autoStart="true"/>
   

   IMPORTANT

   Si le service trackinglogd n'est pas démarré sur le serveur de tracking, aucune information de tracking ne sera remontée.

8. Rechargez la configuration d'Adobe Campaign v7 à l'aide de la commande suivante :

   nlserver config -reload
   

9. Démarrez le processus de postupgrade à l'aide de la commande suivante (toujours en tant que neolane) :

   su - neolane
   nlserver config -timezone:<time zone> -postupgrade -instance:<instance name>
   

   IMPORTANT

   Vous devez impérativement spécifier le fuseau horaire à utiliser comme référence au moment du postupgrade (à l'aide de l'option -timezone). Dans cet exemple, nous utilisons le fuseau horaire Europe/Paris : -timezone:"Europe/Paris".

   REMARQUE

   Nous vous recommandons vivement de mettre à niveau votre base en mode « multi timezone ». Pour plus d'informations à propos des options de fuseaux horaires, consultez la section Fuseaux horaires.

Migration à partir d'Adobe Campaign v6.02

Le déploiement d'Adobe Campaign se déroule en deux parties :

• L'installation des packages Adobe Campaign v7 : cette opération doit être effectuée sur chaque serveur.
• Le postupgrade : cette commande doit être lancée sur chaque instance.

Les étapes de déploiement d'Adobe Campaign sont les suivantes :

1. Installez les packages Adobe Campaign v7 les plus récents à l'aide de la commande suivante :

   • Sous Debian :

     dpkg -i nlserver6-XXXX-amd64_debX.deb
     

   • Sous Red Hat :

     rpm -Uvh nlserver6-XXXX-x86_64_rhX.rpm
     

   IMPORTANT

   Il est impératif que l'installation des packages réussisse pour passer à l'étape suivante.

   REMARQUE

   Adobe Campaign v7 est installé par défaut dans le même répertoire qu'Adobe Campaign v6.02 : /usr/local/neolane/nl6/.

2. Pour mettre à disposition le programme d'installation de la console cliente, copiez-le dans le répertoire d'installation d'Adobe Campaign :

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

   REMARQUE

   Pour plus d'informations sur l'installation d'Adobe Campaign sous Linux, consultez cette section.

3. La migration n'étant pas une installation générique, vous devez forcer le redémarrage du service trackinglogd. Pour cela, ouvrez le fichier nl6/conf/config-default.xml et assurez-vous que le service trackinglogd est bien activé (uniquement sur le ou les serveurs de tracking/redirection) :

   <trackinglogd autoStart="true"/>
   

   IMPORTANT

   Si le service trackinglogd n'est pas démarré sur le serveur de tracking, aucune information de tracking ne sera remontée.

4. Accédez au dossier de sauvegarde nl6.back et copiez (écrasez) les fichiers de configuration et les sous-dossiers de chaque instance. Connectez-vous en tant que neolane et exécutez la commande suivante :

   su - neolane
   
   cp nl6.back/conf/config*.xml nl6/conf/
   cp nl6.back/customer.sh nl6/
   cp -r nl6.back/customers/* nl6/customers/
   cp -r nl6.back/var/* nl6/var/
   

5. Rechargez la configuration d'Adobe Campaign v7 à l'aide de la commande suivante :

   nlserver config -reload
   

6. Démarrez le processus de postupgrade à l'aide de la commande suivante (toujours en tant que neolane) :

   su - neolane
   nlserver config -postupgrade -instance:<instance name>
   

   REMARQUE

   Le mode « multi timezone » n'était disponible, en v6.02, que pour les moteurs de base de données PostgreSQL. Il est à présent proposé quelle que soit la version de votre moteur de base. Nous vous recommandons fortement de transformer votre base en base « multi timezone ». Pour plus d'informations à propos des options de fuseaux horaires, consultez la section Fuseaux horaires.

Migration à partir d'Adobe Campaign v6.1

Le déploiement d'Adobe Campaign se déroule en deux parties :

• L'installation des packages Adobe Campaign v7 : cette opération doit être effectuée sur chaque serveur.
• Le postupgrade : cette commande doit être lancée sur chaque instance.

Les étapes de déploiement d'Adobe Campaign sont les suivantes :

1. Installez les packages Adobe Campaign v7 les plus récents à l'aide de la commande suivante :

   • Sous Debian :

     dpkg -i nlserver6-XXXX-amd64_debX.deb
     

   • Sous Red Hat :

     rpm -Uvh nlserver6-XXXX-x86_64_rhX.rpm
     

   IMPORTANT

   Il est impératif que l'installation des packages réussisse pour passer à l'étape suivante.

   REMARQUE

   Adobe Campaign v7 est installé par défaut dans le répertoire : /usr/local/neolane/nl6/.

2. Pour mettre à disposition le programme d'installation de la console cliente, copiez-le dans le répertoire d'installation d'Adobe Campaign :

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

   REMARQUE

   Pour plus d'informations sur l'installation d'Adobe Campaign sous Linux, consultez cette section.

3. Accédez au dossier de sauvegarde nl6.back et copiez (écrasez) les fichiers de configuration et les sous-dossiers de chaque instance. Connectez-vous en tant que neolane et exécutez la commande suivante :

   su - neolane
   
   cp nl6.back/conf/config*.xml nl6/conf/
   cp nl6.back/customer.sh nl6/
   cp -r nl6.back/customers/* nl6/customers/
   cp -r nl6.back/var/* nl6/var/
   

4. Rechargez la configuration d'Adobe Campaign v7 à l'aide de la commande suivante :

   nlserver config -reload
   

5. Démarrez le processus de postupgrade à l'aide de la commande suivante (toujours en tant que neolane) :

   su - neolane
   nlserver config -postupgrade -instance:<instance name>
   

Migration du serveur de redirection (Apache)

À ce stade, Apache doit être arrêté. Pour plus d'informations, consultez la section Arrêt des services.

1. Connectez-vous en tant que root.

2. Modifiez les variables d'environnement d'Apache afin de les faire pointer vers le répertoire nl6.

   • Sous Debian :

     vi /etc/apache2/envvars
     

   • Sous Red Hat :

     vi /usr/local/apache2/bin/envvars
     

3. Exécutez ensuite les commandes suivantes :

   • Sous Debian :

     Dans le fichier nlsrv.load, remplacez toutes les occurrences de nl5 par nl6.

     vi /etc/apache2/mods-available/nlsrv.load
     

     Supprimez le lien du fichier nlsrv.conf et recréez-le.

     rm /etc/apache2/mods-available/nlsrv.conf 
     ln -s /usr/local/neolane/nl6/tomcat-6/conf/apache_neolane.conf /etc/apache2/
     mods-available/nlsrv.conf
     

   • Sous Red Hat :

     Dans le répertoire /usr/local/apache2/conf, éditez le fichier httpd.conf et remplacez nl5 par nl6 dans les lignes ci-dessous.

     Sous RHEL 7 / Debian 8 :

     LoadModule requesthandler24_module /usr/local/neolane/nl6/lib/libnlsrvmod.so
     Include /usr/local/neolane/nl6/tomcat-6/conf/apache_neolane.conf
     

4. Dans le fichier alias.conf, les occurrences de nl5 doivent être remplacées par nl6. Sous Debian, la commande est la suivante :

   vi /etc/apache2/mods-available/alias.conf
   

Zones de sécurité

Si vous migrez depuis une v6.02 ou antérieure, vous devez paramétrer vos zones de sécurité avant de redémarrer les services. Voir à ce sujet la section Sécurité.

Redémarrage des services

La procédure dépend de votre version précédente d'Adobe Campaign :

Migration à partir d'Adobe Campaign v5.11

Dans les fichiers config-<instance name>.xml, réactivez le démarrage automatique des services mta, wfserver, stat, etc.

<?xml version='1.0'?>
<serverconf>
  <shared>
    <dataStore hosts="myServer*" lang="en_US">
      <dataSource name="default">
        <dbcnx encrypted="1" login="myLogin" password="myPassword"  provider="postgresql" server="myServer"/>
      </dataSource>
    </dataStore>
  </shared>

  <mta autoStart="true" statServerAddress="localhost"/>
  <stat autoStart="true"/>
  <wfserver autoStart="true"/>
  <inMail autoStart="true"/>
  <sms autoStart="false"/>
</serverconf>

Sur chacun des serveurs suivants, démarrez Apache puis les services Adobe Campaign :

1. Serveur de tracking/redirection.
2. Serveur de mid-sourcing.
3. Serveur marketing.

Avant de passer à l'étape suivante, testez complètement la nouvelle installation, validez la non-régression et assurez-vous que tout est fonctionnel, en suivant toutes les recommandations données dans la section Paramétrages généraux.

Migration à partir d'Adobe Campaign v6.02

Dans les fichiers config-<instance name>.xml, réactivez le démarrage automatique des services mta, wfserver, stat, etc.

<?xml version='1.0'?>
<serverconf>
  <shared>
    <dataStore hosts="myServer*" lang="en_US">
      <dataSource name="default">
        <dbcnx encrypted="1" login="myLogin" password="myPassword"  provider="postgresql" server="myServer"/>
      </dataSource>
    </dataStore>
  </shared>

  <mta autoStart="true" statServerAddress="myStatServer"/>
  <stat autoStart="true"/>
  <wfserver autoStart="true"/>
  <inMail autoStart="true"/>
  <sms autoStart="false"/>
</serverconf>

Sur chacun des serveurs suivants, démarrez Apache puis les services Adobe Campaign :

1. Serveur de tracking/redirection.
2. Serveur de mid-sourcing.
3. Serveur marketing.

Testez complètement la nouvelle installation, validez la non-régression et assurez-vous que tout est fonctionnel, en suivant toutes les recommandations de la section Paramétrages généraux.

Migration à partir d'Adobe Campaign v6.1

Sur chacun des serveurs suivants, démarrez Apache puis les services Adobe Campaign :

1. Serveur de tracking/redirection.
2. Serveur de mid-sourcing.
3. Serveur marketing.

Testez complètement la nouvelle installation, validez la non-régression et assurez-vous que tout est fonctionnel, en suivant toutes les recommandations de la section Paramétrages généraux.

Suppression et nettoyage d'Adobe Campaign v5

Avant de supprimer et nettoyer l'installation d'Adobe Campaign v5, il est impératif de suivre les recommandations ci-dessous :

• Effectuez une validation complète de la nouvelle installation par les équipes fonctionnelles.
• Ne procédez à la désinstallation d'Adobe Campaign v5 qu'une fois que vous êtes certain qu'un retour arrière n'est pas nécessaire.

Supprimez le répertoire nl5.back. Connectez-vous en tant que neolane et exécutez la commande suivante :

su - neolane
rm -rf nl5.back

Redémarrez le serveur.