CentOS Stream 9 – Common Problem 040 – Diagnosis and Fix

📖 ~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

SAN-attached host on CentOS Stream 9 reports failed paths for /dev/mapper/mpathb.

Environment & Reproduction

Hosts with FC HBA or iSCSI to active-passive arrays.

cat /etc/os-release
uname -r
rpm -qa | grep 

Root Cause Analysis

Cable or switch port failure on one fabric, or stale multipath bindings.

Quick Triage

Confirm package, network, SELinux and firewall state.

multipath -ll
lsblk
ls /dev/mapper/

Step-by-Step Diagnosis

Drill into storage/multipath state and recent journal entries to isolate the failure.

journalctl -k | grep -i multipath
dmsetup ls --target multipath

Solution – Primary Fix

Apply the standard remediation for storage/multipath on CentOS Stream 9.

sudo multipath -F
sudo systemctl restart multipathd
sudo multipath -v2

Solution – Alternative Approaches

Switch path_grouping_policy to multibus for active/active arrays.

Verification & Acceptance Criteria

Validate the fix with positive functional checks before closing.

multipath -ll | grep -E 'active|failed'

Rollback Plan

Revert to the previous known-good configuration if the fix regresses.

cp /root/backup/multipath.conf /etc/multipath.conf
systemctl restart multipathd

Prevention & Hardening

Codify the fix in configuration management and add monitoring.

Monitor path state via SNMP and Prometheus exporter.

Related Errors & Cross-Refs

FC zoning and iSCSI portal mismatches.

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

device-mapper-multipath documentation.