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

# gnt-debug(8)

Debug commands

## Name

gnt-debug - Debug commands

## Synopsis

**gnt-debug** {command} \[arguments...\]

## DESCRIPTION

The **gnt-debug** is used for debugging the Ganeti system.

## COMMANDS

### IALLOCATOR

**iallocator** \[--debug\] \[--dir *DIRECTION*\] {--algorithm *ALLOCATOR* } \[--mode *MODE*\] \[--mem *MEMORY*\] \[--disks *DISKS*\] \[--disk-template *TEMPLATE*\] \[--nics *NICS*\] \[--os-type *OS*\] \[--vcpus *VCPUS*\] \[--tags *TAGS*\] {*instance*}

Executes a test run of the *iallocator* framework.

The command will build input for a given iallocator script (named with the **--algorithm** option), and either show this input data (if *DIRECTION* is **in**) or run the iallocator script and show its output (if *DIRECTION* is **out**).

If the *MODE* is **allocate**, then an instance definition is built from the other arguments and sent to the script, otherwise (*MODE* is **relocate**) an existing instance name must be passed as the first argument.

This build of Ganeti will look for iallocator scripts in the following directories: /usr/local/lib/ganeti/iallocators,/usr/lib/ganeti/iallocators; for more details about this framework, see the HTML or PDF documentation.

### DELAY

**delay** \[--debug\] \[--no-master\] \[-n *NODE*...\] {*duration*}

Run a test opcode (a sleep) on the master and on selected nodes (via an RPC call). This serves no other purpose but to execute a test operation.

The **-n** option can be given multiple times to select the nodes for the RPC call. By default, the delay will also be executed on the master, unless the **--no-master** option is passed.

The *delay* argument will be interpreted as a floating point number.

### SUBMIT-JOB

**submit-job** \[--verbose\] \[--timing-stats\] \[--job-repeat **N**\] \[--op-repeat **N**\] {opcodes\_file...}

This command builds a list of opcodes from files in JSON format and submits a job per file to the master daemon. It can be used to test options that are not available via command line.

The **verbose** option will additionally display the corresponding job IDs and the progress in waiting for the jobs; the **timing-stats** option will show some overall statistics inluding the number of total opcodes, jobs submitted and time spent in each stage (submit, exec, total).

The **job-repeat** and **op-repeat** options allow to submit multiple copies of the passed arguments; job-repeat will cause N copies of each job (input file) to be submitted (equivalent to passing the arguments N times) while op-repeat will cause N copies of each of the opcodes in the file to be executed (equivalent to each file containing N copies of the opcodes).

### TEST-JOBQUEUE

**test-jobqueue**

Executes a few tests on the job queue. This command might generate failed jobs deliberately.

### LOCKS

**locks** \[--no-headers\] \[--separator=*SEPARATOR*\] \[-v\]

\[-o *\[+\]FIELD,...*\] \[--interval=*SECONDS*\]

Shows a list of locks in the master daemon.

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 **-v** option activates verbose mode, which changes the display of special field states (see **[ganeti(7)](/ganeti/7.md)**).

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

- **mode**

  Mode in which the lock is currently acquired (exclusive or shared)

- **name**

  Lock name

- **owner**

  Current lock owner(s)

- **pending**

  Threads waiting for the lock

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.

Use **--interval** to repeat the listing. A delay specified by the option value in seconds is inserted.

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