# nodepower(8) - Check or change power state of confluent nodes

## SYNOPSIS

`nodepower [options] <noderange> ([status|on|off|shutdown|boot|reset])`

## DESCRIPTION

**nodepower** with only a noderange will retrieve current power state of nodes through confluent. When given an additional argument, it will request a change to the power state of the nodes. The following arguments are recognized:

- `on`: Turn on the specified noderange. Nothing will happen to nodes of the noderange that are already on.
- `off`: Immediately turn off the specified noderange, without waiting for OS to shutdown. Nothing will happen to nodes of the noderange that are already on.
- `boot`: Immediately boot a system. This will power on nodes of the noderange that are off, and reset nodes of the noderange that are on. The previous state will be reflected in the output.
- `shutdown`: Request the OS gracefully shut down. Nothing will happen for nodes that are off, and nodes will not shutdown if the OS fails to gracefully respond.
- `reset`: Request immediate reset of nodes of the noderange. Nodes that are off will not react to this request.
- `status`: Behave identically to having no argument passed at all.
- `pdu_status`: Query state of associated PDU outlets, if configured.
- `pdu_on`: Energize all PDU outlets associated with the noderange.
- `pdu_off`: De-energize all PDU outlets associated with the noderange.

## OPTIONS

- `-p`, `--showprevious`: Show previous power state for all directives that may change power state.
- `-m MAXNODES`, `--maxnodes=MAXNODES`: Specify a maximum number of nodes to change power state, prompting if over the threshold
- `-h`, `--help`: Show help message and exit

## EXAMPLES

- Get power state of nodes n1 through n4: `# nodepower n1-n4`  
  `n1: on`  
  `n2: on`  
  `n3: on`  
  `n4: off`
- Forcing a reboot of nodes n1-n4: `# nodepower n1-n4 boot`  
  `n3: on->reset`  
  `n1: on->reset`  
  `n2: on->reset`  
  `n4: off->on`