CNV-50110: Added a small migration section

Author: jhradilek

_attributes/common-attributes.adoc

@@ -67,6 +67,10 @@ endif::[]
 :mtc-version: 1.8
 :mtc-version-z: 1.8.4
 :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

@@ -36,7 +36,7 @@ This short guided tour introduces several key aspects of using {VirtProductName}
 Quick start tours are available for several {VirtProductName} features. To access quick starts, complete the following steps:
 
 . Click the *Help* icon *?* in the menu bar on the header of the {product-title} web console.
-. Select *Quick Starts*. 
+. Select *Quick Starts*.
 
 You can filter the available tours by entering the keyword `virtualization` in the *Filter* field.
 endif::openshift-rosa,openshift-dedicated[]
@@ -123,6 +123,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/virtual_machines/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