5.355 "torque.cfg" Configuration File

Administrators can configure the torque.cfg file (located in PBS_SERVER_HOME (/var/spool/torque by default)) to alter the behavior of the qsub command on specific host machines where the file resides. This file contains a list of parameters and values separated by whitespace. This only affects qsub, and only on each specific host with the file.

5.355.1 Configuration Parameters

CLIENTRETRY

DEFAULTCKPT

FAULT_TOLERANT_BY_DEFAULT

HOST_NAME_SUFFIX

INTERACTIVE_PORT_RANGE

CLIENTRETRY
Format	<INT>
Default	0
Description	Seconds between retry attempts to talk to pbs_server.
Example	CLIENTRETRY 10 Torque waits 10 seconds after a failed attempt before it attempts to talk to pbs_server again.

DEFAULTCKPT
For mat	One of None, Enabled, Shutdown, Periodic, Interval=minutes, depth=number, or dir=path
Default	None
Description	Default value for job's checkpoint attribute. For a description of all possible values, see qsub This default setting can be overridden at job submission with the qsub -c option.
Example	DEFAULTCKPT Shutdown By default, Torque checkpoints at pbs_mom shutdown.

FAULT_TOLERANT_BY_DEFAULT
Format	<BOOLEAN>
Default	FALSE
Description	Sets all jobs to fault tolerant by default. (See qsub -f for more information on fault tolerance.)
Example	FAULT_TOLERANT_BY_DEFAULT TRUE Jobs are fault tolerant by default. They will not be canceled based on failed polling, no matter how many nodes fail to report.

HOST_NAME_SUFFIX
Format	<STRING>
Default	---
Description	Specifies a hostname suffix. When qsub submits a job, it also submits the username of the submitter and the name of the host from which the user submitted the job. Torque appends the value of HOST_NAME_SUFFIX to the hostname. This is useful for multi-homed systems that may have more than one name for a host.
Example	HOST_NAME_SUFFIX -ib When a job is submitted, the -ib suffix is appended to the host name.

INTERACTIVE_PORT_RANGE
Format	<INTEGER>-<INTEGER>
Default	---
Description	Sets a range of ports for interactive jobs. The minimum port must be greater than 1024, and the maximum port must be greater than the minimum port, or else the setting will be ignored.
Example	INTERACTIVE_PORT_RANGE 20000-20100 Force all interactive listening ports on this host to be between 20000 and 20100, inclusive.

QSUBHOST
Format	<HOSTNAME>
Default	---
Description	The hostname given as the argument of this option will be used as the PBS_O_HOST variable for job submissions. By default, PBS_O_HOST is the hostname of the submission host. This option allows administrators to override the default hostname and substitute a new name.
Example	QSUBHOST host1 The default hostname associated with a job is host1.

QSUBSENDUID
Format	N/A
Default	---
Description	Integer for job's PBS_O_UID variable. Specifying the parameter name anywhere in the config file enables the feature. Removing the parameter name disables the feature.
Example	QSUBSENDUID Torque assigns a unique ID to a job when it is submitted by qsub.

QSUBSLEEP
Format	<INT>
Default	0
Description	Specifies time, in seconds, to sleep between a user's submitting and Torque's starting a qsub command. Used to prevent users from overwhelming the scheduler.
Example	QSUBSLEEP 2 When a job is submitted with qsub, it will sleep for 2 seconds.

RERUNNABLEBYDEFAULT
Format	<BOOLEAN>
Default	TRUE
Description	Specifies if a job is re-runnable by default. Setting this to false causes the re-runnable attribute value to be false unless the users specifies otherwise with the qsub -r option. (New in Torque 2.4.)
Example	RERUNNABLEBYDEFAULT FALSE By default, qsub jobs cannot be rerun.

SERVERHOST
Format	<STRING>
Default	localhost
Description	If set, the qsub command will open a connection to the host specified by the SERVERHOST string.
Example	SERVERHOST orion15 The server will open socket connections and and communicate using serverhost orion15.

SUBMITFILTER
Format	<STRING>
Default	/usr/local/sbin/torque_submitfilter
Description	Specifies the location of the submit filter (see Job Submission Filter ("qsub Wrapper") used to pre-process job submission.
Example	SUBMITFILTER /usr/local/sbin/torque_submitfilter The location of the submit filter is specified as /usr/local/sbin/torque_submitfilter.

TRQ_IFNAME
Format	<STRING>
Default	null
Description	Allows you to specify a specific network interface to use for outbound Torque requests. The string is the name of a network interface, such as eth0 or eth1, depending on which interface you want to use.
Example	TRQ_IFNAME eth1 Outbound Torque requests are handled by eth1.

VALIDATEGROUP
Format	<BOOLEAN>
Default	FALSE
Description	Validate submit user's group on qsub commands. For Torque builds released after 2/8/2011, VALIDATEGROUP also checks any groups requested in group_list at the submit host. Set VALIDATEGROUP to "TRUE" if you set disable_server_id_check to TRUE.
Example	VALIDATEGROUP TRUE qsub verifies the submitter's group ID.

VALIDATEPATH
Format	<BOOLEAN>
Default	TRUE
Description	Validate local existence of -d and/or -w working directories.
Example	VALIDATEPATH FALSE qsub does not validate the path.