Skip to content

Rewrite MTV section in CNV docs #99589

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
anarnold97 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Rewrite MTV section in CNV docs #99589

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion _attributes/common-attributes.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
30 changes: 17 additions & 13 deletions modules/migrating-to-virt.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Copy link
Member

@ousleyp ousleyp Oct 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These links work better now if I copy and paste them and substitute 2.9 for {mtv-version} (though for some reason the preview build hasn't caught on yet). However, the "Mapping networks" and "mapping storage" URLs now both point to 7.8. About network maps in migration plans :)

* 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}].
4 changes: 2 additions & 2 deletions virt/getting_started/virt-getting-started.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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

Expand Down