wiki/docs/sop/openqa_sop_system_upgrades.md

title
SOP: openQA - System Upgrades

This SOP details the necessary steps for performing a system upgrade on an openQA host.

{% include "contacts_top.md" %}

Fedora

1. Verify current installation is fully upgraded

   dnf upgrade --refresh
   

2. Install system upgrade plugin

   dnf install dnf-plugin-system-upgrade
   

3. Download the upgrade packages for next version

   dnf system-upgrade download --releasever=[newversion]
   

4. Reboot into offline upgrade mode

   dnf system-upgrade reboot
   

5. Post-reboot cleanup

   dnf system-upgrade clean
   dnf clean packages
   

Post-Upgrade Tasks

These steps may also be necessary in some (but not all) cases.

Upgrade the PostgreSQL database

1. Install postgresql-upgrade package

   dnf install postgresql-upgrade
   

2. Upgrade your postgres database

   sudo -iu postgres
   postgresql-setup --upgrade
   

Re-apply Rocky branding

1. Obtain the Ansible openQA deployment repository{target=_blank}

2. Run the branding related tasks

   ansible-playbook init-openqa-rocky-developer-host.yml -t branding
   

References

• Upgrading Fedora using the DNF system upgrade{target=_blank}
• How to Easily Upgrade to Fedora Workstation 36{target=_blank}

{% include "content_bottom.md" %}