Provided by: ganeti2_2.1.2.1-2_all bug

NAME

       gnt-job - job commands

SYNOPSIS

       gnt-job  command [ arguments... ]

DESCRIPTION

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

COMMANDS

   ARCHIVE
       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
       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.

   CANCEL
       cancel id

       Cancel the job identified by the given id. Only jobs that have not  yet
       started  to  run can be canceled; that is, jobs in either the queued or
       waiting state.

   INFO
       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
       list [ --no-headers ] [ --separator=SEPARATOR ]
           [ -o [+]FIELD,... ]

       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:

       id     the job id

       status the status of the job

       received_ts
              the timestamp the job was received

       start_ts
              the timestamp when the job was started

       end_ts the timestamp when the job was ended

       summary
              a summary of the opcodes that define the job

       ops    the list of opcodes defining the job

       opresult
              the list of opcode results

       opstatus
              the list of opcode statuses

       oplog  the list of opcode logs

       opstart
              the list of opcode start times

       opend  the list of opcode end times

       lock_status
              the lock status (useful for debugging)

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

   WATCH
       watch [ id ]

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

REPORTING BUGS

       Report bugs to  <URL:http://code.google.com/p/ganeti/> or  contact  the
       developers using the ganeti mailing list <ganeti@googlegroups.com>.

SEE ALSO

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

       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-
       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).

COPYRIGHT

       Copyright  (C) 2006, 2007, 2008, 2009 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 /usr/share/common-licenses/GPL.