---
name: "gnt-job"
section: "8"
platform: "linux"
package: "ganeti2"
version: "2.5.2-1+deb7u2"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/gnt-job"
---

# gnt-job(8)

Job commands

## 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

- **priority**

  current priority 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 (before acquiring locks)

- **opexec**

  the list of opcode execution start times (after acquiring any necessary locks)

- **opend**

  the list of opcode end times

- **oppriority**

  the priority of each opcode

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.

### WATCH

**watch** {id}

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

## REPORTING BUGS

Report bugs to project website (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)](/ganeti/7.md) (general overview), [**ganeti-os-interface**(7)](/ganeti-os-interface/7.md) (guest OS definitions).

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

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

Ganeti htools: [**htools**(1)](/htools/1.md) (generic binary), [**hbal**(1)](/hbal/1.md) (cluster balancer), [**hspace**(1)](/hspace/1.md) (capacity calculation), [**hail**(1)](/hail/1.md) (IAllocator plugin), [**hscan**(1)](/hscan/1.md) (data gatherer from remote clusters).

## COPYRIGHT

Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011 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.