问题说明

本文用于排查“ZSphere 添加 SAN 数据存储报 mpath 设备被占用”类问题。

现象

• 添加 SAN 数据存储失败，报 can't open /dev/mapper/mpathm exclusively 或 Mounted filesystem。
• 底层能看到多路径设备，但平台无法纳管为数据存储。

适用环境

• 产品：ZVF
• 版本：4.x
• 组件：ZSphere
• 涉及对象：SAN 数据存储
• 场景：存储与透传类问题，需结合当前版本、部署形态、存储类型和操作时间线确认。

可能原因

• lvm.conf 或 lvmlocal.conf filter 过滤规则不正确。
• 目标 mpath 设备被已有文件系统、LVM 或其他进程占用。
• 多路径设备命名或 WWID 识别异常。

排查步骤

按顺序执行以下检查，并记录受影响对象、发生时间、完整报错和当前状态。

1. 确认目标 LUN、WWID、mpath 设备和主机可见性。
2. 只读检查 multipath、lsblk、pvs/vgs/lvs，确认设备是否被占用。
3. 核对 lvm.conf/lvmlocal.conf filter 是否匹配当前设备。
4. 修改过滤规则或释放设备前需确认该 LUN 未承载现有业务数据。

处理方法

1. 确认目标 LUN 未承载现有业务数据、卷组或文件系统后，按当前设备规划修正 LVM 过滤规则或释放占用。
2. 无法确认设备引用关系时，保留 multipath 和 LVM 信息，联系 ZStack 官方技术支持确认处理路径。

验证方法

• 目标 LUN 可被正确识别，且不再被错误的 mpath 或 LVM 引用占用。
• SAN 数据存储可成功添加，现有业务 LUN 不受影响。