X-Git-Url: https://code.grnet.gr/git/ganeti-local/blobdiff_plain/ff39194fa68040b33c6dd05da02a01d62b0919a2..f5720846bac577abfa565b6ab1c75871da562c65:/man/gnt-instance.rst diff --git a/man/gnt-instance.rst b/man/gnt-instance.rst index 6d3c1ba..9c7c2a6 100644 --- a/man/gnt-instance.rst +++ b/man/gnt-instance.rst @@ -84,7 +84,7 @@ the resolver (e.g. in DNS or /etc/hosts, depending on your setup). Since the name check is used to compute the IP address, if you pass this option you must also pass the ``--no-ip-check`` option. -If you don't wat the instance to automatically start after +If you don't want the instance to automatically start after creation, this is possible via the ``--no-start`` option. This will leave the instance down until a subsequent **gnt-instance start** command. @@ -190,9 +190,11 @@ boot\_order as 'dc'. For KVM the boot order is either "floppy", "cdrom", "disk" or - "network". Please note that older versions of KVM couldn't - netboot from virtio interfaces. This has been fixed in more recent - versions and is confirmed to work at least with qemu-kvm 0.11.1. + "network". Please note that older versions of KVM couldn't netboot + from virtio interfaces. This has been fixed in more recent versions + and is confirmed to work at least with qemu-kvm 0.11.1. Also note + that if you have set the ``kernel_path`` option, that will be used + for booting, and this setting will be silently ignored. blockdev\_prefix Valid for the Xen HVM and PVM hypervisors. @@ -256,7 +258,7 @@ cdrom\_disk\_type This parameter determines the way the cdroms disks are presented to the instance. The default behavior is to get the same value of - the eariler parameter (disk_type). The possible options are: + the earlier parameter (disk_type). The possible options are: - paravirtual - ide @@ -411,9 +413,10 @@ kernel\_path Valid for the Xen PVM and KVM hypervisors. This option specifies the path (on the node) to the kernel to boot - the instance with. Xen PVM instances always require this, while - for KVM if this option is empty, it will cause the machine to load - the kernel from its disks. + the instance with. Xen PVM instances always require this, while for + KVM if this option is empty, it will cause the machine to load the + kernel from its disks (and the boot will be done accordingly to + ``boot_order``). kernel\_args Valid for the Xen PVM and KVM hypervisors. @@ -506,7 +509,7 @@ mem\_path use\_chroot Valid for the KVM hypervisor. - This boolean option determines wether to run the KVM instance in a + This boolean option determines whether to run the KVM instance in a chroot directory. If it is set to ``true``, an empty directory is created before @@ -712,7 +715,7 @@ hypervisor mac, ip, mode, link Specifications for the one NIC that will be created for the - instance. 'bridge' is also accepted as a backwards compatibile + instance. 'bridge' is also accepted as a backwards compatible key. nics @@ -893,8 +896,8 @@ MODIFY | [{-H|\--hypervisor-parameters} *HYPERVISOR\_PARAMETERS*] | [{-B|\--backend-parameters} *BACKEND\_PARAMETERS*] | [{-m|\--runtime-memory} *SIZE*] -| [\--net add*[:options]* \| \--net remove \| \--net *N:options*] -| [\--disk add:size=*SIZE*[,vg=*VG*][,metavg=*VG*] \| \--disk remove \| +| [\--net add*[:options]* \| \--net [*N*:]remove \| \--net *N:options*] +| [\--disk add:size=*SIZE*[,vg=*VG*][,metavg=*VG*] \| \--disk [*N*:]remove \| | \--disk *N*:mode=*MODE*] | [{-t|\--disk-template} plain | {-t|\--disk-template} drbd -n *new_secondary*] [\--no-wait-for-sync] | [\--os-type=*OS* [\--force-variant]] @@ -1085,7 +1088,7 @@ case the more than one instance will be affected. The ``--no-remember`` option will perform the startup but not change the state of the instance in the configuration file (if it was stopped -before, Ganeti will still thinks it needs to be stopped). This can be +before, Ganeti will still think it needs to be stopped). This can be used for testing, or for a one shot-start where you don't want the watcher to restart the instance if it crashes. @@ -1250,10 +1253,10 @@ REPLACE-DISKS [\--disks *idx*] {*instance*} **replace-disks** [\--submit] [\--early-release] [\--ignore-ipolicy] -{\--iallocator *name* \| \--node *node* } {*instance*} +{{-I\|\--iallocator} *name* \| {{-n|\--new-secondary} *node* } {*instance*} **replace-disks** [\--submit] [\--early-release] [\--ignore-ipolicy] -{\--auto} {*instance*} +{-a\|\--auto} {*instance*} This command is a generalized form for replacing disks. It is currently only valid for the mirrored (DRBD) disk template. @@ -1526,7 +1529,7 @@ viewed with the **gnt-cluster info** command). If the ``--cleanup`` option is passed, the operation changes from migration to attempting recovery from a failed previous migration. In this mode, Ganeti checks if the instance runs on the correct node (and -updates its configuration if not) and ensures the instances's disks +updates its configuration if not) and ensures the instances' disks are configured correctly. In this mode, the ``--non-live`` option is ignored. @@ -1544,6 +1547,9 @@ The ``--no-runtime-changes`` option forbids migrate to alter an instance's runtime before migrating it (eg. ballooning an instance down because the target node doesn't have enough available memory). +If an instance has the backend parameter ``always\_failover`` set to +true, then the migration is automatically converted into a failover. + See **ganeti(7)** for a description of ``--submit`` and other common options.