149 lines
3.4 KiB
Groff
149 lines
3.4 KiB
Groff
|
.\" Process this file with
|
||
|
|
.\" groff -man -Tascii rinv.1
|
||
|
|
.\"
|
||
|
|
.TH RINV 1 "Jan 2008" xCAT "xCAT"
|
||
|
|
.SH NAME
|
||
|
|
rinv \- remote hardware inventory
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.B rinv
|
||
|
|
[\fInoderange\fR] [\fIpci\fR|\fIconfig\fR|\fImodel\fR|\fIserial\fR|\fIasset\fR|\fIall\fR]
|
||
|
|
|
||
|
|
.B rinv
|
||
|
|
[\fI-h\fR|\fI--help\fR|\fI-v\fR|\fI--version\fR]
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.B rinv
|
||
|
|
retrieves hardware configuration information from the on-board Service Processor
|
||
|
|
for a single or range of nodes and groups.
|
||
|
|
.SH OPTIONS
|
||
|
|
.IP \fBpci\fR
|
||
|
|
Retrieves PCI bus information.
|
||
|
|
|
||
|
|
.IP \fBconfig\fR
|
||
|
|
Retrieves number of processors, speed, total memory, and DIMM locations.
|
||
|
|
|
||
|
|
.IP \fBmodel\fR
|
||
|
|
Retrieves model number.
|
||
|
|
|
||
|
|
.IP \fBserial\fR
|
||
|
|
Retrieves serial number.
|
||
|
|
|
||
|
|
.IP \fBasset\fR
|
||
|
|
Retrieves asset tag. Usually it's the MAC address of eth0.
|
||
|
|
|
||
|
|
.IP \fBall\fR
|
||
|
|
All of the above.
|
||
|
|
|
||
|
|
.IP \fB-h\fR|\fB--help\fR
|
||
|
|
Print help.
|
||
|
|
|
||
|
|
.IP \fB-v\fR|\fB--version\fR
|
||
|
|
Print version.
|
||
|
|
|
||
|
|
.SH DIAGNOSTICS
|
||
|
|
The following diagnostics may be issued on stdout/stderr:
|
||
|
|
|
||
|
|
is not a node or a group
|
||
|
|
.RS
|
||
|
|
Node or group is not defined in
|
||
|
|
.BR nodelist.tab (5).
|
||
|
|
.RE
|
||
|
|
|
||
|
|
function not supported
|
||
|
|
.RS
|
||
|
|
Node does not support remote power control or remote power control method not supported.
|
||
|
|
.RE
|
||
|
|
|
||
|
|
ping to $SPN failed
|
||
|
|
.RS
|
||
|
|
Where $SPN = the Service Processor Network defined in
|
||
|
|
.BR mp.tab (5).
|
||
|
|
PCI MPA adapter may not have power. Check Ethernet cable and IP.
|
||
|
|
.RE
|
||
|
|
|
||
|
|
telnet timeout
|
||
|
|
.RS
|
||
|
|
PCI MPA adapter may not have power. Check Ethernet cable and IP.
|
||
|
|
.RE
|
||
|
|
|
||
|
|
connection refused
|
||
|
|
.RS
|
||
|
|
Returned if telnet fails. PCI MPA may be in use or telnet interface is locked up.
|
||
|
|
.BR mpareset (1)
|
||
|
|
can be used to reboot the PCI MPA.
|
||
|
|
.RE
|
||
|
|
|
||
|
|
unknown asma $host
|
||
|
|
.RS
|
||
|
|
Returned if not in /etc/hosts or DNS.
|
||
|
|
.RE
|
||
|
|
|
||
|
|
name lookup failure
|
||
|
|
.RS
|
||
|
|
Returned if not in DNS.
|
||
|
|
.RE
|
||
|
|
|
||
|
|
node not on asma $SPN
|
||
|
|
.RS
|
||
|
|
Where $SPN = the SPN defined for that node in in
|
||
|
|
.BR mp.tab (5).
|
||
|
|
Use
|
||
|
|
.BR mpncheck (1)
|
||
|
|
$SPN to verify. Check cabling and try
|
||
|
|
.BR
|
||
|
|
mpareset (1).
|
||
|
|
.RE
|
||
|
|
|
||
|
|
remote session timeout
|
||
|
|
.RS
|
||
|
|
Communication with SPN was successful but communication with node failed. Check cabling. Try removing power from node, wait 10 seconds, then restore.
|
||
|
|
.SH EXAMPLES
|
||
|
|
|
||
|
|
\fIrinv node5 all\fR
|
||
|
|
|
||
|
|
node5: Machine Type/Model 865431Z
|
||
|
|
.br
|
||
|
|
node5: Serial Number 23C5030
|
||
|
|
.br
|
||
|
|
node5: Asset Tag 00:06:29:1F:01:1A
|
||
|
|
.br
|
||
|
|
node5: PCI Information
|
||
|
|
.br
|
||
|
|
node5: Bus VendID DevID RevID Description Slot Pass/Fail
|
||
|
|
.br
|
||
|
|
node5: 0 1166 0009 06 Host Bridge 0 PASS
|
||
|
|
.br
|
||
|
|
node5: 0 1166 0009 06 Host Bridge 0 PASS
|
||
|
|
.br
|
||
|
|
node5: 0 5333 8A22 04 VGA Compatible Controller 0 PASS
|
||
|
|
.br
|
||
|
|
node5: 0 8086 1229 08 Ethernet Controller 0 PASS
|
||
|
|
.br
|
||
|
|
node5: 0 8086 1229 08 Ethernet Controller 0 PASS
|
||
|
|
.br
|
||
|
|
node5: 0 1166 0200 50 ISA Bridge 0 PASS
|
||
|
|
.br
|
||
|
|
node5: 0 1166 0211 00 IDE Controller 0 PASS
|
||
|
|
.br
|
||
|
|
node5: 0 1166 0220 04 Universal Serial Bus 0 PASS
|
||
|
|
.br
|
||
|
|
node5: 1 9005 008F 02 SCSI Bus Controller 0 PASS
|
||
|
|
.br
|
||
|
|
node5: 1 14C1 8043 03 Unknown Device Type 2 PASS
|
||
|
|
.br
|
||
|
|
node5: Machine Configuration Info
|
||
|
|
.br
|
||
|
|
node5: Number of Processors: 2
|
||
|
|
.br
|
||
|
|
node5: Processor Speed: 866 MHz
|
||
|
|
.br
|
||
|
|
node5: Total Memory: 512 MB
|
||
|
|
.br
|
||
|
|
node5: Memory DIMM locations: Slot(s) 3 4
|
||
|
|
.br
|
||
|
|
.SH "FILES"
|
||
|
|
.IX Header "FILES"
|
||
|
|
/opt/xcat/bin/rinv
|
||
|
|
.SH "NOTES"
|
||
|
|
.IX Header "NOTES"
|
||
|
|
This command is part of the xCAT software product.
|