(Click to open topic with navigation)

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