.. Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file
   distributed with this work for additional information#
   regarding copyright ownership.  The ASF licenses this file
   to you under the Apache License, Version 2.0 (the
   "License"); you may not use this file except in compliance
   with the License.  You may obtain a copy of the License at
   http://www.apache.org/licenses/LICENSE-2.0
   Unless required by applicable law or agreed to in writing,
   software distributed under the License is distributed on an
   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
   KIND, either express or implied.  See the License for the
   specific language governing permissions and limitations
   under the License.


What's New in |release|
=======================

Apache CloudStack |release| is a 4.22 LTS minor release with around 290 fixes
and improvements since the 4.22.0.0 release. Some of the highlights include:

• VMware-to-KVM migration fixes and improvements, including VDDK support and guest OS handling
• GPU domain parsing fixes and PCI display controller support
• Support configurable settings in the Proxmox Extension
• Host VM power reporting improvements in Extensions
• Support UEFI on KVM hosts by default with preconfigured default settings.
• B&R enhancements, including NAS backup support with Linstor, timeout configuration support and other backup fixes
• KVM Host HA improvements and heartbeat enhancements for SharedMountPoint storage
• Support for creating volumes directly on a specified storage pool
• Support KVM import and unmanage operations for SharedMountPoint pools
• Support to list and query async jobs by resource
• Better VM lifecycle handling, including reserved resource cleanup and improved expunge error reporting
• Networking fixes and improvements for NSX, Routed VPCs, Load Balancer rules, Static Routes, and VPN DH groups
• Incremental volume snapshot fixes and snapshot rollback reliability improvements for KVM
• Storage plugins - Ceph, Linstor, PowerFlex related fixes and improvements
• Some CKS related fixes and improvements
• Several UI fixes and improvements

The full list of new features can be found in the project release notes at
https://docs.cloudstack.apache.org/en/4.22.1.0/releasenotes/changes.html

What's in since 4.22.0.0
========================

Apache CloudStack 4.22.0.0 is the initial 4.22 LTS release with 10 new features,
around 15 improvements and more than 140 bug fixes since the 4.21.0.0 release.
Some of the highlights include:

• Enhanced Backup and Disaster Recovery
• SSL Offloading for Load Balancers
• Baremetal/MaaS Extension
• CSI Driver for CKS
• Console Access for Proxmox in Extensions Framework
• VMware-to-KVM Migration Enhancements
• Snapshot/Backup Schedule Listing
• Per-Zone Console Proxy Configuration
• Direct Volume Migrations by-passing Secondary Storage
• Persistent domain for unmanaged KVM instances from CS
• Support for User Data on System VMs
• EL10 & OpenSUSE 15.6 Platform Support
• Stronger Checksum Algorithm (SHA-512)
• Enable KVM Volume and VM snapshot by default
• Support XZ compression format for template registration with KVM
• Support for Shared Filesystem on Networks with Config Drive

Known Issues
------------

• Starting 4.21 VM snapshots are supported for instances on KVM hosts. However, volume snapshots and VM snapshots cannot coexist.
  Restoring a volume snapshot will remove any existing VM snapshots and may lead to data loss.
  There is a UI issue where error messages in such scenarios may not clearly indicate the problem.

• When managing and unmanaging UEFI-based VMs on KVM hosts, migration of such VMs may fail in certain scenarios.
  This typically occurs when a VM that was unmanaged and later re-imported is started on a different host and then
  migrated back to its original host. The migration fails because the VM domain still exists on the original host,
  resulting in a conflict. As a workaround, manually remove the old domain from the original host before attempting the migration again.

The full list of new features can be found in the project release notes at
https://docs.cloudstack.apache.org/en/4.22.0.0/releasenotes/changes.html