Provided by: ganeti_2.9.3-1_all bug


       gnt-job - Job commands


       gnt-job {command} [arguments...]


       The gnt-job is used for examining and manipulating the job queue.


       archive {id...}

       This  command  can  be  used  to  archive  job by their IDs.  Only jobs that have finished
       execution (i.e either success, error or canceled jobs).

       autoarchive {age | all}

       Archive jobs by their age.  This command can archive  jobs  older  than  age  seconds,  or
       alternatively all finished jobs can be archived if the string all is passed.

       {[--force] {--pending | --queued | --waiting} |
        job-id ...}

       Cancel  the job(s) identified by the given job id.  Only jobs that have not yet started to
       run can be canceled; that is, jobs in either the queued  or  waiting  state.   To  skip  a
       confirmation,  pass  --force.   --queued and waiting can be used to cancel all jobs in the
       respective state, --pending includes both.

       change-priority --priority {low | normal | high}
       {[--force] {--pending | --queued | --waiting} |
        job-id ...}

       Changes the priority of one or multiple pending jobs.  Jobs currently  running  have  only
       the  priority  of  remaining opcodes changed.  --priority must be specified.  --queued and
       waiting can be used to re-prioritize all jobs in the respective state, --pending  includes
       both.  To skip a confirmation, pass --force.

       info {id...}

       Show  detailed information about the given job id(s).  If no job id is given, all jobs are
       examined (warning, this is a lot of information).

       list [--no-headers] [--separator=SEPARATOR]
       [-o [+]FIELD,...] [--filter] [job-id...]

       Lists the jobs and their status.  By default, the job id, job  status,  and  a  small  job
       description is listed, but additional parameters can be selected.

       The  --no-headers  option will skip the initial header line.  The --separator option takes
       an argument which denotes what will be used between the output fields.  Both these options
       are to help scripting.

       The  -o  option  takes  a comma-separated list of output fields.  The available fields and
       their meaning are:

              Whether job is archived

       end_ts Timestamp of job end (tuple containing seconds and microseconds)

       id     Job ID

       opend  List of opcode execution end timestamps

       opexec List of opcode execution start timestamps (after acquiring locks)

       oplog  List of opcode output logs

              List of opcode priorities

              List of opcodes results

       ops    List of all opcodes

              List of opcode start timestamps (before acquiring locks)

              List of opcodes status

              Current job priority (19 to -20)

              Timestamp of when job was received (tuple containing seconds and microseconds)

              Timestamp of job start (tuple containing seconds and microseconds)

       status Job status

              List of per-opcode summaries

       If the value of the option starts with the character +, the new fields will  be  added  to
       the  default  list.   This  allows  one  to  quickly see the default list plus a few other
       fields, instead of retyping the entire list of fields.

       To include archived jobs in the list the --archived option can be used.

       The following options can be used to show only specific jobs:

              Show only jobs pending execution.

              Show jobs currently running only.

              Show failed jobs only.

              Show finished jobs only.

       If exactly one argument is given and it appears to be a query filter (see ganeti(7)),  the
       query result is filtered accordingly.  For ambiguous cases (e.g.  a single field name as a
       filter) the --filter (-F) option forces the argument to be treated as a filter.

       list-fields [field...]

       Lists available fields for jobs.

       wait {id}

       Wait for the job by the given id to finish; do not produce any output.

       watch {id}

       This command follows the output of the job by the given id and prints it.


       Report  bugs  to  project  website  (  or   contact   the
       developers using the Ganeti mailing list (


       Ganeti  overview  and specifications: ganeti(7) (general overview), ganeti-os-interface(7)
       (guest OS definitions), ganeti-extstorage-interface(7) (external storage providers).

       Ganeti  commands:  gnt-cluster(8)   (cluster-wide   commands),   gnt-job(8)   (job-related
       commands),  gnt-node(8) (node-related commands), gnt-instance(8) (instance commands), gnt-
       os(8) (guest OS commands), gnt-storage(8) (storage  commands),  gnt-group(8)  (node  group
       commands), gnt-backup(8) (instance import/export commands), gnt-debug(8) (debug commands).

       Ganeti  daemons:  ganeti-watcher(8) (automatic instance restarter), ganeti-cleaner(8) (job
       queue cleaner), ganeti-noded(8) (node daemon), ganeti-masterd(8) (master daemon),  ganeti-
       rapi(8) (remote API daemon).

       Ganeti htools: htools(1) (generic binary), hbal(1) (cluster balancer), hspace(1) (capacity
       calculation), hail(1) (IAllocator plugin), hscan(1) (data gatherer from remote  clusters),
       hinfo(1) (cluster information printer), mon-collector(7) (data collectors interface).


       Copyright  (C) 2006, 2007, 2008, 2009, 2010, 2011, 2012 Google Inc.  Permission is granted
       to copy, distribute and/or modify under the terms of the GNU  General  Public  License  as
       published  by  the  Free Software Foundation; either version 2 of the License, or (at your
       option) any later version.

       On Debian systems, the complete text of the GNU General Public License  can  be  found  in