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 2020/11/25 08:34:53 UTC

[cloudstack-documentation] branch master updated: 4.15 Release & Upgrade Notes (#150)

This is an automated email from the ASF dual-hosted git repository.

rohit pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git


The following commit(s) were added to refs/heads/master by this push:
     new 4931fee  4.15 Release & Upgrade Notes (#150)
4931fee is described below

commit 4931feeda59df13733cdfd8da3851333aacdce62
Author: Rohit Yadav <ro...@shapeblue.com>
AuthorDate: Wed Nov 25 14:04:43 2020 +0530

    4.15 Release & Upgrade Notes (#150)
    
    * releasenotes: 4.15 systemvm tmpl upgrade + primate GA notes
    
    Signed-off-by: Rohit Yadav <ro...@shapeblue.com>
    
    * compat: update
    
    Signed-off-by: Rohit Yadav <ro...@shapeblue.com>
    
    * Adding primate related info
    
    Co-authored-by: davidjumani <dj...@gmail.com>
---
 source/_global.rst                        |  24 +-
 source/conf.py                            |   4 +-
 source/installguide/primate.rst           |  27 +-
 source/releasenotes/about.rst             |  44 +-
 source/releasenotes/changes.rst           | 719 +-----------------------------
 source/releasenotes/compat.rst            |  26 +-
 source/upgrading/index.rst                |   1 +
 source/upgrading/upgrade/upgrade-4.14.rst | 326 ++++++++++++++
 8 files changed, 393 insertions(+), 778 deletions(-)

diff --git a/source/_global.rst b/source/_global.rst
index e1f4a83..0af4614 100644
--- a/source/_global.rst
+++ b/source/_global.rst
@@ -25,19 +25,19 @@
 
 .. Latest version systemvm template name
 
-.. |sysvm64-version|     replace:: 4.14.0
-.. |sysvm64-name-xen|    replace:: systemvm-xenserver-4.14.0
-.. |sysvm64-name-kvm|    replace:: systemvm-kvm-4.14.0
-.. |sysvm64-name-vmware| replace:: systemvm-vmware-4.14.0
-.. |sysvm64-name-hyperv| replace:: systemvm-hyperv-4.14.0
-.. |sysvm64-name-ovm|    replace:: systemvm-ovm-4.14.0
+.. |sysvm64-version|     replace:: 4.15.0
+.. |sysvm64-name-xen|    replace:: systemvm-xenserver-4.15.0
+.. |sysvm64-name-kvm|    replace:: systemvm-kvm-4.15.0
+.. |sysvm64-name-vmware| replace:: systemvm-vmware-4.15.0
+.. |sysvm64-name-hyperv| replace:: systemvm-hyperv-4.15.0
+.. |sysvm64-name-ovm|    replace:: systemvm-ovm-4.15.0
 
 .. Latest version systemvm template URL
-.. |sysvm64-url-xen|    replace:: http://download.cloudstack.org/systemvm/4.14/systemvmtemplate-4.14.0-xen.vhd.bz2
-.. |sysvm64-url-kvm|    replace:: http://download.cloudstack.org/systemvm/4.14/systemvmtemplate-4.14.0-kvm.qcow2.bz2
-.. |sysvm64-url-vmware| replace:: http://download.cloudstack.org/systemvm/4.14/systemvmtemplate-4.14.0-vmware.ova
-.. |sysvm64-url-hyperv| replace:: http://download.cloudstack.org/systemvm/4.14/systemvmtemplate-4.14.0-hyperv.vhd.zip
-.. |sysvm64-url-ovm|    replace:: http://download.cloudstack.org/systemvm/4.14/systemvmtemplate-4.14.0-ovm.raw.bz2
+.. |sysvm64-url-xen|    replace:: http://download.cloudstack.org/systemvm/4.15/systemvmtemplate-4.15.0-xen.vhd.bz2
+.. |sysvm64-url-kvm|    replace:: http://download.cloudstack.org/systemvm/4.15/systemvmtemplate-4.15.0-kvm.qcow2.bz2
+.. |sysvm64-url-vmware| replace:: http://download.cloudstack.org/systemvm/4.15/systemvmtemplate-4.15.0-vmware.ova
+.. |sysvm64-url-hyperv| replace:: http://download.cloudstack.org/systemvm/4.15/systemvmtemplate-4.15.0-hyperv.vhd.zip
+.. |sysvm64-url-ovm|    replace:: http://download.cloudstack.org/systemvm/4.15/systemvmtemplate-4.15.0-ovm.raw.bz2
 
 .. Version specific: 4.5 systemvm template URL
 .. |acs45-sysvm64-url-xen|    replace:: http://download.cloudstack.org/systemvm/4.5/systemvm64template-4.5-xen.vhd.bz2
@@ -56,4 +56,4 @@
 
 .. |br| raw:: html
 
-   <br/>
\ No newline at end of file
+   <br/>
diff --git a/source/conf.py b/source/conf.py
index 9733e62..325e655 100644
--- a/source/conf.py
+++ b/source/conf.py
@@ -24,9 +24,9 @@ copyright = '2012-2020, Apache Foundation'
 author = 'Apache CloudStack Project'
 
 # The short X.Y version
-version = '4.14'
+version = '4.15'
 # The full version, including alpha/beta/rc tags
-release = '4.14.0.0'
+release = '4.15.0.0'
 
 rst_epilog = """
 .. include:: /_global.rst 
diff --git a/source/installguide/primate.rst b/source/installguide/primate.rst
index 4347527..6c750e6 100644
--- a/source/installguide/primate.rst
+++ b/source/installguide/primate.rst
@@ -29,6 +29,7 @@ and Ant Design for Apache CloudStack.
 
 Primate GA was released with CloudStack 4.15, where the legacy UI is deprecated,
 and will be removed in an eventual major CloudStack release.
+Each release of Apache CloudStack comes with its own release of Primate as well.
 
 `User participation in the community mailing lists
 <http://cloudstack.apache.org/mailing-lists.html>`_ is encouraged. Users may
@@ -52,7 +53,17 @@ API improvements which may not be available prior to Apache CloudStack 4.15.
 Installation on CentOS
 ~~~~~~~~~~~~~~~~~~~~~~
 
-Users running management server (4.15 or above) on CentOS can setup the
+Users running management server (4.15 or above) can directly install Primate:
+
+.. parsed-literal::
+
+    yum install cloudstack-primate
+
+Note: there is no need to restart management server post-installation, and
+after installation the UI can be accessed on
+management-server-host:8080/client/primate using any modern browser.
+
+To install the latest release of Primate on CentOS, setup the
 following Primate repository:
 
 .. parsed-literal::
@@ -73,14 +84,20 @@ Next, install Primate:
 
     yum install cloudstack-primate
 
-Note: there is no need to restart management server post-installation, and
-after installation the UI can be accessed on
-management-server-host:8080/client/primate using any modern browser.
 
 Installation on Ubuntu
 ~~~~~~~~~~~~~~~~~~~~~~
 
-Users running CloudStack management server (4.15 or above) on Ubuntu can setup the following Primate repository:
+Users running management server (4.15 or above) can directly install Primate
+
+.. parsed-literal::
+
+    apt-get update
+    apt-get install cloudstack-primate
+
+
+To install the latest release of Primate on Ubuntu, setup the
+following Primate repository:
 
 .. parsed-literal::
 
diff --git a/source/releasenotes/about.rst b/source/releasenotes/about.rst
index 56359a9..57cd7bf 100644
--- a/source/releasenotes/about.rst
+++ b/source/releasenotes/about.rst
@@ -17,25 +17,15 @@
 What's New in |release|
 =======================
 
-Apache CloudStack |release| is a |version| LTS release with over 15 major new features, and
-over 200 enhancements and fixes since 4.13.  Highlights include:
-
-•	New modern UI (Project Primate, Technical preview)
-•	Backup and Recovery framework
-•	Backup and Recovery Provider for Veeam
-•	VM ingestion
-•	L2 network PVLAN enhancements
-•	CloudStack Kubernetes Service
-•	UEFI support
-•	KVM rolling maintenance
-•	Enable Direct Download for systemVM templates
-•	VR health checks
-•	Download logs and diagnostics data from SSVM/CPVM/VRs
-•	Enable additional configuration metadata to virtual machines
+Apache CloudStack |release| is a |version| LTS release with over FIXME major new
+features, and over 100 enhancements and fixes since 4.14.  Highlights include:
 
+• New modern UI (Primate, GA release)
+• Support for CentOS8 and Ubuntu 20.04 as management server hosts and KVM hosts
+• FIXME: add rest of new features
 
 The full list of new features can be found in the project release notes at
-http://docs.cloudstack.apache.org/en/4.14.0.0/releasenotes/changes.html
+http://docs.cloudstack.apache.org/en/4.15.0.0/releasenotes/changes.html
 
 .. important::
    This version of CloudStack allows control over the visibility of the DNS services provided
@@ -75,20 +65,16 @@ before adding the KVM host in CloudStack:
    HostKeyAlgorithms=+ssh-dss
    KexAlgorithms=+diffie-hellman-group1-sha1
 
-New User Interface & Depreciation notice of existing UI
+Primate GA and Legacy UI Deprecation and Removal Notice
 =======================================================
 
-Cloudstack 4.14 ships with a Technical Preview of a new, modern User Interface (project Primate).
-This technical preview can be used by users & operators of Cloudstack environments for evaluation
-& testing purposes. With version 4.14, the existing UI remains the supported UI for production environments.
-However, with the 4.14 release, the Apache Cloudstack community will stop taking feature requests
-for new functionality in the existing UI. All new functionality will be developed against the new UI.
-
-The next LTS release (likely to be version 4.15) of Apache Cloudstack will ship
-with the production release of the new UI. It will also be the last version of
-CloudStack to ship with the old UI. This release will also have the final
-deprecation notice for the old UI.
-
-In the following release (likely to be 4.16), the old UI will be deprecated.
+Cloudstack 4.15 ships with the GA release of a new and modern User Interface
+(Primate) which deprecates the current legacy UI. With version 4.15, the
+existing legacy UI (deprecated) along with the new UI (Primate) are the
+supported UI for production environments. In the next 4.16 release, the Apache
+Cloudstack community will remove the legacy UI and only the new UI (Primate)
+will be supported by the Apache CloudStack community moving forward. Users are
+encouraged to implement a migration path towards the new UI (Primate) in their
+production environments.
 
 Please see `Primate install guide <../installguide/primate.html>`_
diff --git a/source/releasenotes/changes.rst b/source/releasenotes/changes.rst
index 7c4d097..514619d 100644
--- a/source/releasenotes/changes.rst
+++ b/source/releasenotes/changes.rst
@@ -15,7 +15,7 @@
 
 
 
-Changes in |release| since 4.13
+Changes in |release| since 4.14
 ===============================
 
 Apache CloudStack uses GitHub <https://github.com/apache/cloudstack/issues>`_ 
@@ -28,723 +28,8 @@ to track its issues.
 +-------------------------+----------+------------------------------------------------------------+
 | Version                 | Github   | Description                                                |
 +=========================+==========+============================================================+
-| 4.14.0.0                | `#4064`_ | fix dhcp lease entry wrong hostname                        |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#4057`_ | Allow deleting snapshot on local filesystem                |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3992`_ | cks: use public links for templates and binaries iso for   |
-|                         |          | smoke tests                                                |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#4055`_ | db.properties: Enforce UTC timezone by default             |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#4042`_ | Fixed guest vlan range going missing when using zone       |
-|                         |          | wizard                                                     |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#4043`_ | Volume deleted during cold migration if Secondary Storage  |
-|                         |          | over 90% full                                              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#4029`_ | Bring back vm.suspend during deleting VM snapshot          |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#4033`_ | kvm: suspend/resume in deleting vm snapshot on kvm         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#4023`_ | FIX: prevent empty sshkey name.                            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3969`_ | Snapshot deletion issues                                   |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#4025`_ | server: Cannot list affinity group if there are hosts      |
-|                         |          | dedicated to domain                                        |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#4014`_ | Improvement on build time and new quality profile          |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#4002`_ | server: Search zone-wide storage pool when allocation      |
-|                         |          | algothrim is firstfitleastconsumed                         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3984`_ | Remove rolling-maintenance service from debian rules       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3999`_ | Update schema-41310to41400.sql                             |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#4008`_ | Fix template registration error                            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3988`_ | Add support for zulu-11 in cloudstack 4.14                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#4005`_ | Fixed create template from snapshot never returning        |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3995`_ | UI bug fix: Cannot deploy VM from ISO                      |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3993`_ | Fixes raw templates not downloading                        |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3977`_ | With basic zone and VMware hypervisor, VR fails to start   |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3973`_ | systemd dependency on db                                   |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3956`_ | maven quality tool plugins                                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3985`_ | NPE fix for System VM's start Command                      |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3989`_ | server: export full response view for zones response for   |
-|                         |          | root admin                                                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3972`_ | Updated upgrade paths                                      |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3971`_ | Updated upgrade path                                       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3587`_ | vrouter in redundant mode acquire guest ips from first ip  |
-|                         |          | of the tier                                                |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3839`_ | FEATURE-3823: kvm agent hooks                              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3638`_ | UEFI Support on CloudStack                                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3960`_ | Rename max.retries setting                                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3932`_ | Prevent overflow on StatsCollector.java                    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3681`_ | Validate disk offering IOPS normal and maximum read/write  |
-|                         |          | values                                                     |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3962`_ | Make text clear regarding removing data disks.             |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3963`_ | Handle port forward rule check for vpc and non vpc         |
-|                         |          | Isolated networks                                          |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3610`_ | [KVM] Rolling maintenance                                  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3948`_ | server: password is not displayed when reinstall a vm or   |
-|                         |          | reset ssh key                                              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3953`_ | Revert "CLOUDSTACK-10271 maven plugin for owasp dependency |
-|                         |          | check added"                                               |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3925`_ | Add cache mode param properly                              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#2446`_ | CLOUDSTACK-10271 maven plugin for owasp dependency check   |
-|                         |          | added                                                      |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3657`_ | cleanup for resources left by test_accounts and            |
-|                         |          | test_project                                               |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3943`_ | vr: fix password server run with empty gateway in isolated |
-|                         |          | network with RVRs                                          |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3940`_ | Regression Fix: Allow full response view to Admin user     |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3828`_ | [KVM] Direct download agnostic of the storage provider     |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3651`_ | Fix simulator docker db deploy issue (apache#3397)         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3947`_ | server: fix database exception while searching network     |
-|                         |          | offerings                                                  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3935`_ | Fix VM with ISO attached migration issue                   |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3919`_ | Handle EOFException during VR Health Check                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3680`_ | CloudStack Kubernetes Service                              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3862`_ | Userdata to display static NAT as public ip instead of VR  |
-|                         |          | ip                                                         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3924`_ | Fixed error on data volumes lager than 2.14TB when         |
-|                         |          | creating instances on VMware                               |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3928`_ | maven: update dependencies                                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3911`_ | kvm: fix/optimize propogating configs                      |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3930`_ | Remove unused guest OS mapping class from Vmware code      |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3927`_ | ui: fix merge issue that causes VR duplicates              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3553`_ | CloudStack Backup & Recovery Framework                     |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3901`_ | Removed unused vars from pom file                          |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3847`_ | VR: Fix Redundant VRouter guest network on wrong interface |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3898`_ | vrouter: reload keepalived instead of restart and fix      |
-|                         |          | password server issues when add/remove vpc tier            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3907`_ | Allow port 80/8080 accessible only from guest network      |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3916`_ | server: fix issue while list ssh keypairs by keyword       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3913`_ | Fix dhcp infinite lease time                               |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3904`_ | Avoid duplicate alerts when router state changes           |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3903`_ | VR: Send VM password to all Running VRs in network/vpc     |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3894`_ | api: Fix count and item issues returned by list APIs       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3731`_ | Enable Direct Download for systemVM templates              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3899`_ | vpc: add bypassvlanoverlapcheck parameter when create      |
-|                         |          | private gateway                                            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3905`_ | Fix network rules issue if default egress policy is Allow  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3639`_ | Multiple networks support for vms in advanced zone with    |
-|                         |          | security group (and kvm support)                           |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3491`_ | KVM: Propagating changes on host parameters to the agents  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3879`_ | kvm: Enable virtio drivers based on guest os display name  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3739`_ | Add new command to update security group name              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3884`_ | kvm: fix exception in volume stats after storage migration |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3882`_ | remove duplicate index region                              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3864`_ | Ignore site to site vpn status check on internallbvm       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3880`_ | simulator: fix travis failure after merging volume         |
-|                         |          | destroy/recover                                            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3871`_ | Fixed duplicate id error when creating VM work jobs        |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3873`_ | Fixed root volume resize from ui                           |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3877`_ | [SECURITY] Use HTTPS to resolve dependencies in Maven      |
-|                         |          | Build                                                      |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3601`_ | JDK11 support                                              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3876`_ | server: use host record related to a ssvm/cpvm             |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3732`_ | [Vmware] Enable PVLAN support on L2 networks               |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3870`_ | systemvm: list systemvm does not return agent state and    |
-|                         |          | version                                                    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3688`_ | New feature: Add support to destroy/recover volumes        |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3854`_ | Install python-dnspython or python-dns to fix issue with   |
-|                         |          | cloudstack-setup-management                                |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3865`_ | Fixed default text missing from network selection on       |
-|                         |          | instance wizard                                            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3869`_ | packaging: install python-dnspython or python-dns to fix   |
-|                         |          | issue with c…                                              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3805`_ | UI: Display drop down list for VPN customer gateway        |
-|                         |          | selection                                                  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3844`_ | ISSUE-3838: Wrong SSVM behavior causes redownloading for   |
-|                         |          | all the templates                                          |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3865`_ | Fixed default text missing from network selection on       |
-|                         |          | instance wizard                                            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3857`_ | vr: add missing rule for port forwarding rule in vpc       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3851`_ | vpc: set traffic type of private gateway IP to Public to   |
-|                         |          | fix keepalived misconfiguration                            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3867`_ | Usage event to store zone id while uploading template and  |
-|                         |          | volume                                                     |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3861`_ | test: check more connectivity in test_privategw_acl.py     |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3863`_ | Start all (instead of Disconnected) Site-to-Site VPN       |
-|                         |          | connections when VPC VR starts                             |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3803`_ | Bug fix : set restart_required to 0 after restarting       |
-|                         |          | network                                                    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3606`_ | VM ingestion                                               |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3836`_ | Bug fix: De-associate IP address if enabling static nat    |
-|                         |          | fails                                                      |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3807`_ | Enhancement: Allow creating network with duplicate name    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3818`_ | Display numeric value in exception instead of variable     |
-|                         |          | name                                                       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3791`_ | server: fix checking disk offering access for snapshot     |
-|                         |          | volume                                                     |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3832`_ | ui bug fix: cannot assign vms to internal lb in VPC        |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3855`_ | kvm: Fix router migration issue when router has            |
-|                         |          | control/public nics onother physical network than guest    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3383`_ | template: copy md5 mismatch                                |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3819`_ | Clean up inactive iscsi sessions when VMs get moved due to |
-|                         |          | crashes                                                    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3575`_ | Health check feature for virtual router                    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3275`_ | [CLOUDSTACK-10408] Fix String.replaceAll() to replace()    |
-|                         |          | for bet…                                                   |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3604`_ | Fix Policy Based Routing for private gateway static routes |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3760`_ | New feature: Resource count (CPU/RAM) take only running    |
-|                         |          | vms into calculation                                       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3803`_ | Bug fix : set restart_required to 0 after restarting       |
-|                         |          | network                                                    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3840`_ | Fix listing management server by parameters                |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3834`_ | Fix: The metrics view API response is not super-set of     |
-|                         |          | resources response keys                                    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3848`_ | vr: fix vr in unknown state (more)                         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3726`_ | vrouter: reload haproxy when cfg file is updated           |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3846`_ | Fix for "Impossible to edit domain settings in UI"         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3845`_ | travis: use https based maven repo mirror                  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3835`_ | Update Docker README file                                  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3813`_ | kvm-local-pool-trailing-slash                              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3761`_ | [FIX] [BACKPORT] [4.13] Rethrow takeVMSnapshot() exception |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3758`_ | server: Fix NPE while update displayvm on vm with dynamic  |
-|                         |          | service offering                                           |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3728`_ | server: double check host capacity when start/migrate a vm |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3727`_ | server: Capacity check should take vms in Migrating state  |
-|                         |          | into calculation                                           |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3477`_ | RvR: Set up metadata/password/dhcp server on gateway IP    |
-|                         |          | instead of guest IP in RVR                                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3821`_ | Incorrect param name caused global setting test to fail    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3825`_ | fixed inconsistency of IP on VR when VR is destroyed and   |
-|                         |          | recrea…                                                    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3759`_ | server: fix resource count error when upgrade a vm         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3822`_ | set TCP as default protocol in lb list                     |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3694`_ | Ldap fixes                                                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3799`_ | Update message when keys are NOT being injected            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3806`_ | python/c++ formatting in java corrected                    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3814`_ | Add missing HA config keys (#3776)                         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3350`_ | Get Diagnostics: Download logs and diagnostics data from   |
-|                         |          | SSVM, CPVM, Router                                         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3795`_ | Agent lb on svm                                            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3776`_ | Add missing HA config keys                                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3659`_ | Fix typo: the past tense of shutdown is shutdown, not      |
-|                         |          | shutdowned                                                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3800`_ | Revert "Extract systemvm.iso using bsdtar (#3536)"         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3510`_ | Allow additional configuration metadata to VMs             |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3736`_ | Add protocol number support for security group rules       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3778`_ | Endless settings on templates and instances                |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3796`_ | Revert "Simulator: Better VR Redundant Status Behaviour"   |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3743`_ | only update powerstate if sure it is the latest            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3536`_ | Extract systemvm.iso using bsdtar                          |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3313`_ | Simulator: Better VR Redundant Status Behaviour            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3682`_ | ui: fix migrate host form no host popup                    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3658`_ | client: fix for jetty session timeout                      |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3662`_ | Increase DHCP lease time to infinite                       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3793`_ | ui: fix for truncated name for project accounts            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3597`_ | kvm: Logrotate should not touch agent.log                  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3721`_ | network: cleanup dhcp/dns entries while remove a nic from  |
-|                         |          | vm                                                         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3790`_ | Bug fix: Dont display empty item in free ip list           |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3715`_ | break session only on illegal origin                       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3775`_ | New feature: Acquire specific public IP for network        |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3755`_ | Added zone check for attach iso                            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3782`_ | 4.13                                                       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3729`_ | config: add isdynamic flag in configuration response       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3733`_ | filter hosts to query on zone wide storage                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3747`_ | convert protocal names to be found as labels               |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3754`_ | Once again allow a VM to be on multiple networks from VPCs |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3767`_ | create template from snapshot regression (partly reverted) |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3781`_ | Honour promiscuous mode from networkOffering (#3765)       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3765`_ | Honour promiscuous mode from networkOffering               |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3772`_ | Revert of the "Revert "Fix virtual template size for       |
-|                         |          | managed storage for KVM / refactor                         |
-|                         |          | cloud-install-sys-tmplt""                                  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3425`_ | Better tracking host maintanence and handling of migration |
-|                         |          | jobs                                                       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3774`_ | Revert "Add missing HA config keys"                        |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3771`_ | Revert "Fix virtual template size for managed storage for  |
-|                         |          | KVM / refactor cloud-install-sys-tmplt"                    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3371`_ | Fix virtual template size for managed storage for KVM /    |
-|                         |          | refactor cloud-install-sys-tmplt                           |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3737`_ | Add missing HA config keys                                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3738`_ | Load Average for KVM                                       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3769`_ | README: that time of the year!                             |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3746`_ | Fix OS category for some OS-es added in 4.13               |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3615`_ | Handle Ceph/RBD snapshot delete                            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3546`_ | [FIX] Rethrow takeVMSnapshot() exception                   |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3474`_ | Enhance VM Statistics to add more detail                   |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3745`_ | Save SSH.PublicKey into user_vm_details regardless of      |
-|                         |          | password management.                                       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3740`_ | Add support for ecdsa and ed25519 public keys.             |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3617`_ | [KVM] Agent LB Fix: Connections from disabled KVM host     |
-|                         |          | agents are refused                                         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3669`_ | server: Fix resource count of primary storage/volume       |
-|                         |          | because of Expunged volumes                                |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3723`_ | a conditional to prevent creation of a field               |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3640`_ | consoleproxy: Enable console for vms in Stopping/Migrating |
-|                         |          | state                                                      |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3704`_ | utils: use iproute to get default network interface        |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3703`_ | increase width of field in UI                              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3696`_ | env config for dual zone simulator                         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3695`_ | debian: fix symlink issue post install/upgrade             |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3701`_ | security_group.py: check cidr unstrictly to accept cidrs   |
-|                         |          | like 1.1.1.1/24                                            |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3635`_ | server: acquire IPv4 address when add secondary IP to nic  |
-|                         |          | if IP is not specified                                     |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3636`_ | kvm: fix issue that network rules for secondary IPs are    |
-|                         |          | not applied                                                |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3653`_ | Fix VR creation issue while creating VM on shared network  |
-|                         |          | using PVLAN                                                |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3630`_ | New BuildRequires for CentOS 7: python-setuptools          |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3650`_ | Add support for vSphere Web SDK 6.7 installation in        |
-|                         |          | install-non-oss.sh                                         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3678`_ | vpc: fix acl rule with protocol number is not applied      |
-|                         |          | correctly in vpc vr                                        |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3632`_ | add class cleanup method                                   |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3682`_ | ui: fix migrate host form no host popup                    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3605`_ | fix issue #3590 'Revert Ceph/RBD Snapshot'                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3668`_ | storage: don't select an SSVM that is removed              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3612`_ | systemvm: for ip route show command don't use the throw    |
-|                         |          | command                                                    |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3616`_ | Reduce verbosity of Async Job Manager log messages         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3644`_ | IoT/ARM64 support: allow cloudstack-agent on Raspberry Pi  |
-|                         |          | 4 (armv8) to use kvm acceleration                          |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3666`_ | snapshot failure diagnostics unhidden                      |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3623`_ | kvm: Use 'ip' instead of 'brctl'                           |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3620`_ | Small additional NuageVsp cleanups (#3146)                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3658`_ | client: fix for jetty session timeout                      |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3665`_ | ignore patches and unzipped logs                           |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3662`_ | Increase DHCP lease time to infinite                       |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3641`_ | security_group.py: fix NameError: name 'd' is not defined  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3648`_ | Security Group: limit returns in get_bridge_physdev to 1   |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3525`_ | NioServer: retain links by address string to minimize      |
-|                         |          | resource leak                                              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3627`_ | server: Do NOT cleanup dhcp and dns when stop a vm         |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3589`_ | kvm/security_group: Make Security Group Python 3           |
-|                         |          | compatible                                                 |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3608`_ | server: Cleanup dhcp and dns entries only on expunging VM  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3607`_ | allocator: in case of null guest OS don't fail             |
-|                         |          | prioritisation completely                                  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3538`_ | Refactoring to remove duplicate code (by Frank/Nuage)      |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3597`_ | kvm: Logrotate should not touch agent.log                  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3591`_ | Deprecate EL6 and Add 4.13-4.14 Upgrade Path               |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3574`_ | `service is-active` output check for "failed"              |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3519`_ | kvm/cloudstack-guest-tool: Tool to query Qemu Guest Agent  |
-+-------------------------+----------+------------------------------------------------------------+
-| 4.14.0.0                | `#3582`_ | systemvmtemplate: Fix Debian 9 iso url                     |
 +-------------------------+----------+------------------------------------------------------------+
 
-216 Issues listed
+xxx Issues listed
 
 .. _`#4064`: https://github.com/apache/cloudstack/pull/4064
-.. _`#4057`: https://github.com/apache/cloudstack/pull/4057
-.. _`#3992`: https://github.com/apache/cloudstack/pull/3992
-.. _`#4055`: https://github.com/apache/cloudstack/pull/4055
-.. _`#4042`: https://github.com/apache/cloudstack/pull/4042
-.. _`#4043`: https://github.com/apache/cloudstack/pull/4043
-.. _`#4029`: https://github.com/apache/cloudstack/pull/4029
-.. _`#4033`: https://github.com/apache/cloudstack/pull/4033
-.. _`#4023`: https://github.com/apache/cloudstack/pull/4023
-.. _`#3969`: https://github.com/apache/cloudstack/pull/3969
-.. _`#4025`: https://github.com/apache/cloudstack/pull/4025
-.. _`#4014`: https://github.com/apache/cloudstack/pull/4014
-.. _`#4002`: https://github.com/apache/cloudstack/pull/4002
-.. _`#3984`: https://github.com/apache/cloudstack/pull/3984
-.. _`#3999`: https://github.com/apache/cloudstack/pull/3999
-.. _`#4008`: https://github.com/apache/cloudstack/pull/4008
-.. _`#3988`: https://github.com/apache/cloudstack/pull/3988
-.. _`#4005`: https://github.com/apache/cloudstack/pull/4005
-.. _`#3995`: https://github.com/apache/cloudstack/pull/3995
-.. _`#3993`: https://github.com/apache/cloudstack/pull/3993
-.. _`#3977`: https://github.com/apache/cloudstack/pull/3977
-.. _`#3973`: https://github.com/apache/cloudstack/pull/3973
-.. _`#3956`: https://github.com/apache/cloudstack/pull/3956
-.. _`#3985`: https://github.com/apache/cloudstack/pull/3985
-.. _`#3989`: https://github.com/apache/cloudstack/pull/3989
-.. _`#3972`: https://github.com/apache/cloudstack/pull/3972
-.. _`#3971`: https://github.com/apache/cloudstack/pull/3971
-.. _`#3587`: https://github.com/apache/cloudstack/pull/3587
-.. _`#3839`: https://github.com/apache/cloudstack/pull/3839
-.. _`#3638`: https://github.com/apache/cloudstack/pull/3638
-.. _`#3960`: https://github.com/apache/cloudstack/pull/3960
-.. _`#3932`: https://github.com/apache/cloudstack/pull/3932
-.. _`#3681`: https://github.com/apache/cloudstack/pull/3681
-.. _`#3962`: https://github.com/apache/cloudstack/pull/3962
-.. _`#3963`: https://github.com/apache/cloudstack/pull/3963
-.. _`#3610`: https://github.com/apache/cloudstack/pull/3610
-.. _`#3948`: https://github.com/apache/cloudstack/pull/3948
-.. _`#3953`: https://github.com/apache/cloudstack/pull/3953
-.. _`#3925`: https://github.com/apache/cloudstack/pull/3925
-.. _`#2446`: https://github.com/apache/cloudstack/pull/2446
-.. _`#3657`: https://github.com/apache/cloudstack/pull/3657
-.. _`#3943`: https://github.com/apache/cloudstack/pull/3943
-.. _`#3940`: https://github.com/apache/cloudstack/pull/3940
-.. _`#3828`: https://github.com/apache/cloudstack/pull/3828
-.. _`#3651`: https://github.com/apache/cloudstack/pull/3651
-.. _`#3947`: https://github.com/apache/cloudstack/pull/3947
-.. _`#3935`: https://github.com/apache/cloudstack/pull/3935
-.. _`#3919`: https://github.com/apache/cloudstack/pull/3919
-.. _`#3680`: https://github.com/apache/cloudstack/pull/3680
-.. _`#3862`: https://github.com/apache/cloudstack/pull/3862
-.. _`#3924`: https://github.com/apache/cloudstack/pull/3924
-.. _`#3928`: https://github.com/apache/cloudstack/pull/3928
-.. _`#3911`: https://github.com/apache/cloudstack/pull/3911
-.. _`#3930`: https://github.com/apache/cloudstack/pull/3930
-.. _`#3927`: https://github.com/apache/cloudstack/pull/3927
-.. _`#3553`: https://github.com/apache/cloudstack/pull/3553
-.. _`#3901`: https://github.com/apache/cloudstack/pull/3901
-.. _`#3847`: https://github.com/apache/cloudstack/pull/3847
-.. _`#3898`: https://github.com/apache/cloudstack/pull/3898
-.. _`#3907`: https://github.com/apache/cloudstack/pull/3907
-.. _`#3916`: https://github.com/apache/cloudstack/pull/3916
-.. _`#3913`: https://github.com/apache/cloudstack/pull/3913
-.. _`#3904`: https://github.com/apache/cloudstack/pull/3904
-.. _`#3903`: https://github.com/apache/cloudstack/pull/3903
-.. _`#3894`: https://github.com/apache/cloudstack/pull/3894
-.. _`#3731`: https://github.com/apache/cloudstack/pull/3731
-.. _`#3899`: https://github.com/apache/cloudstack/pull/3899
-.. _`#3905`: https://github.com/apache/cloudstack/pull/3905
-.. _`#3639`: https://github.com/apache/cloudstack/pull/3639
-.. _`#3491`: https://github.com/apache/cloudstack/pull/3491
-.. _`#3879`: https://github.com/apache/cloudstack/pull/3879
-.. _`#3739`: https://github.com/apache/cloudstack/pull/3739
-.. _`#3884`: https://github.com/apache/cloudstack/pull/3884
-.. _`#3882`: https://github.com/apache/cloudstack/pull/3882
-.. _`#3864`: https://github.com/apache/cloudstack/pull/3864
-.. _`#3880`: https://github.com/apache/cloudstack/pull/3880
-.. _`#3871`: https://github.com/apache/cloudstack/pull/3871
-.. _`#3873`: https://github.com/apache/cloudstack/pull/3873
-.. _`#3877`: https://github.com/apache/cloudstack/pull/3877
-.. _`#3601`: https://github.com/apache/cloudstack/pull/3601
-.. _`#3876`: https://github.com/apache/cloudstack/pull/3876
-.. _`#3732`: https://github.com/apache/cloudstack/pull/3732
-.. _`#3870`: https://github.com/apache/cloudstack/pull/3870
-.. _`#3688`: https://github.com/apache/cloudstack/pull/3688
-.. _`#3854`: https://github.com/apache/cloudstack/pull/3854
-.. _`#3865`: https://github.com/apache/cloudstack/pull/3865
-.. _`#3869`: https://github.com/apache/cloudstack/pull/3869
-.. _`#3805`: https://github.com/apache/cloudstack/pull/3805
-.. _`#3844`: https://github.com/apache/cloudstack/pull/3844
-.. _`#3865`: https://github.com/apache/cloudstack/pull/3865
-.. _`#3857`: https://github.com/apache/cloudstack/pull/3857
-.. _`#3851`: https://github.com/apache/cloudstack/pull/3851
-.. _`#3867`: https://github.com/apache/cloudstack/pull/3867
-.. _`#3861`: https://github.com/apache/cloudstack/pull/3861
-.. _`#3863`: https://github.com/apache/cloudstack/pull/3863
-.. _`#3803`: https://github.com/apache/cloudstack/pull/3803
-.. _`#3606`: https://github.com/apache/cloudstack/pull/3606
-.. _`#3836`: https://github.com/apache/cloudstack/pull/3836
-.. _`#3807`: https://github.com/apache/cloudstack/pull/3807
-.. _`#3818`: https://github.com/apache/cloudstack/pull/3818
-.. _`#3791`: https://github.com/apache/cloudstack/pull/3791
-.. _`#3832`: https://github.com/apache/cloudstack/pull/3832
-.. _`#3855`: https://github.com/apache/cloudstack/pull/3855
-.. _`#3383`: https://github.com/apache/cloudstack/pull/3383
-.. _`#3819`: https://github.com/apache/cloudstack/pull/3819
-.. _`#3575`: https://github.com/apache/cloudstack/pull/3575
-.. _`#3275`: https://github.com/apache/cloudstack/pull/3275
-.. _`#3604`: https://github.com/apache/cloudstack/pull/3604
-.. _`#3760`: https://github.com/apache/cloudstack/pull/3760
-.. _`#3803`: https://github.com/apache/cloudstack/pull/3803
-.. _`#3840`: https://github.com/apache/cloudstack/pull/3840
-.. _`#3834`: https://github.com/apache/cloudstack/pull/3834
-.. _`#3848`: https://github.com/apache/cloudstack/pull/3848
-.. _`#3726`: https://github.com/apache/cloudstack/pull/3726
-.. _`#3846`: https://github.com/apache/cloudstack/pull/3846
-.. _`#3845`: https://github.com/apache/cloudstack/pull/3845
-.. _`#3835`: https://github.com/apache/cloudstack/pull/3835
-.. _`#3813`: https://github.com/apache/cloudstack/pull/3813
-.. _`#3761`: https://github.com/apache/cloudstack/pull/3761
-.. _`#3758`: https://github.com/apache/cloudstack/pull/3758
-.. _`#3728`: https://github.com/apache/cloudstack/pull/3728
-.. _`#3727`: https://github.com/apache/cloudstack/pull/3727
-.. _`#3477`: https://github.com/apache/cloudstack/pull/3477
-.. _`#3821`: https://github.com/apache/cloudstack/pull/3821
-.. _`#3825`: https://github.com/apache/cloudstack/pull/3825
-.. _`#3759`: https://github.com/apache/cloudstack/pull/3759
-.. _`#3822`: https://github.com/apache/cloudstack/pull/3822
-.. _`#3694`: https://github.com/apache/cloudstack/pull/3694
-.. _`#3799`: https://github.com/apache/cloudstack/pull/3799
-.. _`#3806`: https://github.com/apache/cloudstack/pull/3806
-.. _`#3814`: https://github.com/apache/cloudstack/pull/3814
-.. _`#3350`: https://github.com/apache/cloudstack/pull/3350
-.. _`#3795`: https://github.com/apache/cloudstack/pull/3795
-.. _`#3776`: https://github.com/apache/cloudstack/pull/3776
-.. _`#3659`: https://github.com/apache/cloudstack/pull/3659
-.. _`#3800`: https://github.com/apache/cloudstack/pull/3800
-.. _`#3510`: https://github.com/apache/cloudstack/pull/3510
-.. _`#3736`: https://github.com/apache/cloudstack/pull/3736
-.. _`#3778`: https://github.com/apache/cloudstack/pull/3778
-.. _`#3796`: https://github.com/apache/cloudstack/pull/3796
-.. _`#3743`: https://github.com/apache/cloudstack/pull/3743
-.. _`#3536`: https://github.com/apache/cloudstack/pull/3536
-.. _`#3313`: https://github.com/apache/cloudstack/pull/3313
-.. _`#3682`: https://github.com/apache/cloudstack/pull/3682
-.. _`#3658`: https://github.com/apache/cloudstack/pull/3658
-.. _`#3662`: https://github.com/apache/cloudstack/pull/3662
-.. _`#3793`: https://github.com/apache/cloudstack/pull/3793
-.. _`#3597`: https://github.com/apache/cloudstack/pull/3597
-.. _`#3721`: https://github.com/apache/cloudstack/pull/3721
-.. _`#3790`: https://github.com/apache/cloudstack/pull/3790
-.. _`#3715`: https://github.com/apache/cloudstack/pull/3715
-.. _`#3775`: https://github.com/apache/cloudstack/pull/3775
-.. _`#3755`: https://github.com/apache/cloudstack/pull/3755
-.. _`#3782`: https://github.com/apache/cloudstack/pull/3782
-.. _`#3729`: https://github.com/apache/cloudstack/pull/3729
-.. _`#3733`: https://github.com/apache/cloudstack/pull/3733
-.. _`#3747`: https://github.com/apache/cloudstack/pull/3747
-.. _`#3754`: https://github.com/apache/cloudstack/pull/3754
-.. _`#3767`: https://github.com/apache/cloudstack/pull/3767
-.. _`#3781`: https://github.com/apache/cloudstack/pull/3781
-.. _`#3765`: https://github.com/apache/cloudstack/pull/3765
-.. _`#3772`: https://github.com/apache/cloudstack/pull/3772
-.. _`#3425`: https://github.com/apache/cloudstack/pull/3425
-.. _`#3774`: https://github.com/apache/cloudstack/pull/3774
-.. _`#3771`: https://github.com/apache/cloudstack/pull/3771
-.. _`#3371`: https://github.com/apache/cloudstack/pull/3371
-.. _`#3737`: https://github.com/apache/cloudstack/pull/3737
-.. _`#3738`: https://github.com/apache/cloudstack/pull/3738
-.. _`#3769`: https://github.com/apache/cloudstack/pull/3769
-.. _`#3746`: https://github.com/apache/cloudstack/pull/3746
-.. _`#3615`: https://github.com/apache/cloudstack/pull/3615
-.. _`#3546`: https://github.com/apache/cloudstack/pull/3546
-.. _`#3474`: https://github.com/apache/cloudstack/pull/3474
-.. _`#3745`: https://github.com/apache/cloudstack/pull/3745
-.. _`#3740`: https://github.com/apache/cloudstack/pull/3740
-.. _`#3617`: https://github.com/apache/cloudstack/pull/3617
-.. _`#3669`: https://github.com/apache/cloudstack/pull/3669
-.. _`#3723`: https://github.com/apache/cloudstack/pull/3723
-.. _`#3640`: https://github.com/apache/cloudstack/pull/3640
-.. _`#3704`: https://github.com/apache/cloudstack/pull/3704
-.. _`#3703`: https://github.com/apache/cloudstack/pull/3703
-.. _`#3696`: https://github.com/apache/cloudstack/pull/3696
-.. _`#3695`: https://github.com/apache/cloudstack/pull/3695
-.. _`#3701`: https://github.com/apache/cloudstack/pull/3701
-.. _`#3635`: https://github.com/apache/cloudstack/pull/3635
-.. _`#3636`: https://github.com/apache/cloudstack/pull/3636
-.. _`#3653`: https://github.com/apache/cloudstack/pull/3653
-.. _`#3630`: https://github.com/apache/cloudstack/pull/3630
-.. _`#3650`: https://github.com/apache/cloudstack/pull/3650
-.. _`#3678`: https://github.com/apache/cloudstack/pull/3678
-.. _`#3632`: https://github.com/apache/cloudstack/pull/3632
-.. _`#3682`: https://github.com/apache/cloudstack/pull/3682
-.. _`#3605`: https://github.com/apache/cloudstack/pull/3605
-.. _`#3668`: https://github.com/apache/cloudstack/pull/3668
-.. _`#3612`: https://github.com/apache/cloudstack/pull/3612
-.. _`#3616`: https://github.com/apache/cloudstack/pull/3616
-.. _`#3644`: https://github.com/apache/cloudstack/pull/3644
-.. _`#3666`: https://github.com/apache/cloudstack/pull/3666
-.. _`#3623`: https://github.com/apache/cloudstack/pull/3623
-.. _`#3620`: https://github.com/apache/cloudstack/pull/3620
-.. _`#3658`: https://github.com/apache/cloudstack/pull/3658
-.. _`#3665`: https://github.com/apache/cloudstack/pull/3665
-.. _`#3662`: https://github.com/apache/cloudstack/pull/3662
-.. _`#3641`: https://github.com/apache/cloudstack/pull/3641
-.. _`#3648`: https://github.com/apache/cloudstack/pull/3648
-.. _`#3525`: https://github.com/apache/cloudstack/pull/3525
-.. _`#3627`: https://github.com/apache/cloudstack/pull/3627
-.. _`#3589`: https://github.com/apache/cloudstack/pull/3589
-.. _`#3608`: https://github.com/apache/cloudstack/pull/3608
-.. _`#3607`: https://github.com/apache/cloudstack/pull/3607
-.. _`#3538`: https://github.com/apache/cloudstack/pull/3538
-.. _`#3597`: https://github.com/apache/cloudstack/pull/3597
-.. _`#3591`: https://github.com/apache/cloudstack/pull/3591
-.. _`#3574`: https://github.com/apache/cloudstack/pull/3574
-.. _`#3519`: https://github.com/apache/cloudstack/pull/3519
-.. _`#3582`: https://github.com/apache/cloudstack/pull/3582
diff --git a/source/releasenotes/compat.rst b/source/releasenotes/compat.rst
index 253e5e6..708af30 100644
--- a/source/releasenotes/compat.rst
+++ b/source/releasenotes/compat.rst
@@ -22,15 +22,15 @@ Supported OS Versions for Management Server
 This section lists the operating systems that are supported for running
 CloudStack Management Server.
 
--  RHEL versions 7.x
--  CentOS versions 7.x
--  Ubuntu 16.04 LTS, 18.04 LTS
+-  Ubuntu 16.04 LTS, 18.04, 20.04 LTS
+-  CentOS versions 7.x, 8.x
+-  RHEL versions 7.x, 8.x
 
 Software Requirements
 ~~~~~~~~~~~~~~~~~~~~~
 
 -  Java JRE 11
--  MySQL 5.5, 5.6, 5.7
+-  MySQL 5.6, 5.7, 8.0
 
 Supported Hypervisor Versions
 -----------------------------
@@ -38,14 +38,14 @@ Supported Hypervisor Versions
 CloudStack supports three hypervisor families, XenServer with XAPI, KVM,
 and VMware with vSphere.
 
--  CentOS 7.x with KVM
--  Ubuntu 16.04 LTS, 18.04 LTS with KVM
--  Red Hat Enterprise Linux 7.x with KVM
--  XenServer versions 7.0, 7.1, 7.2, 7.4, 7.5 with latest hotfixes, XCP-ng 7.4, 7.6
+-  Ubuntu 16.04 LTS, 18.04, 20.04 LTS with KVM
+-  CentOS 7.x, 8.x with KVM
+-  Red Hat Enterprise Linux 7.x, 8.x with KVM
+-  XenServer versions 7.0, 7.1, 7.2, 7.4, 7.5, 8.0 with latest hotfixes, XCP-ng 7.4, 7.6, 8.0, 8.1
 
    .. note:: It is now required to enable HA on the XenServer pool in order to recover from a pool-master failure. Please refer to the `XenServer documentation <https://docs.citrix.com/en-us/xencenter/7-1/pools-ha-enable.html>`_.
 
--  VMware versions 6.0, 6.5 and 6.7 (tested up to 6.7 U3)
+-  VMware versions 6.5 and 6.7 (tested up to 6.7 U3)
 
    .. note:: There is a known issue in 6.7 U1 (https://kb.vmware.com/s/article/67315) which blocks some CloudStack cloning operations. The use of linked clones is known to be effected.
 
@@ -80,11 +80,11 @@ browser, but it's possible that some browsers will not render portions
 of the UI reliably, depending on their support of Web standards. For
 best results, one of the following browsers recommended:
 
--  Firefox version 31 or later
+-  Firefox version 75 or later
 
--  Google Chrome version 36.0+
+-  Google Chrome version 85 or later
 
--  Safari 6+
+-  Safari 12+
 
 Notice Of Management OSes and Hypervisors to be Deprecated
 ----------------------------------------------------------
@@ -96,6 +96,7 @@ The following hypervisors are no longer be supported in this release
 -  vSphere 5.0
 -  vSphere 5.1
 -  vSphere 5.5
+-  vSphere 6.0
 -  CentOS/RHEL (KVM) 6.x
 -  Ubuntu 14.04
 
@@ -104,6 +105,5 @@ The following Management Server Operating Systems are no longer supported in thi
 -  CentOS 6.x
 -  Ubuntu 14.04
 
-
 Please see `CloudStack Wiki <https://cwiki.apache.org/confluence/display/CLOUDSTACK/Hypervisor+and+Management+Server+OS+EOL+Dates>`_ 
 for details.
diff --git a/source/upgrading/index.rst b/source/upgrading/index.rst
index 7bb6c28..5186e1c 100644
--- a/source/upgrading/index.rst
+++ b/source/upgrading/index.rst
@@ -37,6 +37,7 @@ Contents:
 .. toctree::
    :maxdepth: 1
  
+   upgrade/upgrade-4.14
    upgrade/upgrade-4.13
    upgrade/upgrade-4.12
    upgrade/upgrade-4.11
diff --git a/source/upgrading/upgrade/upgrade-4.14.rst b/source/upgrading/upgrade/upgrade-4.14.rst
new file mode 100644
index 0000000..a66dfeb
--- /dev/null
+++ b/source/upgrading/upgrade/upgrade-4.14.rst
@@ -0,0 +1,326 @@
+.. 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.14.x
+
+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
+#. Upload the |sysvm64-version| System VM template if not already using it.
+#. Confirm Java 11 is the default Java version
+#. Stop all running management servers
+#. Backup CloudStack database (MySQL)
+#. Add "serverTimezone=UTC" to your "db.properties"
+#. 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
+
+.. warning::
+    If you are not already using the |sysvm64-version| System VM template you will need to
+    upgrade your System VM template prior to performing the upgrade of the
+    CloudStack packages.
+
+.. include:: _sysvm_templates.rst
+
+.. include:: _java_version.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'`.sql
+      $ mysqldump -u root -p cloud_usage > cloud_usage-backup_`date '+%Y-%m-%d'`.sql
+
+
+.. _ubuntu414:
+.. _apt-repo414:
+
+Management Server
+-----------------
+
+.. include:: _timezone.rst
+
+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
+
+#. Install the new UI (Primate)
+
+   .. parsed-literal::
+
+      $ sudo apt-get install cloudstack-primate
+
+
+.. _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
+
+#. Install the new UI (Primate)
+
+   .. parsed-literal::
+
+      $ sudo yum install cloudstack-primate
+
+.. _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
+
+System-VMs and Virtual-Routers
+------------------------------
+
+.. include:: _sysvm_restart.rst