v7 on-premise & hybrid

Operating principle

Last update: 2023-07-31

Technically, the Adobe Campaign platform is based on several modules.

There are many Adobe Campaign modules. Some operate continuously, while others are started up occasionally to perform administrative tasks (e.g. to configure the database connection) or to run a recurrent task (e.g. consolidating tracking information).

There are three types of Adobe Campaign modules:

  • Multi-instance modules: a single process is run for all instances. This applies to the following modules: web, syslogd, trackinglogd and watchdog (activities from the config-default.xml file).
  • Mono-instance modules: one process is run per instance. This applies to the following modules: mta, wfserver, inMail, sms and stat (activities from the config-<instance>.xml file).
  • Utility modules: these are modules that are run occasionally to perform occasional or recurrent operations (cleanup, config, downloading tracking logs, etc.).

Module administration is performed using the command line tool nlserver installed in the bin directory of the installation folder.

The general syntax of the nlserver tool is as follows:

nlserver <command> <command arguments>

For the list of available modules, use the nlserver command.

The available modules are detailed in the following table:

Command Description
aliasCleansing Standardizing enumeration values
billing Sending the system activity report to billing@neolane.net
cleanup Cleansing the database: deletes obsolete data from the database and runs an update of the statistics used by the database engine optimizer.
config Modifying server configuration
export Exporting to command line: lets you send to the command line an export model created in the Adobe Campaign client console
fileconvert Converting a set size file
import Importing to command line: lets you send to the command line an import model created in the Adobe Campaign client console.
inMail Inbound mail analyzer
installsetup Availability of the customer installation file
javascript Executing JavaScript scripts, with access to SOAP APIs.
job Command line processing
merge Form merge
midSourcing Recovery of delivery information in mid-sourcing mode
monitor XML Displaying of the status of server processes and scheduled tasks, by instance.
mta Main Agent transfer message
package Importing or exporting entity package files
pdump Displaying server process statuses
prepareda Preparing a delivery action
restart Partial server restart
runwf Execution of a workflow instance
shutdown Full system shutdown
sms SMS notification processing
sql SQL script execution
start Additional starts
stat Maintains MTA connection statistics
stop Partial system shutdown
submitda Submitting a delivery action
syslogd Log and trace writing server
tracking Consolidating and retrieving tracking logs
trackinglogd Tracking log writing and purging server
watchdog Startup and monitoring instance
web Application server (HTTP and SOAP)
wfserver Workflow server
IMPORTANT

There is one last module: the tracking and relay module linked to the application server which, for the sake of performance, is integrated via native mechanisms into an Apache or IIS web server via a dynamic library. There is no Adobe Campaign command enabling you to start or administer this module. You must therefore use the commands of the Web server itself.

Module usage and the syntax of its parameters are displayed using the following command: nlserver [module] -?

Example:

nlserver config -?

Usage: nlserver [-verbose:<verbose mode>] [-?|h|H] [-version] [-noconsole]
 [-tracefile:<file>] [-tracefilter:<[type|!type],...>]
 [-instance:<instance>] [-low] [-high] [-queryplans] [-detach]
 [-internalpassword:<[password/newpassword]>] [-postupgrade]
 [-nogenschema] [-force] [-allinstances]
 [-addinstance:<instance/DNS masks[/language]>]
 [-setdblogin:<[dbms:]account[:database][/password]@server>]
 [-monoinstance]
 [-addtrackinginstance:<instance/masks DNS[/databaseId/[/language[/password]]]>]
 [-trackingpassword:<[password][/newpassword]>]
 [-setproxy:<protocol/server:port[/login]>] [-reload]
 [-applyxsl:<schema/file.xsl>] [-filter:<file>]
 [-setactivationkey:<activation key>]
 [-getactivationkey:<client identifier>]
-verbose : verbose mode
-? : display this help message
-version : display version number
-noconsole : no longer display logs and traces on the console
-tracefile : name of trace file to be generated (without extension)
-tracefilter : filter for the traces to be generated e.g.: wdbc,soap,!xtkquery.
-instance : instance to be used (default instance if this option is not present).
-low : start up with low priority
-high : start up with high priority (not recommended)
-queryplans : generate traces with the execution plans of SQL queries.
-detach : detaches the process from its parent (internal option)
-internalpassword : changes the password of the server internal account.
-postupgrade : updates the database following upgrade to a higher version.
-nogenschema : does not recompute the schemas during database update
-force : updates the database even if this has already been done with the current build
-allinstances : updates the database over all configured instances
-addinstance : adds a new instance.
-setdblogin : sets the parameters for connection to the database of an instance. The DBMS can be 'oracle', 'postgresql', 'mssql' or 'odbc' (default=postgresql)
-monoinstance : initializes for a single instance ().
-addtrackinginstance : adds a new tracking instance.
-trackingpassword : changes the tracking password of an instance
-setproxy : sets the parameters for connection to a proxy server. The protocol can be 'http', 'https' or 'all'.
-reload : asks the server to reload the configuration of the instances.
-applyxsl : applies an XSL stylesheet to all entities of a schema.
-filter : applies the XTK filter contained in the file during loading of the schema entities.
-setactivationkey : sets the activation key

On this page