参考来源与致谢
- 引用来源:Ubuntu系统下的多路径软件 DM Multipath 配置。 – pipci – 博客园
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
服务器通过多条物理链路连接同一 SAN 存储卷时,操作系统会看到多个同源块设备。DM Multipath 是 Ubuntu 自带的设备映射器多路径工具,用于把这些路径聚合为一个逻辑设备,并在链路故障时切换 I/O 路径。适用于双控存储、双 HBA、双交换机等冗余组网环境。
若仅使用本地磁盘或单链路直连存储,通常无需启用多路径。
组件说明 #
- dm_multipath:内核模块,为路径与路径组重新分配 I/O,提供出错冗余。
- multipath-tools:用户态程序集,负责配置并启用设备映射器多路径。
- multipath:命令,列出并配置多路径设备。
- multipathd:守护进程,监视路径状态,路径恢复后触发路径组切换;修改
/etc/multipath.conf后需使其重新加载。 - kpartx:为设备中的分区生成映射设备,处理 DOS 分区时常用。
准备与风险 #
操作前请确认:
- 已在测试环境验证,或已对业务数据完成备份。
- 已记录当前磁盘拓扑,包括各路径的 WWID。
- 已确认存储侧映射与 zoning 配置正确。
- 已准备回退方案,例如可卸载软件包、恢复原
multipath.conf。
分区、格式化、LVM 操作具有破坏性。请先备份数据,并在测试环境验证命令,再在生产环境执行。
处理步骤 #
1. 检查软件包 #
dpkg -l | grep multipath-tools
无输出表示未安装。可通过 apt 源安装;无法访问外网时,可挂载系统 ISO 配置本地源,具体方法参见对应 Ubuntu 版本官方文档。
2. 安装软件包 #
apt-cache search multipath-tools
apt-get install multipath-tools
若需从 SAN 引导,再安装 multipath-tools-boot;否则可不装。
3. 检查服务状态 #
systemctl list-unit-files | grep multipath
若未启用:
systemctl enable multipath-tools.service
4. 生成配置文件 #
默认无 /etc/multipath.conf。安装后模板位于 /usr/share/doc/multipath-tools/examples/,可复制为正式配置:
cp -v /usr/share/doc/multipath-tools/examples/multipath.conf.synthetic /etc/multipath.conf
5. 编辑配置 #
模板内容多为注释,可按环境取消相关行注释,或直接追加。示例:
defaults {
user_friendly_names yes
path_grouping_policy multibus
}
blacklist {
wwid [本地磁盘WWID]
}
查看磁盘 WWID:
ll /dev/disk/by-id/
把本地磁盘加入黑名单,避免多路径接管系统盘。
6. 启动守护进程 #
systemctl start multipathd.service
修改配置后使其生效:
systemctl reload multipathd.service
7. 检查模块 #
lsmod | grep dm_multipath
8. 查看多路径设备 #
multipath -ll
输出中应出现聚合设备及其多条路径。使用 fdisk -l 时,针对存储卷请操作 /dev/mapper/ 下的多路径设备,不要直接操作 /dev/sdb、/dev/sdc 等单路径设备,本地系统盘除外。
验证方法 #
multipath -ll显示设备状态为 active ready,路径数符合预期。lsblk或fdisk -l可见/dev/mapper/下的聚合设备。- 在测试环境断开一条链路,观察 I/O 是否继续,路径状态是否变化。
- 恢复链路后确认路径重新上线。
回退建议 #
- 停止并禁用相关服务:
systemctl stop multipathd.service、systemctl disable multipathd.service。 - 恢复修改前的
/etc/multipath.conf,或移除新增配置。 - 必要时卸载软件包,并确认业务已切换到其他访问方式。
- 回退前确保无业务正在使用多路径设备。
常见问题 #
user_friendly_names 是否应设为 yes #
设为 yes 时,设备别名为 mpathn,但该名称仅在单节点唯一,不保证集群各节点一致。集群中若需名称统一,建议设为 no,且不要为设备配置 alias。使用 LVM 时通常不受影响。
/dev/mapper 与 /dev/dm-n 区别 #
/dev/mapper/ 下的设备用于业务访问;/dev/dm-n 仅供内部使用,不要直接引用。
修改配置后未生效 #
需执行 systemctl reload multipathd.service 或重启守护进程。
本地磁盘被多路径接管 #
检查 blacklist 中的 WWID 是否正确,确认后重新加载配置。
不同 Ubuntu 版本在软件包名称、服务单元、模板路径上可能存在差异,请以对应版本官方文档为准。
