table of contents
other versions
pbs_server_attributes(7B) | PBS | pbs_server_attributes(7B) |
NAME¶
pbs_server_attributes - pbs server attributesDESCRIPTION¶
Server attributes can be read by any client; privilege is not required. Most server attributes are alterable by a privileged client, run by a user with administrator or operator privilege. Certain attributes require the user to have full administrator privilege. The following is a list of the server attributes.This is a default value for the queue
attribute of the same name. Format: boolean, "TRUE",
"True", "true", "Y", "y",
"1", "FALSE", "False", "false",
"N", "n", "0"; default value: false = disabled.
Attribute which when true directs the server to use the acl_hosts
access control lists. Requires full manager privilege to set or alter. Format:
boolean, "TRUE", "True", "true", "Y",
"y", "1", "FALSE", "False",
"false", "N", "n", "0"; default value:
false = disabled. List of hosts which may request services from this server.
This list contains the network name of the hosts. Local requests, i.e. from
the server's host itself, are aways accepted even if the host is not included
in the list. See section 10.1, Authorization, in the PBS External Reference
Specification. Requires full manager privilege to set or alter. Format:
"[+|-]hostname.domain[,...]"; default value: all hosts. This is a
default value for the queue attribute of the same name. Format: boolean,
"TRUE", "True", "true", "Y",
"y", "1", "FALSE", "False",
"false", "N", "n", "0"; default value:
false = disabled. Attribute which when true directs the server to use the
server level acl_users access list. Requires full manager privilege to
set or alter. Format: boolean (see acl_group_enable); default value: disabled.
List of users allowed or denied the ability to make any requests of this
server. See section 10.1, Authorization, in the PBS External Reference
Specification. If acl_user_enable is set to true, only users listed in
acl_users may submit to or execute jobs in the queue. Requires full manager
privilege to set or alter. Format: "[+|-]user[@host][,...]"; default
value: all users allowed. List of super users who may submit to and execute
jobs at this server. If the job execution id would be zero (0), then the job
owner, root@host, must be listed in this access control list or the job is
rejected. Format: "[+|-]user[@host][,...]"; default value: no root
jobs allowed. Allow job submissions from compute nodes regardless of
ruserok(). Requires full manager privilege to set or alter. Format: boolean;
default value: disabled. Automatically configure a node's np value based on
the ncpus value from the status update. Requires full manager privilege to set
or alter. Format: boolean; default value: disabled. A text string which may be
set by the scheduler or other privileged client to provide information to the
batch system users. Format: any string; default value: none. A node
specification to use if there is no other supplied specification. This
attribute is only used by servers where a nodes file exist in the
server_priv directory providing a list of nodes to the server. If the nodes
file does not exist, this attribute is not set by default and is ignored if
set. The default value allows for jobs to share a single node. Format: a node
specification string; default value: 1#shared. The queue which is the target
queue when a request does not specify a queue name. Format: a queue name;
default value: none, must be set to an existing queue. Set a node's state to
"down" if MOM reports a message beginning with the string
"ERROR". This might interfere with moab's node error handling. See
the HEALTH CHECK section in pbs_mom(8B). This is an EXPERIMENTAL feature and
may be removed in the future. Format: boolean; default value: false. Add
additional string-type job resources. They have no effect within TORQUE and
are only advisible to the scheduler. They can not be used for
resources_default/min/max. Format: list; default value: none. Enables the
"job deletion nanny" feature. All job cancels will create a
repeating task that will resend KILL signals if the initial job cancel failed.
Further job cancels will be rejected with the message "job cancel in
progress." This is useful for temporary failures with a job's execution
node during a job delete request. It is possible that the job nanny might
interfere with job restarts, migrations, and checkpointing. Format: boolean;
default value: false. Specifies the pbs_server to pbs_mom TCP socket timeout
in seconds that is used when the pbs_server sends a job start to the pbs_mom.
It is useful when the mom has extra overhead involved in starting jobs. If not
specified then the tcp_timeout value is used. Moderates how often job stat
requests will be issued from pbs_server to the MOM daemons. If poll_jobs is
unset or false, then all jobs that haven't been updated in job_stat_rate
seconds will trigger a stat request. If poll_jobs is true, then all jobs will
be updated every job_stat_rate.
(see poll_jobs) On active clusters, 60 or 120 might be reasonable. Default value: 45 seconds (PBS_RESTAT_JOB in server_limits.h) Minimum value: 4 seconds (PBS_JOBSTAT_MIN in server_limits.h) Number of seconds to retain completed jobs in the C state. This is overridden by the execution queue attribute of the same name. Format: integer; default value: 0. The amount of the time delay between the sending of SIGTERM and SIGKILL when a qdel command is issued against a running job. This is overridden by the execution queue attribute of the same name. Format: integer seconds; default value: 2 seconds. A bit string which specifies the type of events which are logged, see the section on Event Logging in chapter 3 of the ERS. Format: integer; default value: 511, all events. If this is set to a value > 0 then pbs_server will roll the current log file to logfile.1 when its size is greater than or equal to the value of log_file_max_size. This value is interpreted as kilobytes. If this is set to a value >=1 and log_file_max_size is set then pbs_server will continue rolling the log files to logfile.log_file_roll_depth. Controls the verbosity of server logs. This value ranges from 0 to 7 with 7 representing maximum verbosity. Format: integer; default value: 0, minimum verbosity. Override the default format for the body of outgoing mail messages. A number of printf-like format specifiers and escape sequences can be used:
The following attributes are read-only, they are maintained by the server and
cannot be changed by a client.
(see poll_jobs) On active clusters, 60 or 120 might be reasonable. Default value: 45 seconds (PBS_RESTAT_JOB in server_limits.h) Minimum value: 4 seconds (PBS_JOBSTAT_MIN in server_limits.h) Number of seconds to retain completed jobs in the C state. This is overridden by the execution queue attribute of the same name. Format: integer; default value: 0. The amount of the time delay between the sending of SIGTERM and SIGKILL when a qdel command is issued against a running job. This is overridden by the execution queue attribute of the same name. Format: integer seconds; default value: 2 seconds. A bit string which specifies the type of events which are logged, see the section on Event Logging in chapter 3 of the ERS. Format: integer; default value: 511, all events. If this is set to a value > 0 then pbs_server will roll the current log file to logfile.1 when its size is greater than or equal to the value of log_file_max_size. This value is interpreted as kilobytes. If this is set to a value >=1 and log_file_max_size is set then pbs_server will continue rolling the log files to logfile.log_file_roll_depth. Controls the verbosity of server logs. This value ranges from 0 to 7 with 7 representing maximum verbosity. Format: integer; default value: 0, minimum verbosity. Override the default format for the body of outgoing mail messages. A number of printf-like format specifiers and escape sequences can be used:
- \n
- new line
- \t
- horizontal tab
- \\
- backslash
- \'
- single quote
- \"
- double quote
- %d
- details concerning the message
- %h
- PBS host name
- %i
- PBS job identifier
- %j
- PBS job name
- %m
- long reason for message
- %r
- short reason for message
- %%
- a single %
- \n
- new line
- \t
- horizontal tab
- \\
- backslash
- \'
- single quote
- \"
- double quote
- %d
- details concerning the message
- %h
- PBS host name
- %i
- PBS job identifier
- %j
- PBS job name
- %m
- long reason for message
- %r
- short reason for message
- %%
- a single %
The total amount of certain types of resources
allocated to running jobs. The current state of the server:
- Active
- The server is running and will invoke the job scheduler as required to schedule jobs for execution.
- Idle
- The server is running but will not invoke the job scheduler.
- Scheduling
- The server is running and there is an outstanding request to the job scheduler.
- Terminating
- The server is terminating. No additional jobs will be scheduled.
- Terminating, Delayed
- The server is terminating in delayed mode. The server will not run any new jobs and will shutdown when the last currently executing job completes.
- The total number of jobs managed by the server currently in each state. The total number of jobs currently managed by the server. The release version number of the server.
SEE ALSO¶
the PBS ERS, qmgr(1B), pbs_resources(7B)Local |