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] [-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
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
36 attribute.
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
46 directory is given by the symbol $PBS_SERVER_HOME which
47 is typically /usr/spool/PBS.
48 -e Accept status update from any mom. Adds node to nodes
50 file.
51 -f Force overwrite of server database.
53 -h Print help information.
55 -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 -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 -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 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 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 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 cold All jobs are deleted. Positive confirmation is
106 required before this direction is accepted.
107 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 -v Shows version.
114 -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 -D Debug mode.
121 -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 -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 -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 -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 -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 --about Shows information about pbs_server.
156 --ha Enables high availability mode.
158 --help Prints help information.
160 --version Shows version and commit information.
162
164 $PBS_SERVER_HOME/server_priv
165 default directory for configuration files, typically
166 /usr/spool/pbs/server_priv
167 $PBS_SERVER_HOME/server_logs
169 directory for log files recorded by the server.
170
172 On receipt of the following signals, the server performs the defined
173 action:
174 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 SIGINT Causes an orderly shutdown of pbs_server.
180 SIGUSR1, SIGUSR2
182 Causes server to increase and decrease logging levels, respec‐
183 tively.
184 SIGTERM
186 Causes an orderly shutdown of pbs_server.
187 SIGSHUTDN
189 On systems (Unicos) where SIGSHUTDN is defined, it also causes
190 an orderly shutdown of the server.
191 SIGPIPE
193 This signal is ignored.
194 All other signals have their default behavior installed.
196
198 If the server command fails to begin batch operation, the server exits
199 with a value greater than zero.
200
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.
206Local pbs_server(8B)