Skip to content
kaazoo edited this page Jul 28, 2015 · 1 revision

Command line

Start DrQueue master

drqueue master

Start DrQueue slave

drqueue slave

Create new job

  • Will render file Blender scene /usr/local/drqueue/tmp/icetest.blend from frame 1 to 10 with 1 frame each task.
drqueue job add -s 1 -e 10 -b 1 -r blender -f /usr/local/drqueue/tmp/icetest.blend -n blender_job_1

Create new job with limits

  • Will only run on computers with Mac OSX and with at least 2 GB of RAM and 2 CPU cores
drqueue job add -s 1 -e 10 -b 1 -r blender -f /usr/local/drqueue/tmp/icetest.blend --os="Mac OSX" --minram=2 --mincores=2 -n blender_job_2

Create new job for certain pool

  • Will only run on computers of pool ‘foobar’
drqueue job add -s 1 -e 10 -b 1 -r blender -f /usr/local/drqueue/tmp/icetest.blend -p foobar -n blender_job_1

List all existing jobs

drqueue job list

List all available computers

drqueue computer list

Add computer to pool

  • Will add computer with id ‘0’ to pool ‘foobar’
drqueue computer pool -p foobar -i 0

Rerun a job

  • Will run job ‘blender_test_1’ for another time
drqueue job rerun -n blender_test_1

Command line reference

Umbrella command

$ drqueue -h
usage: drqueue [-h] [-v] {job,task,computer,security,master,slave} ...

optional arguments:
  -h, --help            show this help message and exit
  -v, --verbose         verbose output

subcommands:
  {job,task,computer,security,master,slave}
    job                 job management
    task                task management
    computer            computer management
    security            toggle IPython security permissions
    master              start master daemon
    slave               start slave daemon

Master subcommand

$ drqueue master -h
usage: drqueue master [-h] [-v]

optional arguments:
  -h, --help     show this help message and exit
  -v, --verbose  verbose output

Slave subcommand

$ drqueue slave -h
usage: drqueue slave [-h] [-v] [-n]

optional arguments:
  -h, --help        show this help message and exit
  -v, --verbose     verbose output
  -n, --no-restart  don't restart engine process automatically

Job subcommand

$ drqueue job -h
usage: drqueue job [-h] [-v]
                   
                   {list,add,stop,kill,delete,continue,rerun,rerun_interrupted_tasks}
                   ...

optional arguments:
  -h, --help            show this help message and exit
  -v, --verbose         verbose output

subcommands:
  {list,add,stop,kill,delete,continue,rerun,rerun_interrupted_tasks}
    list                list one or more jobs
    add                 add a new job
    stop                stop running job
    kill                kill running job
    delete              delete existing job
    continue            continue stopped job
    rerun               rerun stopped job
    rerun_interrupted_tasks
                        rerun interrupted tasks

Task subcommand

$ drqueue task -h
usage: drqueue task [-h] [-v] {rerun,show} ...

optional arguments:
  -h, --help     show this help message and exit
  -v, --verbose  verbose output

subcommands:
  {rerun,show}
    rerun        rerun task with ID 'tid' of job identified by ID 'id' or NAME
                 'n'
    show         show task with ID 'tid'

Computer subcommand

$ drqueue computer -h
usage: drqueue computer [-h] [-v] {list,stop,pool} ...

optional arguments:
  -h, --help        show this help message and exit
  -v, --verbose     verbose output

subcommands:
  {list,stop,pool}
    list            list known computers
    stop            stop computer
    pool            set pool membership of computers

Security subcommand

$ drqueue security -h
usage: drqueue security [-h] [-v] {lock,unlock} ...

optional arguments:
  -h, --help     show this help message and exit
  -v, --verbose  verbose output

subcommands:
  {lock,unlock}
    lock         lock IPython security permissions
    unlock       unlock IPython security permissions