A.90 edit Vm

Edits a virtual machine.

Syntax

edit Vm instance [ memory=value ] [ memoryLimit=value ] [ cpuCount=value ] [ cpuCountLimit=value ] [ cpuPriority=value ] [ cpuUtilizationCap=value ] [ highAvailability= { Yes | No } ] [ hugePagesEnabled= { Yes | No } ] [ osType=value ] [ 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 } ] [ networkInstallpath=value ] [ startPolicy= { BEST_SERVER | CURRENT_SERVER | USE_POOL_POLICY } ] [ name=value ] [ description=value ]

Where instance is:

{ id=value | name=value }

Description

This command edits the attributes of 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. May be an integer between 32 and 2000000.

memoryLimit=value

The maximum memory size the virtual machine can be allocated in MB. May be an integer between 32 and 2000000.

cpuCount=value

The number of processors the virtual machine is allocated. May be an integer between 1 and 128.

cpuCountLimit=value

The maximum number of processors the virtual machine can be allocated. May be an integer between 1 and 128.

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 10 and 100; the higher the number, the more scheduled time the CPU is given.

highAvailability= { Yes | No }

Whether to enable High Availability (HA).

hugePagesEnabled= { Yes | No }

Whether to enable HugePages. If you enable HugePages, you should also enable support for HugePages in the guest operating system. This option must only be used for virtual machines that have their domain type set to XEN_PVM. More information on Huge Page support is provided in How are Huge Pages Enabled for Virtual Machines? in the Oracle VM Concepts Guide.

osType= value

The operating system of the virtual machine. To find the operating system type, use the getVmOsTypes command.

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 networkInstallpath parameter.

networkInstallpath=value

The location at which the installation media (mounted ISO file) is located when creating a PVM guest.

startPolicy= { BEST_SERVER | CURRENT_SERVER | USE_POOL_POLICY }

Optional virtual machine start up policy.

name=value

A name to identify the virtual machine.

description=value

Optional description for the virtual machine. value is a maximum of 4,000 characters.

{ id=value | name=value }

The instance of the object using either the id or name option, for example name=MyVM.

Examples

Example A.115 Edit a virtual machine

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

See Also