A comprehensive collection of scripts to automate and guide the upgrade process between RHEL versions. These scripts help system administrators perform safe and reliable upgrades while following Red Hat's recommended practices.
These upgrade scripts are designed for:
- 64-bit Intel and AMD (x86_64)
- 64-bit ARM (aarch64)
If you're running RHEL on one of these architectures, these scripts are compatible with your system.
Each upgrade path follows a consistent 3-phase process:
- System requirements verification
- Subscription validation
- Repository configuration
- Critical configuration backup
- Installation of upgrade tools
- Pre-upgrade analysis
- Issue resolution
- System upgrade
- Automatic reboot
- Upgrade verification
- System cleanup
- Service validation
- Configuration updates
Before starting any upgrade:
-
System Requirements
- Active RHEL subscription
- Minimum 5GB free space in /var
- Complete system backup or VM snapshot
- Working internet connection
-
Documentation
- Review the specific upgrade path documentation
- Check documentation
- Understand the upgrade process and potential risks
-
Testing
- Test the upgrade process in a non-production environment
- Verify application compatibility
- Plan for downtime during the upgrade
-
Choose your upgrade path directory:
cd scripts/using-cdn/rhel7-to-8/ # For RHEL 7 to 8 cd scripts/using-cdn/rhel8-to-9/ # For RHEL 8 to 9 cd scripts/using-cdn/rhel9-to-10/ # For RHEL 9 to 10
-
Run the pre-upgrade script:
sudo ./pre-upgrade.sh
-
Follow the Leapp upgrade process:
leapp preupgrade # Review the pre-upgrade report leapp upgrade -
After reboot, run the post-upgrade script:
sudo ./post-upgrade.sh
- Comprehensive system checks
- Detailed logging
- Error handling and validation
- Automated repository management
- Configuration backups
- Service verification
- Progress reporting
- Backup: Always create a full system backup before upgrading
- Testing: Test in a non-production environment first
- Review: Read all documentation before proceeding
- Support: Have Red Hat support information ready
- Downtime: Plan for system downtime during upgrade
- Verification: Test system functionality after upgrade
- Check logs in
/var/log/pre-upgrade/and/var/log/post-upgrade/ - Review Leapp logs in
/var/log/leapp/ - Consult the upgrade report generated after completion
- Contact Red Hat support if needed
Contributions are welcome! Please feel free to submit pull requests or create issues for improvements.
This project is licensed under the MIT License - see the LICENSE file for details.
These scripts are provided as-is, without warranty. Always test thoroughly and maintain backups before performing system upgrades.