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

Products

• Output Management Web Viewer

Issue/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.

Environment

Release:
Component: WBVLUW

Resolution

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.

Additional Information

Please collect the trace files for the date you reproduced the error.  They are located in logs subdirectory (under your install directory) and send them to Broadcom Support.

1. ccitrace.log
2. wvtrace.log
3. jdrastrace.log

Do not bother sending one if it has 0 KB.  You may not find all three of them, but that is OK.