DocumentazioneCampaignDocumentazione di Campaign Classic v7

Solo on-premise/ibrido

Installazione di pacchetti con Linux

16 gennaio 2025
  • Argomenti:
  • Impostazioni applicazione

Adobe Campaign viene fornito con il pacchetto nlserver che contiene i file binari e di configurazione per una determinata versione.

I comandi di installazione consentono di:

  • Copia i file in /usr/local/neolane
  • Creare un account Adobe Campaign Linux (e il gruppo associato) creato con /usr/local/neolane come home directory
  • Creare uno script automatico /etc/init.d/nlserver6 da utilizzare all'avvio o creare un'unità di sistema
NOTE
L'utente di sistema neolane non deve essere stato creato prima dell'esecuzione del comando. L'utente neolane viene creato automaticamente durante l'installazione.
Anche la directory home collegata all'utente neolane viene creata automaticamente in /usr/local/neolane. Verificare che lo spazio sul disco /usr/local sia sufficiente.

È possibile eseguire il comando pinghostname per assicurarsi che il server possa raggiungere se stesso.

Distribuzione basata su pacchetti RPM

AVAILABILITY
A partire dalla versione 7.4.1, le librerie XML per i pacchetti RPM Linux non sono più incluse in Campaign. È necessario installare queste librerie.

Per installare Adobe Campaign su un sistema operativo RPM (RHEL, CentOS), effettuare le seguenti operazioni:

  1. Ottieni il pacchetto Adobe Campaign. Il nome del file è nlserver6-v7-XXXX-0.x86_64.rpm, dove XXXX è il numero di build di Adobe Campaign.

    CAUTION
    Assicurati di utilizzare il nome file corretto per la versione di Adobe Campaign negli esempi di comandi di questa sezione.

  2. Per installarlo, connettiti come root ed esegui il seguente comando, dove XXXX è il numero di build di Adobe Campaign:

    yum install nlserver6-v7-XXXX-0.x86_64.rpm

    Il file rpm dipende dai pacchetti che si trovano nelle distribuzioni CentOS/Red Hat. Se non desideri utilizzare alcune di queste dipendenze (ad esempio, se desideri utilizzare Oracle JDK invece di OpenJDK), potresti dover utilizzare l’opzione "nodeps" di rpm:

    rpm --nodeps -Uvh nlserver6-v7-XXXX-0.x86_64.rpm

Si noti che la maggior parte delle dipendenze elencate è obbligatoria e nlserver non può essere avviata se non è installata (l'eccezione è aperta; è possibile installare un altro JDK).

Il comando bc, obbligatorio per l'esecuzione di netreport, non è disponibile per impostazione predefinita in tutte le distribuzioni Linux. Per verificare se il comando è disponibile, eseguire il comando which bc. In caso contrario, devi installarlo.

Con CentOS è necessario installare il pacchetto bc.x86_64: connettiti come root ed esegui il comando seguente:

yum install bc.x86_64

RHEL 9 per distribuzioni on-premise

Con Campaign v7.4.1, in qualità di cliente on-premise che utilizza RHEL 9, se desideri utilizzare l’autenticazione DKIM (Domain Keys Identified Mail), devi aggiornare le impostazioni di sistema.

Per eseguire questa operazione, eseguire la procedura seguente:

  1. Esegui il comando seguente come radice:
update-crypto-policies --set LEGACY
  1. Riavvia il modulo MTA:
nlserver restart mta@<instance-name>

Distribuzione basata su APT (Debian)

Per installare Adobe Campaign su un sistema operativo Debian a 64 bit, attieniti alla seguente procedura:

  1. Ottieni il pacchetto Adobe Campaign. Il nome del file è nlserver6-v7-XXXX-linux-2.6-amd64.deb, dove XXXX è il numero di build di Adobe Campaign.

    CAUTION
    Assicurati di utilizzare il nome file corretto per la versione di Adobe Campaign negli esempi di comandi di questa sezione.

  2. Per installarlo, connettiti come root ed esegui il seguente comando, dove XXXX è il numero di build di Adobe Campaign:

    apt install ./nlserver6-v7-XXXX-linux-2.6-amd64.deb

Personalizzazione dei parametri

Alcuni parametri possono essere personalizzati tramite il file customer.sh

Se si esegue l'installazione per la prima volta, è possibile che il file customer.sh non esista ancora nel server.

Creala e assicurati che disponga dei diritti di esecuzione. In caso contrario, immetti il seguente comando:

chmod +x /usr/local/neolane/nl6/customer.sh

Codifica server

Per impostazione predefinita, il server viene avviato in un ambiente iso8859-15. Tuttavia, il server può essere avviato in un ambiente UTF-8.

CAUTION
Questa modifica influisce sulle interazioni con il file system (file caricati tramite un flusso di lavoro o uno script di JavaScript) e sulla codifica del file. È quindi consigliabile utilizzare l’ambiente predefinito.

Per creare una istanza giapponese, è necessario utilizzare un ambiente UTF-8.

Per abilitare l’ambiente UTF-8, utilizza il seguente comando:

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

Variabili di ambiente

Le seguenti variabili di ambiente devono essere definite correttamente.

Alcune combinazioni richiedono modifiche all’ambiente utilizzato per eseguire Adobe Campaign. È possibile creare e modificare un file specifico (/usr/local/neolane/nl6/customer.sh) per aggiungere modifiche specifiche all'ambiente Adobe Campaign.

Se necessario, modificare il file customer.sh utilizzando il comando vi customer.sh e adattare la configurazione o aggiungere le righe mancanti:

  • Per il client di Oracle:

    export ORACLE_HOME=/usr/local/instantclient_10_2
export TNS_ADMIN=/etc/oracle
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH

    Il contenuto della variabile di ambiente ORACLE_HOME corrisponde alla directory di installazione di Oracle.

    Il contenuto della variabile TNS_ADMIN deve corrispondere alla posizione del file tnsnames.ora.

  • Per LibreOffice:

    Per eseguire Adobe Campaign su una versione esistente di LibreOffice, sono necessarie configurazioni aggiuntive: è necessario specificare i percorsi di accesso alla directory di installazione. Ad esempio:

    • Debian

      Vengono forniti i valori predefiniti per OOO_INSTALL_DIR e OOO_BASIS_INSTALL_DIR. È possibile sostituirli in customer.sh se il layout dell'installazione di LibreOffice è diverso:

      export OOO_BASIS_INSTALL_DIR=/usr/lib/libreoffice/
export OOO_INSTALL_DIR=/usr/lib/libreoffice/

    • CentOs

      Utilizza i seguenti valori predefiniti:

      export OOO_BASIS_INSTALL_DIR=/usr/lib64/libreoffice/
export OOO_INSTALL_DIR=/usr/lib64/libreoffice/

  • Per Java Development Kit (JDK):

    Per impostazione predefinita, lo script di configurazione dell'ambiente Adobe Campaign (~/nl6/env.sh) cerca la directory di installazione JDK. Tuttavia, si consiglia di specificare quale JDK deve essere utilizzato. A tale scopo, è possibile forzare la variabile di ambiente JDK_HOME utilizzando il comando seguente:

    export JDK_HOME=/usr/java/jdkX.Y.Z
    NOTE
    Assicurati che la versione JDK utilizzata corrisponda al nome della directory.

    Per testare la configurazione JDK, accedi come utente di Adobe Campaign con il seguente comando:

    su - neolane

Per poter tenere conto delle modifiche, è necessario riavviare il servizio Adobe Campaign.

I comandi sono i seguenti:

systemctl stop nlserver
systemctl start nlserver

Client Oracle in Linux

Quando si utilizza Oracle con Adobe Campaign, è necessario configurare i livelli client Oracle in Linux.

  • Utilizza il client completo

  • Definizione TNS

    Le definizioni TNS devono essere aggiunte durante la fase di installazione. A tale scopo, utilizzare i seguenti comandi:

    cd /etc
mkdir oracle
cd oracle
vi tnsnames.ora

  • Variabili di ambiente

    Consulta Variabili di ambiente.

  • Configurazione per Adobe Campaign

    Per completare l'installazione del client Oracle per Adobe Campaign, è necessario creare un collegamento simbolico per il file .so utilizzato da Adobe Campaign.

    A tale scopo, utilizzare i seguenti comandi:

    cd /usr/lib/oracle/10.2.0.4/client/lib
ln -s libclntsh.so.10.1 libclntsh.so

In caso di problemi, assicurati che i pacchetti elencati nella documentazione di installazione di Oracle siano installati correttamente.

Controlli di installazione

È ora possibile eseguire un test di installazione iniziale utilizzando i seguenti comandi:

su - neolane
nlserver pdump

Quando Adobe Campaign non viene avviato, la risposta è:

no task

Primo avvio del server

Una volta completato il test di installazione, immettere il seguente comando:

nlserver web

Vengono quindi visualizzate le seguenti informazioni:

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

Questi comandi consentono di creare config-default.xml e serverConf.xml file di configurazione. Tutti i parametri disponibili in serverConf.xml sono elencati in questa sezione.

Premere Ctrl+C per arrestare il processo, quindi immettere il comando seguente:

nlserver start web

Vengono quindi visualizzate le seguenti informazioni:

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

Per interromperlo, immetti:

nlserver stop web

Vengono quindi visualizzate le seguenti informazioni:

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

Password per l’identificatore interno

Il server Adobe Campaign definisce un account di accesso tecnico denominato internal che dispone di tutti i diritti su tutte le istanze. Subito dopo l'installazione, l'account di accesso non dispone di una password. È obbligatorio definirne uno.

Per ulteriori informazioni, consulta questa sezione.

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