From 3374fa2f9ecbd0efc403e167cb91d57f6e80b4ac Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Jandre?= Date: Mon, 14 Oct 2024 15:34:50 -0300 Subject: [PATCH 01/11] Update docs for 4.20 --- source/_global.rst | 22 +- source/conf.py | 4 +- source/releasenotes/about.rst | 130 +- source/releasenotes/api-changes.rst | 2894 +++++++++++---------- source/releasenotes/changes.rst | 2111 +++------------ source/releasenotes/compat.rst | 2 +- source/upgrading/index.rst | 1 + source/upgrading/upgrade/upgrade-4.20.rst | 303 +++ 8 files changed, 2251 insertions(+), 3216 deletions(-) create mode 100644 source/upgrading/upgrade/upgrade-4.20.rst diff --git a/source/_global.rst b/source/_global.rst index 0e5c15a353..a3efb2bf92 100644 --- a/source/_global.rst +++ b/source/_global.rst @@ -25,19 +25,19 @@ .. Latest version systemvm template name -.. |sysvm64-version| replace:: 4.19.1 -.. |sysvm64-name-xen| replace:: systemvm-xenserver-4.19.1 -.. |sysvm64-name-kvm| replace:: systemvm-kvm-4.19.1 -.. |sysvm64-name-vmware| replace:: systemvm-vmware-4.19.1 -.. |sysvm64-name-hyperv| replace:: systemvm-hyperv-4.19.1 -.. |sysvm64-name-ovm| replace:: systemvm-ovm-4.19.1 +.. |sysvm64-version| replace:: 4.20 +.. |sysvm64-name-xen| replace:: systemvm-xenserver-4.20 +.. |sysvm64-name-kvm| replace:: systemvm-kvm-4.20 +.. |sysvm64-name-vmware| replace:: systemvm-vmware-4.20 +.. |sysvm64-name-hyperv| replace:: systemvm-hyperv-4.20 +.. |sysvm64-name-ovm| replace:: systemvm-ovm-4.20 .. Latest version systemvm template URL -.. |sysvm64-url-xen| replace:: http://download.cloudstack.org/systemvm/4.19/systemvmtemplate-4.19.1-xen.vhd.bz2 -.. |sysvm64-url-kvm| replace:: http://download.cloudstack.org/systemvm/4.19/systemvmtemplate-4.19.1-kvm.qcow2.bz2 -.. |sysvm64-url-vmware| replace:: http://download.cloudstack.org/systemvm/4.19/systemvmtemplate-4.19.1-vmware.ova -.. |sysvm64-url-hyperv| replace:: http://download.cloudstack.org/systemvm/4.19/systemvmtemplate-4.19.1-hyperv.vhd.zip -.. |sysvm64-url-ovm| replace:: http://download.cloudstack.org/systemvm/4.19/systemvmtemplate-4.19.1-ovm.raw.bz2 +.. |sysvm64-url-xen| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0.0-x86_64-xen.vhd.bz2 +.. |sysvm64-url-kvm| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0.0-x86_64-kvm.qcow2.bz2 +.. |sysvm64-url-vmware| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0.0-x86_64-vmware.ova +.. |sysvm64-url-hyperv| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0.0-x86_64-hyperv.vhd.zipp +.. |sysvm64-url-ovm| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0.0-x86_64-ovm.raw.bz2 .. Images diff --git a/source/conf.py b/source/conf.py index ae4b057a87..277e874e1e 100644 --- a/source/conf.py +++ b/source/conf.py @@ -24,9 +24,9 @@ author = 'Apache CloudStack Project' # The short X.Y version -version = '4.19' +version = '4.20' # The full version, including alpha/beta/rc tags -release = '4.19.1.0' +release = '4.20.0.0' rst_epilog = """ .. include:: /_global.rst diff --git a/source/releasenotes/about.rst b/source/releasenotes/about.rst index eb5d5f66b2..4eaa7bbb0e 100644 --- a/source/releasenotes/about.rst +++ b/source/releasenotes/about.rst @@ -17,128 +17,40 @@ What's New in |release| ======================= -Apache CloudStack |release| is a 4.19 LTS minor release with over 300 fixes -and improvements since the 4.19.0.0 release. Some of the highlights include: - -• Improvements for VMware migration to KVM -• Support to manage/unmanage DATA volume of a primary storage on KVM -• Support for NFS mount options for a primary storage on KVM -• Support to change storage pool scope from Cluster to Zone and vice versa -• Support for RHEL/OL/Rocky/Alma Linux in the same cluster -• Import from remote KVM enhancements -• Storage plugins, PowerFlex, StorPool, Linstor related fixes and improvements -• Some CKS, Veeam (B&R) related fixes and improvements -• Several UI fixes and improvements +Apache CloudStack |release| is the initial 4.20 LTS release. It has over 190 fixes +and features since the 4.19.1.0 release. The full list of fixes and improvements can be found in the project release notes at -https://docs.cloudstack.apache.org/en/4.19.1.0/releasenotes/changes.html +https://docs.cloudstack.apache.org/en/4.20.0.0/releasenotes/changes.html -What's in since 4.19.0.0 +What's in since 4.20.0.0 ======================== -Apache CloudStack 4.19.0.0 is the initial 4.19 LTS release with 300+ new -features, improvements and bug fixes since 4.18, including 26 major +Apache CloudStack 4.20.0.0 is the initial 4.20 LTS release with 190f+ new +features, improvements and bug fixes since 4.19, including 15 major new features. Some of the highlights include: -• CloudStack Object Storage Feature -• VMware to KVM Migration -• KVM Import -• CloudStack DRS -• OAuth2 Authentication -• VNF Appliances Support -• CloudStack DRS -• CloudStack Snapshot Copy -• Scheduled Instance Lifecycle Operations -• Guest OS Management -• Pure Flash Array and HPE-Primera Support -• User-specified source NAT -• Storage Browser -• Safe CloudStack Shutdown -• New CloudStack Dashboard -• Domain migration -• Flexible tags for hosts and storage pools -• Support for Userdata in Autoscale Groups -• KVM Host HA for StorPool storage -• Dynamic secondary storage selection -• Domain VPCs -• Global ACL for VPCs +• Webhooks +• Dynamic and Static Routing +• Ceph RGW Object Store Support +• NSX integration +• Shared Filesystem +• Multi-arch Zones + The full list of new features can be found in the project release notes at -https://docs.cloudstack.apache.org/en/4.19.0.0/releasenotes/changes.html +https://docs.cloudstack.apache.org/en/4.20.0.0/releasenotes/changes.html .. _guestosids -Possible Issue with volume snapshot revert with KVM -=================================================== - -Between versions 4.17.x, 4.18.0 and 4.18.1, KVM volume snapshot backups were -not full snapshots and they rely on the primary storage as a backing store. -To prevent any loss of data, care must be taken during revert operation and -it must be ensured that the source primary storage snapshot file is present -if the snapshot is created with any of these CloudStack versions. - -Users will have a backing store in their volume snapshots in the following cases: - -- the snapshots are from a ROOT volume created from template; - -Users will not have a backing store in their volume snapshots in the following cases: - -- the snapshots are from ROOT volumes created with ISO; -- the snapshots are from DATADISK volumes; - -Following there are two queries to help users identify snapshots with a backing store: - -Identify snapshots that were not removed yet and were created from a volume that was created from a template: - -.. parsed-literal:: - SELECT s.uuid AS "Snapshot ID", - s.name AS "Snapshot Name", - s.created AS "Snapshot creation datetime", - img_s.uuid AS "Sec Storage ID", - img_s.name AS "Sec Storage Name", - ssr.install_path AS "Snapshot path on Sec Storage", - v.uuid AS "Volume ID", - v.name AS "Volume Name" - FROM cloud.snapshots s - INNER JOIN cloud.volumes v ON (v.id = s.volume_id) - INNER JOIN cloud.snapshot_store_ref ssr ON (ssr.snapshot_id = s.id - AND ssr.store_role = 'Image') - INNER JOIN cloud.image_store img_s ON (img_s.id = ssr.store_id) - WHERE s.removed IS NULL - AND v.template_id IS NOT NULL; - -With that, one can use qemu-img info in the snapshot file to check if they have a backing store. - -For those snapshots that have a backing store, one can use the following query to check which template is it and in which storage pool it is: - -.. parsed-literal:: - SELECT vt.uuid AS "Template ID", - vt.name AS "Template Name", - tsr.install_path AS "Template file on Pri Storage", - sp.uuid AS "Pri Storage ID", - sp.name AS "Pri Storage Name", - sp.`path` AS "Pri Storage Path", - sp.pool_type as "Pri Storage type" - FROM cloud.template_spool_ref tsr - INNER JOIN cloud.storage_pool sp ON (sp.id = tsr.pool_id AND sp.removed IS NULL) - INNER JOIN cloud.vm_template vt ON (vt.id = tsr.template_id) - WHERE tsr.install_path = "