需依次完成multipath工具安装启用、配置文件生成编辑、多路径设备扫描发现、udev规则固化设备名、路径故障切换验证五步操作，确保Linux系统正确识别和管理多路径存储设备。
如果您在Linux系统中使用多路径存储设备，但系统无法正确识别或管理multipath设备，则可能是由于multipath服务未启用、配置文件缺失或底层设备路径异常。以下是完成multipath设备配置与管理的具体步骤：
一、安装并启用multipath工具
multipath-tools是Linux下管理多路径设备的核心软件包，提供mpathconf、multipath、multipathd等命令行工具。需确保该工具已安装且守护进程处于运行状态。
1、执行yum install device-mapper-multipath（RHEL/CentOS）或apt install multipath-tools（Debian/Ubuntu）安装软件包。
2、运行systemctl enable multipathd设置开机自启。
3、运行systemctl start multipathd启动multipath守护进程。
4、执行lsmod | grep dm_multipath确认内核模块dm_multipath已加载。
二、生成并编辑multipath.conf配置文件
默认情况下multipath.conf可能不存在或为空，需手动创建基础配置以定义设备黑名单、多路径策略及WWID匹配规则。配置文件控制设备发现、路径分组和故障切换行为。
1、执行mpathconf --enable --with_multipathd y生成初始配置文件。
2、备份原始配置：cp /etc/multipath.conf /etc/multipath.conf.bak。
3、用文本编辑器打开/etc/multipath.conf，取消defaults段中user_friendly_names的注释，并设为yes。
4、在blacklist段中添加devnode "^sda"等本地磁盘设备名，避免将系统盘纳入多路径管理。
5、保存后执行systemctl restart multipathd重载配置。
三、扫描并发现多路径设备
系统需主动探测SCSI总线上的LUN并识别重复路径，通过WWID聚合为单一multipath设备节点（如/dev/mapper/mpatha）。此过程依赖于udev规则和底层HBA驱动状态。
1、执行echo "- - -" > /sys/class/scsi_host/host*/scan触发所有HBA主机适配器重新扫描。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
2、运行fdisk -l | grep "Multipath"或ls /dev/mapper/查看是否出现mpath*设备。
3、使用multipath -ll列出当前所有多路径映射关系，确认各路径状态为active或failed。
4、若输出中显示[undef]或ghost，说明部分路径未被正确识别，需检查光纤链路或存储端Zone配置。
四、配置udev规则固化设备名
为避免multipath设备名在重启后变动，需基于WWID创建稳定的符号链接。udev规则可将特定WWID绑定至预定义别名（如/dev/mapper/vol_data），保障上层应用访问一致性。
1、执行multipath -v3 -d | grep "wwid"获取目标LUN的完整WWID字符串。
2、编辑/etc/udev/rules.d/99-multipath-custom.rules，添加一行：ENV{DM_UUID}=="mpath-<strong><font color="green">3600a09803830444f4e3b4c547a6b7c8d</font></strong>", SYMLINK+="mapper/vol_data"（替换WWID为实际值）。
3、运行udevadm control --reload-rules重载规则。
4、执行udevadm trigger --subsystem-match=block触发设备事件，使新链接生效。
五、验证路径故障切换功能
模拟单条物理路径中断，验证multipathd能否自动将I/O重定向至其余可用路径，确保业务连续性。该测试需在非生产环境或维护窗口执行。
1、运行cat /proc/scsi/scsi确认各HBA卡对应的目标ID与LUN ID。
2、执行echo 1 > /sys/block/<strong><font color="green">sdX/device/delete</font></strong>（将sdX替换为待屏蔽的路径设备名）强制卸载某条路径。
3、持续运行watch -n1 "multipath -ll | grep -A5 mpatha"观察路径状态变化。
4、当原路径变为failed而其余路径保持active且I/O无中断时，表明故障切换成功。
