Process Automation - Increase logging levels, file size and rollover for PAM logs

book

Article ID: 9347

calendar_today

Updated On:

Products

CA Service Management - Service Desk Manager CA Process Automation Base Process Automation Manager

Issue/Introduction

This document will outline the steps to modify the logging levels, the file size of those logs for rollover and the number of total logs retained by Process Automation.

To assist Broadcom Support in troubleshooting issues, logging levels often need to be increased in order to capture the full output of the problem. ERROR level logs (which is what you will normally see) do not necessarily mean that there was a problem. This is usually just normal output of activity.

And because Process Automation uses the embedded JBoss application server, it relies on Apache Log4j for the logging mechanism, and it does not utilize exception logging. 

Environment

Process Automation - All Versions

Resolution

SETUP ORCHESTATOR LOGGING:

Make sure to monitor disk space on the drive where Process Automation is installed, and make sure to clean up and delete unnecessary log files on a regular basis. The /log/ folder itself can be deleted (when the orchestrator is stopped) and the folder will be recreated when the orchestrator is restarted.

If you make a copy of the following file, this copy must be moved to a backup location outside of the /PAM/ folder structure.

To enable INFO level logging, open the log4j.xml file located in the /PAM/server/c2o/conf folder with a text editor.

Search for JXTA and in that section where JXTA appears as shown here:

   <!-- A size based file rolling appender for C2O and JXTA Logs-->
   <appender name="C2OFILE" class="org.jboss.logging.appender.RollingFileAppender">
   <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>
   <param name="File" value="${jboss.server.home.dir}/log/c2o.log"/>
   <param name="Threshold" value="WARN"/>
   <param name="Append" value="true"/>
   <param name="MaxFileSize" value="50000KB"/>
   <param name="MaxBackupIndex" value="3"/>

Change 

<param name="Threshold" value="WARN"/>

to

<param name="Threshold" value="INFO"/>

 

Next, search for "root" - no quotes. In the section that appears for root shown below:

 

   <!-- ======================= -->
   <!-- Setup the Root category -->  
   <!-- ======================= -->

   <root>
<priority value="WARN" />
        <appender-ref ref="CONSOLE"/>  
        <appender-ref ref="C2OFILE"/>    
        </root>

Change

<priority value="WARN" />

to

<priority value="INFO" />

 

You do not need to restart PAM for this to take effect, it is a dynamic change. Support may request you clear the log files to get fresh results which will require a restart.


Additional Information

In the JXTA section, you may also specify the number of log files that you wish to retain (currently the default is 3) as well as the size of each of the files (currently defaulted to 50000KB or 50MB).

To increase the number of retained files, change the MaxBackupIndex value from 3 to your desired count. If you wish to retain 10 log files, the line would be changed to

<param name="MaxBackupIndex" value="10"/>

If you would like to change the size of the files to 100MB, the MaxFileSize value would be modified such as

<param name="MaxFileSize" value="100000KB"/>

Make sure to retain the formatting in all modifications that are made.

As with the log level modification, any changes to these values are dynamic and do not require a restart of Process Automation for them to take affect.