You are here: Supporting Documents > everRun Enterprise Command Line Interface Reference > AVCLI Command Descriptions > vm-import

vm-import

Usage

avcli vm-import --archive filename.ova [--no-auto-start] [--cpu number] [--memory size] [--name vm-name] [--storage-groups groups] [--interfaces networks] [--volumes volumes] [--data] [--force] [--silent] [--dry-run] [--throttle] [--use-https]

Description

The vm-import command imports a VM from an OVA or OVF VM archive file.

Options

--archive filename.ova The OVA or OVF file archive to import.
--no-auto-start Do not start the VM after the import has finished.
--cpu number

The number of CPUs to assign to the VM. This defaults to the value in the archive.

--memory size The size of memory, in megabytes, to assign to the VM. This defaults to the value in the archive.
--name vm-name The name to assign to the VM. This defaults to the value in the archive.
--storage-groups groups The list of storage groups to use for allocating the VM's volumes. By default, all available storage groups are used. Allocation occurs in a round-robin fashion.
--interfaces networks The list of shared networks to assign to the VM's interfaces. By default, values in the archive or available shared networks are assigned.
--volumes volumes Import only these volumes. By default, all available volumes from the OVF are imported.
--data Import data only for the specified volumes.
--force When the OVF file is missing the isBootable flag (a known issue for Windows XP), assume that the VHD pointed to by OVF is the bootable one.
--silent Suppress output.
--dry-run Show the interface to the shared network and volume-to-storage-group assignments without actually importing or restoring a VM.
--throttle

Slow down the import/export operation. Valid values are:

  • none: Do not use throttling. This is the default value.
  • low: Slow down by about 25%.
  • medium: Slow down by about 50%.
  • high: Slow down by about 75%.
--use-https Use secure HTTPS transport instead of the default streaming method (HTTP transport). Streaming over HTTPS provides slower performance than HTTP but is much more secure.

Examples

$ avcli vm-import --archive vm1.ova
$ avcli vm-import --archive vm1.ovf
$ avcli vm-import --name myVM --throttle low --archive vm1.ovf
$ avcli vm-import --cpu 2 --memory 1024 --archive vm1.ovf
$ avcli vm-import --interfaces network0 network1 --archive vm1.ovf
$ avcli vm-import --storage-groups sm-0000 sm-0001 --archive vm1.ovf
$ avcli vm-import --volumes boot_vol vol3 --data vol3 --archive vm1.ovf
of