NAME¶
pbsnodes - pbs node manipulation
SYNOPSIS¶
pbsnodes [-{a|x}] [-q] [-s server] [node|:property]
pbsnodes -l [-q] [-s server] [state] [nodename|:property ...]
pbsnodes [-{c|d|o|r}] [-q] [-s server] [-n] [-N "note"]
[node|:property]
DESCRIPTION¶
The
pbsnodes command is used to mark nodes down, free or offline. It can
also be used to list nodes and their state. Node information is obtained by
sending a request to the PBS job server. Sets of nodes can be operated on at
once by specifying a node property prefixed by a colon.
Nodes do not exist in a single state, but actually have a set of states. For
example, a node can be simultaneously "busy" and
"offline". The "free" state is the absence of all other
states and so is never combined with other states.
In order to execute pbsnodes with other than the
-a or
-l options,
the user must have PBS Manager or Operator privilege.
OPTIONS¶
- -a
- All attributes of a node or all nodes are listed. This is
the default if no flag is given.
- -x
- Same as -a, but the output has an XML-like format.
- -c
- Clear OFFLINE from listed nodes.
- -d
- Print MOM diagnosis on the listed nodes. Not yet
implemented. Use momctl instead.
- -o
- Add the OFFLINE state. This is different from being marked
DOWN. OFFLINE prevents new jobs from running on the specified nodes. This
gives the administrator a tool to hold a node out of service without
changing anything else. The OFFLINE state will never be set or cleared
automatically by pbs_server; it is purely for the manager or
operator.
- -p
- Purge the node record from pbs_server. Not yet
implemented.
- -r
- Reset the listed nodes by clearing OFFLINE and adding DOWN
state. pbs_server will ping the node and, if they communicate correctly,
free the node.
- -l
- List node names and their state. If no state is specified,
only nodes in the DOWN, OFFLINE, or UNKNOWN states are listed. Specifying
a state string acts as an output filter. Valid state strings are
"free", "offline", "down",
"reserve", "job-exclusive", "job-sharing",
"busy", "time-shared", or
"state-unknown".
- -N
- Specify a "note" attribute. This allows an
administrator to add an arbitrary annotation to the listed nodes. To clear
a note, use -N "" or -N n.
- -n
- Show the "note" attribute for nodes that are
DOWN, OFFLINE, or UNKNOWN. This option requires -l.
- -q
- Supress all error messages.
- -s
- Specify the PBS server's hostname or IP address.
SEE ALSO¶
pbs_server(8B) and the PBS External Reference Specification