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.
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.
Listener failover scenario 2: Non-master listener node fails
This topic pertains to a clustered listener configuration. In this scenario, the master listener node is unresponsive. Either the node is down or is not reachable due to network issues.

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.
    - 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.
      - Listener failover scenario 1: Non-master listener node fails
        This topic pertains to a clustered listener configuration. In this scenario, a non-master listener node is unresponsive. Either the node is down or is not reachable due to network issues.
      - Listener failover scenario 2: Non-master listener node fails
        This topic pertains to a clustered listener configuration. In this scenario, the master listener node is unresponsive. Either the node is down or is not reachable due to network issues.
    - 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

Listener failover scenario 2: Master listener node fails

This topic pertains to a clustered listener configuration. In this scenario, the master listener node is unresponsive. Either the node is down or is not reachable due to network issues.

The node is determined to be unresponsive based on a limited number of retries within a certain time period.

In this case, the Unica Campaign web application asks the next node in the cluster to become the master listener, based on masterListenerPriority. The node becomes the master listener based on master listener election and takes over load balancing duties. The master listener also performs session synchronization between multiple listeners.

When the unresponsive node comes back up, it performs as a non-master listener. It does not automatically regain master listener status. If you want to make a different listener the master listener, you must stop the currently serving master listener first.

The cluster configuration changes are recorded in the masterlistener.log.

Note: If a user was editing a flowchart or other object, any unsaved data is lost. The cluster automatically re-establishes the connection to the same session file (.ses) for the flowchart in Edit mode. However, any data that was not saved (either manually or by configured checkpointFrequency and autosaveFrequency) is lost.

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.