Generating logs for each node in a cluster deployment

You can generate logs for each node where you deploy Marketing Platform. You can specify different logging levels for each node in your cluster.

Procedure

Complete one of the following actions to generate logs for each node in your Marketing Platform cluster deployment:
  • Share the location where Marketing Platform is installed on all nodes of the cluster. To share the location, you must install Marketing Platform on a shared drive that is accessible from all nodes. Complete the following actions to share the location:
    1. Add the JVM parameter in the each node. Use the following command to add the JVM parameter: -DPLATFORM_LOG4J_PROPERTIES_FILE=log4j_node1.properties, where the log4j_node1.properties is a copy of the log4j.properties file. You can change the name of the property file.
    2. Use the following command to set the JVM parameter log4j.appender.System.File=Log_File_Name
      For example: log4j.appender.System.File=platform_node1.log
    3. Complete steps 1 and 2 for all the nodes in the cluster. Make sure that the log file names are different to identify the file generated from each node.
    4. Restart the cluster.
      All the log files are created in the PLATFORM_HOME/Platform/logs directory.
  • If the Marketing Platform deployment is not shared on all the nodes of the cluster, use the DUNICA_PLATFORM_HOME directory as a Java™ parameter that points to the location where the logs are generated. Complete the following actions to generate log files for each node in your cluster by changing the Java parameter:
    1. Use the following command to specify the Java parameter: -DUNICA_PLATFORM_HOME=path_where_log_files_are_generated
      For example: UNICA_PLATFORM_HOME=/opt/Platform
    2. Create the following directories at the location where log files are generated: conf and logs
    3. Provide the write permission to the logs directory.
    4. Copy the log4j.properties file in the conf directory. The log4j.properties is located in the Marketing Platform installation directory.
    5. Restart the cluster.
  • Replicate the Marketing Platform installation directory structure on all nodes of the cluster. Complete the following actions to replicate the directory structure:
    1. Create a same directory structure on each node till the PLATFORM_HOME/Platform/conf/ directory.
    2. Create the logs directory in the PLATFORM_HOME/Platform directory, and provide the write permission to the logs directory.
    3. Copy the log4j.properties file in the conf directory. The log4j.properties is located in the Marketing Platform installation directory.
      You do not need to add DUNICA_PLATFORM_HOME as a Java parameter.