Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
S
Slurm
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Package Registry
Model registry
Operate
Environments
Terraform modules
Monitor
Incidents
Service Desk
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Terms and privacy
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
tud-zih-energy
Slurm
Commits
0e9c91cb
Commit
0e9c91cb
authored
14 years ago
by
Don Lipari
Browse files
Options
Downloads
Patches
Plain Diff
Typo fixes to sacctmgr.1
parent
97ec1c6f
No related branches found
Branches containing commit
No related tags found
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
doc/man/man1/sacctmgr.1
+56
-55
56 additions, 55 deletions
doc/man/man1/sacctmgr.1
with
56 additions
and
55 deletions
doc/man/man1/sacctmgr.1
+
56
−
55
View file @
0e9c91cb
.TH SACCTMGR "1" "April 2009" "sacctmgr 2.0" "Slurm components"
.TH SACCTMGR "1" "April 2009" "sacctmgr 2.0" "Slurm components"
.SH "NAME"
.SH "NAME"
sacctmgr \- Used to view and modify Slurm account information.
sacctmgr \- Used to view and modify Slurm account information.
...
@@ -53,7 +53,7 @@ This is equivalent to the \fBquiet\fR command.
...
@@ -53,7 +53,7 @@ This is equivalent to the \fBquiet\fR command.
.TP
.TP
\fB\-r\fR, \fB\-\-readonly\fR
\fB\-r\fR, \fB\-\-readonly\fR
Makes it so the running sacctmgr can
not modify accounting information.
Makes it so the running sacctmgr cannot modify accounting information.
The \fBreadonly\fR option is for use within interactive mode.
The \fBreadonly\fR option is for use within interactive mode.
.TP
.TP
...
@@ -213,12 +213,13 @@ Workload Characterization Key. An arbitrary string for grouping orthogonal
...
@@ -213,12 +213,13 @@ Workload Characterization Key. An arbitrary string for grouping orthogonal
.TP
.TP
\fIDefaultQOS\fP=<default qos>
\fIDefaultQOS\fP=<default qos>
The default QOS this association and it
'
s child
e
rn should have.
The default QOS this association and its childr
e
n should have.
This is overridden if set directly on a user.
This is overridden if set directly on a user.
To clear a previously set value use the modify command with a new value of \-1.
To clear a previously set value use the modify command with a new value of \-1.
.P
NOTE: Because this could be inherited from a parent an association can
NOTE: Because this could be inherited from a parent an association can
easily end up with a default qos that it does not have access to.
easily end up with a default qos that it does not have access to.
There is no current checking to make sure this does
n'
t happen. When
There is no current checking to make sure this does
no
t happen. When
read in from the slurmctld the default qos is checked against and if
read in from the slurmctld the default qos is checked against and if
the default qos isn't in the list of valid QOS for that association
the default qos isn't in the list of valid QOS for that association
and the association only has access to 1 QOS that will become the
and the association only has access to 1 QOS that will become the
...
@@ -236,23 +237,27 @@ aggregate for this association and all association which are children
...
@@ -236,23 +237,27 @@ aggregate for this association and all association which are children
of this association.
of this association.
To clear a previously set value use the modify command with a new
To clear a previously set value use the modify command with a new
value of \-1.
value of \-1.
.P
NOTE: This limit is not enforced if set on the root
NOTE: This limit is not enforced if set on the root
association of a cluster. So even though it may appear in sacctmgr
association of a cluster. So even though it may appear in sacctmgr
output it will not be enforced.
output, it will not be enforced.
NOTE: This limit only applys when using the Priority Multifactor
.P
ALSO NOTE: This limit only applies when using the Priority Multifactor
plugin. The time is decayed using the value of PriorityDecayHalfLife
plugin. The time is decayed using the value of PriorityDecayHalfLife
or PriorityUsageResetPeriod as set in the slurm.conf. When this limit
or PriorityUsageResetPeriod as set in the slurm.conf. When this limit
is reached all associated jobs running will be killed and all future
jobs
is reached all associated jobs running will be killed and all future
submitted with associations in the group will be delayed until
they
jobs
submitted with associations in the group will be delayed until
are able to run inside the limit.
they
are able to run inside the limit.
.TP
.TP
\fIGrpCPUs\fP=<max cpus>
\fIGrpCPUs\fP=<max cpus>
Maximum number of CPUs running jobs are able to be allocated in aggregate for
Maximum number of CPUs running jobs are able to be allocated in aggregate for
this association and all association which are children of this association.
this association and all association which are children of this association.
To clear a previously set value use the modify command with a new
To clear a previously set value use the modify command with a new
value of \-1. (NOTE: This limit only applys fully when using the Select
value of \-1.
Consumable Resouce plugin.)
.P
NOTE: This limit only applies fully when using the Select Consumable
Resource plugin.
.TP
.TP
\fIGrpJobs\fP=<max jobs>
\fIGrpJobs\fP=<max jobs>
...
@@ -278,15 +283,17 @@ To clear a previously set value use the modify command with a new value of \-1.
...
@@ -278,15 +283,17 @@ To clear a previously set value use the modify command with a new value of \-1.
Maximum wall clock time running jobs are able to be allocated in aggregate for
Maximum wall clock time running jobs are able to be allocated in aggregate for
this association and all association which are children of this association.
this association and all association which are children of this association.
To clear a previously set value use the modify command with a new value of \-1.
To clear a previously set value use the modify command with a new value of \-1.
NOTE: This limit is not enforced if set on the root
.P
association of a cluster. So even though it may appear in sacctmgr
NOTE: This limit is not enforced if set on the root association of a
output it will not be enforced.
cluster. So even though it may appear in sacctmgr output, it will not
NOTE: This limit only applys when using the Priority Multifactor
be enforced.
.P
ALSO NOTE: This limit only applies when using the Priority Multifactor
plugin. The time is decayed using the value of PriorityDecayHalfLife
plugin. The time is decayed using the value of PriorityDecayHalfLife
or PriorityUsageResetPeriod as set in the slurm.conf. When this limit
or PriorityUsageResetPeriod as set in the slurm.conf. When this limit
is reached all associated jobs running will be killed and all future
jobs
is reached all associated jobs running will be killed and all future
submitted with associations in the group will be delayed until
they
jobs
submitted with associations in the group will be delayed until
are able to run inside the limit.
they
are able to run inside the limit.
.TP
.TP
\fIMaxCPUMins\fP=<max cpu minutes>
\fIMaxCPUMins\fP=<max cpu minutes>
...
@@ -302,8 +309,10 @@ Maximum number of CPUs each job is able to use in this association.
...
@@ -302,8 +309,10 @@ Maximum number of CPUs each job is able to use in this association.
This is overridden if set directly on a user.
This is overridden if set directly on a user.
Default is the cluster's limit.
Default is the cluster's limit.
To clear a previously set value use the modify command with a new
To clear a previously set value use the modify command with a new
value of \-1. (NOTE: This limit only applys fully when using the Select
value of \-1.
Consumable Resouce plugin.)
.P
NOTE: This limit only applies fully when using the Select Consumable
Resource plugin.
.TP
.TP
\fIMaxJobs\fP=<max jobs>
\fIMaxJobs\fP=<max jobs>
...
@@ -337,15 +346,17 @@ Default is the cluster's limit.
...
@@ -337,15 +346,17 @@ Default is the cluster's limit.
<days>\-<hr>:<min>:<sec> or <days>\-<hr>.
<days>\-<hr>:<min>:<sec> or <days>\-<hr>.
The value is recorded in minutes with rounding as needed.
The value is recorded in minutes with rounding as needed.
To clear a previously set value use the modify command with a new value of \-1.
To clear a previously set value use the modify command with a new value of \-1.
NOTE: Changing this value will have no effect on any running or pending job.
.P
NOTE: Changing this value will have no effect on any running or
pending job.
.TP
.TP
\fIQosLevel\fP<operator><comma separated list of qos names>
\fIQosLevel\fP<operator><comma separated list of qos names>
Specify the default Quality of Service's that jobs are able to run at
Specify the default Quality of Service's that jobs are able to run at
for this association. To get a list of valid QOS's use 'sacctmgr list qos'.
for this association. To get a list of valid QOS's use 'sacctmgr list qos'.
This value will override it
'
s parents value and push down to it
'
s
This value will override its parents value and push down to its
children as the new default. Setting a QosLevel to '' (two single
children as the new default. Setting a QosLevel to '' (two single
quotes with nothing between them) restores it
'
s default setting. You
quotes with nothing between them) restores its default setting. You
can also use the operator += and \-= to add or remove certain QOS's
can also use the operator += and \-= to add or remove certain QOS's
from a QOS list.
from a QOS list.
...
@@ -404,8 +415,7 @@ Display all coordinators for this account.
...
@@ -404,8 +415,7 @@ Display all coordinators for this account.
.TP
.TP
\fIWithDeleted\fP
\fIWithDeleted\fP
Display information with previously deleted data.
Display information with previously deleted data.
.P
.SH ""
NOTE: If using the WithAssoc option you can also query against
NOTE: If using the WithAssoc option you can also query against
association specific information to view only certain associations
association specific information to view only certain associations
this account may have. These extra options can be found in the
this account may have. These extra options can be found in the
...
@@ -431,8 +441,7 @@ Organization to which the account belongs.
...
@@ -431,8 +441,7 @@ Organization to which the account belongs.
\fICoordinators\fP
\fICoordinators\fP
List of users that are a coordinator of the account. (Only filled in
List of users that are a coordinator of the account. (Only filled in
when using the WithCoordinator option.)
when using the WithCoordinator option.)
.P
.SH ""
NOTE: If using the WithAssoc option you can also view the information
NOTE: If using the WithAssoc option you can also view the information
about the various associations the account may have on all the
about the various associations the account may have on all the
clusters in the system. The Association format fields are described
clusters in the system. The Association format fields are described
...
@@ -457,8 +466,7 @@ List the associations of the user(s).
...
@@ -457,8 +466,7 @@ List the associations of the user(s).
.TP
.TP
\fIPartition\fP=<comma separated list of partition names>
\fIPartition\fP=<comma separated list of partition names>
List the associations of the partition(s).
List the associations of the partition(s).
.P
.SH ""
NOTE: You can also use the general specifications list above in the
NOTE: You can also use the general specifications list above in the
\fIGENERAL SPECIFICATIONS FOR ASSOCIATION BASED ENTITIES\fP section.
\fIGENERAL SPECIFICATIONS FOR ASSOCIATION BASED ENTITIES\fP section.
...
@@ -557,7 +565,7 @@ The id of the association.
...
@@ -557,7 +565,7 @@ The id of the association.
Associations are kept in a hierarchy this is the left most
Associations are kept in a hierarchy this is the left most
spot in the hierarchy. When used with the RGT variable all
spot in the hierarchy. When used with the RGT variable all
associations with a LFT inside this LFT and before the RGT are
associations with a LFT inside this LFT and before the RGT are
child
e
rn of this association.
childr
e
n of this association.
.TP
.TP
\fIMaxCPUMins\fP
\fIMaxCPUMins\fP
...
@@ -608,7 +616,7 @@ The numeric values of valid QOS\' for this association.
...
@@ -608,7 +616,7 @@ The numeric values of valid QOS\' for this association.
Associations are kept in a hierarchy this is the right most
Associations are kept in a hierarchy this is the right most
spot in the hierarchy. When used with the LFT variable all
spot in the hierarchy. When used with the LFT variable all
associations with a LFT inside this RGT and after the LFT are
associations with a LFT inside this RGT and after the LFT are
child
e
rn of this association.
childr
e
n of this association.
.TP
.TP
\fIUser\fP
\fIUser\fP
...
@@ -642,8 +650,7 @@ Comma separated list of numeric RPC values.
...
@@ -642,8 +650,7 @@ Comma separated list of numeric RPC values.
\fIWOLimits\fP
\fIWOLimits\fP
Display information without limit information. This is for a smaller
Display information without limit information. This is for a smaller
default format of Cluster,ControlHost,ControlPort,RPC
default format of Cluster,ControlHost,ControlPort,RPC
.P
.SH ""
NOTE: You can also use the general specifications list above in the
NOTE: You can also use the general specifications list above in the
\fIGENERAL SPECIFICATIONS FOR ASSOCIATION BASED ENTITIES\fP section.
\fIGENERAL SPECIFICATIONS FOR ASSOCIATION BASED ENTITIES\fP section.
...
@@ -693,8 +700,7 @@ The numeric value of the select plugin the cluster is using.
...
@@ -693,8 +700,7 @@ The numeric value of the select plugin the cluster is using.
\fIRPC\fP
\fIRPC\fP
When a slurmctld registers with the database the rpc version the controller
When a slurmctld registers with the database the rpc version the controller
is running is placed here.
is running is placed here.
.P
.SH ""
NOTE: You can also view the information about the root association for
NOTE: You can also view the information about the root association for
the cluster. The Association format fields are described
the cluster. The Association format fields are described
in the \fILIST/SHOW ASSOCIATION FORMAT OPTIONS\fP section.
in the \fILIST/SHOW ASSOCIATION FORMAT OPTIONS\fP section.
...
@@ -708,8 +714,7 @@ Account name to add this user as a coordinator to.
...
@@ -708,8 +714,7 @@ Account name to add this user as a coordinator to.
.TP
.TP
\fINames\fP=<comma separated list of user names>
\fINames\fP=<comma separated list of user names>
Names of coordinators.
Names of coordinators.
.P
.SH ""
NOTE: To list coordinators use the WithCoordinator options with list
NOTE: To list coordinators use the WithCoordinator options with list
account or list user.
account or list user.
.RE
.RE
...
@@ -781,7 +786,7 @@ set automatically to Node.
...
@@ -781,7 +786,7 @@ set automatically to Node.
.TP
.TP
\fIUser\fP=<comma separated list of users>
\fIUser\fP=<comma separated list of users>
Query against users who set the event. If this is set, the event type is
Query against users who set the event. If this is set, the event type is
set automatically to Node since only user slurm can p
r
eform a cluster event.
set automatically to Node since only user slurm can pe
r
form a cluster event.
.RE
.RE
...
@@ -817,7 +822,7 @@ Numeric value of the name of the event.
...
@@ -817,7 +822,7 @@ Numeric value of the name of the event.
.TP
.TP
\fINodeName\fP
\fINodeName\fP
The node
e
ffected by the event. In a cluster event, this is blank.
The node
a
ffected by the event. In a cluster event, this is blank.
.TP
.TP
\fIReason\fP
\fIReason\fP
...
@@ -943,7 +948,7 @@ Maximum number of CPU minutes running jobs are able to be allocated in
...
@@ -943,7 +948,7 @@ Maximum number of CPU minutes running jobs are able to be allocated in
aggregate for this QOS.
aggregate for this QOS.
To clear a previously set value use the modify command with a new
To clear a previously set value use the modify command with a new
value of \-1.
value of \-1.
NOTE: This limit only appl
y
s when using the Priority Multifactor
NOTE: This limit only appl
ie
s when using the Priority Multifactor
plugin. The time is decayed using the value of PriorityDecayHalfLife
plugin. The time is decayed using the value of PriorityDecayHalfLife
or PriorityUsageResetPeriod as set in the slurm.conf. When this limit
or PriorityUsageResetPeriod as set in the slurm.conf. When this limit
is reached all associated jobs running will be killed and all future jobs
is reached all associated jobs running will be killed and all future jobs
...
@@ -981,7 +986,7 @@ To clear a previously set value use the modify command with a new value of \-1.
...
@@ -981,7 +986,7 @@ To clear a previously set value use the modify command with a new value of \-1.
Maximum wall clock time running jobs are able to be allocated in aggregate for
Maximum wall clock time running jobs are able to be allocated in aggregate for
this QOS.
this QOS.
To clear a previously set value use the modify command with a new value of \-1.
To clear a previously set value use the modify command with a new value of \-1.
NOTE: This limit only appl
y
s when using the Priority Multifactor
NOTE: This limit only appl
ie
s when using the Priority Multifactor
plugin. The time is decayed using the value of PriorityDecayHalfLife
plugin. The time is decayed using the value of PriorityDecayHalfLife
or PriorityUsageResetPeriod as set in the slurm.conf. When this limit
or PriorityUsageResetPeriod as set in the slurm.conf. When this limit
is reached all associated jobs running will be killed and all future jobs
is reached all associated jobs running will be killed and all future jobs
...
@@ -1033,7 +1038,7 @@ Name of the QOS. Needed for creation.
...
@@ -1033,7 +1038,7 @@ Name of the QOS. Needed for creation.
\fIPreempt\fP
\fIPreempt\fP
Other QOS\' this QOS can preempt.
Other QOS\' this QOS can preempt.
Setting a Preempt to '' (two single
Setting a Preempt to '' (two single
quotes with nothing between them) restores it
'
s default setting. You
quotes with nothing between them) restores its default setting. You
can also use the operator += and \-= to add or remove certain QOS's
can also use the operator += and \-= to add or remove certain QOS's
from a QOS list.
from a QOS list.
...
@@ -1108,10 +1113,9 @@ Get information about which associations were affected by the transactions.
...
@@ -1108,10 +1113,9 @@ Get information about which associations were affected by the transactions.
.TP
.TP
\fIWhere\fP
\fIWhere\fP
.P
.SH ""
NOTE: If using the WithAssoc option you can also view the information
NOTE: If using the WithAssoc option you can also view the information
about the various associations the transaction
e
ffected. The
about the various associations the transaction
a
ffected. The
Association format fields are described
Association format fields are described
in the \fILIST/SHOW ASSOCIATION FORMAT OPTIONS\fP section.
in the \fILIST/SHOW ASSOCIATION FORMAT OPTIONS\fP section.
.RE
.RE
...
@@ -1168,8 +1172,7 @@ Display all accounts a user is coordinator for.
...
@@ -1168,8 +1172,7 @@ Display all accounts a user is coordinator for.
.TP
.TP
\fIWithDeleted\fP
\fIWithDeleted\fP
Display information with previously deleted data.
Display information with previously deleted data.
.P
.SH ""
NOTE: If using the WithAssoc option you can also query against
NOTE: If using the WithAssoc option you can also query against
association specific information to view only certain associations
association specific information to view only certain associations
this account may have. These extra options can be found in the
this account may have. These extra options can be found in the
...
@@ -1186,7 +1189,7 @@ Admin level of user.
...
@@ -1186,7 +1189,7 @@ Admin level of user.
.TP
.TP
\fIDefaultAccount\fP
\fIDefaultAccount\fP
An t
he users default account.
T
he user
'
s default account.
.TP
.TP
\fICoordinators\fP
\fICoordinators\fP
...
@@ -1196,8 +1199,7 @@ when using the WithCoordinator option.)
...
@@ -1196,8 +1199,7 @@ when using the WithCoordinator option.)
.TP
.TP
\fIUser\fP
\fIUser\fP
The name of a user.
The name of a user.
.P
.SH ""
NOTE: If using the WithAssoc option you can also view the information
NOTE: If using the WithAssoc option you can also view the information
about the various associations the user may have on all the
about the various associations the user may have on all the
clusters in the system. The Association format fields are described
clusters in the system. The Association format fields are described
...
@@ -1217,8 +1219,7 @@ Specific cluster for the WCKey.
...
@@ -1217,8 +1219,7 @@ Specific cluster for the WCKey.
.TP
.TP
\fIUser\fP
\fIUser\fP
The name of a user for the WCKey.
The name of a user for the WCKey.
.P
.SH ""
NOTE: If using the WithAssoc option you can also view the information
NOTE: If using the WithAssoc option you can also view the information
about the various associations the user may have on all the
about the various associations the user may have on all the
clusters in the system. The Association format fields are described
clusters in the system. The Association format fields are described
...
@@ -1264,8 +1265,8 @@ in the file.
...
@@ -1264,8 +1265,8 @@ in the file.
Quick explanation how the file works.
Quick explanation how the file works.
Since the associations in the system follow a hierarchy so does the
Since the associations in the system follow a hierarchy
,
so does the
file. Any
thing that is a parent needs to be defined before any
file. Anything that is a parent needs to be defined before any
children. The only exception is the understood 'root' account. This
children. The only exception is the understood 'root' account. This
is always a default for any cluster and does not need to be defined.
is always a default for any cluster and does not need to be defined.
...
@@ -1553,7 +1554,7 @@ cautiously since this is writing your sql into the database.
...
@@ -1553,7 +1554,7 @@ cautiously since this is writing your sql into the database.
.br
.br
When modifying an object placing the key words 'set' and the
When modifying an object placing the key words 'set' and the
optional 'where' is critical to perform correctly below are examples to
optional 'where' is critical to perform correctly below are examples to
produce correct results. As a rule of thumb any
thing you put in front
produce correct results. As a rule of thumb anything you put in front
of the set will be used as a quantifier. If you want to put a
of the set will be used as a quantifier. If you want to put a
quantifier after the key word 'set' you should use the key
quantifier after the key word 'set' you should use the key
word 'where'.
word 'where'.
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment