Creates a guest virtual machine (VM) from an Open Virtual Appliance (OVA) file.
| 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. |
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.
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.
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
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.
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 .