Rewrite MTV section in CNV docs #99589

anarnold97 · 2025-09-23T19:51:11Z

Task

Migrating to OpenShift Virtualization

Quick rearrangement of the MTV section in CNV to make MTV a bit more included in CNV.

Version(s):

Issue:

Link to docs preview:

QE review:

QE has approved this change.

Additional information:

ocpdocs-previewbot · 2025-09-23T20:06:29Z

🤖 Tue Sep 30 22:36:21 - Prow CI generated the docs preview:
https://99589--ocpdocs-pr.netlify.app
Complete list of updated preview URLs: artifacts/updated_preview_urls.txt

modules/migrating-to-virt.adoc

virt/getting_started/virt-getting-started.adoc

modules/migrating-to-virt.adoc

ousleyp

Hey Andy, thanks for doing this. It looks great overall but there are a few issues with the links and some nits/suggestions. Please also update the PR description to include which versions this applies to. IMO, it's ready for merge if you fix those issues and squash your commits.

modules/migrating-to-virt.adoc

ousleyp · 2025-09-24T15:40:32Z

modules/migrating-to-virt.adoc

+
+* link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html-single/installing_and_using_the_migration_toolkit_for_virtualization/index%23creating-a-network-map[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%23creating-a-storage-map[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: Once the migration plan is created and the networks and storage are mapped, you can perform the migration. {mtv-short} handles the transfer of VM data and configuration to the OpenShift cluster.


IBM Style nit:

s/Once/After or s/Once/When

Use with caution once adverb
Use only to mean one time. Do not use as a conjunction to mean after or when.

modules/migrating-to-virt.adoc

anarnold97 · 2025-09-24T17:12:04Z

Hey Andy, thanks for doing this. It looks great overall but there are a few issues with the links and some nits/suggestions. Please also update the PR description to include which versions this applies to. IMO, it's ready for merge if you fix those issues and squash your commits.

@ousleyp - your changes are all implemented

openshift-ci · 2025-09-24T17:33:24Z

@anarnold97: The label(s) /label MTV cannot be applied. These labels are supported: acknowledge-critical-fixes-only, platform/aws, platform/azure, platform/baremetal, platform/google, platform/libvirt, platform/openstack, ga, tide/merge-method-merge, tide/merge-method-rebase, tide/merge-method-squash, px-approved, docs-approved, qe-approved, ux-approved, no-qe, downstream-change-needed, rebase/manual, cluster-config-api-changed, run-integration-tests, approved, backport-risk-assessed, bugzilla/valid-bug, cherry-pick-approved, cloud-experts, cnv, dev-tools, distributed-tracing, ims, jira/valid-bug, merge-review-in-progress, merge-review-needed, mtc, multi-arch, oadp, ok-to-test, rhacs, rhv, sd-docs, serverless, service-mesh, sme-review-done, sme-review-needed, stability-fix-approved, staff-eng-approved, telco. Is this label configured under labels -> additional_labels or labels -> restricted_labels in plugin.yaml?

Details

In response to this:

/label MTV

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

ousleyp · 2025-09-30T18:49:42Z

modules/migrating-to-virt.adoc

+* link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html-single/installing_and_using_the_migration_toolkit_for_virtualization/index%23creating-a-migration-plan[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%23creating-a-network-map#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%23creating-a-network-map#about-storage-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.


These three links (Creating a migration plan, Mapping networks, and mapping storage) don't work for me; they all point to the top of the page as if the links were all to https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/2.8/html-single/installing_and_using_the_migration_toolkit_for_virtualization/index

@anarnold97 Do the links work on your end?

modules/migrating-to-virt.adoc

Signed-off-by: A.Arnold <anarnold@redhat.com>

openshift-ci · 2025-09-30T22:38:30Z

@anarnold97: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

anarnold97 · 2025-09-30T22:45:10Z

Sorry @ousleyp - i can see the problem.

it is the attribute version of MTV, which is set to 2.8

if i update that to 2.9 the links will work

ousleyp · 2025-10-01T15:39:11Z

Sorry @ousleyp - i can see the problem.

it is the attribute version of MTV, which is set to 2.8

if i update that to 2.9 the links will work

Ah ok! Thanks for checking, @anarnold97. So is this change only for enterprise-4.20+?

anarnold97 · 2025-10-01T18:37:36Z

@ousleyp - thanks for checking
MTV sort of independent of OCP... but MTV 2.9.0 came out to coincide with OCP 4.19
And will change to MTV 2.10.0 for OCP 4.20

What do you mean that was too much boring information? 🤣

ousleyp

One more thing with the links - thanks! Since you're changing the attribute to 2.9 and you said that 2.9 was released to coincide with 4.19, it seems like this PR should be cherrypicked to 4.19 and 4.20[*]. Shall I assign those labels? Let me know when you're ready for merge.

[*] and a separate PR should later be opened to update the variable to 2.10 when that goes out - that would be against main and 4.20, I think?

ousleyp · 2025-10-02T14:55:03Z

modules/migrating-to-virt.adoc

-* 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.


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 :)

anarnold97 · 2025-10-02T15:20:49Z

@ousleyp - that would be awesome, thanks

bergerhoffer · 2025-10-20T15:22:42Z

The branch/enterprise-4.21 label has been added to this PR.

This is because your PR targets the main branch and is labeled for enterprise-4.20. And any PR going into main must also target the latest version branch (enterprise-4.21).

If the update in your PR does NOT apply to version 4.21 onward, please re-target this PR to go directly into the appropriate version branch or branches (enterprise-4.x) instead of main.

openshift-ci bot added the size/S Denotes a PR that changes 10-29 lines, ignoring generated files. label Sep 23, 2025

openshift-ci bot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Sep 23, 2025

anarnold97 commented Sep 23, 2025

View reviewed changes

modules/migrating-to-virt.adoc Outdated Show resolved Hide resolved

anarnold97 commented Sep 23, 2025

View reviewed changes

virt/getting_started/virt-getting-started.adoc Show resolved Hide resolved

anarnold97 commented Sep 23, 2025

View reviewed changes

modules/migrating-to-virt.adoc Outdated Show resolved Hide resolved

ousleyp reviewed Sep 24, 2025

View reviewed changes

anarnold97 commented Sep 24, 2025

View reviewed changes

modules/migrating-to-virt.adoc Outdated Show resolved Hide resolved

anarnold97 force-pushed the rework-MTV-section-in-CNV branch from 96d0e62 to c17899c Compare September 24, 2025 16:59

anarnold97 closed this Sep 24, 2025

anarnold97 reopened this Sep 24, 2025

ousleyp reviewed Sep 30, 2025

View reviewed changes

anarnold97 commented Sep 30, 2025

View reviewed changes

modules/migrating-to-virt.adoc Outdated Show resolved Hide resolved

anarnold97 commented Sep 30, 2025

View reviewed changes

modules/migrating-to-virt.adoc Outdated Show resolved Hide resolved

Rewrite MTV section in CNV docs

9593c6f

Signed-off-by: A.Arnold <anarnold@redhat.com>

anarnold97 force-pushed the rework-MTV-section-in-CNV branch from 14619ed to 9593c6f Compare September 30, 2025 22:24

ousleyp reviewed Oct 2, 2025

View reviewed changes

ousleyp added CNV Label for all CNV PRs branch/enterprise-4.19 branch/enterprise-4.20 labels Oct 2, 2025

ousleyp added this to the Continuous Release milestone Oct 2, 2025

bergerhoffer added the branch/enterprise-4.21 label Oct 20, 2025


		* link:https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{mtv-version}/html-single/installing_and_using_the_migration_toolkit_for_virtualization/index%23creating-a-network-map[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%23creating-a-storage-map[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: Once the migration plan is created and the networks and storage are mapped, you can perform the migration. {mtv-short} handles the transfer of VM data and configuration to the OpenShift cluster.

Rewrite MTV section in CNV docs #99589

Are you sure you want to change the base?

Rewrite MTV section in CNV docs #99589

Uh oh!

Conversation

anarnold97 commented Sep 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Task

Uh oh!

ocpdocs-previewbot commented Sep 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ousleyp left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ousleyp Sep 24, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

anarnold97 commented Sep 24, 2025

Uh oh!

openshift-ci bot commented Sep 24, 2025

Uh oh!

ousleyp Sep 30, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

openshift-ci bot commented Sep 30, 2025

Uh oh!

anarnold97 commented Sep 30, 2025

Uh oh!

ousleyp commented Oct 1, 2025

Uh oh!

anarnold97 commented Oct 1, 2025

Uh oh!

ousleyp left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ousleyp Oct 2, 2025

Choose a reason for hiding this comment

Uh oh!

anarnold97 commented Oct 2, 2025

Uh oh!

bergerhoffer commented Oct 20, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

anarnold97 commented Sep 23, 2025 •

edited

Loading

ocpdocs-previewbot commented Sep 23, 2025 •

edited

Loading

ousleyp left a comment •

edited

Loading