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

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


The following commit(s) were added to refs/heads/4.18 by this push:
     new 5304e92  4.18.1.0: update release notes and upgrade instruction (#343)
5304e92 is described below

commit 5304e92e4ad55f53fe159bfd3858d956864408e7
Author: Wei Zhou <[email protected]>
AuthorDate: Thu Sep 14 12:35:30 2023 +0200

    4.18.1.0: update release notes and upgrade instruction (#343)
---
 source/_global.rst                        |  28 +-
 source/conf.py                            |   2 +-
 source/releasenotes/about.rst             |   6 +-
 source/releasenotes/api-changes.rst       |  96 +++++
 source/releasenotes/changes.rst           | 678 +++++++++++++++++++++++++++++-
 source/upgrading/index.rst                |   1 +
 source/upgrading/upgrade/upgrade-4.18.rst | 301 +++++++++++++
 7 files changed, 1090 insertions(+), 22 deletions(-)

diff --git a/source/_global.rst b/source/_global.rst
index fbec0e7..b8d3531 100644
--- a/source/_global.rst
+++ b/source/_global.rst
@@ -25,25 +25,19 @@
 
 .. Latest version systemvm template name
 
-.. |sysvm64-version|     replace:: 4.18.0
-.. |sysvm64-name-xen|    replace:: systemvm-xenserver-4.18.0
-.. |sysvm64-name-kvm|    replace:: systemvm-kvm-4.18.0
-.. |sysvm64-name-vmware| replace:: systemvm-vmware-4.18.0
-.. |sysvm64-name-hyperv| replace:: systemvm-hyperv-4.18.0
-.. |sysvm64-name-ovm|    replace:: systemvm-ovm-4.18.0
+.. |sysvm64-version|     replace:: 4.18.1
+.. |sysvm64-name-xen|    replace:: systemvm-xenserver-4.18.1
+.. |sysvm64-name-kvm|    replace:: systemvm-kvm-4.18.1
+.. |sysvm64-name-vmware| replace:: systemvm-vmware-4.18.1
+.. |sysvm64-name-hyperv| replace:: systemvm-hyperv-4.18.1
+.. |sysvm64-name-ovm|    replace:: systemvm-ovm-4.18.1
 
 .. Latest version systemvm template URL
-.. |sysvm64-url-xen|    replace:: 
http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.0-xen.vhd.bz2
-.. |sysvm64-url-kvm|    replace:: 
http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.0-kvm.qcow2.bz2
-.. |sysvm64-url-vmware| replace:: 
http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.0-vmware.ova
-.. |sysvm64-url-hyperv| replace:: 
http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.0-hyperv.vhd.zip
-.. |sysvm64-url-ovm|    replace:: 
http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.0-ovm.raw.bz2
-
-.. Version specific: 4.5 systemvm template URL
-.. |acs45-sysvm64-url-xen|    replace:: 
https://download.cloudstack.org/systemvm/4.5/systemvm64template-4.5-xen.vhd.bz2
-.. |acs45-sysvm64-url-kvm|    replace:: 
https://download.cloudstack.org/systemvm/4.5/systemvm64template-4.5-kvm.qcow2.bz2
-.. |acs45-sysvm64-url-vmware| replace:: 
https://download.cloudstack.org/systemvm/4.5/systemvm64template-4.5-vmware.ova
-.. |acs45-sysvm64-url-hyperv| replace:: 
https://download.cloudstack.org/systemvm/4.5/systemvm64template-4.5-hyperv.vhd.zip
+.. |sysvm64-url-xen|    replace:: 
http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.1-xen.vhd.bz2
+.. |sysvm64-url-kvm|    replace:: 
http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.1-kvm.qcow2.bz2
+.. |sysvm64-url-vmware| replace:: 
http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.1-vmware.ova
+.. |sysvm64-url-hyperv| replace:: 
http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.1-hyperv.vhd.zip
+.. |sysvm64-url-ovm|    replace:: 
http://download.cloudstack.org/systemvm/4.18/systemvmtemplate-4.18.1-ovm.raw.bz2
 
 .. Images
 
diff --git a/source/conf.py b/source/conf.py
index cb7366e..4dc872c 100644
--- a/source/conf.py
+++ b/source/conf.py
@@ -26,7 +26,7 @@ author = 'Apache CloudStack Project'
 # The short X.Y version
 version = '4.18'
 # The full version, including alpha/beta/rc tags
-release = '4.18.0.0'
+release = '4.18.1.0'
 
 rst_epilog = """
 .. include:: /_global.rst 
diff --git a/source/releasenotes/about.rst b/source/releasenotes/about.rst
index d39fb97..9ec18fc 100644
--- a/source/releasenotes/about.rst
+++ b/source/releasenotes/about.rst
@@ -17,11 +17,11 @@
 What's New in |release|
 =======================
 
-Apache CloudStack |release| is the initial 4.18 LTS release. It has over 300 
fixes
-and features since the 4.17.2.0 release.
+Apache CloudStack |release| is a 4.18 LTS minor release with 196 fixes
+since the 4.18.0.0 release.
 
 The full list of fixes and improvements can be found in the project release 
notes at
-https://docs.cloudstack.apache.org/en/4.18.0.0/releasenotes/changes.html
+https://docs.cloudstack.apache.org/en/4.18.1.0/releasenotes/changes.html
 
 What's in since 4.18.0.0
 ======================
diff --git a/source/releasenotes/api-changes.rst 
b/source/releasenotes/api-changes.rst
index 99043be..604b9f9 100644
--- a/source/releasenotes/api-changes.rst
+++ b/source/releasenotes/api-changes.rst
@@ -13,6 +13,102 @@
    specific language governing permissions and limitations
    under the License.
 
+API Changes in |release| since 4.18.0.0
+===================================
+For the complete list of API commands and params consult the `CloudStack 
Apidocs`_.
+
+Parameters Changed in API Commands
+-------------------------------
+
+.. cssclass:: table-striped table-bordered table-hover
+
++------------------------------------------------------------+--------------------------------------------------------------------------------+
+| Name                                                       | Description     
                                                               |
++============================================================+================================================================================+
+| ``listStoragePools``                                       | **Request:**    
                                                               |
+|                                                            |                 
                                                               |
+|                                                            | *New 
Parameters:*                                                              |
+|                                                            |                 
                                                               |
+|                                                            | - ``status`` 
(optional)                                                        |
+|                                                            |                 
                                                               |
++------------------------------------------------------------+--------------------------------------------------------------------------------+
+| ``startVirtualMachine``                                    | **Request:**    
                                                               |
+|                                                            |                 
                                                               |
+|                                                            | *Changed 
Parameters:*                                                          |
+|                                                            |                 
                                                               |
+|                                                            | - 
``considerLastHost`` was available for users but now only for ROOT admins    |
+|                                                            |                 
                                                               |
++------------------------------------------------------------+--------------------------------------------------------------------------------+
+| ``addGuestOs``                                             | **Request:**    
                                                               |
+|                                                            |                 
                                                               |
+|                                                            | *New 
Parameters:*                                                              |
+|                                                            |                 
                                                               |
+|                                                            | - ``display`` 
(optional)                                                       |
+|                                                            |                 
                                                               |
+|                                                            | *Changed 
Parameters:*                                                          |
+|                                                            |                 
                                                               |
+|                                                            | - ``details`` 
was 'required' and is now 'optional'                             |
+|                                                            |                 
                                                               |
++------------------------------------------------------------+--------------------------------------------------------------------------------+
+| ``updateGuestOs``                                          | **Request:**    
                                                               |
+|                                                            |                 
                                                               |
+|                                                            | *New 
Parameters:*                                                              |
+|                                                            |                 
                                                               |
+|                                                            | - ``display`` 
(optional)                                                       |
+|                                                            |                 
                                                               |
++------------------------------------------------------------+--------------------------------------------------------------------------------+
+| ``listOsTypes``                                            | **Request:**    
                                                               |
+|                                                            |                 
                                                               |
+|                                                            | *New 
Parameters:*                                                              |
+|                                                            |                 
                                                               |
+|                                                            | - ``display`` 
(optional)                                                       |
+|                                                            |                 
                                                               |
++------------------------------------------------------------+--------------------------------------------------------------------------------+
+| ``createAutoScaleVmProfile``                               | **Request:**    
                                                               |
+|                                                            |                 
                                                               |
+|                                                            | *New 
Parameters:*                                                              |
+|                                                            |                 
                                                               |
+|                                                            | - 
``userdataid`` (optional)                                                    |
+|                                                            | - 
``userdatadetails`` (optional)                                               |
+|                                                            |                 
                                                               |
+|                                                            | **Response:**   
                                                               |
+|                                                            |                 
                                                               |
+|                                                            | *New 
Parameters:*                                                              |
+|                                                            |                 
                                                               |
+|                                                            | - 
``userdataid``                                                               |
+|                                                            | - 
``userdataname``                                                             |
+|                                                            | - 
``userdatapolicy``                                                           |
+|                                                            | - 
``userdatadetails``                                                          |
+|                                                            |                 
                                                               |
++------------------------------------------------------------+--------------------------------------------------------------------------------+
+| ``updateAutoScaleVmProfile``                               | **Request:**    
                                                               |
+|                                                            |                 
                                                               |
+|                                                            | *New 
Parameters:*                                                              |
+|                                                            |                 
                                                               |
+|                                                            | - 
``userdataid`` (optional)                                                    |
+|                                                            | - 
``userdatadetails`` (optional)                                               |
+|                                                            |                 
                                                               |
+|                                                            | **Response:**   
                                                               |
+|                                                            |                 
                                                               |
+|                                                            | *New 
Parameters:*                                                              |
+|                                                            |                 
                                                               |
+|                                                            | - 
``userdataid``                                                               |
+|                                                            | - 
``userdataname``                                                             |
+|                                                            | - 
``userdatapolicy``                                                           |
+|                                                            | - 
``userdatadetails``                                                          |
+|                                                            |                 
                                                               |
++------------------------------------------------------------+--------------------------------------------------------------------------------+
+| ``listAutoScaleVmProfiles``                                | **Response:**   
                                                               |
+|                                                            |                 
                                                               |
+|                                                            | *New 
Parameters:*                                                              |
+|                                                            |                 
                                                               |
+|                                                            | - 
``userdataid``                                                               |
+|                                                            | - 
``userdataname``                                                             |
+|                                                            | - 
``userdatapolicy``                                                           |
+|                                                            | - 
``userdatadetails``                                                          |
+|                                                            |                 
                                                               |
++------------------------------------------------------------+--------------------------------------------------------------------------------+
+
 API Changes Introduced in 4.18.0.0
 ===================================
 For the complete list of API commands and params consult the `CloudStack 
Apidocs`_.
diff --git a/source/releasenotes/changes.rst b/source/releasenotes/changes.rst
index 5b76795..9c63c84 100644
--- a/source/releasenotes/changes.rst
+++ b/source/releasenotes/changes.rst
@@ -13,7 +13,487 @@
    specific language governing permissions and limitations
    under the License.
 
-Changes in |release| since 4.17.2.0
+
+Changes in |release| since 4.18.0.0
+===================================
+
+Apache CloudStack uses GitHub 
https://github.com/apache/cloudstack/milestone/27?closed=1
+to track its issues.
+
+
+.. cssclass:: table-striped table-bordered table-hover
+
+
++-------------------------+----------+--------------------------------------------------------------+
+| Version                 | Github   | Description                             
                     |
++=========================+==========+==============================================================+
+| 4.18.1.0                | `#7933`_ | server: fix dualstack ipv6 networks for 
vxlan                |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7945`_ | kvm: fix live vm migration between 
local storage pools       |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7947`_ | ui: don't skip if dataview has multiple 
items in response    |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7932`_ | Fix direct download https compressed 
qcow2 template checker  |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7924`_ | PowerFlex: Handle missing volumes 
gracefully during delete   |
+|                         |          | volume                                  
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7922`_ | db: Add index on cluster_details.name 
for FirstFitPlanner    |
+|                         |          | speedup                                 
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7887`_ | xen/xcpng: set vmr.VCPUsMax to minimum 
of global setting and |
+|                         |          | host cpu cores                          
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7913`_ | server: throw new exception when 
rootdisksize is required    |
+|                         |          | but not set                             
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7874`_ | systemvm: update size and state of 
systemvm template during  |
+|                         |          | registration                            
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7867`_ | UI: Infer template settings in the 
deploy VM wizard          |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7911`_ | ui: speed up compute instance listing   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7846`_ | ui: Fix refresh and re-route behaviour  
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7877`_ | server: try with all supported 
hypervisors (ordered, no      |
+|                         |          | duplications) when deploy a virtual 
router                   |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7144`_ | server: fix cannot get systemvm ips in 
dedicated ranges      |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7909`_ | server: fix global setting              
                     |
+|                         |          | 
system.vm.public.ip.reservation.mode.strictness is not       |
+|                         |          | really dynamic                          
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7761`_ | vmware: improve solidfire storage 
plugin integration and fix |
+|                         |          | cases                                   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7898`_ | server: allow user to list available 
IPs on shared networks  |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7609`_ | ui: fix notification list reordering 
intermittently          |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7880`_ | server Don't allow inadvertent deletion 
of hidden details    |
+|                         |          | via API                                 
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7900`_ | UI: Add central project store and watch 
functionality        |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7894`_ | ui: bump UI pkg version to match 
CloudStacks                 |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7897`_ | ui: make it clear that deletion of a 
volume will not delete  |
+|                         |          | any snapshots                           
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7896`_ | UI: update ip ranges of shared networks 
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7799`_ | engine/schema: fix duplicated guest 
OSes in 4.18.0.0         |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7893`_ | ui: Fix project theme on reload or 
refresh                   |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7886`_ | server: check hostId when attach disk 
to a Stopped vm with   |
+|                         |          | local storage                           
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7801`_ | ui: fix creating zone with vxlan if 
Guest physical network   |
+|                         |          | is not the last                         
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7769`_ | AutoScaling: support Managed User Data  
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7882`_ | UI: Fix hide delete button for 
templates that are in         |
+|                         |          | Installing template state               
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7888`_ | Support GNU sed apidoc for MacOS build  
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7870`_ | server: Allow admins to disable the 2FA 
of users in          |
+|                         |          | subdomains                              
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7879`_ | UI: Add missing tooltips to 
Register/Upload Templates/ISOs   |
+|                         |          | views                                   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7876`_ | Api: update command domainId/account 
descriptions            |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7826`_ | cpvm: Fix CPVM not releasing CPU after 
closing console       |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7293`_ | security group: replace 
vm.getPrivateMacAddress() with       |
+|                         |          | nic.getMacAddress()                     
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7853`_ | Fix role escalation prevention          
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7875`_ | packaging: install tzdata-java or 
timezone-java              |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7848`_ | server: get only Ready ISO to mount     
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7380`_ | VMware: add support for 8.0b (8.0.0.2), 
8.0c (8.0.0.3)       |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7844`_ | server: Replace Hashtable with 
LinkedHashMap in              |
+|                         |          | createIsoResponse                       
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7866`_ | api: Force-stop descriptions            
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7869`_ | UI: Show iso urls                       
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7862`_ | test: skip live storage migration on 
CentOS 7                |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#6970`_ | CPVM: fix cpu usage for console vm when 
using vnc over       |
+|                         |          | websockets                              
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7832`_ | server: Fix allocation of more public 
IPs than the account's |
+|                         |          | limit                                   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7831`_ | VMware: Fix casting exception during 
backup NIC              |
+|                         |          | synchronization                         
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7854`_ | CKS: check access when get 
kubernetescluster config          |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7833`_ | ui: assorted improvements               
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7828`_ | cloudstack: bump to use 4.18.1.0 
systemvmtemplate            |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7845`_ | storpool: fix pom.xml which caused 
docker image build        |
+|                         |          | failures                                
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7777`_ | server: remove registered userdata when 
cleanup an account   |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7441`_ | server: Use max secondary storage 
defined on the account     |
+|                         |          | during upload                           
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7685`_ | test: upgrade kubernetes versions to 
1.25.0/1.26.0           |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7836`_ | kvm: Added VNI Devices as normal bridge 
slave devs           |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7694`_ | noVNC: fix JP keyboard on vmware7+ 
which uses websocket URL  |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7629`_ | Prometheus exporter fix cpu/memory 
usage labels              |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7775`_ | server: clean network offerings for 
domain on remove         |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7808`_ | engine/schema: fix CPU cap limitation 
for upgraded           |
+|                         |          | environment                             
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7760`_ | VM.CREATE/VOLUME.DELETE/VOLUME.DESTROY 
not being emitted     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7810`_ | Allow KVM overcommit to work without 
reducing minimum VM     |
+|                         |          | memory when vm ballooning is disabled   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7812`_ | make details optional for addGuestOs 
API                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7809`_ | Remove nic allocation txn during Vm 
deploy.                  |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7667`_ | include all VMs when projects selected 
not just for admins   |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7793`_ | UI: allow new keys for VM details       
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7392`_ | Refactoring StorPool's smoke tests      
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7796`_ | UI: decode userdata in EditVM dialog    
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7722`_ | packaging: unalias cp before package 
upgrade                 |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7564`_ | make NoopDbUpgrade do a systemvm 
template check              |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7792`_ | UI unit test: fix expected values       
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7739`_ | UI: Filter templates by zone and 
hypervisor type when        |
+|                         |          | reinstall a VM                          
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7663`_ | KVM: fix SSVM starting when 
overprovisioning memory          |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7706`_ | pom.xml: add property 
project.systemvm.template.location     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7779`_ | cloudutils: fix adding rocky9 host 
failure due to missing    |
+|                         |          | /etc/sysconfig/libvirtd                 
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7785`_ | server: get id from persisted object 
ReservationVO           |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7766`_ | search in (too) large result sets       
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7772`_ | ui: fix 404 error when list volumes of 
system vms            |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7768`_ | packaging: install tzdata-java on 
centos7/centos8            |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7750`_ | add remove tag to remove acl item 
method                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7758`_ | UI: fix userdataid or userdata content 
is passed when        |
+|                         |          | userdata append/override is unchecked   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7765`_ | Fix NPE in management server logs due 
to /proc/cpuinfo       |
+|                         |          | output                                  
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7764`_ | UI: add step to create bearer token for 
kubernetes dashboard |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7735`_ | Set encrypted PowerFlex disk format 
correctly                |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7708`_ | utils: fix RBD URI if credentials 
contains slash             |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7749`_ | ui: fix userdata base64 encoding        
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7757`_ | Allow encrypted volume migration for 
PowerFlex volumes       |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7724`_ | server: clear resource reservation and 
increment resource    |
+|                         |          | count in a transaction                  
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7288`_ | SSVM: 'allow from' private IP in other 
SSVMs if the public   |
+|                         |          | IP is in allowed internal sites cidrs   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7754`_ | eof added to StorPoolStatsCollector     
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7404`_ | Storage and volumes statistics tasks 
for StorPool primary    |
+|                         |          | storage                                 
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#6797`_ | proper storage construction             
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7634`_ | guarantee MAC uniqueness                
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7656`_ | server: allow migration of all VMs with 
local storage on KVM |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7719`_ | Add L2 networks to Zones with SG        
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7641`_ | vmware: fix unmanaged instance listing 
when different name & |
+|                         |          | internal CS name                        
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7580`_ | agent: get the right controll cidr      
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7732`_ | Sync precommit config from main         
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7695`_ | server,engine-orchestration: allocate 
vm without transaction |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7693`_ | Fix direct download URL checks          
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7713`_ | use `Files.createTempDirectory()` 
instead of `new File()`    |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7691`_ | NPE guard                               
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7381`_ | Fix foreign key constraints and the 
mysql procedure that is  |
+|                         |          | used                                    
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7707`_ | UI: fix wrong vpcid when create network 
in VPC               |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7630`_ | cleanup removal of physical network     
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7237`_ | console proxy: use AeadBase64Encryptor 
instead of            |
+|                         |          | AES/CBC/PKCS5Padding                    
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7607`_ | server: do not check zone imagestores 
for directdownload     |
+|                         |          | template delete                         
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7588`_ | UI: Zone wizard fix                     
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7666`_ | engine-orchestration: fix volume size 
resource count         |
+|                         |          | mismatch                                
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7689`_ | scaleio: Avoid race condition while 
handling host disconnect |
+|                         |          | and connect scenarios                   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7687`_ | api: correct error on resize volume 
resource allocation      |
+|                         |          | failure                                 
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7583`_ | marvin: fix smoke test failures if mgmt 
server is Ubuntu     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7628`_ | ui: fix vm import for L2 n/w in Setup 
state                  |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7511`_ | Tungsten: change conserve_mode of 
default network offering   |
+|                         |          | to 0                                    
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7539`_ | Volume encryption support for StorPool 
plug-in               |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7594`_ | Fix: Volumes on lost local storage 
cannot be removed         |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7584`_ | server: Add check on host's status 
while deleting config     |
+|                         |          | drive on host cache                     
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7664`_ | [4.18] Bump the version to 
4.18.1.0-SNAPSHOT                 |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7408`_ | Allow volume migrations in ScaleIO 
within and across ScaleIO |
+|                         |          | storage clusters                        
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7444`_ | engine-orchestration,vmware: hypervisor 
migration during     |
+|                         |          | start vm migration                      
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7636`_ | utils: fix check for mrtalink url       
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7620`_ | accept first word from host os string 
for backwards          |
+|                         |          | compatibility                           
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7597`_ | consider last host only for root-admin  
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7410`_ | ssvm: pass all accessible secondary 
storage to ssvm          |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7570`_ | interpret /etc/redhet-release better    
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7602`_ | marvin: fix test_data for parsing 
failure                    |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7592`_ | .github: Use parallel builds for github 
actions              |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#6512`_ | Refactor test and change IP range       
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7313`_ | server: improve storage GC to skip 
expunging possible        |
+|                         |          | duplicate volumes                       
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7160`_ | vmware: do not create vm datastore when 
attach an existing   |
+|                         |          | volume on solidfire                     
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7524`_ | secondary-storage: delete backedup 
snapshot dir on delete    |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7479`_ | cks: k8s cluster on vpc tier            
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7508`_ | guestos: add Windows Server 2022        
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7452`_ | test: reduce PowerMock usage for code 
coverage               |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7475`_ | cks,ui: allow changing stopped cluster 
offering,             |
+|                         |          | improvements                            
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7559`_ | Create user 'cloud' in cloudstack-usage 
postinstall          |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7526`_ | server: fix volume detach operation 
when no vm host          |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7557`_ | ui: show zones and offerings to users   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7455`_ | Fix Tungsten Fabric errors on adding a 
new zone due to       |
+|                         |          | duplicated entries on ntwk_service_map  
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7527`_ | ui: fix infocard tempalte, iso fields   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7485`_ | engine-storage: fix errored template 
becomes active          |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7424`_ | ui: fix tags for security group rules   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7521`_ | Marvin: Fix deployDataCenter's cleanup  
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7522`_ | github-actions: fix ui build workflow   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7506`_ | increase log detail for limit checking, 
fix                  |
+|                         |          | getDomainReservation()                  
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7421`_ | api,server: fix VM.CREATE events on vm 
deploy without start  |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7265`_ | router: do not restart conntrackd if no 
guest networks       |
+|                         |          | (issue 6702)                            
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7448`_ | server: add config SSVM capacity scan   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7264`_ | ssvm: continue with other secondary 
storages if fails to     |
+|                         |          | program a secondary storage             
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7513`_ | ui: set default cpu, memory value for 
k8s version            |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7512`_ | ui: fix sourceIP is not passed when 
create internal LB       |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7499`_ | ui: fix action notifications            
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7163`_ | fix tools/build/setnextversion.sh: do 
not update             |
+|                         |          | tools/apidoc/pom.xml                    
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7027`_ | marvin: replace encodestring for 
encodebytes                 |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7478`_ | addAnnotation: added the various entity 
type supported by    |
+|                         |          | the api call                            
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7494`_ | server: Fix DirectDownload certificate 
check initial delay   |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7498`_ | server: fix null pointer on powerflex 
attach volume edge     |
+|                         |          | case                                    
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7482`_ | Qemu migration hook: check for source 
length before using    |
+|                         |          | element 0                               
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7477`_ | novnc: Send console text slower to 
avoid overloading remote  |
+|                         |          | keyboard buffer                         
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7453`_ | Support local storage live migration 
for direct download     |
+|                         |          | templates                               
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7423`_ | ui: fix custom offering cpuspeed during 
vm import            |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7415`_ | server: validate ip address value on 
update config           |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7445`_ | ssvm: fix post request header case 
mismatch                  |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7439`_ | refactor: delete unsed serviceoffering 
classes in quota      |
+|                         |          | module                                  
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7368`_ | ui: Add filtering by state in account, 
systemvms, router and |
+|                         |          | storagepool                             
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7215`_ | server: dedicate vxlan range to account 
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7373`_ | ui: Allow admin/user to filter by state 
for Pods, Clusters   |
+|                         |          | and Hosts                               
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7269`_ | debian/control: build packages on 
ubuntu 22.04               |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7398`_ | server,engine-schema: fix listing 
service offering for vm    |
+|                         |          | scale                                   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7360`_ | Set hypervisor hostname via userdata 
only when the global    |
+|                         |          | settings are allowed                    
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7407`_ | server: rephrase error message for iso 
vm reinstall          |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7400`_ | Fix for direct download templates with 
multiple bypassed     |
+|                         |          | references                              
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7384`_ | server: Roles search by keyword         
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7385`_ | vmware: Datastore cluster 
synchronization should check if    |
+|                         |          | the child datastores are in UP state or 
not                  |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7393`_ | ui: CreateNetwork isolated/L2 form, 
added accounts list      |
+|                         |          | under selected domain                   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7276`_ | ui: allow clearing dns during zone 
update                    |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7411`_ | ui: show only advanced zones for 
vmautoscale form            |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7277`_ | ui: show vpn users tab in networks 
section                   |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7406`_ | server: list vm search vm ip using 
keyword                   |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7394`_ | ui: allow creating account 
networkdomain                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7388`_ | pom.xml: bump only required 
dependencies                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7402`_ | ui: Fixed the Description coloumn in 
the UI for Quota        |
+|                         |          | traffic page                            
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7359`_ | Fix ScaleVM to consider resize volume 
in any type of service |
+|                         |          | offering                                
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7281`_ | Console: upgrade noVNC from v1.2.0 to 
v1.4.0                 |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7328`_ | server: fix userdatadetails parsing     
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7395`_ | ui: show static-nat tag for public ip   
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7387`_ | Added details about account/domain to 
which network will be  |
+|                         |          | assigned during creation                
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7268`_ | saml: Add EncryptedElementType key 
resolver to SAML plugin   |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7332`_ | test: add smoke test for user role for 
userdata crud api     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7327`_ | orchestration: fix error on deleted 
template vm start        |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7382`_ | fixed L2 network creation for 
particular account             |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7200`_ | Added upper case JPEG extension for 
icon upload              |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7343`_ | UI: fix templates/offerings are not 
listed in autoscale vm   |
+|                         |          | profile when login as user              
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7372`_ | Fixed avoid set variables which is 
causing deployment        |
+|                         |          | failures                                
                     |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7374`_ | Add service ip to listManagementServers 
API response         |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7367`_ | UI: fix default network is not passed 
to deployvm API        |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7361`_ | ui: Added UEFI support flag in host 
details view             |
++-------------------------+----------+--------------------------------------------------------------+
+| 4.18.1.0                | `#7140`_ | Fix PR 7131 bugs and vulnerabilities    
                     |
++-------------------------+----------+--------------------------------------------------------------+
+
+196 Issues listed
+
+
+Changes in 4.18.0.0 since 4.17.x
 ===================================
 
 Apache CloudStack uses GitHub 
https://github.com/apache/cloudstack/milestone/23?closed=1
@@ -701,3 +1181,199 @@ to track its issues.
 .. _`#6331`: https://github.com/apache/cloudstack/pull/6331 
 .. _`#6474`: https://github.com/apache/cloudstack/pull/6474 
 .. _`#6326`: https://github.com/apache/cloudstack/pull/6326 
+.. _`#7933`: https://github.com/apache/cloudstack/pull/7933
+.. _`#7945`: https://github.com/apache/cloudstack/pull/7945
+.. _`#7947`: https://github.com/apache/cloudstack/pull/7947
+.. _`#7932`: https://github.com/apache/cloudstack/pull/7932
+.. _`#7924`: https://github.com/apache/cloudstack/pull/7924
+.. _`#7922`: https://github.com/apache/cloudstack/pull/7922
+.. _`#7887`: https://github.com/apache/cloudstack/pull/7887
+.. _`#7913`: https://github.com/apache/cloudstack/pull/7913
+.. _`#7874`: https://github.com/apache/cloudstack/pull/7874
+.. _`#7867`: https://github.com/apache/cloudstack/pull/7867
+.. _`#7911`: https://github.com/apache/cloudstack/pull/7911
+.. _`#7846`: https://github.com/apache/cloudstack/pull/7846
+.. _`#7877`: https://github.com/apache/cloudstack/pull/7877
+.. _`#7144`: https://github.com/apache/cloudstack/pull/7144
+.. _`#7909`: https://github.com/apache/cloudstack/pull/7909
+.. _`#7761`: https://github.com/apache/cloudstack/pull/7761
+.. _`#7898`: https://github.com/apache/cloudstack/pull/7898
+.. _`#7609`: https://github.com/apache/cloudstack/pull/7609
+.. _`#7880`: https://github.com/apache/cloudstack/pull/7880
+.. _`#7900`: https://github.com/apache/cloudstack/pull/7900
+.. _`#7894`: https://github.com/apache/cloudstack/pull/7894
+.. _`#7897`: https://github.com/apache/cloudstack/pull/7897
+.. _`#7896`: https://github.com/apache/cloudstack/pull/7896
+.. _`#7799`: https://github.com/apache/cloudstack/pull/7799
+.. _`#7893`: https://github.com/apache/cloudstack/pull/7893
+.. _`#7886`: https://github.com/apache/cloudstack/pull/7886
+.. _`#7801`: https://github.com/apache/cloudstack/pull/7801
+.. _`#7769`: https://github.com/apache/cloudstack/pull/7769
+.. _`#7882`: https://github.com/apache/cloudstack/pull/7882
+.. _`#7888`: https://github.com/apache/cloudstack/pull/7888
+.. _`#7870`: https://github.com/apache/cloudstack/pull/7870
+.. _`#7879`: https://github.com/apache/cloudstack/pull/7879
+.. _`#7876`: https://github.com/apache/cloudstack/pull/7876
+.. _`#7826`: https://github.com/apache/cloudstack/pull/7826
+.. _`#7293`: https://github.com/apache/cloudstack/pull/7293
+.. _`#7853`: https://github.com/apache/cloudstack/pull/7853
+.. _`#7875`: https://github.com/apache/cloudstack/pull/7875
+.. _`#7848`: https://github.com/apache/cloudstack/pull/7848
+.. _`#7380`: https://github.com/apache/cloudstack/pull/7380
+.. _`#7844`: https://github.com/apache/cloudstack/pull/7844
+.. _`#7866`: https://github.com/apache/cloudstack/pull/7866
+.. _`#7869`: https://github.com/apache/cloudstack/pull/7869
+.. _`#7862`: https://github.com/apache/cloudstack/pull/7862
+.. _`#6970`: https://github.com/apache/cloudstack/pull/6970
+.. _`#7832`: https://github.com/apache/cloudstack/pull/7832
+.. _`#7831`: https://github.com/apache/cloudstack/pull/7831
+.. _`#7854`: https://github.com/apache/cloudstack/pull/7854
+.. _`#7833`: https://github.com/apache/cloudstack/pull/7833
+.. _`#7828`: https://github.com/apache/cloudstack/pull/7828
+.. _`#7845`: https://github.com/apache/cloudstack/pull/7845
+.. _`#7777`: https://github.com/apache/cloudstack/pull/7777
+.. _`#7441`: https://github.com/apache/cloudstack/pull/7441
+.. _`#7685`: https://github.com/apache/cloudstack/pull/7685
+.. _`#7836`: https://github.com/apache/cloudstack/pull/7836
+.. _`#7694`: https://github.com/apache/cloudstack/pull/7694
+.. _`#7629`: https://github.com/apache/cloudstack/pull/7629
+.. _`#7775`: https://github.com/apache/cloudstack/pull/7775
+.. _`#7808`: https://github.com/apache/cloudstack/pull/7808
+.. _`#7760`: https://github.com/apache/cloudstack/pull/7760
+.. _`#7810`: https://github.com/apache/cloudstack/pull/7810
+.. _`#7812`: https://github.com/apache/cloudstack/pull/7812
+.. _`#7809`: https://github.com/apache/cloudstack/pull/7809
+.. _`#7667`: https://github.com/apache/cloudstack/pull/7667
+.. _`#7793`: https://github.com/apache/cloudstack/pull/7793
+.. _`#7392`: https://github.com/apache/cloudstack/pull/7392
+.. _`#7796`: https://github.com/apache/cloudstack/pull/7796
+.. _`#7722`: https://github.com/apache/cloudstack/pull/7722
+.. _`#7564`: https://github.com/apache/cloudstack/pull/7564
+.. _`#7792`: https://github.com/apache/cloudstack/pull/7792
+.. _`#7739`: https://github.com/apache/cloudstack/pull/7739
+.. _`#7663`: https://github.com/apache/cloudstack/pull/7663
+.. _`#7706`: https://github.com/apache/cloudstack/pull/7706
+.. _`#7779`: https://github.com/apache/cloudstack/pull/7779
+.. _`#7785`: https://github.com/apache/cloudstack/pull/7785
+.. _`#7766`: https://github.com/apache/cloudstack/pull/7766
+.. _`#7772`: https://github.com/apache/cloudstack/pull/7772
+.. _`#7768`: https://github.com/apache/cloudstack/pull/7768
+.. _`#7750`: https://github.com/apache/cloudstack/pull/7750
+.. _`#7758`: https://github.com/apache/cloudstack/pull/7758
+.. _`#7765`: https://github.com/apache/cloudstack/pull/7765
+.. _`#7764`: https://github.com/apache/cloudstack/pull/7764
+.. _`#7735`: https://github.com/apache/cloudstack/pull/7735
+.. _`#7708`: https://github.com/apache/cloudstack/pull/7708
+.. _`#7749`: https://github.com/apache/cloudstack/pull/7749
+.. _`#7757`: https://github.com/apache/cloudstack/pull/7757
+.. _`#7724`: https://github.com/apache/cloudstack/pull/7724
+.. _`#7288`: https://github.com/apache/cloudstack/pull/7288
+.. _`#7754`: https://github.com/apache/cloudstack/pull/7754
+.. _`#7404`: https://github.com/apache/cloudstack/pull/7404
+.. _`#6797`: https://github.com/apache/cloudstack/pull/6797
+.. _`#7634`: https://github.com/apache/cloudstack/pull/7634
+.. _`#7656`: https://github.com/apache/cloudstack/pull/7656
+.. _`#7719`: https://github.com/apache/cloudstack/pull/7719
+.. _`#7641`: https://github.com/apache/cloudstack/pull/7641
+.. _`#7580`: https://github.com/apache/cloudstack/pull/7580
+.. _`#7732`: https://github.com/apache/cloudstack/pull/7732
+.. _`#7695`: https://github.com/apache/cloudstack/pull/7695
+.. _`#7693`: https://github.com/apache/cloudstack/pull/7693
+.. _`#7713`: https://github.com/apache/cloudstack/pull/7713
+.. _`#7691`: https://github.com/apache/cloudstack/pull/7691
+.. _`#7381`: https://github.com/apache/cloudstack/pull/7381
+.. _`#7707`: https://github.com/apache/cloudstack/pull/7707
+.. _`#7630`: https://github.com/apache/cloudstack/pull/7630
+.. _`#7237`: https://github.com/apache/cloudstack/pull/7237
+.. _`#7607`: https://github.com/apache/cloudstack/pull/7607
+.. _`#7588`: https://github.com/apache/cloudstack/pull/7588
+.. _`#7666`: https://github.com/apache/cloudstack/pull/7666
+.. _`#7689`: https://github.com/apache/cloudstack/pull/7689
+.. _`#7687`: https://github.com/apache/cloudstack/pull/7687
+.. _`#7583`: https://github.com/apache/cloudstack/pull/7583
+.. _`#7628`: https://github.com/apache/cloudstack/pull/7628
+.. _`#7511`: https://github.com/apache/cloudstack/pull/7511
+.. _`#7539`: https://github.com/apache/cloudstack/pull/7539
+.. _`#7594`: https://github.com/apache/cloudstack/pull/7594
+.. _`#7584`: https://github.com/apache/cloudstack/pull/7584
+.. _`#7664`: https://github.com/apache/cloudstack/pull/7664
+.. _`#7408`: https://github.com/apache/cloudstack/pull/7408
+.. _`#7444`: https://github.com/apache/cloudstack/pull/7444
+.. _`#7636`: https://github.com/apache/cloudstack/pull/7636
+.. _`#7620`: https://github.com/apache/cloudstack/pull/7620
+.. _`#7597`: https://github.com/apache/cloudstack/pull/7597
+.. _`#7410`: https://github.com/apache/cloudstack/pull/7410
+.. _`#7570`: https://github.com/apache/cloudstack/pull/7570
+.. _`#7602`: https://github.com/apache/cloudstack/pull/7602
+.. _`#7592`: https://github.com/apache/cloudstack/pull/7592
+.. _`#6512`: https://github.com/apache/cloudstack/pull/6512
+.. _`#7313`: https://github.com/apache/cloudstack/pull/7313
+.. _`#7160`: https://github.com/apache/cloudstack/pull/7160
+.. _`#7524`: https://github.com/apache/cloudstack/pull/7524
+.. _`#7479`: https://github.com/apache/cloudstack/pull/7479
+.. _`#7508`: https://github.com/apache/cloudstack/pull/7508
+.. _`#7452`: https://github.com/apache/cloudstack/pull/7452
+.. _`#7475`: https://github.com/apache/cloudstack/pull/7475
+.. _`#7559`: https://github.com/apache/cloudstack/pull/7559
+.. _`#7526`: https://github.com/apache/cloudstack/pull/7526
+.. _`#7557`: https://github.com/apache/cloudstack/pull/7557
+.. _`#7455`: https://github.com/apache/cloudstack/pull/7455
+.. _`#7527`: https://github.com/apache/cloudstack/pull/7527
+.. _`#7485`: https://github.com/apache/cloudstack/pull/7485
+.. _`#7424`: https://github.com/apache/cloudstack/pull/7424
+.. _`#7521`: https://github.com/apache/cloudstack/pull/7521
+.. _`#7522`: https://github.com/apache/cloudstack/pull/7522
+.. _`#7506`: https://github.com/apache/cloudstack/pull/7506
+.. _`#7421`: https://github.com/apache/cloudstack/pull/7421
+.. _`#7265`: https://github.com/apache/cloudstack/pull/7265
+.. _`#7448`: https://github.com/apache/cloudstack/pull/7448
+.. _`#7264`: https://github.com/apache/cloudstack/pull/7264
+.. _`#7513`: https://github.com/apache/cloudstack/pull/7513
+.. _`#7512`: https://github.com/apache/cloudstack/pull/7512
+.. _`#7499`: https://github.com/apache/cloudstack/pull/7499
+.. _`#7163`: https://github.com/apache/cloudstack/pull/7163
+.. _`#7027`: https://github.com/apache/cloudstack/pull/7027
+.. _`#7478`: https://github.com/apache/cloudstack/pull/7478
+.. _`#7494`: https://github.com/apache/cloudstack/pull/7494
+.. _`#7498`: https://github.com/apache/cloudstack/pull/7498
+.. _`#7482`: https://github.com/apache/cloudstack/pull/7482
+.. _`#7477`: https://github.com/apache/cloudstack/pull/7477
+.. _`#7453`: https://github.com/apache/cloudstack/pull/7453
+.. _`#7423`: https://github.com/apache/cloudstack/pull/7423
+.. _`#7415`: https://github.com/apache/cloudstack/pull/7415
+.. _`#7445`: https://github.com/apache/cloudstack/pull/7445
+.. _`#7439`: https://github.com/apache/cloudstack/pull/7439
+.. _`#7368`: https://github.com/apache/cloudstack/pull/7368
+.. _`#7215`: https://github.com/apache/cloudstack/pull/7215
+.. _`#7373`: https://github.com/apache/cloudstack/pull/7373
+.. _`#7269`: https://github.com/apache/cloudstack/pull/7269
+.. _`#7398`: https://github.com/apache/cloudstack/pull/7398
+.. _`#7360`: https://github.com/apache/cloudstack/pull/7360
+.. _`#7407`: https://github.com/apache/cloudstack/pull/7407
+.. _`#7400`: https://github.com/apache/cloudstack/pull/7400
+.. _`#7384`: https://github.com/apache/cloudstack/pull/7384
+.. _`#7385`: https://github.com/apache/cloudstack/pull/7385
+.. _`#7393`: https://github.com/apache/cloudstack/pull/7393
+.. _`#7276`: https://github.com/apache/cloudstack/pull/7276
+.. _`#7411`: https://github.com/apache/cloudstack/pull/7411
+.. _`#7277`: https://github.com/apache/cloudstack/pull/7277
+.. _`#7406`: https://github.com/apache/cloudstack/pull/7406
+.. _`#7394`: https://github.com/apache/cloudstack/pull/7394
+.. _`#7388`: https://github.com/apache/cloudstack/pull/7388
+.. _`#7402`: https://github.com/apache/cloudstack/pull/7402
+.. _`#7359`: https://github.com/apache/cloudstack/pull/7359
+.. _`#7281`: https://github.com/apache/cloudstack/pull/7281
+.. _`#7328`: https://github.com/apache/cloudstack/pull/7328
+.. _`#7395`: https://github.com/apache/cloudstack/pull/7395
+.. _`#7387`: https://github.com/apache/cloudstack/pull/7387
+.. _`#7268`: https://github.com/apache/cloudstack/pull/7268
+.. _`#7332`: https://github.com/apache/cloudstack/pull/7332
+.. _`#7327`: https://github.com/apache/cloudstack/pull/7327
+.. _`#7382`: https://github.com/apache/cloudstack/pull/7382
+.. _`#7200`: https://github.com/apache/cloudstack/pull/7200
+.. _`#7343`: https://github.com/apache/cloudstack/pull/7343
+.. _`#7372`: https://github.com/apache/cloudstack/pull/7372
+.. _`#7374`: https://github.com/apache/cloudstack/pull/7374
+.. _`#7367`: https://github.com/apache/cloudstack/pull/7367
+.. _`#7361`: https://github.com/apache/cloudstack/pull/7361
+.. _`#7140`: https://github.com/apache/cloudstack/pull/7140
diff --git a/source/upgrading/index.rst b/source/upgrading/index.rst
index 8bb26ec..b6b78c0 100644
--- a/source/upgrading/index.rst
+++ b/source/upgrading/index.rst
@@ -44,6 +44,7 @@ Contents:
  
    upgrade/mysql
    upgrade/valid_source
+   upgrade/upgrade-4.18
    upgrade/upgrade-4.17
    upgrade/upgrade-4.16
    upgrade/upgrade-4.15
diff --git a/source/upgrading/upgrade/upgrade-4.18.rst 
b/source/upgrading/upgrade/upgrade-4.18.rst
new file mode 100644
index 0000000..655befe
--- /dev/null
+++ b/source/upgrading/upgrade/upgrade-4.18.rst
@@ -0,0 +1,301 @@
+.. 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.18.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.
+#. 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
+
+.. include:: _sysvm_templates.rst
+
+
+Packages repository
+-------------------
+
+Most users of CloudStack manage the installation and upgrades of
+CloudStack with one of Linux's predominant package systems, RPM or
+APT. This guide assumes you'll be using RPM and Yum (for Red Hat
+Enterprise Linux or CentOS), or APT and Debian packages (for Ubuntu).
+
+Create RPM or Debian packages (as appropriate) and a repository from
+the |release| source, or check the Apache CloudStack downloads page at
+http://cloudstack.apache.org/downloads.html
+for package repositories supplied by community members. You will need
+them for :ref:`ubuntu414` or :ref:`kvm414` hosts upgrade.
+
+Instructions for creating packages from the CloudStack source are in the
+`CloudStack Installation Guide`_.
+
+Database Preparation
+--------------------
+
+Backup current database
+
+#. Stop your management server or servers. Run this on all management
+   server hosts:
+
+   .. parsed-literal::
+
+      $ sudo service cloudstack-management stop
+
+#. If you are running a usage server or usage servers, stop those as well:
+
+   .. parsed-literal::
+
+      $ sudo service cloudstack-usage stop
+
+#. Make a backup of your MySQL database. If you run into any issues or
+   need to roll back the upgrade, this will assist in debugging or
+   restoring your existing environment. You'll be prompted for your
+   password.
+
+   .. parsed-literal::
+
+      $ mysqldump -u root -p -R cloud > cloud-backup_$(date +%Y-%m-%d-%H%M%S)
+      $ mysqldump -u root -p cloud_usage > cloud_usage-backup_$(date 
+%Y-%m-%d-%H%M%S)
+
+
+.. _ubuntu414:
+.. _apt-repo414:
+
+Management Server
+-----------------
+
+Ubuntu
+######
+
+If you are using Ubuntu, follow this procedure to upgrade your packages. If
+not, skip to step :ref:`rhel414`.
+
+.. note::
+   **Community Packages:** This section assumes you're using the community
+   supplied packages for CloudStack. If you've created your own packages and
+   APT repository, substitute your own URL for the ones used in these examples.
+
+The first order of business will be to change the sources list for
+each system with CloudStack packages. This means all management
+servers, and any hosts that have the KVM agent (no changes should
+be necessary for hosts that are running VMware or Xen.)
+
+Edit your ``/etc/apt/sources.list.d/cloudstack.list`` file on
+any systems that have CloudStack packages installed to points to version 
|version|
+
+This file should have one line, which contains:
+
+.. parsed-literal::
+
+   deb http://download.cloudstack.org/ubuntu bionic |version|
+
+Setup the public key for the above repository:
+
+.. parsed-literal::
+
+   wget -qO - http://download.cloudstack.org/release.asc | sudo apt-key add -
+
+#. Now update your apt package list:
+
+   .. parsed-literal::
+
+      $ sudo apt-get update
+
+#. Now that you have the repository configured, it's time to upgrade
+   the ``cloudstack-management`` package.
+
+   .. parsed-literal::
+
+      $ sudo apt-get upgrade cloudstack-management
+
+#. If you use CloudStack usage server
+
+   .. parsed-literal::
+
+      $ sudo apt-get upgrade cloudstack-usage
+
+
+.. _rhel414:
+.. _rpm-repo414:
+
+CentOS/RHEL
+##############
+
+If you are using CentOS or RHEL, follow this procedure to upgrade your
+packages. If not, skip to hypervisors section :ref:`upg_hyp_414`.
+
+.. note::
+   **Community Packages:** This section assumes you're using the community
+   supplied packages for CloudStack. If you've created your own packages and
+   yum repository, substitute your own URL for the ones used in these examples.
+
+The first order of business will be to change the yum repository
+for each system with CloudStack packages. This means all
+management servers, and any hosts that have the KVM agent (no changes
+should be necessary for hosts that are running VMware or Xen.)
+
+Change your ``/etc/yum.repos.d/cloudstack.repo`` file on
+any systems that have CloudStack packages installed to points to version 
|version|.
+
+This file should have content similar to the following:
+
+.. parsed-literal::
+
+   [apache-cloudstack]
+   name=Apache CloudStack
+   baseurl=http://download.cloudstack.org/centos/$releasever/|version|/
+   enabled=1
+   gpgcheck=0
+
+Setup the GPG public key if you wish to enable ``gpgcheck=1``:
+
+.. parsed-literal::
+
+   rpm --import http://download.cloudstack.org/RPM-GPG-KEY
+
+#. Now that you have the repository configured, it's time to upgrade the
+   ``cloudstack-management``.
+
+   .. parsed-literal::
+
+      $ sudo yum upgrade cloudstack-management
+
+#. If you use CloudStack usage server
+
+   .. parsed-literal::
+
+      $ sudo yum upgrade cloudstack-usage
+
+.. _upg_hyp_414:
+
+Upgrade Hypervisors
+-------------------
+
+Hypervisor: XenServer
+#####################
+
+
+No additional steps are required for XenServer Hypervisor for this upgrade.
+
+
+Hypervisor: VMware
+###################
+
+.. warning::
+   For VMware hypervisor, CloudStack management server packages must be
+   built using "noredist". Refer to :ref:`building-noredist`.
+
+
+No additional steps are requried for the VMware Hypervisor for this upgrade.
+
+
+.. _kvm414:
+
+Hypervisor: KVM
+#################
+
+KVM on Ubuntu
+""""""""""""""
+
+(KVM only) Additional steps are required for each KVM host. These
+steps will not affect running guests in the cloud. These steps are
+required only for clouds using KVM as hosts and only on the KVM
+hosts.
+
+#. Configure the :ref:`APT repo <apt-repo414>` as detailed above.
+
+#. Stop the running agent.
+
+   .. parsed-literal::
+
+      $ sudo service cloudstack-agent stop
+
+#. Update the agent software.
+
+   .. parsed-literal::
+
+      $ sudo apt-get upgrade cloudstack-agent
+
+#. Start the agent.
+
+   .. parsed-literal::
+
+      $ sudo service cloudstack-agent start
+
+
+KVM on CentOS/RHEL
+"""""""""""""""""""
+
+For KVM hosts, upgrade the ``cloudstack-agent`` package
+
+#. Configure the :ref:`rpm-repo414` as detailed above.
+
+   .. parsed-literal::
+
+      $ sudo yum install -y epel-release
+      $ sudo yum upgrade cloudstack-agent
+
+#. Restart the agent:
+
+   .. parsed-literal::
+
+      $ sudo service cloudstack-agent stop
+      $ sudo service cloudstack-agent start
+
+
+Restart management services
+---------------------------
+
+#. Now it's time to start the management server
+
+   .. parsed-literal::
+
+      $ sudo service cloudstack-management start
+
+#. If you use it, start the usage server
+
+   .. parsed-literal::
+
+      $ sudo service cloudstack-usage start
+
+
+.. include:: _sysvm_restart.rst

Reply via email to