Chapter 7. Performing post-upgrade tasks on the RHEL 9 system

1. Remove any remaining Leapp packages from the exclude list in the /etc/dnf/dnf.conf configuration file, including the snactor package, which is a tool for upgrade extension development. During the in-place upgrade, Leapp packages that were installed with the Leapp utility are automatically added to the exclude list to prevent critical files from being removed or updated. After the in-place upgrade, these Leapp packages must be removed from the exclude list before they can be removed from the system.

   • To manually remove packages from the exclude list, edit the /etc/dnf/dnf.conf configuration file and remove the desired Leapp packages from the exclude list.

   • To remove all packages from the exclude list:

     # dnf config-manager --save --setopt exclude=''

     Copy to Clipboard Toggle word wrap

2. Remove remaining RHEL 8 packages, including remaining Leapp packages.

   1. Remove the old kernel packages from the RHEL 9 system. For more information on removing kernel packages, see the Red Hat Knowledgebase solution What is the proper method to remove old kernels from a Red Hat Enterprise Linux system?

   2. Locate remaining RHEL 8 packages:

      # rpm -qa | grep -e '\.el[78]' | grep -vE '^(gpg-pubkey|libmodulemd|katello-ca-consumer)' | sort

      Copy to Clipboard Toggle word wrap

   3. Remove remaining RHEL 8 packages from your RHEL 9 system. To ensure that RPM dependencies are maintained, use the dnf remove command.

      For example:

      # dnf remove $(rpm -qa | grep \.el[78] | grep -vE 'gpg-pubkey|libmodulemd|katello-ca-consumer')

      Copy to Clipboard Toggle word wrap
      Important

      This step might also remove third-party packages. Review the transaction before accepting to ensure no packages are unintentionally removed.

   4. Remove remaining Leapp dependency packages:

      # dnf remove leapp-deps-el9 leapp-repository-deps-el9

      Copy to Clipboard Toggle word wrap

3. Optional: Remove all remaining upgrade-related data from the system:

   # rm -rf /var/log/leapp /root/tmp_leapp_py3 /var/lib/leapp

   Copy to Clipboard Toggle word wrap
   Important

   Removing this data might limit Red Hat Support’s ability to investigate and troubleshoot post-upgrade problems.

4. Disable DNF repositories whose packages are not RHEL 9-compatible. Repositories managed by RHSM are handled automatically. To disable these repositories:

   # dnf config-manager --set-disabled <repository_id>

   Copy to Clipboard Toggle word wrap

   Replace repository_id with the repository ID.

5. Replace the old rescue kernel and initial RAM disk with the current kernel and disk:

   1. Remove the existing rescue kernel and initial RAM disk:

      # rm /boot/vmlinuz-*rescue* /boot/initramfs-*rescue* 

      Copy to Clipboard Toggle word wrap

   2. Reinstall the rescue kernel and related initial RAM disk:

      # /usr/lib/kernel/install.d/51-dracut-rescue.install add "$(uname -r)" /boot "/boot/vmlinuz-$(uname -r)"

      Copy to Clipboard Toggle word wrap

   3. If your system is on the IBM Z architecture, update the zipl boot loader:

      # zipl

      Copy to Clipboard Toggle word wrap

6. Check existing configuration files:

   • Review, remediate, and then remove the rpmnew, rpmsave, and leappsave files. Note that rpmsave and leappsave are equivalent and can be handled similarly. For more information, see What are rpmnew & rpmsave files?
   • Remove configuration files for RHEL 8 DNF modules from the /etc/dnf/modules.d/ directory that are no longer valid. Note that these files have no effect on the system when related DNF modules do not exist.
7. Re-evaluate and re-apply your security policies. Especially, change the SELinux mode to enforcing. For details, see Applying security policies.

Verification

1. Verify that the previously removed rescue kernel and rescue initial RAM disk files have been created for the current kernel:

   # ls /boot/vmlinuz-*rescue* /boot/initramfs-*rescue* 
   # lsinitrd /boot/initramfs-*rescue*.img | grep -qm1 "$(uname -r)/kernel/" && echo "OK" || echo "FAIL"

   Copy to Clipboard Toggle word wrap

2. Verify the rescue boot entry refers to the existing rescue files. See the grubby output:

   # grubby --info /boot/vmlinuz-*rescue*

   Copy to Clipboard Toggle word wrap

3. Review the grubby output and verify that no RHEL 8 boot entries are configured:

   # grubby --info ALL

   Copy to Clipboard Toggle word wrap

4. Verify that no files related to previous RHEL are present in the /boot/loader/entries file:

   # grep -r ".el8" "/boot/loader/entries/" || echo "Everything seems ok."

   Copy to Clipboard Toggle word wrap