Revision a53cd1f4 man/gnt-instance.rst

b/man/gnt-instance.rst
34 34
| [--net=*N* [:options...] \| --no-nics]
35 35
| [-B *BEPARAMS*]
36 36
| [-H *HYPERVISOR* [: option=*value*... ]]
37
| [-O, --os-parameters *param*=*value*... ]
37 38
| [--file-storage-dir *dir\_path*] [--file-driver {loop \| blktap}]
38 39
| {-n *node[:secondary-node]* \| --iallocator *name*}
39 40
| {-o *os-type*}
......
127 128
instance. If no such parameters are specified, the values are
128 129
inherited from the cluster. Possible parameters are:
129 130

  
130

  
131

  
132 131
memory
133 132
    the memory size of the instance; as usual, suffixes can be used to
134 133
    denote the unit, otherwise the value is taken in mebibites
......
151 150

  
152 151
The possible hypervisor options are as follows:
153 152

  
154

  
155

  
156 153
boot\_order
157 154
    Valid for the Xen HVM and KVM hypervisors.
158 155

  
......
411 408
    "tablet".
412 409

  
413 410

  
411
The ``-O`` (``--os-parameters``) option allows customisation of the OS
412
parameters. The actual parameter names and values depends on the OS
413
being used, but the syntax is the same key=value. For example, setting
414
a hypothetical ``dhcp`` parameter to yes can be achieved by::
415

  
416
    gnt-instance add -O dhcp=yes ...
417

  
418

  
414 419
The ``--iallocator`` option specifies the instance allocator plugin
415 420
to use. If you pass in this option the allocator will select nodes
416 421
for this instance automatically, so you don't need to pass them
......
853 858
|  --disk *N*:mode=*MODE*]
854 859
| [-t plain | -t drbd -n *new_secondary*]
855 860
| [--os-type=*OS* [--force-variant]]
861
| [-O, --os-parameters *param*=*value*... ]
856 862
| [--submit]
857 863
| {*instance*}
858 864

  
......
861 867
disks and NICs to/from the instance. Note that you need to give at
862 868
least one of the arguments, otherwise the command complains.
863 869

  
864
The ``-H`` option specifies hypervisor options in the form of
865
name=value[,...]. For details which options can be specified, see
866
the **add** command.
870
The ``-H``, ``-B`` and ``-O`` options specifies hypervisor, backend
871
and OS parameter options in the form of name=value[,...]. For details
872
which options can be specified, see the **add** command.
867 873

  
868 874
The ``-t`` option will change the disk template of the instance.
869 875
Currently only conversions between the plain and drbd disk templates
......
911 917

  
912 918
The ``--select-os`` option switches to an interactive OS reinstall.
913 919
The user is prompted to select the OS template from the list of
914
available OS templates. OS parameters can be overridden using
915
``-O``.
920
available OS templates. OS parameters can be overridden using ``-O``
921
(more documentation for this option under the **add** command).
916 922

  
917 923
Since this is a potentially dangerous command, the user will be
918 924
required to confirm this action, unless the ``-f`` flag is passed.

Also available in: Unified diff