[ Description ] [ Usage  ] [ Options ] [ Permission listing code table ] [ Notes ] [ Examples ] [ See also ]

    Description

    Modifies the permissions for an individual user.

    To modify the default permissions for all users not explicitly granted privileges with qbusers, you must modify supervisor_default_security in the Supervisor's qb.conf file, and then restart the Supervisor service.

    Usage 

    qbusers options [user…]

    Options

    Switch

    Description

    --add

    add permission

    --delete

    delete permission

    --set

    set to only permission

    --group [group]

    modify group permissions

    --drop

    drop user from Qube!

    --submitjob

    permit submit job

    --submitcallback

    permit submit callback

    --submitglobalcallback

    permit submit global callback

    --kill

    permit kill job

    --remove

    permit remove job

    --modify

    permit modify job

    --preempt

    permit preempt job

    --block

    permit block job

    --interrupt

    permit interrupt job

    --unblock

    permit unblock job

    --suspend

    permit suspend job

    --resume

    permit resume job

    --bump

    permit bump job

    --migrate

    permit migrate job

    --retry

    permit retry job

    --requeue

    permit requeue job

    --shove

    permit shove job

    --fail

    permit fail job

    --retire

    permit retire job

    --all

    permit all privileges

    --admin

    permit admin privilege

    --sudo

    permit sudo admin privilege

    --impersonate

    permit impersonation

    --lock

    permit lock/unlock of workers

    --list

    list all users (see codeTable)

    --member

    list all users w/groups

    --help

    help for qbusers

    Permission listing code table

    Code

    Explanation

     

     Administrative

    a

    admin - user has admin permissions

    s

    sudo admin - user has sudo admin permissions

    i

    impersonate user - user may submit job as any user

    l

    lock host - user may lock/unlock workers

     

    Submission

    j

    submit job

    c

    submit callback

    g

    submit global callback

     Job Control

    k

    kill job

    r

    remove job

    m

    modify job

    p

    preempt job

    b

    block job

    u

    unblock job

    i

    interrupt job

    c

    complete job

    s

    suspend job

    e

    resume job

    y

    retry job

    q

    requeue job

    gmigrate job
    pbump job (top/bottom)
    vshove job
    ffail job
    tretire job
    nreset job 

    Notes

     

    Examples

    Give the user 'monkey' the ability to submit jobs:

    % qbusers --add --submitjob monkey

    Add users george, ira, and oscar to the plfx group

    qbusers -add --group "plfx" george ira oscar

     

    List all users and their permissions

    % qbusers --list
    total 4
    ---l jc- krmpbuicseyqg-vft      [default]
    asil jcg krmpbuicseyqgpvft      Administrator
    asil jcg krmpbuicseyqgpvft      qube
    asil jcg krmpbuicseyqgpvft      root
    asil jcg krmpbuicseyqgpvft      system

    (Any user not explicitly listed here falls into the [default] class.)

     

    Next, we’ll add two new users, john and sue, and give them full user permissions.

    % qbusers --add --all john sue

    modified permissions

    % qbusers --list

    total 6
    ---l jc- krmpbuicseyqg-vft      [default]
    asil jcg krmpbuicseyqgpvft      Administrator
    ---- jcg krmpbuicseyqgpvft      john
    asil jcg krmpbuicseyqgpvft      qube
    asil jcg krmpbuicseyqgpvft      root
    asil jcg krmpbuicseyqgpvft      system
    ---- jcg krmpbuicseyqgpvft      sue

     

    Finally, we’ll delete two users, john and system.

    % qbusers --drop john system

    modified permissions

    % qbusers --list

    total 4
    ---l jc- krmpbuicseyqg-vft      [default]
    asil jcg krmpbuicseyqgpvft      Administrator
    asil jcg krmpbuicseyqgpvft      qube
    asil jcg krmpbuicseyqgpvft      root
    ---- jcg krmpbuicseyqgpvft      sue

    See also

    Permissions

     

    • No labels