路径状态

multipathd 守护进程会根据 /etc/multipath.conf 文件中定义的轮询间隔定期对路径状态进行更新。就内核而言，dm 状态与路径状态类似。dm 状态将保留其当前状态，直到路径检查程序完成为止。

路径状态

ready, ghost该路径已启动并准备好进行 I/O。

faulty, shaky路径为停用。

i/o pending检查程序正积极检查此路径，状态将很快更新。

i/o timeout检查程序在超时之前没有返回success/failure。这被认为与 faulty 一样。

removed该路径已从系统中删除，很快也将从多路径设备中删除。这被认为与 faulty 一样。

wild multipathd 无法运行路径检查程序，因为内部错误或配置问题。这与 faulty 相同，除了多路径会跳过路径上的许多操作。

unchecked路径检查程序还没有在此路径上运行，要么是因为它刚刚被发现，还没有一个分配的路径检查程序，要么是路径检查程序遇到了错误。这与 wild 相同。

delayed路径检查程序返回路径已启动，但多路径会延迟路径的恢复，因为路径最近失败了多次，且多路径已被配置为在此种情况下延迟路径。这被认为与 faulty 一样。

DM 状态

Active映射到 ready 和 ghost 路径状态。

Failed映射到所有其他路径的状态，除了 没有等效的 dm 状态的 i/o pending 。

在线状态

Running设备已启用。

Offline设备已禁用。

安装multipath软件

RHEL/CentOS

老版本：

# yum install device-mapper-multipath

8之后：

# dnf install device-mapper-multipath

Ubuntu

$ sudo apt-update

$ sudo apt-get install multipath-tools multipath-tools-boot

初始化配置文件

第一次安装multipath后，是没有配置文件/etc/multipath.conf的，可以手动创建或者从模板拷贝。

RHEL/CentOS

创建一个空配置

# mpathconf --enable

将 DM 多路径配置为使用多路径设备 WWID 作为其名称，而不是 mpath_n_ 用户友好命名方案：

# mpathconf --enable --user_friendly_names n

从模板拷贝配置文件

cp /usr/share/doc/device-mapper-multipath-0.4.9/multipath.conf /etc/multipath.conf

通过multipath内置的配置库获取默认的配置文件

​ 1.手动创建一个空的multipath.conf文件

# touch /etc/multipath.conf

​ 2.使用如下命令获取内置配置

# echo "show config" | multipathd -k >/etc/multipath.conf

重新载入配置

# systemctl reload multipathd.service

# systemctl start multipathd.service

验证配置结果

# ls /dev/mapper/

查看默认配置

# multipath -t

Ubuntu

从模板拷贝配置

# cp /usr/share/doc/multipath-tools/examples /etc/multipath.conf

从内部配置库获取配置文件

# touch /etc/multipath.conf --//创建一个空配置

# systemctl restart multipath-tools.service --//重启服务

# echo 'show config' | multipathd -k > multipath.conf-live --//生成内部配置

手动创建一个配置文件，然后编辑内容

重启服务，重新加载配置

# systemctl restart multipath-tools.service

自定义多路径配置

查看默认配置

# multipathd show config

# multipath -t

关于配置文件结构描述

在DM的配置文件中可以有以下几类配置项：

blacklist

不视为多路径的特定设备列表。

blacklist_exceptions

根据 blacklist 部分的参数，列出其他将被忽略的多路径设备。

defaults

DM 多路径的常规默认设置。

multipaths

各个多路径设备特性的设置。这些值会覆盖在配置文件中的 overrides, devices, 和 defaults 部分指定的值。

devices

各个存储控制器的设置。这些值覆盖了在 配置文件的 defaults 部分中指定的内容。如果您使用默认不支持的存储阵列，您可能需要为阵列创建 devices 子部分。

overrides

适用于所有设备的设置。这些值覆盖了在配置文件的 devices 和 defaults 部分中指定的值。

当系统决定多路径设备的属性时，它会按照以下顺序检查 multipath.conf 文件中的单独部分的设置：

multipaths 部分overrides 部分devices 部分defaults 部分

配置文件blacklist段

blacklist中设置不被DM配置的本地磁盘设备，通常有以下几种方式：

通过设备的WWID设置

获取到本地设备，如sda的wwid

# multipathd show paths raw format "%d %w" | grep sda

sda WDC_WD800JD-75MSA3_WD-WMAM9FU71040

编辑/etc/multipath.conf文件如下：

blacklist {

wwid WDC_WD800JD-75MSA3_WD-WMAM9FU71040

}

通过设备名称设置

使用devnode 本地磁盘设备名称设置blacklist。

blacklist {

devnode "^sd[a-z]"

}

此方式不太推荐，因为如果某些设备不经udev规则绑定，可能在系统重启后，设备名称会发生变化。

通过设备类型设置

通过特定的设备类型，屏蔽某些特定型号的设备。

blacklist {

device {

vendor "IBM"

product "3S42" #DS4200 Product 10

}

device {

vendor "HP"

product "*"

}

}

​

配置文件defaults段

参见文档： multipath默认参数值.xlsx

配置文件multipaths段

使用 multipath.conf 配置文件的 multipaths 部分设置单个多路径设备的属性。设备映射器(DM)多路径使用这些属性覆盖所有其他配置设置，包括 overrides 部分中的设置。

multipaths 部分仅将 multipath 子部分识别为属性。下表显示了您可以在 multipath 子部分中为每个特定多路径设备设置的属性。

以下列表中的属性是可选的。如果没有设置它们，则会应用来自 overrides, devices, 或 defaults 部分中的默认值。以下这些属性的设置可以参考 配置默认设置 章节

path_grouping_policypath_selectorprioprio_argsfailbackno_path_retryrr_min_iorr_min_io_rqflush_on_last_delfeaturesreservation_keyuser_friendly_namesdeferred_removesan_path_err_thresholdsan_path_err_forget_ratesan_path_err_recovery_timemarginal_path_err_sample_timemarginal_path_err_rate_thresholdmarginal_path_err_recheck_gap_timemarginal_path_double_failed_timedelay_watch_checksdelay_wait_checksskip_kpartxmax_sectors_kbghost_delay

配置文件devices段

使用 multipath.conf 配置文件的 devices 部分为单个存储控制器类型定义设置。本节中设置的值覆盖 defaults 部分中的指定的值。系统根据 vendor, product, 和 revision 关键字标识存储控制器类型。这些关键字是正则表达式，必须与有关特定设备的 sysfs 信息匹配。

devices 部分仅将 device 子部分识别为属性。如果某个设备有多个关键字匹配，则所有匹配条目的属性都将应用到其中。如果在多个匹配的 device 子部分中指定属性，则后续版本的条目优先于任何之前条目。

Linux 内核，版本 4.3 及更新版本会自动将设备处理程序附加到已知设备。这包括支持 SCSI-3 ALUA 的所有设备。之后，内核不会启用更改处理程序。在这些内核上设置此类设备的 hardware_handler 属性不会起作用。