Campaign |unicaACListener
Properties in this category specify logging levels, certain access privileges, language encodings, number of operating system threads, and the protocol, host, and port of the Campaign listener. These properties need to be set only once per instance of Campaign; they do not need to be set for every partition.
enableWindowsImpersonation
Description
The enableWindowsImpersonation property specifies whether Windows Impersonation is enabled in Campaign Windows. For more details about Windows Impersonation in Campaign, see the Campaign Administrator’s Guide.
Set the value to TRUE to use Windows Impersonation.
Set the value to FALSE if Windows Impersonation is not used.
Default value
FALSE
Valid Values
TRUE | FALSE
enableWindowsEventLogging
Description
The Campaign > unicaACListener > enableWindowsEventLogging property controls logging to the Windows event log. Set this property to TRUE to log to the Windows event log.
Default value
FALSE
Valid Values
TRUE | FALSE
serverHost
Description
The serverHost property specifies the name or IP address of the machine where the Campaign listener is installed. If the Campaign listener is not installed on the same machine where IBM® Unica Marketing is installed, change the value to the machine name or IP address of the machine where the Campaign listener is installed.
Default value
localhost
logMaxBackupIndex
Description
The logMaxBackupIndex property specifies how many backup files can exist before the oldest one is deleted. If you set this property to 0 (zero), Campaign does not create any backup files and the log file stops logging when it reaches the size you specified in the logMaxFileSize property.
If you specify a number (N) for this property, when the log file (File) reaches the size you specified in the logMaxFileSize property, Campaign renames the existing backup files (File.1 ... File.N-1) to File.2 ... File.N , renames the current log file File.1, closes it, and and starts a new log file named File.
Default value
1 (creates one backup file)
logStringEncoding
Description
The logStringEncoding property controls the encoding used for all log files. This value should match the encoding used on the operating system. For multi-locale environments, UTF-8 is the preferred setting.
If you change this value, you should empty or remove all affected log files to prevent writing multiple encodings into a single file.
*
WIDEUTF-8 is not supported for this setting.
Default value
native
Valid Values
See the Campaign Administrator's Guide for a list of supported encodings.
systemStringEncoding
Description
The systemStringEncoding property specifies the encoding(s) used to interpret values coming into Campaign from the operating system (file system paths and filenames, for example), as well as the encoding in which Campaign presents values back to the operating system. This value should be generally be set to native. For multi-locale environments, UTF-8 is the preferred setting.
The value can include more than one encoding, separated by commas: for example,
UTF-8,ISO-8859,CP950
*
WIDEUTF-8 is not supported for this setting.
Default value
native
Valid Values
See the Campaign Administrator's Guide for a list of supported encodings.
loggingLevels
Description
The Campaign > unicaACListener > loggingLevels property controls the amount of detail written to the log file.
Default value
MEDIUM
Valid Values
*
*
*
maxReuseThreads
Description
The Campaign > unicaACListener > maxReuseThreads property sets the number of operating system threads cached by the Campaign listener process (unica_aclsnr) for reuse.
It is a best practice to use the cache when you want to reduce the overhead of thread allocation, or with operating systems that can exhibit an inability to release threads when asked to do so by an application.
Default value
0 (zero), which disables the cache
logMaxFileSize
Description
The logMaxFileSize property specifies the maximum size, in bytes, that the log file can reach before rolling into the backup file.
Default value
10485760 (10 MB)
windowsEventLoggingLevels
Description
The windowsEventLoggingLevels property controls the amount of detail written to the Windows event log file based on severity.
Default value
MEDIUM
Valid Values
*
*
*
*
The ALL level includes trace messages intended for diagnostic purposes.
serverPort
Description
The serverPort property specifies the port where the Campaign listener is installed.
Default value
4664
useSSL
Description
The useSSL property specifies whether to use Secure Sockets Layer for communications between the Campaign listener and the Campaign web application.
Default value
no
Valid Values
yes | no
keepalive
Description
Use the keepalive property to specify, in seconds, the frequency with which the Campaign web application server sends keep alive messages on otherwise-inactive socket connections to the Campaign listener.
Using the keepalive configuration parameter enables socket connections to remain open through extended periods of application inactivity in environments configured to close inactive connections between the web application and the listener (for example, a firewall).
When there is activity on a socket, the keep alive period is automatically reset. At the DEBUG logging level in the web application server, the campaignweb.log will show evidence of the keep alive messages as they are sent to the listener.
Default value
0, which disables the keepalive feature
Valid Values
positive integers