Skip to main content
Version: latest

VMO

Use the vmo command to migrate Virtual Machines (VMs) and import and deploy vSphere Open Virtual Appliances (OVAs). The VMs can then be used with the Virtual Machine Orchestrator (VMO).

Subcommands

  • deploy-ova - Deploy an imported vSphere OVA. This command requires you to have an OVA deployment file. If you do not have one, you can generate an OVA with the import-ova subcommand.

  • import-ova - Import a vSphere OVA. This subcommand will generate an OVA deployment configuration file. The configuration can then be deployed using the deploy-ova subcommand.

  • migrate-vm - Migrate one or more VMware vSphere VMs to Palette VMO.

Prerequisites

Limitations

  • You can only use the vmo subcommand with VMs hosted in VMware vSphere.

Deploy OVA

Use the deploy-ova subcommand to deploy an imported vSphere OVA to Palette VMO. The following flags are supported by the deploy-ova subcommand. Refer to the Import and Deploy OVAs to Palette VMO guide for further details on importing and deploying vSphere OVAs.

Short FlagLong FlagDescriptionType
-f--config-fileSpecifies an OVA configuration file.string
-o--config-onlyUpdate the OVA configuration file only, without proceeding with the deployment. This flag requires the --config-file be specified.boolean
-s--silentPerform a silent OVA deployment. This flag requires the --config-file be specified.boolean
-h--helpHelp for the deploy-ova subcommand.-

Examples

Deploy a vSphere OVA previously imported to Palette VMO in interactive mode.

palette vmo deploy-ova --config-file ~/.palette/vmo/vms/my-ova-name/my-ova-name.yaml

Update the OVA configuration file without proceeding with the depoyment.

palette vmo import-ova --config-file ~/.palette/vmo/vms/my-ova-name/my-ova-name.yaml --config-only

Deploy a vSphere OVA previously imported to Palette VMO in interactive mode silently, without blocking the terminal.

palette vmo deploy-ova --config-file ~/.palette/vmo/vms/my-ova-name/my-ova-name.yaml --silent

Import OVA

Use the import-ova subcommand to import a vSphere OVA to Palette VMO. The following flags are supported by the import-ova subcommand. The OVA will be converted to the QCOW2 virtual disk storage format. This subcommand generates an OVA deployment configuration file. You can then either directly upload the imported image to a DataVolume or upload it a Docker image registry. Refer to the Import and Deploy OVAs to Palette VMO guide for further details on importing and deploying vSphere OVAs

Short FlagLong FlagDescriptionType
-f--config-fileSpecifies an OVA configuration file.string
-o--config-onlyGenerate the OVA configuration file only, without proceeding with the import.boolean
--skip-convertSkip OVA conversion to QCOW2 format.boolean
--skip-imageSkip VM image upload.boolean
-h--helpHelp for the deploy-ova subcommand.-

Examples

Import a vSphere OVA to Palette VMO in interactive mode.

palette vmo import-ova

Create a configuration file for the OVA import without proceeding with the import.

palette vmo import-ova --config-only

Import an OVA to Palette VMO using a configuration file. The configuration file is generated using the --config-only flag.

palette vmo import-ova --config-file ~/.palette/vmo/vms/my-ova-name/my-ova-name.yaml

Import an OVA to Palette VMO without converting it to QCOW2 format.

palette vmo import-ova --skip-convert

Import an OVA to Palette VMO without uploading it.

palette vmo import-ova --skip-image

Migrate VM

Use the migrate-vm subcommand to migrate one or more VMs from VMware vSphere to Palette VMO. The following flags are supported by the migrate-vm subcommand. The migration consists of two phases. First, all guest disks are transferred to Persistent Volumes (PVs) in K8s using KubeVirt CDI and VMware Virtual Disk Development Kit (VDDK). Then, the guest OS on the root disk is made bootable and drivers are installed using virt-v2v. Refer to the Migrate a VM to a VMO cluster guide for further details on migrating a vSphere VM to Palette VMO.

Short FlagLong FlagDescriptionType
-f--config-fileSpecifies a configuration file for the VM migration.string
-o--config-onlyGenerate the migration configuration file only, without proceeding with the migration.boolean
-p--update-passwordsUpdate the vSphere and ESXi passwords saved in the configuration file. This flag requires the --config-file to be specified.boolean
-h--helpHelp for the migrate-vm subcommand.-

Examples

Migrate a VM to Palette VMO in interactive mode.

palette vmo migrate-vm

Create a configuration file for the VM migration without proceeding with the migration.

palette vmo migrate-vm --config-only

Migrate a VM using a configuration file. The configuration file is generated using the --config-only flag.

palette vmo migrate-vm --config-file ~/.palette/vmo/migrations/migration-123/config.yaml

Update the passwords of an VM migration using a configuration file. The configuration file is generated using the --config-only flag.

palette vmo migrate-vm --config-file ~/.palette/vmo/migrations/migration-123/config.yaml --update-passwords