Revision 13ddcb50 man/gnt-instance.rst

b/man/gnt-instance.rst
628 628
    better performance. Especially if you use a network file system
629 629
    (e.g. NFS) to store your instances this is the recommended choice.
630 630

  
631

  
632
The ``--submit`` option is used to send the job to the master daemon
633
but not wait for its completion. The job ID will be shown so that it
634
can be examined via **gnt-job info**.
635

  
636 631
If ``--ignore-ipolicy`` is given any instance policy violations occuring
637 632
during this operation are ignored.
638 633

  
634
See **ganeti(7)** for a description of ``--submit`` and other common
635
options.
636

  
639 637
Example::
640 638

  
641 639
    # gnt-instance add -t file --disk 0:size=30g -B maxmem=512 -o debian-etch \
......
761 759
kvm process for KVM, etc.). By default two minutes are given to each
762 760
instance to stop.
763 761

  
764
The ``--submit`` option is used to send the job to the master daemon
765
but not wait for its completion. The job ID will be shown so that it
766
can be examined via **gnt-job info**.
767

  
768 762
The ``--force`` option is used to skip the interactive confirmation.
769 763

  
764
See **ganeti(7)** for a description of ``--submit`` and other common
765
options.
766

  
770 767
Example::
771 768

  
772 769
    # gnt-instance remove instance1.example.com
......
927 924
changes instance's state to ``down``. These modifications take effect
928 925
immediately.
929 926

  
930
The ``--submit`` option is used to send the job to the master daemon
931
but not wait for its completion. The job ID will be shown so that it
932
can be examined via **gnt-job info**.
933

  
934 927
If ``--ignore-ipolicy`` is given any instance policy violations occuring
935 928
during this operation are ignored.
936 929

  
930
See **ganeti(7)** for a description of ``--submit`` and other common
931
options.
932

  
937 933
Most of the changes take effect at the next restart. If the instance is
938 934
running, there is no effect on the instance.
939 935

  
......
962 958
or ``--all`` options), the user must pass the ``--force-multiple``
963 959
options to skip the interactive confirmation.
964 960

  
965
The ``--submit`` option is used to send the job to the master daemon
966
but not wait for its completion. The job ID will be shown so that it
967
can be examined via **gnt-job info**.
961
See **ganeti(7)** for a description of ``--submit`` and other common
962
options.
968 963

  
969 964
RENAME
970 965
^^^^^^
......
985 980
is used to compute the IP address, if you pass this option you must also
986 981
pass the ``--no-ip-check`` option.
987 982

  
988
The ``--submit`` option is used to send the job to the master daemon
989
but not wait for its completion. The job ID will be shown so that it
990
can be examined via **gnt-job info**.
983
See **ganeti(7)** for a description of ``--submit`` and other common
984
options.
991 985

  
992 986
Starting/stopping/connecting to console
993 987
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
......
1075 1069
that is the actual instance memory size already). Note that the values
1076 1070
override the instance parameters (and not extend them): an instance
1077 1071
with "kernel\_args=ro" when started with -H kernel\_args=single will
1078
result in "single", not "ro single".  The ``--submit`` option is used
1079
to send the job to the master daemon but not wait for its
1080
completion. The job ID will be shown so that it can be examined via
1081
**gnt-job info**.
1072
result in "single", not "ro single".
1082 1073

  
1083 1074
The ``--paused`` option is only valid for Xen and kvm hypervisors.  This
1084 1075
pauses the instance at the start of bootup, awaiting ``gnt-instance
1085 1076
console`` to unpause it, allowing the entire boot process to be
1086 1077
monitored for debugging.
1087 1078

  
1079
See **ganeti(7)** for a description of ``--submit`` and other common
1080
options.
1081

  
1088 1082
Example::
1089 1083

  
1090 1084
    # gnt-instance start instance1.example.com
......
1118 1112
``--sec-node-tags`` options are similar as for the **startup** command
1119 1113
and they influence the actual instances being shutdown.
1120 1114

  
1121
The ``--submit`` option is used to send the job to the master daemon
1122
but not wait for its completion. The job ID will be shown so that it
1123
can be examined via **gnt-job info**.
1124

  
1125 1115
``--ignore-offline`` can be used to ignore offline primary nodes and
1126 1116
force the instance to be marked as stopped. This option should be used
1127 1117
with care as it can lead to an inconsistent cluster state.
......
1135 1125
``--no-remember``, and when the watcher is activated again it will
1136 1126
restore the correct runtime state for all instances.
1137 1127

  
1128
See **ganeti(7)** for a description of ``--submit`` and other common
1129
options.
1130

  
1138 1131
Example::
1139 1132

  
1140 1133
    # gnt-instance shutdown instance1.example.com
......
1177 1170
The ``--force-multiple`` will skip the interactive confirmation in the
1178 1171
case the more than one instance will be affected.
1179 1172

  
1173
See **ganeti(7)** for a description of ``--submit`` and other common
1174
options.
1175

  
1180 1176
Example::
1181 1177

  
1182 1178
    # gnt-instance reboot instance1.example.com
......
1242 1238
the new secondary node will be the one chosen manually via the
1243 1239
``--new-secondary`` option.
1244 1240

  
1241
Note that it is not possible to select an offline or drained node as a
1242
new secondary.
1243

  
1245 1244
The fourth form (when using ``--auto``) will automatically determine
1246 1245
which disks of an instance are faulty and replace them within the same
1247 1246
node. The ``--auto`` option works only when an instance has only
1248 1247
faulty disks on either the primary or secondary node; it doesn't work
1249 1248
when both sides have faulty disks.
1250 1249

  
1251
The ``--submit`` option is used to send the job to the master daemon
1252
but not wait for its completion. The job ID will be shown so that it
1253
can be examined via **gnt-job info**.
1254

  
1255 1250
The ``--early-release`` changes the code so that the old storage on
1256 1251
secondary node(s) is removed early (before the resync is completed)
1257 1252
and the internal Ganeti locks for the current (and new, if any)
......
1265 1260
violations if replace-disks changes groups and the instance would
1266 1261
violate the new groups instance policy.
1267 1262

  
1268
Note that it is not possible to select an offline or drained node as a
1269
new secondary.
1263
See **ganeti(7)** for a description of ``--submit`` and other common
1264
options.
1270 1265

  
1271 1266
ACTIVATE-DISKS
1272 1267
^^^^^^^^^^^^^^
......
1284 1279
the devices have been activated. The *disk/0* and *disk/1* are the
1285 1280
Ganeti-names of the instance disks; how they are visible inside the
1286 1281
instance is hypervisor-specific. */dev/drbd0* and */dev/drbd1* are the
1287
actual block devices as visible on the node.  The ``--submit`` option
1288
is used to send the job to the master daemon but not wait for its
1289
completion. The job ID will be shown so that it can be examined via
1290
**gnt-job info**.
1282
actual block devices as visible on the node.
1291 1283

  
1292 1284
The ``--ignore-size`` option can be used to activate disks ignoring
1293 1285
the currently configured size in Ganeti. This can be used in cases
......
1299 1291
Note that it is safe to run this command while the instance is already
1300 1292
running.
1301 1293

  
1294
See **ganeti(7)** for a description of ``--submit`` and other common
1295
options.
1296

  
1302 1297
DEACTIVATE-DISKS
1303 1298
^^^^^^^^^^^^^^^^
1304 1299

  
......
1317 1312
the disks. This can still fail due to the instance actually running or
1318 1313
other issues.
1319 1314

  
1320
The ``--submit`` option is used to send the job to the master daemon
1321
but not wait for its completion. The job ID will be shown so that it
1322
can be examined via **gnt-job info**.
1315
See **ganeti(7)** for a description of ``--submit`` and other common
1316
options.
1323 1317

  
1324 1318
GROW-DISK
1325 1319
^^^^^^^^^
1326 1320

  
1327
**grow-disk** [\--no-wait-for-sync] [\--submit] {*instance*} {*disk*}
1328
{*amount*}
1321
| **grow-disk** [\--no-wait-for-sync] [\--submit] {*instance*} {*disk*}
1322
| {*amount*}
1329 1323

  
1330 1324
Grows an instance's disk. This is only possible for instances having a
1331 1325
plain, drbd or rbd disk template.
......
1356 1350
If you do not want gnt-instance to wait for the new disk region to be
1357 1351
synced, use the ``--no-wait-for-sync`` option.
1358 1352

  
1359
The ``--submit`` option is used to send the job to the master daemon
1360
but not wait for its completion. The job ID will be shown so that it
1361
can be examined via **gnt-job info**.
1353
See **ganeti(7)** for a description of ``--submit`` and other common
1354
options.
1362 1355

  
1363 1356
Example (increase the first disk for instance1 by 16GiB)::
1364 1357

  
......
1398 1391
has. Note that changing nodes is only allowed when all disks are
1399 1392
replaced, e.g. when no ``--disk`` option is passed.
1400 1393

  
1401
The ``--submit`` option is used to send the job to the master daemon
1402
but not wait for its completion. The job ID will be shown so that it
1403
can be examined via **gnt-job info**.
1394
See **ganeti(7)** for a description of ``--submit`` and other common
1395
options.
1404 1396

  
1405 1397
Recovery
1406 1398
~~~~~~~~
......
1440 1432
process, for kvm). By default two minutes are given to each instance
1441 1433
to stop.
1442 1434

  
1443
The ``--submit`` option is used to send the job to the master daemon
1444
but not wait for its completion. The job ID will be shown so that it
1445
can be examined via **gnt-job info**.
1446

  
1447 1435
If ``--ignore-ipolicy`` is given any instance policy violations occuring
1448 1436
during this operation are ignored.
1449 1437

  
1438
See **ganeti(7)** for a description of ``--submit`` and other common
1439
options.
1440

  
1450 1441
Example::
1451 1442

  
1452 1443
    # gnt-instance failover instance1.example.com
......
1537 1528
MOVE
1538 1529
^^^^
1539 1530

  
1540
**move** [-f] [\--ignore-consistency]
1541
[-n *node*] [\--shutdown-timeout=*N*] [\--submit] [\--ignore-ipolicy]
1542
{*instance*}
1531
| **move** [-f] [\--ignore-consistency]
1532
| [-n *node*] [\--shutdown-timeout=*N*] [\--submit] [\--ignore-ipolicy]
1533
| {*instance*}
1543 1534

  
1544 1535
Move will move the instance to an arbitrary node in the cluster.  This
1545 1536
works only for instances having a plain or file disk template.
......
1557 1548
in trying to shutdown the instance on its node; useful if the
1558 1549
hypervisor is broken and you want to recuperate the data.
1559 1550

  
1560
The ``--submit`` option is used to send the job to the master daemon
1561
but not wait for its completion. The job ID will be shown so that it
1562
can be examined via **gnt-job info**.
1563

  
1564 1551
If ``--ignore-ipolicy`` is given any instance policy violations occuring
1565 1552
during this operation are ignored.
1566 1553

  
1554
See **ganeti(7)** for a description of ``--submit`` and other common
1555
options.
1556

  
1567 1557
Example::
1568 1558

  
1569 1559
    # gnt-instance move -n node3.example.com instance1.example.com

Also available in: Unified diff