pbsnodes(8)

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

NAME

6       pbsnodes - pbs node manipulation
7

SYNOPSIS

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

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

SEE ALSO