root / man / gnt-backup.sgml @ 33ea43b6
History | View | Annotate | Download (14.5 kB)
1 | dd4b1106 | Iustin Pop | <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [ |
---|---|---|---|
2 | dd4b1106 | Iustin Pop | |
3 | dd4b1106 | Iustin Pop | <!-- Fill in your name for FIRSTNAME and SURNAME. --> |
4 | dd4b1106 | Iustin Pop | <!-- Please adjust the date whenever revising the manpage. --> |
5 | d3b4cf9f | Iustin Pop | <!ENTITY dhdate "<date>February 11, 2009</date>"> |
6 | dd4b1106 | Iustin Pop | <!-- SECTION should be 1-8, maybe w/ subsection other parameters are |
7 | dd4b1106 | Iustin Pop | allowed: see man(7), man(1). --> |
8 | dd4b1106 | Iustin Pop | <!ENTITY dhsection "<manvolnum>8</manvolnum>"> |
9 | dd4b1106 | Iustin Pop | <!ENTITY dhucpackage "<refentrytitle>gnt-backup</refentrytitle>"> |
10 | dd4b1106 | Iustin Pop | <!ENTITY dhpackage "gnt-backup"> |
11 | dd4b1106 | Iustin Pop | |
12 | dd4b1106 | Iustin Pop | <!ENTITY debian "<productname>Debian</productname>"> |
13 | dd4b1106 | Iustin Pop | <!ENTITY gnu "<acronym>GNU</acronym>"> |
14 | dd4b1106 | Iustin Pop | <!ENTITY gpl "&gnu; <acronym>GPL</acronym>"> |
15 | dd4b1106 | Iustin Pop | <!ENTITY footer SYSTEM "footer.sgml"> |
16 | dd4b1106 | Iustin Pop | ]> |
17 | dd4b1106 | Iustin Pop | |
18 | dd4b1106 | Iustin Pop | <refentry> |
19 | dd4b1106 | Iustin Pop | <refentryinfo> |
20 | dd4b1106 | Iustin Pop | <copyright> |
21 | dd4b1106 | Iustin Pop | <year>2007</year> |
22 | d3b4cf9f | Iustin Pop | <year>2008</year> |
23 | d3b4cf9f | Iustin Pop | <year>2009</year> |
24 | 33ea43b6 | Iustin Pop | <year>2010</year> |
25 | dd4b1106 | Iustin Pop | <holder>Google Inc.</holder> |
26 | dd4b1106 | Iustin Pop | </copyright> |
27 | dd4b1106 | Iustin Pop | &dhdate; |
28 | dd4b1106 | Iustin Pop | </refentryinfo> |
29 | dd4b1106 | Iustin Pop | <refmeta> |
30 | dd4b1106 | Iustin Pop | &dhucpackage; |
31 | dd4b1106 | Iustin Pop | |
32 | dd4b1106 | Iustin Pop | &dhsection; |
33 | 33ea43b6 | Iustin Pop | <refmiscinfo>ganeti 2.1</refmiscinfo> |
34 | dd4b1106 | Iustin Pop | </refmeta> |
35 | dd4b1106 | Iustin Pop | <refnamediv> |
36 | dd4b1106 | Iustin Pop | <refname>&dhpackage;</refname> |
37 | dd4b1106 | Iustin Pop | |
38 | dd4b1106 | Iustin Pop | <refpurpose>ganeti instance import/export</refpurpose> |
39 | dd4b1106 | Iustin Pop | </refnamediv> |
40 | dd4b1106 | Iustin Pop | <refsynopsisdiv> |
41 | dd4b1106 | Iustin Pop | <cmdsynopsis> |
42 | dd4b1106 | Iustin Pop | <command>&dhpackage; </command> |
43 | dd4b1106 | Iustin Pop | |
44 | dd4b1106 | Iustin Pop | <arg choice="req">command</arg> |
45 | dd4b1106 | Iustin Pop | <arg>arguments...</arg> |
46 | dd4b1106 | Iustin Pop | </cmdsynopsis> |
47 | dd4b1106 | Iustin Pop | </refsynopsisdiv> |
48 | dd4b1106 | Iustin Pop | <refsect1> |
49 | dd4b1106 | Iustin Pop | <title>DESCRIPTION</title> |
50 | dd4b1106 | Iustin Pop | |
51 | dd4b1106 | Iustin Pop | <para> |
52 | dd4b1106 | Iustin Pop | The <command>&dhpackage;</command> is used for importing and exporting |
53 | dd4b1106 | Iustin Pop | instances and their configuration from a ganeti system. It is useful for |
54 | dd4b1106 | Iustin Pop | backing instances up and also to migrate them between clusters. |
55 | dd4b1106 | Iustin Pop | </para> |
56 | dd4b1106 | Iustin Pop | |
57 | dd4b1106 | Iustin Pop | </refsect1> |
58 | dd4b1106 | Iustin Pop | <refsect1> |
59 | dd4b1106 | Iustin Pop | <title>COMMANDS</title> |
60 | dd4b1106 | Iustin Pop | |
61 | dd4b1106 | Iustin Pop | <refsect2> |
62 | dd4b1106 | Iustin Pop | <title>EXPORT</title> |
63 | dd4b1106 | Iustin Pop | |
64 | dd4b1106 | Iustin Pop | <cmdsynopsis> |
65 | dd4b1106 | Iustin Pop | <command>export</command> |
66 | dd4b1106 | Iustin Pop | <arg choice="req">-n <replaceable>node</replaceable></arg> |
67 | 1e2c9fd3 | Guido Trotter | <arg>--shutdown-timeout=<replaceable>N</replaceable></arg> |
68 | dd4b1106 | Iustin Pop | <arg>--noshutdown</arg> |
69 | dd4b1106 | Iustin Pop | <arg choice="req"><replaceable>instance</replaceable></arg> |
70 | 1e2c9fd3 | Guido Trotter | |
71 | dd4b1106 | Iustin Pop | </cmdsynopsis> |
72 | dd4b1106 | Iustin Pop | |
73 | dd4b1106 | Iustin Pop | <para> |
74 | f69dab6d | Iustin Pop | Exports an instance to the target node. All the instance data |
75 | f69dab6d | Iustin Pop | and its configuration will be exported under the |
76 | 56118de5 | Iustin Pop | /srv/ganeti/export/<replaceable>instance</replaceable> |
77 | f69dab6d | Iustin Pop | directory on the target node. |
78 | dd4b1106 | Iustin Pop | </para> |
79 | dd4b1106 | Iustin Pop | |
80 | dd4b1106 | Iustin Pop | <para> |
81 | 1e2c9fd3 | Guido Trotter | The <option>--shutdown-timeout</option> is used to specify how |
82 | 1e2c9fd3 | Guido Trotter | much time to wait before forcing the shutdown (xm destroy in xen, |
83 | 1e2c9fd3 | Guido Trotter | killing the kvm process, for kvm). By default two minutes are |
84 | 1e2c9fd3 | Guido Trotter | given to each instance to stop. |
85 | 1e2c9fd3 | Guido Trotter | </para> |
86 | 1e2c9fd3 | Guido Trotter | |
87 | 1e2c9fd3 | Guido Trotter | <para> |
88 | dd4b1106 | Iustin Pop | The <option>--noshutdown</option> option will create a |
89 | dd4b1106 | Iustin Pop | snapshot disk of the instance without shutting it down first. |
90 | dd4b1106 | Iustin Pop | While this is faster and involves no downtime, it cannot be |
91 | dd4b1106 | Iustin Pop | guaranteed that the instance data will be in a consistent state |
92 | dd4b1106 | Iustin Pop | in the exported dump. |
93 | dd4b1106 | Iustin Pop | </para> |
94 | dd4b1106 | Iustin Pop | |
95 | dd4b1106 | Iustin Pop | <para> |
96 | 084f05a5 | Iustin Pop | The exit code of the command is 0 if all disks were backed up |
97 | 084f05a5 | Iustin Pop | successfully, 1 if no data was backed up or if the |
98 | 084f05a5 | Iustin Pop | configuration export failed, and 2 if just some of the disks |
99 | 084f05a5 | Iustin Pop | failed to backup. The exact details of the failures will be |
100 | 084f05a5 | Iustin Pop | shown during the command execution (and will be stored in the |
101 | 084f05a5 | Iustin Pop | job log). It is recommended that for any non-zero exit code, |
102 | 084f05a5 | Iustin Pop | the backup is considered invalid, and retried. |
103 | 084f05a5 | Iustin Pop | </para> |
104 | 084f05a5 | Iustin Pop | |
105 | 084f05a5 | Iustin Pop | <para> |
106 | dd4b1106 | Iustin Pop | Example: |
107 | dd4b1106 | Iustin Pop | <screen> |
108 | 017778ac | Guido Trotter | # gnt-backup export -n node1.example.com instance3.example.com |
109 | dd4b1106 | Iustin Pop | </screen> |
110 | dd4b1106 | Iustin Pop | </para> |
111 | dd4b1106 | Iustin Pop | </refsect2> |
112 | dd4b1106 | Iustin Pop | |
113 | dd4b1106 | Iustin Pop | <refsect2> |
114 | dd4b1106 | Iustin Pop | <title>IMPORT</title> |
115 | dd4b1106 | Iustin Pop | <cmdsynopsis> |
116 | dd4b1106 | Iustin Pop | <command>import</command> |
117 | d3b4cf9f | Iustin Pop | <sbr> |
118 | a53a1b18 | Michael Hanselmann | <group choice="req"> |
119 | d3b4cf9f | Iustin Pop | <arg>-n <replaceable>node<optional>:secondary-node</optional></replaceable></arg> <arg>--iallocator |
120 | d3b4cf9f | Iustin Pop | <replaceable>name</replaceable></arg> |
121 | a53a1b18 | Michael Hanselmann | </group> |
122 | bdb7d4e8 | Michael Hanselmann | <sbr> |
123 | bdb7d4e8 | Michael Hanselmann | |
124 | d3b4cf9f | Iustin Pop | <arg rep="repeat">--disk <replaceable>N</replaceable>:size=<replaceable>VAL</replaceable><arg>,mode=<replaceable>ro|rw</replaceable></arg></arg> |
125 | a53a1b18 | Michael Hanselmann | <sbr> |
126 | d3b4cf9f | Iustin Pop | <group> |
127 | d3b4cf9f | Iustin Pop | <arg rep="repeat">--net <replaceable>N</replaceable><arg rep="repeat">:options</arg></arg> |
128 | d3b4cf9f | Iustin Pop | <arg>--no-nics</arg> |
129 | d3b4cf9f | Iustin Pop | </group> |
130 | d3b4cf9f | Iustin Pop | <sbr> |
131 | d3b4cf9f | Iustin Pop | <arg>-B <replaceable>BEPARAMS</replaceable></arg> |
132 | d3b4cf9f | Iustin Pop | <sbr> |
133 | d3b4cf9f | Iustin Pop | <arg>-H <replaceable>HYPERVISOR</replaceable><arg>:<arg choice="plain" rep="repeat">option=<replaceable>value</replaceable></arg></arg></arg> |
134 | 8cd7cb4c | Guido Trotter | <sbr> |
135 | d3b4cf9f | Iustin Pop | <arg>--src-node=<replaceable>source-node</replaceable></arg> |
136 | d3b4cf9f | Iustin Pop | <arg>--src-dir=<replaceable>source-dir</replaceable></arg> |
137 | dd4b1106 | Iustin Pop | <sbr> |
138 | bdb7d4e8 | Michael Hanselmann | |
139 | 33ea43b6 | Iustin Pop | <arg choice="opt">-t<group> |
140 | dd4b1106 | Iustin Pop | <arg>diskless</arg> |
141 | dd4b1106 | Iustin Pop | <arg>plain</arg> |
142 | f69dab6d | Iustin Pop | <arg>drbd</arg> |
143 | d3b4cf9f | Iustin Pop | <arg>file</arg> |
144 | bdb7d4e8 | Michael Hanselmann | </group></arg> |
145 | f69dab6d | Iustin Pop | <sbr> |
146 | bdb7d4e8 | Michael Hanselmann | |
147 | 33ea43b6 | Iustin Pop | <arg choice="opt">--identify-defaults</arg> |
148 | 33ea43b6 | Iustin Pop | <sbr> |
149 | 33ea43b6 | Iustin Pop | |
150 | dd4b1106 | Iustin Pop | <arg choice="req"><replaceable>instance</replaceable></arg> |
151 | dd4b1106 | Iustin Pop | </cmdsynopsis> |
152 | 33ea43b6 | Iustin Pop | |
153 | dd4b1106 | Iustin Pop | <para> |
154 | dd4b1106 | Iustin Pop | Imports a new instance from an export residing on |
155 | dd4b1106 | Iustin Pop | <replaceable>source-node</replaceable> in |
156 | dd4b1106 | Iustin Pop | <replaceable>source-dir</replaceable>. |
157 | d3b4cf9f | Iustin Pop | <replaceable>instance</replaceable> must be in DNS and resolve |
158 | d3b4cf9f | Iustin Pop | to a IP in the same network as the nodes in the cluster. If |
159 | d3b4cf9f | Iustin Pop | the source node and directory are not passed, the last backup |
160 | d3b4cf9f | Iustin Pop | in the cluster is used, as visible with the |
161 | d3b4cf9f | Iustin Pop | <command>list</command> command. |
162 | dd4b1106 | Iustin Pop | </para> |
163 | dd4b1106 | Iustin Pop | |
164 | dd4b1106 | Iustin Pop | <para> |
165 | d3b4cf9f | Iustin Pop | The <option>disk</option> option specifies the parameters for |
166 | d3b4cf9f | Iustin Pop | the disks of the instance. The numbering of disks starts at |
167 | 33ea43b6 | Iustin Pop | zero. For each disk, at least the size needs to be given, and |
168 | 33ea43b6 | Iustin Pop | optionally the access mode (read-only or the default of |
169 | 33ea43b6 | Iustin Pop | read-write) can also be specified. The size is interpreted |
170 | 33ea43b6 | Iustin Pop | (when no unit is given) in mebibytes. You can also use one of |
171 | 33ea43b6 | Iustin Pop | the suffixes |
172 | d3b4cf9f | Iustin Pop | <literal>m</literal>, <literal>g</literal> or |
173 | d5687e89 | Guido Trotter | <literal>t</literal> to specificy the exact the units used; |
174 | d5687e89 | Guido Trotter | these suffixes map to mebibytes, gibibytes and tebibytes. |
175 | dd4b1106 | Iustin Pop | </para> |
176 | dd4b1106 | Iustin Pop | |
177 | dd4b1106 | Iustin Pop | <para> |
178 | c0e4a2c3 | Iustin Pop | Alternatively, a single-disk instance can be created via the |
179 | c0e4a2c3 | Iustin Pop | <option>-s</option> option which takes a single argument, |
180 | c0e4a2c3 | Iustin Pop | the size of the disk. This is similar to the Ganeti 1.2 |
181 | c0e4a2c3 | Iustin Pop | version (but will only create one disk). |
182 | c0e4a2c3 | Iustin Pop | </para> |
183 | c0e4a2c3 | Iustin Pop | |
184 | c0e4a2c3 | Iustin Pop | <para> |
185 | 33ea43b6 | Iustin Pop | If no disk information is passed, the disk configuration saved |
186 | 33ea43b6 | Iustin Pop | at export time will be used. |
187 | 33ea43b6 | Iustin Pop | </para> |
188 | 33ea43b6 | Iustin Pop | |
189 | 33ea43b6 | Iustin Pop | <para> |
190 | 33ea43b6 | Iustin Pop | The minimum disk specification is therefore empty (export |
191 | 33ea43b6 | Iustin Pop | information will be used), a single disk can be specified as |
192 | c0e4a2c3 | Iustin Pop | <userinput>--disk 0:size=20G</userinput> (or <userinput>-s |
193 | c0e4a2c3 | Iustin Pop | 20G</userinput> when using the <option>-s</option> option), |
194 | c0e4a2c3 | Iustin Pop | and a three-disk instance can be specified as |
195 | c0e4a2c3 | Iustin Pop | <userinput>--disk 0:size=20G --disk 1:size=4G --disk |
196 | c0e4a2c3 | Iustin Pop | 2:size=100G</userinput>. |
197 | 1e808cbf | Guido Trotter | </para> |
198 | 1e808cbf | Guido Trotter | |
199 | 1e808cbf | Guido Trotter | <para> |
200 | d3b4cf9f | Iustin Pop | The NICs of the instances can be specified via the |
201 | 33ea43b6 | Iustin Pop | <option>--net</option> option. By default, the NIC |
202 | 33ea43b6 | Iustin Pop | configuration of the original (exported) instance will be |
203 | 33ea43b6 | Iustin Pop | reused. Each NIC can take up to three parameters (all |
204 | 33ea43b6 | Iustin Pop | optional): |
205 | d3b4cf9f | Iustin Pop | <variablelist> |
206 | d3b4cf9f | Iustin Pop | <varlistentry> |
207 | d3b4cf9f | Iustin Pop | <term>mac</term> |
208 | d3b4cf9f | Iustin Pop | <listitem> |
209 | d3b4cf9f | Iustin Pop | <simpara>either a value or <constant>GENERATE</constant> |
210 | d3b4cf9f | Iustin Pop | to generate a new unique MAC, or |
211 | d3b4cf9f | Iustin Pop | <constant>AUTO</constant> to reuse the old MAC</simpara> |
212 | d3b4cf9f | Iustin Pop | </listitem> |
213 | d3b4cf9f | Iustin Pop | </varlistentry> |
214 | d3b4cf9f | Iustin Pop | <varlistentry> |
215 | d3b4cf9f | Iustin Pop | <term>ip</term> |
216 | d3b4cf9f | Iustin Pop | <listitem> |
217 | d3b4cf9f | Iustin Pop | <simpara>specifies the IP address assigned to the |
218 | d3b4cf9f | Iustin Pop | instance from the Ganeti side (this is not necessarily |
219 | d3b4cf9f | Iustin Pop | what the instance will use, but what the node expects |
220 | d3b4cf9f | Iustin Pop | the instance to use)</simpara> |
221 | d3b4cf9f | Iustin Pop | </listitem> |
222 | d3b4cf9f | Iustin Pop | </varlistentry> |
223 | 7d713344 | Guido Trotter | <varlistentry> |
224 | 7d713344 | Guido Trotter | <term>mode</term> |
225 | 7d713344 | Guido Trotter | <listitem> |
226 | 7d713344 | Guido Trotter | <simpara>specifies the connection mode for this nic: |
227 | 7d713344 | Guido Trotter | routed or bridged.</simpara> |
228 | 7d713344 | Guido Trotter | </listitem> |
229 | 7d713344 | Guido Trotter | </varlistentry> |
230 | 7d713344 | Guido Trotter | <varlistentry> |
231 | 7d713344 | Guido Trotter | <term>link</term> |
232 | 7d713344 | Guido Trotter | <listitem> |
233 | 7d713344 | Guido Trotter | <simpara>in bridged mode specifies the bridge to attach |
234 | 7d713344 | Guido Trotter | this NIC to, in routed mode it's intended to |
235 | 7d713344 | Guido Trotter | differentiate between different routing tables/instance |
236 | 7d713344 | Guido Trotter | groups (but the meaning is dependent on the network |
237 | 8063787e | Guido Trotter | script, see gnt-cluster(8) for more details)</simpara> |
238 | 7d713344 | Guido Trotter | </listitem> |
239 | 7d713344 | Guido Trotter | </varlistentry> |
240 | 7d713344 | Guido Trotter | </variablelist> |
241 | 7d713344 | Guido Trotter | Of these "mode" and "link" are nic parameters, and inherit their |
242 | 7d713344 | Guido Trotter | default at cluster level. |
243 | dd4b1106 | Iustin Pop | </para> |
244 | dd4b1106 | Iustin Pop | |
245 | dd4b1106 | Iustin Pop | <para> |
246 | 33ea43b6 | Iustin Pop | If no network is desired for the instance, you should create a |
247 | 33ea43b6 | Iustin Pop | single empty NIC and delete it afterwards |
248 | 33ea43b6 | Iustin Pop | via <command>gnt-instance modify --net delete</command>. |
249 | dd4b1106 | Iustin Pop | </para> |
250 | dd4b1106 | Iustin Pop | |
251 | dd4b1106 | Iustin Pop | <para> |
252 | d3b4cf9f | Iustin Pop | The <option>-B</option> option specifies the backend |
253 | d3b4cf9f | Iustin Pop | parameters for the instance. If no such parameters are |
254 | 33ea43b6 | Iustin Pop | specified, the values are inherited from the export. Possible |
255 | d3b4cf9f | Iustin Pop | parameters are: |
256 | d3b4cf9f | Iustin Pop | <variablelist> |
257 | d3b4cf9f | Iustin Pop | <varlistentry> |
258 | d3b4cf9f | Iustin Pop | <term>memory</term> |
259 | d3b4cf9f | Iustin Pop | <listitem> |
260 | d3b4cf9f | Iustin Pop | <simpara>the memory size of the instance; as usual, |
261 | d3b4cf9f | Iustin Pop | suffixes can be used to denote the unit, otherwise the |
262 | d3b4cf9f | Iustin Pop | value is taken in mebibites</simpara> |
263 | d3b4cf9f | Iustin Pop | </listitem> |
264 | d3b4cf9f | Iustin Pop | </varlistentry> |
265 | d3b4cf9f | Iustin Pop | <varlistentry> |
266 | d3b4cf9f | Iustin Pop | <term>vcpus</term> |
267 | d3b4cf9f | Iustin Pop | <listitem> |
268 | d3b4cf9f | Iustin Pop | <simpara>the number of VCPUs to assign to the instance |
269 | d3b4cf9f | Iustin Pop | (if this value makes sense for the hypervisor)</simpara> |
270 | d3b4cf9f | Iustin Pop | </listitem> |
271 | d3b4cf9f | Iustin Pop | </varlistentry> |
272 | d3b4cf9f | Iustin Pop | <varlistentry> |
273 | d3b4cf9f | Iustin Pop | <term>auto_balance</term> |
274 | d3b4cf9f | Iustin Pop | <listitem> |
275 | d3b4cf9f | Iustin Pop | <simpara>whether the instance is considered in the N+1 |
276 | d3b4cf9f | Iustin Pop | cluster checks (enough redundancy in the cluster to |
277 | d3b4cf9f | Iustin Pop | survive a node failure)</simpara> |
278 | d3b4cf9f | Iustin Pop | </listitem> |
279 | d3b4cf9f | Iustin Pop | </varlistentry> |
280 | d3b4cf9f | Iustin Pop | </variablelist> |
281 | 8cd7cb4c | Guido Trotter | </para> |
282 | 8cd7cb4c | Guido Trotter | |
283 | 8cd7cb4c | Guido Trotter | <para> |
284 | 33ea43b6 | Iustin Pop | The <option>-t</option> options specifies the disk layout type |
285 | 33ea43b6 | Iustin Pop | for the instance. If not passed, the configuration of the |
286 | 33ea43b6 | Iustin Pop | original instance is used. The available choices are: |
287 | dd4b1106 | Iustin Pop | <variablelist> |
288 | dd4b1106 | Iustin Pop | <varlistentry> |
289 | dd4b1106 | Iustin Pop | <term>diskless</term> |
290 | dd4b1106 | Iustin Pop | <listitem> |
291 | dd4b1106 | Iustin Pop | <para> |
292 | dd4b1106 | Iustin Pop | This creates an instance with no disks. Its useful for |
293 | dd4b1106 | Iustin Pop | testing only (or other special cases). |
294 | dd4b1106 | Iustin Pop | </para> |
295 | dd4b1106 | Iustin Pop | </listitem> |
296 | dd4b1106 | Iustin Pop | </varlistentry> |
297 | dd4b1106 | Iustin Pop | <varlistentry> |
298 | dd4b1106 | Iustin Pop | <term>plain</term> |
299 | dd4b1106 | Iustin Pop | <listitem> |
300 | dd4b1106 | Iustin Pop | <para>Disk devices will be logical volumes.</para> |
301 | dd4b1106 | Iustin Pop | </listitem> |
302 | dd4b1106 | Iustin Pop | </varlistentry> |
303 | dd4b1106 | Iustin Pop | <varlistentry> |
304 | f69dab6d | Iustin Pop | <term>drbd</term> |
305 | f69dab6d | Iustin Pop | <listitem> |
306 | f69dab6d | Iustin Pop | <para> |
307 | f69dab6d | Iustin Pop | Disk devices will be drbd (version 8.x) on top of lvm |
308 | bd028152 | Iustin Pop | volumes. |
309 | f69dab6d | Iustin Pop | </para> |
310 | f69dab6d | Iustin Pop | </listitem> |
311 | f69dab6d | Iustin Pop | </varlistentry> |
312 | d3b4cf9f | Iustin Pop | <varlistentry> |
313 | d3b4cf9f | Iustin Pop | <term>file</term> |
314 | d3b4cf9f | Iustin Pop | <listitem> |
315 | d3b4cf9f | Iustin Pop | <para>Disk devices will be backed up by files, under the |
316 | d3b4cf9f | Iustin Pop | <filename |
317 | d3b4cf9f | Iustin Pop | class="directory">@RPL_FILE_STORAGE_DIR@</filename>. By |
318 | d3b4cf9f | Iustin Pop | default, each instance will get a directory (as its own |
319 | d3b4cf9f | Iustin Pop | name) under this path, and each disk is stored as |
320 | d3b4cf9f | Iustin Pop | individual files in this (instance-specific) |
321 | d3b4cf9f | Iustin Pop | directory.</para> |
322 | d3b4cf9f | Iustin Pop | </listitem> |
323 | d3b4cf9f | Iustin Pop | </varlistentry> |
324 | dd4b1106 | Iustin Pop | </variablelist> |
325 | dd4b1106 | Iustin Pop | </para> |
326 | dd4b1106 | Iustin Pop | |
327 | dd4b1106 | Iustin Pop | <para> |
328 | a53a1b18 | Michael Hanselmann | The <option>--iallocator</option> option specifies the instance |
329 | a53a1b18 | Michael Hanselmann | allocator plugin to use. If you pass in this option the allocator will |
330 | a53a1b18 | Michael Hanselmann | select nodes for this instance automatically, so you don't need to pass |
331 | a53a1b18 | Michael Hanselmann | them with the <option>-n</option> option. For more information please |
332 | a53a1b18 | Michael Hanselmann | refer to the instance allocator documentation. |
333 | a53a1b18 | Michael Hanselmann | </para> |
334 | a53a1b18 | Michael Hanselmann | |
335 | a53a1b18 | Michael Hanselmann | <para> |
336 | a53a1b18 | Michael Hanselmann | The optional second value of the <option>--node</option> is used for |
337 | d3b4cf9f | Iustin Pop | the drbd template and specifies the remote node. |
338 | c234fe4c | Guido Trotter | </para> |
339 | c234fe4c | Guido Trotter | |
340 | c234fe4c | Guido Trotter | <para> |
341 | 33ea43b6 | Iustin Pop | Since many of the parameters are by default read from the |
342 | 33ea43b6 | Iustin Pop | exported instance information and used as such, the new |
343 | 33ea43b6 | Iustin Pop | instance will have all parameters explicitly specified, the |
344 | 33ea43b6 | Iustin Pop | opposite of a newly added instance which has most parameters |
345 | 33ea43b6 | Iustin Pop | specified via cluster defaults. To change the import behaviour |
346 | 33ea43b6 | Iustin Pop | to recognize parameters whose saved value matches the current |
347 | 33ea43b6 | Iustin Pop | cluster default and mark it as such (default value), pass |
348 | 33ea43b6 | Iustin Pop | the <option>--identify-defaults</option> option. This will |
349 | 33ea43b6 | Iustin Pop | affect the hypervisor, backend and NIC parameters, both read |
350 | 33ea43b6 | Iustin Pop | from the export file and passed in via the command line. |
351 | dd4b1106 | Iustin Pop | </para> |
352 | dd4b1106 | Iustin Pop | |
353 | dd4b1106 | Iustin Pop | <para> |
354 | 33ea43b6 | Iustin Pop | Example for identical instance import: |
355 | 33ea43b6 | Iustin Pop | <screen> |
356 | 33ea43b6 | Iustin Pop | # gnt-backup import -n node1.example.com instance3.example.com |
357 | 33ea43b6 | Iustin Pop | </screen> |
358 | 33ea43b6 | Iustin Pop | </para> |
359 | 33ea43b6 | Iustin Pop | <para> |
360 | 33ea43b6 | Iustin Pop | Explicit configuration example: |
361 | dd4b1106 | Iustin Pop | <screen> |
362 | d3b4cf9f | Iustin Pop | # gnt-backup import -t plain --disk 0:size=1G -B memory=512 \ |
363 | d3b4cf9f | Iustin Pop | > -n node1.example.com \ |
364 | dd4b1106 | Iustin Pop | > instance3.example.com |
365 | dd4b1106 | Iustin Pop | </screen> |
366 | dd4b1106 | Iustin Pop | </para> |
367 | dd4b1106 | Iustin Pop | |
368 | dd4b1106 | Iustin Pop | </refsect2> |
369 | dd4b1106 | Iustin Pop | |
370 | dd4b1106 | Iustin Pop | <refsect2> |
371 | dd4b1106 | Iustin Pop | <title>LIST</title> |
372 | dd4b1106 | Iustin Pop | |
373 | dd4b1106 | Iustin Pop | <cmdsynopsis> |
374 | dd4b1106 | Iustin Pop | <command>list</command> |
375 | 59885275 | Guido Trotter | <arg>--node=<replaceable>NODE</replaceable></arg> |
376 | dd4b1106 | Iustin Pop | </cmdsynopsis> |
377 | dd4b1106 | Iustin Pop | |
378 | dd4b1106 | Iustin Pop | <para> |
379 | f69dab6d | Iustin Pop | Lists the exports currently available in the default directory |
380 | f69dab6d | Iustin Pop | in all the nodes of the current cluster, or optionally only a |
381 | 59885275 | Guido Trotter | subset of them specified using the <option>--node</option> |
382 | 59885275 | Guido Trotter | option (which can be used multiple times) |
383 | dd4b1106 | Iustin Pop | </para> |
384 | dd4b1106 | Iustin Pop | |
385 | f69dab6d | Iustin Pop | <para> |
386 | f69dab6d | Iustin Pop | Example: |
387 | f69dab6d | Iustin Pop | <screen> |
388 | f69dab6d | Iustin Pop | # gnt-backup list --nodes node1 --nodes node2 |
389 | f69dab6d | Iustin Pop | </screen> |
390 | 949bdabe | Iustin Pop | </para> |
391 | dd4b1106 | Iustin Pop | </refsect2> |
392 | dd4b1106 | Iustin Pop | |
393 | d3b4cf9f | Iustin Pop | <refsect2> |
394 | d3b4cf9f | Iustin Pop | <title>REMOVE</title> |
395 | d3b4cf9f | Iustin Pop | <cmdsynopsis> |
396 | d3b4cf9f | Iustin Pop | <command>remove</command> |
397 | d3b4cf9f | Iustin Pop | <arg choice="req">instance_name</arg> |
398 | d3b4cf9f | Iustin Pop | </cmdsynopsis> |
399 | d3b4cf9f | Iustin Pop | |
400 | d3b4cf9f | Iustin Pop | <para> |
401 | d3b4cf9f | Iustin Pop | Removes the backup for the given instance name, if any. If the |
402 | d3b4cf9f | Iustin Pop | backup was for a deleted instances, it is needed to pass the |
403 | d3b4cf9f | Iustin Pop | <acronym>FQDN</acronym> of the instance, and not only the |
404 | d3b4cf9f | Iustin Pop | short hostname. |
405 | d3b4cf9f | Iustin Pop | </para> |
406 | d3b4cf9f | Iustin Pop | |
407 | d3b4cf9f | Iustin Pop | </refsect2> |
408 | d3b4cf9f | Iustin Pop | |
409 | dd4b1106 | Iustin Pop | </refsect1> |
410 | dd4b1106 | Iustin Pop | |
411 | dd4b1106 | Iustin Pop | &footer; |
412 | dd4b1106 | Iustin Pop | |
413 | dd4b1106 | Iustin Pop | </refentry> |
414 | dd4b1106 | Iustin Pop | |
415 | dd4b1106 | Iustin Pop | <!-- Keep this comment at the end of the file |
416 | dd4b1106 | Iustin Pop | Local variables: |
417 | dd4b1106 | Iustin Pop | mode: sgml |
418 | dd4b1106 | Iustin Pop | sgml-omittag:t |
419 | dd4b1106 | Iustin Pop | sgml-shorttag:t |
420 | dd4b1106 | Iustin Pop | sgml-minimize-attributes:nil |
421 | dd4b1106 | Iustin Pop | sgml-always-quote-attributes:t |
422 | dd4b1106 | Iustin Pop | sgml-indent-step:2 |
423 | dd4b1106 | Iustin Pop | sgml-indent-data:t |
424 | dd4b1106 | Iustin Pop | sgml-parent-document:nil |
425 | dd4b1106 | Iustin Pop | sgml-default-dtd-file:nil |
426 | dd4b1106 | Iustin Pop | sgml-exposed-tags:nil |
427 | dd4b1106 | Iustin Pop | sgml-local-catalogs:nil |
428 | dd4b1106 | Iustin Pop | sgml-local-ecat-files:nil |
429 | dd4b1106 | Iustin Pop | End: |
430 | dd4b1106 | Iustin Pop | --> |