From d8a019d84ac138f34c949a817c2901f75d1ce32c Mon Sep 17 00:00:00 2001 From: Al Bowles Date: Wed, 28 Jun 2023 14:55:11 -0500 Subject: [PATCH 1/4] Add SOP for openQA system upgrades --- docs/sop/openqa_sop_system_upgrades.md | 59 ++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 docs/sop/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..006c458 --- /dev/null +++ b/docs/sop/openqa_sop_system_upgrades.md @@ -0,0 +1,59 @@ +--- +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 + +1. Install system upgrade plugin + + dnf install dnf-plugin-system-upgrade + +1. Download the upgrade packages for next version + + dnf system-upgrade download --releasever=[newversion] + +1. Reboot into offline upgrade mode + + dnf system-upgrade reboot + +1. 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 + +1. Upgrade your postgres database + + 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) + +1. Run the branding related tasks + + ansible-playbook init-openqa-rocky-developer-host.yml -t branding + +## References +https://docs.fedoraproject.org/en-US/quick-docs/dnf-system-upgrade/ +https://www.makeuseof.com/how-to-upgrade-to-fedora-workstation-36/ + +{% include "content_bottom.md" %} From 95cc56019ee3e3ef6f873d48cba249bd84e9d651 Mon Sep 17 00:00:00 2001 From: Al Bowles Date: Wed, 28 Jun 2023 14:58:35 -0500 Subject: [PATCH 2/4] Update pages --- docs/sop/.pages | 1 + 1 file changed, 1 insertion(+) 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' ... From 735dc00201adb6495e71af72d407a2caedcb7033 Mon Sep 17 00:00:00 2001 From: Trevor Cooper Date: Thu, 29 Jun 2023 09:19:45 -0700 Subject: [PATCH 3/4] codeblocks and link attributes --- docs/sop/openqa_sop_system_upgrades.md | 22 +++++++++++++++++++--- 1 file changed, 19 insertions(+), 3 deletions(-) diff --git a/docs/sop/openqa_sop_system_upgrades.md b/docs/sop/openqa_sop_system_upgrades.md index 006c458..8b2a1f5 100644 --- a/docs/sop/openqa_sop_system_upgrades.md +++ b/docs/sop/openqa_sop_system_upgrades.md @@ -10,24 +10,34 @@ This SOP details the necessary steps for performing a system upgrade on an openQ 1. Verify current installation is fully upgraded + ``` shell 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 @@ -37,23 +47,29 @@ These steps may also be necessary in some (but not all) cases. 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) +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 -https://docs.fedoraproject.org/en-US/quick-docs/dnf-system-upgrade/ -https://www.makeuseof.com/how-to-upgrade-to-fedora-workstation-36/ +- [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" %} From 89c5def5d704031b9bee9b9b8da98c7f3d21b816 Mon Sep 17 00:00:00 2001 From: Trevor Cooper Date: Thu, 29 Jun 2023 14:53:21 -0700 Subject: [PATCH 4/4] canonicalize codeblock language --- docs/sop/openqa_sop_system_upgrades.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sop/openqa_sop_system_upgrades.md b/docs/sop/openqa_sop_system_upgrades.md index 8b2a1f5..b7f81fb 100644 --- a/docs/sop/openqa_sop_system_upgrades.md +++ b/docs/sop/openqa_sop_system_upgrades.md @@ -10,7 +10,7 @@ This SOP details the necessary steps for performing a system upgrade on an openQ 1. Verify current installation is fully upgraded - ``` shell linenums="1" + ``` bash linenums="1" dnf upgrade --refresh ```