EXPORT
~~~~~~
-**export** {-n *node*} [--shutdown-timeout=*N*] [--noshutdown]
-[--remove-instance] [--ignore-remove-failures] {*instance*}
+| **export** {-n *node*} [\--shutdown-timeout=*N*] [\--noshutdown]
+| [\--remove-instance] [\--ignore-remove-failures] [\--submit]
+| {*instance*}
Exports an instance to the target node. All the instance data and
its configuration will be exported under the
-``@CUSTOM_EXPORT_DIR@/``*instance* directory on the target node.
+``@CUSTOM_EXPORT_DIR@/$instance`` directory on the target node.
The ``--shutdown-timeout`` is used to specify how much time to wait
before forcing the shutdown (xm destroy in xen, killing the kvm
that for any non-zero exit code, the backup is considered invalid,
and retried.
+See **ganeti**\(7) for a description of ``--submit`` and other common
+options.
+
Example::
# gnt-backup export -n node1.example.com instance3.example.com
~~~~~~
| **import**
-| {-n *node[:secondary-node]* | --iallocator *name*}
-| [--disk *N*:size=*VAL* [,vg=*VG*], [,mode=*ro|rw*]...]
-| [--net *N* [:options...] | --no-nics]
+| {-n *node[:secondary-node]* | \--iallocator *name*}
+| [\--disk *N*:size=*VAL* [,vg=*VG*], [,mode=*ro|rw*]...]
+| [\--net *N* [:options...] | \--no-nics]
| [-B *BEPARAMS*]
| [-H *HYPERVISOR* [: option=*value*... ]]
-| [--src-node=*source-node*] [--src-dir=*source-dir*]
+| [\--src-node=*source-node*] [\--src-dir=*source-dir*]
| [-t [diskless | plain | drbd | file]]
-| [--identify-defaults]
+| [\--identify-defaults]
+| [\--ignore-ipolicy]
+| [\--submit]
| {*instance*}
Imports a new instance from an export residing on *source-node* in
the node expects the instance to use)
mode
- specifies the connection mode for this nic: ``routed`` or
- ``bridged``.
+ specifies the connection mode for this NIC: ``routed``,
+ ``bridged`` or ``openvswitch``
link
- in bridged mode specifies the bridge to attach this NIC to, in
- routed mode it's intended to differentiate between different
- routing tables/instance groups (but the meaning is dependent on
- the network script in use, see **gnt-cluster**(8) for more
- details)
+ in bridged and openvswitch mode specifies the interface to attach
+ this NIC to, in routed mode it's intended to differentiate between
+ different routing tables/instance groups (but the meaning is
+ dependent on the network script in use, see **gnt-cluster**\(8) for
+ more details)
-Of these ``mode`` and ``link`` are nic parameters, and inherit their
+Of these ``mode`` and ``link`` are NIC parameters, and inherit their
default at cluster level.
If no network is desired for the instance, you should create a single
-empty NIC and delete it afterwards via **gnt-instance modify --net
+empty NIC and delete it afterwards via **gnt-instance modify \--net
delete**.
The ``-B`` option specifies the backend parameters for the
The ``--src-dir`` option allows importing instances from a directory
below ``@CUSTOM_EXPORT_DIR@``.
+If ``--ignore-ipolicy`` is given any instance policy violations occuring
+during this operation are ignored.
+
Since many of the parameters are by default read from the exported
instance information and used as such, the new instance will have
all parameters explicitly specified, the opposite of a newly added
affect the hypervisor, backend and NIC parameters, both read from
the export file and passed in via the command line.
+See **ganeti**\(7) for a description of ``--submit`` and other common
+options.
+
Example for identical instance import::
# gnt-backup import -n node1.example.com instance3.example.com
LIST
~~~~
-**list** [--node=*NODE*]
+| **list** [\--node=*NODE*] [\--no-headers] [\--separator=*SEPARATOR*]
+| [-o *[+]FIELD,...*]
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)
+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:
+
+@QUERY_FIELDS_EXPORT@
+
+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.
+
Example::
- # gnt-backup list --nodes node1 --nodes node2
+ # gnt-backup list --node node1 --node node2
+
+
+LIST-FIELDS
+~~~~~~~~~~~
+
+**list-fields** [field...]
+
+Lists available fields for exports.
REMOVE