Provided by: ganeti_1.2.6-2_all bug

NAME

       gnt-backup - ganeti instance import/export

SYNOPSIS

       gnt-backup  command [ arguments... ]

DESCRIPTION

       The  gnt-backup is used for importing and exporting instances and their
       configuration from a ganeti system. It is useful for backing  instances
       up and also to migrate them between clusters.

COMMANDS

   EXPORT
       export -n node [ --noshutdown ] instance

       Exports  an  instance to the target node. All the instance data and its
       configuration will be exported under  the  /srv/ganeti/exports/instance
       directory on the target node.

       The  --noshutdown  option  will  create a snapshot disk of the instance
       without shutting it down first.  While this is faster and  involves  no
       downtime,  it  cannot be guaranteed that the instance data will be in a
       consistent state in the exported dump.

       Example:

       # gnt-backup export -n node1.example.com instance3.example.com

   IMPORT
       import { -n node[:secondary-node] | --iallocator name }
           [ -s disksize ] [ --swap-size disksize ] [ -m memsize ]
           [ --cpu vcpus ] [ --ip { default | none | ip-address } ]
           [ -b bridge ] [ --no-wait-for-sync ] [ --no-ip-check ]
           --src-node=source-node --src-dir=source-dir
           -t [ diskless | plain | local_raid1 | remote_raid1 | drbd ]
           [ --auto_balance AUTO_BALANCE ] instance

       Imports a new instance  from  an  export  residing  on  source-node  in
       source-dir.   instance  must  be in DNS and resolve to a IP in the same
       network as the nodes in the cluster.

       The -s option specifies the disk size for the  instance,  in  mebibytes
       (defaults to 20480MiB = 20GiB). You can also use one of the suffixes m,
       g or t to specificy the exact the units used;  these  suffixes  map  to
       mebibytes, gibibytes and tebibytes.

       The  --swap-size option specifies the swap disk size (in mebibytes) for
       the instance (the one presented as /dev/sdb). The default  is  4096MiB.
       As for the disk size, you can specify other suffixes.

       The  -m option specifies the memory size for the instance, in mebibytes
       (defaults to 128 MiB). Again, you can use other suffixes (e.g. 2g).

       The -b option specifies the  bridge  to  which  the  instance  will  be
       connected.  (defaults  to  the cluster-wide default bridge specified at
       cluster intialization time).

       The -t options specifies the disk layout type  for  the  instance.  The
       available choices are:

       diskless
              This  creates  an instance with no disks. Its useful for testing
              only (or other special cases).

       plain  Disk devices will be logical volumes.

       local_raid1
              Disk devices will be md raid1  arrays  over  two  local  logical
              volumes.

       remote_raid1
              Disk devices will be md raid1 arrays with one component (so it’s
              not  actually  raid1):  a  drbd  (0.7.x)  device   between   the
              instance’s  primary  node and the node given by the second value
              of the --node option.

       drbd   Disk devices will be drbd (version 8.x) on top of  lvm  volumes.
              They  are  equivalent  in functionality to remote_raid1, but are
              recommended for new instances (if you have drbd 8.x  installed).

       The --iallocator option specifies the instance allocator plugin to use.
       If you pass in this option the allocator will  select  nodes  for  this
       instance  automatically,  so  you  don’t  need to pass them with the -n
       option. For more information please refer  to  the  instance  allocator
       documentation.

       The  optional  second  value  of the --node is used for the remote raid
       template type and specifies the remote node.

       If you do not want gnt-backup to wait for the disk mirror to be synced,
       use the --no-wait-for-sync option.

       Use the --cpu option to set the number of virtual CPUs.

       The  --auto-balance  option  specifies  whether  the memory size of the
       instance will be considered in cluster verify checks; in the future, it
       might be used for automated cluster operations, but currently it is not
       used anywhere else. It default to true.

       To pass an IPv4 address to the hypervisor,  specify  the  --ip  option.
       Note  that  this  IP  address  will  not  be used by the OS scripts and
       changing it later will  change  the  address  that  the  instance  will
       actually use.

       Ganeti will not check whether an instance’s IP address is already alive
       if the --no-ip-check option is specified.

       Example:

       # gnt-backup import -t plain -s 30 -m 512 -n node1.example.com \
       > --src-node=node2.example.com \
       > --src-dir=/srv/ganeti/exports/instance3.example.com \
       > instance3.example.com

   LIST
       list [ --node=NODE ]

       Lists the exports currently available in the default directory  in  all
       the  nodes  of the current cluster, or optionally only a subset of them
       specified using the --node option (which can be used multiple times)

       Example:

       # gnt-backup list --nodes node1 --nodes node2

REPORTING BUGS

       Report  bugs  to  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-node(8)
       (node-related commands), gnt-instance(8) (instance commands), gnt-os(8)
       (guest OS commands).  gnt-backup(8) (instance import/export  commands).

       Ganeti   daemons:  ganeti-watcher(8)  (automatic  instance  restarter),
       ganeti-noded(8) (node daemon),  ganeti-master(8)  (the  master  startup
       script), ganeti-rapi(8) (remote API daemon).

COPYRIGHT

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