X-Git-Url: https://code.grnet.gr/git/ganeti-local/blobdiff_plain/c0e4a2c3d28e2a7d534d36d4b57c0e8481712b73..1b54fc6c2fd92b614c029cc5312d02f9f1526253:/man/gnt-instance.sgml?ds=sidebyside diff --git a/man/gnt-instance.sgml b/man/gnt-instance.sgml index d50fb65..2d9d44f 100644 --- a/man/gnt-instance.sgml +++ b/man/gnt-instance.sgml @@ -428,6 +428,29 @@ + kernel_args + + Valid for the Xen PVM and KVM hypervisors. + + + This options specifies extra arguments to the kernel + that will be loaded. device. This is always used + for Xen PVM, while for KVM it is only used if the + option is also + specified. + + + + The default setting for this value is simply + "ro", which mounts the root + disk (initially) in read-only one. For example, + setting this to single will + cause the instance to start in single-user mode. + + + + + initrd_path Valid for the Xen PVM and KVM hypervisors. @@ -437,7 +460,10 @@ initrd to boot the instance with. Xen PVM instances can use this always, while for KVM if this option is only used if the option - is also specified. + is also specified. You can pass here either an + absolute filename (the path to the initrd) if you + want to use an initrd, or use the format + no_initrd_path for no initrd. @@ -1095,14 +1121,17 @@ instance5: 11225 -s --static - instance + + --all + instance + - Show detailed information about the (given) instances. This - is different from list as it shows - detailed data about the instance's disks (especially useful - for drbd disk template). + Show detailed information about the given instance(s). This is + different from list as it shows detailed data + about the instance's disks (especially useful for the drbd disk + template). @@ -1110,6 +1139,11 @@ instance5: 11225 available in the configuration file is returned, without querying nodes, making the operation faster. + + + Use the to get info about all instances, + rather than explicitely passing the ones you're interested in. + @@ -1195,17 +1229,26 @@ instance5: 11225 reinstall -o os-type - -f force --select-os + -f force + --force-multiple + + + --instance + --node + --primary + --secondary + --all + --submit - instance + instance - Reinstalls the operating system on the given instance. The instance - must be stopped when running this command. If the - is specified, the operating system is - changed. + Reinstalls the operating system on the given instance(s). The + instance(s) must be stopped when running this command. If the + is specified, the operating + system is changed. @@ -1215,6 +1258,19 @@ instance5: 11225 + Since this is a potentially dangerous command, the user will + be required to confirm this action, unless the + flag is passed. When multiple instances + are selected (either by passing multiple arguments or by + using the , + , or + options), the user must pass both the + and + options to skip the + interactive confirmation. + + + The option is used to send the job to the master daemon but not wait for its completion. The job ID will be shown so that it can be examined via @@ -1265,7 +1321,6 @@ instance5: 11225 startup - --extra=PARAMS --force --force-multiple @@ -1278,6 +1333,9 @@ instance5: 11225 --all + -H + -B + --submit - The option is used to pass - additional argument to the instance's kernel for this start - only. Currently there is no way to specify a persistent set - of arguments (beside the one hardcoded). Note that this may - not apply to all virtualization types. - - - Use to start even if secondary disks are failing. @@ -1355,6 +1405,23 @@ instance5: 11225 + The and options + specify extra, temporary hypervisor and backend parameters + that can be used to start an instance with modified + parameters. They can be useful for quick testing without + having to modify an instance back and forth, e.g.: + +# gnt-instance start -H root_args="single" instance1 +# gnt-instance start -B memory=2048 instance2 + + The first form will start the instance + instance1 in single-user mode, and + the instance instance2 with 2GB of + RAM (this time only, unless that is the actual instance + memory size already). + + + The option is used to send the job to the master daemon but not wait for its completion. The job ID will be shown so that it can be examined via @@ -1365,7 +1432,6 @@ instance5: 11225 Example: # gnt-instance start instance1.example.com -# gnt-instance start --extra single test1.example.com # gnt-instance start --node node1.example.com node2.example.com # gnt-instance start --all @@ -1432,8 +1498,6 @@ instance5: 11225 reboot - --extra=PARAMS - --type=REBOOT-TYPE --ignore-secondaries @@ -1536,6 +1600,7 @@ instance5: 11225 replace-disks --submit -p + --disks idx instance @@ -1543,6 +1608,7 @@ instance5: 11225 replace-disks --submit -s + --disks idx instance @@ -1558,16 +1624,22 @@ instance5: 11225 - This command is a generalized form for adding and replacing - disks. It is currently only valid for the mirrored (DRBD) - disk template. + This command is a generalized form for replacing disks. It + is currently only valid for the mirrored (DRBD) disk + template. The first form (when passing the option) will replace the disks on the primary, while the second form (when passing the option will replace - the disks on the secondary node. + the disks on the secondary node. For these two cases (as the + node doesn't change), it is possible to only run the replace + for a subset of the disks, using the option + which takes a list of + comma-delimited disk indices (zero-based), + e.g. 0,2 to replace only the first + and third disks.