diff --git a/xCAT-client-2.0/share/man/man1/reventlog.1 b/xCAT-client-2.0/share/man/man1/reventlog.1 new file mode 100644 index 000000000..aa0f04d0c --- /dev/null +++ b/xCAT-client-2.0/share/man/man1/reventlog.1 @@ -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. + diff --git a/xCAT-client-2.0/share/man/man1/rinv.1 b/xCAT-client-2.0/share/man/man1/rinv.1 new file mode 100644 index 000000000..f7225b313 --- /dev/null +++ b/xCAT-client-2.0/share/man/man1/rinv.1 @@ -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. diff --git a/xCAT-client-2.0/share/man/man1/rnetboot.1 b/xCAT-client-2.0/share/man/man1/rnetboot.1 new file mode 100644 index 000000000..054327469 --- /dev/null +++ b/xCAT-client-2.0/share/man/man1/rnetboot.1 @@ -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 diff --git a/xCAT-client-2.0/share/man/man1/rpower.1 b/xCAT-client-2.0/share/man/man1/rpower.1 new file mode 100644 index 000000000..4ef566d95 --- /dev/null +++ b/xCAT-client-2.0/share/man/man1/rpower.1 @@ -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. diff --git a/xCAT-client-2.0/share/man/man1/rvitals.1 b/xCAT-client-2.0/share/man/man1/rvitals.1 new file mode 100644 index 000000000..2f3654c58 --- /dev/null +++ b/xCAT-client-2.0/share/man/man1/rvitals.1 @@ -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. diff --git a/xCAT-client-2.0/share/man/man8/getmacs.8 b/xCAT-client-2.0/share/man/man8/getmacs.8 new file mode 100644 index 000000000..6903d15e0 --- /dev/null +++ b/xCAT-client-2.0/share/man/man8/getmacs.8 @@ -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