diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index a5de2de9a7..ac344fa78f 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -3903,7 +3903,7 @@ Topics: Distros: openshift-enterprise Topics: - Name: OpenShift Virtualization release notes - File: virt-4-15-release-notes + File: virt-4-16-release-notes - Name: Getting started Dir: getting_started Topics: diff --git a/virt/release_notes/virt-4-15-release-notes.adoc b/virt/release_notes/virt-4-16-release-notes.adoc similarity index 52% rename from virt/release_notes/virt-4-15-release-notes.adoc rename to virt/release_notes/virt-4-16-release-notes.adoc index ca2559bb11..8021a9c356 100644 --- a/virt/release_notes/virt-4-15-release-notes.adoc +++ b/virt/release_notes/virt-4-16-release-notes.adoc @@ -1,8 +1,8 @@ :_mod-docs-content-type: ASSEMBLY -[id="virt-4-15-release-notes"] +[id="virt-4-16-release-notes"] = {VirtProductName} release notes include::_attributes/common-attributes.adoc[] -:context: virt-4-15-release-notes +:context: virt-4-16-release-notes toc::[] @@ -54,112 +54,37 @@ The SVVP certification applies to: Quick start tours are available for several {VirtProductName} features. To view the tours, click the *Help* icon *?* in the menu bar on the header of the {product-title} web console and then select *Quick Starts*. You can filter the available tours by entering the keyword `virtualization` in the *Filter* field. -[id="virt-4-15-new"] +[id="virt-4-16-new"] == New and changed features This release adds new features and enhancements related to the following components and concepts: -[id="virt-4-15-installation-update"] +[id="virt-4-16-installation-update"] === Installation and update -//CNV-34680: Metrics update -* You can now use the `kubevirt_vm_created_total` metric (Type: Counter) to query the number of VMs created in a specified namespace. - -[id="virt-4-15-infrastructure"] +[id="virt-4-16-infrastructure"] === Infrastructure -//CNV-21920: Move instancetype API from v1alpha2 to v1beta1 -* The `instanceType` API now uses a more stable `v1beta1` version. - -//CNV-31433: virtio-serial channel for SAP - -[id="virt-4-15-virtualization"] +[id="virt-4-16-virtualization"] === Virtualization -//CNV-34757: Guest OS console logs -* You can now enable access to the xref:../../virt/support/virt-troubleshooting.adoc#guest-system-logs_virt-troubleshooting[serial console logs of VM guests] to facilitate troubleshooting. This feature is disabled by default. Cluster administrators can change the default setting for VMs by using the web console or the CLI. Users can toggle guest log access on individual VMs regardless of the cluster-wide default setting. - -//CNV-29983: Free page reporting -* Free page reporting is enabled by default. - -//CNV-28880: KSM configuration -* You can configure {VirtProductName} to xref:../../virt/virtual_machines/advanced_vm_management/virt-activating-ksm.adoc#virt-activating-ksm[activate kernel samepage merging (KSM)] when a node is overloaded. - -[id="virt-4-15-networking"] +[id="virt-4-16-networking"] === Networking -//CNV-30164 and CNV-30167: NIC hot plug feature is now GA. This was TP for 4.14. Moved the release note from the TP section to here. Covers both bridge and SR-IOV NICs -* You can xref:../../virt/vm_networking/virt-hot-plugging-network-interfaces.adoc#virt-hot-plugging-network-interfaces[hot plug a secondary network interface] to a running virtual machine (VM). Hot plugging and hot unplugging is supported only for VMs created with {VirtProductName} 4.14 or later. Hot unplugging is not supported for Single Root I/O Virtualization (SR-IOV) interfaces. - -//CNV-13680: Connecting OVN-Kubernetes to underlying physical networks. Remove known issue BZ-1885605 after adding this note. -* {VirtProductName} now supports the localnet topology for xref:../../virt/vm_networking/virt-connecting-vm-to-ovn-secondary-network.adoc#virt-connecting-vm-to-ovn-secondary-network[OVN-Kubernetes secondary networks]. A localnet topology connects the secondary network to the physical underlay. This enables both east-west cluster traffic and access to services running outside the cluster, but it requires additional configuration of the underlying Open vSwitch (OVS) system on cluster nodes. - -//CNV-30170: NetworkPolicies filtering using IP blocks with OVN-Kubernetes -* An OVN-Kubernetes secondary network is compatible with the xref:../../networking/multiple_networks/configuring-additional-network.adoc#compatibility-with-multi-network-policy_configuring-additional-network[multi-network policy API], which provides the `MultiNetworkPolicy` custom resource definition (CRD) to control traffic flow to and from VMs. You can use the `ipBlock` attribute to define network policy ingress and egress rules for specific CIDR blocks. - -//CNV-30296: Running DPDK workloads on SR-IOV is now GA. The TP note from 4.13 should have been part of 4.14 as well. -* xref:../../virt/vm_networking//virt-using-dpdk-with-sriov.adoc#virt-configuring-cluster-dpdk_virt-using-dpdk-with-sriov[Configuring a cluster for DPDK workloads on SR-IOV] was previously Technology Preview and is now generally available. - -[id="virt-4-15-storage"] +[id="virt-4-16-storage"] === Storage -//CNV-35029: PVC annotation to explain host-assisted cloning -* When cloning a data volume, the Containerized Data Importer (CDI) chooses an efficient Container Storage Interface (CSI) clone if certain prerequisites are met. Host-assisted cloning, a less efficient method, is used as a fallback. To understand why host-assisted cloning was used, you can check the `cdi.kubevirt.io/cloneFallbackReason` annotation on the cloned persistent volume claim (PVC). - - -[id="virt-4-15-web"] +[id="virt-4-16-web"] === Web console -//CNV-34697: Instance types is now GA. Move the 4.14 RN from the TP section to here. -* Installing and editing xref:../../virt/virtual_machines/creating_vms_rh/virt-creating-vms-from-instance-types.adoc#virt-creating-vm-instancetype_virt-creating-vms-from-instance-types[customized instance types] and preferences to create a virtual machine (VM) from a volume or persistent volume claim (PVC) was previously Technology Preview and is now generally available. -//CNV-33122: Virtualization page updates for 4.15 -* The *Preview features* tab can now be found under *Virtualization* -> *Overview* -> *Settings*. - -//CNV-36165: VM disks with persistent reservation. -* You can configure disk sharing for ordinary virtual machine (VM) or LUN-backed VM disks to allow multiple VMs to share the same underlying storage. Any disk to be shared must be in block mode. -+ -To allow a LUN-backed block mode VM disk to be shared among multiple VMs, a cluster administrator must enable the SCSI `persistentReservation` feature gate. -+ -For more information, see xref:../../virt/virtual_machines/virtual_disks/virt-configuring-shared-volumes-for-vms.adoc#virt-configuring-shared-volumes-for-vms[Configuring shared volumes for virtual machines]. - -//CNV-36162: Search option in VM configuration tab -* You can now search for VM configuration settings in the *Configuration* tab of the *VirtualMachine details* page. - -//CNV-36159: New configuration option "SSH over NodePort service" -* You can now configure *SSH over NodePort service* under *Virtualization* -> *Overview* -> *Settings* -> *Cluster* -> *General settings* -> *SSH configurations*. - -//CNV-36603: Mark bootable volumes as favorite -* When creating a VM from an instance type, you can now designate favorite bootable volumes by starring them in the volume list of the {product-title} web console. - -//CNV-36464: Run a test that shows that the SR-IOV settings are correct -* You can run a VM xref:../../virt/monitoring/virt-running-cluster-checkups.adoc#virt-measuring-latency-vm-secondary-network_virt-running-cluster-checkups[latency checkup] by using the web console. From the side menu, click *Virtualization* -> *Checkups* -> *Network latency*. -To run your first checkup, click *Install permissions* and then click *Run checkup*. - -//CNV-28718: Storage checks -* You can run a storage validation xref:../../virt/monitoring/virt-running-cluster-checkups.adoc#virt-running-cluster-checkups[checkup] by using the web console. From the side menu, click *Virtualization* -> *Checkups* -> *Storage*. -To run your first checkup, click *Install permissions* and then click *Run checkup*. - -//CNV-33131: Set KSM from the UI -* You can enable or disable the xref:../../virt/virtual_machines/advanced_vm_management/virt-activating-ksm.adoc#virt-activating-ksm[kernel samepage merging (KSM) activation feature] for all cluster nodes by using the xref:../../virt/virtual_machines/advanced_vm_management/virt-activating-ksm.adoc#virt-configure-ksm-web_virt-activating-ksm[web console]. - -//CNV-33127: SR-IOV NIC hot plug from the UI - -//CNV-31114: Using SSH key secret from another project -* You can now use existing secrets from other projects when xref:../../virt/virtual_machines/virt-accessing-vm-ssh.adoc#static-key-management-vm[adding a public SSH key during VM creation] or when xref:../../virt/virtual_machines/virt-edit-vms.adoc#virt-adding-secret-configmap-service-account-to-vm_virt-edit-vms[adding a secret to an existing VM]. - -//CNV-30307 -* You can now xref:../../virt/vm_networking/virt-connecting-vm-to-ovn-secondary-network.adoc#virt-creating-nad-localnet-console_virt-connecting-vm-to-ovn-secondary-network[create a network attachment definition (NAD) for OVN-Kubernetes localnet topology] by using the {product-title} web console. - - -//NOTE: Comment out deprecated and removed features (and their IDs) if not used in a release -[id="virt-4-15-deprecated-removed"] +[id="virt-4-16-deprecated-removed"] == Deprecated and removed features +//NOTE: Comment out deprecated and removed features (and their IDs) if not used in a release - -[id="virt-4-15-deprecated"] +[id="virt-4-16-deprecated"] === Deprecated features -// NOTE: when uncommenting deprecated features list, change the Removed features header level below to === +// NOTE: When uncommenting deprecated features list, change the Removed features header level below to === Deprecated features are included in the current release and supported. However, they will be removed in a future release and are not recommended for new deployments. @@ -171,23 +96,18 @@ Deprecated features are included in the current release and supported. However, //CNV-29048 Release note: Metrics name changes //Commenting out for 4.15. No response from devs about updating the article link for 4.15 -//* Many OpenShift Virtualization metrics have changed or will change in a future version. These changes could affect your custom dashboards. See link:https://access.redhat.com/articles/7028805[OpenShift Virtualization 4.14 metric changes] for details. +//* Many OpenShift Virtualization metrics have changed or will change in a future version. These changes could affect your custom dashboards. See link:https://access.redhat.com/articles/7028805[OpenShift Virtualization 4.14 metric changes] for details. //CNV-32032 Release note: DEPRECATED FEATURE (Windows 2012R2 templates deprecated) * Support for Windows Server 2012 R2 templates is deprecated. -[id="virt-4-15-removed"] +[id="virt-4-16-removed"] === Removed features Removed features are not supported in the current release. -//CNV-23499: Carry over/repeat removed feature from 4.12 -//Leaving this as is for 4.15 -* Support for the legacy HPP custom resource, and the associated storage class, has been removed for all new deployments. In {VirtProductName} {VirtVersion}, the HPP Operator uses the Kubernetes Container Storage Interface (CSI) driver to configure local storage. A legacy HPP custom resource is supported only if it had been installed on a previous version of {VirtProductName}. - - -[id="virt-4-15-technology-preview"] +[id="virt-4-16-technology-preview"] == Technology Preview features Some features in this release are currently in Technology Preview. These experimental features are not intended for production use. Note the following scope of support on the Red Hat Customer Portal for these features: @@ -203,37 +123,33 @@ link:https://access.redhat.com/support/offerings/techpreview[Technology Preview //CNV-33125: Add CPU limits to the UI * Cluster admins can now enable CPU resource limits on a namespace in the {product-title} web console under *Overview* -> *Settings* -> *Cluster* -> *Preview features*. -[id="virt-4-15-bug-fixes"] +[id="virt-4-16-bug-fixes"] == Bug fixes -* Previously, the `windows-efi-installer` pipeline failed when started with a storage class that had the `volumeBindingMode` set to `WaitForFirstConsumer`. This fix removes the annotation in the `StorageClass` object that was causing the pipelines to fail. (link:https://issues.redhat.com/browse/CNV-32287[*CNV-32287*]) -* Previously, if you simultaneously cloned approximately 1000 virtual machines (VMs) using the provided data sources in the `openshift-virtualization-os-images` namespace, not all of the VMs moved to a running state. With this fix, you can clone a large number of VMs concurrently. (link:https://issues.redhat.com/browse/CNV-30083[*CNV-30083*]) - -* Previously, you could not SSH into a VM by using a `NodePort` service and its associated fully qualified domain name (FQDN) displayed in the web console when using `networkType: OVNKubernetes` in your `install-config.yaml` file. With this update, you can configure the web console so it shows a valid accessible endpoint for SSH `NodePort` services. (link:https://issues.redhat.com/browse/CNV-24889[*CNV-24889*]) - -* With this update, live migration no longer fails for a virtual machine instance (VMI) after hot plugging a virtual disk. (link:https://issues.redhat.com/browse/CNV-34761[*CNV-34761*]) - - -[id="virt-4-15-known-issues"] +[id="virt-4-16-known-issues"] == Known issues [discrete] -[id="virt-4-15-ki-monitoring"] +[id="virt-4-16-ki-monitoring"] ==== Monitoring //fix targeted for 4.16 * The Pod Disruption Budget (PDB) prevents pod disruptions for migratable virtual machine images. If the PDB detects pod disruption, then `openshift-monitoring` sends a `PodDisruptionBudgetAtLimit` alert every 60 minutes for virtual machine images that use the `LiveMigrate` eviction strategy. (link:https://issues.redhat.com/browse/CNV-33834[*CNV-33834*]) ** As a workaround, xref:../../monitoring/managing-alerts.adoc#silencing-alerts_managing-alerts[silence alerts]. +[discrete] +[id="virt-4-16-ki-networking"] +==== Networking + [discrete] -[id="virt-4-15-ki-nodes"] +[id="virt-4-16-ki-nodes"] ==== Nodes //4.15 Keep per Stu and Simone * Uninstalling {VirtProductName} does not remove the `feature.node.kubevirt.io` node labels created by {VirtProductName}. You must remove the labels manually. (link:https://issues.redhat.com/browse/CNV-38543[*CNV-38543*]) [discrete] -[id="virt-4-15-ki-storage"] +[id="virt-4-16-ki-storage"] ==== Storage //4.15 Keep per Alex Kalenyuk Issue is closed as "Not a bug" but is still a known issue * If you use Portworx as your storage solution on AWS and create a VM disk image, the created image might be smaller than expected due to the filesystem overhead being accounted for twice. (link:https://issues.redhat.com/browse/CNV-32695[*CNV-32695*]) @@ -250,7 +166,7 @@ link:https://access.redhat.com/support/offerings/techpreview[Technology Preview [discrete] -[id="virt-4-15-ki-virtualization"] +[id="virt-4-16-ki-virtualization"] ==== Virtualization // new for 4.15 @@ -277,8 +193,12 @@ Legacy OpenSSL clients that do not support EMS or TLS 1.3 now cannot connect to [discrete] -[id="virt-4-15-ki-webconsole"] +[id="virt-4-16-ki-webconsole"] ==== Web console //CNV-38293 -* When you first deploy an {product-title} cluster, creating VMs from templates or instance types by using the web console fails if you do not have `cluster-admin` permissions. -** As a workaround, the cluster administrator must first xref:../../nodes/pods/nodes-pods-configmaps.adoc#nodes-pods-configmap-create-from-console_configmaps[create a config map] to enable other users to use templates and instance types to create VMs. (link: https://issues.redhat.com/browse/CNV-38284[*CNV-38284*]) \ No newline at end of file +* When you first deploy an {product-title} cluster, creating VMs from templates or instance types by using the web console, fails if you do not have `cluster-admin` permissions. +** As a workaround, the cluster administrator must first xref:../../nodes/pods/nodes-pods-configmaps.adoc#nodes-pods-configmap-create-from-console_configmaps[create a config map] to enable other users to use templates and instance types to create VMs. (link: https://issues.redhat.com/browse/CNV-38284[*CNV-38284*]) + +//CNV-38593: RN: Known issue Remove invalid annotation from "OVN Kubernetes secondary localnet network" +* When you create a network attachment definition (NAD) for an OVN-Kubernetes localnet topology by using the web console, the invalid annotation `k8s.v1.cni.cncf.io/resourceName: openshift.io/` appears. This annotation prevents the starting of the VM. +** As a workaround, remove the annotation.