Les étapes de migration sous Linux sont les suivantes :
Arrêtez d'abord tous les processus accédant à la base de données, sur toutes les machines concernées.
Connectez-vous en tant que root.
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
Reconnectez-vous en tant que root.
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
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.
Si un ou plusieurs processus Adobe Campaign sont encore actifs ou bloqués au bout de quelques minutes, forcez leur arrêt.
killall nlserver
Si certains processus sont toujours actifs au bout de quelques minutes, vous pouvez forcer leur fermeture à l'aide de la commande :
killall -9 nlserver
La procédure dépend de votre version précédente d’Adobe Campaign.
Sauvegardez la base de données Adobe Campaign.
Connectez-vous en tant que neolane et sauvegardez le répertoire nl5 à l'aide de la commande suivante :
su - neolane
mv nl5 nl5.back
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é.
É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>
Sauvegardez la base de données Adobe Campaign.
Connectez-vous en tant que neolane et sauvegardez le répertoire nl6 à l'aide de la commande suivante :
su - neolane
mv nl6 nl6.back
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é.
É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>
Sauvegardez la base de données Adobe Campaign.
Connectez-vous en tant que neolane et sauvegardez le répertoire nl6 à l'aide de la commande suivante :
su - neolane
mv nl6 nl6.back
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é.
La procédure dépend de votre version précédente d’Adobe Campaign.
Connectez-vous en tant que root.
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
Désinstallez les packages Adobe Campaign v5.
Sous Debian :
dpkg --purge nlserver5 nlthirdparty5
Sous Red Hat :
rprm -ev nlserver5 nlthirdparty5
Cette section montre comment désinstaller les packages Adobe Campaign v6.02 ou v6.1.
Connectez-vous en tant que root.
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
Désinstallez les packages Adobe Campaign v6.
Sous Debian :
dpkg --purge nlserver6 nlthirdparty6
Sous Red Hat :
rprm -ev nlserver6 nlthirdparty6
La procédure dépend de votre version précédente d’Adobe Campaign.
Le déploiement d'Adobe Campaign se déroule en deux parties :
Les étapes de déploiement d'Adobe Campaign sont les suivantes :
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
Il est impératif que l'installation des packages réussisse pour passer à l'étape suivante.
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.
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
Pour plus d'informations sur l'installation d'Adobe Campaign sous Linux, consultez cette section.
Modifiez le fichier .bashrd correspondant à l'utilisateur neolane. Connectez-vous en tant que neolane et exécutez la commande suivante :
su - neolane
vim ~/.bashrc
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.
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 ]
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.
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 :
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/
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.
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.
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"/>
Si le service trackinglogd n'est pas démarré sur le serveur de tracking, aucune information de tracking ne sera remontée.
Rechargez la configuration d'Adobe Campaign v7 à l'aide de la commande suivante :
nlserver config -reload
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>
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".
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.
Ne redémarrez pas les services Adobe Campaign à ce stade. Des modifications doivent préalablement être effectuées sur Apache.
Le déploiement d'Adobe Campaign se déroule en deux parties :
Les étapes de déploiement d'Adobe Campaign sont les suivantes :
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
Il est impératif que l'installation des packages réussisse pour passer à l'étape suivante.
Adobe Campaign v7 est installé par défaut dans le même répertoire qu'Adobe Campaign v6.02 : /usr/local/neolane/nl6/.
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
Pour plus d'informations sur l'installation d'Adobe Campaign sous Linux, consultez cette section.
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"/>
Si le service trackinglogd n'est pas démarré sur le serveur de tracking, aucune information de tracking ne sera remontée.
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/
Rechargez la configuration d'Adobe Campaign v7 à l'aide de la commande suivante :
nlserver config -reload
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>
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.
Le déploiement d'Adobe Campaign se déroule en deux parties :
Les étapes de déploiement d'Adobe Campaign sont les suivantes :
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
Il est impératif que l'installation des packages réussisse pour passer à l'étape suivante.
Adobe Campaign v7 est installé par défaut dans le répertoire : /usr/local/neolane/nl6/.
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
Pour plus d'informations sur l'installation d'Adobe Campaign sous Linux, consultez cette section.
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/
Rechargez la configuration d'Adobe Campaign v7 à l'aide de la commande suivante :
nlserver config -reload
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>
Cette section s'applique uniquement lors de la migration à partir d'Adobe Campaign v5.11.
À ce stade, Apache doit être arrêté. Pour plus d'informations, consultez la section Arrêt des services.
Connectez-vous en tant que root.
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
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
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
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é.
La procédure dépend de votre version précédente d'Adobe Campaign.
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 :
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.
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 :
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.
Sur chacun des serveurs suivants, démarrez Apache puis les services Adobe Campaign :
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.
Cette section s'applique uniquement lors de la migration à partir d'Adobe Campaign v5.11.
Avant de supprimer et nettoyer l'installation d'Adobe Campaign v5, il est impératif de suivre les recommandations ci-dessous :
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.