How to set up enhanced tracing / logging for 12.1 Web Viewer

Document ID : KB000117937
Last Modified Date : 22/10/2018
Show Technical Document Details
Introduction:
How do I set up for enhanced tracing / logging for 12.1 Web Viewer? Support is telling me we'll need more detailed information than what is usually collected.
Instructions:
On the DRAS side, please have the server(s) set for message suppression “OFF”.  As a reminder, this can be done dynamically with the command from the SDSF da screen:
 
/f,(DRAS Task Name),message supp(off)
 
Documentation setup for Debug tracing on the Web Viewer Server: This is also a dynamic setting. A change here is usually picked up within 5 minutes, but it is better to have it set up ahead of time. Within the path set for your CAOMWV12_HOME environment variable, there are 3 trace files we need to set up. You'll find them under the /config folder:
 
OmWVTrace.cfg
OmCCITrace.cfg
OmJDrasTrace.cfg
 
The changes are the same for all three. On line 9 or 10 (lines beginning with a # are commented out):
 
Change 1
log4j.category.com.ca.erm.webviewer=ERROR, A3
To
log4j.category.com.ca.erm.webviewer=DEBUG, A3
 
Change 2 - On the last line of the file
log4j.logger.com.ca.erm.webviewer=ERROR#com.ca.erm.webviewer.util.OmTraceLevel
to
log4j.logger.com.ca.erm.webviewer=DEBUG#com.ca.erm.webviewer.util.OmTraceLevel
or optionally (to correctly place the comment appended to the end)
log4j.logger.com.ca.erm.webviewer=DEBUG
#com.ca.erm.webviewer.util.OmTraceLevel
 
Recycling Tomcat will immediately pick up the logging level change.  Having these set up will help minimize the time to get the information CA Support will request.