Affected versions: CentOS Stream 9

📖 ~1 min read

Table of contents
  1. Symptom & Impact
  2. Environment & Reproduction
  3. Root Cause Analysis
  4. Quick Triage
  5. Step-by-Step Diagnosis
  6. Solution – Primary Fix
  7. Solution – Alternative Approaches
  8. Verification & Acceptance Criteria
  9. Rollback Plan
  10. Prevention & Hardening
  11. Related Errors & Cross-Refs
  12. References & Further Reading

Symptom & Impact

Network config changes in /etc/sysconfig/network-scripts are ignored.

Environment & Reproduction

CentOS Stream 9 defaults to NetworkManager keyfile plugin, not ifcfg.

Root Cause Analysis

The ifcfg-rh plugin is deprecated; keyfiles live under /etc/NetworkManager/system-connections/.

Quick Triage

nmcli -t -f NAME,FILENAME c show lists each connection’s source file.

Step-by-Step Diagnosis

Inspect /etc/NetworkManager/conf.d/ for plugin directives.

Illustrative mockup for centos-stream-9 — nm_keyfile_diag
Diagnostic view for networkmanager-keyfile-vs-ifcfg — Illustrative mockup — Progressive Robot

Solution – Primary Fix

Migrate with nmcli c migrate or edit the keyfile and nmcli c reload.

Still having issues? Our IT Solutions & Services team can diagnose and resolve this for you. Get in touch for a free consultation.

Illustrative mockup for centos-stream-9 — nm_keyfile_fix
Remediation steps for networkmanager-keyfile-vs-ifcfg — Illustrative mockup — Progressive Robot

Solution – Alternative Approaches

Install NetworkManager-config-server and re-enable ifcfg-rh plugin temporarily.

Verification & Acceptance Criteria

nmcli c up succeeds and ip a shows expected addressing.

Rollback Plan

Restore the ifcfg file and run nmcli c reload to fall back.

Prevention & Hardening

Standardize on keyfile and store configs in Ansible nmcli module.

Related: dispatcher script paths and connection.autoconnect settings.

Related tutorial: View the step-by-step tutorial for centos-stream-9.

View all centos-stream-9 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Red Hat ‘Configuring and managing networking’ guide.

Need Expert Help?

If you cannot resolve this yourself, our team offers hands-on Server Management, Managed IT Services, and flexible Support Plans. Contact us today — we respond within one business day.