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

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


The following commit(s) were added to refs/heads/4.13 by this push:
     new 8087138  4.13.1.0 documentation release update (#104)
8087138 is described below

commit 8087138276b35f58da1e189f2b4420e73b2c966d
Author: Andrija Panic <[email protected]>
AuthorDate: Fri May 1 16:41:22 2020 +0200

    4.13.1.0 documentation release update (#104)
    
    * Update changes.rst
    
    * what's-new-in-4.13.1.0-about-page
    
    * Update upgrade-4.13.rst
    
    * Update api-changes.rst
---
 source/conf.py                            |   2 +-
 source/releasenotes/about.rst             |  17 +-
 source/releasenotes/api-changes.rst       |   6 +-
 source/releasenotes/changes.rst           | 538 +++++++++++++++++++++++++++++-
 source/upgrading/index.rst                |   3 +-
 source/upgrading/upgrade/upgrade-4.13.rst | 329 ++++++++++++++++++
 6 files changed, 880 insertions(+), 15 deletions(-)

diff --git a/source/conf.py b/source/conf.py
index bfbcb04..e2ebe14 100644
--- a/source/conf.py
+++ b/source/conf.py
@@ -26,7 +26,7 @@ author = 'Apache CloudStack Project'
 # The short X.Y version
 version = '4.13'
 # The full version, including alpha/beta/rc tags
-release = '4.13.0.0'
+release = '4.13.1.0'
 
 rst_epilog = """
 .. include:: /_global.rst 
diff --git a/source/releasenotes/about.rst b/source/releasenotes/about.rst
index 84c8897..3318bac 100644
--- a/source/releasenotes/about.rst
+++ b/source/releasenotes/about.rst
@@ -16,10 +16,21 @@
 
 What's New in |release|
 =======================
-Version |release| is a |version| LTS release adding almost 200 new features, 
enhancements and fixes 
-since 4.12. 
 
-Apache CloudStack |release| is a |version| LTS release nearly 200 new 
features, enhancements and fixes since 4.12, such as enhanced hypervisor 
support, performance increases and more user configurable controls.  Highlights 
include:
+
+What's New in 4.13.1.0
+----------------------
+
+The new 4.13.1.0 version is a 4.13 maintenance release containing almost 100
+fixes and improvements on the 4.13.0.0 release.
+
+
+What's New in 4.13.0.0
+----------------------
+
+Version 4.13.0.0 includes almost 200 new features, enhancements and fixes 
since 4.12. 
+
+Apache CloudStack 4.13.0.0 is a 4.13 LTS release with nearly 200 new features, 
enhancements and fixes since 4.12, such as enhanced hypervisor support, 
performance increases and more user configurable controls.  Highlights include:
 
 •      Supporting configuration of virtualised appliances
 •      VMware 6.7 support
diff --git a/source/releasenotes/api-changes.rst 
b/source/releasenotes/api-changes.rst
index 7dadc29..225ce6e 100644
--- a/source/releasenotes/api-changes.rst
+++ b/source/releasenotes/api-changes.rst
@@ -13,14 +13,10 @@
    specific language governing permissions and limitations
    under the License.
 
-API Changes Introduced in |release|
+API Changes Introduced in 4.13.0.0
 ===================================
 For the complete list of API commands and params consult the `CloudStack 
Apidocs`_.
 
-.. note:: 
-
-   The 4.12 API commands stayed as the 4.11.
-
 
 New API Commands
 ----------------
diff --git a/source/releasenotes/changes.rst b/source/releasenotes/changes.rst
index 91cc23b..d37df95 100644
--- a/source/releasenotes/changes.rst
+++ b/source/releasenotes/changes.rst
@@ -13,14 +13,542 @@
    specific language governing permissions and limitations
    under the License.
 
+Issues Fixed in 4.13.1.0
+========================
 
 
-Changes in |release| since 4.12
-===============================
+Issues Fixed in 4.13.1.0
+------------------------
 
-Apache CloudStack now uses GitHub 
<https://github.com/apache/cloudstack/issues>`_ 
-to track its issues. links to the GitHub pull requests have been included at 
the end
-of each section. 
+.. cssclass:: table-striped table-bordered table-hover
+
++-------------------------+----------+------------------------------------------------------------+
+| Version                 | Github   | Description                             
                   |
++=========================+==========+============================================================+
+| 4.13.1.0                | `#4042`_ | Fixed guest vlan range going missing 
when using zone       |
+|                         |          | wizard                                  
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#4043`_ | Volume deleted during cold migration if 
Secondary Storage  |
+|                         |          | over 90% full                           
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#4033`_ | kvm: suspend/resume in deleting vm 
snapshot on kvm         |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3969`_ | Snapshot deletion issues                
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#4025`_ | server: Cannot list affinity group if 
there are hosts      |
+|                         |          | dedicated to domain                     
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#4002`_ | server: Search zone-wide storage pool 
when allocation      |
+|                         |          | algothrim is firstfitleastconsumed      
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#4005`_ | Fixed create template from snapshot 
never returning        |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3995`_ | UI bug fix: Cannot deploy VM from ISO   
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3993`_ | Fixes raw templates not downloading     
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3977`_ | With basic zone and VMware hypervisor, 
VR fails to start   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3973`_ | systemd dependency on db                
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3989`_ | server: export full response view for 
zones response for   |
+|                         |          | root admin                              
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3971`_ | Updated upgrade path                    
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3932`_ | Prevent overflow on StatsCollector.java 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3948`_ | server: password is not displayed when 
reinstall a vm or   |
+|                         |          | reset ssh key                           
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3943`_ | vr: fix password server run with empty 
gateway in isolated |
+|                         |          | network with RVRs                       
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3651`_ | Fix simulator docker db deploy issue 
(apache#3397)         |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3947`_ | server: fix database exception while 
searching network     |
+|                         |          | offerings                               
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3935`_ | Fix VM with ISO attached migration 
issue                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3924`_ | Fixed error on data volumes lager than 
2.14TB when         |
+|                         |          | creating instances on VMware            
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3911`_ | kvm: fix/optimize propogating configs   
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3847`_ | VR: Fix Redundant VRouter guest network 
on wrong interface |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3898`_ | vrouter: reload keepalived instead of 
restart and fix      |
+|                         |          | password server issues when add/remove 
vpc tier            |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3907`_ | Allow port 80/8080 accessible only from 
guest network      |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3916`_ | server: fix issue while list ssh 
keypairs by keyword       |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3913`_ | Fix dhcp infinite lease time            
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3904`_ | Avoid duplicate alerts when router 
state changes           |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3903`_ | VR: Send VM password to all Running VRs 
in network/vpc     |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3894`_ | api: Fix count and item issues returned 
by list APIs       |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3905`_ | Fix network rules issue if default 
egress policy is Allow  |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3491`_ | KVM: Propagating changes on host 
parameters to the agents  |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3879`_ | kvm: Enable virtio drivers based on 
guest os display name  |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3884`_ | kvm: fix exception in volume stats 
after storage migration |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3864`_ | Ignore site to site vpn status check on 
internallbvm       |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3871`_ | Fixed duplicate id error when creating 
VM work jobs        |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3873`_ | Fixed root volume resize from ui        
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3876`_ | server: use host record related to a 
ssvm/cpvm             |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3870`_ | systemvm: list systemvm does not return 
agent state and    |
+|                         |          | version                                 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3854`_ | Install python-dnspython or python-dns 
to fix issue with   |
+|                         |          | cloudstack-setup-management             
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3865`_ | Fixed default text missing from network 
selection on       |
+|                         |          | instance wizard                         
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3857`_ | vr: add missing rule for port 
forwarding rule in vpc       |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3851`_ | vpc: set traffic type of private 
gateway IP to Public to   |
+|                         |          | fix keepalived misconfiguration         
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3867`_ | Usage event to store zone id while 
uploading template and  |
+|                         |          | volume                                  
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3861`_ | test: check more connectivity in 
test_privategw_acl.py     |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3803`_ | Bug fix : set restart_required to 0 
after restarting       |
+|                         |          | network                                 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3791`_ | server: fix checking disk offering 
access for snapshot     |
+|                         |          | volume                                  
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3832`_ | ui bug fix: cannot assign vms to 
internal lb in VPC        |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3855`_ | kvm: Fix router migration issue when 
router has            |
+|                         |          | control/public nics onother physical 
network than guest    |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3383`_ | template: copy md5 mismatch             
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3819`_ | Clean up inactive iscsi sessions when 
VMs get moved due to |
+|                         |          | crashes                                 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3604`_ | Fix Policy Based Routing for private 
gateway static routes |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3840`_ | Fix listing management server by 
parameters                |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3834`_ | Fix: The metrics view API response is 
not super-set of     |
+|                         |          | resources response keys                 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3848`_ | vr: fix vr in unknown state (more)      
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3726`_ | vrouter: reload haproxy when cfg file 
is updated           |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3846`_ | Fix for "Impossible to edit domain 
settings in UI"         |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3845`_ | travis: use https based maven repo 
mirror                  |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3761`_ | [FIX] [BACKPORT] [4.13] Rethrow 
takeVMSnapshot() exception |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3758`_ | server: Fix NPE while update displayvm 
on vm with dynamic  |
+|                         |          | service offering                        
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3728`_ | server: double check host capacity when 
start/migrate a vm |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3727`_ | server: Capacity check should take vms 
in Migrating state  |
+|                         |          | into calculation                        
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3477`_ | RvR: Set up metadata/password/dhcp 
server on gateway IP    |
+|                         |          | instead of guest IP in RVR              
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3825`_ | fixed inconsistency of IP on VR when VR 
is destroyed and   |
+|                         |          | recrea…                                 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3759`_ | server: fix resource count error when 
upgrade a vm         |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3806`_ | python/c++ formatting in java corrected 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3795`_ | Agent lb on svm                         
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3776`_ | Add missing HA config keys              
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3778`_ | Endless settings on templates and 
instances                |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3743`_ | only update powerstate if sure it is 
the latest            |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3682`_ | ui: fix migrate host form no host popup 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3658`_ | client: fix for jetty session timeout   
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3662`_ | Increase DHCP lease time to infinite    
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3793`_ | ui: fix for truncated name for project 
accounts            |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3597`_ | kvm: Logrotate should not touch 
agent.log                  |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3721`_ | network: cleanup dhcp/dns entries while 
remove a nic from  |
+|                         |          | vm                                      
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3715`_ | break session only on illegal origin    
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3755`_ | Added zone check for attach iso         
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3729`_ | config: add isdynamic flag in 
configuration response       |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3733`_ | filter hosts to query on zone wide 
storage                 |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3747`_ | convert protocal names to be found as 
labels               |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3754`_ | Once again allow a VM to be on multiple 
networks from VPCs |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3767`_ | create template from snapshot 
regression (partly reverted) |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3765`_ | Honour promiscuous mode from 
networkOffering               |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3617`_ | [KVM] Agent LB Fix: Connections from 
disabled KVM host     |
+|                         |          | agents are refused                      
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3640`_ | consoleproxy: Enable console for vms in 
Stopping/Migrating |
+|                         |          | state                                   
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3635`_ | server: acquire IPv4 address when add 
secondary IP to nic  |
+|                         |          | if IP is not specified                  
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3636`_ | kvm: fix issue that network rules for 
secondary IPs are    |
+|                         |          | not applied                             
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3678`_ | vpc: fix acl rule with protocol number 
is not applied      |
+|                         |          | correctly in vpc vr                     
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3605`_ | fix issue #3590 'Revert Ceph/RBD 
Snapshot'                 |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3612`_ | systemvm: for ip route show command 
don't use the throw    |
+|                         |          | command                                 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3666`_ | snapshot failure diagnostics unhidden   
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3620`_ | Small additional NuageVsp cleanups 
(#3146)                 |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3648`_ | Security Group: limit returns in 
get_bridge_physdev to 1   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3627`_ | server: Do NOT cleanup dhcp and dns 
when stop a vm         |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3608`_ | server: Cleanup dhcp and dns entries 
only on expunging VM  |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3574`_ | `service is-active` output check for 
"failed"              |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3582`_ | systemvmtemplate: Fix Debian 9 iso url  
                   |
+| 4.13.1.0                | `#3825`_ | fixed inconsistency of IP on VR when VR 
is destroyed and   |
+|                         |          | recrea…                                 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3759`_ | server: fix resource count error when 
upgrade a vm         |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3806`_ | python/c++ formatting in java corrected 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3795`_ | Agent lb on svm                         
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3776`_ | Add missing HA config keys              
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3778`_ | Endless settings on templates and 
instances                |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3743`_ | only update powerstate if sure it is 
the latest            |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3682`_ | ui: fix migrate host form no host popup 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3658`_ | client: fix for jetty session timeout   
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3662`_ | Increase DHCP lease time to infinite    
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3793`_ | ui: fix for truncated name for project 
accounts            |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3597`_ | kvm: Logrotate should not touch 
agent.log                  |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3721`_ | network: cleanup dhcp/dns entries while 
remove a nic from  |
+|                         |          | vm                                      
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3715`_ | break session only on illegal origin    
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3755`_ | Added zone check for attach iso         
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3729`_ | config: add isdynamic flag in 
configuration response       |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3733`_ | filter hosts to query on zone wide 
storage                 |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3747`_ | convert protocal names to be found as 
labels               |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3754`_ | Once again allow a VM to be on multiple 
networks from VPCs |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3767`_ | create template from snapshot 
regression (partly reverted) |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3765`_ | Honour promiscuous mode from 
networkOffering               |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3617`_ | [KVM] Agent LB Fix: Connections from 
disabled KVM host     |
+|                         |          | agents are refused                      
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3640`_ | consoleproxy: Enable console for vms in 
Stopping/Migrating |
+|                         |          | state                                   
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3635`_ | server: acquire IPv4 address when add 
secondary IP to nic  |
+|                         |          | if IP is not specified                  
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3636`_ | kvm: fix issue that network rules for 
secondary IPs are    |
+|                         |          | not applied                             
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3678`_ | vpc: fix acl rule with protocol number 
is not applied      |
+|                         |          | correctly in vpc vr                     
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3605`_ | fix issue #3590 'Revert Ceph/RBD 
Snapshot'                 |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3612`_ | systemvm: for ip route show command 
don't use the throw    |
+|                         |          | command                                 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3666`_ | snapshot failure diagnostics unhidden   
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3620`_ | Small additional NuageVsp cleanups 
(#3146)                 |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3648`_ | Security Group: limit returns in 
get_bridge_physdev to 1   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3627`_ | server: Do NOT cleanup dhcp and dns 
when stop a vm         |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3608`_ | server: Cleanup dhcp and dns entries 
only on expunging VM  |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3574`_ | `service is-active` output check for 
"failed"              |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3582`_ | systemvmtemplate: Fix Debian 9 iso url  
                   |
+|                         |          | network                                 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3791`_ | server: fix checking disk offering 
access for snapshot     |
+|                         |          | volume                                  
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3832`_ | ui bug fix: cannot assign vms to 
internal lb in VPC        |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3855`_ | kvm: Fix router migration issue when 
router has            |
+|                         |          | control/public nics onother physical 
network than guest    |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3383`_ | template: copy md5 mismatch             
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3819`_ | Clean up inactive iscsi sessions when 
VMs get moved due to |
+|                         |          | crashes                                 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3604`_ | Fix Policy Based Routing for private 
gateway static routes |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3840`_ | Fix listing management server by 
parameters                |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3834`_ | Fix: The metrics view API response is 
not super-set of     |
+|                         |          | resources response keys                 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3848`_ | vr: fix vr in unknown state (more)      
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3726`_ | vrouter: reload haproxy when cfg file 
is updated           |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3846`_ | Fix for "Impossible to edit domain 
settings in UI"         |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3845`_ | travis: use https based maven repo 
mirror                  |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3761`_ | [FIX] [BACKPORT] [4.13] Rethrow 
takeVMSnapshot() exception |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3758`_ | server: Fix NPE while update displayvm 
on vm with dynamic  |
+|                         |          | service offering                        
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3728`_ | server: double check host capacity when 
start/migrate a vm |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3727`_ | server: Capacity check should take vms 
in Migrating state  |
+|                         |          | into calculation                        
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3477`_ | RvR: Set up metadata/password/dhcp 
server on gateway IP    |
+|                         |          | instead of guest IP in RVR              
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3825`_ | fixed inconsistency of IP on VR when VR 
is destroyed and   |
+|                         |          | recrea…                                 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3759`_ | server: fix resource count error when 
upgrade a vm         |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3806`_ | python/c++ formatting in java corrected 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3795`_ | Agent lb on svm                         
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3776`_ | Add missing HA config keys              
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3778`_ | Endless settings on templates and 
instances                |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3743`_ | only update powerstate if sure it is 
the latest            |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3682`_ | ui: fix migrate host form no host popup 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3658`_ | client: fix for jetty session timeout   
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3662`_ | Increase DHCP lease time to infinite    
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3793`_ | ui: fix for truncated name for project 
accounts            |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3597`_ | kvm: Logrotate should not touch 
agent.log                  |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3721`_ | network: cleanup dhcp/dns entries while 
remove a nic from  |
+|                         |          | vm                                      
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3715`_ | break session only on illegal origin    
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3755`_ | Added zone check for attach iso         
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3729`_ | config: add isdynamic flag in 
configuration response       |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3733`_ | filter hosts to query on zone wide 
storage                 |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3747`_ | convert protocal names to be found as 
labels               |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3754`_ | Once again allow a VM to be on multiple 
networks from VPCs |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3767`_ | create template from snapshot 
regression (partly reverted) |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3765`_ | Honour promiscuous mode from 
networkOffering               |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3617`_ | [KVM] Agent LB Fix: Connections from 
disabled KVM host     |
+|                         |          | agents are refused                      
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3640`_ | consoleproxy: Enable console for vms in 
Stopping/Migrating |
+|                         |          | state                                   
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3635`_ | server: acquire IPv4 address when add 
secondary IP to nic  |
+|                         |          | if IP is not specified                  
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3636`_ | kvm: fix issue that network rules for 
secondary IPs are    |
+|                         |          | not applied                             
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3678`_ | vpc: fix acl rule with protocol number 
is not applied      |
+|                         |          | correctly in vpc vr                     
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3605`_ | fix issue #3590 'Revert Ceph/RBD 
Snapshot'                 |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3612`_ | systemvm: for ip route show command 
don't use the throw    |
+|                         |          | command                                 
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3666`_ | snapshot failure diagnostics unhidden   
                   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3620`_ | Small additional NuageVsp cleanups 
(#3146)                 |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3648`_ | Security Group: limit returns in 
get_bridge_physdev to 1   |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3627`_ | server: Do NOT cleanup dhcp and dns 
when stop a vm         |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3608`_ | server: Cleanup dhcp and dns entries 
only on expunging VM  |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3574`_ | `service is-active` output check for 
"failed"              |
++-------------------------+----------+------------------------------------------------------------+
+| 4.13.1.0                | `#3582`_ | systemvmtemplate: Fix Debian 9 iso url  
                   |
++-------------------------+----------+------------------------------------------------------------+
+97 Issues listed
+
+.. _`#4042`: https://github.com/apache/cloudstack/pull/4042
+.. _`#4043`: https://github.com/apache/cloudstack/pull/4043
+.. _`#4033`: https://github.com/apache/cloudstack/pull/4033
+.. _`#3969`: https://github.com/apache/cloudstack/pull/3969
+.. _`#4025`: https://github.com/apache/cloudstack/pull/4025
+.. _`#4002`: https://github.com/apache/cloudstack/pull/4002
+.. _`#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
+.. _`#3989`: https://github.com/apache/cloudstack/pull/3989
+.. _`#3971`: https://github.com/apache/cloudstack/pull/3971
+.. _`#3932`: https://github.com/apache/cloudstack/pull/3932
+.. _`#3948`: https://github.com/apache/cloudstack/pull/3948
+.. _`#3943`: https://github.com/apache/cloudstack/pull/3943
+.. _`#3651`: https://github.com/apache/cloudstack/pull/3651
+.. _`#3947`: https://github.com/apache/cloudstack/pull/3947
+.. _`#3935`: https://github.com/apache/cloudstack/pull/3935
+.. _`#3924`: https://github.com/apache/cloudstack/pull/3924
+.. _`#3911`: https://github.com/apache/cloudstack/pull/3911
+.. _`#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
+.. _`#3905`: https://github.com/apache/cloudstack/pull/3905
+.. _`#3491`: https://github.com/apache/cloudstack/pull/3491
+.. _`#3879`: https://github.com/apache/cloudstack/pull/3879
+.. _`#3884`: https://github.com/apache/cloudstack/pull/3884
+.. _`#3864`: https://github.com/apache/cloudstack/pull/3864
+.. _`#3871`: https://github.com/apache/cloudstack/pull/3871
+.. _`#3873`: https://github.com/apache/cloudstack/pull/3873
+.. _`#3876`: https://github.com/apache/cloudstack/pull/3876
+.. _`#3870`: https://github.com/apache/cloudstack/pull/3870
+.. _`#3854`: https://github.com/apache/cloudstack/pull/3854
+.. _`#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
+.. _`#3803`: https://github.com/apache/cloudstack/pull/3803
+.. _`#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
+.. _`#3604`: https://github.com/apache/cloudstack/pull/3604
+.. _`#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
+.. _`#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
+.. _`#3825`: https://github.com/apache/cloudstack/pull/3825
+.. _`#3759`: https://github.com/apache/cloudstack/pull/3759
+.. _`#3806`: https://github.com/apache/cloudstack/pull/3806
+.. _`#3795`: https://github.com/apache/cloudstack/pull/3795
+.. _`#3776`: https://github.com/apache/cloudstack/pull/3776
+.. _`#3778`: https://github.com/apache/cloudstack/pull/3778
+.. _`#3743`: https://github.com/apache/cloudstack/pull/3743
+.. _`#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
+.. _`#3715`: https://github.com/apache/cloudstack/pull/3715
+.. _`#3755`: https://github.com/apache/cloudstack/pull/3755
+.. _`#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
+.. _`#3765`: https://github.com/apache/cloudstack/pull/3765
+.. _`#3617`: https://github.com/apache/cloudstack/pull/3617
+.. _`#3640`: https://github.com/apache/cloudstack/pull/3640
+.. _`#3635`: https://github.com/apache/cloudstack/pull/3635
+.. _`#3636`: https://github.com/apache/cloudstack/pull/3636
+.. _`#3678`: https://github.com/apache/cloudstack/pull/3678
+.. _`#3605`: https://github.com/apache/cloudstack/pull/3605
+.. _`#3612`: https://github.com/apache/cloudstack/pull/3612
+.. _`#3666`: https://github.com/apache/cloudstack/pull/3666
+.. _`#3620`: https://github.com/apache/cloudstack/pull/3620
+.. _`#3648`: https://github.com/apache/cloudstack/pull/3648
+.. _`#3627`: https://github.com/apache/cloudstack/pull/3627
+.. _`#3608`: https://github.com/apache/cloudstack/pull/3608
+.. _`#3574`: https://github.com/apache/cloudstack/pull/3574
+.. _`#3582`: https://github.com/apache/cloudstack/pull/3582
+
+Changes in 4.13.0.0 since 4.12.0.0
+===================================
 
 
 .. cssclass:: table-striped table-bordered table-hover
diff --git a/source/upgrading/index.rst b/source/upgrading/index.rst
index 3acf799..3fefce9 100644
--- a/source/upgrading/index.rst
+++ b/source/upgrading/index.rst
@@ -36,7 +36,8 @@ Contents:
 
 .. toctree::
    :maxdepth: 1
-
+   
+   upgrade/upgrade-4.13
    upgrade/upgrade-4.12
    upgrade/upgrade-4.11
    upgrade/upgrade-4.10
diff --git a/source/upgrading/upgrade/upgrade-4.13.rst 
b/source/upgrading/upgrade/upgrade-4.13.rst
new file mode 100644
index 0000000..a1c45e5
--- /dev/null
+++ b/source/upgrading/upgrade/upgrade-4.13.rst
@@ -0,0 +1,329 @@
+.. 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.13.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
+#. 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
+
+.. warning::
+    CloudStack |release| uses the same systemVM templates as 
|version_to_upgrade|,
+    so there is no need for a new systemVM template.
+
+
+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:`ubuntu413` or :ref:`rhel413` and :ref:`kvm413` 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 cloud > cloud-backup_`date '+%Y-%m-%d'`.sql
+      $ mysqldump -u root -p cloud_usage > cloud_usage-backup_`date 
'+%Y-%m-%d'`.sql
+
+#. **(KVM Only)** If primary storage of type local storage is in use, the
+   path for this storage needs to be verified to ensure it passes new
+   validation. Check local storage by querying the cloud.storage\_pool
+   table:
+
+   .. parsed-literal::
+
+      $ mysql -u cloud -p -e "select id,name,path from cloud.storage_pool 
where pool_type='Filesystem'"
+
+   If local storage paths are found to have a trailing forward slash,
+   remove it:
+
+   .. parsed-literal::
+
+      $ mysql -u cloud -p -e 'update cloud.storage_pool set 
path="/var/lib/libvirt/images" where path="/var/lib/libvirt/images/"';
+
+
+.. _ubuntu413:
+.. _apt-repo413:
+
+Management Server
+-----------------
+
+Ubuntu
+######
+
+If you are using Ubuntu, follow this procedure to upgrade your packages. If
+not, skip to step :ref:`rhel413`.
+
+.. 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.)
+
+
+
+Make sure that your ``/etc/apt/sources.list.d/cloudstack.list`` file on
+any systems that have CloudStack packages installed points to version 4.13
+
+This file should have one line, which contains:
+
+.. parsed-literal::
+
+   deb http://download.cloudstack.org/ubuntu precise 4.13
+
+
+#. 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
+
+
+.. _rhel413:
+.. _fpo413:
+
+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_413`.
+
+.. 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.)
+
+Confirm your ``/etc/yum.repos.d/cloudstack.repo`` file on
+any systems that have CloudStack packages installed points to version 4.13.
+
+This file should have content similar to the following:
+
+.. parsed-literal::
+
+   [apache-cloudstack]
+   name=Apache CloudStack
+   baseurl=http://download.cloudstack.org/centos/7/4.13/
+   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_413:
+
+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
+   build using "noredist". Refer to :ref:`building-noredist`.
+
+
+No additional steps are requried for the VMware Hypervisor for this upgrade.
+
+
+.. _kvm413:
+
+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-repo413>` 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
+
+#. Verify that the file ``/etc/cloudstack/agent/environment.properties`` has a
+   line that reads:
+
+   .. parsed-literal::
+
+      paths.script=/usr/share/cloudstack-common
+
+   If not, add the line.
+
+#. 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-repo413` as detailed above.
+
+   .. parsed-literal::
+
+      $ sudo yum upgrade cloudstack-agent
+
+#. Verify that the file ``/etc/cloudstack/agent/environment.properties`` has a
+   line that reads:
+
+   .. parsed-literal::
+
+      paths.script=/usr/share/cloudstack-common
+
+   If not, add the line.
+
+#. Restart the agent:
+
+   .. parsed-literal::
+
+      $ sudo service cloudstack-agent stop
+      $ sudo killall jsvc
+      $ 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

Reply via email to