Additional troubleshooting steps

During the upgrade from RHEL 7.9 to RHEL 8.x, you may encounter various environment-specific issues. The table below outlines common issues along with their corresponding workarounds.

Table 1.
Issue Workaround
Unable to download EPEL packages on RHEL 7.9. Enable required RHEL 7 repositories and install the archived EPEL release manually. Then enable the EPEL repository.
perl-Switch not available on RHEL 7.9. Enable the rhel-7-server-optional-rpms repository and install perl-Switch.
Upgrade from RHEL 7.9 to 8.8 fails due to Python error: unable to open database file. Increase the system's open file descriptor limit using the command ulimit -n 16384.
Upgrade from RHEL 8.8 to 8.10 fails due to Python package conflicts.
  1. Open the DNF configuration file /etc/dnf/dnf.conf and comment out the line starting with exclude= if it lists Python-related packages.
    Example:   
    # exclude=python2-leapp,snactor,leapp-upgrade-el7toel8
  2. Remove conflicting Leapp and Python packages.
  3. Clean DNF cache.
  4. Remove DNF Python36 using the command sudo dnf remove python36.