Device Mapper Multipath の設定

手順

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

   Copy to Clipboard Toggle word wrap

   # 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 パッケージが含まれているか確認します。

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   package device-mapper-multipath is not installed

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

   Copy to Clipboard Toggle word wrap

   # yum install device-mapper-multipath

手順

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

   Copy to Clipboard Toggle word wrap

   # mpathconf --enable

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

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

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

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

      Copy to Clipboard Toggle word wrap

      # mpathconf --enable --user_friendly_names n

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

      Copy to Clipboard Toggle word wrap

      # systemctl reload multipathd.service

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

   Copy to Clipboard Toggle word wrap

   # systemctl start multipathd.service

手順

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

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

     Copy to Clipboard Toggle word wrap

     # 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 が作成できるマルチパスデバイスをさらに表示します。

     Copy to Clipboard Toggle word wrap

     # 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

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

     Copy to Clipboard Toggle word wrap

     # 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 属性を使用してこのデバイスを無視します。

   Copy to Clipboard Toggle word wrap

   blacklist {
         wwid WDC_WD800JD-75MSA3_WD-WMAM9FU71040
   }

   警告

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

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

   Copy to Clipboard Toggle word wrap

   # multipath -t > /dev/null

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

   Copy to Clipboard Toggle word wrap

   # multipath -t

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

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

   Copy to Clipboard Toggle word wrap

   # systemctl reload multipathd

検証

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

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

     Copy to Clipboard Toggle word wrap

     # multipath -v2 -l

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

     Copy to Clipboard Toggle word wrap

     # multipath -v2 -d

手順

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

   Copy to Clipboard Toggle word wrap

   # multipathd show config

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

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

   Copy to Clipboard Toggle word wrap

   # 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. 新しいデバイスをスキャンして、マルチパスデバイスの一覧を更新します。

   Copy to Clipboard Toggle word wrap

   # multipath -r

手順

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

   Copy to Clipboard Toggle word wrap

   # dracut --force --add multipath

   注記

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

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

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

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

      # dracut --force --omit multipath

手順

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

   Copy to Clipboard Toggle word wrap

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

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

   N

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

   Y

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

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

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

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

        Copy to Clipboard Toggle word wrap

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

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

        Copy to Clipboard Toggle word wrap

        # zipl

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

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

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

        Copy to Clipboard Toggle word wrap

        options nvme_core multipath=Y

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

        Copy to Clipboard Toggle word wrap

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

     3. initramfs を再構築します。

        Copy to Clipboard Toggle word wrap

        # dracut --force --verbose

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

検証

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

   Copy to Clipboard Toggle word wrap

   # 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 サブシステムをリストアップします。

   Copy to Clipboard Toggle word wrap

   # 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 マルチパスが有効になっているかどうかを確認します。

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

手順

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

   Copy to Clipboard Toggle word wrap

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

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

   N

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

   Y

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

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

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

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

        Copy to Clipboard Toggle word wrap

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

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

        Copy to Clipboard Toggle word wrap

        # zipl

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

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

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

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

        Copy to Clipboard Toggle word wrap

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

     3. initramfs を再構築します。

        Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

   # systemctl enable --now multipathd.service

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

   Copy to Clipboard Toggle word wrap

   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 サービスをリロードします。

   Copy to Clipboard Toggle word wrap

   # multipath -r

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

手順

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

   Copy to Clipboard Toggle word wrap

   #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 セクションにコピーし、そのコメントを外します。

   Copy to Clipboard Toggle word wrap

   defaults {
           user_friendly_names     yes
           path_grouping_policy    multibus
   }

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

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

     Copy to Clipboard Toggle word wrap

     # multipath -t > /dev/null

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

     Copy to Clipboard Toggle word wrap

     # multipath -t

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

   Copy to Clipboard Toggle word wrap

   # service multipathd reload

手順

1. 特定のマルチパスデバイスの multipaths セクションを変更します。設定ファイルで、2 つの特定マルチパスデバイスに対して multipath 属性を指定している例を以下に示します。

   • 1 つ目のデバイスの WWID は 3600508b4000156d70001200000b0000 で、シンボリック名は yellow です。
   • 2 番目のマルチパスデバイスの WWID は 1DEC_321816758474 で、シンボリック名 red があります。

   rr_weight 属性は priorities に設定されています。

   Copy to Clipboard Toggle word wrap

   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 ファイルを検証します。

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

     Copy to Clipboard Toggle word wrap

     # multipath -t > /dev/null

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

     Copy to Clipboard Toggle word wrap

     # multipath -t

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

   Copy to Clipboard Toggle word wrap

   # service multipathd reload

手順

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

   Copy to Clipboard Toggle word wrap

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

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

   overrides セクションには、複数の protocol サブセクションを含めることができます。

   重要

   protocol サブセクションには type パラメーターが含める必要があります。次に、タイプ パラメーターが一致するすべてのパスの設定が、プロトコル サブセクションにリストされている残りのパラメーターで更新されます。

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

     Copy to Clipboard Toggle word wrap

     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 プロトコルを使用するパスデバイスの設定。

     Copy to Clipboard Toggle word wrap

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

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

     Copy to Clipboard Toggle word wrap

     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. サポートされているデバイスを含む、デフォルトの設定値に関する情報を表示します。

   Copy to Clipboard Toggle word wrap

   # 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 はマルチパスされるデバイスです。

   Copy to Clipboard Toggle word wrap

   # 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 エントリーの例を以下に示します。

   Copy to Clipboard Toggle word wrap

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

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

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

     Copy to Clipboard Toggle word wrap

     # multipath -t > /dev/null

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

     Copy to Clipboard Toggle word wrap

     # multipath -t

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

   Copy to Clipboard Toggle word wrap

   # service multipathd reload

手順

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

   Copy to Clipboard Toggle word wrap

   overrides {
           no_path_retry fail
   }

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

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

     Copy to Clipboard Toggle word wrap

     # multipath -t > /dev/null

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

     Copy to Clipboard Toggle word wrap

     # multipath -t

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

   Copy to Clipboard Toggle word wrap

   # service multipathd reload

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

手順

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

   blacklist {
          wwid 3600508b4001080520001e00011700000
   }

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

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

     Copy to Clipboard Toggle word wrap

     # multipath -t > /dev/null

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

     Copy to Clipboard Toggle word wrap

     # multipath -t

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

   Copy to Clipboard Toggle word wrap

   # service multipathd reload

手順

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

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

     Copy to Clipboard Toggle word wrap

     # multipath -t > /dev/null

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

     Copy to Clipboard Toggle word wrap

     # multipath -t

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

   Copy to Clipboard Toggle word wrap

   # service multipathd reload

手順

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

     Copy to Clipboard Toggle word wrap

     # multipath -t > /dev/null

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

     Copy to Clipboard Toggle word wrap

     # multipath -t

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

   Copy to Clipboard Toggle word wrap

   # service multipathd reload

手順

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

   blacklist {
           property "ID_ATA"
   }

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

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

     Copy to Clipboard Toggle word wrap

     # multipath -t > /dev/null

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

     Copy to Clipboard Toggle word wrap

     # multipath -t

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

   Copy to Clipboard Toggle word wrap

   # service multipathd reload

手順

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

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

   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 などの protocol 文字列を認識します。

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

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

     Copy to Clipboard Toggle word wrap

     # multipath -t > /dev/null

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

     Copy to Clipboard Toggle word wrap

     # multipath -t

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

   Copy to Clipboard Toggle word wrap

   # 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 ファイルに以下の行を追加し、必要なデバイスのみを有効にします。

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   blacklist {
           wwid "!3600d0230000000000e13955cc3757803"
   }

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

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

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

   Copy to Clipboard Toggle word wrap

   blacklist_exceptions {
           property "(SCSI_IDENT_|ID_WWN)"
   }

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

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

     Copy to Clipboard Toggle word wrap

     # multipath -t > /dev/null

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

     Copy to Clipboard Toggle word wrap

     # multipath -t

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

   Copy to Clipboard Toggle word wrap

   # service multipathd reload

手順

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

2. 論理ユニット番号 (LUN) へのパスを確認します。

   Copy to Clipboard Toggle word wrap

   # multipath -l

3. パスのサイズを変更します。SCSI デバイスの場合は、デバイスの rescan ファイルに 1 と書き込むと、SCSI ドライバーによる再スキャンが行われます。以下にコマンド例を示します。

   Copy to Clipboard Toggle word wrap

   # echo 1 > /sys/block/path_device/device/rescan

   各パスデバイスに対してこのコマンドを実行します。たとえば、パスデバイスが sda、sdb、sde、および sdf の場合は、次のコマンドを実行します。

   Copy to Clipboard Toggle word wrap

   # 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. マルチパスデバイスのサイズを変更します。

   Copy to Clipboard Toggle word wrap

   # multipathd resize map multipath_device

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

   Copy to Clipboard Toggle word wrap

   # resize2fs /dev/mapper/mpatha

手順

1. /etc/multipath.conf 設定ファイルを作成します。

   Copy to Clipboard Toggle word wrap

   # mpathconf --enable

2. multipathd サービスを有効にします。

   Copy to Clipboard Toggle word wrap

   # systemctl enable multipathd.service

3. find_multipaths 設定パラメーターが on に設定されていない場合は、デバイスのマルチパスの防止 の説明に従って、/etc/multipath.conf ファイルの blacklist セクションと blacklist_exceptions セクションを編集します。

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

   Copy to Clipboard Toggle word wrap

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

   /dev/sdb は、ルートデバイス名に置き換えます。

5. 設定ファイルが正しく設定されていることを確認します。

   Copy to Clipboard Toggle word wrap

   # multipath -d 3600d02300069c9ce09d41c4ac9c53200
   : mpatha (3600d02300069c9ce09d41c4ac9c53200) undef 3PARdata,VV
   size=446M features='1 queue_if_no_path' hwhandler='1 alua' wp=undef
   `-+- policy='service-time 0' prio=50 status=undef
     `- 5:0:0:0 sdb 8:16 undef ready running

   3600d02300069c9ce09d41c4ac9c53200 は、スワップデバイスの WWID に置き換えます。

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

   Copy to Clipboard Toggle word wrap

   # dracut --force --add multipath

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

手順

1. /etc/multipath.conf 設定ファイルを作成します。

   Copy to Clipboard Toggle word wrap

   # mpathconf --enable

2. multipathd サービスを有効にします。

   Copy to Clipboard Toggle word wrap

   # systemctl enable multipathd.service

3. find_multipaths 設定パラメーターが on に設定されていない場合は、デバイスのマルチパスの防止 の説明に従って、/etc/multipath.conf ファイルの blacklist セクションと blacklist_exceptions セクションを編集します。

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

   Copy to Clipboard Toggle word wrap

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

   /dev/sdb は、スワップデバイス名に置き換えます。

5. 設定ファイルが正しく設定されていることを確認します。

   Copy to Clipboard Toggle word wrap

   # multipath -d 3600d02300069c9ce09d41c4ac9c53200
   : mpatha (3600d02300069c9ce09d41c4ac9c53200) undef 3PARdata,VV
   size=446M features='1 queue_if_no_path' hwhandler='1 alua' wp=undef
   `-+- policy='service-time 0' prio=50 status=undef
     `- 5:0:0:0 sdb 8:16 undef ready running

   3600d02300069c9ce09d41c4ac9c53200 は、スワップデバイスの WWID に置き換えます。

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

   Copy to Clipboard Toggle word wrap

   multipaths {
       multipath {
           wwid WWID_of_swap_device
           alias swapdev
       }
   }

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

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

   Copy to Clipboard Toggle word wrap

   /dev/sdb2 swap                    swap    defaults        0 0

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

   Copy to Clipboard Toggle word wrap

   /dev/mapper/swapdev swap          swap    defaults        0 0

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

   Copy to Clipboard Toggle word wrap

   # dracut --force --add multipath

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

手順

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

   Copy to Clipboard Toggle word wrap

   # umount /mnt/mount-point

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

   Copy to Clipboard Toggle word wrap

   # wipefs -a /dev/vg0/myvol

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

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

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

   Copy to Clipboard Toggle word wrap

   # lvremove vg0/myvol

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

   Copy to Clipboard Toggle word wrap

   # vgremove vg0

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

   Copy to Clipboard Toggle word wrap

   # pvremove /dev/sdc1

   Copy to Clipboard Toggle word wrap

   # wipefs -a /dev/sdc1

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

   Copy to Clipboard Toggle word wrap

   # parted /dev/sdc rm 1

7. デバイスを完全に消去する場合は、パーティションテーブルを削除します。

   Copy to Clipboard Toggle word wrap

   # wipefs -a /dev/sdc

8. デバイスを物理的に取り外す場合にのみ、次の手順を実行します。

   • マルチパスデバイスを削除する場合は，次のコマンドを実行します。

     1. デバイスへの全パスを表示します。

        Copy to Clipboard Toggle word wrap

        # multipath -l

        このコマンドの出力は、後のステップで必要になります。

     2. I/O をフラッシュして、マルチパスデバイスを削除します。

        Copy to Clipboard Toggle word wrap

        # multipath -f multipath-device

   • デバイスがマルチパスデバイスとして設定されていない場合や、デバイスがマルチパスデバイスとして設定されていて、過去に I/O を個別のパスに渡している場合は、未処理の I/O を、使用されている全デバイスパスにフラッシュします。

     Copy to Clipboard Toggle word wrap

     # blockdev --flushbufs device

     この操作は、umount コマンドまたは vgreduce コマンドで I/O がフラッシュされないデバイスに直接アクセスする場合に重要になります。

   • SCSI デバイスを取り外す場合は、以下のコマンドを実行します。

     1. システム上のアプリケーション、スクリプト、またはユーティリティーで、/dev/sd、/dev/disk/by-path、または major:minor 番号など、デバイスのパスベースの名前への参照をすべて削除します。参照を削除することで、今後追加される別のデバイスが現在のデバイスと混同されないようにします。

     2. SCSI サブシステムからデバイスへの各パスを削除します。

        Copy to Clipboard Toggle word wrap

        # echo 1 > /sys/block/device-name/device/delete

        デバイスが以前にマルチパスデバイスとして使用されていた場合、device-name は、multipath -l コマンドの出力からの内容に置き換えます。

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

手順

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

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

     Copy to Clipboard Toggle word wrap

     # multipathd disablequeueing map device

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

     Copy to Clipboard Toggle word wrap

     # multipathd disablequeueing maps

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

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

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

     Copy to Clipboard Toggle word wrap

     # multipathd restorequeueing map device

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

     Copy to Clipboard Toggle word wrap

     # multipathd restorequeueing maps

手順

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   # multipathd reconfigure