From d8a019d84ac138f34c949a817c2901f75d1ce32c Mon Sep 17 00:00:00 2001
From: Al Bowles <bowlesalx@gmail.com>
Date: Wed, 28 Jun 2023 14:55:11 -0500
Subject: [PATCH] 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" %}