MTV 2.12.0 Attributes and release notes

Signed-off-by: A.Arnold <anarnold@redhat.com> and Richard Hoch
<rhoch@redhat.com>

Author: anarnold97

documentation/doc-Release_notes/master.adoc

@@ -11,31 +11,19 @@ endif::[]
 [role="_abstract"]
 Review these release notes for {project-first} version {project-version}.
 
-include::modules/ref_rn-2-11.adoc[leveloffset=+1]
+include::modules/ref_rn-2-12.adoc[leveloffset=+1]
 
 // Technical changes by x-stream release
-include::modules/ref_technical-changes-2-11.adoc[leveloffset=+2]
+include::modules/ref_technical-changes-2-12.adoc[leveloffset=+2]
 
 // New features and enhancements by z-stream release
-include::modules/ref_new-features-and-enhancements-2-11.adoc[leveloffset=+2]
+include::modules/ref_new-features-and-enhancements-2-12.adoc[leveloffset=+2]
 
 // Resolved issues by y-stream release
 include::modules/ref_rn-resolved-issues.adoc[leveloffset=+2]
 
 // Resolved issues by z-stream release. Most recent release goes first in the list.
-include::modules/ref_resolved-issues-2-11-7.adoc[leveloffset=+3]
-
-include::modules/ref_resolved-issues-2-11-6.adoc[leveloffset=+3]
-
-include::modules/ref_resolved-issues-2-11-5.adoc[leveloffset=+3]
-
-include::modules/ref_resolved-issues-2-11-4.adoc[leveloffset=+3]
-
-include::modules/ref_resolved-issues-2-11-3.adoc[leveloffset=+3]
-
-include::modules/ref_resolved-issues-2-11-1.adoc[leveloffset=+3]
-
-include::modules/ref_resolved-issues-2-11-0.adoc[leveloffset=+3]
+include::modules/ref_resolved-issues-2-12-0.adoc[leveloffset=+3]
 
 // Known issues by x-stream release
-include::modules/ref_known-issues-2-11.adoc[leveloffset=+2]
+include::modules/ref_known-issues-2-12.adoc[leveloffset=+2]

documentation/modules/common-attributes.adoc

@@ -10,8 +10,8 @@
 :ocp-name: OpenShift
 :ocp-short: OpenShift
 // when updating the ocp-version, update the ocp-y-version
-:ocp-version: 4.21
-:ocp-y-version: 4.21, 4.20, 4.19
+:ocp-version: 4.22
+:ocp-y-version: 4.22, 4.21, 4.20
 :ocp-doc: link:https://docs.redhat.com/en/documentation/openshift_container_platform/{ocp-version}/html-single
 :operator: mtv-operator
 :operator-name-ui: Migration Toolkit for Virtualization Operator
@@ -20,10 +20,10 @@
 :project-full: Migration Toolkit for Virtualization
 :project-short: MTV
 :project-first: {project-full} ({project-short})
-:project-version: 2.11
+:project-version: 2.12
 :mtv-plan: https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{project-version}/html/planning_your_migration_to_red_hat_openshift_virtualization/
 :mtv-mig: https://docs.redhat.com/en/documentation/migration_toolkit_for_virtualization/{project-version}/html/migrating_your_virtual_machines_to_red_hat_openshift_virtualization/
-:project-z-version: 2.11.7
+:project-z-version: 2.12.0
 :rhel-first: Red Hat Enterprise Linux (RHEL)
 :virt: OpenShift Virtualization
 :must-gather: registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:{project-z-version}
@@ -50,3 +50,4 @@
 :subtitle-migrating: Migrating virtual machines from {vmw} vSphere, {rhv-full} or {osp} platforms, or other platforms to Red Hat {virt} by using the {project-full}
 :abstract-migrating: Run your migration plan by using either the {project-first} user interface in the Red Hat OpenShift web console or the command-line interface.
 
+

documentation/modules/ref_known-issues-2-11.adoc

@@ -0,0 +1,48 @@
+// Module included in the following assemblies:
+//
+// * documentation/doc-Release_notes/master.adoc
+
+:_mod-docs-content-type: REFERENCE
+[id="ref_known-issues-2-12_{context}"]
+= Known issues
+
+[role="_abstract"]
+{project-first} {project-version} has the following known issues.
+
+VM migrations with XFS v4 file systems fail during conversion::
+Migrating a virtual machine (VM) with an XFS v4 file system uses a Red Hat Enterprise Linux 9 `virt-v2v` image. This image does not support the `virt_v2v_memsize` and `virt_v2v_smp` parameters. As a consequence, the migration fails during the conversion phase if you set these parameters with `xfsCompatibility: true`.
++
+To work around this problem, do not combine `xfsCompatibility: true` with the `virt_v2v_memsize` or `virt_v2v_smp` parameters. As a result, you avoid unexpected conversion failures.
++
+link:https://redhat.atlassian.net/browse/MTV-5595[MTV-5595]
+
+Inactive migration plans incorrectly display as running::
+The `max_vms_inflight` parameter sets a limit for concurrent virtual machine (VM) migrations or migrating disks. When migrations exceed this limit, the migration process queues the excess migration plans. As a consequence, the user interface (UI) incorrectly displays the status of these inactive, queued plans as *Running*.
++
+No known workaround exists.
++
+link:https://redhat.atlassian.net/browse/MTV-1736[MTV-1736]
+
+Deploying many User Defined Networks simultaneously causes node failures::
+Migrating from VMware to OpenShift Virtualization or deploying User Defined Networks (UDNs) can cause heavy resource contention. This contention occurs if you create more than 72 UDNs and their attached resources simultaneously. Open vSwitch (OVS) becomes starved for CPU time. Additionally, there is no way to determine if a UDN is fully created before attaching resources. As a consequence, high pod ready latency occurs, and nodes might enter a `NotReady` state.
++
+To work around this problem, limit simultaneous UDN creation to 72 or fewer. For larger deployments, create the UDNs upfront. Wait for Open Virtual Network Kubernetes (OVNK) utilization to settle before you deploy attached resources. As a result, you maintain stable pod ready latency and prevent node failures.
++
+link:https://redhat.atlassian.net/browse/MTV-5695[MTV-5695]
+
+Warm migrations of NBDE VMs fail during preflight inspection::
+A warm migration of a Network-Bound Disk Encryption (NBDE) virtual machine (VM) uses a DI pod. This pod cannot connect to the Tang server. As a consequence, the preflight inspection fails, and the migration plan fails.
++
+To work around this problem, disable the preflight inspection step by adding `runPreflightInspection: false` to the migration plan `spec`:
++
+[source,yaml]
+----
+spec:
+  ...
+  runPreflightInspection: false
+  ...
+----
++
+As a result, the migration proceeds without the preflight inspection. Potential issues in the plan might not be caught before execution.
++
+link:https://redhat.atlassian.net/browse/MTV-5750[MTV-5750]