Migration steps in Linux are as follows:
First, stop all processes with access to the database on all machines concerned.
Log in as root.
All servers which use the redirection module (webmdl service) need to be stopped. For Apache, run the following command:
/etc/init.d/apache2 stop
Log in again as root.
Stop Adobe Campaign previous version services on all servers.
/etc/init.d/nlserver6 stop
If you are migrating from v5.11, run the following command:
/etc/init.d/nlserver5 stop
Make sure Adobe Campaign services are stopped on each server.
ps waux | grep nlserver
The list of active processes is displayed along with their ID (PID).
If one or more Adobe Campaign processes are still active or blocked after a few minutes, kill them.
killall nlserver
If some processes are still active after a few minutes, you can force them to close using the command:
killall -9 nlserver
The procedure depends on your Adobe Campaign previous version.
Make a backup of the Adobe Campaign database.
Log in as neolane and make a backup of the nl5 directory using the following command:
su - neolane
mv nl5 nl5.back
As a precaution, we recommend that you zip the nl5.back folder and save it to a secure location other than the server.
Edit the config-<instance name>
.xml (in the nl5.back folder), to prevent the mta, wfserver, stat etc. services from starting automatically. For instance, replace autoStart with _autoStart (still as 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>
Make a backup of the Adobe Campaign database.
Log in as neolane and make a backup of the nl6 directory using the following command:
su - neolane
mv nl6 nl6.back
As a precaution, we recommend that you zip the nl6.back folder and save it to a secure location other than the server.
Edit the config-<instance name>
.xml (in the nl6.back folder) to prevent the mta, wfserver, stat, etc. services from starting automatically. For instance, replace autoStart with _autoStart (still as 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>
Make a backup of the Adobe Campaign database.
Log in as neolane and make a backup of the nl6 directory using the following command:
su - neolane
mv nl6 nl6.back
As a precaution, we recommend that you zip the nl6.back folder and save it to a secure location other than the server.
The procedure depends on your Adobe Campaign previous version.
Log in as root.
Identify the Adobe Campaign packages installed using the following command.
In Debian:
dpkg -l | grep nl
The list of installed packages is displayed:
ii nlserver5 5762 nlserver5-5762
ii nlthirdparty5 5660 nlthirdparty5-5660
In Red Hat:
rpm -qa | grep nl
Uninstall Adobe Campaign v5 packages.
In Debian:
dpkg --purge nlserver5 nlthirdparty5
In Red Hat:
rprm -ev nlserver5 nlthirdparty5
This section shows how to uninstall Adobe Campaign v6.02 or v6.1 packages.
Log in as root.
Identify the Adobe Campaign packages installed using the following command.
In Debian:
dpkg -l | grep nl
The list of installed packages is displayed:
ii nlserver6 XXXX nlserver6-XXXX
ii nlthirdparty6 XXXX nlthirdparty6-XXXX
In Red Hat:
rpm -qa | grep nl
Uninstall Adobe Campaign v6 packages.
In Debian:
dpkg --purge nlserver6 nlthirdparty6
In Red Hat:
rprm -ev nlserver6 nlthirdparty6
The procedure depends on your Adobe Campaign previous version.
Deploying Adobe Campaign involves two stages:
To deploy Adobe Campaign, apply the following steps:
Install the most recent Adobe Campaign v7 packages using the following command:
In Debian:
dpkg -i nlserver6-XXXX-linux-2.6-intel.deb
In Red Hat:
rpm -Uvh nlserver6-XXXX-0.x86_64.rpm
You must install the packages successfully before going on to the next step.
When migrating from v5.11, Adobe Campaign is installed in the /usr/local/neolane/nl6/ directory by default.
Once the packages are installed, the following message is displayed: ‘WdbcTimeZone’ option is missing. This is normal.
To make the client console installation program available, copy it into the Adobe Campaign installation directory:
cp setup-client-7.0.XXXX.exe /usr/local/neolane/nl6/datakit/nl/eng/jsp
For more on how to install Adobe Campaign in Linux, refer to this section.
Modify the .bashrd file which matches the neolane user. Log on as neolane and run the following command:
su - neolane
vim ~/.bashrc
When you log in as neolane, the following message is displayed: nl5/env.sh : No such file or directory. This is normal.
At the end of the file, replace nl5/env.sh with nl6/env.sh.
Log in as root and prepare the instance using the following commands:
/etc/init.d/nlserver6 start
Starting nlserver6: [ OK ]
/etc/init.d/nlserver6 stop
Stopping nlserver6: [ OK ]
These commands let you create the Adobe Campaign v6 internal files system: conf directory (with the config-default.xml and serverConf.xml files), var directory.
Go to the nl5.back backup folder and copy (overwrite) the configuration files and sub-folders of each instance. Log in as neolane and run the following command:
For the first command below, do not copy the config-default.xml file.
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/
In the Adobe Campaign v7 serverConf.xml and config-default.xml files, apply the specific configurations that you had for Adobe Campaign v5. For the serverConf.xml file, use the nl5/conf/serverConf.xml.diff file.
When reporting configurations from Adobe Campaign v5 to Adobe Campaign v7, make sure the paths to the physical directories lead to Adobe Campaign v7 and not Adobe Campaign v5.
Since migration is not a generic installation, you need to force the re-starting of the trackinglogd service. To do this, open the nl6/conf/config-default.xml file and make sure the trackinglogd service is activated (only on the tracking/redirection server(s)):
<trackinglogd autoStart="true"/>
If the trackinglogd service is not started on the tracking server, no tracking information will be forwarded.
Reload the Adobe Campaign v7 configuration using the following command:
nlserver config -reload
Start the postupgrade process using the following command (still as neolane):
su - neolane
nlserver config -timezone:<time zone> -postupgrade -instance:<instance name>
You must specify which timezone to use as a reference during the postupgrade (using the -timezone option). In this case, we are using the Europe/Paris timezone -timezone: “Europe/Paris”.
We strongly recommend upgrading your base to “multi timezone”. For further information about timezone options, refer to the Time zones section.
Do not start Adobe Campaign services yet: changes still need to be made in Apache.
Deploying Adobe Campaign involves two stages:
To deploy Adobe Campaign, apply the following steps:
Install the most recent Adobe Campaign v7 packages using the following command:
In Debian:
dpkg -i nlserver6-XXXX-amd64_debX.deb
In Red Hat:
rpm -Uvh nlserver6-XXXX-x86_64_rhX.rpm
You must install the packages successfully before going on to the next step.
Adobe Campaign v7 is installed in the same directory by default as Adobe Campaign v6.02: /usr/local/neolane/nl6/.
To make the client console installation program available, copy it into the Adobe Campaign installation directory:
cp setup-client-7.0.XXXX.exe /usr/local/neolane/nl6/datakit/nl/eng/jsp
For more on how to install Adobe Campaign in Linux, refer to this section.
Since migration is not a generic installation, you need to force the re-starting of the trackinglogd service. To do this, open the nl6/conf/config-default.xml file and make sure the trackinglogd service is activated (only on the tracking/redirection server(s)):
<trackinglogd autoStart="true"/>
If the trackinglogd service is not started on the tracking server, no tracking information will be forwarded.
Go to the nl6.back backup folder and copy (overwrite) the configuration files and sub-folders of each instance. Log in as neolane and run the following command:
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/
Reload the Adobe Campaign v7 configuration using the following command:
nlserver config -reload
Start the postupgrade process using the following command (still as neolane):
su - neolane
nlserver config -postupgrade -instance:<instance name>
The “multi timezone” mode was only available in v6.02 for PostgreSQL database engines. It is now available no matter what version of database engine is being used. We strongly recommend upgrading your base to “multi timezone”. For further information about timezone options, refer to the Time zones section.
Deploying Adobe Campaign involves two stages:
To deploy Adobe Campaign, apply the following steps:
Install the most recent Adobe Campaign v7 packages using the following command:
In Debian:
dpkg -i nlserver6-XXXX-amd64_debX.deb
In Red Hat:
rpm -Uvh nlserver6-XXXX-x86_64_rhX.rpm
You must install the packages successfully before going on to the next step.
Adobe Campaign v7 is installed in the /usr/local/neolane/nl6/ directory by default.
To make the client console installation program available, copy it into the Adobe Campaign installation directory:
cp setup-client-7.0.XXXX.exe /usr/local/neolane/nl6/datakit/nl/eng/jsp
For more on how to install Adobe Campaign in Linux, refer to this section.
Go to the nl6.back backup folder and copy (overwrite) the configuration files and sub-folders of each instance. Log in as neolane and run the following command:
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/
Reload the Adobe Campaign v7 configuration using the following command:
nlserver config -reload
Start the postupgrade process using the following command (still as neolane):
su - neolane
nlserver config -postupgrade -instance:<instance name>
This section only applies when migrating from Adobe Campaign v5.11.
At this stage, Apache needs to be stopped. Refer to: Service stop.
Log in as root.
Change the Apache environment variables to make them link to the nl6 directory.
In Debian:
vi /etc/apache2/envvars
In Red Hat:
vi /usr/local/apache2/bin/envvars
Then run the following commands:
In Debian:
In the nlsrv.load file, replace nl5 with nl6.
vi /etc/apache2/mods-available/nlsrv.load
Delete the link of the nlsrv.conf file and create a new one.
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
In Red Hat:
Go to the /usr/local/apache2/conf directory, edit the http.conf file and replace nl5 with nl6 in the following lines.
In 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
Go to the alias.conf file and replace all nl5 with nl6. To do this in Debian, run the following command:
vi /etc/apache2/mods-available/alias.conf
If you are migrating from v6.02 or earlier, you must configure your security zones before starting services. For more information, refer to Security.
The procedure depends on your Adobe Campaign previous version.
In the config-<instance name>
.xml files, reactivate the automatic startup of the mta, wfserver, stat, etc. services.
<?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>
Start Apache and Adobe Campaign services on each of the following servers:
Before going on to the next step, run a full test of the new installation, make sure there are no regressions and that everything works by following all the recommendations in the General configurations section.
In the config-<instance name>
.xml files, reactivate the automatic startup of the mta, wfserver, stat, etc. services.
<?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>
Start Apache and Adobe Campaign services on each of the following servers:
Fully test the new installation, check that it does not regress and make sure that everything is working correctly by following all the recommendations in the General configurations section.
Start Apache and Adobe Campaign services on each of the following servers:
Fully test the new installation, check that it does not regress and make sure that everything is working correctly by following all the recommendations in the General configurations section.
This section only applies when migrating from Adobe Campaign v5.11.
Before you delete and cleanse the Adobe Campaign v5 installation, you must apply the following recommendations:
Delete the nl5.back directory. Log in as neolane and run the following command:
su - neolane
rm -rf nl5.back
Re-start the server.