Cisco Model D-PCG1000 PowerKEY CAS Gateway User Guide
7-2
Enabling Tracing on the SARA Server
4012159 Rev B
Enable Tracing
Introduction
The SARA Server includes a tracing function, which tracks the flow of information
through SARA Server processes. In order to capture this information to a log file,
you must enable tracing on the SARA Server.
Important: Cisco Services may request that you enable tracing so you can capture
Important: Cisco Services may request that you enable tracing so you can capture
this information for diagnostic purposes.
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
0
Reports only errors. This level is always turned on by default
whenever tracing is enabled.
1
Reports errors and debug information.
2
Reports errors, debug information, and flow information.
The trace.cfg File
The SARA 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
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 SARA Server
processes for changes to take effect.
Viewing Tracing Options
Complete these steps to view the tracing options contained in the trace.cfg file.
1.
In an xterm window on the SARA Server, type more trace.cfg and press
Enter.
Result: A list of tracing options displays on the screen.
Result: A list of tracing options displays on the screen.
2.
Examine the list of tracing options to determine which functions you want to
enable.
3.
Type the Ctrl and C keys simultaneously to exit the more utility.
4.
Go to Syntax For the trace.cfg File, next in this section.