| TORQUE Resource Manager |
Appendix B: Server Parameters
TORQUE server parameters are specified using the qmgr command. Specifically, inside the qmgr command, the set subcommand should be used to modify the server object as in
| Parameter | Format | Default | Description |
| acl_hosts | <HOST>[,<HOST>]... | (all hosts allowed to submit jobs) |
specifies the list of hosts allowed to submit jobs. NOTE: can also be used to specify 'queue-to-host mapping'. (See TORQUE/OpenPBS Queue to Node Mapping in the Moab Workload Administrator's Guide for more information.) Example: |
| acl_host_enable | <BOOLEAN> | FALSE | specifies if the acl_hosts value is enabled |
| acl_logic_or | <BOOLEAN> | FALSE | specifies if user and group queue ACL's should be logically AND'd or logically OR'd |
| acl_roots | <username>@<domain> | --- | specifies which root users are allowed to submit and run jobs. |
| allow_node_submit | <BOOLEAN> | FALSE | specifies if users can submit jobs directly from any trusted compute host directly or from within batch jobs (See Configuring Job Submit Hosts) |
| allow_proxy_user | <BOOLEAN> | FALSE | specifies users can proxy from one user to another. Proxy requests will be either validated by ruserok() or by the scheduler. (See Job Submission Configuration.) |
| auto_node_np | <BOOLEAN> | DISABLED | Automatically configure a node's np value based on the ncpus value from the status update. Requires full manager privilege to set or alter. |
| default_queue | <STRING> | --- | indicates the queue to assign to a job if no queue is explicitly specified by the submitter |
| extra_resc | <STRING> | --- | Add additional string-type job resources. They have no effect within TORQUE and are only visible to the scheduler. They can not be used for resources_default/min/max. |
| job_nanny | <BOOLEAN> | FALSE | Enables the “job deletion nanny” feature. All job cancels will create a repeating task that will resend KILL signals if the initial job cancel failed. Further job cancels will be rejected with the message “job cancel in progress.” This is useful for temporary failures with a job’s execution node during a job delete request. |
| job_stat_rate | <INT> | 45 (set to 30 in TORQUE 1.2.0p5 and earlier) | specifies the maximum age of mom level job data which is allowed when servicing a qstat request. If data is older than this value, the pbs_server daemon will contact mom's with stale data to request an update. NOTE: For large systems, this value should be increased to 5 minutes or higher. |
| log_level | <INT> | 0 | specifies the pbs_server logging verbosity. Maximum value is 7. |
| log_file_max_size | <INT> | 0 | specifies a soft limit, in kilobytes, for the server’s log file. The filesize is checked every 5 minutes, and if the current day filesize is greater than or equal to this value then it will be rolled from X to X.1 and a new empty log will be opened. Any value ⇐ 0 will be ignored by pbs_server (the log will not be rolled). |
| log_file_roll_depth | <INT> | 1 | This parameter controlls how deep the current day log files will be rolled, if log_file_max_size is set, before they are deleted. |
| mail_domain | <STRING> | --- | Override the default domain for outgoing mail messages. If set, emails will be addressed to “euser@mail_domain”. If unset, the job’s Job_Owner attribute will be used. |
| managers | user@host.sub.domain[,user@host.sub.domain...] | root on the local host | List of users granted batch administrator privileges. The host, sub-domain, or domain name may be wildcarded by the use of an asterisk character (*). Requires full manager privilege to set or alter. |
| mom_job_sync | <BOOLEAN> | TRUE | specifies that the pbs_server will synchronize its view of the job queue and resource allocation with compute nodes as they come online. If a job exists on a compute node in a pre-execution or corrupt state, it will be automatically cleaned up and purged. (enabled by default in TORQUE 2.2.0 and higher) |
| operators | user@host.sub.domain[,user@host.sub.domain...] | root on the local host | List of users granted batch operator privileges. Requires full manager privilege to set or alter. |
| node_check_rate | <INT> | 600 | specifies the minimum duration (in seconds) that a node can be unresponsive to server queries before being marked down by the pbs_server daemon |
| node_pack | <BOOLEAN> | --- | Controls how multiple processor nodes are allocated to jobs. If this attribute is set to true, jobs will be assigned to the multiple processor nodes with the fewest free processors. This packs jobs into the fewest possible nodes leaving multiple processor nodes free for jobs which need many processors on a node. If set to false, jobs will be scattered across nodes reducing conflicts over memory between jobs. If unset, the jobs are packed on nodes in the order that the nodes are declared to the server (in the nodes file). Default value: unset - assigned to nodes as nodes in order that were declared. |
| node_ping_rate | <INT> | 300 | specifies the maximum interval (in seconds) between successive pings sent from the pbs_server daemon to the pbs_mom daemon to determine node/daemon health. |
| poll_jobs | <BOOLEAN> | TRUE (FALSE in TORQUE 1.2.0p5 and earlier) | if set to TRUE, pbs_server will poll job info from mom's over time and will not block on handling requests which require this job information. If not set, no polling will occur and if job information is requested which is stale, pbs_server may block while it attempts to update this information. NOTE: For large systems, this value should be set to TRUE. |
| query_other_jobs | <BOOLEAN> | FALSE | specifies whether or not non-admin users may view jobs they do not own |
| resources_available | <STRING> | --- | allows overriding of detected resource quantity limits (see queue resources_available) NOTE: pbs_server must be restarted for changes to take effect. Also, resources_available is constrained by the smallest of queue.resources_available and the server.resources_available. |
| submit_hosts | "<HOSTNAME>[,<HOSTNAME>]..." | --- | specifies the list of hosts beyonds the host running pbs_server which can submit batch or interactive jobs. (see Configuring Job Submit Hosts) |
| tcp_timeout | <INT> | 8 | specifies the pbs_server to pbs_mom TCP socket timeout in seconds. (see Considerations for Large Clusters) |
These parameters are set using the qmgr command. For example,