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

vm-restore

Usage

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

Description

The vm-restore command restores a VM from an OVA or OVF file.

Options

--archive filename.ova The OVA or OVF file archive to restore.
--no-auto-start Do not start the VM after the restore 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.
--volume-prefix prefix Adds the specified prefix to the beginning of the newly imported volume names to prevent conflicts with existing volumes on the system. For example, if a source volume is ocean_boot, and you specify --volume-prefix new, the imported volume would be new-ocean_boot.
--data Restore data only for the specified volumes.
--silent Suppress output.
--dry-run Show the interface to the shared network and volume-to-storage-group assignments without actually restoring a VM.
--throttle

Slow down the 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-restore --archive vm1.ova
$ avcli vm-restore --archive vm1/vm1.ovf
$ avcli vm-restore --name myVM --throttle low --archive vm1.ovf
$ avcli vm-restore --cpu 2 --memory 1024 --archive vm1.ovf
$ avcli vm-restore --interfaces network0 network1 --archive vm1.ovf
$ avcli vm-restore --storage-groups sm-0000 sm-0001 --archive vm1.ovf
$ avcli vm-restore --data vol1 vol3 --archive vm1.ovf
of