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 <[email protected]>
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 <[email protected]>
* fix
Signed-off-by: Abhishek Kumar <[email protected]>
* typo fix
Signed-off-by: Abhishek Kumar <[email protected]>
* minor formatting
Signed-off-by: Abhishek Kumar <[email protected]>
* ubuntu 22.04 support
Signed-off-by: Abhishek Kumar <[email protected]>
* remove type and priority
Signed-off-by: Abhishek Kumar <[email protected]>
Signed-off-by: Abhishek Kumar <[email protected]>
---
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
