IBM Books

Administration Guide

rpower Command

Name

rpower - Controls remote power for Cluster Systems Management (CSM) nodes.

Synopsis

rpower [-a] [-h] [-n host[,host...]] [-N Node_group[,Node_group...]] [-v | -V] on | off | reboot | query | resetsp_hcp | resetsp_host

Description

The rpower command allows remote power control for the nodes in a cluster. The command uses the CSM database to determine the nodes and their service processor information. The -a option causes the rpower command to run on all of the nodes defined in the cluster. The -n and -N options cause the command to run on the set of nodes defined by these options. In addition to these options, you can define an environment variable, RPOWER_LIST, which is the name of a file that contains a list of nodes to manage. The host names used must be the names specified when defining the nodes in the CSM database.

The query option prints an on or off status response for each of the nodes specified. The on, off, reboot, and resetsp options print the node name with the command specified and the return code of the command.

Note:
The -P and -B options are no longer valid for this command.

Options

-a
Runs the command on all of the nodes in the cluster.

-h
Writes usage information to standard output.

-n host[,host...]
Specifies a list of nodes on which to run the command.

-N Node_group[,Node_group...]
Specifies one or more node groups on which to run the command.

-v | -V
Specifies to turn tracing on. Note that when you specify this option, tracing in turned on for the duration of the command only. After the command is run, tracing is restored to the state it was in before the command was executed.

on
Powers the node or nodes on.

off
Requests a shutdown and schedules a power off based on the ISP timer.

reboot
Reboots the power on the node or nodes.

query
Reports the power status of the node or nodes.

resetsp_hcp
Resets the service processor for the hcp or hcps.

resetsp_host
Resets the service processor for the node or nodes.

Environment

RPOWER_LIST
Specifies a file that contains definitions of the set of hosts, one per line, that comprise the node list.

Exit Status

0
Command has run successfully.

1
Error occurred with one or more of the remote power commands.

Security

While the rpower command currently only supports the Netfinity hardware, the architecture is designed to allow future enhancements for other hardware support. For Netfinity hardware, the rpower command requires that the systemid command be run first, in order to establish the user ID and password that is necessary to access the remote hardware.

Note:
If you change the ID and password on the service processor, then you must run the systemid command and specify the new ID and password. For information on using the systemid command, see the man page.

Examples

  1. To query one node, type:
    rpower -n clsn04 query
    
    The output is:
    clsn04 on
     
     
    
  2. To query all nodes, type:
    rpower -a query
     
    
    The output is similar to:
    clsn05.ppd.pok.ibm.com on
    clsn04.ppd.pok.ibm.com on
    clsn03.ppd.pok.ibm.com on
    clsn02.ppd.pok.ibm.com on
    clsn01.ppd.pok.ibm.com on
     
     
    
  3. To power off a node, type:
    rpower -n clsn04 off
     
     
    
    The output is:
    clsn04 off complete rc=0
     
     
    
  4. To power on a node, enter:
    rpower -n clsn04 on
     
     
    
  5. To display a list of the nodes in a node group, type:
    nodegrp -p test
    
    The output is similar to:
    clsn01.ppd.pok.ibm.com 
    clsn02.ppd.pok.ibm.com 
    clsn05.ppd.pok.ibm.com 
     
     
    
  6. To query the power status of the nodes in a node group, type:
    rpower -N test query 
     
    
    The output is similar to:
    clsn01.ppd.pok.ibm.com on 
    clsn02.ppd.pok.ibm.com on 
    clsn05.ppd.pok.ibm.com on 
    

Files

/etc/opt/csm/system_config/<node ID>
The file containing the id and encrypted password.

/opt/csm/bin/rpower
Location of the rpower command.

See Also

Author

John Simpson - cluster@us.ibm.com


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]