RHEL 8 to RHEL 9: inplace upgrade fails at "Network configuration for unsupported device types detected"

Solution Verified - Updated

Environment

  • Red Hat Enterprise Linux 8
    • leapp

Issue

  • When performing RHEL 8 to RHEL 9 inplace upgrade, leapp reports one inhibitor as follows

    Risk Factor: high (inhibitor)
Title: Network configuration for unsupported device types detected
Summary: RHEL 9 does not support the legacy network-scripts package that was deprecated in RHEL 8 in favor of NetworkManager. Files for device types that are not supported by NetworkManager are present in the system. Files with the problematic configuration:
    - /etc/sysconfig/network-scripts/ifcfg-XXX

Resolution

The solution is to convert all legacy /etc/sysconfig/network-scripts/ifcfg-XXX files into their equivalent in /etc/NetworkManager/system-connections directory.

  1. Collect the list the ifcfg files.

    # ls /etc/sysconfig/network-scripts/ifcfg-*

    Example of output:

    /etc/sysconfig/network-scripts/ifcfg-Wired_connection_1

  2. Collect the current NetworkManager connections.

    # nmcli con show

    Example of output:

    NAME                UUID                                  TYPE      DEVICE 
Wired connection 1  80fbe093-84e9-33dd-XXXX-29296cc7646c  ethernet  enp1s0

  3. For each ifcfg configuration file listed in the nmcli output above, migrate the respective confirmation file.

    # nmcli connection migrate "Wired connection 1"

    Example of output:

    Connection 'Wired connection 1' (80fbe093-84e9-XXXX-abef-29296cc7646c) successfully migrated.

Root Cause

  • The Legacy network scripts are deprecated in Red Hat Enterprise Linux 8 and are no longer provided by default.
  • For more details, please check the doc attached below:
    Chapter 9. Networking

This content is not included.BZ 2196797 - RFE: enhance the resolution for "Network configuration for unsupported device types detected" actor has been filed to provide better resolution instructions.

Diagnostic Steps

  • The pre-upgrade report is available both in the /var/log/leapp/leapp-report.txt file.The report summarizes potential problems and proposes recommended solutions. The report also helps you decide whether it is possible or advisable to proceed with the upgrade.

  • The leapp-report.txt file contains the following inhibitor

    Risk Factor: high (inhibitor)
Title: Network configuration for unsupported device types detected
Summary: RHEL 9 does not support the legacy network-scripts package that was deprecated in RHEL 8 in favor of NetworkManager. Files for device types that are not supported by NetworkManager are present in the system. Files with the problematic configuration:
    - /etc/sysconfig/network-scripts/ifcfg-XXX
SBR
Product(s)
Components
Category
Tags

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.