NAME
rpower - remote power control
SYNOPSIS
rpowernoderangeon|off|stat|state|reset|boot|cycle
rpower[-h|--help]
rpower[-v|--version]
DESCRIPTION
rpower controls the power for a single or range of nodes. See noderange(3).
OPTIONS
-
on
- Turn power on. off
- Turn power off. stat|state
- Print the current power state/status. reset
- Send a hard reset. boot
- If off, then power on. If on, then hard reset. The option is recommended over cycle. cycle
- Power off, then on. -h, --help
- Help. Prints out a brief help message. -v, --version
- Version. Display the version number.
ENVIRONMENT
-
XCATROOT
- Location of xCAT, usually /opt/xcat. Defined in /etc/profile.d/xcat.sh and /etc/profile.d/xcat.csh.
FILES
-
$XCATROOT/etc/nodelist.tab
- xCAT nodelist file. See nodelist.tab(5) for further details. $XCATROOT/etc/nodehm.tab
- xCAT node hardware management file. See nodehm.tab(5) for further details. This is used to determine the remote power method. $XCATROOT/etc/mp.tab
- Management Processor Network definition table. See mp.tab(5) for further details. $XCATROOT/etc/mpa.tab
- Management Processor Adapter definition table. See mpa.tab(5) for further details. $XCATROOT/etc/apc.tab
- APC Master Switch definition table. See apc.tab(5) for further details. $XCATROOT/etc/apcp.tab
- APC Master Switch Plus definition table. See apcp.tab(5) for further details. $XCATROOT/etc/emp.tab
- Emergency Management Port definition table. See emp.tab(5) for further details. $XCATROOT/etc/baytech.tab
- Bay Tech switch definition table. See baytech.tab(5) for further details.
DIAGNOSTICS
The following diagnostics may be issued on stdout/stderr:
-
invalid node, group, or range
- Node or group is not defined in nodelist.tab(5). function not supported
- Node does not support remote power control or remote power control method not supported. ping to $MPN failed
- Where $MPN = the Management Processor Network defined in mp.tab(5). PCI MPA adapter may not have power. Check Ethernet cable and IP. telnet timeout
- PCI MPA adapter may not have power. Check Ethernet cable and IP. unknown asma/rsa HOST
- Returned if not in /etc/hosts or DNS. node not on asma $MPN
- Where $MPN = the Management Processor Network defined in mp.tab(5). Use mpncheck(1) $MPN to verify. Check cabling and try mpareset(1). remote session timeout
- Communication with SPN was successful but communication with node failed. Check cabling. Try removing power from node, wait 10 seconds, then restore.
EXAMPLES
rpower node5 onnode4: on
node5: off
rpower node5 on
node5: on
BUGS
Unknown.
AUTHOR
Egan Ford <egan@us.ibm.com>