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

NAME

6       pbs_server - start a pbs batch server
7

SYNOPSIS

9       pbs_server [-a  active]  [-c]  [-d config_path] [-e] [-F] [-f] [-h] [-l
10       location] [-p port] [-t type]  [-v]  [-A acctfile]  [-D]  [-H hostname]
11       [-L logfile]  [-M mom_port]  [-n don't send hierarchy] [-R momRPP_port]
12       [-S scheduler_port] [--about] [--ha] [--help] [--version]
13

DESCRIPTION

15       The pbs_server command starts the operation of a batch  server  on  the
16       local  host.  Typically, this command will be in a local boot file such
17       as /etc/rc.local .  If  the  batch  server  is  already  in  execution,
18       pbs_server will exit with an error.  To insure that the pbs_server com‐
19       mand is not runnable by the general user  community,  the  server  will
20       only execute if its real and effective uid is zero.
21
22       The server will record a diagnostic message in a log file for any error
23       occurrence.  The log files are maintained in the server_logs  directory
24       below  the  home  directory  of  the server.  If the log file cannot be
25       opened, the diagnostic message is written to the system console.
26

OPTIONS

28       -a active      Specifies if scheduling is active or not.  This sets the
29                      server  attribute  scheduling. If the option argument is
30                      "true" ("True", "t", "T", or "1"), the server is  active
31                      and  the PBS job scheduler will be called.  If the argu‐
32                      ment is "false" ("False", "f", "F", or "0),  the  server
33                      is  idle,  and  the  scheduler will not be called and no
34                      jobs will be run.  If this option is not specified,  the
35                      server will retain the prior value of the scheduling at‐
36                      tribute.
37
38       -c             Wait 10 minutes before contacting moms. Any mom  report‐
39                      ing in does not get pinged if starting pbs_server before
40                      moms.
41
42       -d config_path Specifies the path of the directory which is home to the
43                      servers  configuration files, PBS_HOME.  A host may have
44                      multiple servers.  Each server  must  have  a  different
45                      configuration  directory.  The default configuration di‐
46                      rectory is given by the symbol $PBS_SERVER_HOME which is
47                      typically /usr/spool/PBS.
48
49       -e             Accept  status  update  from any mom. Adds node to nodes
50                      file.
51
52       -F             Do not fork. Use when running under systemd.
53
54       -f             Force overwrite of server database.
55
56       -h             Print help information.
57
58       -l location    Specifies where to  find  the  scheduler  (for  example,
59                      Moab)  when  it  does  not  reside  on  the same host as
60                      Torque.          Example:         pbs_server          -1
61                      <other_host>:<other_port>
62
63       -p port        Specifies  the port number on which the server will lis‐
64                      ten for batch requests.  If multiple servers are running
65                      on  a  single  host,  each must have its own unique port
66                      number.  This option is for use in testing with multiple
67                      batch systems on a single host.
68
69       -t type        If  the  job is rerunnable or restartable, and -t create
70                      is specified, the server will discard any existing  con‐
71                      figuration  files, queues, and jobs, and initialize con‐
72                      figuration files to the default values.  The  server  is
73                      idled.   If  -t is not specified, job states will remain
74                      the same.
75
76       -v             Shows version.
77
78       -A acctfile    Specifies an absolute path name of the file  to  use  as
79                      the  accounting  file.   If  not  specified, the file is
80                      named    for     the     current     date     in     the
81                      PBS_HOME/server_priv/accounting directory.
82
83       -D             Debug mode. Do not fork.
84
85       -H hostname    Causes the server to start under a different hostname as
86                      obtained from gethostname(2). Useful  for  servers  with
87                      multiple  network interfaces to support connections from
88                      clients over an interface that has a  hostname  assigned
89                      that  differs  from the one that is returned by gethost‐
90                      name(2).
91
92       -L logfile     Specifies an absolute path name of the file  to  use  as
93                      the  log  file.  If not specified, the file is one named
94                      for the current date in the PBS_HOME/server_logs  direc‐
95                      tory, see the -d option.
96
97       -M mom_port    Specifies  the host name and/or port number on which the
98                      server should connect the job executor, MOM.  The option
99                      argument,  mom_conn,  is  one  of  the forms: host_name,
100                      [:]port_number, or host_name:port_number.  If  host_name
101                      not specified, the local host is assumed.   If port_num‐
102                      ber is not specified, the default port is assumed.   See
103                      the -M option for pbs_mom(8).
104
105       -n don't send heirarchy
106                      Directs  pbs_server to not send the hierarchy to all the
107                      MOMs on startup. Instead, the hierarchy is only sent  if
108                      a  MOM  requests it. This flag works only in conjunction
109                      with the local MOM hierarchy feature.
110
111       -R mom_RPPport Specifies the port number on which the the server should
112                      query  the  up/down  status of Mom.    See the -R option
113                      for pbs_mom(8).
114
115       -S scheduler_port
116                      Specifies the port number to  which  the  server  should
117                      connect  when  contacting  the  Scheduler.   By  default
118                      pbs_server looks for the scheduler on the  loopback  ad‐
119                      dress  at  port 15004. The -S option changes the default
120                      to the value given in the option  argument.  The  option
121                      argument, scheduler_conn, is of the same syntax as under
122                      the -M option.
123
124       --about        Shows information about pbs_server.
125
126       --ha           Enables high availability mode.
127
128       --help         Prints help information.
129
130       --version      Shows version and commit information.
131

FILES

133       $PBS_SERVER_HOME/server_priv
134                      default directory  for  configuration  files,  typically
135                      /usr/spool/pbs/server_priv
136
137       $PBS_SERVER_HOME/server_logs
138                      directory for log files recorded by the server.
139

Signal Handling

141       On  receipt  of  the following signals, the server performs the defined
142       action:
143
144       SIGHUP The current server log and accounting log  are  closed  and  re‐
145              opened.   This  allows for the prior log to be renamed and a new
146              log started from the time of the signal.
147
148       SIGINT Causes an orderly shutdown of pbs_server.
149
150       SIGUSR1, SIGUSR2
151              Causes server to increase and decrease logging  levels,  respec‐
152              tively.
153
154       SIGTERM
155              Causes an orderly shutdown of pbs_server.
156
157       SIGSHUTDN
158              On  systems  (Unicos) where SIGSHUTDN is defined, it also causes
159              an orderly shutdown of the server.
160
161       SIGPIPE
162              This signal is ignored.
163
164       All other signals have their default behavior installed.
165

EXIT STATUS

167       If the server command fails to begin batch operation, the server  exits
168       with a value greater than zero.
169

SEE ALSO

171       qsub    (1B),    pbs_connect(3B),    pbs_mom(8B),   pbs_sched_basl(8B),
172       pbs_sched_tcl(8B), pbsnodes(8B), qdisable(8B),  qenable(8B),  qmgr(1B),
173       qrun(8B), qstart(8B), qstop(8B), qterm(8B), and the PBS External Refer‐
174       ence Specification.
175
176
177
178Local                                                           pbs_server(8B)
Impressum