Enabling single-user logging

If you have installed the Marketing Platform 10.0.0.1 FixPack, you can enable single-user logging.

About this task

Logging is configured using one of two files: log4j.properties or log4j.xml. By default, the log4j.properties file is used.

If you have installed the Marketing Platform 10.0.0.1 FixPack, you can enable per-user logging by configuring logging to use the XML file and then editing the XML file. If Marketing Platform is configured in a cluster deployment, copy the XML file to each node.

Note: With XML logging enabled, a thread is created that periodically checks if the XML configuration file has been created or modified. If a change or file creation is detected, then the XML file is read to configure log4j. The polling interval is 60 seconds.

Procedure

  1. Configure logging to use log4j.xml by setting the following JVM parameter.

    -DENABLE_PLATFORM_LOG4J_XML_LOGGING=true

    The value must be set to true to enable per-user logging.

    If Marketing Platform is configured in a cluster deployment, set this JVM parameter in each node of the cluster.

  2. To specify the user account to be logged in per-user logging, edit the log4j.xml file as shown in the following example.

    In the example, asm_admin is the user, but you can substitute any Marketing Platform user name.

    
    <filter class="com.unica.manager.logger.UserMatchFilter">
       <param name="StringToMatch" value="asm_admin" />
    </filter>
    
  3. If Marketing Platform is configured in a cluster deployment, copy the edited XML file to each node of the cluster.

    You can use a command like the one shown in the following example.

    -DPLATFORM_LOG4J_XML_FILE=log4j_node1.xml

    The log4j_node1.xml file is a copy of the log4j.xml file. You can use any name for the copied file.