Provided by: ganeti2_2.4.5-1_all bug

Name

       gnt-debug - Debug commands

Synopsis

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

DESCRIPTION

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

COMMANDS

   ALLOCATOR
       allocator  [--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)).

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

       name   Lock name

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

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

COPYRIGHT

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