Cisco Cisco Expressway Maintenance Manual

This section provides information about how to use the diagnostics tools:

 

n 

 

n 

 

n 

 and 

 advanced logging configuration tools

 

n 

The 

 tool (

) can be used to assist in 

troubleshooting system issues.

It allows you to generate a diagnostic log of system activity over a period of time, and then to download the 
log so that it can be sent to your Cisco customer support representative. You can also take and subsequently 
download a tcpdump while logging is in progress.

To use this tool:

 1.  Go to 

.

 2.  Optionally, select Take tcpdump while logging.

 3.  Click Start new log.

 4.  (Optional) Enter some Marker text and click Add marker.

 

l 

The marker facility can be used to add comment text to the log file before certain activities are 
performed. This helps to subsequently identify the relevant sections in the downloaded diagnostic log 
file.

 

l 

You can add as many markers as required, at any time while the diagnostic logging is in progress.

 

l 

Marker text is added to the log with a "DEBUG_MARKER" tag.

 5.  Reproduce the system issue you want to trace in the diagnostic log.

 6.  Click Stop logging.

 7.  Click Download log to save the diagnostic log archive to your local file system. You are prompted to save 

the archive (the exact wording depends on your browser).

The downloaded diagnostic log archive contains the following files:

 

n 

loggingsnapshot.txt - containing log messages in response to the activities performed during the logging 
period

 

n 

xconf_dump.txt - containing information about the configuration of the system at the time the logging was 
started

 

n 

xstat_dump.txt - containing information about the status of the system at the time the logging was started

 

n 

(if relevant) diagnostic_logging_tcpdump.pcap - containing the packets captured during the logging period

These files can be sent to your Cisco support representative, if you have been requested to do so.

 tcpdump files may contain sensitive information. Only send tcpdump files to trusted recipients. 

Consider encrypting the file before sending it, and also send the decrypt password out-of-band.

Cisco Expressway Administrator Guide (X8.5)     

Page 234 of 394

Maintenance

Diagnostics tools