Capturing Server Logs Using Script; Requirements - Cisco ASR 5000 Series Installation And Administration Manual

L-ESS Maintenance and Troubleshooting

Capturing Server Logs Using Script

In the event additional troubleshooting assistance is required, debugging information can be collected using a script
called getSupportDetails.pl. This script collects different log files and captures the output of certain system commands
that aid in troubleshooting issues. This script is packaged with the server in the
<less_install_dir>/ess/tools/supportdetails/ directory.
This script refers to an XML file to get the list of logs. This XML file resides in the same directory as the script. Once
executed, the script retrieves the contents of logs, files, folders, and output of certain commands and prepares a zipped
file (lesssupportDetails.tar.gz), by default it is placed in /tmp/log directory.

Requirements

Perl 5.8.5 and above is required for running the script.
Apart from standard Perl modules (which are included in default installation of Perl), some additional modules are
required for running the script. The list is as follows:
 expat version 1.95.8
 XML::Parser version 2.34
 XML-Parser-EasyTree
 Devel-CoreStack version 1.3
These modules are installed by default by the product. Please ensure that the above mentioned modules are installed
when using a different installation of Perl.
To run the script, change to the path where the script is present and type:
./getSupportDetails.pl [--level=...] [--xmlfile=...] [--help]
Keyword/Variable Description
--level Specifies the level of debug to run. It can have a maximum of 3 levels. The level 3 provides the most detailed
information.Default: 1
--xmlfile Specifies the xml file name to be used for collecting the log.
Default: getSupportDetails.xml
--help Displays the supported keywords/variables.
For example, ./getSupportDetails.pl --level=3 --xmlfile=/tmp/getSupportDetails.xml
Supported Levels:
The logs that can be collected for different levels are as follows:
 Level 1:
 Current status (running / not running) of the product
 Current version of the installed product
 Current Config files of the product
 Output of the following commands:
OL-22979-03
netstat -nr
Cisco ASR 5000 Series External Storage Server Installation and Administration Guide ▄
Troubleshooting the L-ESS ▀
87