You are here: Appendices > Appendix K: "torque.cfg" Configuration File

K.1 "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.

K.1.1 Configuration Parameters

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.

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.