arif/xcat-core
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Add manpages for new commands

Browse Source 
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@228 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
This commit is contained in:
lissav 2008-01-08 15:59:10 +00:00
parent ece42fe254
commit 410528f79c
6 changed files with 985 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

130
xCAT-client-2.0/share/man/man1/reventlog.1 Normal file
View File

@ -0,0 +1,130 @@
.\" Process this file with
.\" groff -man -Tascii reventlog.1
.\"
.TH REVENTLOG 1 "Jan 2008" xCAT "xCAT"
.SH NAME
reventlog \- retrieve or clear remote hardware event logs
.SH SYNOPSIS
.B reventlog
[\fInoderange\fR] [\fInumber of entries\fR|\fIall\fR|\fIclear\fR]
.B reventlog
[\fI-h\fR|\fI--help\fR|\fI-v\fR|\fI--version\fR]
.SH DESCRIPTION
.B reventlog
can display any number of remote hardware event log entries
or clear them for a range of nodes. See
.BR noderange (3).
Hardware event logs are stored on each servers service processor.
.SH OPTIONS
.IP \fIn\fR
Retrieve \fIn\fR number of entries.
.IP \fBall\fR
Retrieve all entries.
.IP \fBclear\fR
Clear event logs.
.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 event log retrieval or remote event log retrieval 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
\fIreventlog node4,node5 5\fR
node4: SERVPROC I 09/06/00 15:23:33 Remote Login Successful User ID = USERID[00]
.br
node4: SERVPROC I 09/06/00 15:23:32 System spn1 started a RS485 connection with us[00]
.br
node4: SERVPROC I 09/06/00 15:22:35 RS485 connection to system spn1 has ended[00]
.br
node4: SERVPROC I 09/06/00 15:22:32 Remote Login Successful User ID = USERID[00]
.br
node4: SERVPROC I 09/06/00 15:22:31 System spn1 started a RS485 connection with us[00]
.br
node5: SERVPROC I 09/06/00 15:22:32 Remote Login Successful User ID = USERID[00]
.br
node5: SERVPROC I 09/06/00 15:22:31 System spn1 started a RS485 connection with us[00]
.br
node5: SERVPROC I 09/06/00 15:21:34 RS485 connection to system spn1 has ended[00]
.br
node5: SERVPROC I 09/06/00 15:21:30 Remote Login Successful User ID = USERID[00]
.br
node5: SERVPROC I 09/06/00 15:21:29 System spn1 started a RS485 connection with us[00]
.br
\fIreventlog node4,node5 clear\fR
node4: clear
.br
node5: clear
.SH "FILES"
.IX Header "FILES"
/opt/xcat/bin/reventlog
.SH "NOTES"
.IX Header "NOTES"
This command is part of the xCAT software product.

148
xCAT-client-2.0/share/man/man1/rinv.1 Normal file
View File

@ -0,0 +1,148 @@
.\" 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.

165
xCAT-client-2.0/share/man/man1/rnetboot.1 Normal file
View File

@ -0,0 +1,165 @@
.\" Automatically generated by Pod::Man version 1.02
.\" Tue Jan 8 10:33:42 2008
.\"
.\" Standard preamble:
.\" ======================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. | will give a
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` `
. ds C' '
'br\}
.el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
.\" index entries marked with X<> in POD. Of course, you'll have to process
.\" the output yourself in some meaningful fashion.
.if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
. .
. nr % 0
. rr F
.\}
.\"
.\" For nroff, turn off justification. Always turn off hyphenation; it
.\" makes way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
.bd B 3
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
. ds #V .8m
. ds #F .3m
. ds #[ \f1
. ds #] \fP
.\}
.if t \{\
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. ds #V .6m
. ds #F 0
. ds #[ \&
. ds #] \&
.\}
. \" simple accents for nroff and troff
.if n \{\
. ds ' \&
. ds ` \&
. ds ^ \&
. ds , \&
. ds ~ ~
. ds /
.\}
.if t \{\
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
. ds : e
. ds 8 ss
. ds o a
. ds d- d\h'-1'\(ga
. ds D- D\h'-1'\(hy
. ds th \o'bp'
. ds Th \o'LP'
. ds ae ae
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ======================================================================
.\"
.IX Title "RNETBOOT.1 1"
.TH RNETBOOT.1 1 "perl v5.6.0" "2008-01-08" "User Contributed Perl Documentation"
.UC
.SH "NAME"
\&\fBrnetboot\fR \-Will force an unattended network install for a range of nodes (diskless) Front end to nodeset noderange netboot; rpower noderange boot.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBrnetboot\fR
\&\fInoderange\fR
.PP
\&\fBrnetboot\fR
[\fB\-h\fR|\fB\*(--help\fR]
.PP
\&\fBrnetboot\fR
[\fB\-v\fR|\fB\*(--version\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBrnetboot\fRWill force an unattended network install for a range of nodes (diskless) Front end to nodeset noderange netboot; rpower noderange boot.
.SH "EXAMPLES"
.IX Header "EXAMPLES"
.Vb 4
\& rnetboot 1,3
\& rnetboot 14-56,70-203
\& rnetboot 1,3,14-56,70-203
\& rnetboot all,-129-256
.Ve

208
xCAT-client-2.0/share/man/man1/rpower.1 Normal file
View File

@ -0,0 +1,208 @@
.\" Automatically generated by Pod::Man version 1.02
.\" Tue Jan 8 10:48:25 2008
.\"
.\" Standard preamble:
.\" ======================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. | will give a
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` `
. ds C' '
'br\}
.el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
.\" index entries marked with X<> in POD. Of course, you'll have to process
.\" the output yourself in some meaningful fashion.
.if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
. .
. nr % 0
. rr F
.\}
.\"
.\" For nroff, turn off justification. Always turn off hyphenation; it
.\" makes way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
.bd B 3
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
. ds #V .8m
. ds #F .3m
. ds #[ \f1
. ds #] \fP
.\}
.if t \{\
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. ds #V .6m
. ds #F 0
. ds #[ \&
. ds #] \&
.\}
. \" simple accents for nroff and troff
.if n \{\
. ds ' \&
. ds ` \&
. ds ^ \&
. ds , \&
. ds ~ ~
. ds /
.\}
.if t \{\
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
. ds : e
. ds 8 ss
. ds o a
. ds d- d\h'-1'\(ga
. ds D- D\h'-1'\(hy
. ds th \o'bp'
. ds Th \o'LP'
. ds ae ae
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ======================================================================
.\"
.IX Title "RPOWER.1 1"
.TH RPOWER.1 1 "perl v5.6.0" "2008-01-08" "User Contributed Perl Documentation"
.UC
.SH "NAME"
rpower \- remote power control
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBrpower\fR
\&\fInoderange\fR
\&\fBon\fR|\fBoff\fR|\fBstat\fR|\fBstate\fR|\fBreset\fR|\fBboot\fR|\fBcycle\fR
.PP
\&\fBrpower\fR
[\fB\-h\fR|\fB\*(--help\fR]
.PP
\&\fBrpower\fR
[\fB\-v\fR|\fB\*(--version\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fIrpower\fR controls the power for a single or range of nodes.
.SH "OPTIONS"
.IX Header "OPTIONS"
.Ip "\fBon\fR" 4
.IX Item "on"
Turn power on.
.Ip "\fBoff\fR" 4
.IX Item "off"
Turn power off.
.Ip "\fBstat\fR|\fBstate\fR" 4
.IX Item "stat|state"
Print the current power state/status.
.Ip "\fBreset\fR" 4
.IX Item "reset"
Send a hard reset.
.Ip "\fBboot\fR" 4
.IX Item "boot"
If off, then power on.
If on, then hard reset.
The option is recommended over \fBcycle\fR.
.Ip "\fBcycle\fR" 4
.IX Item "cycle"
Power off, then on.
.Ip "\fB\-h\fR, \fB\*(--help\fR" 4
.IX Item "-h, help"
Help.
Prints out a brief help message.
.Ip "\fB\-v\fR, \fB\*(--version\fR" 4
.IX Item "-v, version"
Version.
Display the version number.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
.SH "EXAMPLES"
.IX Header "EXAMPLES"
\fIrpower node4,node5 stat\fR
node4: on
.br
node5: off
\fIrpower node5 on\fR
node5: on
.SH "FILES"
.IX Header "FILES"
/opt/xcat/bin/rpower
.SH "NOTES"
.IX Header "NOTES"
This command is part of the xCAT software product.

169
xCAT-client-2.0/share/man/man1/rvitals.1 Normal file
View File

@ -0,0 +1,169 @@
.\" Process this file with
.\" groff -man -Tascii rvitals.1
.\"
.TH RVITALS 1 "Jan 2008" xCAT "xCAT"
.SH NAME
rvitals \- remote hardware vitals
.SH SYNOPSIS
.B rvitals
[\fInoderange\fR] [\fIcputemp\fR|\fIdisktemp\fR|\fIambtemp\fR|\fItemp\fR]
.B rvitals
[\fInoderange\fR] [\fIvoltage\fR|\fIfanspeed\fR|\fIpower\fR|\fIpowertime\fR]
.B rvitals
[\fInoderange\fR] [\fIreboots\fR|\fIstate\fR|\fIall\fR]
.B rvitals
[\fI-h\fR|\fI--help\fR|\fI-v\fR|\fI--version\fR]
.SH DESCRIPTION
.B rvitals
retrieves hardware vital information from the on-board Service Processor
for a single or range of nodes and groups.
.SH OPTIONS
.IP \fBcputemp\fR
Retrieves CPU temperatures.
.IP \fBdisktemp\fR
Retrieves HD back plane temperatures.
.IP \fBambtemp\fR
Retrieves ambient temperatures.
.IP \fBtemp\fR
Retrieves all temperatures.
.IP \fBvoltage\fR
Retrieves power supply and VRM voltage readings.
.IP \fBfanspeed\fR
Retrieves fan speeds.
.IP \fBpower\fR
Retrieves power status.
.IP \fBpowertime\fR
Retrieves total power uptime. This value only increases, unless the
Service Processor flash gets updated.
.IP \fBreboot\fR
Retrieves total number of reboots. This value only increases, unless the
Service Processor flash gets updated.
.IP \fBstate\fR
Retrieves the system state.
.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
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
\fIrvitals node5 all\fR
node5: CPU 1 Temperature: + 29.00 C (+ 84.2 F)
.br
node5: CPU 2 Temperature: + 19.00 C (+ 66.2 F)
.br
node5: DASD Sensor 1 Temperature: + 32.00 C (+ 89.6 F)
.br
node5: System Ambient Temperature Temperature: + 26.00 C (+ 78.8 F)
.br
node5: +5V Voltage: + 5.01V
.br
node5: +3V Voltage: + 3.29V
.br
node5: +12V Voltage: + 11.98V
.br
node5: +2.5V Voltage: + 2.52V
.br
node5: VRM1 Voltage: + 1.61V
.br
node5: VRM2 Voltage: + 1.61V
.br
node5: Fan 1 Percent of max: 100%
.br
node5: Fan 2 Percent of max: 100%
.br
node5: Fan 3 Percent of max: 100%
.br
node5: Fan 4 Percent of max: 100%
.br
node5: Fan 5 Percent of max: 100%
.br
node5: Fan 6 Percent of max: 100%
.br
node5: Current Power Status On
.br
node5: Power On Seconds 11855915
.br
node5: Number of Reboots 930
.br
node5: System State Booting OS or in unsupported OS
.br
.SH "FILES"
.IX Header "FILES"
/opt/xcat/bin/rvitals
.SH "NOTES"
.IX Header "NOTES"
This command is part of the xCAT software product.

165
xCAT-client-2.0/share/man/man8/getmacs.8 Normal file
View File

@ -0,0 +1,165 @@
.\" Automatically generated by Pod::Man version 1.02
.\" Tue Jan 8 10:43:59 2008
.\"
.\" Standard preamble:
.\" ======================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. | will give a
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` `
. ds C' '
'br\}
.el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
.\" index entries marked with X<> in POD. Of course, you'll have to process
.\" the output yourself in some meaningful fashion.
.if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
. .
. nr % 0
. rr F
.\}
.\"
.\" For nroff, turn off justification. Always turn off hyphenation; it
.\" makes way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
.bd B 3
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
. ds #V .8m
. ds #F .3m
. ds #[ \f1
. ds #] \fP
.\}
.if t \{\
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. ds #V .6m
. ds #F 0
. ds #[ \&
. ds #] \&
.\}
. \" simple accents for nroff and troff
.if n \{\
. ds ' \&
. ds ` \&
. ds ^ \&
. ds , \&
. ds ~ ~
. ds /
.\}
.if t \{\
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
. ds : e
. ds 8 ss
. ds o a
. ds d- d\h'-1'\(ga
. ds D- D\h'-1'\(hy
. ds th \o'bp'
. ds Th \o'LP'
. ds ae ae
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ======================================================================
.\"
.IX Title "GETMACS.8 1"
.TH GETMACS.8 1 "perl v5.6.0" "2008-01-08" "User Contributed Perl Documentation"
.UC
.SH "NAME"
\&\fBgetmacs\fR \- Collect mac addresses.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBgetmacs\fR
\&\fInoderange\fR
.PP
\&\fBgetmacs\fR
[\fB\-h\fR|\fB\*(--help\fR]
.PP
\&\fBgetmacs\fR
[\fB\-v\fR|\fB\*(--version\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Collects \s-1MAC\s0 addresses of the input noderange.
.SH "EXAMPLES"
.IX Header "EXAMPLES"
.Vb 4
\& getmacs 1,3
\& getmacs 14-56,70-203
\& getmacs 1,3,14-56,70-203
\& getmacs all,-129-256
.Ve