Add a user share to a fairshare queue

About this task

You can add a member and share to a fairshare queue in lsb.queues using live reconfiguration.

Run bconf addmember queue=queue_name "FAIRSHARE=USER_SHARES[[user_name, share]]"

For example, for the existing lsb.queues configuration:

...
Begin queue
QUEUE_NAME=my_queue
FAIRSHARE=USER_SHARES[[tina, 10] [default, 3]]
End Queue
...

Add a user group and share:

bconf addmember queue=my_queue "FAIRSHARE=USER_SHARES[[ug1, 10]]"
bconf: Request for queue <my_queue> accepted

Once accepted by bconf, the new share definition appears in bqueue -l output:

bqueues -l my_queue
...
USER_SHARES: [tina, 10] [ug1, 10] [default, 3]
...

Important:

If USER_SHARES=[] for the fairshare queue and a share value is added to USER_SHARES, the value [default,1] is also added automatically.

For example, for the lsb.queues configuration:

...
Begin queue
QUEUE_NAME=queue16
FAIRSHARE=USER_SHARES[]
End Queue
...

Add a share value:

bconf addmember queue=queue16 "FAIRSHARE=USER_SHARES[[user3, 10]]"
bconf: Request for queue <queue16> accepted

Once accepted by bconf, the new share definition appears in bqueue -l output:

bqueues -l queue16
...
USER_SHARES: [user3, 10] [default, 1]
...