1 gnt-debug(8) Ganeti | Version @GANETI_VERSION@
2 ==============================================
7 gnt-debug - Debug commands
12 **gnt-debug** {command} [arguments...]
17 The **gnt-debug** is used for debugging the Ganeti system.
25 **iallocator** [\--debug] [\--dir *DIRECTION*] {\--algorithm
26 *ALLOCATOR* } [\--mode *MODE*] [\--mem *MEMORY*] [\--disks *DISKS*]
27 [\--disk-template *TEMPLATE*] [\--nics *NICS*] [\--os-type *OS*]
28 [\--vcpus *VCPUS*] [\--tags *TAGS*] {*instance*}
30 Executes a test run of the *iallocator* framework.
32 The command will build input for a given iallocator script (named
33 with the ``--algorithm`` option), and either show this input data
34 (if *DIRECTION* is ``in``) or run the iallocator script and show its
35 output (if *DIRECTION* is ``out``).
37 If the *MODE* is ``allocate``, then an instance definition is built
38 from the other arguments and sent to the script, otherwise (*MODE* is
39 ``relocate``) an existing instance name must be passed as the first
42 This build of Ganeti will look for iallocator scripts in the following
43 directories: @CUSTOM_IALLOCATOR_SEARCH_PATH@; for more details about
44 this framework, see the HTML or PDF documentation.
49 **delay** [\--debug] [\--no-master] [-n *NODE*...] {*duration*}
51 Run a test opcode (a sleep) on the master and on selected nodes
52 (via an RPC call). This serves no other purpose but to execute a
55 The ``-n`` option can be given multiple times to select the nodes
56 for the RPC call. By default, the delay will also be executed on
57 the master, unless the ``--no-master`` option is passed.
59 The *delay* argument will be interpreted as a floating point
65 **submit-job** [\--verbose] [\--timing-stats] [\--job-repeat *N*]
66 [\--op-repeat *N*] [\--each] {opcodes_file...}
68 This command builds a list of opcodes from files in JSON format and
69 submits a job per file to the master daemon. It can be used to test
70 options that are not available via command line.
72 The ``verbose`` option will additionally display the corresponding
73 job IDs and the progress in waiting for the jobs; the
74 ``timing-stats`` option will show some overall statistics inluding
75 the number of total opcodes, jobs submitted and time spent in each
76 stage (submit, exec, total).
78 The ``job-repeat`` and ``op-repeat`` options allow to submit
79 multiple copies of the passed arguments; job-repeat will cause N
80 copies of each job (input file) to be submitted (equivalent to
81 passing the arguments N times) while op-repeat will cause N copies
82 of each of the opcodes in the file to be executed (equivalent to
83 each file containing N copies of the opcodes).
85 The ``each`` option allow to submit each job separately (using ``N``
86 SubmitJob LUXI requests instead of one SubmitManyJobs request).
93 Executes a few tests on the job queue. This command might generate
94 failed jobs deliberately.
99 | **locks** [\--no-headers] [\--separator=*SEPARATOR*] [-v]
100 | [-o *[+]FIELD,...*] [\--interval=*SECONDS*]
102 Shows a list of locks in the master daemon.
104 The ``--no-headers`` option will skip the initial header line. The
105 ``--separator`` option takes an argument which denotes what will be
106 used between the output fields. Both these options are to help
109 The ``-v`` option activates verbose mode, which changes the display of
110 special field states (see **ganeti(7)**).
112 The ``-o`` option takes a comma-separated list of output fields.
113 The available fields and their meaning are:
117 If the value of the option starts with the character ``+``, the new
118 fields will be added to the default list. This allows one to quickly
119 see the default list plus a few other fields, instead of retyping
120 the entire list of fields.
122 Use ``--interval`` to repeat the listing. A delay specified by the
123 option value in seconds is inserted.
125 .. vim: set textwidth=72 :