DM Multipath

Red Hat Enterprise Linux 7

Device Mapper Multipath の設定および管理

概要

本ガイドは、Red Hat Enterprise Linux 7 で Device Mapper Multipath を使用する方法について説明しています。

第1章 Device Mapper を使ったマルチパス設定

Device Mapper のマルチパス (DM Multipath) を使用すると、サーバーノードとストレージアレイとの間の複数の I/O パスを 1 つのデバイスに設定できます。これらの I/O パスは、個別のケーブル、スイッチ、コントローラーを含むことができる物理的な SAN 接続です。複数の I/O パスを集め、集めたパスで設定される新しいデバイスを 1 つ作成するのがマルチパス機能です。

この章では、Red Hat Enterprise Linux 7 の初期リリースの後に追加された DM-Multipath の機能についてまとめています。また、DM-Multipath および各コンポーネントについての高水準の概要、DM-Multipath の設定についての概要についても説明しています。

1.1. 新機能と変更点

本項では、Red Hat Enterprise Linux 7 の初期リリース以降の DM Multipath の新機能について説明します。

1.1.1. Red Hat Enterprise Linux 7.1 の新機能および変更された機能

Red Hat Enterprise Linux 7.1 には、ドキュメントや機能を対象とする以下の更新および変更が含まれています。

表5.1「便利な multipath コマンドのオプション」に、multipath コマンドの -w と -W のオプションに関する説明が加えられています。このオプションを使用すると wwids ファイルの管理が容易になります。
multipath.conf ファイルの features パラメーターの values 引数に使用できる追加オプションの説明が、4章DM Multipath 設定ファイルに加えられています。
表4.1「マルチパス設定の defaults セクション」に force_sync パラメーターの説明が加えられています。このパラメーターを yes に設定すると、パスチェッカーが非同期モードでは実行されなくなります。

さらに、ドキュメント全体にわたり、技術的な内容の若干の修正と明確化を行いました。

1.1.2. Red Hat Enterprise Linux 7.2 の新機能および変更された機能

Red Hat Enterprise Linux 7.2 ではドキュメントと機能が以下のように更新/変更されています。

本書には新しい項「Multipath Helper で自動設定ファイルの生成」が加えられました。Multipath Helper アプリケーションを使用して、カスタムエイリアスとデバイスブラックリストのマルチパス設定や、個々のマルチパスデバイスの特性向け設定を作成できます。
multipath.conf 設定ファイルの defaults セクションで、パラメーター config_dir、new_bindings_in_boot、ignore_new_boot_devs、retrigger_tries、および retrigger_delays がサポートされるようになりました。multipath.conf ファイルの defaults セクションの詳細は、表4.1「マルチパス設定の defaults セクション」を参照してください。
multipath.conf 設定ファイルの defaults、devices、multipaths のセクションで、設定パラメーター delay_watch_checks および delay_wait_checks がサポートされるようになりました。設定パラメーターの詳細は、4章DM Multipath 設定ファイルを参照してください。

さらに、ドキュメント全体にわたり、技術的な内容の若干の修正と明確化を行いました。

1.1.3. Red Hat Enterprise Linux 7.3 の新機能および変更された機能

Red Hat Enterprise Linux 7.3 ではドキュメントと機能が以下のように更新、変更されています。

multipathd コマンドが、"raw" 形式のバージョンでマルチパスデバイスとパスのステータスを表示する新しい形式のコマンドをサポートするようになりました。raw 形式ではヘッダーは出力されず、フィールドがパッディングされていないため、列とヘッダーが調整されていません。代わりに、フィールドは format 文字列の指定どおりに出力します。multipathd コマンドの詳細は、「multipathd コマンド」を参照してください。
Red Hat Enterprise Linux 7.3 以降、デバイス設定で prio "alua exclusive_pref_bit" を指定すると、マルチパスが pref ビットセットのパスのみを含むパスグループを作成し、このパスグループに最高の優先度を与えるようになります。設定パラメーターの詳細は、4章DM Multipath 設定ファイルを参照してください。
multipath.conf 設定ファイルの defaults、devices、multipaths の各セクションで skip_kpartx 設定パラメーターがサポートされるようになりました。設定パラメーターの詳細は、4章DM Multipath 設定ファイルを参照してください。

さらに、ドキュメント全体にわたり、技術的な内容の若干の修正と明確化を行いました。

1.1.4. Red Hat Enterprise Linux 7.4 の新機能および変更された機能

Red Hat Enterprise Linux 7.4 では、ドキュメントと機能が以下のように更新、変更されています。

multipath.conf 設定ファイルの defaults、devices、multipaths の各セクションで、max_sectors_kb 設定パラメーターをサポートするようになりました。設定パラメーターの詳細は、4章DM Multipath 設定ファイルを参照してください。
multipath.conf 設定ファイルの defaults セクションおよび devices セクションで、detect_path_checker 設定パラメーターをサポートするようになりました。設定パラメーターの詳細は、4章DM Multipath 設定ファイルを参照してください。
multipath.conf 設定ファイルの defaults セクションで、remove_retries パラメーターと detect_path_checker パラメーターをサポートするようになりました。multipath.conf ファイルの defaults セクションの詳細は、表4.1「マルチパス設定の defaults セクション」を参照してください。

1.1.5. Red Hat Enterprise Linux 7.5 の新機能および変更された機能

Red Hat Enterprise Linux 7.5 では、ドキュメントと機能が以下のように更新、変更されています。

Red Hat Enterprise Linux 7.5 より、multipath.conf 設定ファイルの blacklist および blacklist_exceptions セクションが property パラメーターをサポートするようになりました。property パラメーターの詳細は「ブラックリストから除外」を参照してください。
multipath.conf 設定ファイルの defaults および multipaths セクションが reservation_key パラメーターの file の値をサポートするようになりました。設定パラメーターの詳細は、4章DM Multipath 設定ファイルを参照してください。
multipath.conf 設定ファイルの defaults セクションは prkeys_file パラメーターをサポートします。multipath.conf ファイルの defaults セクションの詳細は、表4.1「マルチパス設定の defaults セクション」を参照してください。

1.1.6. Red Hat Enterprise Linux 7.6 の新機能および変更された機能

Red Hat Enterprise Linux 7.6 では、ドキュメントと機能が以下のように更新、変更されています。

Red Hat Enterprise Linux 7.6 より、設定ファイルの blacklist セクションで protocol セクションを使用すると、マルチパス化から除外するデバイスのプロトコルを指定することができます。デバイスプロトコルでブラックリストに指定する方法については、「デバイスプロトコルでブラックリストの指定 (Red Hat Enterprise Linux 7.6 以上)」を参照してください。
multipath.conf 設定ファイルの defaults および devices セクションは、all_tg_pt パラメーターをサポートします。設定パラメーターの詳細は、4章DM Multipath 設定ファイルを参照してください。

1.2. DM Multipath の概要

DM Multipath は以下のような目的に使用できます。

冗長性

DM Multipath は、アクティブ/パッシブ設定でフェイルオーバーを提供できます。アクティブ/パッシブ設定では、パスは、I/O には常に半分しか使用されません。I/O パスの要素 (ケーブル、スイッチ、またはコントローラー) に障害が発生すると、DM Multipath は代替パスに切り替えます。
パフォーマンスの向上
DM Multipath を active/active モードに設定すると、I/O はラウンドロビン式でパス全体に分散されます。一部の設定では、DM Multipath は I/O パスの負荷を検出し、負荷を動的に再調整できます。

図1.1「active/passive マルチパス設定 - RAID デバイスが 1 つ」に、サーバーから RAID デバイスへの I/O パスが 2 つある active/passive 設定を示します。サーバーには HBA が 2 つ、SAN スイッチ、RAID コントローラーが 2 つずつあります。

図1.1 active/passive マルチパス設定 - RAID デバイスが 1 つ

[D]

この設定では、hba1、SAN1、およびコントローラー 1 を通る I/O パスと、hba2、SAN2、およびコントローラー 2 を通る I/O パスの 2 つのパスがあります。この設定には、障害が発生する可能性のあるポイントが数多く存在します。

HBA の障害
FC ケーブルの障害
SAN スイッチの障害
アレイコントローラーポートの障害

DM-Multipath が設定されていると、このようなポイントで障害が発生したときに、DM-Multipath により代替 I/O パスへの切り替えが行われます。

図1.2「active/passive マルチパス設定 - RAID デバイスが 2 つ」ではもう少し複雑な active/passive 設定を示します。サーバーには HBA、SAN スイッチがそれぞれ 2 つあり、RAID コントローラーがそれぞれ 2 つ付いた RAID デバイスが 2 つあります。

図1.2 active/passive マルチパス設定 - RAID デバイスが 2 つ

[D]

図1.2「active/passive マルチパス設定 - RAID デバイスが 2 つ」に示した例では、それぞれの RAID デバイスに 2 つの I/O パスがあります (図1.1「active/passive マルチパス設定 - RAID デバイスが 1 つ」に示した例と同様)。DM-Multipath が設定されていると、RAID デバイスへの I/O パスで障害が発生したときに、DM-Multipath が、I/O パスを別のパスに切り替えます。

図1.3「active/active マルチパス設定 - RAID デバイスが 1 つ」では、サーバーに HBA が 2 つ、SAN スイッチが 1 つ、RAID コントローラーが 2 つある active/active 設定を示します。サーバーからストレージデバイスへの I/O パスは 4 つあります。

hba1 から controller1 まで
hba1 から controller2 まで
hba2 から controller1 まで
hba2 から controller2 まで

この設定では、 I/O をこれらの 4 つのパスに分散することが可能です。

図1.3 active/active マルチパス設定 - RAID デバイスが 1 つ

[D]

1.3. ストレージアレイの対応

DM-Multipath に対応しているストレージアレイで最も一般的なものは、DM-Multipath にデフォルトで含まれています。対応しているデバイスなどのデフォルトの設定値は、以下のいずれかのコマンドを実行して確認してください。

# multipathd show config
# multipath -t

ストレージアレイが DM Multipath に対応していてもデフォルトの設定には含まれていない場合は、DM Multipath 設定ファイルの multipath.conf にそのストレージアレイを追加する必要があります。DM Multipath 設定ファイルの詳細は4章DM Multipath 設定ファイルを参照してください。

ストレージアレイの中には、I/O エラーとパスの切り替えに特殊な処理を必要とするがあります。こうしたストレージアレイの場合には、別途ハードウェアハンドラーカーネルモジュールが必要になります。

1.4. DM Multipath のコンポーネント

表1.1「DM Multipath のコンポーネント」で、DM-Multipath のコンポーネントを説明します。

表1.1 DM Multipath のコンポーネント
コンポーネント	説明
`dm_multipath` カーネルモジュール	I/O を再ルーティングし、パスとパスグループのフェールオーバーに対応します。
`mpathconf` ユーティリティー	デバイスマッパーマルチパスを設定して有効にします。
multipath コマンド	マルチパスデバイスを表示、設定します。通常、`/etc/rc.sysinit` で起動しますが、ブロックデバイスを追加した場合は udev プログラムで起動することもできます。
multipathd デーモン	パスを監視します。パスが失敗して戻るため、パスグループスイッチを開始します。マルチパスデバイスへのインタラクティブな変更を許可します。対話式でマルチパスデバイスに変更を加えることができます。`/etc/multipath.conf` ファイルを変更した場合は、常にデーモンを再起動する必要があります。
kpartx コマンド	デバイス上のパーティションのデバイスマッパーデバイスを作成します。DM Multipath の DOS ベースパーティションの場合はこのコマンドを使用する必要があります。kpartx はそれ自体のパッケージで提供されますが、`device-mapper-multipath` パッケージはそのパッケージに依存します。

1.5. DM Multipath 設定の概要

DM Multipath には、一般的なマルチパス設定に適したデフォルト設定がコンパイルされています。DM Multipath をシステムに設定する基本的手順を以下に示します。

device-mapper-multipath rpm をインストールします。
mpathconf コマンドで設定ファイルを作成し、マルチパスを有効にします。設定ファイルを編集する必要がない場合は、このコマンドでマルチパスデーモンを起動することもできます。
必要に応じて multipath.conf 設定ファイルを編集し、デフォルト値の変更、更新したファイルの保存を行います。
マルチパスデーモンを起動します。

マルチパス設定の手順については3章DM Multipath の設定をご覧ください。

第2章マルチパスデバイス

DM-Multipath を使用しない場合、サーバーノードからストレージコントローラーへの各パスは、システムでは別々のデバイスとして扱われます。DM Multipath は、基礎となるデバイスの上に 1 つのマルチパスデバイスを作成することにより、I/O パスを論理的に整理する方法を提供します。

2.1. マルチパスデバイス識別子

マルチパスデバイスは、それぞれグローバルに固有で不変となる World Wide Identifier (WWID) を持っています。デフォルトでは、マルチパスデバイスの名前はその WWID に設定されます。マルチパス設定ファイル内に user_friendly_names オプションを設定すると、mpathn 形式の、ノード固有の名前にエイリアスを作成することができます。

例えば、HBA を 2 つ搭載したノードとポートが 2 つあるストレージコントローラーを、ゾーニングされていない 1 つの FC スイッチで接続した場合、/dev/sda、/dev/sdb、dev/sdc、/dev/sdd の 4 つのデバイスが認識されます。DM Multipath は、マルチパス設定に従って、I/O を基本となるこれらの 4 つのデバイスにルーティングしなおす一意の WWID を持つシングルデバイスを作成します。user_friendly_names 設定オプションが yes に設定されている場合、マルチパスデバイスの名前は mpathn に設定されます。

新しいデバイスを DM-Multipath の管理下に置くと、/dev ディレクトリー配下の /dev/mapper/mpathn と /dev/dm-n の 2 ヶ所に表示されます。

/dev/mapper のデバイスは、ブートプロセスの初期段階で作成されます。論理ボリュームの作成時など、マルチパスを設定したデバイスにアクセスします。
/dev/dm-n 形式のデバイスはすべて内部的な使用を目的としているため、管理者の方は絶対に使用しないでください。

user_friendly_names 設定オプションなど、マルチパス設定のデフォルト値については「設定ファイルの defaults セクション」を参照してください。

マルチパス設定ファイルの multipaths セクションに alias オプションを使用することで、マルチパスデバイスに任意の名前を付けることもできます。マルチパス設定ファイルの multipaths セクションについての詳細は「設定ファイルの multipaths セクション」を参照してください。

2.2. クラスター内で整合性のあるマルチパスデバイス名の維持

user_friendly_names 設定オプションを yes に設定すると、マルチパスデバイスの名前が 1 ノードに対して固有となりますが、そのマルチパスデバイスを使用している全ノードで同じ名前になる保証はありません。同様に、multipath.conf 設定ファイルの multipaths セクションでデバイスに alias オプションを設定すると、その名前が自動的にクラスター内の全ノードで同じにはなりません。LVM を使用してマルチパスデバイスから複数の論理デバイスを作成している場合は問題にならないはずですが、すべてのノードでマルチパスデバイス名を同じ名前にする必要がある場合は、user_friendly_names オプションを yes に設定しない、またデバイスにエイリアスを設定しないことをお勧めします。user_friendly_names を yes に設定したりデバイスにエイリアスを設定しなければ、デバイス名はデフォルトでそのデバイスの WWID になるため、整合性を維持することができます。

ただし、システムで定義される user_friendly_names を、クラスター内の全ノードに対して固有にしたい場合には、以下の手順に従うと整合性を維持することができます。

すべてのマルチパスデバイスの設定をひとつのマシンで行います。
次のコマンドを使って、他のマシンのマルチパスデバイスをすべて無効にします。
```
# systemctl stop multipathd.service
# multipath -F
```
クラスター内の 1 番目のマシンの /etc/multipath/bindings ファイルを他のすべてのマシンにコピーします。
先ほど multipathd デーモンを無効にしたすべてのマシンで以下のコマンドを実行して、再度デーモンを有効にします。
```
# systemctl start multipathd.service
```

新しいデバイスを追加する場合は、この手順を繰り返す必要があります。

同様に、エイリアスもクラスター内のすべてのノードに対して固有となるよう設定する場合は、同じ手順でクラスター内の各ノードの /etc/multipath.conf ファイルが同じになるようにします。

1 つのマシンの multipath.conf ファイルで、マルチパスデバイスのエイリアスを設定します。
次のコマンドを使って、他のマシンのマルチパスデバイスをすべて無効にします。
```
# systemctl stop multipathd.service
# multipath -F
```
そのマシンの /etc/multipath.conf ファイルを、クラスター内にある他のすべてのマシンにコピーします。
先ほど multipathd デーモンを無効にしたすべてのマシンで以下のコマンドを実行して、再度デーモンを有効にします。
```
# systemctl start multipathd.service
```

新しいデバイスを追加する場合は、この手順を繰り返す必要があります。

2.3. マルチパスデバイスの属性

user_friendly_names オプションや alias オプションの他にも、マルチパスデバイスには多くの属性があります。マルチパス設定ファイルの multipaths セクションに、特定のマルチパスデバイス用のエントリーを作成すると、そのデバイスの属性を変更することができます。マルチパス設定ファイルの multipaths セクションについての詳細は「設定ファイルの multipaths セクション」を参照してください。

2.4. 論理ボリューム内のマルチパスデバイス

マルチパスデバイスを作成した後、LVM 物理ボリュームを作成するときに物理デバイス名を使用するのと同じように、マルチパスデバイス名を使用できます。例えば、マルチパスデバイスの名前が /dev/mapper/mpath0 の場合は、以下のコマンドを実行すると /dev/mapper/mpatha が物理ボリュームとして認識されます。

pvcreate /dev/mapper/mpatha

他の LVM 物理デバイスを使用するのと同じように、LVM ボリュームグループを作成するときに、作成された LVM 物理デバイスを使用できます。

注記

複数のパーティションが設定されたデバイス全体に LVM 物理ボリュームを作成しようとすると、pvcreate コマンドは失敗します。特に指定しない限り、Anaconda や Kickstart インストールプログラムは、すべてのブロックデバイスに対して空のパーティションテーブルを作成するので注意してください。パーティションではなくデバイス全体を使用したい場合には、そのデバイスから既存のパーティションを削除する必要があります。既存パーティションの削除には、kpartx -d や fdisk のコマンドを使用できます。システムに 2TB 以上のブロックデバイスがある場合は、parted コマンドを使用してパーティションを削除します。

複数の物理デバイスで、active/passive のアレイを設定しマルチパスを使用する LVM 論理ボリュームを作成する場合は、/etc/lvm/lvm.conf ファイルにフィルターを追加して、このような複数デバイスで設定されマルチパスを使用するディスクを除外してください。これは、I/O の受信時にアレイがアクティブパスをパッシブパスに自動的に変更する場合に、このようなデバイスにフィルターが設定されていないと、LVM がパッシブパスをスキャンするたびにマルチパスがフェールオーバーおよびフェールバックするためです。passive パスを active パスに変更する際にコマンドを必要とする active/passive アレイの場合、このような状態が発生すると LVM で警告メッセージが表示されます。

LVM 設定ファイル (lvm.conf) ですべての SCSI デバイスをフィルターするには、そのファイルの devices セクションに、以下のフィルターを組み込みます。

filter = [ "r/block/", "r/disk/", "r/sd.*/", "a/.*/" ]

第3章 DM Multipath の設定

本章では、DM Multipath を設定する手順を説明します。これには、以下の手順が含まれます。

DM-Multipath の基本設定
ローカルディスクを無視する
設定ファイルにデバイスを追加する
initramfs ファイルシステムでマルチパスを起動する

3.1. DM Multipath の設定

システムに DM-Multipath をセットアップする前に、システムが更新されており、device-mapper-multipath パッケージがインストールされていることを確認してください。

mpathconf ユーティリティーを使用してマルチパスを設定します。マルチパス設定ファイル /etc/multipath.conf が作成されます。

/etc/multipath.conf ファイルが既に存在する場合は、mpathconf ユーティリティーでファイルを編集します。
/etc/multipath.conf ファイルが存在しない場合は、mpathconf ユーティリティーが /usr/share/doc/device-mapper-multipath-0.4.9/multipath.conf を起動ファイルとして使用します。
/usr/share/doc/device-mapper-multipath-0.4.9/multipath.conf ファイルが存在しない場合は、mpathconf ユーティリティーにより /etc/multipath.conf ファイルがゼロから作成されます。

mpathconf ユーティリティーの詳細は、mpathconf(8) の man ページを参照してください。

/etc/multipath.conf ファイルを編集する必要がない場合は、以下のコマンドを実行すると、基本的なフェイルオーバー設定用の DM-Multipath をセットアップすることができます。このコマンドでマルチパス設定が有効になり、multipathd デーモンが起動されます。

# mpathconf --enable --with_multipathd y

multipathd デーモンを起動する前に/etc/multipath.conf ファイルを編集する必要がある場合は、以下の手順に従い基本的なフェイルオーバー設定用の DM-Multipath をセットアップします。

--enable オプションを指定して mpathconf コマンドを実行します。

# mpathconf --enable

mpathconf コマンドに必要な追加オプションの詳細は、man ページの mpathconf を参照するか、--help オプションを指定して mpathconf コマンドを実行してください。

# mpathconf --help
usage: /sbin/mpathconf <command>

Commands:
Enable: --enable 
Disable: --disable
Set user_friendly_names (Default y): --user_friendly_names <y|n>
Set find_multipaths (Default y): --find_multipaths <y|n> 
Load the dm-multipath modules on enable (Default y): --with_module  <y|n>
start/stop/reload multipathd (Default n): --with_multipathd  <y|n>

必要に応じて /etc/multipath.conf ファイルを編集します。DM-Multipath 用のデフォルト設定はシステムにコンパイルされているため、/etc/multipath.conf ファイルで明示的に指定する必要はありません。
path_grouping_policy のデフォルト値は failover にセットされています。このため、/etc/multipath.conf ファイルを変更する必要はありません。設定ファイル内のデフォルト値の変更に関する詳細は4章DM Multipath 設定ファイルをご覧ください。
設定ファイルの初期デフォルトセクションによりマルチパスデバイス名が mpathn の形式になるよう設定されます。この設定がないと、マルチパスデバイスの WWID がマルチパスデバイスの名前になります。
必要に応じて設定ファイルを保存し、エディターを終了します。
以下のコマンドを実行します。
```
# systemctl start multipathd.service
```

設定ファイルで、user_friendly_names の値を yes に設定したため、マルチパスデバイスが /dev/mapper/mpathn に作成されます。デバイス名を選択したエイリアスに設定する方法は、4章DM Multipath 設定ファイル を参照してください。

ユーザーフレンドリー名を使用しない場合は、次のコマンドを実行します。

# mpathconf --enable --user_friendly_names n

注記

マルチパスデーモンを起動してからマルチパス設定ファイルの編集が必要になった場合は、systemctl reload multipathd.service コマンドを実行して変更を反映する必要があります。

3.2. マルチパスデバイスの作成時にローカルのディスクを無視

ローカルの SCSI カードが内蔵ディスクに搭載されているマシンがあります。DM Multipath をこのようなデバイスで使用することは推奨されません。find_multipaths 設定パラメーターを yes にセットすると、こうしたデバイスをブラックリストに指定する必要がなくなります。find_multipaths 設定パラメーターについては「設定ファイルの defaults セクション」を参照してください。

find_multipaths 設定パラメーターを yes にセットしない場合は、以下の手順に従ってマルチパス設定ファイルを修正すると、マルチパスの設定時にローカルのディスクを無視できます。

どのディスクが内蔵ディスクかを確認し、そのディスクに、ブラックリストとして指定する印を付けます。

以下の例では /dev/sda が内蔵ディスクです。デフォルトのマルチパス設定ファイル内で元々設定されているように、multipath -v2 を実行するとマルチパスマップ内にローカルディスク /dev/sda が表示されます。

この例では、multipath コマンドの -d オプションを指定し、マルチパスデバイスを作成しないドライランであることを示します。multipath コマンドの出力の詳細は、「Multipath コマンドの出力」を参照してください。

# multipath -v2 -d
: SIBM-ESXSST336732LC____F3ET0EP0Q000072428BX1 undef WINSYS,SF2372
size=33 GB features="0" hwhandler="0" wp=undef
`-+- policy='round-robin 0' prio=1 status=undef
  |- 0:0:0:0 sda 8:0  [--------- 

: 3600a0b80001327d80000006d43621677 undef WINSYS,SF2372
size=12G features='0' hwhandler='0' wp=undef
`-+- policy='round-robin 0' prio=1 status=undef
  |- 2:0:0:0 sdb 8:16  undef ready  running
  `- 3:0:0:0 sdf 8:80 undef ready  running

: 3600a0b80001327510000009a436215ec undef WINSYS,SF2372
size=12G features='0' hwhandler='0' wp=undef
`-+- policy='round-robin 0' prio=1 status=undef
  |- 2:0:0:1 sdc 8:32 undef ready  running
  `- 3:0:0:1 sdg 8:96 undef ready  running

: 3600a0b80001327d800000070436216b3 undef WINSYS,SF2372
size=12G features='0' hwhandler='0' wp=undef
`-+- policy='round-robin 0' prio=1 status=undef
  |- 2:0:0:2 sdd 8:48 undef ready  running
  `- 3:0:0:2 sdg 8:112 undef ready  running

: 3600a0b80001327510000009b4362163e undef WINSYS,SF2372
size=12G features='0' hwhandler='0' wp=undef
`-+- policy='round-robin 0' prio=1 status=undef
  |- 2:0:0:3 sdd 8:64 undef ready  running
  `- 3:0:0:3 sdg 8:128 undef ready  running

デバイスマッパーによる /dev/sda のマルチパスマップへのマッピングを阻止するため、/etc/multipath.conf ファイルの blacklist セクションを編集してこのデバイスを追加します。devnode タイプで sda デバイスをブラックリストに指定することもできますが、/dev/sda が再起動後に同じになる保証はないため安全な方法ではありません。個々のデバイスをブラックリストに指定する場合は、そのデバイスの WWID を使用します。
multipath -v2 コマンドに対する出力を見ると、/dev/sda デバイスの WWID は SIBM-ESXSST336732LC____F3ET0EP0Q000072428BX1 になっています。このデバイスをブラックリストに指定する場合は /etc/multipath.conf ファイルに以下の記述を含めます。
```
blacklist {
      wwid SIBM-ESXSST336732LC____F3ET0EP0Q000072428BX1
}
```
/etc/multipath.conf ファイルを更新したら、multipathd デーモンにファイルを再ロードするよう、手動で指示する必要があります。以下のコマンドで、更新した /etc/multipath.conf ファイルを再ロードします。
```
# systemctl reload multipathd.service
```

3.3. ストレージデバイスの設定

DM-Multipath に対応しているストレージアレイで最も一般的なものは、DM-Multipath にデフォルトで含まれています。対応デバイスなど、デフォルトの設定値は、次のいずれかのコマンドを実行して確認してください。

# multipathd show config
# multipath -t

既知のマルチパスデバイスとして、デフォルトではサポートされていないストレージデバイスを追加する必要がある場合は、/etc/multipath.conf ファイルを編集して適切なデバイス情報を記入します。

たとえば、HP Open-V シリーズに関する情報を追加する場合は、以下のようなエントリーを記述します。この例では、すべてのパスに障害が発生した場合には、1 分間 (または 5 秒ごとの再試行で 12 回の再試行を行う) のキュー待ちを行うようにデバイスを設定します。

devices {
        device {
                vendor "HP"
                product "OPEN-V"
                no_path_retry 12
        }
}

設定ファイルの devices セクションの詳細は、「設定ファイルの devices セクション」を参照してください。

3.4. initramfs ファイルシステムでマルチパスの設定

initramfs ファイルシステムでマルチパスを設定することができます。マルチパスの設定後、以下のオプションを追加して dracut を実行すると、マルチパス設定ファイルで initramfs ファイルシステムを再構築できます。

# dracut --force --add multipath

initramfs ファイルシステムからマルチパスを実行してマルチパス設定ファイルに変更を加える場合、変更を有効にするには initramfs ファイルシステムを再構築する必要があります。

第4章 DM Multipath 設定ファイル

DM Multipath では、マルチパスで最も一般的に使用する設定値がデフォルトで提供されています。また DM Multipath に対応する最も一般的なストレージアレイが DM Multipath に含まれています。対応しているデバイスなどのデフォルトの設定値は、以下のいずれかのコマンドを実行して確認してください。

# multipathd show config
# multipath -t

DM-Multipath の設定値は、/etc/multipath.conf 設定ファイルを編集すると無効にできます。必要な場合は、デフォルトでは対応していないストレージアレイを設定ファイルに追加することもできます。

注記

initramfs ファイルシステムでマルチパスの設定を実行することができます。initramfs ファイルシステムからマルチパスを実行してマルチパス設定ファイルに変更を加える場合、変更を有効にするには initramfs ファイルシステムを再構築する必要があります。マルチパスで initramfs ファイルシステムを再構築する方法は、「initramfs ファイルシステムでマルチパスの設定」を参照してください。

本章では、multipath.conf ファイルの解析や変更について説明します。以下のトピックに関する項が含まれます。

設定ファイルの概要
設定ファイルの blacklist セクション
設定ファイルの defaults セクション
設定ファイルの multipaths セクション
設定ファイルの devices セクション

マルチパス設定ファイルで指定するのは、使用状況に応じて必要とされるセクションや、デフォルト値の変更が必要なセクションのみです。使用環境には無関係なファイルのセクションや、デフォルト値を無効にする必要がないファイルのセクションでは、初期ファイルに指定されているコメントアウトを削除する必要はありません。

設定ファイルでは、正規表現の記述構文を使用できます。

設定ファイルの詳細は、man ページの multipath.conf(5) を参照してください。

4.1. 設定ファイルの概要

マルチパス設定ファイルは以下のセクションに分かれています。

blacklist: マルチパス設定の対象として考慮しないデバイスの一覧。
blacklist_exceptions: この例外セクションに指定されていなければ、blacklist セクションのパラメーターに従ってブラックリストに指定されるマルチパスの候補になる一覧。
defaults: DM Multipath のデフォルトの全般設定。
multipaths: マルチパスデバイスの特性に関する個別設定。ここで指定する値は、設定ファイルの defaults と devices のセクションで指定されている値より優先されます。
デバイス: ストレージコントローラーの個別設定。ここで指定する値は、設定ファイル内の defaults セクションで指定されている値より優先されます。デフォルトでは対応していないストレージアレイを使用している場合は、そのアレイ用の devices サブセクションを作成する必要があります。

システムがマルチパスデバイスの属性を決定するとき、まずマルチパス設定をチェックし、次にデバイス設定をチェックしてから、マルチパスシステムのデフォルトを確認します。

4.2. 設定ファイルの blacklist セクション

マルチパス設定ファイルの blacklist セクションには、システムがマルチパスデバイスを設定する際に使用しないデバイスを指定します。ブラックリストに指定したデバイスは、マルチパスデバイスには含まれません。

以前の Red Hat Enterprise Linux のリリースでは、明示的にブラックリストに指定されていないすべてのパスに、マルチパスデバイスの作成を試行していました。Red Hat Enterprise Linux 6 からは、find_multipaths 設定パラメーターを yes に設定すると、マルチパスによるデバイスの作成が、以下の 3 つの条件のうちのいずれかを満たす場合に限られます。

ブラックリストに指定されておらず、同一の WWID を持つパスが少なくとも 2 つある場合。
手動で multipath コマンドを実行して、デバイスを指定して作成を強制している場合。
任意のパスが、以前に作成されたマルチパスデバイスと同一の WWID を持っている場合 (そのマルチパスデバイスがその時点で存在していない場合も含む)。マルチパスデバイスを作成すると、常にそのデバイスの WWID が記憶されるため、同一の WWID を持つパスが検出されると、そのデバイスが自動的に再作成されます。これにより、マルチパスのブラックリストを編集しなくても、マルチパスが自動的に正しいパスを選択してマルチパスデバイスにすることができます。
find_multipaths パラメーターを使用しないでマルチパスデバイスを作成してから、パラメーターを yes に設定し直した場合は、/etc/multipath/wwids ファイルから、マルチデバイスとして作成しないデバイスの WWID を削除しなければならない可能性もあります。以下は、/etc/multipath/wwids ファイルの例を示しています。スラッシュ (/) で囲まれている部分が WWID です。
```
# Multipath wwids, Version : 1.0
# NOTE: This file is automatically maintained by multipath and multipathd.
# You should not need to edit this file in normal circumstances.
#
# Valid WWIDs:
/3600d0230000000000e13955cc3757802/
/3600d0230000000000e13955cc3757801/
/3600d0230000000000e13955cc3757800/
/3600d02300069c9ce09d41c31f29d4c00/
/SWINSYS  SF2372         0E13955CC3757802/
/3600d0230000000000e13955cc3757803/
```

find_multipaths パラメーターを yes に設定すれば、複数のパスがあるにも関わらずマルチパスを設定しないデバイスだけを、ブラックリストに指定する必要があります。そのため、通常はデバイスをブラックリストに指定する必要がありません。

デバイスをブラックリストを指定する必要がある場合は、以下の基準に従って行います。

WWID は、「WWID でブラックリストの指定」を参照してください。
デバイス名で指定する場合は、「デバイス名でブラックリストの指定」を参照してください。
デバイスタイプで指定する場合は、「デバイスタイプでブラックリストの指定」を参照してください。
udev プロパティーで指定する場合は、「udev プロパティーでブラックリストの指定 (Red Hat Enterprise Linux 7.5 以上)」を参照してください。
デバイスプロトコルで指定する場合は、「デバイスプロトコルでブラックリストの指定 (Red Hat Enterprise Linux 7.6 以上)」を参照してください。

デフォルトでは、設定ファイルの初期ブラックリストセクションをコメントアウトした後でも、各種のデバイスタイプがブラックリストに指定されます。詳細は「デバイス名でブラックリストの指定」を参照してください。

4.2.1. WWID でブラックリストの指定

設定ファイルの blacklist セクションで wwid エントリーを使用し、World-Wide IDentification でデバイスをブラックリストに指定できます。

以下の例では、WWID が 26353900f02796769 であるデバイスをブラックリストに指定します。

blacklist {
       wwid 26353900f02796769
}

4.2.2. デバイス名でブラックリストの指定

設定ファイルの blacklist セクションで devnode エントリーを使用し、デバイス名でデバイスタイプをブラックリストに指定し、マルチパスデバイスに含まれないようにできます。

以下の例では、sd* のデバイスをすべてブラックリストに指定することで、すべての SCSI デバイスをブラックリストに指定します。

blacklist {
       devnode "^sd[a-z]"
}

blacklist セクションで devnode エントリーを使用すると、特定タイプに該当する全デバイスではなく、個々のデバイスをブラックリストに指定できます。ただし、デバイスが udev ルールで静的にマッピングされていない限り、再起動後にそのデバイス名が同じ名前になる保証がないため、この方法は推奨できません。再起動すると、デバイス名が /dev/sda から /dev/sdb などに変わる可能性があります。

デフォルトでは、以下の devnode エントリーがデフォルトのブラックリストにコンパイルされています。このエントリーによりブラックリストに指定されるデバイスは、通常 DM Multipath をサポートしません。このようなデバイスでマルチパスを有効にするには、「ブラックリストから除外」の説明に従って、設定ファイルの blacklist_exceptions セクションにデバイスを指定する必要があります。

blacklist {
       devnode "^(ram|raw|loop|fd|md|dm-|sr|scd|st)[0-9]*"
       devnode "^(td|ha)d[a-z]"
}

4.2.3. デバイスタイプでブラックリストの指定

設定ファイルの blacklist セクションに特定のデバイスタイプを指定するには、device セクションを使用します。以下の例では、IBM DS4200 デバイスと HP デバイスをすべてブラックリストに指定します。

blacklist {
       device {
               vendor  "IBM"
               product "3S42"       #DS4200 Product 10
       }
       device {
               vendor  "HP"
               product "*"
       }
}

4.2.4. udev プロパティーでブラックリストの指定 (Red Hat Enterprise Linux 7.5 以上)

multipath.conf 設定ファイルの blacklist セクションおよび blacklist_exceptions セクションは property パラメーターに対応します。このパラメーターを使用すると、ユーザーは特定タイプのデバイスをブラックリストに指定できます。property パラメーターは、デバイスの udev 環境変数名と照合される正規表現の文字列を取ります。

以下の例は、udev プロパティーの ID_ATA プロパティーを持つすべてのデバイスをブラックリストに指定します。

blacklist {
        property "ID_ATA"
}

4.2.5. デバイスプロトコルでブラックリストの指定 (Red Hat Enterprise Linux 7.6 以上)

protocol セクションのある設定ファイルの blacklist セクションに、マルチパス化から除外されるデバイスのプロトコルを指定できます。マルチパスが認識するプロトコル文字列は scsi:fcp、scsi:spi、scsi:ssa、scsi:sbp、scsi:srp、scsi:iscsi、scsi:sas、scsi:adt、scsi:ata、scsi:unspec、ccw、cciss、nvme、および undef です。パスが使用しているプロトコルを表示するには、コマンド multipathd show paths format "%d %P" を実行します。

以下の例は、未定義のプロトコルまたは未知の SCSI トランスポートタイプを持つすべてのデバイスをブラックリストに指定します。

blacklist {
        protocol "scsi:unspec"
        protocol "undef"
}

4.2.6. ブラックリストから除外

設定ファイルの blacklist_exceptions セクションを使用すると、デフォルトではブラックリストに指定されているデバイスで、マルチパスを有効にできます。

例えば、デバイスが多数あり、その中の 1 つのデバイス (以下の例では WWID が 3600d0230000000000e13955cc3757803 のデバイス) でのみマルチパスを有効にしたい場合は、有効にしたいデバイス以外のものを 1 つ 1 つブラックリストに指定するのではなく、一旦すべてのデバイスをブラックリストに指定してから、/etc/multipath.conf ファイルに以下の行を追加すれば、目的のデバイスにだけマルチパスを許可することができます。

blacklist {
        wwid "*"
}

blacklist_exceptions {
        wwid "3600d0230000000000e13955cc3757803"
}

設定ファイルの blacklist_exceptions セクションでデバイスを指定する場合は、blacklist で指定したのと同じ方法で指定しなければなりません。たとえば、blacklist で devnode エントリーを使用してデバイスを指定している場合は、exception で除外指定に使用している WWID が正しくても適用されません。同様に devnode による除外は、devnode エントリーでブラックリストを指定したデバイスにしか適用されず、device による除外は、device エントリーでブラックリストを指定したデバイスにしか適用されません。

property パラメーターの挙動は、他の blacklist_exception パラメーターとは異なります。このパラメーターを設定した場合は、一致する udev 変数がデバイスに必要になります。この変数がないと、デバイスはブラックリストに指定されます。このパラメーターを使用すると、USB スティックやローカルハードドライブなど、マルチパスが無視する必要のある SCSI デバイスをブラックリストに登録できます。合理的にマルチパス化できる SCSI デバイスのみを許可するには、以下の例のようにこのパラメーターを SCSI_IDENT_|ID_WWN) に設定します。

blacklist_exceptions {
        property "(SCSI_IDENT_|ID_WWN)"
}

4.3. 設定ファイルの defaults セクション

/etc/multipath.conf 設定ファイルには defaults セクションがあり、以下のように user_friendly_names パラメーターを yes にセットすることができます。

defaults {
        user_friendly_names yes
}

上記は、user_friendly_names パラメーターのデフォルト値を上書きします。

設定ファイルに defaults のテンプレートが含まれています。このセクションは、以下のようにコメントアウトされています。

#defaults {
#       polling_interval        10
#       path_selector           "round-robin 0"
#       path_grouping_policy    multibus
#       uid_attribute           ID_SERIAL
#       prio                    alua
#       path_checker            readsector0
#       rr_min_io               100
#       max_fds                 8192
#       rr_weight               priorities
#       failback                immediate
#       no_path_retry           fail
#       user_friendly_names     yes
#}

設定パラメーターのデフォルト値を上書きする場合は、このテンプレートの該当行を defaults セクションにコピーして、コメントを外します。たとえば、path_grouping_policy パラメーターを、デフォルト値の failover から multibus に上書きするには、以下のように、テンプレートで該当行を見つけて設定ファイルの defaults セクションにコピーし、そのコメントを外します。

defaults {
        user_friendly_names     yes
        path_grouping_policy    multibus
}

multipath.conf 設定ファイルの defaults セクションに設定する属性を表4.1「マルチパス設定の defaults セクション」で説明します。multipath.conf ファイルの devices および multipaths セクションにおける属性指定で上書きされない限り、これらの値が DM-Multipath で使用されます。

属性説明

polling_interval パスチェックが行われる間隔を秒数で指定します。適正に機能するパスでは、チェックの間隔は (4 * polling_interval) まで徐々に増加します。デフォルト値は 5 です。

multipath_dir 動的共有オブジェクトが保管されるディレクトリーです。デフォルト値はシステムによって異なり、一般的には/lib/multipath になります。

find_multipaths

マルチパスデバイスのセットアップモードを定義します。このパラメーターが yes に設定されていると、マルチパスは、ブラックリスト化されていないパスにはデバイス作成を試行しません。以下にあげる 3 つの条件のいずれかを満たす場合のみ、デバイスを作成します。

- ブラックリストに指定されておらず、同一の WWID を持つパスが少なくとも 2 つある場合

- ユーザーが手動で multipath コマンドを実行し、デバイスを指定して作成を強制している場合

- 任意のパスが、以前に作成されたマルチパスデバイスと同一の WWID を持っている場合。find_multipaths を設定した状態でマルチパスデバイスを作成すると、そのデバイスの WWID が記憶されるため、マルチパスが同一の WWID を持つパスを認識するとすぐに、そのデバイスを自動的に再作成します。これによって、マルチパスのブラックリストを編集しなくても、マルチパスが自動的に正しいパスを選択してマルチパスデバイスにすることができます。find_multipaths パラメーターを設定せずにマルチパスデバイスを既に作成している場合は、「設定ファイルの blacklist セクション」の説明を参照してください。

デフォルト値は no です。ただし、Red Hat Enterprise Linux 7 では、mpathconf が作成するデフォルトの multipath.conf ファイルにより、find_multipaths が有効になります。

reassign_maps デバイスマッパーマップの再割り当てを有効にします。このオプションを使用すると、multipathd デーモンは、既存のデバイスマッパーのマップを、基本的なブロックデバイスではなく、常にマルチパスデバイスに向けるように再マップします。使用可能な値は、yes または no です。デフォルト値は yes です。

verbosity デフォルトの詳細度です。値が高いほど詳細レベルが高くなります。使用できるレベルは 0 から 6 の間です。デフォルト値は 2 です。

path_selector

次回の I/O 動作に使用するパスを決定する、デフォルトのアルゴリズムを指定します。使用できる値を以下に示します。

round-robin 0: パスグループ内の全てのパスをループスルーし、それぞれのパスに同負荷の I/O を送ります。

queue-length 0: 未処理の I/O 要求数が最も少ないパスに、次の I/O 群を送ります。

service-time 0: 推定処理時間が最も短いパスに、次の I/O 群を送ります。推定処理時間は、各パスに対する未処理の I/O の合計サイズを、その相対スループットで割ることにより求められます。

デフォルト値は service-time 0 です。

path_grouping_policy

未指定のマルチパスに適用する、デフォルトのパスグルーピングポリシーを指定します。使用できる値を以下に示します。

failover: 優先グループごとに 1 つのパス。

multibus: 1 つの優先グループ内で有効なすべてのパス。

group_by_serial: 検出されたシリアル番号ごとに 1 つの優先グループ。

group_by_prio: パス優先値ごとに 1 つの優先グループ。優先度はグローバル、コントローラー別、またはマルチパスオプション別に指定されているコールアウトプログラムによって決定されます。

group_by_node_name: ターゲットノード名ごとに 1 つの優先グループ。ターゲットノード名は /sys/class/fc_transport/target*/node_name 内で取得されます。

デフォルト値は failover です。

prio

パスの優先値を得るために呼び出すデフォルトの関数を指定します。例えば、SPC-3 の ALUA ビットは悪用可能な prio 値を提供します。使用できる値を以下に示します。

const: すべてのパスに優先度 1 を設定します。

emc: EMC アレイのパス優先度を生成します。

alua: SCSI-3 ALUA 設定に基づいてパス優先度を生成します。Red Hat Enterprise Linux 7.3 以降、デバイス設定で prio "alua exclusive_pref_bit" を指定すると、マルチパスが pref ビットセットのパスのみを含むパスグループを作成し、このパスグループに最高の優先度を与えるようになります。

ontap: NetApp アレイのパスの優先度を生成します。

rdac: LSI/Engenio RDAC コントローラーのパスの優先度を生成します。

hp_sw: active/standby モードにおける Compaq/HP コントローラー用パスの優先度を生成します。

hds: Hitachi HDS Modular ストレージアレイのパスの優先度を生成します。

デフォルト値は const です。

features

マルチパスデバイスの追加デフォルト機能です。形式は "number_of_features_plus_arguments feature1 ..." となります。

features に使用できる値:

queue_if_no_path: no_path_retry を queue に設定するのと同じです。この機能の使用時に発生する可能性がある問題については「queue_if_no_path 機能に関する問題」を参照してください。

retain_attached_hw_handler: SCSI 層によりハードウェアハンドラーがパスデバイスに接続されている状態で、このパラメーターを yes に設定した場合は、multipath.conf ファイルで指定している hardware_handler の使用をデバイスに強制しません。SCSI 層によるハードウェアハンドラーの接続が行われていない場合は、通常通り、マルチパスで設定されているハードウェアハンドラーの使用が継続されます。デフォルト値は no です。

pg_init_retries n: 失敗するまでパスグループの初期化を最高 n 回再試行します。ここで、1 <= n <= 50 です。

pg_init_delay_msecs n: パスグループの初期化の再試行を、n ミリ秒間隔で待機します。ここで、0 <= n <= 60000 です。

path_checker

パスの状態を判断するのに使用するデフォルトのメソッドを指定します。使用できる値を以下に示します。

readsector0: デバイスの最初のセクターを読み取ります。

tur: デバイスに対して TEST UNIT READY コマンドを発行します。

emc_clariion: EMC Clariion 固有の EVPD ページ 0xC0 の問い合わせを行い、パスを特定します。

hp_sw: Active/Standby のファームウェアを搭載した HP ストレージアレイのパスの状態をチェックします。

rdac: LSI/Engenio RDAC ストレージコントローラーのパス状態をチェックします。

directio: 直接 I/O を使用する最初のセクターを読み取ります。

デフォルト値は directio です。

failback

パスグループのフェイルバックを管理します。

immediate の値を設定すると、active パスを含んでいる最も優先度の高いパスグループに直ちにフェイルバックします。

manual の値を指定すると、フェイルバックはすぐに行われず、オペレーター介入がある場合のみにフェイルバックします。

followover の値を指定すると、パスグループの最初のパスが active になったときに自動フェイルバックを実行します。これにより、別のノードがフェイルオーバーを要求しているときは、ノードが自動的にフェイルバックしなくなります。

0 以上の数値で、フェイルバックの秒単位の遅延を指定します。

デフォルト値は manual です。

rr_min_io 現在のパスグループで、次のパスに切り替えるまでにルーティングする I/O 要求数を指定します。この設定は、2.6.31 より前のカーネルを実行しているシステムにのみ適用されます。2.6.31 以降のシステムには、rr_min_io_rq を使用してください。デフォルト値は 1000 です。

rr_min_io_rq 現在のパスグループで、次のパスに切り替えるまでにルーティングする I/O 要求数を指定します。要求ベースの device-mapper-multipath を使用しています。2.6.31 より前のバージョンのカーネルを実行しているシステムの場合は rr_min_io を使用してください。デフォルト値は 1 です。

rr_weight priorities に設定すると、次のパスを選択するために selector を呼び出すまで、rr_min_io リクエストをパスに送信する代わりに、送信するリクエスト数が、prio 関数のように、パスの優先度の rr_min_io 倍で決められます。uniform に設定すると、すべてのパスの重みが等しくなります。デフォルト値は uniform です。

no_path_retry

障害の発生したパスの使用を何回試行してからキュー待ちを無効にするか、その回数を指定します。

fail を指定すると、キュー待ちはせず直ちに失敗します。

queue を指定すると、パスが修復されるまでキュー待ちは停止しません。

デフォルト値は 0 です。

user_friendly_names yes に設定すると、/etc/multipath/bindings ファイルを使った永続的で固有となるエイリアスが、mpathn の形式でマルチパスに割り当てられます。no に設定すると、WWID がマルチパスのエイリアスに使用されます。ただし、設定ファイルの multipaths セクションで指定されるデバイス固有のエイリアスの方が、ここでの設定よりも優先されることになります。デフォルト値は no です。

queue_without_daemon no に設定すると、multipathd デーモンにより、シャットダウン時にすべてのデバイスのキュー待ちが無効になります。デフォルト値は no です。

flush_on_last_del yes に設定すると、デバイスへの最後のパスが削除された時点で、multipathd デーモンがキュー待ちを無効にします。デフォルト値は no です。

max_fds マルチパスおよび multipathd デーモンで開くことが可能な、オープンファイル記述子の最大数をセットします。これは、ulimit -n コマンドに相当します。Red Hat Enterprise Linux 6.3 リリース以降、デフォルト値は max になっています。つまり、/proc/sys/fs/nr_open に記述されたシステムの上限に設定されます。これより前のリリースでは、値を設定しないと、オープンファイル記述子の最大数は呼び出しのプロセスが取得し、通常は 1024 です。この数が 1024 を超える場合は、念のため、パスの最大数に 32 を加えた数を設定してください。

checker_timeout 明示的なタイムアウトで、SCSI コマンドを発行するパス checker および prioritizer に使用するタイムアウト (秒) です。デフォルト値は sys/block/sdx/device/timeout から取得します。

fast_io_fail_tmo FC リモートポートで問題を検出してから、そのリモートポートでデバイスへの I/O が失敗するまでの scsi 層の待機時間 (秒) です。この値は dev_loss_tmo よりも小さくすることをお勧めします。これを off に設定すると、タイムアウトが無効になります。デフォルト値は OS により決定されます。fast_io_fail_tmo オプションは、recovery_tmo および replacement_timeout オプションの値を上書きします。詳細は、「iSCSI および DM Multipath のオーバーライド」を参照してください。

dev_loss_tmo FC リモートポート上で問題を検出してから、システムから削除されるまでの scsi 層の待機時間 (秒) です。無限に設定する場合は、2147483647 秒または 68 年に設定します。デフォルト値は OS により決定されます。

hw_string_match

multipath.conf ファイルの devices セクション内の各デバイス設定から独自のデバイス設定を作成するか、組み込みデバイス設定の 1 つを修正します。hw_string_match を yes に設定すると、ユーザーのデバイス設定内のベンダー、製品、およびリビジョンの文字列が、組み込みのデバイス設定の文字列と完全に一致する場合には、組み込みの設定がユーザー設定オプションで修正されます。完全に一致しない場合、ユーザーのデバイス設定は新しい設定として処理されます。hw_string_match を no に設定すると、文字列による一致ではなく正規表現による一致が使用されます。

hw_string_match パラメーターは、デフォルトで no に設定されます。

retain_attached_hw_handler SCSI 層で、ハードウェアハンドラーがパスデバイスに接続されている状態で、このパラメーターを yes に設定した場合は、multipath.conf ファイルで指定している hardware_handler の使用をデバイスに強制しません。SCSI 層によるハードウェアハンドラーの接続が行われていない場合は、通常通り、マルチパスで設定されているハードウェアハンドラーの使用が継続されます。デフォルト値は no です。

detect_prio yes に設定すると、デバイスで ALUA に対応しているかを最初にチェックします。対応している場合は、alua prioritizer をデバイスに割り当てます。デバイスが ALUA に対応していない場合は、通常通り prioritizer の特定を行います。デフォルト値は no です。

uid_attribute 固有のパス識別子を与えます。デフォルト値は ID_SERIAL です。

force_sync (Red Hat Enterprise Linux Release 7.1 以降)yes に設定すると、パスチェッカーは非同期モードで実行しません。つまり、一度に実行されるチェッカーは 1 つのみになります。これは、複数の multipathd チェッカーが並行して実行されていて、CPU に大きなプレッシャーをかけている場合に便利です。デフォルト値は no です。

delay_watch_checks (Red Hat Enterprise Linux Release 7.2 以降) 0 よりも大きい値に設定すると、multipathd デーモンは、指定されたチェック回数の間、有効なパスを監視します。監視されているパスが再び失敗すると、パスが次に有効になったときに、delay_wait_checks で指定された連続的なチェック回数の間保持されるまで使用されません。これにより、信用できないパスがオンラインに戻ったときにすぐに使用されることを防ぐことができます。デフォルト値は no です。

delay_wait_checks (Red Hat Enterprise Linux Release 7.2 以降) 0 よりも大きい値に設定すると、オンラインに戻ったデバイスが、delay_watch_checks で指定されたチェック回数内に再び失敗し、次にオンラインに戻るときに、デバイスはマークされ、遅延が発生します。デバイスは、delay_wait_checks で指定されたチェック回数が経過するまで使用されません。デフォルト値は no です。

ignore_new_boot_devs (Red Hat Enterprise Linux Release 7.2 以降) yes に設定すると、ブートの初期段階でノードが initramfs ファイルシステムに存在しているときに、WWID が /etc/multipath/wwids の initramfs copy に存在していないデバイスは、マルチパスによって作成されません。この機能は、インストール中のブートに使用できます (マルチパスが、udev ルールによって最初に現れたときに要求しなかったデバイスに、設定を自ら試行する場合)。このパラメーターは yes または no に設定できます。設定しない場合は、デフォルトで no に設定されます。

retrigger_tries、retrigger_delay (Red Hat Enterprise Linux Release 7.2 以降) retrigger_tries パラメーターと retrigger_delay パラメーターは、udev が元の uevents の処理に完全に失敗し、マルチパスでデバイスを使用できなくなった場合に、multipathd が uevents を再トリガーするために使用されます。retrigger_tries パラメーターは、デバイスが完全にセットアップされていない場合にマルチパスが uevent の再トリガーを試行する回数を設定します。retrigger_delay パラメーターは、再試行の間隔 (秒) を設定します。これら両方のオプションではゼロ以上の数値を使用できます。retrigger_tries パラメーターをゼロに設定すると、再試行が無効になります。retrigger_delay パラメーターをゼロに設定すると、パスチェッカーの次のループで uevent が再発行されます。retrigger_tries パラメーターが設定されていない場合は、デフォルトで 3 に設定されます。retrigger_delay パラメーターが設定されていない場合は、デフォルトで 10 に設定されます。

new_bindings_in_boot (Red Hat Enterprise Linux Release 7.2 以降) new_bindings_in_boot パラメーターは、通常のファイルシステムのバインディングファイルによりすでに提供されている user_friendly_name を、マルチパスが initramfs ファイルシステムで提供しないようにするために使用されます (initramfs ファイルシステムが再作成された場合にのみ、initramfs ファイルシステムの user_friendly_names バインディングが同期されるため発生する可能性がある問題)。このパラメーターを no に設定すると、マルチパスは initramfs ファイルシステムに新しいバインディングを作成しません。デバイスで /etc/multipath/bindings の initramfs コピーにバインディングがない場合、マルチパスは WWID をエイリアスとして使用し、user_friendly_name を提供しません。ブートの後半で、ノードが通常のファイルシステムをマウントした後で、マルチパスはデバイスに user_friendly_name を提供します。このパラメーターは yes または no に設定できます。設定しない場合は、デフォルトで no に設定されます。

config_dir (Red Hat Enterprise Linux Release 7.2 以降) "" 以外の値に設定すると、マルチパスは、このディレクトリーで ".conf" で終わるファイルをアルファベット順に検索し、まるで設定情報が /etc/multipath.conf ファイルに存在するかのように、それらのファイルから設定情報を読み取ります。これにより、マシンごとに固有の設定ファイル以外に、マシン間で共有する 1 つの主要設定を持つことができます。config_dir パラメーターは、"" または完全修飾ディレクトリー名のいずれかにする必要があります。このパラメーターは主要な /etc/multipath.conf ファイルでのみ設定でき、config_dir ファイルに指定されたファイルには設定できません。デフォルト値は /etc/multipath/conf.d です。

deferred_remove yes に設定すると、multipathd は最終パスデバイスが削除されるときに通常の削除ではなく遅延された削除を行います。これにより、通常の削除が行われ、削除に失敗したときに multipathed デバイスが使用中である場合、デバイスは最終ユーザーがデバイスを終了したときに自動的に削除されます。デフォルト値は no です。

log_checker_err once に設定すると、multipathd は、最初のパスチェッカーエラーを詳細レベル 2 でログに記録します。以降のすべてのエラーは、デバイスが復元されるまで詳細レベル 3 でログに記録されます。always に設定されている場合、multipathd は、常に詳細レベル 2 でパスチェッカーエラーをログに記録します。デフォルト値は always です。

skip_kpartx (Red Hat Enterprise Linux Release 7.3 以降) yes に設定すると、kpartx は自動的にデバイスにパーティションを作成しません。これにより、デバイスにパーティションテーブルがある場合でも、パーティションを作成せずにマルチパスデバイスを作成することができます。このオプションのデフォルト値は no です。

max_sectors_kb (Red Hat Enterprise Linux リリース 7.4 およびそれ以降では) マルチパスデバイスの初回アクティベート時の前に、max_sectors_kb デバイスキューパラメーターを、マルチパスデバイスのすべての基礎的なパスで指定された値に設定します。マルチパスデバイスの作成時には、デバイスはパスデバイスから max_sectors_kb 値を継承します。手動でこの値をマルチパスデバイス向けに高めたり、パスデバイス向けにこの値を低くすると、マルチパスデバイスはパスデバイスが許可するよりも大きな I/O 操作を作成する場合があります。max_sectors_kb パラメーターを使用すると、パスデバイス上にマルチパスデバイスを作成する前に容易にこれらの値が設定でき、無効なサイズの I/O 操作が渡されることを回避できます。このパラメーターを設定しないと、パスデバイスではデバイスドライバーがこれを設定し、マルチパスデバイスがパスデバイスからこれを継承します。

remove_retries (Red Hat Enterprise Linux Release 7.4 以降) マルチパスが、使用中のデバイスを削除するのを試行する回数を設定します。一度試行してから次の試行が行われるまで、マルチパスは 1 秒スリープ状態となります。デフォルトの値は 0 で、マルチパスは削除を試行しません。

disable_changed_wwids (Red Hat Enterprise Linux Release 7.4 以降) yes に設定した場合は、マルチパスデバイスを設定しているパスデバイスの WWID が変更すると、パスの WWID がマルチパスデバイスの WWID に復元されるまで、マルチパスがパスデバイスへのアクセスを無効にします。デフォルト値は no で、パスの WWID が変更したかどうかを確認しません。

detect_path_checker (Red Hat Enterprise Linux Release 7.4 以降) yes に設定すると、マルチパスにより、デバイスが ALUA に対応しているかどうかが確認されます。対応している場合は、tur パスチェッカーが自動的に使用されます。対応していない場合は、通常通りに path_checker が選択されます。デフォルト値は no です。

reservation_key

これは、mpathpersist によって使用されるサービスアクション予約キーです。永続予約を使用するすべてのマルチパスデバイスに設定する必要があり、PERSISTENT RESERVE OUT パラメーターリストの RESERVATION KEY フィールドと同じである必要があります。これには、I_T ネクサスを特定するために、アプリケーションクライアントがデバイスサーバーに提供した 8 バイトの値が含まれます。mpathpersist でキーを登録する際に --param-aptpl オプションが使用される場合、:aptpl を予約キーの最後に追加する必要があります。

Red Hat Enterprise Linux 7.5 より、このパラメーターを file に設定できるようになりました。これにより、prkeys ファイルで mpath‐persist によって登録された RESERVATION KEY が保存されます。その後、multipathd デーモンはこのキーを使用して、表示されるように追加のパスを登録します。登録が削除されると、RESERVATION KEY は prkeys ファイルから削除されます。これは、デフォルトで未設定になっています。

prkeys_file (Red Hat Enterprise Linux 7.5 以上のリリース) prkeys ファイルの完全パス名です。これは、reservation_key パラメーターが file に設定されたときに、特定の WWID に使用された予約キーを追跡するために multipathd デーモンに使用されます。デフォルト値は /etc/multipath/prkeys です。

all_tg_pt (Red Hat Enterprise Linux 7.6 以上のリリース) このオプションを yes に設定すると、mpathpersist がキーを設定するときに、1 つのホストから 1 つのターゲットポートに登録されたキーを 1 つのホストからすべてのターゲットポート向けとして処理します。1 つのターゲットに 1 つのホストではなく、1 つのホストからすべてのターゲットポートで登録キーを自動的に設定および消去するアレイで mpathpersist を適切に使用するには、yes に設定する必要があります。デフォルト値は no です。

4.4. 設定ファイルの multipaths セクション

multipath.conf 設定ファイルの multipaths セクションで各特定マルチパスデバイスに対して設定できる属性を表4.2「Multipaths の属性」に示します。属性が適用されるのは、指定したマルチパスデバイスのみです。デフォルト値が DM-Multipath によって使用され、multipath.conf ファイルの defaults と devices セクションに設定した属性より優先されます。

属性説明

wwid multipath 属性を適用するマルチパスデバイスの WWID を指定します。このパラメーターは、multipath.conf ファイルのこのセクションに必須となります。

alias multipath 属性が適用されるマルチパスデバイスのシンボリック名を指定します。user_friendly_names を使用する場合には、この値を mpathn に設定しないでください。設定すると、自動的に割り当てられる user_friendly_names と競合してしまうため、誤ったデバイスノード名が与えられる可能性があります。

path_grouping_policy

未指定のマルチパスに適用する、デフォルトのパスグルーピングポリシーを指定します。使用できる値を以下に示します。

failover = 優先グループごとに 1 つのパス

multibus = 1 つの優先グループで有効なすべてのパス

group_by_serial = 検出されたシリアル番号ごとに 1 つの優先グループ

group_by_prio = パス優先値ごとに 1 つの優先グループ

group_by_node_name = ターゲットノード名ごとに 1 つの優先グループ

path_selector

次回の I/O 動作に使用するパスを決定する、デフォルトのアルゴリズムを指定します。使用できる値を以下に示します。

round-robin 0: パスグループ内の全てのパスをループスルーし、それぞれのパスに同負荷の I/O を送ります。

queue-length 0: 未処理の I/O 要求数が最も少ないパスに、次の I/O 群を送ります。

failback

パスグループのフェイルバックを管理します。

immediate の値を設定すると、active パスを含んでいる最も優先度の高いパスグループに直ちにフェイルバックします。

manual の値を指定すると、フェイルバックはすぐに行われず、オペレーター介入がある場合のみにフェイルバックします。

0 以上の数値で、フェイルバックの秒単位の遅延を指定します。

prio

const: すべてのパスに優先度 1 を設定します。

emc: EMC アレイのパス優先度を生成します。

ontap: NetApp アレイのパスの優先度を生成します。

rdac: LSI/Engenio RDAC コントローラーのパスの優先度を生成します。

hp_sw: active/standby モードにおける Compaq/HP コントローラー用パスの優先度を生成します。

hds: Hitachi HDS Modular ストレージアレイのパスの優先度を生成します。

features

マルチパスデバイスの追加デフォルト機能です。形式は "number_of_features_plus_arguments feature1 ..." となります。

features に使用できる値:

pg_init_retries n: 失敗するまでパスグループの初期化を最高 n 回再試行します。ここで、1 <= n <= 50 です。

pg_init_delay_msecs n: パスグループの初期化の再試行を、n ミリ秒間隔で待機します。ここで、0 <= n <= 60000 です。

no_path_retry

障害の発生したパスの使用を何回試行してからキュー待ちを無効にするか、その回数を指定します。

fail を指定すると、キュー待ちはせず直ちに失敗します。

queue を指定すると、パスが修復されるまでキュー待ちは停止しません。

flush_on_last_del yes に設定すると、デバイスへの最後のパスが削除された時点でキュー待ちを無効にします。

max_sectors_kb (Red Hat Enterprise Linux リリース 7.4 およびそれ以降では) マルチパスデバイスの初回アクティベート時の前に、max_sectors_kb デバイスキューパラメーターを、マルチパスデバイスのすべての基礎的なパスで指定された値に設定します。マルチパスデバイスの作成時には、デバイスはパスデバイスから max_sectors_kb 値を継承します。手動でこの値をマルチパスデバイス向けに高めたり、パスデバイス向けにこの値を低くすると、マルチパスデバイスはパスデバイスが許可するよりも大きな I/O 操作を作成する場合があります。max_sectors_kb パラメーターを使用すると、パスデバイス上にマルチパスデバイスを作成する前に容易にこれらの値が設定でき、無効なサイズの I/O 操作が渡されることを回避できます。ユーザーがこのパラメーターを設定しないと、パスデバイスはデバイスドライバーにこれを設定させ、マルチパスデバイスがパスデバイスからこれを継承します。

reservation_key

Red Hat Enterprise Linux 7.5 より、このパラメーターを file に設定できるようになりました。これにより、prkeys_file ファイルで mpath‐persist によって登録された RESERVATION KEY が保存されます。その後、multipathd デーモンはこのキーを使用して、表示されるように追加のパスを登録します。登録が削除されると、RESERVATION KEY は prkeys_file ファイルから削除されます。

設定ファイルで、2 つの特定マルチパスデバイスに対して multipath 属性を指定している例を以下に示します。1 つ目のデバイスの WWID は 3600508b4000156d70001200000b0000 で、シンボリック名は yellow です。

2 番目のマルチパスデバイスの WWID は 1DEC_____321816758474 で、シンボリック名 red があります。rr_weight 属性は priorities に設定されています。

multipaths {
       multipath {
              wwid                  3600508b4000156d70001200000b0000
              alias                 yellow
              path_grouping_policy  multibus
              path_selector         "round-robin 0"
              failback              manual
              rr_weight             priorities
              no_path_retry         5
       }
       multipath {
              wwid                  1DEC_____321816758474
              alias                 red
              rr_weight             priorities
        }
}

4.5. 設定ファイルの devices セクション

multipath.conf 設定ファイルの devices セクションでストレージデバイスごとに設定できる属性を表4.3「デバイス属性」に示します。そのデバイスを含むパスでは、multipath.conf ファイルの multipaths セクションに指定されている属性で上書きされない限り、この属性が使用されます。この属性は、multipath.conf ファイルの defaults セクションに設定されている属性より優先されます。

マルチパスに対応しているデバイスの多くは、デフォルトでマルチパスの設定に含まれています。対応デバイスなど、デフォルトの設定値は、次のいずれかのコマンドを実行して確認してください。

# multipathd show config
# multipath -t

おそらく、こうしたデバイスの値を修正する必要はありませんが、必要が生じた場合は、設定ファイルにエントリーを追加すればデフォルト値を上書きできます。multipathd show config コマンドが表示する、目的のデバイスのデフォルト値をコピーして、変更したい値に書き換えることができます。

設定ファイルのこのセクションに、デフォルトでは自動で設定されないデバイスを追加する場合は、vendor パラメーターおよび product パラメーターを設定する必要があります。値は /sys/block/device_name/device/vendor と /sys/block/device_name>/device/model で検索できます。device_name は、マルチパス設定対象のデバイスです。以下に例を示します。

# cat /sys/block/sda/device/vendor
WINSYS  
# cat /sys/block/sda/device/model
SF2372

追加で指定するパラメーターは、使用するデバイスにより異なります。デバイスが active/active の場合は通常、追加でパラメーターを設定する必要はありません。path_grouping_policy を multibus に設定することもできます。表4.3「デバイス属性」で説明されているように、設定が必要となる可能性があるパラメーターは、no_path_retry および rr_min_io です。

デバイスが active/passive であるにも関わらず、I/O を持つパスが自動的に passive パスに切り替えられる場合は、チェッカーの関数を、I/O をパスに送信しない関数に変更し、それが正しく動作するかどうかを検証する必要があります (これを行わないとデバイスはフェイルオーバーし続けます)。つまり、ほとんどの場合は、path_checker を tur に設定するということになります。この設定は、Test Unit Ready コマンドに対応するすべての SCSI デバイスで機能します。Test Unit Ready コマンドは大半のデバイスで対応しています。

パスの切り替えに特殊なコマンドを必要とするデバイスにマルチパスを設定するには、ハードウェアハンドラーカーネルモジュールが必要になります。現在、利用可能なハードウェアハンドラーは emc です。このハンドラーが目的のデバイスに使用できない場合は、そのデバイスにマルチパスを設定できない可能性があります。

属性説明

vendor device 属性が適用されるストレージデバイスのベンダー名 (例: COMPAQ) を指定します。

product device 属性が適用されるストレージデバイスの製品名 (例: HSV110 (C)COMPAQ) を指定します。

revision ストレージデバイスの製品リビジョン識別子を指定します。

product_blacklist 製品別にデバイスをブラックリスト指定するのに使用する正規表現を指定します。

alias_prefix デフォルトの "mpath" の代わりに、このデバイスタイプに使用する user_friendly_names 接頭辞。

hardware_handler

パスグループの切り替えや I/O エラーの処理時に、ハードウェア固有の動作を行うのに使用するモジュールを指定します。使用できる値を以下に示します。

1 emc: EMC ストレージアレイ用のハードウェアハンドラーです。

1 alua: SCSI-3 ALUA アレイ用のハードウェアハンドラーです。

1 hp_sw: Compaq/HP コントローラー用のハードウェアハンドラーです。

1 rdac: LSI/Engenio RDAC コントローラー用のハードウェアハンドラーです。

path_grouping_policy

未指定のマルチパスに適用する、デフォルトのパスグルーピングポリシーを指定します。使用できる値を以下に示します。

failover = 優先グループごとに 1 つのパス

multibus = 1 つの優先グループで有効なすべてのパス

group_by_serial = 検出されたシリアル番号ごとに 1 つの優先グループ

group_by_prio = パス優先値ごとに 1 つの優先グループ

group_by_node_name = ターゲットノード名ごとに 1 つの優先グループ

path_selector

次回の I/O 動作に使用するパスを決定する、デフォルトのアルゴリズムを指定します。使用できる値を以下に示します。

round-robin 0: パスグループ内の全てのパスをループスルーし、それぞれのパスに同負荷の I/O を送ります。

queue-length 0: 未処理の I/O 要求数が最も少ないパスに、次の I/O 群を送ります。

path_checker

パスの状態を判断するのに使用するデフォルトのメソッドを指定します。使用できる値を以下に示します。

readsector0: デバイスの最初のセクターを読み取ります。

tur: デバイスに対して TEST UNIT READY を発行します。

emc_clariion: EMC Clariion 固有の EVPD ページ 0xC0 の問い合わせを行い、パスを特定します。

hp_sw: Active/Standby のファームウェアを搭載した HP ストレージアレイのパスの状態をチェックします。

rdac: LSI/Engenio RDAC ストレージコントローラーのパスの状態をチェックします。

directio: 直接 I/O を使用する最初のセクターを読み取ります。

features

マルチパスデバイスの追加デフォルト機能です。形式は "number_of_features_plus_arguments feature1 ..." となります。

features に使用できる値:

pg_init_retries n: 失敗するまでパスグループの初期化を最高 n 回再試行します。ここで、1 <= n <= 50 です。

pg_init_delay_msecs n: パスグループの初期化の再試行を、n ミリ秒間隔で待機します。ここで、0 <= n <= 60000 です。

prio

const: すべてのパスに優先度 1 を設定します。

emc: EMC アレイのパス優先度を生成します。

ontap: NetApp アレイのパスの優先度を生成します。

rdac: LSI/Engenio RDAC コントローラーのパスの優先度を生成します。

hp_sw: active/standby モードにおける Compaq/HP コントローラー用パスの優先度を生成します。

hds: Hitachi HDS Modular ストレージアレイのパスの優先度を生成します。

failback

パスグループのフェイルバックを管理します。

immediate の値を設定すると、active パスを含んでいる最も優先度の高いパスグループに直ちにフェイルバックします。

manual の値を指定すると、フェイルバックはすぐに行われず、オペレーター介入がある場合のみにフェイルバックします。

0 以上の数値で、フェイルバックの秒単位の遅延を指定します。

no_path_retry

障害の発生したパスの使用を何回試行してからキュー待ちを無効にするか、その回数を指定します。

fail を指定すると、キュー待ちはせず直ちに失敗します。

queue を指定すると、パスが修復されるまでキュー待ちは停止しません。

fast_io_fail_tmo FC リモートポートで問題を検出してから、そのリモートポートでデバイスへの I/O が失敗するまでの scsi 層の待機時間 (秒) です。この値は dev_loss_tmo よりも小さくすることをお勧めします。これを off に設定すると、タイムアウトが無効になります。fast_io_fail_tmo オプションは、recovery_tmo および replacement_timeout オプションの値を上書きします。詳細は、「iSCSI および DM Multipath のオーバーライド」を参照してください。

dev_loss_tmo FC リモートポート上で問題を検出してから、システムから削除されるまでの scsi 層の待機時間 (秒) です。この値を無制限に設定するには 2147483647 秒または 68 年に設定します。

flush_on_last_del yes に設定すると、デバイスへの最後のパスが削除された時点で、multipathd デーモンがキュー待ちを無効にします。

detect_prio yes に設定すると、デバイスで ALUA に対応しているかを最初にチェックします。対応している場合は、alua prioritizer をデバイスに割り当てます。デバイスが ALUA に対応していない場合は、通常通り prioritizer の特定を行います。

uid_attribute 固有のパス識別子を与えます。

max_sectors_kb (Red Hat Enterprise Linux リリース 7.4 およびそれ以降では) マルチパスデバイスの初回アクティベート時の前に、max_sectors_kb デバイスキューパラメーターを、マルチパスデバイスのすべての基礎的なパスで指定された値に設定します。マルチパスデバイスの作成時には、デバイスはパスデバイスから max_sectors_kb 値を継承します。手動でこの値をマルチパスデバイス向けに高めたり、パスデバイス向けにこの値を低くすると、マルチパスデバイスはパスデバイスが許可するよりも大きな I/O 操作を作成する場合があります。max_sectors_kb パラメーターを使用すると、パスデバイス上にマルチパスデバイスを作成する前に容易にこれらの値が設定でき、無効なサイズの I/O 操作が渡されることを回避できます。ユーザーがこのパラメーターを設定しないと、パスデバイスはデバイスドライバーにこれを設定させ、マルチパスデバイスがパスデバイスからこれを継承します。

all_devs このパラメーターを yes に設定すると、このデバイス設定に指定されたすべてのオプションによって、他のデバイス設定すべてのオプションの値 (設定ファイルの値とデフォルトの値両方) がオーバーライドされます。

マルチパス設定ファイルの device エントリーの例を以下に示します。

#	}
#	device {
#		vendor			"COMPAQ  "
#		product			"MSA1000         "
#		path_grouping_policy	multibus
#		path_checker		tur
#		rr_weight		priorities
#	}
#}

以下の設定は、すべての内蔵デバイス設定に対して no_path_retry を fail に設定します。

devices {
	device {
		all_devs yes
		no_path_retry fail
	}
}

4.6. iSCSI および DM Multipath のオーバーライド

recovery_tmo sysfs オプションは、特定の iSCSI デバイスのタイムアウトを制御します。次のオプションは、システム全体の recovery_tmo 値を上書きします。

replacement_timeout 設定オプションは、システム全体で全 iSCSI デバイスの recovery_tmo 値を上書きします。
DM Multipath が管理するすべての iSCSI デバイスで、DM Multipath の fast_io_fail_tmo オプションは、システム全体の recovery_tmo 値を上書きします。DM Multipath の fast_io_fail_tmo オプションは、ファイバーチャネルデバイスの fast_io_fail_tmo オプションを上書きします。
DM Multipath の fast_io_fail_tmo オプションは replacement_timeout よりも優先します。Red Hat は、DM Multipath が管理するデバイスで replacement_timeout を使用して recovery_tmo を上書きすることは推奨していません。これは、DM Multipath が常に recovery_tmo を multipathd サービスが再読み込みするためです。

第5章 DM Multipath の管理とトラブルシューティング

この章では、稼働中のシステムで DM-Multipath を管理する方法について説明します。

5.1. Multipath Helper で自動設定ファイルの生成

Red Hat Enterprise Linux で、Multipath Helper アプリケーションを使用して、マルチパスデバイス用の基本的な設定を生成できます。このアプリケーションでは、カスタムエイリアスとデバイスブラックリストのマルチパス設定や、個々のマルチパスデバイスの特性向け設定を作成できます。作業が完了したら、アプリケーションで、選択した設定パラメーターを含むインストールスクリプトを生成し、確認のための multipath.conf 設定ファイルが提供されます。

Multipath Helper アプリケーションは、https://access.redhat.com/labsinfo/multipathhelper にあります。

5.2. オンラインのマルチパスデバイスのサイズ変更

オンラインのマルチパスデバイスのサイズを変更する必要がある場合は、以下の手順に従ってください。

物理デバイスのサイズを変更します。
次のコマンドを実行して、LUN へのパスを検索します。
```
# multipath -l
```
パスのサイズを変更します。SCSI デバイスの場合、デバイスの rescan ファイルに 1 と書き込むと、SCSI ドライバーによる再スキャンが行われます。以下にコマンドの例を示します。
```
# echo 1 > /sys/block/path_device/device/rescan 
```
各パスデバイスに対してこのコマンドを実行します。たとえば、パスデバイスが sda、sdb、sde、および sdf の場合は、次のコマンドを実行します。
```
# echo 1 > /sys/block/sda/device/rescan
# echo 1 > /sys/block/sdb/device/rescan
# echo 1 > /sys/block/sde/device/rescan
# echo 1 > /sys/block/sdf/device/rescan
```
multipathd resize コマンドを実行して、マルチパスデバイスのサイズを変更します。
```
# multipathd resize map multipath_device
```
ファイルシステムのサイズを変更します (LVM または DOS のパーティションが使用されていないことを前提とします)。
```
# resize2fs /dev/mapper/mpatha
```

5.3. root ファイルシステムを、シングルパスデバイスからマルチパスデバイスへ移行

シングルパスのデバイスにシステムをインストールしてから、別のパスを root ファイルシステムに追加する場合は、root ファイルシステムをマルチパスのデバイスに移行する必要があります。本セクションでは、シングルパスからマルチパスのデバイスへの移行手順を説明します。

device-mapper-multipath パッケージがインストールされていることを確認した上で、以下の手順を実行します。

以下のコマンドを実行して /etc/multipath.conf 設定ファイルを作成、マルチパスモジュールをロードして multipathd の chkconfig を on に設定します。
```
# mpathconf --enable
```
mpathconf コマンドを使ったマルチパスの設定に関する詳細は「DM Multipath の設定」を参照してください。
find_multipaths 設定パラメーターが yes に設定されていない場合は、「設定ファイルの blacklist セクション」の説明に従って、/etc/multipath.conf ファイルの blacklist および blacklist_exceptions セクションを編集します。
検出され次第、root デバイスにマルチパスデバイスを構築させるため、次のコマンドを実行します。また、このコマンドを実行すると、パスが 1 つしかない場合でも必ず find_multipaths がデバイスを許可するようになります。
```
# multipath -a root_devname
```
たとえば root デバイスが /dev/sdb の場合は次のコマンドを実行します。
```
# multipath -a /dev/sdb
wwid '3600d02300069c9ce09d41c4ac9c53200' added
```
設定ファイルの設定が正しく行われたことを確認するため、multipath コマンドを実行して、次のような行が出力されていることを検索します。これは、コマンドがマルチパスデバイスの作成に失敗したことを示しています。
```
date  wwid: ignoring map
```
たとえば、デバイスの WWID が 3600d02300069c9ce09d41c4ac9c53200 の場合は、次のような行が出力に表示されます。
```
# multipath
Oct 21 09:37:19 | 3600d02300069c9ce09d41c4ac9c53200: ignoring map
```
dracut コマンドに以下のオプションを付けて実行し、multipath 付きの initramfs ファイルシステムを再ビルドします。
```
# dracut --force -H --add multipath
```
マシンをシャットダウンします。
マシンから他のパスが見えるように、FC スイッチを設定します。
マシンを起動します。
root ファイルシステム ('/') が、マルチパス設定したデバイス上にあることを確認します。

5.4. swap ファイルシステムをシングルパスデバイスからマルチパスデバイスへ移行

デフォルトでは、swap デバイスは論理ボリュームとして設定されます。論理ボリュームグループを設定する物理ボリュームでマルチパスを設定している限り、このようなデバイスをマルチパスデバイスとして設定する特別な手順は必要ありません。ただし、swap デバイスが LVM ボリュームではなく、デバイス名でマウントする場合には、/etc/fstab ファイルに、適切なマルチパスデバイス名を設定しないといけない場合があります。

-v3 オプションを指定して /sbin/multipath コマンドを実行し、swap デバイスの WWID 番号を確認します。コマンドの出力のパス一覧に swap デバイスが表示されます。
swap デバイスを示す、次のような行のコマンド出力を探します。
```
WWID  H:B:T:L devname MAJOR:MINOR
```
たとえば、swap ファイルシステムを sda か、そのパーティションの 1 つに設定している場合は、以下のような行が表示されます。
```
===== paths list =====
...
1ATA     WDC WD800JD-75MSA3                           WD-WMAM9F 1:0:0:0 sda 8:0
...
```

/etc/multipath.conf ファイルに、swap デバイスのエイリアスを設定します。

multipaths {
    multipath {
        wwid WWID_of_swap_device
        alias swapdev
    }
}

/etc/fstab で、root デバイスへの古いデバイスパスを、マルチパスデバイスに置き換えます。
たとえば /etc/fstab ファイルに、以下のようなエントリーがあった場合、
```
/dev/sda2 swap                    swap    defaults        0 0
```
そのエントリーを以下のように変更します。
```
/dev/mapper/swapdev swap          swap    defaults        0 0
```

5.5. マルチパスデーモン

マルチパス設定の実装に問題があることが判明した場合は、3章DM Multipath の設定 の説明に従って、マルチパスデーモンが実行していることを確認する必要があります。マルチパスが設定されているデバイスを使用するには、multipathd デーモンを実行しておく必要があります。

5.6. queue_if_no_path 機能に関する問題

features "1 queue_if_no_path" でマルチパスデバイスを設定した場合は、1 つ以上のパスが復旧するまで、I/O を実行するプロセスがすべてハングします。これを回避するには、/etc/multipath.conf ファイルに no_path_retry N パラメーターを設定します (N はシステムでパスを再試行する回数に置き換えます)。

features "1 queue_if_no_path" オプションを使用しなければならない状況で上記の問題が発生した場合は、dmsetup コマンドを使って、特定の LUN (どのパスも利用できないもの) 用のランタイム時ポリシーを編集します。例えば、マルチパスデバイス mpathc のポリシーを "queue_if_no_path" から "fail_if_no_path" に変更する場合は以下のコマンドを実行します。

dmsetup message mpathc 0 "fail_if_no_path"

パスではなく mpathn エイリアスを指定する必要があります。

5.7. Multipath コマンドの出力

マルチパスデバイスの作成、修正、一覧表示を行うと、現在のデバイス設定が表示されます。形式を以下に示します。

マルチパスデバイス

 action_if_any: alias (wwid_if_different_from_alias) dm_device_name_if_known vendor,product size=size features='features' hwhandler='hardware_handler' wp=write_permission_if_known

パスグループ

-+- policy='scheduling_policy' prio=prio_if_known status=path_group_status_if_known

パス

 `- host:channel:id:lun devnode major:minor dm_status_if_known path_status online_status

マルチパスコマンドの出力例を以下に示します。

3600d0230000000000e13955cc3757800 dm-1 WINSYS,SF2372
size=269G features='0' hwhandler='0' wp=rw
|-+- policy='round-robin 0' prio=1 status=active
| `- 6:0:0:0 sdb 8:16  active ready  running
`-+- policy='round-robin 0' prio=1 status=enabled
  `- 7:0:0:0 sdf 8:80  active ready  running

パスが有効になり、I/O が可能になると、パスのステータスが ready または ghost になります。パスが停止している場合は、ステータスが faulty または shaky になります。パスの状態は、/etc/multipath.conf ファイルに定義されているポーリング間隔に応じ、multipathd デーモンによって定期的に更新されます。

dm の状態は、パスの状態と似ていますが、カーネルの観点からは異なります。dm の状態は、failed (faulty に類似) と、それ以外の状態を示す active の 2 種類があります。任意のデバイスのパス状態と dm 状態が、一時的に一致しない場合があります。

online_status に使用できる値は running と offline です。offline は、この SCSI デバイスが無効になっていることを表します。

注記

マルチパスデバイスを作成中または修正中の場合は、パスグループのステータス、dm のデバイス名、書き込みパーミッション、dm のステータスなどが不明です。また、機能も常に正しいとは限りません。

5.8. multipath コマンドを使ったマルチパスクエリー

multipath コマンドで -l オプションおよび -ll オプションを使用すると、現在のマルチパス設定を表示できます。-l オプションは、sysfs の情報から収集したマルチパストポロジーと、デバイスマッパーを表示します。-ll オプションは、-l オプションが表示する情報のほかに、使用できる他のすべてのシステムコンポーネントを表示します。

マルチパス設定を表示するとき、3 つの詳細レベルは、multipath コマンドの -v オプションで指定できます。-v0 を指定すると何も出力されません。-v1 を指定すると、作成または更新されたマルチパス名のみが出力され、kpartx などの別のツールに提供できます。-v2 を指定すると、検出されたパス、マルチパス、およびデバイスマップがすべて出力されます。

multipath -l コマンドの出力を以下に示します。

# multipath -l
3600d0230000000000e13955cc3757800 dm-1 WINSYS,SF2372
size=269G features='0' hwhandler='0' wp=rw
|-+- policy='round-robin 0' prio=1 status=active
| `- 6:0:0:0 sdb 8:16  active ready  running
`-+- policy='round-robin 0' prio=1 status=enabled
  `- 7:0:0:0 sdf 8:80  active ready  running

multipath -ll コマンドの出力を以下に示します。

# multipath -ll
3600d0230000000000e13955cc3757801 dm-10 WINSYS,SF2372
size=269G features='0' hwhandler='0' wp=rw
|-+- policy='round-robin 0' prio=1 status=enabled
| `- 19:0:0:1 sdc 8:32  active ready  running
`-+- policy='round-robin 0' prio=1 status=enabled
  `- 18:0:0:1 sdh 8:112 active ready  running
3600d0230000000000e13955cc3757803 dm-2 WINSYS,SF2372
size=125G features='0' hwhandler='0' wp=rw
`-+- policy='round-robin 0' prio=1 status=active
  |- 19:0:0:3 sde 8:64  active ready  running
  `- 18:0:0:3 sdj 8:144 active ready  running

5.9. multipath コマンドのオプション

表5.1「便利な multipath コマンドのオプション」では、multipath コマンドの便利なオプションの一部を説明します。

表5.1 便利な multipath コマンドのオプション
オプション	説明
`-l`	`sysfs` から収集した現在のマルチパス設定とデバイスマッパーを表示します。
`-ll`	`sysfs` から収集した現在のマルチパス設定、デバイスマッパー、使用可能な全システムコンポーネントを表示します。
`-f device`	指定したマルチパスデバイスを削除します。
`-F`	不要なマルチパスデバイスをすべて削除します。
`-w device`	指定したデバイスの `wwid` を、`wwids` ファイルから削除します。
`-W`	現在のマルチパスデバイスのみを組み込むように、`wwids` ファイルをリセットします。

5.10. dmsetup コマンドを使ってデバイスマッパーのエントリーを特定

dmsetup コマンドを使って、マルチパスを設定したデバイスに一致するデバイスマッパーのエントリーを検索できます。

以下のコマンドでは、すべてのデバイスマッパーデバイスと、そのメジャー番号およびマイナー番号を表示します。dm デバイス名は、マイナー番号で特定できます。例えば、マイナー番号 3 は、マルチパス設定したデバイス /dev/dm-3 になります。

# dmsetup ls
mpathd  (253:4)
mpathep1        (253:12)
mpathfp1        (253:11)
mpathb  (253:3)
mpathgp1        (253:14)
mpathhp1        (253:13)
mpatha  (253:2)
mpathh  (253:9)
mpathg  (253:8)
VolGroup00-LogVol01     (253:1)
mpathf  (253:7)
VolGroup00-LogVol00     (253:0)
mpathe  (253:6)
mpathbp1        (253:10)
mpathd  (253:5)

5.11. multipathd コマンド

multipathd コマンドを使用して、multipathd デーモンを管理できます。利用可能な multipathd コマンドについては、multipathd(8) man ページを参照してください。

以下のコマンドは、multipathd show maps コマンドの出力の標準デフォルト形式を示しています。

# multipathd show maps
name sysfs uuid
mpathc dm-0 360a98000324669436c2b45666c567942

一部の multipathd コマンドには、後にワイルドカードが付いた format オプションを含むものがあります。次のコマンドを実行すると、使用できるワイルドカードの一覧を表示できます。

# multipathd show wildcards

Red Hat Enterprise Linux リリース 7.3 の時点では、multipathd コマンドは、"raw" 形式のバージョンでマルチパスデバイスとパスのステータスを表示する、新しい形式のコマンドをサポートしています。raw 形式ではヘッダーは出力されず、フィールドがパッディングされていないため、列とヘッダーが調整されていません。代わりに、フィールドは format 文字列の指定どおりに出力します。このため、出力はスクリプトで使いやすくなります。multipathd show wildcards コマンドを使用すると、書式設定文字列に使用されたワイルドカードを表示することができます。

以下の multipathd コマンドは、multipathd が監視しているマルチパスデバイスを、通常および raw 形式でマルチパスワイルドカードのある書式設定文字列を使用して表示します。

list|show maps|multipaths format $format
list|show maps|multipaths raw format $format

以下の multipathd コマンドは、multipathd が監視しているパスを、通常および raw 形式でマルチパスワイルドカードのある書式設定文字列を使用して表示します。

list|show paths format $format
list|show paths raw format $format

以下のコマンドは、multipathd show maps での raw 形式と非 raw 形式の違いを表示します。raw 形式ではヘッダーがなく、単一のスペースのみが列の間にあることに注意してください。

# multipathd show maps format "%n %w %d %s"
name   uuid                              sysfs vend/prod/rev
mpathc 360a98000324669436c2b45666c567942 dm-0  NETAPP,LUN   

# multipathd show maps raw format "%n %w %d %s"
mpathc 360a98000324669436c2b45666c567942 dm-0 NETAPP,LUN

5.12. 対話式コンソール multipathd を使用したトラブルシューティング

multipathd -k コマンドは、multipathd デーモンに対する対話式のインターフェイスです。このコマンドを実行すると対話式のマルチパスコンソールが立ち上がります。このコマンドを実行してから help を入力すると、使用可能なコマンドの一覧が表示され、対話式コマンドを入力できます。CTRL-D を入力すると終了します。

multipathd 対話式コンソールを使用すると、システムで発生している問題のトラブルシューティングを行うことができます。たとえば、次のコマンドシーケンスを実行すると、デフォルト値などのマルチパス設定を表示して、その後コンソールを終了します。

# multipathd -k
> > show config
> > CTRL-D

次の順序でコマンドを実行し、multipath.conf に対する変更がすべて反映されるようにします。

# multipathd -k
> > reconfigure
> > CTRL-D

次のコマンドシーケンスを実行し、パスチェッカーが正しく動作していることを確認します。

# multipathd -k
> > show paths
> > CTRL-D

5.13. パッケージ削除時におけるマルチパスファイルのクリーンアップ

device-mapper-multipath rpm. ファイルを削除しても、/etc/multipath.conf、/etc/multipath/bindings、および /etc/multipath/wwids の各ファイルは削除されないことに注意してください。このファイルは、device-mapper-multipath パッケージの後続のインストール時に手動で削除する必要があります。