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>--swap-size <replaceable>disksize</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>--swap-size</option> option specifies the swap
135 disk size (in mebibytes) for the instance (the one presented
136 as <filename class="devicefile">/dev/sdb</filename>). The
137 default is <constant>4096MiB</constant>. As for the disk
138 size, you can specify other suffixes.
142 The <option>-m</option> option specifies the memory size for
143 the instance, in mebibytes (defaults to 128 MiB). Again, you
144 can use other suffixes (e.g. <userinput>2g</userinput>).
148 The <option>-b</option> option specifies the bridge to which the
149 instance will be connected. (defaults to the cluster-wide default
150 bridge specified at cluster intialization time).
154 The <option>-t</option> options specifies the disk layout type for
155 the instance. The available choices are:
158 <term>diskless</term>
161 This creates an instance with no disks. Its useful for
162 testing only (or other special cases).
169 <para>Disk devices will be logical volumes.</para>
173 <term>local_raid1</term>
176 Disk devices will be md raid1 arrays over two local
182 <term>remote_raid1</term>
185 Disk devices will be md raid1 arrays with one
186 component (so it's not actually raid1): a drbd (0.7.x)
187 device between the instance's primary node and the
188 node given by the second value of the
189 <option>--node</option> option.
197 Disk devices will be drbd (version 8.x) on top of lvm
198 volumes. They are equivalent in functionality to
199 <replaceable>remote_raid1</replaceable>, but are
200 recommended for new instances (if you have drbd 8.x
209 If you do not want gnt-backup to wait for the disk mirror
210 to be synced, use the <option>--no-wait-for-sync</option>
217 # gnt-backup import -t plain -s 30 -m 512 -n node1.example.com \
218 > --src-node=node2.example.com \
219 > --src-dir=/srv/ganeti/exports/instance3.example.com \
220 > instance3.example.com
230 <command>list</command>
231 <arg>--node=<replaceable>NODE</replaceable></arg>
235 Lists the exports currently available in the default directory
236 in all the nodes of the current cluster, or optionally only a
237 subset of them specified using the <option>--node</option>
238 option (which can be used multiple times)
244 # gnt-backup list --nodes node1 --nodes node2
254 <!-- Keep this comment at the end of the file
259 sgml-minimize-attributes:nil
260 sgml-always-quote-attributes:t
263 sgml-parent-document:nil
264 sgml-default-dtd-file:nil
265 sgml-exposed-tags:nil
266 sgml-local-catalogs:nil
267 sgml-local-ecat-files:nil