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.

Limitations

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

Deploy OVA

Prerequisites

• A healthy VMO cluster. Refer to the Create a VMO Profile for further guidance.
• One or more VMs hosted in VMware vSphere. Only VMs whose operating systems are included under virt-v2v supported guest systems can be migrated.

Usage

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 Flag	Long Flag	Description	Type
-f	--config-file	Specifies an OVA configuration file.	string
-o	--config-only	Update the OVA configuration file only, without proceeding with the deployment. This flag requires the --config-file be specified.	boolean
-s	--silent	Perform a silent OVA deployment. This flag requires the --config-file be specified.	boolean
-h	--help	Help 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

Prerequisites

• A healthy VMO cluster. Refer to the Create a VMO Profile for further guidance.
• One or more VMs hosted in VMware vSphere. Only VMs whose operating systems are included under virt-v2v supported guest systems can be migrated.

Usage

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 Flag	Long Flag	Description	Type
-f	--config-file	Specifies an OVA configuration file.	string
-o	--config-only	Generate the OVA configuration file only, without proceeding with the import.	boolean
	--skip-convert	Skip OVA conversion to QCOW2 format.	boolean
	--skip-image	Skip VM image upload.	boolean
-h	--help	Help 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

Prerequisites

Refer to Migrate a VM to a VMO cluster using the Palette CLI for a full list of prerequisites.

Usage

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 using the Palette CLI guide for further details on migrating a vSphere VM to Palette VMO.

Short Flag	Long Flag	Description	Type
-f	--config-file	Specifies a configuration file for the VM migration.	string
-o	--config-only	Generate the migration configuration file only, without proceeding with the migration.	boolean
-p	--update-passwords	Update the vSphere and ESXi passwords saved in the configuration file. This flag requires the --config-file to be specified.	boolean
-h	--help	Help 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