create vm ova

create vm vm_name ova ova_file {memory memory_size} {cpus num_cpus} {slot slot_ID} {vnc [none | vnc_display]}

Description

Creates a guest virtual machine (VM) from an Open Virtual Appliance (OVA) file.

Syntax Description

vm Designates creating a virtual machine.
vm_name Specifies the VM name.
ova Designates using an OVA file to create the VM.
ova_file Specifies the OVA file to use.
memory Designates specifying the amount of RAM allocated to the VM.
memory_size Specifies the amount of RAM (in MB) allocated to the VM. The default is 4,096.
cpus Designates specifying the number of CPUs to allocate to the VM.
num_cpus Specifies the number of CPUs to allocate to the VM. Range is 1–2. The default is 1.
slot Specifies assigning the VM to run on a slot.
slot_ID Specifies the slot number that the VM will run on.
vnc Specifies providing a display number for VNC access.
none Disables VNC access (default).
vnc_display Specifies the VNC screen number. Range is 0–15.

Default

The default memory size to run the VM on is 4,096 MB.

The default number of CPUs to allocate to the VM is one.

By default, VNC access is disabled.

Usage Guidelines

If the VM storage device has not been initialized when this command is run, you are prompted to run the clear vm storage command to initiate partitioning, file system creation, and initialization of the file/directory structure on the device.

Compatibility issues may occur when using third-party OVA files. The image format qcow2 is generally more reliable.

The Integrated Application Hosting (IAH) feature requires the Solid State Storage Device SSD-120.

For the VNC display number (or screen number), you can use the values from 0 to 15. These correspond to TCP ports 5,900 to 5,915. Multiple VMs can be configured with the same VNC display, but VMs configured with the same display number cannot run at the same time. A VM cannot be started if the VNC port is already in use. For security reasons, the VNC display is only accessible using SSH tunnel. VNC cannot be configured on non-primary stack nodes.

Example

The following example creates a VM called "vm1" with OVA file "my_ova" with 2,000 MB as the amount of RAM allocated to the VM:

# create vm vm1 ova my_ova memory 2000

History

This command was first available in ExtremeXOS 30.3.

VNC capability was added in ExtremeXOS 30.5.

Stacking support was added in ExtremeXOS 30.6.

Platform Availability

This command is available on all platforms that support the Integrated Application Hosting (IAH) feature and have a Core or Premier license installed. For a list of platforms that support the IAH feature and for information about licenses, see the ExtremeXOS 32.1 Feature License Requirements .