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