Pour une plateforme Linux 32 bits, procédez à une installation d'Adobe Campaign 32 bits. Pour une plateforme Linux 64 bits, procédez à une installation d'Adobe Campaign 64 bits.
Pour chacune de ces versions, Adobe Campaign est livré avec un package nlserver, qui contient les binaires et les fichiers de configuration pour une version donnée.
Les commandes d'installation permettent de :
L'utilisateur système neolane ne doit pas avoir été créé avant de lancer ces commandes. L'utilisateur neolane est automatiquement créé lors de l'installation.
Le répertoire home associé à l'utilisateur neolane est lui aussi automatiquement créé sous /usr/local/neolane. Assurez-vous que /usr/local comporte suffisamment d'espace disque (quelques giga-octets sont nécessaires).
Vous pouvez tester si le serveur peut s'atteindre lui-même en lançant un pinghostname
.
Pour installer Adobe Campaign sur un système d'exploitation RPM (RHEL, CentOS et SUSE), les étapes sont les suivantes :
Vous devez au préalable accéder aux deux packages d'Adobe Campaign.
Le fichier est nommé comme ci-dessous, où XXXX représente le numéro de build d'Adobe Campaign :
Vérifiez que vous utilisez bien le nom de fichier correct pour votre version d'Adobe Campaign dans les exemples de commande de cette section.
Pour les installer, connectez-vous en tant que root et exécutez la commande suivante (où XXXX est le numéro de build d'Adobe Campaign) :
yum install nlserver6-v7-XXXX-0.x86_64.rpm
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 (par exemple, si vous souhaitez utiliser Oracle JDK au lieu d'OpenJDK), vous devrez peut-être utiliser l'option "nodeps" du fichier rpm :
rpm --nodeps -Uvh nlserver6-v7-XXXX-0.x86_64.rpm
La commande 'bc', nécessaire à l'exécution du netreport (voir cette section, pour plus d'informations) n'est pas présente par défaut sur toutes les distributions Linux. Pour vérifier si la commande est disponible, exécutez la commande 'which bc'. Si elle n'est pas présente, vous devez l'installer.
Sur CentOS, il faut installer le package bc.x86_64 : connectez-vous en tant que root et exécutez la commande suivante :
yum install bc.x86_64
Pour installer Adobe Campaign 64 bits sur un système d'exploitation Debian 64 bits, les étapes sont les suivantes :
Vous devez au préalable accéder aux deux packages d'Adobe Campaign.
XXXX est le numéro de build d'Adobe Campaign.
Vérifiez que vous utilisez bien le nom de fichier correct pour votre version d'Adobe Campaign dans les exemples de commande de cette section.
Pour les installer, connectez-vous en tant que root et exécutez la commande suivante (où XXXX est le numéro de build d'Adobe Campaign) :
dpkg -i nlserver6-v7-XXXX-linux-2.6-amd64.deb
S’il manque des dépendances, exécutez la commande suivante :
apt-get install -f
Particularités de Debian 8/9
Pour installer Adobe Campaign sur un système d’exploitation Debian 8/9, tenez compte des points suivants :
OpenSSL doit être installé préalablement.
Installer les librairies libicu52 (Debian 8) ou libicu57 (Debian 9), libprotobuf9 (Debian8) et libc-ares2 avec les commandes suivantes :
aptitude install libicu52 (Debian 8) libicu57 (Debian 9)
aptitude install libc-ares2
aptitude install libprotobuf9 (only Debian 8)
Installer le JDK7 avec la commande suivante :
aptitude install openjdk-7-jdk (Debian 8)
aptitude install openjdk-7-jdk (Debian 9)
Certains paramètres peuvent être personnalisés via le fichier customer.sh.
Si vous effectuez l'installation pour la première fois, le fichier customer.sh n'existe peut-être pas encore sur le serveur. Créez-le et assurez-vous qu'il dispose des droits d'exécution. Dans le cas contraire, saisissez la commande suivante :
chmod +x /usr/local/neolane/nl6/customer.sh
Par défaut, le serveur est démarré dans un environnement iso8859-15. Néanmoins, le serveur peut être démarré dans un environnement UTF-8.
Cette modification a une incidence sur les interactions avec le système de fichiers (fichiers chargés via un workflow ou un script JavaScript) et sur le codage des fichiers. Nous vous recommandons donc d'utiliser l'environnement par défaut.
Toutefois, pour la création d'une instance japonaise, l'utilisation d'un environnement UTF-8 est obligatoire.
Pour activer l'environnement UTF-8, utilisez la commande suivante :
mkdir -p /usr/local/neolane/nl6
touch /usr/local/neolane/nl6/unicodeenv
L'installation supporte à la fois le français et l'anglais. Par défaut, le serveur utilise l'anglais.
Pour basculer en français, saisissez les commandes suivantes :
su - neolane
vi nl6/customer.sh
et ajoutez la ligne suivante :
export neolane_LANG=fra
Pour garantir une bonne lecture des messages système, les consoles doivent être dans une page de codes correspondant à la langue (ISO-8859-1 ou -15 pour le français).
Les variables d'environnement suivantes doivent être définies correctement.
Certaines combinaisons nécessitent des modifications de l'environnement utilisé pour exécuter Adobe Campaign. Un fichier spécifique (/usr/local/neolane/nl6/customer.sh
) peut être créé et modifié pour ajouter des modifications spécifiques à l'environnement Adobe Campaign.
Au besoin, éditez le fichier customer.sh à l'aide de la commande vi customer.sh et adaptez la configuration ou ajoutez les lignes manquantes :
Pour le client Oracle :
export ORACLE_HOME=/usr/local/instantclient_10_2
export TNS_ADMIN=/etc/oracle
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH
Le contenu de la variable d'environnement ORACLE_HOME correspond au répertoire d'installation d'Oracle.
Le contenu de la variable TNS_ADMIN doit correspondre au répertoire d'enregistrement du fichier tnsnames.ora.
Pour LibreOffice :
Si vous souhaitez faire fonctionner Adobe Campaign sur une version de LibreOffice existante, une configuration complémentaire est nécessaire : vous devez indiquer les chemins d'accès aux répertoires d'installation. Par exemple :
Debian
Les valeurs par défaut de OOO_INSTALL_DIR et OOO_BASIS_INSTALL_DIR sont fournies. Vous pouvez les remplacer dans customer.sh si la disposition de l'installation LibreOffice est différente :
export OOO_BASIS_INSTALL_DIR=/usr/lib/libreoffice/
export OOO_INSTALL_DIR=/usr/lib/libreoffice/
CentOs
Utiliser les valeurs par défaut suivantes :
export OOO_BASIS_INSTALL_DIR=/usr/lib64/libreoffice/
export OOO_INSTALL_DIR=/usr/lib64/libreoffice/
Pour Java Development Kit (JDK) :
Par défaut, le script de configuration de l'environnement Adobe Campaign (~/nl6/env.sh
) recherche le répertoire d'installation du JDK. Ce comportement n'étant pas fiable à 100 %, vous devez indiquer le JDK à utiliser. Pour ce faire, vous pouvez forcer la variable d'environnement JDK_HOME à l'aide de la commande suivante :
export JDK_HOME=/usr/java/jdk1.6.0_07
Il s'agit ici d'un exemple. Assurez-vous que la version du JDK utilisée correspond au nom du répertoire.
Pour tester la configuration du JDK, connectez-vous en tant qu'utilisateur Adobe Campaign système avec la commande suivante :
su - neolane
Vous devez relancer le service Adobe Campaign afin que les changements d'environnement soient pris en compte.
Les commandes sont les suivantes :
/etc/init.d/nlserver6 stop
/etc/init.d/nlserver6 start
À compter de la version 20.1, nous vous recommandons d’utiliser plutôt la commande suivante :
systemctl stop nlserver
systemctl start nlserver
Lorsque vous utilisez Oracle avec Adobe Campaign, vous devez configurer les couches clientes Oracle sous Linux.
Utilisez la version cliente complète
Définition TNS
Vous devez ajouter vos définitions TNS lors de la phase d'installation. Pour cela, les commandes sont les suivantes :
cd /etc
mkdir oracle
cd oracle
vi tnsnames.ora
Variables d'environnement
Pour plus d'informations, consultez la section Variables d'environnement.
Paramétrage pour Adobe Campaign
Pour finaliser l'installation du client Oracle pour Adobe Campaign, vous devez créer un lien symbolique pour le fichier .so utilisé par Adobe Campaign.
Pour cela, les commandes sont les suivantes :
cd /usr/lib/oracle/10.2.0.4/client/lib
ln -s libclntsh.so.10.1 libclntsh.so
En cas de problème, vérifiez que les packages listés dans la documentation d'installation Oracle sont bien installés.
Vous pouvez procéder à un test initial de l'installation à l'aide des commandes suivantes :
su - neolane
nlserver pdump
Lorsque Adobe Campaign n'est pas démarré, la réponse est :
no task
Une fois le test d'installation réalisé, saisissez la commande suivante :
nlserver web
Les informations affichées sont alors les suivantes :
17:11:03 > Application server for Adobe Campaign Classic (7.X YY.R build XXX@SHA1) of DD/MM/YYYY
17:11:03 > Web server start (pid=17546, tid=-151316352)...
17:11:03 > Creating server configuration file '/usr/local/[INSTALL]/nl6/conf/serverConf.xml' via '/usr/local/[INSTALL]/nl6/conf/fra/serverConf.xml.sample'
17:11:03 > Creating server configuration file '/usr/local/[INSTALL]/nl6/conf/config-default.xml' via '/usr/local/[INSTALL]/nl6/conf/models/config-default.xml'
17:11:03 > Server started
17:11:08 > Stop requested (pid=17546)
17:11:08 > Web server stop(pid=17546, tid=-151316352)...
Ces commandes permettent de créer les fichiers de configuration config-default.xml et serverConf.xml. Tous les paramètres disponibles dans le fichier serverConf.xml sont répertoriés dans cette section.
Saisissez la combinaison Ctr+C pour arrêter le processus, puis la commande suivante :
nlserver start web
Les informations affichées sont alors les suivantes :
12:17:21 > Application server for Adobe Campaign Classic (7.X YY.R build XXX@SHA1) of DD/MM/YYYY
12:17:21 > Running task 'web@default' ('nlserver web -tracefile:web@default -instance:default -detach -tomcat -autorepair') in a new process
12:17:21 > Application server for Adobe Campaign Classic (7.X YY.R build XXX@SHA1) of DD/MM/YYYY
12:17:21 > Web server start (pid=29188, tid=-1224824320)...
12:17:21 > Creating server configuration file '/usr/local/[INSTALL]/nl6/conf/serverConf.xml' via '/usr/local/[INSTALL]/nl6/conf/fra/serverConf.xml.sample'
12:17:22 > Tomcat started
12:17:22 > Server started
Pour l'arrêter, saisissez :
nlserver stop web
Les informations affichées sont alors les suivantes :
12:18:31 > Application server for Adobe Campaign Classic (7.X YY.R build XXX@SHA1) of DD/MM/YYYY
12:18:31 > Stop requested for 'web@default' ('nlserver web -tracefile:web@default -instance:default -detach -tomcat -autorepair', pid=29188, tid=-1224824320)...
12:18:31 > Stop requested (pid=29188)
12:18:31 > Web server stopped (pid=29188, tid=-1224824320)...
Le serveur Adobe Campaign définit un identifiant (ou 'login') technique nommé internal qui possède tous les droits, sur toutes les instances. Après une installation récente, cet identifiant n'a pas de mot de passe. Il est obligatoire d'en définir un.
En savoir plus dans cette section.