From c6e79eec91fd26dfb33c5ec12c8ad7ab803cba9d Mon Sep 17 00:00:00 2001
From: Jaromir Hradilek <jhradilek@redhat.com>
Date: Fri, 29 Nov 2024 23:36:18 +0100
Subject: [PATCH] CNV-50110: Added a small migration section

---
 _attributes/common-attributes.adoc            |  4 +++
 modules/migrating-to-virt.adoc                | 34 +++++++++++++++++++
 .../getting_started/virt-getting-started.adoc |  2 ++
 3 files changed, 40 insertions(+)
 create mode 100644 modules/migrating-to-virt.adoc

diff --git a/_attributes/common-attributes.adoc b/_attributes/common-attributes.adoc
index f46d06ce42..ca25e6bf3b 100644
--- a/_attributes/common-attributes.adoc
+++ b/_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
diff --git a/modules/migrating-to-virt.adoc b/modules/migrating-to-virt.adoc
new file mode 100644
index 0000000000..80409b004e
--- /dev/null
+++ b/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.
diff --git a/virt/getting_started/virt-getting-started.adoc b/virt/getting_started/virt-getting-started.adoc
index 27acf7641c..ccbfab718d 100644
--- a/virt/getting_started/virt-getting-started.adoc
+++ b/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