MOP For the Community: Ubuntu Upgrade Steps from 4.20.0 to 4.20.1

[tatay188]

Giving Back to the community.

We create a MOP - Method of Procedure - for the Upgrade from 4.20.0 to 4.20.1 using Ubuntu.
Use the MOP at your own risk - We are sharing to give something back to the community.

We Did not shutdown the MYSQL.
Take some time to come backup. We have had VMs running.

Simplified and It is based on the Official Documentation on : https://docs.cloudstack.apache.org/en/latest/upgrading/upgrade/upgrade-4.20.html

STEP 1)
Go to the UI:
Go to IMAGES-- > TEMPLATES and click Register Template from URL
URL: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.1-x86_64-kvm.qcow2.bz2
Name: systemvm-kvm-4.20.1-x86_64
Description: systemvm-kvm-4.20.1-x86_64
Zone: Choose the zone where this hypervisor is used
Hypervisor: KVM
Format: QCOW2
Direct download: No/False (grayed button)
OS Type: Debian GNU/Linux 12 (64-bit) (or the highest Debian release number available in the dropdown)
Template Type: SYSTEM
Arch: X86_64
Extractable: no (grayed button)
Password Enabled: no (grayed button)
Public: no (grayed button)
Featured: no (grayed button)
Routing: no (grayed button)
HVM: yes/true (Button on Green)

Wait UNTIL THE Template Shows "Ready" - Click refresh from time to time.

ONCE THE SYSTEM TEMPLATE IS READY

STEP 2)
Go back to the Management server
On each management server proceed:

service cloudstack-management stop

service cloudstack-usage stop
cd /etc/openstack/management

cp config.json config.json.$(date +%Y-%m-%d-%H%M%S)
cp db.properties db.properties.$(date +%Y-%m-%d-%H%M%S)

SKIP THIS STEP: USE Only if STEP 1) fails or gives a problem use the following:

/usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary1 -u http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.1-x86_64-kvm.qcow2.bz2 -h kvm -s -F

STEP 3)

Login to one of the MYSQL SERVERs and BACKUP:

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)

STEP 4)
Go back to the Management server
On each management server proceed:

Replace Jammy with the Version of Ubuntu

cat >//etc/apt/sources.list.d/cloudstack.list<<EOF
deb http://download.cloudstack.org/ubuntu jammy 4.20
EOF

wget -4 -qO - http://download.cloudstack.org/release.asc | sudo apt-key add -

apt-get update
apt-get upgrade cloudstack-management
Configuration file '/etc/cloudstack/management/config.json'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ? Your options are:
Y or I : install the package maintainer's version
N or O : keep your currently-installed version
D : show the differences between the versions
Z : start a shell to examine the situation
The default action is to keep your current version.
*** config.json (Y/I/N/O/D/Z) [default=N] ? N

For us the only difference is an additional Line, after "LoginFooter" "resetPasswordFooter": "",
When to choose N : We are not using the document links. If you don't need the document Links have customized links
When to choose Y : If you need the Document Links press Y, and copy your customizations for the logos and colors.

Configuration file '/etc/cloudstack/management/server.properties'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ? Your options are:
Y or I : install the package maintainer's version
N or O : keep your currently-installed version
D : show the differences between the versions
Z : start a shell to examine the situation
The default action is to keep your current version.
*** server.properties (Y/I/N/O/D/Z) [default=N] ? N

apt-get upgrade cloudstack-usage

Login to the KVM HYPERVISORS
IN EACH Hypervisor do as follows:

cat >//etc/apt/sources.list.d/cloudstack.list<<EOF
deb http://download.cloudstack.org/ubuntu jammy 4.20
EOF

wget -4 -qO - http://download.cloudstack.org/release.asc | sudo apt-key add -

apt-get update

cd /etc/cloudstack/agent/
cp agent.properties agent.properties.$(date +%Y-%m-%d-%H%M%S)

service cloudstack-agent stop

apt-get upgrade cloudstack-agent

systemctl start cloudstack-agent

Omar F. Mendoza
Tata Y.
Sonic Cloud 11