Skip to content

SOP: openQA System Upgrades

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

Contact Information

Owner Testing Team
Email Contact
Mattermost Contacts @stack, @tcooper
Mattermost Channels ~Testing


  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

  2. Run the branding related tasks

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


Additional Information

If you have questions with respect to this content or to report concerns regarding the use or misuse content please do not hesitate to contact us at

Rocky Linux and the Rocky Enterprise Software Foundation (RESF) does not make any express or implied warranties, including but not limited to the warranties of non-infringement of any third party intellectual property rights. RESF does not warrant that any pending trademark applications for trademarks of RESF will result in any granted trademark protection. RESF shall not be liable for any claims relating to user's activities falling within the scope of the permission and user hereby agrees to indemnify, defend and hold RESF and its contributors harmless against any such claim.

This content is licensed under under Attribution-Share Alike 4.0 International license unless otherwise noted.