Shared network location for clustered listeners: campaignSharedHome

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.

Requirements

  • The common area can be a machine or location that is accessible from all other machines in the listener cluster.
  • Each listener in a cluster must have full access to the shared files and folders.
  • Best practice is for all listeners to be on the same network, and for the shared home to also be on that network, to avoid latency issues.
  • To avoid any single point of failure, the shared file system should use mirrored RAID or an equivalent method of redundancy.
  • If you are installing a single-listener configuration, a shared file system is a best practice, in case you decide to implement listener clusters in the future.

Shared files and folders

In a clustered configuration, all listeners share the folder structure shown below. The shared location (<campaignSharedHome>) is specified at installation time and is configurable at Campaign|campaignClustering|campaignSharedHome. The shared partition contains all logs, campaigns, templates, and other files.

campaignSharedHome
 |--->/conf
    |------> activeSessions.udb
    |------> deadSessions.udb
    |------> etc.
 |--->/logs
    |------> masterlistener.log
    |------> etc.
 |--->/partitions
    |------> partition[n]
       |----------> {similar to <Campaign_home> partition folder structure} 

Files and folders that are not shared

Each Unica Campaign listener has its set of folders and files that are not shared, under <Campaign_home>. Campaign_home is an environment variable that represents the Unica Campaign application installation directory. This variable is set in cmpServer.bat (Windows) or rc.unica_ac.sh (UNIX). Partitions are specific to the local listener. Each local partition folder contains a tmp folder for temporary files during flowchart runs and a conf folder for the table manager cache file.
Campaign_home
 |--->/conf
    |------> config.xml
    |------> unica_aclsnr.pid
    |------> unica_aclsnr.udb
    |------> etc.
 |--->/logs
    |------> unica_aclsnr.log
    |------> etc.
 |--->/partitions
    |------> partition[n]
       |---------->/tmp
       |---------->/conf
       |---------->{other files specific to the partition}