2017-06-21 18:02:59 +00:00
|
|
|
nodepower(8) -- Check or change power state of confluent nodes
|
|
|
|
|
=========================================================
|
|
|
|
|
|
|
|
|
|
## SYNOPSIS
|
|
|
|
|
|
2021-06-16 15:19:49 +00:00
|
|
|
`nodepower [options] <noderange> ([status|on|off|shutdown|boot|reset])`
|
2017-06-21 18:02:59 +00:00
|
|
|
|
|
|
|
|
## 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.
|
2022-05-11 18:59:54 +00:00
|
|
|
* `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.
|
2017-06-21 18:02:59 +00:00
|
|
|
|
2018-07-18 15:02:12 +00:00
|
|
|
## OPTIONS
|
|
|
|
|
|
2021-06-16 15:19:49 +00:00
|
|
|
* `-p`, `--showprevious`:
|
2018-07-18 15:02:12 +00:00
|
|
|
Show previous power state for all directives that may change power state.
|
2021-03-19 12:22:47 +00:00
|
|
|
|
2021-03-22 10:34:23 +00:00
|
|
|
* `-m MAXNODES`, `--maxnodes=MAXNODES`:
|
|
|
|
|
Specify a maximum number of nodes to change power state, prompting if
|
|
|
|
|
over the threshold
|
|
|
|
|
|
2021-03-19 12:22:47 +00:00
|
|
|
* `-h`, `--help`:
|
|
|
|
|
Show help message and exit
|
2018-07-18 15:02:12 +00:00
|
|
|
|
2017-06-21 18:02:59 +00:00
|
|
|
## 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`
|
