Introduction
Enterprise Linux operating systems require periodic upgrades to maintain security, supportability, compliance, and operational stability.
As organizations modernize infrastructure platforms, migrating from Oracle Linux 7 to Oracle Linux 8 becomes important because Oracle Linux 8 introduces:
✔ Modern package management
✔ Improved security
✔ Better kernel support
✔ Enhanced automation compatibility
✔ AppStream modular repositories
✔ Long-term enterprise support
However, major Linux upgrades are not simple package updates.
They involve:
✔ Repository transitions
✔ Package dependency changes
✔ Kernel migration
✔ Bootloader modifications
✔ Service compatibility validation
✔ Third-party package handling
Oracle Linux provides the Leapp upgrade utility to automate and orchestrate Oracle Linux 7 to Oracle Linux 8 migrations safely.
In this blog, we will perform a complete deep dive into:
✔ Configuring Leapp repositories
✔ Installing Leapp utility
✔ Preupgrade analysis
✔ Understanding inhibitors
✔ Answer file handling
✔ Repository migration
✔ Upgrade execution
✔ Upgrade boot workflow
✔ Enterprise troubleshooting
✔ Real-world operational challenges
Understanding Leapp
Leapp is an in-place upgrade utility used to migrate Oracle Linux 7 systems to Oracle Linux 8.
Why Major OS Upgrades Are Complex
Upgrading from Oracle Linux 7 to Oracle Linux 8 involves platform-level architectural changes.
These include:
✔ Kernel transitions
✔ Package replacement
✔ Repository mapping
✔ Driver compatibility
✔ Service migration
✔ Security policy updates
✔ Boot environment changes
Note : Operating system upgrades are not only package upgrades — they are full platform transitions.
Oracle Linux Upgrade Architecture
The Leapp upgrade process follows multiple operational stages.
Upgrade Workflow
Oracle Linux 7
│
▼
Repository Validation
│
▼
Leapp Installation
│
▼
Preupgrade Analysis
│
▼
Inhibitor Detection
│
▼
Answer File Validation
│
▼
Upgrade Initramfs Creation
│
▼
System Reboot
│
▼
Upgrade Environment Boot
│
▼
Package Migration
│
▼
Oracle Linux 8
Step 1: Verify Current Oracle Linux Version
Before starting the migration, validate the current OS version.
Command:
cat /etc/os-release
Example output:
NAME="Oracle Linux Server"
VERSION="7.x"
Step 2: Verify Current Repositories
Repository consistency is critical before performing upgrades.
Check repositories:
yum repolist
Why Repository Validation Matters
Broken or duplicate repositories may cause:
✔ Dependency failures
✔ Package mapping errors
✔ Upgrade inhibitors
✔ Incomplete migrations
✔ Boot failures
Add Leapp Repository Configuration
Navigate to repository directory:
cd /etc/yum.repos.d/
Create or validate Oracle Linux repositories.
Example:
[ol7_leapp]
name=Oracle Linux 7 Leapp Repository
baseurl=https://yum.oracle.com/repo/OracleLinux/OL7/leapp/x86_64/
enabled=1
gpgcheck=1
Refresh Repository Metadata
yum clean all
yum makecache
Step 4: Install Leapp Utility
Install required Leapp packages.
Command:
yum install -y leapp-upgrade leapp-data-oraclelinux
What Gets Installed?
Leapp installs:
✔ Upgrade actors
✔ Dependency analysis modules
✔ Migration logic
✔ Repository mapping data
✔ Upgrade workflows
Verify Leapp Installation
rpm -qa | grep leapp
Step 5: Understanding Leapp Preupgrade
Before performing the actual upgrade, Leapp performs extensive system analysis.
Command:
leapp preupgrade
What Happens During Preupgrade?
Leapp analyzes:
✔ Installed packages
✔ Drivers
✔ Repository configuration
✔ Bootloader state
✔ Kernel compatibility
✔ Unsupported packages
✔ Dependency conflicts
✔ Security policies
Operational Insight
The preupgrade phase prevents unsafe migrations before system modification begins.
Understanding Inhibitors
One of the most important Leapp concepts is inhibitors.
What Are Inhibitors?
Inhibitors are conditions that stop the upgrade from continuing safely.
If inhibitors exist, Leapp blocks the upgrade process.
Why Inhibitors Exist
Inhibitors protect systems from unsafe migration scenarios.
Examples:
✔ Unsupported repositories
✔ Duplicate repository entries
✔ Deprecated packages
✔ Missing answer files
✔ Third-party RPM conflicts
✔ Unsupported drivers
✔ Incorrect boot configuration
Real Repository Inhibitor Example
Example error:
Repository ol8_baseos_latest is listed more than once in the configuration.
Why This Happens
Possible causes:
✔ Duplicate .repo files
✔ Custom repositories
✔ Third-party repositories
✔ Incorrect migration preparation
Fixing Duplicate Repositories
Check repository directory:
ls -l /etc/yum.repos.d/
Review duplicate repository definitions:
grep -r "ol8_baseos_latest" /etc/yum.repos.d/
Remove duplicate entries carefully.
Understanding Leapp Answer Files
This is one of the most important upgrade concepts.
What Are Answer Files?
During upgrades, Leapp may require administrator confirmation for specific migration decisions.
Leapp stores these prompts inside answer files.
Location:
/var/log/leapp/answerfile
Why Answer Files Matter
Leapp blocks upgrades until required questions are answered.
Example:
Missing required answers in the answer file.
View Required Answers
Command:
leapp answer --section remove_pam_pkcs11_module_check.confirm=True
What Does This Do?
This command confirms specific upgrade actions required by Leapp.
Operational Insight
Answer files help administrators explicitly approve risky or environment-specific migration decisions.
Understanding Repository Migration
Oracle Linux 7 and Oracle Linux 8 use different repository structures.
Oracle Linux 7 Repositories
✔ ol7_latest
✔ ol7_UEKR6
✔ Optional repositories
Oracle Linux 8 Repositories
✔ BaseOS
✔ AppStream
✔ UEK repositories
Repository Mapping Workflow
OL7 Repositories
│
Repository Mapping
│
▼
OL8 BaseOS + AppStream
Understanding AppStream Repositories
Oracle Linux 8 introduces AppStream modular repositories.
Unlike Oracle Linux 7:
Packages are grouped into modules and streams.
Examples:
✔ Python streams
✔ NodeJS streams
✔ Database modules
This increases flexibility but also migration complexity.
Third-Party Repository Challenges
Enterprise systems commonly use third-party repositories.
Examples:
✔ EPEL
✔ Monitoring agents
✔ Security tools
✔ Vendor repositories
✔ Backup software
Example EPEL Problem
Example error:
No package epel-release available
Why This Happens
Possible causes:
✔ Repository incompatibility
✔ Incorrect release version
✔ Unsupported packages
✔ Missing metadata
Step 6: Execute Upgrade
Once inhibitors are resolved, begin the upgrade.
Command: leapp upgrade
What Happens Internally?
Leapp performs:
✔ Upgrade initramfs creation
✔ Bootloader modification
✔ Package migration
✔ Repository transition
✔ Kernel migration
✔ Service migration
Understanding Upgrade Initramfs
This is one of the most advanced upgrade concepts.
What is Upgrade Initramfs?
Leapp temporarily boots into a dedicated upgrade initramfs environment outside the running Oracle Linux 7 userspace.
This isolated environment safely performs package replacement operations.
Upgrade Boot Workflow
Normal OL7 Boot
│
▼
Upgrade Initramfs
│
▼
Package Migration
│
▼
OL8 Boot
Why Upgrade Initramfs Is Required
Leapp performs the upgrade outside the running Oracle Linux 7 userspace to avoid active package conflicts and dependency corruption during migration.
The temporary upgrade initramfs environment provides an isolated userspace where package replacement, repository switching, kernel migration, and dependency updates can occur safely without interfering with the currently running operating system.
This isolation significantly reduces the risk of package inconsistency and upgrade instability during major platform transitions.
Step 7: Reboot the System
After upgrade preparation:
reboot
The system boots into the temporary upgrade environment.
Migration occurs automatically.
Step 8: Verify Oracle Linux 8 Upgrade
After reboot completes:
Verify OS Version
cat /etc/os-release
Common Real-World Upgrade Problems
Many upgrade failures occur because of environment inconsistencies rather than Leapp itself.
Common Operational Problems
✔ Repository duplication
✔ Dependency conflicts
✔ Unsupported packages
✔ Missing drivers
✔ Bootloader issues
✔ EPEL incompatibility
✔ Service startup failures
✔ Network configuration mismatches
✔ SELinux conflicts
Upgrade Failure Recovery
If the upgrade process fails during migration, administrators should analyze Leapp reports, validate repositories, review inhibitors, and restore systems using backups or boot volume snapshots when necessary.
/var/log/leapp/leapp-report.txt
/var/log/leapp/leapp-upgrade.log
/var/log/leapp/leapp-preupgrade.log
Leapp logs provide detailed visibility into dependency analysis, migration stages, repository transitions, and package failures.
Rollback and Recovery Planning
Enterprise upgrades should always include rollback preparation.
Before upgrades:
✔ Create backups
✔ Snapshot boot volumes
✔ Validate rollback workflows
✔ Test upgrades in staging
✔ Document recovery procedures
Why Rollback Planning Matters
If upgrades fail unexpectedly:
Rollback capability reduces downtime and operational risk.
Enterprise Upgrade Best Practices
✔ Validate backups before upgrade
✔ Remove unsupported repositories
✔ Review Leapp reports carefully
✔ Resolve inhibitors completely
✔ Test upgrades in staging first
✔ Validate applications after migration
✔ Monitor services post-upgrade
✔ Maintain rollback procedures
Conclusion
Leapp provides a powerful and automated framework for migrating Oracle Linux 7 systems to Oracle Linux 8 through dependency analysis, repository validation, package migration, and upgrade orchestration.
Although the migration process is heavily automated, successful enterprise upgrades still require careful planning, repository consistency, inhibitor analysis, answer file validation, operational testing, and rollback preparation to ensure production stability.
Modern Linux upgrades are no longer simple package updates — they are enterprise platform modernization workflows requiring operational engineering discipline.
Top comments (0)