Skip to content

4.21.0.0 release notes updates #549

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sureshanaparti merged 3 commits into from
Aug 28, 2025
Merged

4.21.0.0 release notes updates #549

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
e3f0ca2
4.21.0.0 release notes updates
sureshanaparti Aug 28, 2025
21b5ae6
Updated API changes
sureshanaparti Aug 28, 2025
413f707
Updated known issues
sureshanaparti Aug 28, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 12 additions & 12 deletions source/_global.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,20 +25,20 @@

.. Latest version systemvm template name

.. |sysvm64-version| replace:: 4.20.1
.. |sysvm64-name-xen| replace:: systemvm-xenserver-4.20.1-x86_64
.. |sysvm64-name-kvm| replace:: systemvm-kvm-4.20.1-x86_64
.. |sysvm64-name-vmware| replace:: systemvm-vmware-4.20.1-x86_64
.. |sysvm64-name-hyperv| replace:: systemvm-hyperv-4.20.1-x86_64
.. |sysvm64-name-ovm| replace:: systemvm-ovm-4.20.1-x86_64
.. |sysvm64-version| replace:: 4.20.2
.. |sysvm64-name-xen| replace:: systemvm-xenserver-4.20.2-x86_64
.. |sysvm64-name-kvm| replace:: systemvm-kvm-4.20.2-x86_64
.. |sysvm64-name-vmware| replace:: systemvm-vmware-4.20.2-x86_64
.. |sysvm64-name-hyperv| replace:: systemvm-hyperv-4.20.2-x86_64
.. |sysvm64-name-ovm| replace:: systemvm-ovm-4.20.2-x86_64

.. Latest version systemvm template URL
.. |sysvm64-url-xen| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.1-x86_64-xen.vhd.bz2
.. |sysvm64-url-kvm| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.1-x86_64-kvm.qcow2.bz2
.. |sysvm64-url-kvm-aarch64| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.1-aarch64-kvm.qcow2.bz2
.. |sysvm64-url-vmware| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.1-x86_64-vmware.ova
.. |sysvm64-url-hyperv| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.1-x86_64-hyperv.vhd.zip
.. |sysvm64-url-ovm| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.1-x86_64-ovm.raw.bz2
.. |sysvm64-url-xen| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.2-x86_64-xen.vhd.bz2
.. |sysvm64-url-kvm| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.2-x86_64-kvm.qcow2.bz2
.. |sysvm64-url-kvm-aarch64| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.2-aarch64-kvm.qcow2.bz2
.. |sysvm64-url-vmware| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.2-x86_64-vmware.ova
.. |sysvm64-url-hyperv| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.2-x86_64-hyperv.vhd.zip
.. |sysvm64-url-ovm| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.2-x86_64-ovm.raw.bz2

.. Images

Expand Down
4 changes: 2 additions & 2 deletions source/conf.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,9 @@
author = 'Apache CloudStack Project'

# The short X.Y version
version = '4.20'
version = '4.21'
# The full version, including alpha/beta/rc tags
release = '4.20.1.0'
release = '4.21.0.0'

rst_epilog = """
.. include:: /_global.rst
Expand Down
95 changes: 29 additions & 66 deletions source/releasenotes/about.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,71 +17,34 @@
What's New in |release|
=======================

Apache CloudStack |release| is a 4.20 LTS minor release with over 150 fixes
and improvements since the 4.20.0.0 release. Some of the highlights include:

• Improvements to multi-architecture support in CloudStack
• vTPM support for KVM and VMware
• Support for XenServer 8.4 / XCP-ng 8.3
• Added support for VMware 80u2 and 80u3
• Updated Sysyem VM template to Debian 12.11
• NAS B&R improvements
• Experimental Support of EL10 as Management Server and KVM host


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

What's New in 4.20.0.0
=======================

Apache CloudStack 4.20.0.0 is the initial 4.20 LTS release with 190+ new
features, improvements and bug fixes since 4.19, including 15 major
new features. Some of the highlights include:

• Webhooks
• Dynamic and Static Routing
• Ceph RGW Object Store Support
• NSX integration
• Shared Filesystems
• Multi-arch Zones
• Simple NAS backup plugin for KVM
• Usage UI
• API documentation in UI

Apache CloudStack |release| is a 4.21 Regular release with 15 new features,
around 40 improvements and more than 150 bug fixes since the 4.20.1.0 release.
Some of the highlights include:

• CloudStack Extensions Framework and Orchestrate Anything extension, with built-in extensions for Proxmox and Hyper-V
Copy link
Contributor

@shwstppr shwstppr Aug 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
• CloudStack Extensions Framework and Orchestrate Anything extension, with built-in extensions for Proxmox and Hyper-V
• CloudStack Extensions Framework - Introducing Orchestrator extension, with inbuilt extensions for Proxmox and Hyper-V

Copy link
Contributor

@shwstppr shwstppr Aug 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

cc @rohityadavcloud @msinhore if you've a better phrase here

• GPU Integration with KVM in CloudStack (Technical Preview)
• Netris Network Plugin Integration
• Cloudian HyperStore Object Store Plugin Integration
• CloudStack Kubernetes Service (CKS) Enhancements
• Create Instance from Backup
• Instance Lease (Automatic Stop/Deletion)
• Backup and Object Storage Limits
• Virtual Trusted Platform Module (vTPM) Support
Copy link
Contributor

@shwstppr shwstppr Aug 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this be a little higher in the list?

Copy link
Contributor Author

@sureshanaparti sureshanaparti Aug 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same as above ^^^

• Support for KVM on s390x (IBM Z and LinuxONE) architecture
Copy link
Contributor

@shwstppr shwstppr Aug 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure about highlighting this but I don't know of compatibility

Copy link
Contributor Author

@sureshanaparti sureshanaparti Aug 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

agree, PR is in & seems tested

• Management Server Maintenance Mode
• Incremental Volume Snapshots for KVM
• File-Based Disk-Only Instance Snapshots with KVM
• Reconciliation of VM and Volume Copy/Migrate operations for KVM agent
• Storage Access Groups
• Volume Allocation Algorithm Support
• VMware to KVM migration improvements
• Storage plugins - Ceph, PowerFlex, StorPool, Linstor related fixes and improvements
Copy link
Contributor

@shwstppr shwstppr Aug 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There was some StorPool related improvement around cross-zone stuff, not sure if it can be highlighted

Copy link
Contributor Author

@sureshanaparti sureshanaparti Aug 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

there are other fixes/improvements, not including all, it's high-level summary and is in sync with the announcement

• Several UI fixes and improvements, including Deploy Instance Form, Announcement Banner, etc

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

• Usage data for Instance Backups does not update after the final backup of an Instance is deleted

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

Log4j Upgrade
=============

Up until 4.19.x.x, the logging library used for the project was Log4j 1.29.
The 4.20.0.0 version has updated the library to Log4j2. The new Log4j2 configuration file format is not backwards
compatible with the old one. The 4.20.0.0 packages will come with the default configuration files updated.
Users that have made customizations to their files must update their configuration files to match with the new format,
the `official Log4j documentation`_ might help you migrate your custom configurations.

JRE Upgrade
============

Up until 4.19.x.x, the JRE used for ACS was JRE 11. In 4.20.0.0, JRE has been upgraded to JRE 17 as JRE 11 has reached EOL.
This means that Centos7 (EL7) is no longer supported.

.. _official Log4j documentation: https://logging.apache.org/log4j/2.x/migrate-from-log4j1.html

Events Message Bus Change
=========================
On upgrading from 4.19.x or lower, existing AMQP or Kafka integration
configurations should be moved from folder
``/etc/cloudstack/management/META-INF/cloudstack/core`` to
``/etc/cloudstack/management/META-INF/cloudstack/event``

Guest OS Categories Change
==========================

The guest operating system categories have been updated in 4.21, resulting in a
reorganization of the guest operating systems with respect to categories.

If the ``oscategoryid`` functionality for hosts is being used, ensure it is
pointing to the correct guest operating system category ID.
https://docs.cloudstack.apache.org/en/4.21.0.0/releasenotes/changes.html
Loading