flux-account-edit-user(1)

SYNOPSIS

flux account edit-user USERNAME [--bank=BANK] [OPTIONS]

DESCRIPTION

flux account edit-user allows for the modifications of certain fields for a given association. Passing the -B/--bank option will specify a specific row for the update to be applied. If left out, the update will be applied across all of the rows in association_table where username is found.

The list of modifiable fields for an association are as follows:

-i/--userid

The userid of the association.

--default-bank

The default bank that the user belongs to.

--shares

The amount of available resources their organization considers they should be entitled to use relative to other competing users.

--fairshare

The ratio between the amount of resources an association is allocated versus the amount actually consumed.

--max-running-jobs

The max number of running jobs the association can have at any given time.

--max-active-jobs

The max number of both pending and running jobs the association can have at any given time.

-N/--max-nodes

The max number of nodes an association can have across all of their running jobs.

-c/--max-cores

The max number of cores an association can have across all of their running jobs.

-q/--queues

A comma-separated list of all of the queues an association can run jobs under.

-P/--projects

A comma-separated list of all of the projects an association can run jobs under.

--default-project

The default project the association will submit jobs under when they do not specify a project.

--max-sched-jobs

The max number of jobs in SCHED state an association can have at any given time.

--add-queue

Add a single queue to the association's list of permissible queues.

--delete-queue

Remove a single queue from the association's list of permissible queues.

All of the attributes able to be modified can be reset to their default value by passing -1 as the value for the field. Multiple fields can be edited at the same time by passing them on the command line.

The max_nodes and max_cores fields can also be reset to their maximum value (2147483647) by passing "unlimited".

EXAMPLES

Multiple attributes for an association can be edited at the same time:

$ flux account edit-user moose --max-active-jobs=100 --queues="special,expedite"

An association's attributes can be reset to their default value by passing -1:

$ flux account edit-user moose --max-active-jobs=-1