Revision 735e1318 man/gnt-instance.rst

b/man/gnt-instance.rst
1365 1365
RECREATE-DISKS
1366 1366
^^^^^^^^^^^^^^
1367 1367

  
1368
**recreate-disks** [--submit] [--disks=``indices``] [-n node1:[node2]]
1369
  {*instance*}
1368
| **recreate-disks** [--submit] [-n node1:[node2]]
1369
| [--disk=*N*[:[size=*VAL*][,mode=*ro\|rw*]]] {*instance*}
1370 1370

  
1371
Recreates the disks of the given instance, or only a subset of the
1372
disks (if the option ``disks`` is passed, which must be a
1373
comma-separated list of disk indices, starting from zero).
1371
Recreates all or a subset of disks of the given instance.
1374 1372

  
1375 1373
Note that this functionality should only be used for missing disks; if
1376 1374
any of the given disks already exists, the operation will fail.  While
1377 1375
this is suboptimal, recreate-disks should hopefully not be needed in
1378 1376
normal operation and as such the impact of this is low.
1379 1377

  
1378
If only a subset should be recreated, any number of ``disk`` options can
1379
be specified. It expects a disk index and an optional list of disk
1380
parameters to change. Only ``size`` and ``mode`` can be changed while
1381
recreating disks. To recreate all disks while changing parameters on
1382
a subset only, a ``--disk`` option must be given for every disk of the
1383
instance.
1384

  
1380 1385
Optionally the instance's disks can be recreated on different
1381 1386
nodes. This can be useful if, for example, the original nodes of the
1382 1387
instance have gone down (and are marked offline), so we can't recreate
1383 1388
on the same nodes. To do this, pass the new node(s) via ``-n`` option,
1384 1389
with a syntax similar to the **add** command. The number of nodes
1385 1390
passed must equal the number of nodes that the instance currently
1386
has. Note that changing nodes is only allowed for 'all disk'
1387
replacement (when ``--disks`` is not passed).
1391
has. Note that changing nodes is only allowed when all disks are
1392
replaced, e.g. when no ``--disk`` option is passed.
1388 1393

  
1389 1394
The ``--submit`` option is used to send the job to the master daemon
1390 1395
but not wait for its completion. The job ID will be shown so that it

Also available in: Unified diff