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

Document ID : KB000009347
Last Modified Date : 14/02/2018
Show Technical Document Details
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 CA Process Automation.

Background:

To assist CA 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 CA Process Automation uses the embedded JBoss application server, it relies on Apache Log4j for the logging mechanism, and it does not utilize exception logging. 

Instructions:

Make sure to monitor disk space on the drive where CA 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.

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 affect, it is a dynamic change.

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.