diff --git a/source/upgrading/upgrade/_sysvm_restart.rst b/source/upgrading/upgrade/_sysvm_restart.rst index d4b267aaae..8f01fb2299 100644 --- a/source/upgrading/upgrade/_sysvm_restart.rst +++ b/source/upgrading/upgrade/_sysvm_restart.rst @@ -16,7 +16,18 @@ .. sub-section included in upgrade notes. Once you've upgraded the packages on your management servers, you'll -need to restart the system VMs. Ensure that the admin port is set to +need to restart the system VMs in order for those VMs to be rebuilt +from the new systemVM template version. + +.. note:: + + Restarting system VMs can be done in different ways. You can use script + "cloudstack-sysvmadm" which is provided with CloudStack, or do a manual restart of system VMs + or do it by using third-party tools such as Ansible. + Below we are giving instructions for using the "cloudstack-sysvmadm" script. + + +Ensure that the admin port is set to 8096 by using the "integration.api.port" global parameter. This port is used by the cloudstack-sysvmadm script at the end of the upgrade procedure. For information about how to set this parameter, see :ref:`configuration parameters ` diff --git a/source/upgrading/upgrade/upgrade-4.10.rst b/source/upgrading/upgrade/upgrade-4.10.rst index 87b07605bd..04906d3b6f 100644 --- a/source/upgrading/upgrade/upgrade-4.10.rst +++ b/source/upgrading/upgrade/upgrade-4.10.rst @@ -432,3 +432,8 @@ Restart management services .. parsed-literal:: $ sudo service cloudstack-usage start + +System-VMs and Virtual-Routers +------------------------------ + +.. include:: _sysvm_restart.rst diff --git a/source/upgrading/upgrade/upgrade-4.11.rst b/source/upgrading/upgrade/upgrade-4.11.rst index eaa3819a51..a9485d7f09 100644 --- a/source/upgrading/upgrade/upgrade-4.11.rst +++ b/source/upgrading/upgrade/upgrade-4.11.rst @@ -362,3 +362,8 @@ Restart management services .. parsed-literal:: $ sudo service cloudstack-usage start + +System-VMs and Virtual-Routers +------------------------------ + +.. include:: _sysvm_restart.rst diff --git a/source/upgrading/upgrade/upgrade-4.12.rst b/source/upgrading/upgrade/upgrade-4.12.rst index 70db11a991..376dc7a56e 100644 --- a/source/upgrading/upgrade/upgrade-4.12.rst +++ b/source/upgrading/upgrade/upgrade-4.12.rst @@ -358,3 +358,8 @@ Restart management services .. parsed-literal:: $ sudo service cloudstack-usage start + +System-VMs and Virtual-Routers +------------------------------ + +.. include:: _sysvm_restart.rst diff --git a/source/upgrading/upgrade/upgrade-4.9.rst b/source/upgrading/upgrade/upgrade-4.9.rst index d19e22dea1..ee217869f3 100644 --- a/source/upgrading/upgrade/upgrade-4.9.rst +++ b/source/upgrading/upgrade/upgrade-4.9.rst @@ -432,4 +432,7 @@ Restart management services $ sudo service cloudstack-usage start +System-VMs and Virtual-Routers +------------------------------ +.. include:: _sysvm_restart.rst