1pbs_server(8B) PBS pbs_server(8B)
2
6 pbs_server - start a pbs batch server
7
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
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 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
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 -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 -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 -e Accept status update from any mom. Adds node to nodes
50 file.
51 -F Do not fork. Use when running under systemd.
53 -f Force overwrite of server database.
55 -h Print help information.
57 -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 -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 -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 -v Shows version.
77 -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 -D Debug mode. Do not fork.
84 -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 -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 -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 -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 -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 -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 --about Shows information about pbs_server.
125 --ha Enables high availability mode.
127 --help Prints help information.
129 --version Shows version and commit information.
131
133 $PBS_SERVER_HOME/server_priv
134 default directory for configuration files, typically
135 /usr/spool/pbs/server_priv
136 $PBS_SERVER_HOME/server_logs
138 directory for log files recorded by the server.
139
141 On receipt of the following signals, the server performs the defined
142 action:
143 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 SIGINT Causes an orderly shutdown of pbs_server.
149 SIGUSR1, SIGUSR2
151 Causes server to increase and decrease logging levels, respec‐
152 tively.
153 SIGTERM
155 Causes an orderly shutdown of pbs_server.
156 SIGSHUTDN
158 On systems (Unicos) where SIGSHUTDN is defined, it also causes
159 an orderly shutdown of the server.
160 SIGPIPE
162 This signal is ignored.
163 All other signals have their default behavior installed.
165
167 If the server command fails to begin batch operation, the server exits
168 with a value greater than zero.
169
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.
175Local pbs_server(8B)