[On-Premise/hybride uniquement]{class="badge yellow" title="S’applique uniquement aux déploiements on-premise et hybrides"}

Installation de packages avec Linux installing-packages-with-linux

Adobe Campaign est fourni avec le package nlserver qui contient les fichiers binaires et 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éez un script automatique /etc/init.d/nlserver6 à utiliser au démarrage ou créez une unité systemd.
NOTE
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 dispose de suffisamment d’espace disque.

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

Distribution basée sur les packages RPM distribution-based-on-rpm--packages

Pour installer Adobe Campaign sur un système d’exploitation RPM (RHEL, CentOS), suivez les étapes ci-après :

  1. Récupérez le package Adobe Campaign. Le nom du fichier est nlserver6-v7-XXXX-0.x86_64.rpm, où XXXX est le numéro de build d’Adobe Campaign.

    note caution
    CAUTION
    Vérifiez que vous utilisez bien le nom de fichier correct pour votre version d’Adobe Campaign dans les exemples de commandes de cette section.
  2. Pour l’installer, connectez-vous en tant que root et exécutez la commande suivante (où XXXX est le numéro de build d’Adobe Campaign) :

    code language-none
    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 :

    code language-none
    rpm --nodeps -Uvh nlserver6-v7-XXXX-0.x86_64.rpm
    

La commande bc, obligatoire pour exécuter le script netreport, n’est pas disponible 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) distribution-based-on-apt--debian-

Pour installer Adobe Campaign sur un système d’exploitation Debian 64 bits, suivez les étapes ci-après :

  1. Récupérez le package Adobe Campaign. Le nom du fichier est nlserver6-v7-XXXX-linux-2.6-amd64.deb, où XXXX est le numéro de build d’Adobe Campaign.

    note caution
    CAUTION
    Vérifiez que vous utilisez bien le nom de fichier correct pour votre version d’Adobe Campaign dans les exemples de commandes de cette section.
  2. Pour l’installer, connectez-vous en tant que root et exécutez la commande suivante (où XXXX est le numéro de build d’Adobe Campaign) :

    code language-none
    dpkg -i nlserver6-v7-XXXX-linux-2.6-amd64.deb
    

    S’il manque des dépendances, exécutez la commande suivante :

    code language-none
    apt-get install -f
    
  3. Lors de l’installation d’Adobe Campaign sur un système d’exploitation Debian, tenez compte des éléments suivants :

  • OpenSSL doit être installé préalablement.

  • Installez libicu et libc-aresXX, où XX est la version, avec les commandes suivantes :

    code language-none
    apt install libicuXX
    
    code language-none
    apt install libc-aresXX
    
    code language-none
    apt install openjdk-XX-jdk
    

Personnaliser les paramètres personalizing-parameters

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 server-encoding

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.

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

Pour créer une instance en japonais, vous devez utiliser un environnement UTF-8.

Pour activer l’environnement UTF-8, utilisez la commande suivante :

mkdir -p /usr/local/neolane/nl6
touch /usr/local/neolane/nl6/unicodeenv

Variables d'environnement environment-variables

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 :

    code language-none
    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 :

      code language-none
      export OOO_BASIS_INSTALL_DIR=/usr/lib/libreoffice/
      export OOO_INSTALL_DIR=/usr/lib/libreoffice/
      
    • CentOs

      Utiliser les valeurs par défaut suivantes :

      code language-none
      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. Il est toutefois recommandé de spécifier le JDK à utiliser. Pour ce faire, vous pouvez forcer la variable d’environnement JDK_HOME à l’aide de la commande suivante :

    code language-none
    export JDK_HOME=/usr/java/jdkX.Y.Z
    
    note note
    NOTE
    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 :

    code language-none
    su - neolane
    

Vous devez relancer le service Adobe Campaign afin que les changements d'environnement soient pris en compte.

Les commandes sont les suivantes :

systemctl stop nlserver
systemctl start nlserver

Client Oracle sous Linux oracle-client-in-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 :

    code language-none
    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 :

    code language-none
    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 répertoriés dans la documentation d’installation Oracle sont bien installés.

Vérification de l'installation installation-checks

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 first-start-up-of-the-server

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 password-for-the-internal-identifier

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.

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1