From 1cda4dc65d208db01dca6b025b9c36d09be1103e Mon Sep 17 00:00:00 2001 From: Adelina Simion <43963729+addetz@users.noreply.github.com> Date: Fri, 13 Sep 2024 21:46:08 +0200 Subject: [PATCH] docs: add config patch to migration prereqs PLT-1392 (#3911) * docs: add config patch to migration prereqs PLT-1392 * docs: reword prereqs PLT-1392 * docs: reword prereqs PLT-1392 * docs: reduce prereq admonition * docs: reduce prereq admonition * ci: auto-formatting prettier issues --------- Co-authored-by: addetz --- .../advanced-topics/advanced-topics.md | 1 + .../advanced-topics/migrate-vm-kubevirt.md | 51 ++++++++++++++++--- 2 files changed, 45 insertions(+), 7 deletions(-) diff --git a/docs/docs-content/vm-management/create-manage-vm/advanced-topics/advanced-topics.md b/docs/docs-content/vm-management/create-manage-vm/advanced-topics/advanced-topics.md index 35461691f9..8a61e72bf6 100644 --- a/docs/docs-content/vm-management/create-manage-vm/advanced-topics/advanced-topics.md +++ b/docs/docs-content/vm-management/create-manage-vm/advanced-topics/advanced-topics.md @@ -21,3 +21,4 @@ by over-committing CPU and memory. - [Create VM Templates](./create-vm-template.md) - [Create DISK Templates](./create-disk-templates.md) - [Over-commit Resources to Enhance VM Performance](./vm-oversubscription.md) +- [Migrate a VM to a VMO cluster](./migrate-vm-kubevirt.md) diff --git a/docs/docs-content/vm-management/create-manage-vm/advanced-topics/migrate-vm-kubevirt.md b/docs/docs-content/vm-management/create-manage-vm/advanced-topics/migrate-vm-kubevirt.md index 07147eafc4..7a22846176 100644 --- a/docs/docs-content/vm-management/create-manage-vm/advanced-topics/migrate-vm-kubevirt.md +++ b/docs/docs-content/vm-management/create-manage-vm/advanced-topics/migrate-vm-kubevirt.md @@ -25,6 +25,49 @@ from VMware vSphere to Palette VMO. ## Prerequisites - A Healthy VMO cluster. Refer to the [Create a VMO Profile](../../create-vmo-profile.md) for further guidance. + + - The VMO cluster must have access to VMware and the VM you want to migrate. + + :::warning + + If you need to provision `Block` storage volumes during the VM migration process, add the following custom + configuration to your VMO cluster OS pack. Applying this configuration may cause a cluster repave. For more + information, refer to + [Repave Behaviors and Configurations](../../../clusters/cluster-management/node-pool.md#repave-behavior-and-configuration) + + Additionally, we recommend provisioning volumes with the `ReadWriteMany` access mode to ensure that VMs can be + [live migrated](https://kubevirt.io/user-guide/compute/live_migration/#limitations). + + ```yaml + kubeadmconfig: + preKubeadmCommands: + # Start containerd with new configuration + - systemctl daemon-reload + - systemctl restart containerd + files: + - targetPath: /etc/containerd/config.toml + targetOwner: "root:root" + targetPermissions: "0644" + content: | + ## template: jinja + + # Use config version 2 to enable new configuration fields. + version = 2 + + imports = ["/etc/containerd/conf.d/*.toml"] + + [plugins] + [plugins."io.containerd.grpc.v1.cri"] + sandbox_image = "registry.k8s.io/pause:3.9" + device_ownership_from_security_context = true + [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc] + runtime_type = "io.containerd.runc.v2" + [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options] + SystemdCgroup = true + ``` + + ::: + - A VMware vSphere user account with the necessary permissions to manage the VMs you want to migrate. - Migration can optionally accelerated by providing credentials for the ESXi hosts where the VMs reside. - One or more VMs hosted in VMware vSphere. Only VMs whose operating systems are included under @@ -34,16 +77,10 @@ from VMware vSphere to Palette VMO. - If you are migrating more than one VM in the same plan, they must all share the same network. - The Palette CLI installed and setup. Refer to the [Installation](../../../automation/palette-cli/install-palette-cli.md) guide for further details. + - The Palette CLI must have access to both the VMO cluster and the machines to be migrated. - The kubectl command-line tool should also be installed. Refer to the [kubectl installation](https://kubernetes.io/docs/tasks/tools/install-kubectl/) guide to learn more. -:::warning - -The VMO cluster must have access to VMware and the VM you want to migrate. The Palette CLI must have access to both the -VMO cluster and the machines to be migrated. - -::: - ## Migrate VMware vSphere VMs 1. Download the [Kubeconfig](../../../clusters/cluster-management/kubeconfig.md) file of the VMO cluster to the host