Installation de packages avec Linux

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 :

• Copier les fichiers sous /usr/local/neolane
• Créer un compte Linux Adobe Campaign (et le groupe associé), avec pour répertoire racine (home directory) : /usr/local/neolane,
• Créer un script de démarrage automatique au démarrage /etc/init.d/nlserver6, ou créer une unité systemd (à partir de la version 20.1).

Vous pouvez tester si le serveur peut s'atteindre lui-même en lançant un pinghostname.

Distribution basée sur les packages RPM

Pour installer Adobe Campaign sur un système d'exploitation RPM (RHEL, CentOS et SUSE), les étapes sont les suivantes :

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

   • nlserver6-v7-XXXX-0.x86_64.rpm for v7.
   • nlserver6-XXXX-0.x86_64.rpm for v6.1.
   ATTENTION

   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.

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

Distribution basée sur ATP (Debian)

Sous Debian 64 bits

Pour installer Adobe Campaign 64 bits sur un système d'exploitation Debian 64 bits, les étapes sont les suivantes :

1. Vous devez au préalable accéder aux deux packages d'Adobe Campaign.

   • nlserver6-v7-XXXX-linux-2.6-amd64.deb for v7.
   • nlserver6-XXXX-linux-2.6-amd64.deb for v6.1.

   XXXX est le numéro de build d'Adobe Campaign.

   ATTENTION

   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.

2. 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)
  

Personnaliser les paramètres

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

Encodage du serveur

Par défaut, le serveur est lancé dans un environnement iso8859-15. Il est toutefois possible de lancer le serveur dans un environnement UTF-8.

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

Langue par défaut pour le serveur

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

Variables d'environnement

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, OOO_BASIS_INSTALL_DIR et OOO_URE_INSTALL_DIR sont fournies. Vous pouvez les remplacer dans customer.sh si votre installation LibreOffice est différente :

    export OOO_BASIS_INSTALL_DIR=/usr/lib/libreoffice/ 
    export OOO_INSTALL_DIR=/usr/lib/libreoffice/
    export OOO_URE_INSTALL_DIR=/usr/lib/ure/share/
    

  • CentOs

    Utiliser les valeurs par défaut suivantes :

    export OOO_BASIS_INSTALL_DIR=/usr/lib64/libreoffice/
    export OOO_INSTALL_DIR=/usr/lib64/libreoffice/
    export OOO_URE_INSTALL_DIR=/usr/lib64/libreoffice/ure/share/
    

• 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
  

  REMARQUE

  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

Client Oracle sous Linux

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

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

Vérification de l'installation

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

Premier démarrage du serveur

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

Mot de passe de l'identifiant internal

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.