diff --git a/docs/sop/.pages b/docs/sop/.pages index a545ed5..3d19078 100644 --- a/docs/sop/.pages +++ b/docs/sop/.pages @@ -3,4 +3,5 @@ nav: - ... | index.md - 'SOP: openQA Operator Access Request': 'openqa_sop_operator_access.md' - 'SOP: openQA Operator Access Removal': 'openqa_sop_operator_removal.md' + - 'SOP: openQA System Upgrades': 'openqa_sop_system_upgrades.md' ... diff --git a/docs/sop/openqa_sop_system_upgrades.md b/docs/sop/openqa_sop_system_upgrades.md new file mode 100644 index 0000000..b7f81fb --- /dev/null +++ b/docs/sop/openqa_sop_system_upgrades.md @@ -0,0 +1,75 @@ +--- +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 + + ``` bash linenums="1" + dnf upgrade --refresh + ``` + +1. Install system upgrade plugin + + ``` bash linenums="1" + dnf install dnf-plugin-system-upgrade + ``` + +1. Download the upgrade packages for next version + + ``` bash linenums="1" + dnf system-upgrade download --releasever=[newversion] + ``` + +1. Reboot into offline upgrade mode + + ``` bash linenums="1" + dnf system-upgrade reboot + ``` + +1. Post-reboot cleanup + + ``` bash linenums="1" + 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 + + ``` bash linenums="1" + dnf install postgresql-upgrade + ``` + +1. Upgrade your postgres database + + ``` bash linenums="1" + sudo -iu postgres + postgresql-setup --upgrade + ``` + +### Re-apply Rocky branding + +1. Obtain the [Ansible openQA deployment repository](https://git.resf.org/infrastructure/ansible-openqa-management){target=_blank} + +1. Run the branding related tasks + + ``` bash linenums="1" + ansible-playbook init-openqa-rocky-developer-host.yml -t branding + ``` + +## References +- [Upgrading Fedora using the DNF system upgrade](https://docs.fedoraproject.org/en-US/quick-docs/dnf-system-upgrade/){target=_blank} +- [How to Easily Upgrade to Fedora Workstation 36](https://www.makeuseof.com/how-to-upgrade-to-fedora-workstation-36/){target=_blank} + +{% include "content_bottom.md" %}