You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by ro...@apache.org on 2022/09/22 08:00:36 UTC
[cloudstack-documentation] branch 4.17 updated: 4.17.1.0: release notes updates (#287)
This is an automated email from the ASF dual-hosted git repository.
rohit pushed a commit to branch 4.17
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git
The following commit(s) were added to refs/heads/4.17 by this push:
new 2170493 4.17.1.0: release notes updates (#287)
2170493 is described below
commit 2170493f4f6c6cc930c8635033fdc6ca504e707f
Author: Abhishek Kumar <ab...@gmail.com>
AuthorDate: Thu Sep 22 13:30:31 2022 +0530
4.17.1.0: release notes updates (#287)
* 4.17.1.0: release notes updates
Signed-off-by: Abhishek Kumar <ab...@gmail.com>
* fix
Signed-off-by: Abhishek Kumar <ab...@gmail.com>
* typo fix
Signed-off-by: Abhishek Kumar <ab...@gmail.com>
* minor formatting
Signed-off-by: Abhishek Kumar <ab...@gmail.com>
* ubuntu 22.04 support
Signed-off-by: Abhishek Kumar <ab...@gmail.com>
* remove type and priority
Signed-off-by: Abhishek Kumar <ab...@gmail.com>
Signed-off-by: Abhishek Kumar <ab...@gmail.com>
---
source/conf.py | 2 +-
source/releasenotes/about.rst | 17 ++
source/releasenotes/changes.rst | 331 +++++++++++++++++++++++++++++-
source/upgrading/index.rst | 1 +
source/upgrading/upgrade/upgrade-4.17.rst | 299 +++++++++++++++++++++++++++
5 files changed, 648 insertions(+), 2 deletions(-)
diff --git a/source/conf.py b/source/conf.py
index 74fb3c7..fcfea76 100644
--- a/source/conf.py
+++ b/source/conf.py
@@ -26,7 +26,7 @@ author = 'Apache CloudStack Project'
# The short X.Y version
version = '4.17'
# The full version, including alpha/beta/rc tags
-release = '4.17.0.0'
+release = '4.17.1.0'
rst_epilog = """
.. include:: /_global.rst
diff --git a/source/releasenotes/about.rst b/source/releasenotes/about.rst
index d5b0f28..b82f2f7 100644
--- a/source/releasenotes/about.rst
+++ b/source/releasenotes/about.rst
@@ -17,6 +17,23 @@
What's New in |release|
=======================
+Apache CloudStack |release| is a 4.17 LTS minor release with over 150 fixes and
+improvements since the 4.17.0.0 release. Highlights include:
+
+• Support for Ubuntu 22.04 LTS as management server and KVM host
+• Improvements for System VM storage migration on KVM
+• CKS cluster upgrade enhancements
+• Several network and VPC related fixes especially related IPv6 and perimissions
+• KVM libvirt Java library upgrade
+• KVM Shared Mount Point fix
+• VMware local storage volume migration improvements
+
+The full list of fixes and improvements can be found in the project release notes at
+https://docs.cloudstack.apache.org/en/4.17.1.0/releasenotes/changes.html
+
+What's New in 4.17.0.0
+======================
+
Apache CloudStack 4.17.0.0 is a 4.17 LTS release with 383 new
features, improvements and bug fixes since 4.16, including 16 major
new features. Some of the highlights include:
diff --git a/source/releasenotes/changes.rst b/source/releasenotes/changes.rst
index 22d9c67..b4bc018 100644
--- a/source/releasenotes/changes.rst
+++ b/source/releasenotes/changes.rst
@@ -13,6 +13,336 @@
specific language governing permissions and limitations
under the License.
+Changes in |release| since 4.17.0.0
+===================================
+
+Apache CloudStack uses GitHub https://github.com/apache/cloudstack/milestone/25?closed=1
+to track its issues.
+
+.. cssclass:: table-striped table-bordered table-hover
+
+
++-------------------------+----------+------------------------------------------------------------+
+| Version | Github | Description |
++=========================+==========+============================================================+
+| 4.17.1.0 | `#6721`_ | UI fix Theme text color not bind navTextColorPick and |
+| | | reset button |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6725`_ | Reset unusable db connections |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6729`_ | server: fix network upgrade for IPv6 |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6728`_ | upgrade a backported patch |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6730`_ | Jacoco: fix no coverage result in server and some other |
+| | | modules |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6706`_ | systemvm,vr: disable radvd for non-applicable VRs |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6711`_ | ui: Fix netowrkid not passed in deployvm |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6708`_ | UI: fix bulk delete project with cleanup |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6696`_ | kvm: add libvirt host capabilities method for cpu speed |
+| | | retrieval |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6705`_ | server: fix check for ipv6 range overlap |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6707`_ | ui: fix set reservation toggle in add public ip range |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6693`_ | Ignore opensaml's slf4j dependencies |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6688`_ | server: fix scale vm with compute offering having same |
+| | | disk offering |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6643`_ | vmware: fix vm snapshot with datastore cluster, drs |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6687`_ | UI: Remove incorrect API calls when initializing the |
+| | | deploy VM page |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6675`_ | ui: fix update network updateinsequence param |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6655`_ | server: fix error when dedicatingguestvlanrange for |
+| | | physical nw without vlan range |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6671`_ | UI: Fixes suffix icon on project selector not work |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6664`_ | vpc: prevent sourcenat ip disassociation for an active vpc |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6658`_ | cks: fix k8s cluster deployment with host tagged offering |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6276`_ | api, vmware: Allow VM setting/detail for disk controller |
+| | | (root/data) to override template details |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6642`_ | server: remove resource tags for disassociated public ip |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6654`_ | Fix SQL query for uuid wrong format |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6588`_ | server: fix ipv6 network deployment with separate guest nw |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6650`_ | ui: fix resource tags visibility in infocard |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6634`_ | server: fix delete resource tag permission |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6646`_ | ui: fix gputype in add compute offering |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6645`_ | UI - Fixes the warning in detail tab |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6625`_ | vmware,cks: fix attachiso failure with vmware drs |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6636`_ | ui: reset disksize param on offering change in scale vm |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6080`_ | Increase size of column 'value' at table 'account_details' |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6622`_ | Fixes #6621 - Update host memory stats |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6552`_ | removed the use of SharedMountPoint storage type for the |
+| | | StorPool plugin |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6591`_ | vpc,network: fix createLoadBalancer access on user network |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6616`_ | ui: use ssh keypair uuid for listing |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6549`_ | test,xcp-ng: fix tests for VM PV driver issue |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6341`_ | Enable system VM volume migration for KVM |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6612`_ | ui: fix hypervisortrafficlabel for phy nw traffic |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6598`_ | UI: Fix delete ISO navigation after job is finished |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6605`_ | Shows quotaSummary in API documentation |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6607`_ | UI: Fixes notification error can't close when exit config |
+| | | limit tab |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6600`_ | ui: fix icon for vr migrate storage |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6592`_ | ui: fix vpc loadbalancer listing for admins |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6579`_ | api: fix ipv6 firewall apis default role permissions |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6546`_ | Fixed list networks in projects after setting network |
+| | | permissions |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6586`_ | ui: fix deploy vm override custom disk offering |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6583`_ | UI: Fix new network service provider dialog |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6578`_ | UI: Fix account limits values reset after focus is lost on |
+| | | fields |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6564`_ | Remove psudo jobs from listAsyncJobs API |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6562`_ | utils: use safer parsing utility across codebase |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6527`_ | [KVM] Fix for Revert volume snapshot |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6547`_ | UI: Fix can't select schedule interval type |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6462`_ | UI: Fixes UI break with SAML authentication |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6338`_ | test: add, refactor ipv6 network, vpc tests |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6430`_ | Filter removed nics while listing LB vm instances |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6542`_ | Updated log message and throw error when unable to update |
+| | | the secret in key file |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6543`_ | ui: fix zone icon in vm deploy zone selection |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6480`_ | UI: Fixes some issues from zone wizard with VMWare |
+| | | hypervisor |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6536`_ | kvm: add support nicAdapter detail for vm and template |
+| | | settings for KVM |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6537`_ | kvm: skip test that can't run and pass on M1 mac |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6513`_ | cks: fix k8s version upgrade |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6525`_ | UI: Add authmethod field allowing to choose password or |
+| | | ssh key when adding host |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6457`_ | Fix SAML SSO plugin redirect URL |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6495`_ | ui: allow instances to be filtered by group |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6530`_ | Excluded fe80 or link local address in keystore setup |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6529`_ | refactor: new line, lint error fix |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6272`_ | Fix spelling |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6503`_ | UI: Clear all filter values after the reset button clicked |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6414`_ | Fix VMware memory retrieval |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6483`_ | Fix for VMware VM migration with volume in local storage |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6518`_ | Added information about device id 0 for root volume while |
+| | | attaching to VM |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6142`_ | UI: Remove unused dependencies and fix travis build |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6446`_ | CKS: add created to k8s cluster and k8s version |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6476`_ | server: update lb rule with new protocol |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6496`_ | Fix global setting reference for max secondary storage |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6493`_ | UI fix message.add.vpn.customer.gateway.failed when |
+| | | catched error |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6502`_ | UI: Change notification title when resizing volume |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6475`_ | UI: fix create tags for LB rules |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6367`_ | Updated PowerFlex/ScaleIO storage plugin to support |
+| | | separate (storage) network for Hosts(KVM)/Storage |
+| | | connection. |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6477`_ | Fix rpfilter config values from integer to boolean on |
+| | | upgrade path |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6484`_ | ui: fix ui hang on offering creation with no zone |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6481`_ | UI primarystorage linstor fixes |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6472`_ | kvm: upgrade libvirt-java to v0.5.3 |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6468`_ | UI: Fixes ui error when upgrade virtual routers from |
+| | | virtual router list |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6462`_ | UI: Fixes UI break with SAML authentication |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6461`_ | api: Add vpc name and uuid to VMs list response (nics) and |
+| | | nics response |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#5442`_ | some component tests fixes |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6307`_ | fix pseudo random behaviour in pool selection |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6449`_ | Specify vm snapshot uuid in response over db id in the |
+| | | async job response |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6449`_ | Specify vm snapshot uuid in response over db id in the |
+| | | async job response |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6436`_ | UI: Fix hypervisor not selected by default when deploying |
+| | | VM from ISO |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6445`_ | UI: fix create vpc private gw by regular users |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6439`_ | UI: Hide project delete button while in this project view |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6438`_ | UI: Fixes the added storage tags issues on adding primary |
+| | | storage |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6443`_ | UI: Fixes error when creating volume from the snapshot |
++-------------------------+----------+------------------------------------------------------------+
+| 4.17.1.0 | `#6441`_ | Fix deploy from ISO with custom disk offering |
++-------------------------+----------+------------------------------------------------------------+
+
+96 Issues listed
+
+.. _`#6721`: https://github.com/apache/cloudstack/pull/6721
+.. _`#6725`: https://github.com/apache/cloudstack/pull/6725
+.. _`#6729`: https://github.com/apache/cloudstack/pull/6729
+.. _`#6728`: https://github.com/apache/cloudstack/pull/6728
+.. _`#6730`: https://github.com/apache/cloudstack/pull/6730
+.. _`#6706`: https://github.com/apache/cloudstack/pull/6706
+.. _`#6711`: https://github.com/apache/cloudstack/pull/6711
+.. _`#6708`: https://github.com/apache/cloudstack/pull/6708
+.. _`#6696`: https://github.com/apache/cloudstack/pull/6696
+.. _`#6705`: https://github.com/apache/cloudstack/pull/6705
+.. _`#6707`: https://github.com/apache/cloudstack/pull/6707
+.. _`#6693`: https://github.com/apache/cloudstack/pull/6693
+.. _`#6688`: https://github.com/apache/cloudstack/pull/6688
+.. _`#6643`: https://github.com/apache/cloudstack/pull/6643
+.. _`#6687`: https://github.com/apache/cloudstack/pull/6687
+.. _`#6675`: https://github.com/apache/cloudstack/pull/6675
+.. _`#6655`: https://github.com/apache/cloudstack/pull/6655
+.. _`#6671`: https://github.com/apache/cloudstack/pull/6671
+.. _`#6664`: https://github.com/apache/cloudstack/pull/6664
+.. _`#6658`: https://github.com/apache/cloudstack/pull/6658
+.. _`#6276`: https://github.com/apache/cloudstack/pull/6276
+.. _`#6642`: https://github.com/apache/cloudstack/pull/6642
+.. _`#6654`: https://github.com/apache/cloudstack/pull/6654
+.. _`#6588`: https://github.com/apache/cloudstack/pull/6588
+.. _`#6650`: https://github.com/apache/cloudstack/pull/6650
+.. _`#6634`: https://github.com/apache/cloudstack/pull/6634
+.. _`#6646`: https://github.com/apache/cloudstack/pull/6646
+.. _`#6645`: https://github.com/apache/cloudstack/pull/6645
+.. _`#6625`: https://github.com/apache/cloudstack/pull/6625
+.. _`#6636`: https://github.com/apache/cloudstack/pull/6636
+.. _`#6080`: https://github.com/apache/cloudstack/pull/6080
+.. _`#6622`: https://github.com/apache/cloudstack/pull/6622
+.. _`#6552`: https://github.com/apache/cloudstack/pull/6552
+.. _`#6591`: https://github.com/apache/cloudstack/pull/6591
+.. _`#6616`: https://github.com/apache/cloudstack/pull/6616
+.. _`#6549`: https://github.com/apache/cloudstack/pull/6549
+.. _`#6341`: https://github.com/apache/cloudstack/pull/6341
+.. _`#6612`: https://github.com/apache/cloudstack/pull/6612
+.. _`#6598`: https://github.com/apache/cloudstack/pull/6598
+.. _`#6605`: https://github.com/apache/cloudstack/pull/6605
+.. _`#6607`: https://github.com/apache/cloudstack/pull/6607
+.. _`#6600`: https://github.com/apache/cloudstack/pull/6600
+.. _`#6592`: https://github.com/apache/cloudstack/pull/6592
+.. _`#6579`: https://github.com/apache/cloudstack/pull/6579
+.. _`#6546`: https://github.com/apache/cloudstack/pull/6546
+.. _`#6586`: https://github.com/apache/cloudstack/pull/6586
+.. _`#6583`: https://github.com/apache/cloudstack/pull/6583
+.. _`#6578`: https://github.com/apache/cloudstack/pull/6578
+.. _`#6564`: https://github.com/apache/cloudstack/pull/6564
+.. _`#6562`: https://github.com/apache/cloudstack/pull/6562
+.. _`#6527`: https://github.com/apache/cloudstack/pull/6527
+.. _`#6547`: https://github.com/apache/cloudstack/pull/6547
+.. _`#6462`: https://github.com/apache/cloudstack/pull/6462
+.. _`#6338`: https://github.com/apache/cloudstack/pull/6338
+.. _`#6430`: https://github.com/apache/cloudstack/pull/6430
+.. _`#6542`: https://github.com/apache/cloudstack/pull/6542
+.. _`#6543`: https://github.com/apache/cloudstack/pull/6543
+.. _`#6480`: https://github.com/apache/cloudstack/pull/6480
+.. _`#6536`: https://github.com/apache/cloudstack/pull/6536
+.. _`#6537`: https://github.com/apache/cloudstack/pull/6537
+.. _`#6513`: https://github.com/apache/cloudstack/pull/6513
+.. _`#6525`: https://github.com/apache/cloudstack/pull/6525
+.. _`#6457`: https://github.com/apache/cloudstack/pull/6457
+.. _`#6495`: https://github.com/apache/cloudstack/pull/6495
+.. _`#6530`: https://github.com/apache/cloudstack/pull/6530
+.. _`#6529`: https://github.com/apache/cloudstack/pull/6529
+.. _`#6272`: https://github.com/apache/cloudstack/pull/6272
+.. _`#6503`: https://github.com/apache/cloudstack/pull/6503
+.. _`#6414`: https://github.com/apache/cloudstack/pull/6414
+.. _`#6483`: https://github.com/apache/cloudstack/pull/6483
+.. _`#6518`: https://github.com/apache/cloudstack/pull/6518
+.. _`#6142`: https://github.com/apache/cloudstack/pull/6142
+.. _`#6446`: https://github.com/apache/cloudstack/pull/6446
+.. _`#6476`: https://github.com/apache/cloudstack/pull/6476
+.. _`#6496`: https://github.com/apache/cloudstack/pull/6496
+.. _`#6493`: https://github.com/apache/cloudstack/pull/6493
+.. _`#6502`: https://github.com/apache/cloudstack/pull/6502
+.. _`#6475`: https://github.com/apache/cloudstack/pull/6475
+.. _`#6367`: https://github.com/apache/cloudstack/pull/6367
+.. _`#6477`: https://github.com/apache/cloudstack/pull/6477
+.. _`#6484`: https://github.com/apache/cloudstack/pull/6484
+.. _`#6481`: https://github.com/apache/cloudstack/pull/6481
+.. _`#6472`: https://github.com/apache/cloudstack/pull/6472
+.. _`#6468`: https://github.com/apache/cloudstack/pull/6468
+.. _`#6462`: https://github.com/apache/cloudstack/pull/6462
+.. _`#6461`: https://github.com/apache/cloudstack/pull/6461
+.. _`#5442`: https://github.com/apache/cloudstack/pull/5442
+.. _`#6307`: https://github.com/apache/cloudstack/pull/6307
+.. _`#6449`: https://github.com/apache/cloudstack/pull/6449
+.. _`#6449`: https://github.com/apache/cloudstack/pull/6449
+.. _`#6436`: https://github.com/apache/cloudstack/pull/6436
+.. _`#6445`: https://github.com/apache/cloudstack/pull/6445
+.. _`#6439`: https://github.com/apache/cloudstack/pull/6439
+.. _`#6438`: https://github.com/apache/cloudstack/pull/6438
+.. _`#6443`: https://github.com/apache/cloudstack/pull/6443
+.. _`#6441`: https://github.com/apache/cloudstack/pull/6441
+
Changes in |release| since 4.16
===============================
@@ -834,4 +1164,3 @@ to track its issues.
.. _`#6041`: https://github.com/apache/cloudstack/pull/6041
.. _`#6019`: https://github.com/apache/cloudstack/pull/6019
.. _`#5965`: https://github.com/apache/cloudstack/pull/5965
-
diff --git a/source/upgrading/index.rst b/source/upgrading/index.rst
index d7972bf..8bb26ec 100644
--- a/source/upgrading/index.rst
+++ b/source/upgrading/index.rst
@@ -44,6 +44,7 @@ Contents:
upgrade/mysql
upgrade/valid_source
+ upgrade/upgrade-4.17
upgrade/upgrade-4.16
upgrade/upgrade-4.15
upgrade/upgrade-4.14
diff --git a/source/upgrading/upgrade/upgrade-4.17.rst b/source/upgrading/upgrade/upgrade-4.17.rst
new file mode 100644
index 0000000..ff6e379
--- /dev/null
+++ b/source/upgrading/upgrade/upgrade-4.17.rst
@@ -0,0 +1,299 @@
+.. 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.
+
+.. |version_to_upgrade| replace:: 4.17.0
+
+Upgrade Instruction from |version_to_upgrade|
+=============================================
+
+
+This section will show you how to upgrade from CloudStack |version_to_upgrade| to latest
+CloudStack |release|.
+
+Any steps that are hypervisor-specific will be called out with a note.
+
+We recommend reading through this section once or twice before beginning
+your upgrade procedure, and working through it on a test system before
+working on a production system.
+
+.. note::
+ The following upgrade instructions should be performed regardless of
+ hypervisor type.
+
+Overview of Upgrade Steps:
+----------------------------
+
+#. Check any customisations and integrations
+#. Stop all running management servers
+#. Backup CloudStack database (MySQL)
+#. Upgrade 1st CloudStack management server
+#. Update hypervisors specific dependencies
+#. Restart 1st management server
+#. Check that your upgraded environment works as expected
+#. Upgrade and restart the remaining management servers
+
+
+.. include:: _customisation_warnings.rst
+
+
+Packages repository
+-------------------
+
+Most users of CloudStack manage the installation and upgrades of
+CloudStack with one of Linux's predominant package systems, RPM or
+APT. This guide assumes you'll be using RPM and Yum (for Red Hat
+Enterprise Linux or CentOS), or APT and Debian packages (for Ubuntu).
+
+Create RPM or Debian packages (as appropriate) and a repository from
+the |release| source, or check the Apache CloudStack downloads page at
+http://cloudstack.apache.org/downloads.html
+for package repositories supplied by community members. You will need
+them for :ref:`ubuntu414` or :ref:`kvm414` hosts upgrade.
+
+Instructions for creating packages from the CloudStack source are in the
+`CloudStack Installation Guide`_.
+
+Database Preparation
+--------------------
+
+Backup current database
+
+#. Stop your management server or servers. Run this on all management
+ server hosts:
+
+ .. parsed-literal::
+
+ $ sudo service cloudstack-management stop
+
+#. If you are running a usage server or usage servers, stop those as well:
+
+ .. parsed-literal::
+
+ $ sudo service cloudstack-usage stop
+
+#. Make a backup of your MySQL database. If you run into any issues or
+ need to roll back the upgrade, this will assist in debugging or
+ restoring your existing environment. You'll be prompted for your
+ password.
+
+ .. parsed-literal::
+
+ $ mysqldump -u root -p -R cloud > cloud-backup_$(date +%Y-%m-%d-%H%M%S)
+ $ mysqldump -u root -p cloud_usage > cloud_usage-backup_$(date +%Y-%m-%d-%H%M%S)
+
+
+.. _ubuntu414:
+.. _apt-repo414:
+
+Management Server
+-----------------
+
+Ubuntu
+######
+
+If you are using Ubuntu, follow this procedure to upgrade your packages. If
+not, skip to step :ref:`rhel414`.
+
+.. note::
+ **Community Packages:** This section assumes you're using the community
+ supplied packages for CloudStack. If you've created your own packages and
+ APT repository, substitute your own URL for the ones used in these examples.
+
+The first order of business will be to change the sources list for
+each system with CloudStack packages. This means all management
+servers, and any hosts that have the KVM agent (no changes should
+be necessary for hosts that are running VMware or Xen.)
+
+Edit your ``/etc/apt/sources.list.d/cloudstack.list`` file on
+any systems that have CloudStack packages installed to points to version |version|
+
+This file should have one line, which contains:
+
+.. parsed-literal::
+
+ deb http://download.cloudstack.org/ubuntu bionic |version|
+
+Setup the public key for the above repository:
+
+.. parsed-literal::
+
+ wget -qO - http://download.cloudstack.org/release.asc | sudo apt-key add -
+
+#. Now update your apt package list:
+
+ .. parsed-literal::
+
+ $ sudo apt-get update
+
+#. Now that you have the repository configured, it's time to upgrade
+ the ``cloudstack-management`` package.
+
+ .. parsed-literal::
+
+ $ sudo apt-get upgrade cloudstack-management
+
+#. If you use CloudStack usage server
+
+ .. parsed-literal::
+
+ $ sudo apt-get upgrade cloudstack-usage
+
+
+.. _rhel414:
+.. _rpm-repo414:
+
+CentOS/RHEL
+##############
+
+If you are using CentOS or RHEL, follow this procedure to upgrade your
+packages. If not, skip to hypervisors section :ref:`upg_hyp_414`.
+
+.. note::
+ **Community Packages:** This section assumes you're using the community
+ supplied packages for CloudStack. If you've created your own packages and
+ yum repository, substitute your own URL for the ones used in these examples.
+
+The first order of business will be to change the yum repository
+for each system with CloudStack packages. This means all
+management servers, and any hosts that have the KVM agent (no changes
+should be necessary for hosts that are running VMware or Xen.)
+
+Change your ``/etc/yum.repos.d/cloudstack.repo`` file on
+any systems that have CloudStack packages installed to points to version |version|.
+
+This file should have content similar to the following:
+
+.. parsed-literal::
+
+ [apache-cloudstack]
+ name=Apache CloudStack
+ baseurl=http://download.cloudstack.org/centos/$releasever/|version|/
+ enabled=1
+ gpgcheck=0
+
+Setup the GPG public key if you wish to enable ``gpgcheck=1``:
+
+.. parsed-literal::
+
+ rpm --import http://download.cloudstack.org/RPM-GPG-KEY
+
+#. Now that you have the repository configured, it's time to upgrade the
+ ``cloudstack-management``.
+
+ .. parsed-literal::
+
+ $ sudo yum upgrade cloudstack-management
+
+#. If you use CloudStack usage server
+
+ .. parsed-literal::
+
+ $ sudo yum upgrade cloudstack-usage
+
+.. _upg_hyp_414:
+
+Upgrade Hypervisors
+-------------------
+
+Hypervisor: XenServer
+#####################
+
+
+No additional steps are required for XenServer Hypervisor for this upgrade.
+
+
+Hypervisor: VMware
+###################
+
+.. warning::
+ For VMware hypervisor, CloudStack management server packages must be
+ built using "noredist". Refer to :ref:`building-noredist`.
+
+
+No additional steps are requried for the VMware Hypervisor for this upgrade.
+
+
+.. _kvm414:
+
+Hypervisor: KVM
+#################
+
+KVM on Ubuntu
+""""""""""""""
+
+(KVM only) Additional steps are required for each KVM host. These
+steps will not affect running guests in the cloud. These steps are
+required only for clouds using KVM as hosts and only on the KVM
+hosts.
+
+#. Configure the :ref:`APT repo <apt-repo414>` as detailed above.
+
+#. Stop the running agent.
+
+ .. parsed-literal::
+
+ $ sudo service cloudstack-agent stop
+
+#. Update the agent software.
+
+ .. parsed-literal::
+
+ $ sudo apt-get upgrade cloudstack-agent
+
+#. Start the agent.
+
+ .. parsed-literal::
+
+ $ sudo service cloudstack-agent start
+
+
+KVM on CentOS/RHEL
+"""""""""""""""""""
+
+For KVM hosts, upgrade the ``cloudstack-agent`` package
+
+#. Configure the :ref:`rpm-repo414` as detailed above.
+
+ .. parsed-literal::
+
+ $ sudo yum install -y epel-release
+ $ sudo yum install -y python36-libvirt
+ $ sudo yum upgrade cloudstack-agent
+
+#. Restart the agent:
+
+ .. parsed-literal::
+
+ $ sudo service cloudstack-agent stop
+ $ sudo service cloudstack-agent start
+
+
+Restart management services
+---------------------------
+
+#. Now it's time to start the management server
+
+ .. parsed-literal::
+
+ $ sudo service cloudstack-management start
+
+#. If you use it, start the usage server
+
+ .. parsed-literal::
+
+ $ sudo service cloudstack-usage start
+
+
+.. include:: _sysvm_restart.rst