Provided by: torque-server_2.4.16+dfsg-1.3ubuntu1.1_amd64 bug

NAME

       pbs_server - start a pbs batch server

SYNOPSIS

       pbs_server [-a active] [-d config_path] [-p port] [-A acctfile] [-L logfile] [-M mom_port]
       [-R momRPP_port] [-S scheduler_port] [-H hostname] [-t type]

DESCRIPTION

       The pbs_server command starts  the  operation  of  a  batch  server  on  the  local  host.
       Typically, this command will be in a local boot file such as /etc/rc.local .  If the batch
       server is already in execution, pbs_server will exit with an error.  To  insure  that  the
       pbs_server  command  is  not  runnable by the general user community, the server will only
       execute if its real and effective uid is zero.

       The server will record a diagnostic message in a log file for any error  occurrence.   The
       log  files  are  maintained  in  the server_logs directory below the home directory of the
       server.  If the log file cannot be opened, the diagnostic message is written to the system
       console.

OPTIONS

       -a active      Specifies  if  scheduling is active or not.  This sets the server attribute
                      scheduling.  If the option argument is "true" ("True", "t", "T",  or  "1"),
                      the  server  is  active  and  the PBS job scheduler will be called.  If the
                      argument is "false" ("False", "f", "F", or "0), the server is idle, and the
                      scheduler  will  not  be called and no jobs will be run.  If this option is
                      not specified, the server will retain the prior  value  of  the  scheduling
                      attribute.

       -d config_path Specifies  the  path  of  the  directory  which  is  home  to  the  servers
                      configuration files, PBS_HOME.  A host may  have  multiple  servers.   Each
                      server   must  have  a  different  configuration  directory.   The  default
                      configuration directory is given by the symbol  $PBS_SERVER_HOME  which  is
                      typically /usr/spool/PBS.

       -p port        Specifies  the  port  number  on  which  the  server  will listen for batch
                      requests.  If multiple servers are running on a single host, each must have
                      its  own  unique  port  number.   This  option  is  for use in testing with
                      multiple batch systems on a single host.

       -A acctfile    Specifies an absolute path name of the file to use as the accounting  file.
                      If  not  specified,  the  file  is  named  for  the  current  date  in  the
                      PBS_HOME/server_priv/accounting directory.

       -l scheduler_port
                      Specifies the host name and port number of listening schedulers. By default
                      pbs_server  communicates  to the scheduler on the loop back address at port
                      15004. If the scheduler and pbs_server are not on  the  same  host  the  -l
                      option  tells pbs_server where to find the scheduler.  When using TORQUE in
                      high availability mode the -l option should be  used  to  let  TORQUE  know
                      where all potential schedulers are located. If pbs_server and the scheduler
                      are not on the same node the -l option or the -S option  must  be  used  in
                      order for TORQUE to communicate with the scheduler.

       -L logfile     Specifies an absolute path name of the file to use as the log file.  If not
                      specified,  the  file  is  one  named  for  the   current   date   in   the
                      PBS_HOME/server_logs directory, see the -d option.

       -M mom_port    Specifies  the  host  name  and/or  port  number on which the server should
                      connect the job executor, MOM.  The option argument, mom_conn,  is  one  of
                      the   forms:   host_name,  [:]port_number,  or  host_name:port_number.   If
                      host_name not specified, the local host is assumed.   If port_number is not
                      specified, the default port is assumed.  See the -M option for pbs_mom(8).

       -R mom_RPPport Specifies  the port number on which the the server should query the up/down
                      status of Mom.    See the -R option for pbs_mom(8).

       -S scheduler_port
                      Specifies  the  port  number  to  which  the  server  should  connect  when
                      contacting the Scheduler.  By default pbs_server looks for the scheduler on
                      the loopback address at port 15004. The -S option changes  the  default  to
                      the   value   given   in   the   option   argument.  The  option  argument,
                      scheduler_conn, is of the same syntax as under the -M option.

       -H hostname    Causes the server to start under a  different  hostname  as  obtained  from
                      gethostname(2).  Useful  for  servers  with  multiple network interfaces to
                      support connections from clients over an  interface  that  has  a  hostname
                      assigned that differs from the one that is returned by gethostname(2).

       -t type        Specifies  the  impact  on  jobs which were in execution, running, when the
                      server shut down.  If the running job is not rerunnable or restartable from
                      a  checkpoint  image,  the  job  is  aborted.   If the job is rerunnable or
                      restartable, then the actions described below are  taken.   When  the  type
                      argument is:

                      hot     All   jobs  are  requeued  except  non-rerunnable  jobs  that  were
                              executing.  Any rerunnable job which was executing when the  server
                              went  down will be run immediately.  This returns the server to the
                              same state as when it went down.  After those jobs  are  restarted,
                              then normal scheduling takes place for all remaining queued jobs.

                              If  a  job  cannot  be  restarted  immediately because of a missing
                              resource, such as a node being down,  the server  will  attempt  to
                              restart  it  periodically  for upto 5 minutes.   After that period,
                              the server will revert to a normal state, as if warm  started,  and
                              will  no  longer  attempt  to restart any remaining jobs which were
                              running prior to the shutdown.

                      warm    All rerunnable jobs which were running when the  server  went  down
                              are  requeued.   All other jobs are maintained.  New selections are
                              made for which jobs are placed into execution.  Warm is the default
                              if -t is not specified.

                      cold    All  jobs  are  deleted.   Positive confirmation is required before
                              this direction is accepted.

                      create  The server will discard any existing  configuration  files,  queues
                              and jobs, and initialize configuration files to the default values.
                              The server is idled.

FILES

       $PBS_SERVER_HOME/server_priv
                      default     directory     for      configuration      files,      typically
                      /usr/spool/pbs/server_priv

       $PBS_SERVER_HOME/server_logs
                      directory for log files recorded by the server.

Signal Handling

       On receipt of the following signals, the server performs the defined action:

       SIGHUP The current server log and accounting log are closed and reopened.  This allows for
              the prior log to be renamed and a new log started from the time of the signal.

       SIGINT Causes an orderly shutdown of pbs_server.

       SIGUSR1, SIGUSR2
              Causes server to increase and decrease logging levels, respectively.

       SIGTERM
              Causes an orderly shutdown of pbs_server.

       SIGSHUTDN
              On systems (Unicos) where SIGSHUTDN is defined, it also causes an orderly  shutdown
              of the server.

       SIGPIPE
              This signal is ignored.

       All other signals have their default behavior installed.

EXIT STATUS

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

SEE ALSO

       qsub   (1B),   pbs_connect(3B),   pbs_mom(8B),   pbs_sched_basl(8B),    pbs_sched_tcl(8B),
       pbsnodes(8B),   qdisable(8B),  qenable(8B),  qmgr(1B),  qrun(8B),  qstart(8B),  qstop(8B),
       qterm(8B), and the PBS External Reference Specification.