Home
Administrator Guides
Administrator Guide
Unica Campaign listeners
The listener is a key component of Unica Campaign. It provides an interface between front-end clients and back-end analytical server processes.
Unica Campaign Listener (unica_aclsnr)
The Unica Campaign listener (unica_aclsnr) allows clients such as the Unica Campaign web application to connect to back-end analytical server processes.
Unica Campaign listener syntax and options
Use these options to install or uninstall unica_aclsnr as a Windows™ service, do a flowchart recovery run, or display the listener version.

Administrator Guides
- Administrator Guide
  - Unica Campaign administration overview
    The Settings menu provides access to most of the tasks that Unica Campaign administrators typically perform.
  - Security in Unica Campaign
    Security policies control user access to the objects and features in Unica Campaign.
  - Database table administration
    Unica Campaign administrators must perform initial one-time tasks and routine administration tasks that pertain to database tables.
  - Customizing campaigns
    Administrators can customize campaigns by using custom campaign attributes, initiatives, and products.
  - Offer template concepts
    Before administrators perform offer template management tasks, there are several important concepts to understand.
  - About audience level administration
    Unica Campaign is delivered with a single audience level called Customer. You can define any additional audience levels that you need. Audience levels let flowchart designers target specific groups, such as Households, in marketing campaigns.
  - Before you begin working with contact history
    Contact history is stored in the Unica Campaign system database in separate tables by audience level. Therefore, you need to set up audience levels before you begin working with contact history.
  - Response history administration
    Before you begin working with response history, you should read the audience level administration topics and set up required audience levels.
  - Monitoring and controlling flowchart runs
    Choose Campaign > Monitoring and use the All monitored runs page to view the status of all active flowcharts and suspend, resume, or stop flowchart runs.
  - Dimension hierarchy concepts
    A dimension hierarchy is a data construct that groups data into bins based on value ranges. Dimension hierarchies are the basis for a variety of reports.
  - Triggers administration
    Unica Campaign allows you to define inbound and outbound triggers that can be used in all flowcharts in a partition.
  - Unica Campaign log files
    Unica Campaign records information in several different log files.
  - JVM Parameters
  - About codes in Unica Campaign
    Each campaign, cell, offer, and treatment in Unica Campaign has an identifying code that is generated by code generators, and conforms to a specified format.
  - Accessing the Advanced settings
    When a flowchart is open for editing, administrators can choose the Advanced settings option on the Admin menu to make administrative changes that affect only the current flowchart.
  - Unica Campaign integration with other products
    Unica Campaign optionally integrates with a number of other products.
  - Unica Campaign listeners
    The listener is a key component of Unica Campaign. It provides an interface between front-end clients and back-end analytical server processes.
    - Definition of listener terms
      The following terms are used when discussing Unica Campaign listeners and listener clustering.
    - Front-end and back-end components
      Unica Campaign consists of two main components.
    - Unica Campaign Listener (unica_aclsnr)
      The Unica Campaign listener (unica_aclsnr) allows clients such as the Unica Campaign web application to connect to back-end analytical server processes.
      - Unica Campaign listener requirements
        The Unica Campaign listener requires that Unica Platform be running.
      - Unica Campaign listener syntax and options
        Use these options to install or uninstall unica_aclsnr as a Windows™ service, do a flowchart recovery run, or display the listener version.
    - Configuration settings for a single-node listener configuration
      The configuration properties for single-node listener environments are set automatically during installation or upgrade. However, you can adjust them by choosing Settings > Configuration.
    - Configuration settings for a clustered listener configuration
      The configuration properties for clustered listeners are set automatically during installation. However, you can adjust them by choosing Settings > Configuration.
    - Listener clustering
      Clustering involves the use of multiple listeners for the purpose of high availability and load balancing.
    - Diagram of listener clustering
      This diagram illustrates a three-node listener cluster configuration.
    - Supported listener clustering configurations
      This topic pertains to a clustered listener configuration.
    - The master listener
      A clustered listener configuration always includes a master listener. The master listener is a lightweight application whose job is to perform load balancing. It allocates requests to each of the running listeners in the cluster.
    - Load based routing load balancing
      This topic pertains to a clustered listener configuration. To achieve load balancing, Unica Campaign uses a load based routing algorithm. This algorithm maintains a weighted list of servers, where a heavier (higher) weight indicates preference.
    - Listener failover
      This topic pertains to a clustered listener configuration. As long as at least one Unica Campaign listener is viable, failover should occur without disruption.
    - Log files for clustered listeners
      Log files for a clustered listener configuration are in the following locations.
    - Shared network location for clustered listeners
      A clustered listener configuration for Unica Campaign requires that certain files and folders must be shared and accessible to all listeners in a cluster. Therefore, you must have a shared file system in place.
    - Utilities for clustered listeners
      In general, you use the Unica Campaign utilities in a clustered listener environment the same way that you use them in a single-node environment. However, there are some differences to be aware of.
    - Starting and stopping Unica Campaign listeners
      If you install a listener as a Windows™ service or as part of the init process on UNIX™, the listener starts automatically when you start the server. You can also start and stop a listener manually.
  - Unica Campaign utilities
    Administrators use the Unica Campaign utilities to manage listeners, sessions, and flowcharts, and perform other important administrative tasks.
  - Configuring the ACOOptAdmin tool
    Configure the ACOOptAdmin tool to run Unica Optimize sessions from the command line.
  - Non-ASCII data in Unica Campaign
    Unica Campaign supports the use of localized data and non-United States locales, including multiple user-preferred locales within the same installation of the application.
  - Configuration properties for Unica Campaign
    The configuration properties of Unica Campaign are located at SettingsConfiguration. For more details on the configuration properties, see the Campaign Administrator Guide.
  - About special characters
    Some special characters are not supported in any Unica Campaign object names. In addition, some objects have specific naming restrictions.
  - Introduction to character encodings
    This section provides information on character encodings and language-sensitive database considerations, and lists the encodings supported by Unica Campaign.
  - About Unica Campaign Error Codes
    Unica Campaign notifies users of error events when they occur with error messages that consist of a code number and error text.
  - Troubleshooting
- System Tables

Unica Campaign listener syntax and options

Use these options to install or uninstall unica_aclsnr as a Windows™ service, do a flowchart recovery run, or display the listener version.

Use the following syntax with the unica_aclsnr command:

unica_aclsnr {[-a] | [-i]} {[-n] | [-r]} [-d <service_dependencies>] [-u] [-v]

The unica_aclsnr utility supports the following options:

Table 1. Unica Campaign listener options
Option	Description
-a	This option installs the listener as a Windows™ service with auto-restart functionality. If the listener process fails to start or if it stops unexpectedly, this option tries to restart it automatically. It makes two retry attempts within a specified time period. This option is supported for both single-node and clustered listener configurations.
-i	This option installs the listener as a Windows™ service without auto-restart functionality. If the listener is unavailable, it will not be restarted.
-r (the default)	This option starts a recovery run by forcing the listener to find and register any running flowcharts. Use this parameter if for some reason the listener goes down and flowcharts (`unica_acsvr` processes) are still running. The listener stores flowchart information in a text file (`unica_acslnr.udb`). When you use `-r`, the listener checks the .udb file for running flowcharts and re-establishes the connections. Even if the running flowchart processes (flowchart and branch production runs only) went down with the listener, the listener reloads those flowcharts and resumes running them from the last saved checkpoints.
-n	The opposite of `-r`. This option prevents the listener from checking the `unica_acslnr.udb` file.
-d	`[-d <service_dependencies>]` is an optional argument that tells the Microsoft™ Windows™ operating system to wait until the services in <service_dependencies> are completely started before launching the Unica Campaign listener. The most common use case is when the web application server that runs Unica Campaign is also installed as a service, because the web application server must be fully launched and running before you launch the Unica Campaign listener. To specify multiple services, use a comma-separated list. Use the Service name defined in Windows™ Services.
-u	This option uninstalls the listener as a service (Windows™ only).
-v	This option displays the current version of the listener.

Have feedback?
Google Analytics is used to store comments and ratings. To provide a comment or rating for a topic, click Accept All Cookies or Allow All in Cookie Preferences in the footer of this page.