1
0
forked from testing/wiki
wiki/docs/sop/openqa_sop_system_upgrades.md

76 lines
1.7 KiB
Markdown
Raw Normal View History

2023-06-28 19:55:11 +00:00
---
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
2023-06-29 21:53:21 +00:00
``` bash linenums="1"
2023-06-28 19:55:11 +00:00
dnf upgrade --refresh
2023-06-29 16:19:45 +00:00
```
2023-06-28 19:55:11 +00:00
1. Install system upgrade plugin
2023-06-29 16:19:45 +00:00
``` bash linenums="1"
2023-06-28 19:55:11 +00:00
dnf install dnf-plugin-system-upgrade
2023-06-29 16:19:45 +00:00
```
2023-06-28 19:55:11 +00:00
1. Download the upgrade packages for next version
2023-06-29 16:19:45 +00:00
``` bash linenums="1"
2023-06-28 19:55:11 +00:00
dnf system-upgrade download --releasever=[newversion]
2023-06-29 16:19:45 +00:00
```
2023-06-28 19:55:11 +00:00
1. Reboot into offline upgrade mode
2023-06-29 16:19:45 +00:00
``` bash linenums="1"
2023-06-28 19:55:11 +00:00
dnf system-upgrade reboot
2023-06-29 16:19:45 +00:00
```
2023-06-28 19:55:11 +00:00
1. Post-reboot cleanup
2023-06-29 16:19:45 +00:00
``` bash linenums="1"
2023-06-28 19:55:11 +00:00
dnf system-upgrade clean
dnf clean packages
2023-06-29 16:19:45 +00:00
```
2023-06-28 19:55:11 +00:00
## Post-Upgrade Tasks
These steps may also be necessary in some (but not all) cases.
### Upgrade the PostgreSQL database
1. Install postgresql-upgrade package
2023-06-29 16:19:45 +00:00
``` bash linenums="1"
2023-06-28 19:55:11 +00:00
dnf install postgresql-upgrade
2023-06-29 16:19:45 +00:00
```
2023-06-28 19:55:11 +00:00
1. Upgrade your postgres database
2023-06-29 16:19:45 +00:00
``` bash linenums="1"
2023-06-28 19:55:11 +00:00
sudo -iu postgres
postgresql-setup --upgrade
2023-06-29 16:19:45 +00:00
```
2023-06-28 19:55:11 +00:00
### Re-apply Rocky branding
2023-06-29 16:19:45 +00:00
1. Obtain the [Ansible openQA deployment repository](https://git.resf.org/infrastructure/ansible-openqa-management){target=_blank}
2023-06-28 19:55:11 +00:00
1. Run the branding related tasks
2023-06-29 16:19:45 +00:00
``` bash linenums="1"
2023-06-28 19:55:11 +00:00
ansible-playbook init-openqa-rocky-developer-host.yml -t branding
2023-06-29 16:19:45 +00:00
```
2023-06-28 19:55:11 +00:00
## References
2023-06-29 16:19:45 +00:00
- [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}
2023-06-28 19:55:11 +00:00
{% include "content_bottom.md" %}