A.55 edit Vm

A.55 edit Vm
Prev	Appendix A CLI Command Reference	Next

Edits a virtual machine.

Syntax

edit Vm instance [memory=value] [memoryLimit=value] [cpuCountLimit=value] [cpuCount=value] [cpuPriority=value] [cpuUtilizationCap=value] [highAvailability= { yes | no }]
[osType= { WIN_2003 | WIN_2008 | WIN_7 | WIN_VISTA | OTHER_WIN | OL_4 | OL_5 | OL_6 | RHL_4 | RHL_5 | RHL_6 | LINUX_RECOVERY | OTHER_LINUX | SOLARIS_10 | SOLARIS_11 | OTHER_SOLARIS | NONE }]
[mouseType= { OS_DEFAULT | PS2_MOUSE | USB_MOUSE | USB_TABLET }]
[domainType= { XEN_HVM | XEN_HVM_PV_DRIVERS | XEN_PVM | LDOMS_PVM | UNKNOWN }]
[keymapName= { en-us | ar | da | de | de-ch | en-gb | es | et | fi | fo | fr | fr-be | fr-ca | fr-ch | hr | hu | is | it | ja | lt | lv | mk | nl | nl-be | no | pl | pt | pt-br | ru | sl | sv | th | tr }]
[bootOrder= { PXE | DISK | CDROM }] [networkBootPath=value] [name=value] [description=value]

Where instance is:

{ id=id | name=name }

Description

This command edits a virtual machine to change the configuration options.

Although none of the options are mandatory, you must supply at least one option.

Options

The following table shows the available options for this command.

Option	Description
`memory=value`	The memory size the virtual machine is allocated in MB.
`memoryLimit=value`	The maximum memory size the virtual machine can be allocated in MB.
`cpuCountLimit=value`	The maximum number of processors the virtual machine can be allocated.
`cpuCount=value`	The number of processors the virtual machine is allocated.
`cpuPriority=value`	The CPU priority of the virtual machine. A value between 1 and 100; the higher the number, the more priority the CPU is given.
`cpuUtilizationCap=value`	The maximum percentage to which the virtual CPUs can receive scheduled time. A value between 1 and 100; the higher the number, the more scheduled time the CPU is given.
`highAvailability=` { `yes` \| `no` }	Whether to enable High Availability.
`osType=` { `WIN_2003` \| `WIN_2008` \| `WIN_7` \| `WIN_VISTA` \| `OTHER_WIN` \| `OL_4` \| `OL_5` \| `OL_6` \| `RHL_4` \| `RHL_5` \| `RHL_6` \| `LINUX_RECOVERY` \| `OTHER_LINUX` \| `SOLARIS_10` \| `SOLARIS_11` \| `OTHER_SOLARIS` \| `NONE` }	The operating system of the virtual machine.
`mouseType=` { `OS_DEFAULT` \| `PS2_MOUSE` \| `USB_MOUSE` \| `USB_TABLET` }	The mouse type of the virtual machine.
`domainType=` { `XEN_HVM` \| `XEN_HVM_PV_DRIVERS` \| `XEN_PVM` \| `LDOMS_PVM` \| `UNKNOWN` }	The domain type of the virtual machine.
`keymapName=` { `en-us` \| `ar` \| `da` \| `de` \| `de-ch` \| `en-gb` \| `es` \| `et` \| `fi` \| `fo` \| `fr` \| `fr-be` \| `fr-ca` \| `fr-ch` \| `hr` \| `hu` \| `is` \| `it` \| `ja` \| `lt` \| `lv` \| `mk` \| `nl` \| `nl-be` \| `no` \| `pl` \| `pt` \| `pt-br` \| `ru` \| `sl` \| `sv` \| `th` \| `tr` }	The keyboard mapping to use for the virtual machine.
`bootOrder=` { `PXE` \| `DISK` \| `CDROM` }	The boot media order for the virtual machine. Enter options separated by commas (,), for example: `bootOrder='CDROM,DISK'` If you use the `PXE` boot option to boot from network-based installation media, also use the `networkBootPath` parameter.
`networkBootPath=value`	The location at which the installation media (mounted ISO file) is located when creating a PVM guest.
`name=value`	A name to identify the virtual machine.
`description=value`	Optional description for the virtual machine.
{ `id=id` \| `name=name` }	The instance of the object using either the `id` or `name` option, for example `name=MyVM`.

Examples

Example A.74 Edit the disk boot order a virtual machine

OVM> edit Vm name=MyVM bootOrder='CDROM,DISK'

Prev	Up	Next
A.54 edit VlanInterface	Home	A.56 edit VmDiskMapping

A.55 edit Vm

Syntax

Description

Options

Examples

See Also