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