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] [-h] [-l port]
10       [-p port] [-t type] [-v] [-A acctfile] [-D] [-H hostname]  [-L logfile]
11       [-M mom_port]  [-R momRPP_port]  [-S scheduler_port]  [--about]  [--ha]
12       [--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
36                      attribute.
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
46                      directory is given by the symbol $PBS_SERVER_HOME  which
47                      is typically /usr/spool/PBS.
48
49       -e             Accept  status  update  from any mom. Adds node to nodes
50                      file.
51
52       -f             Force overwrite of server database.
53
54       -h             Print help information.
55
56       -l scheduler_port
57                      Specifies the host name and  port  number  of  listening
58                      schedulers.  By  default  pbs_server communicates to the
59                      scheduler on the loop back address at port 15004. If the
60                      scheduler and pbs_server are not on the same host the -l
61                      option tells pbs_server where  to  find  the  scheduler.
62                      When  using  TORQUE  in  high  availability  mode the -l
63                      option should be used  to  let  TORQUE  know  where  all
64                      potential  schedulers are located. If pbs_server and the
65                      scheduler are not on the same node the -l option or  the
66                      -S  option  must be used in order for TORQUE to communi‐
67                      cate with the scheduler.
68
69       -p port        Specifies the port number on which the server will  lis‐
70                      ten for batch requests.  If multiple servers are running
71                      on a single host, each must have  its  own  unique  port
72                      number.  This option is for use in testing with multiple
73                      batch systems on a single host.
74
75       -t type        Specifies the impact on jobs which  were  in  execution,
76                      running,  when the server shut down.  If the running job
77                      is not  rerunnable  or  restartable  from  a  checkpoint
78                      image,  the job is aborted.  If the job is rerunnable or
79                      restartable, then the actions described below are taken.
80                      When the type argument is:
81
82                      hot     All jobs are requeued except non-rerunnable jobs
83                              that were executing.  Any rerunnable  job  which
84                              was  executing when the server went down will be
85                              run immediately.  This returns the server to the
86                              same  state  as  when it went down.  After those
87                              jobs are restarted, then normal scheduling takes
88                              place for all remaining queued jobs.
89
90                              If a job cannot be restarted immediately because
91                              of a missing resource,  such  as  a  node  being
92                              down,   the  server  will  attempt to restart it
93                              periodically for upto 5  minutes.    After  that
94                              period,  the  server  will  revert  to  a normal
95                              state, as if warm started, and  will  no  longer
96                              attempt to restart any remaining jobs which were
97                              running prior to the shutdown.
98
99                      warm    All rerunnable jobs which were running when  the
100                              server  went  down are requeued.  All other jobs
101                              are maintained.  New  selections  are  made  for
102                              which  jobs  are placed into execution.  Warm is
103                              the default if -t is not specified.
104
105                      cold    All jobs are deleted.  Positive confirmation  is
106                              required before this direction is accepted.
107
108                      create  The  server will discard any existing configura‐
109                              tion files, queues and jobs, and initialize con‐
110                              figuration  files  to  the  default values.  The
111                              server is idled.
112
113       -v             Shows version.
114
115       -A acctfile    Specifies an absolute path name of the file  to  use  as
116                      the  accounting  file.   If  not  specified, the file is
117                      named    for     the     current     date     in     the
118                      PBS_HOME/server_priv/accounting directory.
119
120       -D             Debug mode.
121
122       -H hostname    Causes the server to start under a different hostname as
123                      obtained from gethostname(2). Useful  for  servers  with
124                      multiple  network interfaces to support connections from
125                      clients over an interface that has a  hostname  assigned
126                      that  differs  from the one that is returned by gethost‐
127                      name(2).
128
129       -L logfile     Specifies an absolute path name of the file  to  use  as
130                      the  log  file.  If not specified, the file is one named
131                      for the current date in the PBS_HOME/server_logs  direc‐
132                      tory, see the -d option.
133
134       -M mom_port    Specifies  the host name and/or port number on which the
135                      server should connect the job executor, MOM.  The option
136                      argument,  mom_conn,  is  one  of  the forms: host_name,
137                      [:]port_number, or host_name:port_number.  If  host_name
138                      not specified, the local host is assumed.   If port_num‐
139                      ber is not specified, the default port is assumed.   See
140                      the -M option for pbs_mom(8).
141
142       -R mom_RPPport Specifies the port number on which the the server should
143                      query the up/down status of Mom.    See  the  -R  option
144                      for pbs_mom(8).
145
146       -S scheduler_port
147                      Specifies  the  port  number  to which the server should
148                      connect  when  contacting  the  Scheduler.   By  default
149                      pbs_server  looks  for  the  scheduler  on  the loopback
150                      address at port 15004. The -S option changes the default
151                      to  the  value  given in the option argument. The option
152                      argument, scheduler_conn, is of the same syntax as under
153                      the -M option.
154
155       --about        Shows information about pbs_server.
156
157       --ha           Enables high availability mode.
158
159       --help         Prints help information.
160
161       --version      Shows version and commit information.
162

FILES

164       $PBS_SERVER_HOME/server_priv
165                      default  directory  for  configuration  files, typically
166                      /usr/spool/pbs/server_priv
167
168       $PBS_SERVER_HOME/server_logs
169                      directory for log files recorded by the server.
170

Signal Handling

172       On receipt of the following signals, the server  performs  the  defined
173       action:
174
175       SIGHUP The  current  server  log  and  accounting  log  are  closed and
176              reopened.  This allows for the prior log to be renamed and a new
177              log started from the time of the signal.
178
179       SIGINT Causes an orderly shutdown of pbs_server.
180
181       SIGUSR1, SIGUSR2
182              Causes  server  to increase and decrease logging levels, respec‐
183              tively.
184
185       SIGTERM
186              Causes an orderly shutdown of pbs_server.
187
188       SIGSHUTDN
189              On systems (Unicos) where SIGSHUTDN is defined, it  also  causes
190              an orderly shutdown of the server.
191
192       SIGPIPE
193              This signal is ignored.
194
195       All other signals have their default behavior installed.
196

EXIT STATUS

198       If  the server command fails to begin batch operation, the server exits
199       with a value greater than zero.
200

SEE ALSO

202       qsub   (1B),    pbs_connect(3B),    pbs_mom(8B),    pbs_sched_basl(8B),
203       pbs_sched_tcl(8B),  pbsnodes(8B),  qdisable(8B), qenable(8B), qmgr(1B),
204       qrun(8B), qstart(8B), qstop(8B), qterm(8B), and the PBS External Refer‐
205       ence Specification.
206
207
208
209Local                                                           pbs_server(8B)
Impressum