nodepower(8) - Check or change power state of confluent nodes
  1. nodepower(8)
  3. nodepower(8)

NAME

nodepower - 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
  2. October 2023
  3. nodepower(8)