pbsnodes(8)

1pbsnodes(8B)                          PBS                         pbsnodes(8B)
2
3
4

NAME

6       pbsnodes - pbs node manipulation
7

SYNOPSIS

9       pbsnodes [-{a|x}] [-q] [-s server] [node|:property]
10       pbsnodes -l [-q] [-s server] [state] [nodename|:property ...]
11       pbsnodes  [-{c|d|o|r}]  [-q]  [-s server] [-n] [-N "note"] [node|:prop‐
12       erty]
13
14

DESCRIPTION

16       The pbsnodes command is used to mark nodes down, free or  offline.   It
17       can  also  be  used to list nodes and their state.  Node information is
18       obtained by sending a request to the PBS job server.  Sets of nodes can
19       be  operated  on  at  once  by specifying a node property prefixed by a
20       colon.
21       Nodes do not exist in a single  state,  but  actually  have  a  set  of
22       states.   For  example,  a  node can be simultaneously "busy" and "off‐
23       line".  The "free" state is the absence of all other states and  so  is
24       never combined with other states.
25
26       In  order to execute pbsnodes with other than the -a or -l options, the
27       user must have PBS Manager or Operator privilege.
28

OPTIONS

30       -a             All attributes of a node or all nodes are listed.   This
31                      is the default if no flag is given.
32
33       -x             Same as -a, but the output has an XML-like format.
34
35       -c             Clear OFFLINE from listed nodes.
36
37       -d             Print MOM diagnosis on the listed nodes.  Not yet imple‐
38                      mented.  Use momctl instead.
39
40       -o             Add the OFFLINE state.  This  is  different  from  being
41                      marked  DOWN.  OFFLINE prevents new jobs from running on
42                      the specified nodes.  This  gives  the  administrator  a
43                      tool to hold a node out of service without changing any‐
44                      thing else.  The OFFLINE state  will  never  be  set  or
45                      cleared  automatically  by  pbs_server; it is purely for
46                      the manager or operator.
47
48       -p             Purge the node record from pbs_server.  Not  yet  imple‐
49                      mented.
50
51       -r             Reset  the  listed  nodes by clearing OFFLINE and adding
52                      DOWN state.  pbs_server will ping the node and, if  they
53                      communicate correctly, free the node.
54
55       -l             List  node names and their state.  If no state is speci‐
56                      fied, only nodes in the DOWN, OFFLINE, or UNKNOWN states
57                      are listed.  Specifying a state string acts as an output
58                      filter.  Valid  state  strings  are  "free",  "offline",
59                      "down",   "reserve",   "job-exclusive",   "job-sharing",
60                      "busy", "time-shared", or "state-unknown".
61
62       -N             Specify a "note" attribute.  This allows an  administra‐
63                      tor  to add an arbitrary annotation to the listed nodes.
64                      To clear a note, use -N "" or -N n.
65
66       -n             Show the "note" attribute for nodes that are DOWN,  OFF‐
67                      LINE, or UNKNOWN.  This option requires -l.
68
69       -q             Supress all error messages.
70
71       -s             Specify the PBS server's hostname or IP address.
72

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

SEE ALSO