HP XC System Software Administration Guide Version 2.1

15
Using Diagnostic Tools
The H P XC system provides several diagnostic tools. These tools are discussed in this chapter,
as follows:
• A description of the sys_check ut ility a
nd its use (Section 15.1)
• A discussion on the ovp utility (Section 15.2)
• A description of the dgemm utility (Section 15.3)
• Individual discussions of diagnosti
cs for the system interconnects ( Section 15.4)
Troubleshooting procedures are described in Chapter 16.
15.1 Using the sys_check Utility
The sys_check utility is a data collection tool that is used to aid in diagnosing system
errors and problems. U se the sys_check utilitytocreateanHTMLreportofyoursystem’s
configuration (software and hardware); you can specify a text report instead of the default
HTML.
When used as a component of fault diagnosis, the sys_check utility can reduce system down
time by as much as 50% by providing fast access to critical system data.
It is recomme nded that you run a full check at least once a week to maintain the currency of
system data. Ho w ever, note that some options take a long time to run and can have an adverse
impact on system performance. Therefo re, y ou sh ould c ho ose you r op tio ns carefully an d run
them du ring off-peak hours. At a minimum, perform at least one full run as a postconfiguration
task in order to establish a configuration baseline.
The sys_check utility provides options that enable you to do the following:
• Display a list of components
• Enable or disable da ta collection of indiv idu al components
• Create an escalation file for reporting problems to your technical sup port representative
• Specify an output file
Use the following comm and to invoke the sys_check utility in its simplest form:
# sys_check > /tmp/out.html
A p r e ferred form of the sys_check utility uses the debug option because that option displays
output that indicates the progress of the sys_check utility. Also, it is a good idea to capture
the output.
# sys_check -debug > /tmp/out.html
The sys_check util ity collects co nfi gur ation data for only the node on w hich it is run
unless you first set and export the SYS_CHECK_SYSWIDE environment variable. When this
environment variable is set, a subset of the sys_check co mp onen ts collect co nfiguratio n data
for all the nodes i n the HP X C system. In the following example, the mp firmware revision data
for all the nodes in the system is collected; mp is a sys_check component.
# export SYS_CHECK_SYSWIDE=1
# sys_check -debug mp > /tmp/mpout.html
See the sys_check(8) man page for more information about this com man d and its options.
Using Diagnostic Tools 15-1