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}