Cisco Model D-PCG1000 PowerKEY CAS Gateway User Guide

Page of 142
 
Chapter 8    Enabling Tracing on the Application Server 
 
 
 
112 
4023142 Rev B 
Enabling the Tracing Function 
In order to enable or disable tracing for an Application Server process, you must edit 
the /dvs/appserv/tmp/trace.cfg file. Each line in this file represents a trace 
command for an Application Server process. 
Lines that begin with a pound sign (#) are comments. The tracing function ignores 
these lines. Therefore, in order to disable tracing, you can simply add a pound sign 
to the beginning of the corresponding line. 
Also, some of these comment lines may contain trace commands that have been 
disabled. To enable tracing, you can simply remove the pound sign from the 
beginning of those lines. 
Follow these steps to enable the tracing function for an Application Server process: 
1  In an xterm window on the Application Server, type cd  /dvs/appserv/tmp and 
press Enter. The /dvs/appserv/tmp directory becomes the working directory. 
2  Type vi  trace.cfg and press Enter. The trace.cfg file opens. 
3  Does the file contain any comment lines that correspond with the tracing 
function you want to enable? 
 
If yes, remove the # from the beginning of that line and go to step 5. 
 
If no, go to step 4. 
4  Use the arrow keys to scroll to the bottom of the file and add the appropriate 
entry for the tracing function you want to enable.  See The trace.cfg File  
(on page 110) for more information on writing trace.cfg entries. 
5  Type :wq to save and close the file.   
6  Type dvs/appserv/bin/tools/showTracing to put the changes into effect. 
Important: If you do not perform this step, the changes that you made will not 
be put into effect. 
 
Disabling the Tracing Function 
Follow these steps to disable the tracing function for an Application Server process: 
1  In an xterm window on the Application Server, type cd  /dvs/appserv/tmp and 
press Enter. The /dvs/appserv/tmp directory becomes the working directory. 
2  Type vi  trace.cfg and press Enter. The trace.cfg file opens. 
3  Find the entry that corresponds with the tracing function you want to disable. 
4  Place the cursor at the beginning of the line you want to disable and type #
Note:  It is a good idea to comment out the entry instead of deleting it; you can 
enable the command later, if necessary.  To comment out an entry, add a # to the 
beginning of the line containing the entry. 
5  Type :wq to save and close the file.   
6  Type dvs/appserv/bin/tools/showTracing to put the changes into effect.