Cisco Headend System Release 2.7 Installation Guide

Page of 212
 
Chapter 15    Troubleshooting 
 
 
 
182 
4017650 Rev C 
Enable Tracing on the Application Server 
Introduction 
The Application Server includes a tracing function, which tracks the flow of 
information through Application Server processes. In order to capture this 
information to a log file, you must enable tracing on the Application Server. Cisco 
Services may request that you enable tracing so you can capture this information for 
diagnostic purposes. 
This section provides procedures to enable and disable the tracing function and to 
specify the level of detail that you want to include in the log file. 
 
Understanding Trace Levels 
You can choose to trace varying information with varying degrees of detail. You do 
this through the use of trace levels.  Trace levels let you specify how much 
information you want to include in the log file. The following table provides valid 
trace levels. 
Trace Level 
Definition 
Reports only errors. This level is always turned on by default whenever 
tracing is enabled. 
Reports errors and debug information. 
Reports errors, debug information, and flow information. 
 
 
The trace.cfg File 
The Application Server contains a file called/dvs/appserv/tmp/trace.cfg. This file 
contains commands that let you specify the following options: 
 
Whether to enable or disable tracing for a specific process 
 
The amount of detail that you want to capture to a log file 
 
In order to enable or disable tracing or to change the trace levels for a process, 
you must edit the trace.cfg file 
After you make changes to the trace.cfg file, you can run the 
/dvs/appserv/bin/tools/showTracing utility to put the changes into effect. If you 
do not run the showTracing utility, any changes that you made to the trace.cfg file 
may not take effect immediately. It is not necessary to restart any Application Server 
processes for changes to take effect.