Appendices > Appendix C: Node manager (MOM) configuration > Parameters

C.1 Parameters

arch
Format <STRING>
Description Specifies the architecture of the local machine. This information is used by the scheduler only.
Example arch ia64
$alias_server_name
Format <STRING>
Description

(Applicable in version 2.5.0 and later.) Allows the MOM to accept an additional pbs_server host name as a trusted address.

This feature was added to overcome a problem with UDP and RPP where alias IP addresses are used on a server. With alias IP addresses a UDP packet can be sent to the alias address but the UDP reply packet will come back on the primary IP address. RPP matches addresses from its connection table to incoming packets. If the addresses do not match an entry in the RPP table, the packet is dropped. This feature allows an additional address for the server to be added to the table so legitimate packets are not dropped.

Example $alias_server_name node01
$reject_job_submission
Format <BOOLEAN>
Description

If set to TRUE, jobs will be rejected and the user will receive the message, "Jobs cannot be run on mom %s." Default is FALSE.

Example $reject_job_submission job01
$attempt_to_make_dir
Format <BOOLEAN>
Description

When set to TRUE, specifies that you want TORQUE to attempt to create the output directories for jobs if they do not already exist.

Default is FALSE.

TORQUE uses this parameter to make the directory as the user and not as root. TORQUE will create the directory (or directories) ONLY if the user has permissions to do so.

Example $attempt_to_make_dir true
$clienthost
Format <STRING>
Description

Specifies the machine running pbs_server.

This parameter is deprecated. Use $pbsserver.

Example $clienthost node01.teracluster.org
$check_poll_time
Format <STRING>
Description Amount of time between checking running jobs, polling jobs, and trying to resend obituaries for jobs that haven't sent successfully. Default is 45 seconds.
Example $check_poll_time 90
$configversion
Format <STRING>
Description Specifies the version of the config file data.
Example $configversion 113
$cputmult
Format <FLOAT>
Description

CPU time multiplier.

If set to 0.0, MOM level cputime enforcement is disabled.

Example $cputmult 2.2
$ext_pwd_retry
Format <INTEGER>
Description

(Available in TORQUE 2.5.10, 3.0.4, and later.) Specifies the number of times to retry checking the password. Useful in cases where external password validation is used,such as with LDAP.

The default value is 3 retries.

Example $ext_pwd_retry = 5
$ideal_load
Format <FLOAT>
Description Ideal processor load.
Example $ideal_load 4.0
$igncput
Format <BOOLEAN>
Description Ignores limit violation pertaining to CPU time. Default is FALSE.
Example $igncput true
$ignmem
Format <BOOLEAN>
Description Ignores limit violations pertaining to physical memory. Default is FALSE.
Example $ignmem true
$ignvmem
Format <BOOLEAN>
Description Ignores limit violations pertaining to virtual memory. Default is FALSE.
Example $ignvmem true
$ignwalltime
Format <BOOLEAN>
Description Ignore walltime (do not enable mom based walltime limit enforcement).
Example $ignwalltime true
$job_output_file_unmask
Format <STRING>
Description Uses the specified umask when creating job output and error files. Values can be specified in base 8, 10, or 16; leading 0 implies octal and leading 0x or 0X hexadecimal. A value of "userdefault" will use the user's default umask. This parameter is in version 2.3.0 and later.
Example $job_output_file_umask 027
$job_starter
Format <STRING>
Description Specifies the fully qualified pathname of the job starter. If this parameter is specified, instead of executing the job command and job arguments directly, the MOM will execute the job starter, passing the job command and job arguments to it as its arguments. The job starter can be used to launch jobs within a desired environment.
Example $job_starter /var/torque/mom_priv/job_starter.sh
> cat /var/torque/mom_priv/job_starter.sh
#!/bin/bash
export FOOHOME=/home/foo
ulimit -n 314
$*
$log_directory
Format <STRING>
Description Changes the log directory. Default is TORQUE_HOME/mom_logs/. TORQUE_HOME default is /var/spool/torque/ but can be changed in the ./configure script. The value is a string and should be the full path to the desired mom log directory.
Example $log_directory /opt/torque/mom_logs/
$log_file_suffix
Format <STRING>
Description Optional suffix to append to log file names. If %h is the suffix, pbs_mom appends the hostname for where the log files are stored if it knows it, otherwise it will append the hostname where the mom is running.
Example $log_file_suffix %h = 20100223.mybox
$log_file_suffix foo = 20100223.foo
$logevent
Format <STRING>
Description Specifies a bitmap for event types to log.
Example $logevent 255
$loglevel
Format <INTEGER>
Description Specifies the verbosity of logging with higher numbers specifying more verbose logging. Values may range between 0 and 7.
Example $loglevel 4
$log_file_max_size
Format <INTEGER>
Description Soft limit for log file size in kilobytes. Checked every 5 minutes. If the log file is found to be greater than or equal to log_file_max_size the current log file will be moved from X to X.1 and a new empty file will be opened.
Example $log_file_max_size = 100
$log_file_roll_depth
Format <INTEGER>
Description Specifies how many times a log fill will be rolled before it is deleted.
Example $log_file_roll_depth = 7
$log_keep_days
Format <INTEGER>
Description Specifies how many days to keep log files. pbs_mom deletes log files older than the specified number of days. If not specified, pbs_mom won't delete log files based on their age.
Example $log_keep_days 10
$max_conn_timeout_micro_sec
Format <INTEGER>
Description Specifies how long pbs_mom should wait for a connection to be made. Default value is 10000 (.1 sec).
Example $max_conn_timeout_micro_sec 30000

This sets the connection timeout on the MOM to .3 seconds..

$max_load
Format <FLOAT>
Description Maximum processor load.
Example $max_load 4.0
$memory_pressure_duration
Format <INTEGER>
Description (Applicable in version 3.0 and later.) Memory pressure duration sets a limit to the number of times the value of memory_pressure_threshold can be exceeded before a process is terminated. This can only be used with $memory_pressure_threshold.
Example $memory_pressure_duration 5
$memory_pressure_threshold
Format <INTEGER>
Description

(Applicable in version 3.0 and later.) The memory_pressure of a cpuset provides a simple per-cpuset running average of the rate that the processes in a cpuset are attempting to free up in-use memory on the nodes of the cpuset to satisfy additional memory requests. The memory_pressure_threshold is an integer number used to compare against the reclaim rate provided by the memory_pressure file. If the threshold is exceeded and memory_pressure_duration is set, then the process terminates after exceeding the threshold by the number of times set in memory_pressure_duration. If memory_pressure duration is not set, then a warning is logged and the process continues. Memory_pressure_threshold is only valid with memory_pressure enabled in the root cpuset.

To enable, log in as the super user and execute the command echo 1 >> /dev/cpuset/memory_pressure_enabled. See the cpuset man page for more information concerning memory pressure.

Example $memory_pressure_threshold 1000
$node_check_script
Format <STRING>
Description Specifies the fully qualified pathname of the health check script to run (see Compute node health check for more information).
Example $node_check_script /opt/batch_tools/nodecheck.pl
$node_check_interval
Format <STRING>
Description

Specifies the number of MOM intervals between subsequent executions of the specified health check. This value default to 1 indicating the check is run every mom interval (see Compute node health check for more information).

$node_check_interval has two special strings that can be set:

  • jobstart – makes the node health script run when a job is started.
  • jobend – makes the node health script run after each job has completed on a node.
Example $node_check_interval 5
$nodefile_suffix
Format <STRING>
Description Specifies the suffix to append to a host names to denote the data channel network adapter in a multihomed compute node.
Example

$nodefile_suffix i

with the suffix of "i" and the control channel adapter with the name node01, the data channel would have a hostname of node01i.

$nospool_dir_list
Format <STRING>
Description

If this is configured, the job's output is spooled in the working directory of the job or the specified output directory.

Specify the list in full paths, delimited by commas. If the job's working directory (or specified output directory) is in one of the paths in the list (or a subdirectory of one of the paths in the list), the job is spooled directly to the output location. $nospool_dir_list * is accepted.

The user that submits the job must have write permission on the folder where the job is written, and read permission on the folder where the file is spooled.

Alternatively, you can use the $spool_as_final_name parameter to force the job to spool directly to the final output.

This should generally be used only when the job can run on the same machine as where the output file goes, or if there is a shared filesystem. If not, this parameter can slow down the system or fail to create the output file.

Example $nospool_dir_list /home/mike/jobs/,/var/tmp/spool/
opsys
Format <STRING>
Description Specifies the operating system of the local machine. This information is used by the scheduler only.
Example opsys RHEL3
$pbsclient
Format <STRING>
Description Specifies machines which the mom daemon will trust to run resource manager commands via momctl. This may include machines where monitors, schedulers, or admins require the use of this command.
Example $pbsclient node01.teracluster.org
$pbsserver
Format <STRING>
Description

Specifies the machine running pbs_server.

This parameter replaces the deprecated parameter $clienthost.

Example $pbsserver node01.teracluster.org
$prologalarm
Format <INTEGER>
Description Specifies maximum duration (in seconds) which the mom will wait for the job prologue or job epilogue to complete. This parameter defaults to 300 seconds (5 minutes).
Example $prologalarm 60
$rcpcmd
Format <STRING>
Description Specifies the full path and optional additional command line args to use to perform remote copies.
Example mom_priv/config:
$rcpcmd /usr/local/bin/scp -i /etc/sshauth.dat
$remote_reconfig
Format <STRING>
Description Enables the ability to remotely reconfigure pbs_mom with a new config file. Default is disabled. This parameter accepts various forms of true, yes, and 1. For more information on how to reconfigure MOMs, see momctl -r.
Example $remote_reconfig true
$reduce_prolog_checks
Format <STRING>
Description If enabled, TORQUE will only check if the file is a regular file and is executable, instead of the normal checks listed on the prologue and epilogue page. Default is FALSE.
Example $reduce_prolog_checks true
$restricted
Format <STRING>
Description Specifies hosts which can be trusted to access mom services as non-root. By default, no hosts are trusted to access mom services as non-root.
Example $restricted *.teracluster.org
$rpp_throttle
Format <INTEGER>
Description This integer is in microseconds and causes a sleep after every RPP packet is sent. It is for systems that experience job failures because of incomplete data.
Example

$rpp_throttle 100

(will cause a 100 microsecond sleep)

size[fs=<FS>]
Format N/A
Description

Specifies that the available and configured disk space in the <FS> filesystem is to be reported to the pbs_server and scheduler.

To request disk space on a per job basis, specify the file resource as in qsub -l nodes=1,file=1000kb.

Unlike most mom config options, the size parameter is not preceded by a "$" character.

Example

size[fs=/localscratch]

The available and configured disk space in the /localscratch filesystem will be reported.

$source_login_batch
Format <STRING>
Description Specifies whether or not mom will source the /etc/profile, etc. type files for batch jobs. Parameter accepts various forms of true, false, yes, no, 1 and 0. Default is TRUE. This parameter is in version 2.3.1 and later.
Example

$source_login_batch False

MOM will bypass the sourcing of /etc/profile, etc. type files.

$source_login_interactive
Format <STRING>
Description Specifies whether or not mom will source the /etc/profile, etc. type files for interactive jobs. Parameter accepts various forms of true, false, yes, no, 1 and 0. Default is TRUE. This parameter is in version 2.3.1 and later.
Example

$source_login_interactive False

MOM will bypass the sourcing of /etc/profile, etc. type files.

$spool_as_final_name
Format <BOOLEAN>
Description This will spool the job under the final name that the output and error files will receive, instead of having an intermediate file and then copying the result to the final file when the job has completed. This allows users easier access to the file if they want to watch the jobs output as it runs.
Example $spool_as_final_name true
$status_update_time
Format <INTEGER>
Description Specifies the number of seconds between subsequent mom-to-server update reports. Default is 45 seconds.
Example

status_update_time:

$status_update_time 120

MOM will send server update reports every 120 seconds.

$thread_unlink_calls
Format <BOOLEAN>
Description Threads calls to unlink when deleting a job. Default is false. If it is set to TRUE, pbs_mom will use a thread to delete the job's files.
Example

thread_unlink_calls:

$thread_unlink_calls true

$timeout
Format <INTEGER>
Description Specifies the number of seconds before mom-to-mom messages will timeout if RPP is disabled. Default is 60 seconds.
Example

$timeout 120

MOM-to-MOM communication will allow up to 120 seconds before timing out.

$tmpdir
Format <STRING>
Description Specifies a directory to create job-specific scratch space (see Creating Per-Job Temporary Directories).
Example $tmpdir /localscratch
$usecp
Format <HOST>:<SRCDIR> <DSTDIR>
Description Specifies which directories should be staged (see NFS and other networked filesystems)
Example $usecp *.fte.com:/data /usr/local/data
$use_smt
Format <BOOLEAN>
Description

Indicates that the user would like to use SMT. If set, each logical core inside of a physical core will be used as a normal core for cpusets. This parameter is on by default.

If SMT is used, you will need to set the np attribute so that each logical processor is counted.

Example $use_smt false
varattr
Format <INTEGER> <STRING>
Description

Provides a way to keep track of dynamic attributes on nodes.

<INTEGER> is how many seconds should go by between calls to the script to update the dynamic values. If set to -1, the script is read only one time.

<STRING> is the script path. This script should check for whatever dynamic attributes are desired, and then output lines in this format:

name=value

Include any arguments after the script's full path. These features are visible in the output of pbsnodes -a

varattr=Matlab=7.1;Octave=1.0.

Example varattr 25 /usr/local/scripts/nodeProperties.pl arg1 arg2 arg3
$wallmult
Format <FLOAT>
Description

Sets a factor to adjust walltime usage by multiplying a default job time to a common reference system. It modifies real walltime on a per-MOM basis (MOM configuration parameters). The factor is used for walltime calculations and limits in the same way that cputmult is used for cpu time.

If set to 0.0, MOM level walltime enforcement is disabled.

Example $wallmult 2.2

Related topics