https://github.com/ngrogg/leapp-elevate-rocky8-helper
Boilerplate BASH wrapper script for upgrading Rocky Linux 8 to Rocky Linux 9 via Leapp ELevate
https://github.com/ngrogg/leapp-elevate-rocky8-helper
bash bash-script elevate leapp linux rockylinux rockylinux8 rockylinux9
Last synced: 16 days ago
JSON representation
Boilerplate BASH wrapper script for upgrading Rocky Linux 8 to Rocky Linux 9 via Leapp ELevate
- Host: GitHub
- URL: https://github.com/ngrogg/leapp-elevate-rocky8-helper
- Owner: ngrogg
- Created: 2025-07-21T10:26:35.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-11-13T10:38:29.000Z (7 months ago)
- Last Synced: 2025-11-13T12:20:07.546Z (7 months ago)
- Topics: bash, bash-script, elevate, leapp, linux, rockylinux, rockylinux8, rockylinux9
- Language: Shell
- Homepage:
- Size: 46.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Leapp Elevate Rocky 8 Helper - Version r82r9
## Overview
Boilerplate BASH wrapper script for upgrading Rocky Linux 8 to Rocky Linux 9 via Leapp ELevate.
For the CentOS 7 to Rocky 8 version of the script (Version c72r8), see [here](https://github.com/ngrogg/leapp-elevate-centos7-helper)
Alma Linux ELevate documentation can be found [here](https://almalinux.org/elevate/)
**IMPORTANT**
This script should be considered the _basis_ for it's own work effort and not a complete script in and of itself.
It may be possible to run the script as is and successfully upgrade a server to Rocky 9, but there will likely need to be additional adjustments.
Take a snapshot before using! No warranties, ymmv.
## Usage
* **elevateHelper.sh**, a BASH script for upgrading Rocky Linux 8 servers to Rocky Linux 9.
Runs in three parts, a prep stage, an upgrade stage and a post-upgrade stage. Stages are elaborated on further below.
Script will prompt user to check output from script at several points and is _not_ a "fire and forget" script.
These points requiring input will always be color coded in yellow preceeded by **IMPORTANT:** to help output stand out.
Usage, `./elevateHelper.sh STAGE`
Ex. `./elevateHelper.sh prep`
Ex. `./elevateHelper.sh upgrade`
Ex. `./elevateHelper.sh post`
Script also has a help function:
Help, `./elevateHelper.sh help`
See **Upgrade Stages** section below for breakdown on stages.
## Upgrade Stages
Script upgrades server in three stages, below is a breakdown of what's approximately done in each stage.
* **Prep**, Prepare the server for upgrading. This is the most involved of the three stages and the most likely place issues will arise.
Server is updated, ELevate packages are installed, repos are adjusted, and server is checked for errors that will prevent upgrades from completing.
While encountered errors from testing will be resolved there will likely be additional adjustments required depending on server configurations.
Below are some of the common fail points from testing:
- Duplicate packages
- Development versions of kernels installed
- Kernel mismatches between newest installed kernel and running kernel
- Not enough disk space being available
- Incompatible software like NFS or Samba
* **Upgrade**, Upgrade server with leapp upgrade tool. Fairly straightforward, main requirement is at least 10 GB of disk space be available.
If there isn't enough disk space the upgrade will fail. Script has some error checking for this.
* **Post**, Once server is upgraded removed packages are re-installed, repos are re-enabled, server is updated, failed services are checked
and any packages not upgraded by the upgrade process are listed. Grub menu is also regenerated.
## Script
To copy just the script onto a server:
Production version:
`wget https://raw.githubusercontent.com/ngrogg/leapp-elevate-rocky8-helper/refs/heads/main/elevateHelper.sh`
Testing version (not recommended):
`wget https://raw.githubusercontent.com/ngrogg/leapp-elevate-rocky8-helper/refs/heads/testing/elevateHelper.sh`