Merge pull request #85634 from jhradilek/CNV-50110-mtv-docs

CNV-50110: Add a small migration section and link to MTV docs

Author: jab-rh

_attributes/common-attributes.adoc

@@ -68,6 +68,10 @@ endif::[]
 :mtc-version: 1.8
 :mtc-version-z: 1.8.5
 :mtc-legacy-image: 1.7
+:mtv-first: Migration Toolkit for Virtualization (MTV)
+:mtv-short: MTV
+:mtv-full: Migration Toolkit for Virtualization
+:mtv-version: 2.7
 // builds (Valid only in 4.11 and later)
 :builds-v2title: Builds for Red Hat OpenShift
 :builds-v2shortname: OpenShift Builds v2

modules/migrating-to-virt.adoc

@@ -0,0 +1,34 @@
+// Module included in the following assemblies:
+//
+// * virt/getting_started/virt-getting-started.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[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}.
+
+[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.
+====
+
+.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[is installed].
+
+.Procedure
+. link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/migrating-vms-web-console_mtv#adding-source-providers[Configure the source provider].
++
+Select the source provider and enter any required information, such as the URL of the API endpoint or credentials needed to access the virtual machines.
+
+. link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/migrating-vms-web-console_mtv#creating-migration-plans-ui[Create a migration plan].
++
+Select from the list of available virtual machines, configure the target provider, and define storage and network mappings.
+
+. link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/migrating-vms-web-console_mtv#running-migration-plan_mtv[Run the migration plan].
++
+Watch the progress, view migration logs, or cancel the migration.
+
+. Optional: link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html/installing_and_using_the_migration_toolkit_for_virtualization/migrating-vms-web-console_mtv#migration-plan-options-ui_mtv[Archive the migration plan].
++
+After confirming that the migration has completed successfully, you can archive the migration plan to delete the logs and clean up all temporary resources created during migration. You can permanently delete an archived migration plan.

virt/getting_started/virt-getting-started.adoc

@@ -121,6 +121,8 @@ 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