diff --git a/documentation/doc-Release_notes/master.adoc b/documentation/doc-Release_notes/master.adoc index 44f9e04c22a..5442f1cc927 100644 --- a/documentation/doc-Release_notes/master.adoc +++ b/documentation/doc-Release_notes/master.adoc @@ -10,8 +10,8 @@ include::modules/common-attributes.adoc[] include::modules/rn-2-10.adoc[leveloffset=+1] -// Technical changes by x-stream release -//include::modules/technical-changes-2-9.adoc[leveloffset=+2] +// Technical changes by y-stream release +include::modules/technical-changes-2-10.adoc[leveloffset=+2] //include::modules/upgrade-notes-2.9.adoc[leveloffset=+2] // New features and enhancements by z-stream release @@ -22,6 +22,8 @@ include::modules/rn-resolved-issues.adoc[leveloffset=+2] // Resolved issues by z-stream release +include::modules/rn-2-10-6-resolved-issues.adoc[leveloffset=+3] + include::modules/rn-2-10-5-resolved-issues.adoc[leveloffset=+3] include::modules/rn-2-10-4-resolved-issues.adoc[leveloffset=+3] diff --git a/documentation/modules/common-attributes.adoc b/documentation/modules/common-attributes.adoc index d2da593a326..ccd2e04afe9 100644 --- a/documentation/modules/common-attributes.adoc +++ b/documentation/modules/common-attributes.adoc @@ -22,7 +22,7 @@ :project-version: 2.10 :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.10.5 +:project-z-version: 2.10.6 :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} diff --git a/documentation/modules/new-features-and-enhancements-2-10.adoc b/documentation/modules/new-features-and-enhancements-2-10.adoc index 545885aa6ed..4b2ee6a6ca5 100644 --- a/documentation/modules/new-features-and-enhancements-2-10.adoc +++ b/documentation/modules/new-features-and-enhancements-2-10.adoc @@ -2,14 +2,49 @@ // // * documentation/doc-Release_notes/master.adoc -:_mod-docs-content-type: CONCEPT +:_mod-docs-content-type: REFERENCE [id="new-features-and-enhancements-2-10_{context}"] = New features and enhancements [role="_abstract"] {project-first} 2.10 introduces the following features and enhancements: -* In {project-short} 2.10.1, you can migrate VMs that are running on B-tree file systems (Btrfs) to {virt} with support for OS conversion. +* In {project-short} 2.10.6, you can control nested virtualization behavior during migration with the new `enableNestedVirtualization` option. This option accepts three values: + +** Not set (default): Nested virtualization is automatically detected from the source VM and preserved on the target. +** `true`: Force enables nested virtualization on the target VM, regardless of source settings. +** `false`: Force disables nested virtualization on the target VM, regardless of source settings. ++ +This option gives you the flexibility to mitigate performance issues stemming from Virtualization Based Security (VBS) activation. ++ +By disabling VBS on target VMs during the migration of Windows VMs that do not need nested virtualization, you can avoid potential performance degradation, resulting in a more streamlined and efficient migration process. ++ +[NOTE] +==== +After you migrate your VMs to {virt}, you can re-enable VBS by running the following YAML: + +[source,yaml,subs="attributes+"] +---- +apiVersion: kubevirt.io/v1 +kind: VirtualMachine +metadata: + name: +spec: + template: + spec: + domain: + cpu: + features: + - name: vmx + policy: optional + - name: svm + policy: optional +---- +==== ++ +link:https://issues.redhat.com/browse/MTV-4698[(MTV-4698)] + +* In {project-short} 2.10.1, you can migrate VMs that are running on B-tree file systems (Btrfs) to {virt} with support for operating system conversion. + link:https://issues.redhat.com/browse/MTV-2260[(MTV-2260)] @@ -57,8 +92,8 @@ link:https://issues.redhat.com/browse/MTV-2768[(MTV-2768)] * In {project-short} 2.10.0, a `PreFlightInspection` during warm migration enables early detection of issues during guest conversion. If an issue is detected, the warm migration fails before VM shutdown, and users can adjust VM settings or skip guest conversion. Potential errors during the `PreFlightInspection` include the following: + ** Missing LUKS passwords -** Unsupported OS -** Unsupported FS +** Unsupported operating system +** Unsupported file system + link:https://issues.redhat.com/browse/MTV-2427[(MTV-2427)] @@ -70,7 +105,7 @@ link:https://issues.redhat.com/browse/MTV-2427[(MTV-2427)] + link:https://issues.redhat.com/browse/MTV-2856[(MTV-2856)] -* *Technology Preview:* In {project-short} 2.10.0, you can live migrate VMs from one OpenShift (OCP) cluster to another, minimizing downtime with the continuous availability of VMs during the migration process. With this update, MTV creates and maps resources from the source to the destination cluster and triggers the live migration, and {virt} CNV migrates the running VM. +* *Technology Preview:* In {project-short} 2.10.0, you can live migrate VMs from one Red Hat OpenShift cluster to another, minimizing downtime with the continuous availability of VMs during the migration process. With this update, MTV creates and maps resources from the source to the destination cluster and triggers the live migration, and {virt} CNV migrates the running VM. + link:https://issues.redhat.com/browse/MTV-2040[(MTV-2040)] diff --git a/documentation/modules/rn-2-10-0-resolved-issues.adoc b/documentation/modules/rn-2-10-0-resolved-issues.adoc index 9082ffaf47f..fcba9f6d412 100644 --- a/documentation/modules/rn-2-10-0-resolved-issues.adoc +++ b/documentation/modules/rn-2-10-0-resolved-issues.adoc @@ -2,7 +2,7 @@ // // * documentation/doc-Release_notes/master.adoc -:_mod-docs-content-type: CONCEPT +:_mod-docs-content-type: REFERENCE [id="resolved-issues-2-10-0_{context}"] = Resolved issues 2.10.0 diff --git a/documentation/modules/rn-2-10-1-resolved-issues.adoc b/documentation/modules/rn-2-10-1-resolved-issues.adoc index af5d978cef2..84a31f0a18f 100644 --- a/documentation/modules/rn-2-10-1-resolved-issues.adoc +++ b/documentation/modules/rn-2-10-1-resolved-issues.adoc @@ -2,7 +2,7 @@ // // * documentation/doc-Release_notes/master.adoc -:_content-type: CONCEPT +:_mod-docs-content-type: REFERENCE [id="resolved-issues-2-10-1_{context}"] = Resolved issues 2.10.1 diff --git a/documentation/modules/rn-2-10-2-resolved-issues.adoc b/documentation/modules/rn-2-10-2-resolved-issues.adoc index 366c7f571ae..802b4e6e2e6 100644 --- a/documentation/modules/rn-2-10-2-resolved-issues.adoc +++ b/documentation/modules/rn-2-10-2-resolved-issues.adoc @@ -2,7 +2,7 @@ // // * documentation/doc-Release_notes/master.adoc -:_content-type: CONCEPT +:_mod-docs-content-type: REFERENCEs [id="resolved-issues-2-10-2_{context}"] = Resolved issues 2.10.2 diff --git a/documentation/modules/rn-2-10-3-resolved-issues.adoc b/documentation/modules/rn-2-10-3-resolved-issues.adoc index 829e03fc9ff..0b4ddb66709 100644 --- a/documentation/modules/rn-2-10-3-resolved-issues.adoc +++ b/documentation/modules/rn-2-10-3-resolved-issues.adoc @@ -2,7 +2,7 @@ // // * documentation/doc-Release_notes/master.adoc -:_content-type: CONCEPT +:_mod-docs-content-type: REFERENCE [id="resolved-issues-2-10-3_{context}"] = Resolved issues 2.10.3 diff --git a/documentation/modules/rn-2-10-3-security-fixes.adoc b/documentation/modules/rn-2-10-3-security-fixes.adoc index ce434ef55eb..a80e2bbb360 100644 --- a/documentation/modules/rn-2-10-3-security-fixes.adoc +++ b/documentation/modules/rn-2-10-3-security-fixes.adoc @@ -2,7 +2,7 @@ // // * documentation/doc-Release_notes/master.adoc -:_content-type: CONCEPT +:_mod-docs-content-type: REFERENCE [id="security-fixes-2-10-3_{context}"] = Security fixes 2.10.3 diff --git a/documentation/modules/rn-2-10-4-resolved-issues.adoc b/documentation/modules/rn-2-10-4-resolved-issues.adoc index 03f889fc5df..eaed4090737 100644 --- a/documentation/modules/rn-2-10-4-resolved-issues.adoc +++ b/documentation/modules/rn-2-10-4-resolved-issues.adoc @@ -2,7 +2,7 @@ // // * documentation/doc-Release_notes/master.adoc -:_content-type: CONCEPT +:_mod-docs-content-type: REFERENCE [id="resolved-issues-2-10-4_{context}"] = Resolved issues 2.10.4 diff --git a/documentation/modules/rn-2-10-5-resolved-issues.adoc b/documentation/modules/rn-2-10-5-resolved-issues.adoc index b60dddab871..18e80cc324f 100644 --- a/documentation/modules/rn-2-10-5-resolved-issues.adoc +++ b/documentation/modules/rn-2-10-5-resolved-issues.adoc @@ -2,7 +2,7 @@ // // * documentation/doc-Release_notes/master.adoc -:_content-type: CONCEPT +:_mod-docs-content-type: REFERENCE [id="resolved-issues-2-10-5_{context}"] = Resolved issues 2.10.5 diff --git a/documentation/modules/rn-2-10-6-resolved-issues.adoc b/documentation/modules/rn-2-10-6-resolved-issues.adoc new file mode 100644 index 00000000000..43db7ee5d54 --- /dev/null +++ b/documentation/modules/rn-2-10-6-resolved-issues.adoc @@ -0,0 +1,27 @@ +// Module included in the following assemblies: +// +// * documentation/doc-Release_notes/master.adoc + +:_mod-docs-content-type: REFERENCE +[id="resolved-issues-2-10-6_{context}"] += Resolved issues 2.10.6 + +[role="_abstract"] +Review the resolved issues in this release of {project-short}. + +XFSv4 migrations failed:: +{project-short} 2.10.1 was rebased to {rhel-first} 10, which does not support XFS version 4 (XFSv4). As a result, XFSv4 migrations failed for {project-short} 2.10.1-2.10.5. With this release, a new `spec.xfsCompatibility` option is available on the migration plan. When set to `false`, the default setting, the plan uses the standard conversion image. When set to `true`, the plan uses the XFS-compatible conversion image instead of the standard conversion image. ++ +[WARNING] +==== +If you enable XFS support for a migration plan, then the plan cannot support Btrfs migration. +==== ++ +link:https://issues.redhat.com/browse/MTV-4685[MTV-4685] and link:https://issues.redhat.com/browse/MTV-4709[MTV-4709] + + +Migrations with shared disk migration disabled failed:: + +In {project-short}, migration of shared disks is done by running two migration plans, one with the `migrateSharedDisk` option set to `true` and one with the option set to `false`. Before this update, the migration plan with the option set to `false` failed because an unnecessary `populator` pod was created. With this release, the unnecessary pod is not created, and migration of shared disks works as expected. ++ +link:https://issues.redhat.com/browse/MTV-4555[MTV-4555] \ No newline at end of file diff --git a/documentation/modules/technical-changes-2-10.adoc b/documentation/modules/technical-changes-2-10.adoc new file mode 100644 index 00000000000..8892c816327 --- /dev/null +++ b/documentation/modules/technical-changes-2-10.adoc @@ -0,0 +1,14 @@ +// Module included in the following assemblies: +// +// * documentation/doc-Release_notes/master.adoc + +:_content-type: CONCEPT +[id="technical-changes-2-10_{context}"] += Technical changes + +[role="_abstract"] +{project-first} has the following technical changes. + +{project-short} 2.10.1 rebased to RHEL 10:: + +{project-short} 2.10.1 was rebased to {rhel-first} 10. \ No newline at end of file