pbs_server(8B)

💖 pbs_server(8B) — start a pbs batch server 💖

Okay bestie, gather round, because we're about to talk about pbs_server(8B) — the literal main character of your PBS setup. This is the command that gets the whole batch server party started on your local host. Periodt.

---

🌸 SYNOPSIS 🌸

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

---

✨ DESCRIPTION ✨

So pbs_server starts the operation of a batch server on the local host. Ngl, you'll usually find this command chilling in a local boot file like /etc/rc.local. 💅

If the batch server is already running, pbs_server will just exit with an error — like, it's not gonna double-book itself, okay? And to make sure the general user community can't just run this whenever, the server will only execute if its real and effective uid is zero. Security queen behavior. 👑

Whenever an error happens, the server records a diagnostic message in a log file. Those log files live in the server_logs directory below the home directory of the server. And if the log file can't be opened? The diagnostic message gets written to the system console instead. Backup plan, slay. 💖

---

🎀 OPTIONS 🎀

• -a active — Specifies if scheduling is active or not, and 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, 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. Lowkey important, don't skip this one. ✨
• -c — Wait 10 minutes before contacting moms. Any mom reporting in does not get pinged if starting pbs_server before moms. Patience is a virtue, bestie. 🕰️
• -d config_path — Specifies the path of the directory which is home to the server's configuration files, PBS_HOME. A host may have multiple servers, and 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. 🏠
• -e — Accept status update from any mom. Adds node to nodes file. 🫶
• -F — Do not fork. Use when running under systemd. Not me explaining this like it's obvious, but yeah. 💀
• -f — Force overwrite of server database. Use with caution, okay? This one means business. 🔥
• -h — Print help information. Your fave. 🌈
• -l location — Specifies where to find the scheduler (for example, Moab) when it does not reside on the same host as Torque. Example: pbs_server -1 <other_host>:<other_port>. Copy that exactly, iykyk. 📍
• -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. 🎯
• -t type — If the job is rerunnable or restartable, and -t create is specified, the server will discard any existing configuration files, queues, and jobs, and initialize configuration files to the default values. The server is idled. If -t is not specified, job states will remain the same. So like, fresh start vibes only if you ask for it. 🦋
• -v — Shows version. Short and sweet. ⭐
• -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. Money moves, bestie. 💸
• -D — Debug mode. Do not fork. For when you need to see everything. 🙈
• -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). Main character energy with multiple identities, honestly. 🧚
• -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. Keep your receipts, bestie. 🧾
• -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 is 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). MOM said come through. 💅
• -n don't send heirarchy — Directs pbs_server to not send the hierarchy to all the MOMs on startup. Instead, the hierarchy is only sent if a MOM requests it. This flag works only in conjunction with the local MOM hierarchy feature. Selective sending, we love a boundaries queen. 🚪
• -R mom_RPPport — Specifies the port number on which the server should query the up/down status of Mom. See the -R option for pbs_mom(8). Checking in on mom, cute. 🩺
• -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. Scheduler link-up, let's go. 📡
• --about — Shows information about pbs_server. 👀
• --ha — Enables high availability mode. For when you literally cannot afford downtime. 💯
• --help — Prints help information. Because sometimes we all need a little help. 🫶
• --version — Shows version and commit information. Receipts included. 🎀

---

📂 FILES 📂

• $PBS_SERVER_HOME/server_priv — default directory for configuration files, typically /usr/spool/pbs/server_priv. This is where the config besties live. 🏡
• $PBS_SERVER_HOME/server_logs — directory for log files recorded by the server. All the drama gets written down here. 📝

---

🌈 Signal Handling 🌈

On receipt of the following signals, the server performs the defined action. Signal queen behavior, honestly.

• 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. Fresh log, who dis. 🔄
• SIGINT — Causes an orderly shutdown of pbs_server. Graceful exit, we stan. ✨
• SIGUSR1, SIGUSR2 — Causes server to increase and decrease logging levels, respectively. Turn the volume up, turn the volume down. 🔊
• SIGTERM — Causes an orderly shutdown of pbs_server. Another graceful goodbye. 💜
• SIGSHUTDN — On systems (Unicos) where SIGSHUTDN is defined, it also causes an orderly shutdown of the server. Special shoutout to Unicos. 🌟
• SIGPIPE — This signal is ignored. Not today, signal. 🚫
• All other signals have their default behavior installed. The rest are just doing their own thing. 💅

---

⭐ EXIT STATUS ⭐

If the server command fails to begin batch operation, the server exits with a value greater than zero. So like, if it flops, you'll know. 😭

---

👑 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. The whole friend group, fr fr. 🫶

---

Okay that's the whole page, bestie. Every flag, every signal, every file path — all of it. No cap. 💖

With love from the Local manual, pbs_server(8B) — version and date included, iconic as always. 🌸💅✨