Chapter 13: Using Cisco Common Tools

How to Use the RTTest Utility

All ICM processes write some default level of tracing to log files that can be viewed with the Trace and Log utility.

When specific trace levels are enabled, corresponding details are written to router log files in the logfile directory.

Default individual log file size is 99k.

Default aggregate log file size is 600k

If router tracing is turned too high, individual log files will wrap very quickly, potentially within a minute if call volume is high. In that case, not much data can be captured because the time span is very small. To get around this, router log file capacities can be increased by altering a few Microsoft Windows registry settings. Make sure there is enough disk space available before increasing log file capacities.

To enter the Windows registry:

.a From a command prompt, enter regedt32.

.b After checking available disk space, the following two registry settings can be changed to allow for larger router log files.

Note: The values are displayed in hexadecimal by default. Click on the Decimal radio button to see the base 10 value.

\\.\software\geotel\icr\csco\routera\ems\currentversion\library\processes\rtr\EMSAllLogFilesMax

\\.\software\geotel\icr\csco\routera\ems\currentversion\library\processes\rtr\EMSLogFileMax

The first parameter - EMSAllLogFilesMax specifies the maximum amount of disk space the router will allocate for all log files combined.

The second parameter - EMSLogFileMax specifies the maximum size that the router will allocate to each log file. For example, if you set EMSAllLogFilesMax to 20 mg, and EMSLogFileMax to 2 mg, the router will eventually create no more than 10 files, each being no more than 2 mg in size.

Turning Off Debug Tracing in RTTest

When you are finished viewing router logs, it is good practice to disable all tracing that was added for troubleshooting purposes. Do this using the /noall directive as shown below:

c:\icm\cd\ra\logfiles>rttest /cust cd /node routera

rttest: debug /noall

Cisco Support Tools User Guide for Cisco Unified Software Release 2.1(1)

189

Page 203
Image 203
Cisco Systems 2.1(1) manual Turning Off Debug Tracing in RTTest, 189