A.51 create Vm

Creates a virtual machine.

Syntax

create Vm [ 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 ] repository=value [ server=value ] [ startPolicy= { BEST_SERVER | CURRENT_SERVER | USE_POOL_POLICY } ] name=value [ description=value ] on ServerPool instance

Where instance is:

{ id=value | name=value }

Description

This command creates a virtual machine.

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.

repository=value

The name or ID of the storage repository in which to create the virtual machine configuration file.

server=value

The name or ID of the Oracle VM Server on which to create the virtual machine.

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=MyServer.

Note

Any create command only creates a single instance of an object, and therefore only accepts a single object instance as an attribute. Providing more than one object of the same attribute type as a parameter always results in the last attribute value taking precedence.

Examples

Example A.67 Creating a virtual machine

OVM> create Vm name=MyVM repository=MyRepository domainType=XEN_HVM \ 
  server=MyServer startPolicy=USE_POOL_POLICY on ServerPool name=MyServerPool

See Also