Appendices > Appendix K: "torque.cfg" configuration file

Appendix K: "torque.cfg" configuration file

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 the qsub -c documentation.

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_OUID 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 ${libexecdir}/qsub_filter (for version 2.1 and older: /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/qsub_filter

The location of the submit filter is specified as /usr/local/sbin/qsub_filter.

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' working directory.
Example
VALIDATEPATH FALSE

qsub does not validate the path.

© 2014 Adaptive Computing