diff --git a/_attributes/common-attributes.adoc b/_attributes/common-attributes.adoc index ffe2d8ce718b..379a5a74081a 100644 --- a/_attributes/common-attributes.adoc +++ b/_attributes/common-attributes.adoc @@ -91,7 +91,7 @@ endif::[] :mtv-first: Migration Toolkit for Virtualization (MTV) :mtv-short: MTV :mtv-full: Migration Toolkit for Virtualization -:mtv-version: 2.8 +:mtv-version: 2.9 // builds (Valid only in 4.11 and later) :builds-v2title: Builds for Red Hat OpenShift :builds-v2shortname: OpenShift Builds v2 diff --git a/modules/migrating-to-virt.adoc b/modules/migrating-to-virt.adoc index b98e4f2c1418..4b903846f588 100644 --- a/modules/migrating-to-virt.adoc +++ b/modules/migrating-to-virt.adoc @@ -6,20 +6,24 @@ [id="migrating-to-virt_{context}"] = Migrating to {VirtProductName} -To migrate virtual machines from an external provider such as {vmw-first}, {rh-openstack-first}, Red Hat Virtualization, or another {product-title} cluster, use the {mtv-first}. You can also migrate Open Virtual Appliance (OVA) files created by {vmw-full}. +You can migrate virtual machines (VMs) from external providers, such as {vmw-first} and {rh-openstack-first}, to {VirtProductName}. To make this process easier and more efficient, Red{nbsp}Hat provides {mtv-first}. -[NOTE] -==== -{mtv-full} is not part of {VirtProductName} and requires separate installation. For this reason, all links in this procedure lead outside of {VirtProductName} documentation. -==== +{mtv-short} is an Operator that you can install from the OperatorHub in the {product-title} web console. This toolkit simplifies the migration process and provides a central point of management for migrating VMs. -.Prerequisites -* The {mtv-full} Operator link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/installing-the-operator_mtv#installing-the-operator_mtv[is installed]. +The migration process with {mtv-short} involves several key steps: -.Procedure +* link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/installing-the-operator_mtv#installing-the-operator_mtv[Installing the {mtv-short} Operator]: Before you can use the toolkit, you must install the {mtv-short} Operator on your {product-title} cluster. The Operator provides all the necessary components for migration. -* link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/migrating-vmware#adding-source-provider_vmware[Migrate virtual machines from {vmw-first}]. -* link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/migrating-osp_ostack#adding-source-provider_ostack[Migrate virtual machines from {rh-openstack-first}]. -* link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/migrating-rhv_rhv#adding-source-provider_rhv[Migrate virtual machines from Red Hat Virtualization]. -* link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/migrating-virt_cnv#adding-source-provider_cnv[Migrate virtual machines from {VirtProductName}]. -* link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/migrating-ova_ova#adding-source-provider_ova[Migrate virtual machines from OVA files created by {vmw-full}]. +* link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html-single/installing_and_using_the_migration_toolkit_for_virtualization/index#creating-plan-wizard-290-vmware_vmware[Creating a migration plan]: A migration plan defines the VMs to be migrated, the source and destination environments, and other migration settings. This plan helps to organize and automate the migration process. + +* link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html-single/installing_and_using_the_migration_toolkit_for_virtualization/index#about-network-maps_vmware[Mapping networks] and link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html-single/installing_and_using_the_migration_toolkit_for_virtualization/index#about-network-maps_vmware[mapping storage]: {mtv-short} helps you to map networks and storage from your source environment (for example, vSphere or RHV) to the {product-title} environment. This ensures that the migrated VMs have the correct network and storage configurations. + +* Performing the migration: When you have created the migration plan and the networks and storage are mapped, you can perform the migration. {mtv-short} handles the transfer of VM data and configuration to the {product-title} cluster. + +** link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/migrating-vmware[Migrate virtual machines from {vmw-first}]. +** link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/migrating-osp_ostack[Migrate virtual machines from {rh-openstack-first}]. +** link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/migrating-rhv_rhv[Migrate virtual machines from Red{nbsp}Hat Virtualization]. +** link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/migrating-virt_cnv[Migrate virtual machines from {VirtProductName}]. +** link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/migrating-ova_ova[Migrate virtual machines from OVA files created by {vmw-full}]. + +For more information, refer to the link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/[documentation for {mtv-full}]. diff --git a/virt/getting_started/virt-getting-started.adoc b/virt/getting_started/virt-getting-started.adoc index 4fc3dc723f9d..905e57a47ce5 100644 --- a/virt/getting_started/virt-getting-started.adoc +++ b/virt/getting_started/virt-getting-started.adoc @@ -70,6 +70,8 @@ endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[] * xref:../../virt/managing_vms/advanced_vm_management/virt-specifying-nodes-for-vms.adoc#virt-specifying-nodes-for-vms[Specifying nodes for virtual machines]. * xref:../../virt/getting_started/virt-using-the-cli-tools.adoc#virt-virtctl-commands_virt-using-the-cli-tools[`Virtctl` commands]. +include::modules/migrating-to-virt.adoc[leveloffset=+1] + [id="creating-and-managing-vms_{context}"] == Creating and managing virtual machines @@ -121,8 +123,6 @@ Manage a VM: * xref:../../virt/getting_started/virt-using-the-cli-tools.adoc#virt-virtctl-commands_virt-using-the-cli-tools[Manage a VM by using the `virtctl` CLI tool]. * xref:../../virt/managing_vms/virt-exporting-vms.adoc#virt-accessing-exported-vm-manifests_virt-exporting-vms[Export a VM]. -include::modules/migrating-to-virt.adoc[leveloffset=+1] - [id="next-steps_{context}"] == Next steps