Device Mapper Multipath の設定

手順

1. マルチパスデバイストポロジーを表示します。

   # multipath -ll
   mpatha (3600d0230000000000e13954ed5f89300) dm-4 WINSYS,SF2372
   size=233G features='1 queue_if_no_path' hwhandler='0' wp=rw
   `-+- policy='service-time 0' prio=1 status=active
     `- 6:0:0:0 sdf 8:80 active ready running

   出力は 3 つの部分に分けることができます。各部分には、次のグループの情報が表示されます。

   • マルチパスデバイス情報:

     • mpatha (3600d0230000000000e13954ed5f89300): エイリアス (エイリアスと異なる場合は wwid)
     • dm-4: dm デバイス名
     • WINSYS,SF2372: ベンダー、製品
     • size=233G: サイズ
     • features='1 queue_if_no_path': 機能
     • hwhandler='0': ハードウェアハンドラー
     • wp=rw : 書き込み権限

   • パスグループ情報:

     • policy='service-time 0': スケジュールポリシー
     • prio=1: パスグループの優先度
     • status=active: パスグループステータス

   • パス情報:

     • 6:0:0:0: ホスト:チャネル:id:lun
     • sdf: devnode
     • 8:80 : メジャー:マイナー番号
     • active: dm ステータス
     • ready: パスステータス

     • running: オンライン状態

       dm、パス、オンラインのステータスの詳細は、パスステータス を参照してください。

手順

1. システムに device-mapper-multipath パッケージが含まれているか確認します。

   # rpm -q device-mapper-multipath
   device-mapper-multipath-current-package-version

   システムにパッケージが含まれていない場合は、次のように出力されます。

   package device-mapper-multipath is not installed

2. システムにパッケージが含まれていない場合は、次のコマンドを実行してパッケージをインストールします。

   # yum install device-mapper-multipath

手順

1. マルチパス設定ファイルを有効にして初期化します。

   # mpathconf --enable

2. オプション: /etc/multipath.conf ファイルを編集します。

   ほとんどのデフォルト設定はすでに設定されています。たとえば、path_grouping_policy は failover に設定されています。

3. オプション: マルチパスデバイスのデフォルトの命名形式は、/dev/mapper/mpathn 形式に設定されます。別の命名形式を使用する場合は、次のようにします。

   1. ユーザーフレンドリーな命名スキーム (mpath_n_) の代わりに、マルチパスデバイスの WWID を名前として使用するように DM Multipath を設定します。

      # mpathconf --enable --user_friendly_names n

   2. DM Multipath デーモンの設定をリロードします。

      # systemctl reload multipathd.service

4. DM Multipath デーモンを起動します。

   # systemctl start multipathd.service

手順

1. デバイスのモデル、パス、ベンダーなどの既知のパラメーターを使用して内部ディスクを識別し、次のオプションのいずれかを使用してその WWID を決定します。

   • 既存のマルチパスデバイスを表示します。

     # multipath -v2 -l
     
     mpatha (WDC_WD800JD-75MSA3_WD-WMAM9FU71040) dm-2 ATA,WDC WD800JD-75MS
     size=33 GB features="0" hwhandler="0" wp=rw
     `-+- policy='round-robin 0' prio=0 status=active
       |- 0:0:0:0 sda 8:0 active undef running

   • DM Multipath が作成できるマルチパスデバイスをさらに表示します。

     # multipath -v2 -d
     
     : mpatha (WDC_WD800JD-75MSA3_WD-WMAM9FU71040) dm-2 ATA,WDC WD800JD-75MS
     size=33 GB features="0" hwhandler="0" wp=undef
     `-+- policy='round-robin 0' prio=1 status=undef
       |- 0:0:0:0 sda 8:0  undef ready running

   • デバイス情報を表示します。

     # multipathd show paths raw format "%d %w" | grep sda
     sda WDC_WD800JD-75MSA3_WD-WMAM9FU71040

     この例では、/dev/sda は内部ディスクで、その WWID は WDC_WD800JD-75MSA3_WD-WMAM9FU71040 です。

2. /etc/multipath.conf ファイルの blacklist セクションを編集し、WWID 属性を使用してこのデバイスを無視します。

   blacklist {
         wwid WDC_WD800JD-75MSA3_WD-WMAM9FU71040
   }

   警告

   sda などの devnode パラメーターを使用してデバイスを識別することはできますが、/dev/sda が再起動時に同じデバイスを参照することが保証されていないため、この手順は安全ではありません。

3. /etc/multipath.conf ファイルに設定エラーがないか確認します。

   # multipath -t > /dev/null

   完全なレポートを表示するには、コマンド出力を破棄しないでください。

   # multipath -t

4. ディスクが initramfs に含まれている場合は、initramfs を再作成します。詳細は、initramfs でのマルチパスの設定 を参照してください。

5. multipathd デーモンを再設定して、/etc/multipath.conf ファイルをリロードします。

   # systemctl reload multipathd

検証

1. 内部ディスクが無視され、マルチパス出力に表示されないことを確認します。

   • マルチパスデバイスをリスト表示します。

     # multipath -v2 -l

   • DM Multipath が作成できる追加デバイスをリスト表示します。

     # multipath -v2 -d

手順

1. デフォルトの設定値とサポートされているデバイスを表示します。

   # multipathd show config

2. /etc/multipath.conf ファイルを編集して、マルチパスを設定します。

   例3.1 HP OPEN-V ストレージデバイス用の DM Multipath 設定

   # Set default configurations for all devices managed by DM Multipath
   
   defaults {
       # Enable user-friendly names for devices
       user_friendly_names yes
   }
   
   devices {
       # Define configuration for HP OPEN-V storage
       device {
           vendor "HP"
           pproduct "OPEN-V"
           no_path_retry 18
       }
   }

3. 変更を保存してエディターを閉じます。

4. 新しいデバイスをスキャンして、マルチパスデバイスの一覧を更新します。

   # multipath -r

手順

1. マルチパス設定ファイルを使用して initramfs ファイルシステムを再構築します。

   # dracut --force --add multipath

   注記

   initramfs でマルチパスを使用し、その設定ファイルを変更する場合は、変更を反映するために必ず initramfs を再構築してください。ルートデバイスがマルチパスを使用している場合、dracut コマンドは自動的にマルチパスモジュールを initramfs に組み込みます。

2. オプション: initramfs のマルチパスが必要なくなった場合は、以下を実行します。

   1. マルチパス設定ファイルを削除します。

      # rm /etc/dracut.conf.d/multipath.conf

   2. 追加したマルチパス設定を使用して initramfs を再構築します。

      # dracut --force --omit multipath

手順

1. カーネルでネイティブ NVMe マルチパスが有効になっているかどうかを確認します。

   # cat /sys/module/nvme_core/parameters/multipath

   コマンドは以下のいずれかを表示します。

   N

   ネイティブ NVMe マルチパスは無効です。

   Y

   ネイティブ NVMe マルチパスは有効です。

2. ネイティブ NVMe マルチパスが無効になっている場合は、次のいずれかの方法を使用して有効にします。

   • カーネルオプションの使用

     1. nvme_core.multipath=Y オプションをコマンドラインに追加します。

        # grubby --update-kernel=ALL --args="nvme_core.multipath=Y"

     2. 64 ビットの IBM Z アーキテクチャーでは、ブートメニューを更新します。

        # zipl

     3. システムを再起動します。

   • カーネルモジュール設定ファイルの使用

     1. 以下の内容で /etc/modprobe.d/nvme_core.conf 設定ファイルを作成します。

        options nvme_core multipath=Y

     2. initramfs ファイルをバックアップします。

        # cp /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r).bak.$(date +%m-%d-%H%M%S).img

     3. initramfs を再構築します。

        # dracut --force --verbose

     4. システムを再起動します。

3. オプション: 実行中のシステムで、NVMe デバイスの I/O ポリシーを変更して、利用可能なすべてのパスに I/O を分散させます。

   # echo "round-robin" > /sys/class/nvme-subsystem/nvme-subsys0/iopolicy

4. オプション: udev ルールを使用して I/O ポリシーを永続的に設定します。以下の内容で /etc/udev/rules.d/71-nvme-io-policy.rules ファイルを作成します。

   ACTION=="add|change", SUBSYSTEM=="nvme-subsystem", ATTR{iopolicy}="round-robin"

検証

1. システムが NVMe デバイスを認識しているかどうかを確認します。次の例は、2 つの NVMe 名前空間を持つ NVMe over fabrics ストレージサブシステムが接続されていることを想定しています:

   # nvme list
   
   Node             SN                   Model                                    Namespace Usage                      Format           FW Rev
   ---------------- -------------------- ---------------------------------------- --------- -------------------------- ---------------- --------
   /dev/nvme0n1     a34c4f3a0d6f5cec     Linux                                    1         250.06  GB / 250.06  GB    512   B +  0 B   4.18.0-2
   /dev/nvme0n2     a34c4f3a0d6f5cec     Linux                                    2         250.06  GB / 250.06  GB    512   B +  0 B   4.18.0-2

2. 接続されているすべての NVMe サブシステムをリストアップします。

   # nvme list-subsys
   
   nvme-subsys0 - NQN=testnqn
   \
    +- nvme0 fc traddr=nn-0x20000090fadd597a:pn-0x10000090fadd597a host_traddr=nn-0x20000090fac7e1dd:pn-0x10000090fac7e1dd live
    +- nvme1 fc traddr=nn-0x20000090fadd5979:pn-0x10000090fadd5979 host_traddr=nn-0x20000090fac7e1dd:pn-0x10000090fac7e1dd live
    +- nvme2 fc traddr=nn-0x20000090fadd5979:pn-0x10000090fadd5979 host_traddr=nn-0x20000090fac7e1de:pn-0x10000090fac7e1de live
    +- nvme3 fc traddr=nn-0x20000090fadd597a:pn-0x10000090fadd597a host_traddr=nn-0x20000090fac7e1de:pn-0x10000090fac7e1de live

   アクティブトランスポートタイプを確認します。例えば、nvme0 fc はファイバーチャネルトランスポートで接続されていることを示し、nvme tcp は TCP で接続されていることを示しています。

3. カーネルオプションを編集した場合は、カーネルコマンドラインでネイティブ NVMe マルチパスが有効になっているかどうかを確認します。

   # cat /proc/cmdline
   
   BOOT_IMAGE=[...] nvme_core.multipath=Y

4. I/O ポリシーを変更した場合は、NVMe デバイス上で round-robin がアクティブな I/O ポリシーであるかどうかを確認します。

   # cat /sys/class/nvme-subsystem/nvme-subsys0/iopolicy
   
   round-robin

手順

1. ネイティブ NVMe マルチパスが無効になっているかどうかを確認します。

   # cat /sys/module/nvme_core/parameters/multipath

   コマンドは以下のいずれかを表示します。

   N

   ネイティブ NVMe マルチパスは無効です。

   Y

   ネイティブ NVMe マルチパスは有効です。

2. ネイティブ NVMe マルチパスが有効になっている場合は、次のいずれかの方法を使用して無効にします。

   • カーネルオプションの使用

     1. カーネルのコマンドラインから nvme_core.multipath=Y オプションを削除しました。

        # grubby --update-kernel=ALL --remove-args="nvme_core.multipath=Y"

     2. 64 ビットの IBM Z アーキテクチャーでは、ブートメニューを更新します。

        # zipl

     3. システムを再起動します。

   • カーネルモジュール設定ファイルの使用

     1. /etc/modprobe.d/nvme_core.conf ファイルに nvme_core multipath=Y オプションの行が存在する場合は、それを削除します。

     2. initramfs ファイルをバックアップします。

        # cp /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r).bak.$(date +%m%d-%H%M%S).img

     3. initramfs を再構築します。

        # cp /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r).bak.$(date +%m-%d-%H%M%S).img
        # dracut --force --verbose

     4. システムを再起動します。

3. DM マルチパスを有効にします。

   # systemctl enable --now multipathd.service

4. 利用可能なすべてのパスに I/O を分配します。/etc/multipath.conf ファイルに以下の内容を追加します。

   devices {
           device {
                   vendor "NVME"
                   product ".*"
                   path_grouping_policy group_by_prio
           }
   }

   注記

   DM Multipath が NVMe デバイスを管理する場合、/sys/class/nvme-subsystem/nvme-subsys0/iopolicy 設定ファイルは I/O ディストリビューションには影響を与えません。

5. 設定の変更を適用するために、multipathd サービスをリロードします。

   # multipath -r

1. multipaths セクション
2. overrides セクション
3. devices セクション
4. defaults セクション

手順

1. /etc/multipath.conf 設定ファイルを表示します。このファイルには、設定のデフォルトのテンプレートが含まれています。

   #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
   #}

2. 設定パラメーターのデフォルト値を上書きします。このテンプレートから defaults のセクションに関連する行をコピーして、コメントを外すことができます。

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

   defaults {
           user_friendly_names     yes
           path_grouping_policy    multibus
   }

3. 次のいずれかのコマンドを実行してマルチパス設定ファイルを変更した後、/etc/multipath.conf ファイルを検証します。

   • 設定エラーを表示するには、以下のコマンドを実行します。

     # multipath -t > /dev/null

   • 変更が追加された新しい設定を表示するには、以下のコマンドを実行します。

     # multipath -t

4. /etc/multipath.conf ファイルを再読み込みし、multipathd デーモンを再設定して変更を反映します。

   # service multipathd reload

手順

1. 特定のマルチパスデバイスの multipaths セクションを変更します。設定ファイルで、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
           }
   }

2. 次のいずれかのコマンドを実行してマルチパス設定ファイルを変更した後、/etc/multipath.conf ファイルを検証します。

   • 設定エラーを表示するには、以下のコマンドを実行します。

     # multipath -t > /dev/null

   • 変更が追加された新しい設定を表示するには、以下のコマンドを実行します。

     # multipath -t

3. /etc/multipath.conf ファイルを再読み込みし、multipathd デーモンを再設定して変更を反映します。

   # service multipathd reload

手順

1. 以下のコマンドを実行して、特定のパスプロトコルを表示します。

   # multipathd show paths format "%d %P"
   dev protocol
   sda scsi:ata
   sdb scsi:fcp
   sdc scsi:fcp

2. 各マルチパスタイプに protocol サブセクションを追加して、/etc/multipath.conf ファイルの overrides セクションを編集します。

   • scsi:fcp プロトコルを使用するパスデバイスの設定。

     overrides {
             dev_loss_tmo 60
             fast_io_fail_tmo 8
             protocol {
                     type "scsi:fcp"
                     dev_loss_tmo 70
                     fast_io_fail_tmo 10
                     eh_deadline 360
             }
     }

   • scsi:iscsi プロトコルを使用するパスデバイスの設定。

     overrides {
             dev_loss_tmo 60
             fast_io_fail_tmo 8
             protocol {
                     type "scsi:iscsi"
                     dev_loss_tmo 60
                     fast_io_fail_tmo 120
             }
     }

   • 他のすべてのプロトコルを使用するパスデバイスの設定。

     overrides {
             dev_loss_tmo 60
             fast_io_fail_tmo 8
             protocol {
                     type "<type of protocol>"
                     dev_loss_tmo 60
                     fast_io_fail_tmo 8
             }
     }

手順

1. サポートされているデバイスを含む、デフォルトの設定値に関する情報を表示します。

   # multipathd show config
   # multipath -t

   マルチパスに対応しているデバイスの多くは、デフォルトでマルチパスの設定に含まれています。

2. オプション: デフォルトの設定値を変更する必要がある場合は、それらの値を上書きするデバイスの設定ファイルにエントリーを含めることで、デフォルト値を上書きできます。multipathd show config コマンドが表示する、目的のデバイスのデフォルト値をコピーして、変更したい値に書き換えることができます。

3. vendor と product のパラメーターを設定して、デフォルトで自動的に設定されないデバイスを設定ファイルの devices セクションに追加します。次の例に示すように、/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

4. オプション: 特定のデバイスに応じて、追加のパラメーターを指定します。

   active/active デバイス

   通常、この場合、追加のパラメーターを設定する必要はありません。必要に応じて、path_grouping_policy を multibus に設定できます。この他に、設定が必要となる可能性があるパラメーターは no_path_retry と rr_min_io です。

   active/passive デバイス

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

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

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

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

5. 次のいずれかのコマンドを実行してマルチパス設定ファイルを変更した後、/etc/multipath.conf ファイルを検証します。

   • 設定エラーを表示するには、以下のコマンドを実行します。

     # multipath -t > /dev/null

   • 変更が追加された新しい設定を表示するには、以下のコマンドを実行します。

     # multipath -t

6. /etc/multipath.conf ファイルを再読み込みし、multipathd デーモンを再設定して変更を反映します。

   # service multipathd reload

手順

1. デバイス固有の設定を上書きします。たとえば、すべてのデバイスで no_path_retry を fail に設定できます。すべてのパスに障害が発生した場合は、次のコマンドを使用してキューイングをオフにします。これにより、デバイス固有の設定が上書きされます。

   overrides {
           no_path_retry fail
   }

2. 次のいずれかのコマンドを実行してマルチパス設定ファイルを変更した後、/etc/multipath.conf ファイルを検証します。

   • 設定エラーを表示するには、以下のコマンドを実行します。

     # multipath -t > /dev/null

   • 変更が追加された新しい設定を表示するには、以下のコマンドを実行します。

     # multipath -t

3. /etc/multipath.conf ファイルを再読み込みし、multipathd デーモンを再設定して変更を反映します。

   # service multipathd reload

1. プロパティー
2. devnode
3. device
4. プロトコル
5. wwid

手順

1. デバイスの WWID を検索します。

   # multipathd show paths raw format "%d %w" | grep sdb
   sdb 3600508b4001080520001e00011700000

2. wwid エントリーを使用して、/etc/multipath.conf 設定ファイルのデバイスを無効にします。

   次の例は、WWID が 3600508b4001080520001e00011700000 のデバイスを無効にする DM マルチパス設定ファイル内の行を示します。

   blacklist {
          wwid 3600508b4001080520001e00011700000
   }

3. 次のいずれかのコマンドを実行してマルチパス設定ファイルを変更した後、/etc/multipath.conf ファイルを検証します。

   • 設定エラーを表示するには、以下のコマンドを実行します。

     # multipath -t > /dev/null

   • 変更が追加された新しい設定を表示するには、以下のコマンドを実行します。

     # multipath -t

4. /etc/multipath.conf ファイルを再読み込みし、multipathd デーモンを再設定して変更を反映します。

   # service multipathd reload

手順

1. デバイス情報を表示します。

   # udevadm info --query=all -n /dev/mapper/sd* 

2. devnode エントリーを使用して、/etc/multipath.conf 設定ファイルのデバイスを無効にします。

   以下の例は、すべての sd* デバイスを無効にするため、すべての SCSI デバイスを無効にする DM Multipath 設定ファイル内の行を示しています。

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

   devnode エントリーを使用すると、特定タイプのすべてのデバイスではなく、個別のデバイスを無効にできます。ただし、udev ルールで静的にマッピングされていない限り、再起動時に特定のデバイス名が同じ名前になる保証がないため、この方法は推奨されません。たとえば、システムが再起動するとデバイス名が /dev/sda から /dev/sdb に変わる可能性があります。

   デフォルトでは、DM Multipath は以下の devnode エントリーを使用して、SCSI、NVMe、または DASD 以外のすべてのデバイスを無効にします。

   blacklist {
          devnode "!^(sd[a-z]|dasd[a-z]|nvme[0-9])"
   }

   このエントリーを無効にするデバイスは、通常、 DM Multipath に対応していません。

3. 次のいずれかのコマンドを実行してマルチパス設定ファイルを変更した後、/etc/multipath.conf ファイルを検証します。

   • 設定エラーを表示するには、以下のコマンドを実行します。

     # multipath -t > /dev/null

   • 変更が追加された新しい設定を表示するには、以下のコマンドを実行します。

     # multipath -t

4. /etc/multipath.conf ファイルを再読み込みし、multipathd デーモンを再設定して変更を反映します。

   # service multipathd reload

手順

1. 表示デバイスの種類:

   # multipathd show paths raw format "%d %s" | grep sdb
   sdb HP,HSV210

2. device セクションを使用して、/etc/multipath.conf 設定ファイルのデバイスを無効にします。

   以下の例は、IBM DS4200 および HP のすべてのデバイスでのマルチパスを無効にします。

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

3. 次のいずれかのコマンドを実行してマルチパス設定ファイルを変更した後、/etc/multipath.conf ファイルを検証します。

   • 設定エラーを表示するには、以下のコマンドを実行します。

     # multipath -t > /dev/null

   • 変更が追加された新しい設定を表示するには、以下のコマンドを実行します。

     # multipath -t

4. /etc/multipath.conf ファイルを再読み込みし、multipathd デーモンを再設定して変更を反映します。

   # service multipathd reload

手順

1. デバイスの udev 変数を表示します。

   # udevadm info --query=all -n /dev/sdb

2. property パラメーターを使用して、/etc/multipath.conf 設定ファイルのデバイスを無効にします。このパラメーターは、デバイスの udev 環境変数名と一致する正規表現の文字列です。

   以下の例は、udev プロパティー ID_ATA を持つすべてのデバイスでマルチパスを無効にします。

   blacklist {
           property "ID_ATA"
   }

3. 次のいずれかのコマンドを実行してマルチパス設定ファイルを変更した後、/etc/multipath.conf ファイルを検証します。

   • 設定エラーを表示するには、以下のコマンドを実行します。

     # multipath -t > /dev/null

   • 変更が追加された新しい設定を表示するには、以下のコマンドを実行します。

     # multipath -t

4. /etc/multipath.conf ファイルを再読み込みし、multipathd デーモンを再設定して変更を反映します。

   # service multipathd reload

手順

1. オプション: パスが使用するプロトコルを表示します。

   # multipathd show paths raw format "%d %P" | grep sdb
   sdb scsi:fcp

2. protocol パラメーターを使用して、/etc/multipath.conf 設定ファイルのデバイスを無効にします。

   protocol パラメーターは正規表現を取り、プロトコル文字列が一致するすべてのデバイスをブラックリストに指定します。たとえば、すべての nvme デバイスでマルチパスを無効にするには、以下を使用します。

   blacklist {
           protocol "nvme"
   }

   DM Multipath は以下のプロトコル文字列を認識します。

   • scsi:fcp
   • scsi:spi
   • scsi:ssa
   • scsi:sbp
   • scsi:srp
   • scsi:iscsi
   • scsi:sas
   • scsi:adt
   • scsi:ata
   • scsi:unspec
   • ccw
   • cciss
   • nvme:pcie
   • nvme:rdma
   • nvme:fc
   • nvme:tcp
   • nvme:loop
   • nvme:apple-nvme
   • nvme:unspec
   • undef

3. 次のいずれかのコマンドを実行してマルチパス設定ファイルを変更した後、/etc/multipath.conf ファイルを検証します。

   • 設定エラーを表示するには、以下のコマンドを実行します。

     # multipath -t > /dev/null

   • 変更が追加された新しい設定を表示するには、以下のコマンドを実行します。

     # multipath -t

4. /etc/multipath.conf ファイルを再読み込みし、multipathd デーモンを再設定して変更を反映します。

   # service multipathd reload

手順

1. /etc/multipath.conf 設定ファイルの blacklist_exceptions セクションを使用して、デバイスでマルチパスを有効にします。

   設定ファイルの blacklist_exceptions セクションでデバイスを指定する場合は、blacklist セクションで指定したものと同じ基準を使用して例外を指定する必要があります。たとえば、無効にしたデバイスがその WWID に関連付けられている場合でも、WWID 例外は devnode エントリーで無効になっているデバイスには適用されません。同様に、devnode 例外は devnode エントリーにしか適用されず、device 例外はデバイスエントリーにしか適用されません。

   例6.1 WWID による例外

   たとえば、デバイスが多数あり、その中の 1 つのデバイス (以下の例では WWID が 3600d0230000000000e13955cc3757803 のデバイス) でのみマルチパスを有効にする場合は、有効にするデバイス以外のものを 1 つ 1 つ無効にするのではなく、一旦すべてのデバイスを無効にしてから、/etc/multipath.conf ファイルに以下の行を追加し、必要なデバイスのみを有効にします。

   blacklist {
           wwid ".*"
   }
   
   blacklist_exceptions {
           wwid "3600d0230000000000e13955cc3757803"
   }

   または、感嘆符 (!) を使用して blacklist エントリーを反転することもできます。これにより、指定した WWID を除くすべてのデバイスを無効にできます。

   blacklist {
           wwid "!3600d0230000000000e13955cc3757803"
   }

   例6.2 udev プロパティーによる例外

   property パラメーターの挙動は、他の blacklist_exception パラメーターとは異なります。property パラメーターの値は、udev データベース内の変数の名前と一致する必要があります。それ以外の場合は、デバイスは無効になります。このパラメーターを使用すると、USB スティックやローカルハードドライブなどの特定の SCSI デバイスでマルチパスを無効にできます。

   合理的にマルチパス化できる SCSI デバイスでのみマルチパスを有効にするには、以下の例のようにこのパラメーターを SCSI_IDENT_|ID_WWN) に設定します。

   blacklist_exceptions {
           property "(SCSI_IDENT_|ID_WWN)"
   }

2. 次のいずれかのコマンドを実行してマルチパス設定ファイルを変更した後、/etc/multipath.conf ファイルを検証します。

   • 設定エラーを表示するには、以下のコマンドを実行します。

     # multipath -t > /dev/null

   • 変更が追加された新しい設定を表示するには、以下のコマンドを実行します。

     # multipath -t

3. /etc/multipath.conf ファイルを再読み込みし、multipathd デーモンを再設定して変更を反映します。

   # service multipathd reload

手順

1. 物理デバイスのサイズを変更します。

2. 以下のコマンドを実行し、論理ユニット番号 (LUN) までのパスを検索します。

   # multipath -l

3. パスのサイズを変更します。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

4. マルチパスデバイスのサイズを変更します。

   # multipathd resize map multipath_device

5. ファイルシステムのサイズを変更します (LVM または DOS のパーティションが使用されていないことを前提とします)。

   # resize2fs /dev/mapper/mpatha

手順

1. /etc/multipath.conf 設定ファイルを作成し、multipath モジュールをロードし、multipathd systemd サービスを有効にします。

   # yum install device-mapper-multipath

2. 以下のコマンドを実行して /etc/multipath.conf 設定ファイルを作成、マルチパスモジュールをロードして multipathd の chkconfig を on に設定します。

   # mpathconf --enable

3. find_multipaths 設定パラメーターが yes に設定されていない場合は、Preventing devices from multipathing の説明にしたがって /etc/multipath.conf の blacklist および blacklist_exceptions セクションを編集します。

4. 検出され次第、root デバイスにマルチパスデバイスを構築させるため、次のコマンドを実行します。また、このコマンドを実行すると、パスが 1 つしかない場合でも必ず find_multipaths がデバイスを許可するようになります。

   # multipath -a root_devname

   たとえば、root デバイスが /dev/sdb の場合は、次のコマンドを実行します。

   # multipath -a /dev/sdb
   wwid '3600d02300069c9ce09d41c4ac9c53200' added

5. multipath コマンドを実行して設定ファイルの設定が正しく行われたことを確認し、次のような行が出力されていることを検索します。これは、コマンドがマルチパスデバイスの作成に失敗したことを示しています。

   date  wwid: ignoring map

   たとえば、デバイスの WWID が 3600d02300069c9ce09d41c4ac9c53200 の場合は、次のような行が出力に表示されます。

   # multipath
   Oct 21 09:37:19 | 3600d02300069c9ce09d41c4ac9c53200: ignoring map

6. multipath を使用して initramfs ファイルシステムを再構築します。

   # dracut --force -H --add multipath

7. マシンをシャットダウンします。
8. マシンを起動します。
9. 他のパスがマシンから見えるようにする。

手順

1. /etc/multipath/wwids ファイルにデバイスの WWID を追加します。

   # multipath -a swap_devname

   たとえば、root デバイスが /dev/sdb の場合は、次のコマンドを実行します。

   # multipath -a /dev/sdb
   wwid '3600d02300069c9ce09d41c4ac9c53200' added

2. 設定ファイルの設定が正しく行われたことを確認するため、multipath コマンドを実行して、次のような行が出力されていることを検索します。

   date  wwid: ignoring map

   これは、コマンドがマルチパスデバイスの作成に失敗したことを示しています。

   たとえば、デバイスの WWID が 3600d02300069c9ce09d41c4ac9c53200 の場合は、次のような行が出力に表示されます。

   # multipath
   Oct 21 09:37:19 | 3600d02300069c9ce09d41c4ac9c53200: ignoring map

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

   multipaths {
       multipath {
           wwid WWID_of_swap_device
           alias swapdev
       }
   }

4. /etc/fstab ファイルで、root デバイスへの古いデバイスパスを、マルチパスデバイスに置き換えます。

   たとえば、/etc/fstab ファイルに、以下のようなエントリーがあるとします。

   /dev/sdb2 swap                    swap    defaults        0 0

   エントリーを以下のように変更します。

   /dev/mapper/swapdev swap          swap    defaults        0 0

5. multipath を使用して initramfs ファイルシステムを再構築します。

   # dracut --force -H --add multipath

6. マシンをシャットダウンします。
7. マシンを起動します。
8. 他のパスがマシンから見えるようにする。

手順

1. ファイルシステムをアンマウントします。

   # umount /mnt/mount-point

2. ファイルシステムを削除します。

   # wipefs -a /dev/vg0/myvol

   注記

   /etc/fstab ファイルにエントリーを追加して、ファイルシステムとマウントポイントの間の永続的な関連付けを作成した場合は、この時点で /etc/fstab を編集してそのエントリーを削除する必要もあります。

   削除するデバイスのタイプに応じて、次の手順に進みます。

3. ファイルシステムを含む論理ボリューム (LV) を削除します。

   # lvremove vg0/myvol

4. ボリュームグループ (VG) に他の論理ボリュームが残っていない場合は、デバイスを含む VG を安全に削除できます。

   # vgremove vg0

5. 物理ボリューム (PV) メタデータを PV デバイスから削除します。

   # pvremove /dev/sdc1

   # wipefs -a /dev/sdc1

6. PV が含まれていたパーティションを削除します。

   # parted /dev/sdc rm 1

7. パーティションテーブルを削除します。

   # wipefs -a /dev/sdc

8. 稼働中のシステムから物理デバイスを削除します。このデバイスを削除しても、他のデバイスへの I/O は停止しないことに注意してください。

手順

1. キューイングを無効にします。

   • 特定のデバイスの場合:

     # multipathd disablequeueing map device

   • すべてのデバイスの場合:

     # multipathd disablequeueing maps

     キューイングを無効にすると、multipathd を再起動または再読み込みするまで、無効のままになります。

2. キューイングを以前の値にリセットします。

   • 特定のデバイスの場合:

     # multipathd restorequeueing map device

   • すべてのデバイスの場合:

     # multipathd restorequeueing maps

手順

1. コンソールを終了する前に、デフォルト値を含むマルチパス設定を表示します。

   # multipathd -k
   multipathd> show config
   multipathd> Ctrl+D

2. マルチパスが multipath.conf ファイルへの変更をすべて反映するようにします。

   # multipathd -k
   multipathd> reconfigure
   multipathd> Ctrl+D

3. パスチェッカーが正常に動作していることを確認します。

   # multipathd -k
   multipathd> show paths
   multipathd> Ctrl+D

4. また、対話型コンソールを起動せずに、コマンドラインから直接 1 つの multipathd 対話型コマンドを実行することも可能です。たとえば、マルチパスが multipath.conf ファイルへの変更をすべて反映することを確認するには、次のコマンドを実行します。

   # multipathd reconfigure