pbsnodes(8B)
pbsnodes(8B) TORQUE pbsnodes(8B)
NAME
pbsnodes - pbs node query and control
SYNOPSIS
pbsnodes [-{c|d|o|p|r}][-s server] [-q] [-N "note"] [-x] node node ...
pbsnodes -l [-s server] [-n] [-q]
pbsnodes -a [-s server] [-q] [node]
DESCRIPTION
The pbsnodes command is used to mark nodes down, free or off line. It
can also be used to list nodes and their state. Node information is
obtained by sending a request to the PBS job server.
If pbsnodes is run without options (other than -s )), the nodes speci-
fied as operands are marked DOWN and unavailable to run jobs. It is
important that all the nodes known to be down are given as arguments
on the command line. This is because nodes which are not listed are
assumed to be UP and will be indicated as such if they were previously
marked DOWN. None of the other options will change the marking for
nodes which are not given on the command line.
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 nodes and their attributes are listed. The
attributes include "state" and "properities".
-c Clear OFFLINE or DOWN from listed nodes. The listed
nodes are "free" to be allocated to jobs.
-d Diagnose node state. Report health information for
node.
-l List all nodes marked in any way.
-N Specify a "note" attribute. This allows an administra‐
tor 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.
-o Mark listed nodes as OFFLINE even if currently in use.
This is different from being marked DOWN. An automated
script that checks nodes being up or down and calls
pbsnodes with a list of nodes down will not change the
status of nodes marked OFFLINE. This gives the adminis-
trator a tool to hold a node out of service without
changing the automatic script.
-p Purge node. Remove stale node reference.
-q Use Quiet mode.
-r clear OFFLINE from listed nodes.
-s specify the PBS server to which to connect.
-x display results in XML.
SEE ALSO
pbs_server(8B) and the PBS External Reference Specification
Local pbsnodes(8B)
|
