| 21 |
21 |
<year>2007</year>
|
| 22 |
22 |
<year>2008</year>
|
| 23 |
23 |
<year>2009</year>
|
|
24 |
<year>2010</year>
|
| 24 |
25 |
<holder>Google Inc.</holder>
|
| 25 |
26 |
</copyright>
|
| 26 |
27 |
&dhdate;
|
| ... | ... | |
| 29 |
30 |
&dhucpackage;
|
| 30 |
31 |
|
| 31 |
32 |
&dhsection;
|
| 32 |
|
<refmiscinfo>ganeti 2.0</refmiscinfo>
|
|
33 |
<refmiscinfo>ganeti 2.1</refmiscinfo>
|
| 33 |
34 |
</refmeta>
|
| 34 |
35 |
<refnamediv>
|
| 35 |
36 |
<refname>&dhpackage;</refname>
|
| ... | ... | |
| 135 |
136 |
<arg>--src-dir=<replaceable>source-dir</replaceable></arg>
|
| 136 |
137 |
<sbr>
|
| 137 |
138 |
|
| 138 |
|
<arg choice="req">-t<group>
|
|
139 |
<arg choice="opt">-t<group>
|
| 139 |
140 |
<arg>diskless</arg>
|
| 140 |
141 |
<arg>plain</arg>
|
| 141 |
142 |
<arg>drbd</arg>
|
| ... | ... | |
| 143 |
144 |
</group></arg>
|
| 144 |
145 |
<sbr>
|
| 145 |
146 |
|
|
147 |
<arg choice="opt">--identify-defaults</arg>
|
|
148 |
<sbr>
|
|
149 |
|
| 146 |
150 |
<arg choice="req"><replaceable>instance</replaceable></arg>
|
| 147 |
151 |
</cmdsynopsis>
|
|
152 |
|
| 148 |
153 |
<para>
|
| 149 |
154 |
Imports a new instance from an export residing on
|
| 150 |
155 |
<replaceable>source-node</replaceable> in
|
| ... | ... | |
| 159 |
164 |
<para>
|
| 160 |
165 |
The <option>disk</option> option specifies the parameters for
|
| 161 |
166 |
the disks of the instance. The numbering of disks starts at
|
| 162 |
|
zero, and at least one disk needs to be passed. For each disk,
|
| 163 |
|
at least the size needs to be given, and optionally the access
|
| 164 |
|
mode (read-only or the default of read-write) can also be
|
| 165 |
|
specified. The size is interpreted (when no unit is given) in
|
| 166 |
|
mebibytes. You can also use one of the suffixes
|
|
167 |
zero. For each disk, at least the size needs to be given, and
|
|
168 |
optionally the access mode (read-only or the default of
|
|
169 |
read-write) can also be specified. The size is interpreted
|
|
170 |
(when no unit is given) in mebibytes. You can also use one of
|
|
171 |
the suffixes
|
| 167 |
172 |
<literal>m</literal>, <literal>g</literal> or
|
| 168 |
173 |
<literal>t</literal> to specificy the exact the units used;
|
| 169 |
174 |
these suffixes map to mebibytes, gibibytes and tebibytes.
|
| ... | ... | |
| 177 |
182 |
</para>
|
| 178 |
183 |
|
| 179 |
184 |
<para>
|
| 180 |
|
The minimum disk specification is therefore
|
|
185 |
If no disk information is passed, the disk configuration saved
|
|
186 |
at export time will be used.
|
|
187 |
</para>
|
|
188 |
|
|
189 |
<para>
|
|
190 |
The minimum disk specification is therefore empty (export
|
|
191 |
information will be used), a single disk can be specified as
|
| 181 |
192 |
<userinput>--disk 0:size=20G</userinput> (or <userinput>-s
|
| 182 |
193 |
20G</userinput> when using the <option>-s</option> option),
|
| 183 |
194 |
and a three-disk instance can be specified as
|
| ... | ... | |
| 187 |
198 |
|
| 188 |
199 |
<para>
|
| 189 |
200 |
The NICs of the instances can be specified via the
|
| 190 |
|
<option>--net</option> option. By default, one NIC is created
|
| 191 |
|
for the instance, with the MAC set to the original MAC of the
|
| 192 |
|
instance (as it was at export time). Each NIC can take up to
|
| 193 |
|
three parameters (all optional):
|
|
201 |
<option>--net</option> option. By default, the NIC
|
|
202 |
configuration of the original (exported) instance will be
|
|
203 |
reused. Each NIC can take up to three parameters (all
|
|
204 |
optional):
|
| 194 |
205 |
<variablelist>
|
| 195 |
206 |
<varlistentry>
|
| 196 |
207 |
<term>mac</term>
|
| ... | ... | |
| 232 |
243 |
</para>
|
| 233 |
244 |
|
| 234 |
245 |
<para>
|
| 235 |
|
Alternatively, if no network is desired for the instance, you
|
| 236 |
|
can prevent the default of one NIC with the
|
| 237 |
|
<option>--no-nics</option> option.
|
|
246 |
If no network is desired for the instance, you should create a
|
|
247 |
single empty NIC and delete it afterwards
|
|
248 |
via <command>gnt-instance modify --net delete</command>.
|
| 238 |
249 |
</para>
|
| 239 |
250 |
|
| 240 |
251 |
<para>
|
| 241 |
252 |
The <option>-B</option> option specifies the backend
|
| 242 |
253 |
parameters for the instance. If no such parameters are
|
| 243 |
|
specified, the values are inherited from the cluster. Possible
|
|
254 |
specified, the values are inherited from the export. Possible
|
| 244 |
255 |
parameters are:
|
| 245 |
256 |
<variablelist>
|
| 246 |
257 |
<varlistentry>
|
| ... | ... | |
| 270 |
281 |
</para>
|
| 271 |
282 |
|
| 272 |
283 |
<para>
|
| 273 |
|
The <option>-t</option> options specifies the disk layout type for
|
| 274 |
|
the instance. The available choices are:
|
|
284 |
The <option>-t</option> options specifies the disk layout type
|
|
285 |
for the instance. If not passed, the configuration of the
|
|
286 |
original instance is used. The available choices are:
|
| 275 |
287 |
<variablelist>
|
| 276 |
288 |
<varlistentry>
|
| 277 |
289 |
<term>diskless</term>
|
| ... | ... | |
| 326 |
338 |
</para>
|
| 327 |
339 |
|
| 328 |
340 |
<para>
|
| 329 |
|
If you do not want gnt-backup to wait for the disk mirror
|
| 330 |
|
to be synced, use the <option>--no-wait-for-sync</option>
|
| 331 |
|
option.
|
|
341 |
Since many of the parameters are by default read from the
|
|
342 |
exported instance information and used as such, the new
|
|
343 |
instance will have all parameters explicitly specified, the
|
|
344 |
opposite of a newly added instance which has most parameters
|
|
345 |
specified via cluster defaults. To change the import behaviour
|
|
346 |
to recognize parameters whose saved value matches the current
|
|
347 |
cluster default and mark it as such (default value), pass
|
|
348 |
the <option>--identify-defaults</option> option. This will
|
|
349 |
affect the hypervisor, backend and NIC parameters, both read
|
|
350 |
from the export file and passed in via the command line.
|
| 332 |
351 |
</para>
|
| 333 |
352 |
|
| 334 |
353 |
<para>
|
| 335 |
|
Example:
|
|
354 |
Example for identical instance import:
|
|
355 |
<screen>
|
|
356 |
# gnt-backup import -n node1.example.com instance3.example.com
|
|
357 |
</screen>
|
|
358 |
</para>
|
|
359 |
<para>
|
|
360 |
Explicit configuration example:
|
| 336 |
361 |
<screen>
|
| 337 |
362 |
# gnt-backup import -t plain --disk 0:size=1G -B memory=512 \
|
| 338 |
363 |
> -n node1.example.com \
|