Skip to content
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.

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

4.19 release docs #381

Merged
merged 7 commits into from
Feb 6, 2024
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
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
22 changes: 11 additions & 11 deletions source/_global.rst
Original file line number Diff line number Diff line change
Expand Up @@ -25,19 +25,19 @@

.. Latest version systemvm template name

.. |sysvm64-version| replace:: 4.18.1
.. |sysvm64-name-xen| replace:: systemvm-xenserver-4.18.1
.. |sysvm64-name-kvm| replace:: systemvm-kvm-4.18.1
.. |sysvm64-name-vmware| replace:: systemvm-vmware-4.18.1
.. |sysvm64-name-hyperv| replace:: systemvm-hyperv-4.18.1
.. |sysvm64-name-ovm| replace:: systemvm-ovm-4.18.1
.. |sysvm64-version| replace:: 4.19.0
.. |sysvm64-name-xen| replace:: systemvm-xenserver-4.19.0
.. |sysvm64-name-kvm| replace:: systemvm-kvm-4.19.0
.. |sysvm64-name-vmware| replace:: systemvm-vmware-4.19.0
.. |sysvm64-name-hyperv| replace:: systemvm-hyperv-4.19.0
.. |sysvm64-name-ovm| replace:: systemvm-ovm-4.19.0

.. Latest version systemvm template URL
.. |sysvm64-url-xen| replace:: http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.1-xen.vhd.bz2
.. |sysvm64-url-kvm| replace:: http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.1-kvm.qcow2.bz2
.. |sysvm64-url-vmware| replace:: http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.1-vmware.ova
.. |sysvm64-url-hyperv| replace:: http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.1-hyperv.vhd.zip
.. |sysvm64-url-ovm| replace:: http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.1-ovm.raw.bz2
.. |sysvm64-url-xen| replace:: http://download.cloudstack.org/systemvm/4.19/systemvmtemplate-4.19.0-xen.vhd.bz2
.. |sysvm64-url-kvm| replace:: http://download.cloudstack.org/systemvm/4.19/systemvmtemplate-4.19.0-kvm.qcow2.bz2
.. |sysvm64-url-vmware| replace:: http://download.cloudstack.org/systemvm/4.19/systemvmtemplate-4.19.0-vmware.ova
.. |sysvm64-url-hyperv| replace:: http://download.cloudstack.org/systemvm/4.19/systemvmtemplate-4.19.0-hyperv.vhd.zip
.. |sysvm64-url-ovm| replace:: http://download.cloudstack.org/systemvm/4.19/systemvmtemplate-4.19.0-ovm.raw.bz2

.. Images

Expand Down
4 changes: 2 additions & 2 deletions source/conf.py
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.18'
version = '4.19'
# The full version, including alpha/beta/rc tags
release = '4.18.1.0'
release = '4.19.0.0'

rst_epilog = """
.. include:: /_global.rst
Expand Down
101 changes: 37 additions & 64 deletions source/releasenotes/about.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,79 +17,52 @@
What's New in |release|
=======================

Apache CloudStack |release| is a 4.18 LTS minor release with 196 fixes
since the 4.18.0.0 release. Some of the highlights include:

• Support Managed User Data in AutoScale VM groups
• Support CKS (CloudStack Kubernetes Cluster) in VPC tiers
• Support for VMware 8.0.0.x
• Several Hypervisor (VMware, KVM, XenServer) fixes and improvements
• Several UI fixes and improvements
• Several Network (L2, VXLAN, etc) fixes and improvements
• Several System VM (CPVM, SSVM) fixes and improvements
• Improve Solidfire storage plugin integration on VMware
• Support volume migration in ScaleIO/PowerFlex within and across ScaleIO/PowerFlex storage clusters
• Volume encryption support for StorPool
• Fix CloudStack upgrade with some MySQL versions
• Fix guest OSes and guest OS mappings in CloudStack database
Apache CloudStack |release| is the initial 4.19 LTS release. It has over 300 fixes
and features since the 4.18.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.18.1.0/releasenotes/changes.html
https://docs.cloudstack.apache.org/en/4.19.0.0/releasenotes/changes.html

What's in since 4.18.0.0
======================
What's in since 4.19.0.0
========================

Apache CloudStack 4.18.0.0 is the initial 4.18 LTS release with 300+ new
features, improvements and bug fixes since 4.17, including 19 major
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
new features. Some of the highlights include:

• Edge Zones
• Autoscaling
• Managed User Data
• Two-Factor Authentication Framework
• Support for Time-based OTP (TOTP) Authenticator
• Volume Encryption
• SDN Integration – Tungsten Fabric
• Ceph Multi Monitor Support
• API-Driven Console Access
• Console Access Security Improvements
• New Global settings UI
• Configurable MTU for VR
• Adaptative Affinity Groups
• Custom DNS Servers for Networks
• Improved Guest OS Support Framework
• Support for Enterprise Linux 9
• Networker Backup Plugin for KVM Hypervisor
• Custom Quota Tariffs
• Secure VNC for KVM
• 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

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

.. _guestosids

Possible Issue with Guest OS IDs
================================

It has been noticed during upgrade testing that some environment, where
custom guest OSses where added and mapping for those OSses where added,
problems may occur during upgrade. Part of the mitigation is to make sure
OSses that are newly mapped but should have already been in the guest_os
table are there. Make sure you apply those before you start the new 4.18
management server.

first check which of the guest_os entries you miss:

.. parsed-literal::

SELECT * FROM cloud.guest_os WHERE display_name IN (´CentOS 8´, ´Debian GNU/Linux 10 (32-bit)´, ´Debian GNU/Linux 10 (64-bit)´, ´SUSE Linux Enterprise Server 15 (64-bit)´, ´Windows Server 2019 (64-bit)´)

Then apply any of the following lines that you might need.

.. parsed-literal::
Possible Issue with volume snapshot revert with KVM
===================================================

INSERT INTO cloud.guest_os (uuid, category_id, display_name, created, is_user_defined) VALUES (UUID(), '1', 'CentOS 8', now(), '0');
INSERT INTO cloud.guest_os (uuid, category_id, display_name, created, is_user_defined) VALUES (UUID(), '2', 'Debian GNU/Linux 10 (32-bit)', now(), '0');
INSERT INTO cloud.guest_os (uuid, category_id, display_name, created, is_user_defined) VALUES (UUID(), '2', 'Debian GNU/Linux 10 (64-bit)', now(), '0');
INSERT INTO cloud.guest_os (uuid, category_id, display_name, created, is_user_defined) VALUES (UUID(), '5', 'SUSE Linux Enterprise Server 15 (64-bit)', now(), '0');
INSERT INTO cloud.guest_os (uuid, category_id, display_name, created, is_user_defined) VALUES (UUID(), '6', 'Windows Server 2019 (64-bit)', now(), '0');
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 snapshots on the primary storage.
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
Copy link
Contributor

Choose a reason for hiding this comment

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

Perhaps we can add more explicit checks on this part on how to find the file from database?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@nvazquez done

if the snapshot is created with any of these CloudStack versions.
Loading
Loading