Monitoring and Management Tools

Data collection utility - grdinfo

Data collection utility - grdinfo

The grdinfo utility enables the site to use a single command to collect a comprehensive set of debug and configuration information for the SP Switch Router. grdinfo options specify the type of information collected, including logs, dumps, media card statistics, protocol statistics, and control board data. Target data can be obtained at the system level or at the card level.

You can execute grdinfo while the SP Switch Router is running although there will be an impact on performance while the information is collected. This is a diagnostic tool. If the media cards are busy forwarding data and are unable to respond to statistics requests, or if not enough disk space is available, you will get an error message reporting the condition. In most cases, grdinfo stops and ends.

The grdinfo utility is to be used in conjunction with Customer Support staff. Some files grdinfo creates are very large. As a result, the collection process can interfere with system operations. Data is saved in compressed TAR files for ease in transfers to Customer Support.

Information specified by the specified option or options is collected and compressed into a grdinfo.tar.gz file in the /var/tmp/grdinfo directory. One grdinfo file is collected at a time. The size of a particular grdinfo.tar.gz file will vary widely and can tax system file system resources. The grdinfo utility is intended to collect information, not to store it. After you use grdinfo to collect the needed information, copy the data to external storage such as a file server, and then clean up the /var/tmp/grdinfo directory.

It is suggested that you move the output file off the SP Switch Router for analysis. Do not extract the data out of the grdinfo.tar.gz output file while it is on the SP Switch Router.

Note:

This is a brief overview of the grdinfo program. The “Management Commands and Tools” chapter of the GRF Configuration and Management manual contains complete information. Please use that chapter as a guide for collecting diagnostic information.

Options

Options are:

grdinfo -card=slot all

This command returns configuration and state information for a specific media card or for all installed cards. This includes SP Switch Router Adapter, ATM OC-3c, ATM OC-12c, HSSI, SONET, Ethernet, FDDI, and HIPPI cards.

grdinfo -config

the collection of system configuration data, including Card, System, Dump, and Load

profiles, and all /etc/*.conf configuration files, including /etc/gated.conf.

grdinfo -log

the collection of all log files from the local /var/log directory

grdinfo -dump

the collection of all dump files from the local /var directory, including media card, utility, and kernel dumps

grdinfo -system

an extensive collection of control board (RMS) data

SP Switch Router Adapter Guide - 1.4 Update 2

3-25

Page 101
Image 101
Lucent Technologies 9076, 9077 16S, 9077 04S manual Data collection utility grdinfo, Grdinfo -card=slot all