1 <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
3 <!-- Fill in your name for FIRSTNAME and SURNAME. -->
4 <!-- Please adjust the date whenever revising the manpage. -->
5 <!ENTITY dhdate "<date>Jul 6, 2007</date>">
6 <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
7 allowed: see man(7), man(1). -->
8 <!ENTITY dhsection "<manvolnum>8</manvolnum>">
9 <!ENTITY dhucpackage "<refentrytitle>gnt-backup</refentrytitle>">
10 <!ENTITY dhpackage "gnt-backup">
12 <!ENTITY debian "<productname>Debian</productname>">
13 <!ENTITY gnu "<acronym>GNU</acronym>">
14 <!ENTITY gpl "&gnu; <acronym>GPL</acronym>">
15 <!ENTITY footer SYSTEM "footer.sgml">
22 <holder>Google Inc.</holder>
30 <refmiscinfo>ganeti 1.2</refmiscinfo>
33 <refname>&dhpackage;</refname>
35 <refpurpose>ganeti instance import/export</refpurpose>
39 <command>&dhpackage; </command>
41 <arg choice="req">command</arg>
42 <arg>arguments...</arg>
46 <title>DESCRIPTION</title>
49 The <command>&dhpackage;</command> is used for importing and exporting
50 instances and their configuration from a ganeti system. It is useful for
51 backing instances up and also to migrate them between clusters.
56 <title>COMMANDS</title>
62 <command>export</command>
63 <arg choice="req">-n <replaceable>node</replaceable></arg>
64 <arg>--noshutdown</arg>
65 <arg choice="req"><replaceable>instance</replaceable></arg>
69 Exports an instance to the target node. All the instance data
70 and its configuration will be exported under the
71 /srv/ganeti/exports/<replaceable>instance</replaceable>
72 directory on the target node.
76 The <option>--noshutdown</option> option will create a
77 snapshot disk of the instance without shutting it down first.
78 While this is faster and involves no downtime, it cannot be
79 guaranteed that the instance data will be in a consistent state
86 # gnt-backup export -n node1.example.com instance3.example.com
94 <command>import</command>
95 <arg choice="req">-n <replaceable>node<optional>:secondary-node</optional></replaceable></arg>
96 <arg>-s <replaceable>disksize</replaceable></arg>
97 <arg>-o <replaceable>os-type</replaceable></arg>
98 <arg>-m <replaceable>memsize</replaceable></arg>
99 <arg>-b <replaceable>bridge</replaceable></arg>
101 <arg choice="req">-t<group>
104 <arg>local_raid1</arg>
105 <arg>remote_raid1</arg>
110 <arg choice="req">--src-node=<replaceable>source-node</replaceable></arg>
111 <arg choice="req">--src-dir=<replaceable>source-dir</replaceable></arg>
112 <arg choice="req"><replaceable>instance</replaceable></arg>
115 Imports a new instance from an export residing on
116 <replaceable>source-node</replaceable> in
117 <replaceable>source-dir</replaceable>.
118 <replaceable>instance</replaceable> must be in DNS and
119 resolve to a IP in the same network as the nodes in the
124 The <option>-s</option> option specifies the disk size for
125 the instance, in mebibytes (defaults to
126 <constant>20480MiB</constant> =
127 <constant>20GiB</constant>). You can also use one of the
128 suffixes <literal>m</literal>, <literal>g</literal> or
129 <literal>t</literal> to specificy the exact the units used;
130 these suffixes map to mebibytes, gibibytes and tebibytes.
134 The <option>-o</option> options specifies the operating
135 system to be installed. The available operating systems can
136 be listed with <command>gnt-os list</command>.
140 The <option>-m</option> option specifies the memory size for
141 the instance, in mebibytes (defaults to 128 MiB).
145 The <option>-b</option> option specifies the bridge to which the
146 instance will be connected. (defaults to the cluster-wide default
147 bridge specified at cluster intialization time).
151 The <option>-t</option> options specifies the disk layout type for
152 the instance. The available choices are:
155 <term>diskless</term>
158 This creates an instance with no disks. Its useful for
159 testing only (or other special cases).
166 <para>Disk devices will be logical volumes.</para>
170 <term>local_raid1</term>
173 Disk devices will be md raid1 arrays over two local
179 <term>remote_raid1</term>
182 Disk devices will be md raid1 arrays with one
183 component (so it's not actually raid1): a drbd (0.7.x)
184 device between the instance's primary node and the
185 node given by the second value of the
186 <option>--node</option> option.
194 Disk devices will be drbd (version 8.x) on top of lvm
195 volumes. They are equivalent in functionality to
196 <replaceable>remote_raid1</replaceable>, but are
197 recommended for new instances (if you have drbd 8.x
206 If you do not want gnt-backup to wait for the disk mirror
207 to be synced, use the <option>--no-wait-for-sync</option>
214 # gnt-backup import -t plain -s 30 -m 512 -n node1.example.com \
215 > --src-node=node2.example.com \
216 > --src-dir=/srv/ganeti/exports/instance3.example.com \
217 > instance3.example.com
227 <command>list</command>
228 <arg>--node=<replaceable>NODE</replaceable></arg>
232 Lists the exports currently available in the default directory
233 in all the nodes of the current cluster, or optionally only a
234 subset of them specified using the <option>--node</option>
235 option (which can be used multiple times)
241 # gnt-backup list --nodes node1 --nodes node2
251 <!-- Keep this comment at the end of the file
256 sgml-minimize-attributes:nil
257 sgml-always-quote-attributes:t
260 sgml-parent-document:nil
261 sgml-default-dtd-file:nil
262 sgml-exposed-tags:nil
263 sgml-local-catalogs:nil
264 sgml-local-ecat-files:nil