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

polling_interval

パスチェックが行われる間隔を秒数で指定します。適正に機能するパスでは、チェックの間隔は max_polling_interval まで徐々に増加します。

デフォルト値は 5 です。

max_polling_interval

2 つのパスチェック間の最大間隔を秒単位で指定します。

デフォルト値は 4 * polling_interval です。

find_multipaths

マルチパスデバイスのセットアップモードを定義します。利用可能な値は次のとおりです。

off: find_multipaths が off に設定されている場合、multipath は strict 値と同様にルールを適用し、multipathd デーモンは greedy 値と同様にルールを適用します。

on: 同じ World Wide Identifier (WWID) を持つ blacklist に登録されていないデバイスが少なくとも 2 つある場合、または以前にマルチパスがデバイス WWID を持つマルチパスデバイスを作成している場合 (そのマルチパスデバイスがすでに存在しない場合を含む)、デバイスはマルチパスデバイスパスとして扱われます。

greedy: multipathd と multipath の両方が、ブラックリストに登録されていないすべてのデバイスをマルチパスデバイスパスとして扱います。

smart: マルチパスは、ブラックリストに登録されていないすべてのデバイスを自動的にマルチパスデバイスパスと認識します。同じ WWID を持つ 2 番目のパスが find_multipaths_timeout に設定された時間内に表示されない場合、マルチパスはデバイスを解放し、システム内で使用できるようにします。multipathd デーモンは、on 値と同様にルールを適用します。

strict: デバイス WWID を使用してマルチパスデバイスを作成する場合にのみ、デバイスをマルチパスパスとして扱います。

デフォルト値は off です。デフォルトの multipath.conf ファイルでは、find_multipaths が on に設定されています。

find_multipaths_timeout

find_multipaths smart が設定されている場合に、最初のパスを検出した後に追加のパスを待機するためのタイムアウトを秒単位で表します。使用できる値を以下に示します。

正の値: 正の値を設定すると、ブラックリストに登録されていないすべてのデバイスにタイムアウトが適用されます。

負の値: 負の値を設定すると、マルチパスハードウェアテーブル (ビルトインテーブルまたは device セクションのいずれか) にエントリーがある既知のデバイスにのみタイムアウトが適用されます。その他の不明なデバイスは、起動の遅延を避けるために 1 秒だけのタイムアウトを使用します。

0: システムは、この属性にビルトインのデフォルトを適用します。

既知のハードウェアのデフォルト値は -10 です。これは、既知のデバイスのタイムアウトが 10 秒であることを意味します。不明なデバイスのタイムアウトは 1 秒です。find_multipaths 属性の値が smart 以外の場合、この属性は影響しません。

uxsock_timeout

multipathd 対話型コマンドのタイムアウトをミリ秒単位で設定します。

多数のデバイスがあるシステムでは、multipathd 対話型コマンドがタイムアウトして失敗する場合があります。失敗する場合、このタイムアウトを増やして問題を解決してください。

デフォルト値は 4000 です。

reassign_maps

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

verbosity

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

path_selector

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

round-robin 0: パスグループ内のすべてのパスをループし、rr_min_io または rr_min_io_rq により決定された同数の 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 つの優先グループ。優先順位は、prio 属性によって決定されます。

group_by_node_name: ターゲットノード名ごとに 1 つの優先グループ。/sys/class/fc_transport/target*/node_name ディレクトリーには、ターゲットノード名が含まれています。

group_by_tpg: ターゲットポートグループごとに 1 つの優先グループ。マルチパスデバイス内のすべてのパスの優先関数は、alua または sysfs に設定する必要があります。

デフォルト値は failover です。

uid_attrs

WWID による uevents のマージを有効にするには、このオプションを設定します。このアクションにより、uevent の処理効率が向上する場合があります。これは、一意のパス識別子 (WWID) を決定するために使用する udev プロパティーを設定する別の方法でもあります。

このオプションの値は、type:ATTR のようなスペースで区切られたレコードのリストです。type はデバイスノード名の先頭と一致し、ATTR はデバイスの照合に使用する udev プロパティーの名前です。

このオプションを設定し、それがデバイスのデバイスノード名と一致する場合、このデバイスの WWID を決定するために設定されている他のすべての方法がオーバーライドされます。

この値を sd:ID_SERIAL dasd:ID_UID nvme:ID_WWN に設定することで、uevent マージを有効にできます。

デフォルトは unset です。

prio

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

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

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

sysfs: sysfs からパス優先度を生成します。この prioritizer は、オプションの prio_arg 値 exclusive_pref_bit を受け入れます。sysfs 値は、sysfs 属性の access_state および preferred_path を使用します。

alua: Small Computer System Interface-3 (SCSI-3) ALUA 設定に基づいてパス優先度を生成します。デバイス設定で prio alua および prio_args exclusive_pref_bit を指定すると、マルチパスにより exclusive_pref_bit が設定されたパスのみを含むパスグループが作成され、そのパスグループに最高の優先度が割り当てられます。このタイプのケースの詳細は、multipath.conf(5) man ページを参照してください。

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

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

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

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

random: 1 から 10 までのランダムな優先度を生成します。

weightedpath: 正規表現と引数として指定された優先度に基づいて、パスの優先度を生成します。prio_args キーワードが必要です。

path_latency: レイテンシーアルゴリズムに基づいてパスの優先度を生成します。prio_args キーワードが必要です。

ana: Non-Volatile Memory Express (NVMe) Asymmetric Namespace Access (ANA) 設定に基づいてパスの優先度を生成します。この優先度ルーチンはハードウェアに依存します。

datacore: 一部の DataCore ストレージアレイのパス優先度を生成します。prio_args キーワードが必要です。この優先度ルーチンはハードウェアに依存します。

iet: IP アドレスに基づいて iSCSI ターゲットのパス優先度を生成します。prio_args キーワードが必要です。この優先度ルーチンは、iSCSI でのみ使用できます。

デフォルト値は、detect_prio の設定により異なります。detect_prio が yes に設定されている場合、デフォルトの優先度アルゴリズムは sysfs です。唯一の例外は NetAPP E シリーズで、デフォルトは alua です。detect_prio が no に設定されている場合、デフォルトの優先度アルゴリズムは const です。

prio_args

関数 prio に渡す引数。これは、次の prioritizer にのみ適用されます。

weighted: <hbtl,devname,serial,wwn> <regex1> <prio1> <regex2> <prio2> 形式の値が必要です。

hbtl: Regex 値は、SCSI H:B:T:L 形式にできます。例: 1:0:.:. , *:0:0:

devname: Regex 値はデバイス名形式にできます。例: sda、sd.e

serial: Regex 値はシリアル番号形式にできます。serial を、sysfs を介して検索するか、コマンド multipathd show paths format "%z" を実行して検索します。

wwn: Regex 値は、host_wwnn:host_wwpn:target_wwnn:target_wwpn の形式にできます。これらの値は、sysfs を介して検索するか、コマンド multipathd show paths format %N:%R:%n:%r" を実行して検索できます。

path_latency: io_num= <integer> base_num=<integer> の形式の値が必要です。

io_num: 現在のパスに継続的に送信される読み取り IO の数。この値は、平均パスレイテンシーの計算に役立ちます。有効な値には、Integer、[2, 200] が含まれます。

base_num: 対数スケールの基本数値。この値は、異なる優先順位を分割するのに役立ちます。有効な値には、Integer、[2, 10] が含まれます。平均レイテンシーの最大値は 100s で、平均レイテンシーの最小値は 1us です。

alua: exclusive_pref_bit 値が設定されている場合、preferred_path_bit が設定されたパスは常に独自のパスグループを作成します。

sysfs: exclusive_pref_bit 値が設定されている場合、preferred_path_bit が設定されたパスは常に独自のパスグループを作成します。

datacore: timeout=<milliseconds> preferredsds=<name> の形式の値が必要です。

preferredsds: この値は必須であり、優先される SDS 名を表します。

timeout: この値はオプションです。問い合わせのタイムアウトをミリ秒単位で設定します。

iet: preferredip=<ip_address> の形式の値が必要です。

preferredip: この値は必須です。これは、iSCSI ターゲットの優先 IP アドレス (ドット区切りの 10 進数表記) です。

デフォルト値は unset です。

features

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

features に使用できる値:

queue_if_no_path: no_path_retry を queue に設定するのと同じです。

pg_init_retries n: 失敗するまでパスグループの初期化を最高 n 回再試行します。数値は 1 から 50 の間でなければなりません。

pg_init_delay_msecs msecs: pg_init の再試行が開始されるまでのミリ秒数。数値は 0 から 60000 の間でなければなりません。

queue_mode mode: マルチパスデバイスごとにキューイングモードを選択します。mode 値のオプションは、bio、rq、または mq です。それぞれ bio-based、request-based、block-multiqueue request-based (blk-mq) に対応しています。

デフォルトでは、値は 未設定 です。

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 を使用する最初のセクターを読み取ります。

cciss_tur: HP/COMPAQ Smart Array (CCISS) コントローラーのパス状態を確認します。これはハードウェアに依存します。

none: デバイスはチェックしません。sysfs から取得した値を使用するようにフォールバックします。

デフォルト値は tur です。

alias_prefix

この属性は、user_friendly_names プレフィックスを表します。

デフォルト値は mpath です。

failback

パスグループのフェイルバックを管理します。使用できる値を以下に示します。

immediate: アクティブなパスを含む最も優先順位の高いパスグループへの即時フェイルバックを指定します。

manual: フェイルバックはすぐに実行されず、オペレーターの介入によってのみ発生することを指定します。

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

0 より大きい数値で、フェイルバックの遅延を秒単位で指定します。

デフォルト値は manual です。

rr_min_io

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

rr_min_io_rq

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

no_path_retry

この属性の数値は、キューイングを無効にする前に、パスチェッカーがマルチパスデバイス内のすべてのパスに対して何回失敗するとキューイングが無効になるかを指定します。

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

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

デフォルト値は fail です。

user_friendly_names

使用できる値を以下に示します。

yes: システムが /etc/multipath/bindings ファイルを使用して、永続的で一意のエイリアスを mpath<n> の形式でマルチパスに割り当てることができることを指定します。

no: システムは WWID をマルチパスのエイリアスとして使用します。設定ファイルの multipaths セクションで設定したデバイス固有のエイリアスは、この名前をオーバーライドします。

デフォルト値は no です。

queue_without_daemon

no に設定すると、multipathd デーモンはシャットダウン時にすべてのデバイスのキューイングを無効にします。デフォルト値は no です。

flush_on_last_del

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

max_fds

マルチパスおよび multipathd デーモンで開くことが可能な、オープンファイル記述子の最大数をセットします。これは、ulimit -n コマンドに相当します。デフォルト値は max で、これは /proc/sys/fs/nr_open からのシステム制限に設定されます。

checker_timeout

明示的なタイムアウトで、SCSI コマンドを発行するパス checker および prioritizer に使用するタイムアウト (秒) です。sys/block/sd<x>/device/timeout ディレクトリーにはデフォルト値が含まれています。

fast_io_fail_tmo

FC リモートポートで問題が検出されてから、そのリモートポート上のデバイスへの I/O が失敗するまでに SCSI レイヤーが待機する秒数。この値は dev_loss_tmo の値より小さくなければなりません。これを off に設定すると、タイムアウトが無効になります。デフォルト値は 5 です。fast_io_fail_tmo オプションは、基礎となるパスデバイスの recovery_tmo および replacement_timeout オプションの値をオーバーライドします。

dev_loss_tmo

FC リモートポートで問題が検出された後、それをシステムから削除するまで SCSI レイヤーが待機する秒数。無限に設定する場合は、2147483647 秒または 68 年に設定します。デフォルト値はオペレーティングシステムによって決定されます。

eh_deadline

SCSI デバイスに障害が発生した場合に、SCSI レイヤーがエラー処理の実行に費やす最大秒数を指定します。このタイムアウト後、scsi レイヤーはホストバスアダプター (HBA) の完全なリセットを実行します。rport が失われることがなく、そのため fast_io_fail_tmo と dev_loss_tmo はトリガーされないが、scsi コマンドは引き続きハングする場合、これを設定する必要があります。SCSI エラーハンドラーが HBA のリセットを実行すると、その HBA 上のすべてのターゲットパスに影響します。eh_deadline 値は、影響を受ける HBA 上のすべてのターゲットがマルチパス化されている場合にのみ設定する必要があります。

デフォルト値は unset です。

detect_prio

はい に設定すると、マルチパスは、デバイスが非対称論理ユニットアクセス (ALUA) をサポートする SCSI デバイスであるか、非対称名前空間アクセス (ANA) をサポートする NVMe デバイスであるかを検出します。デバイスが ALUA をサポートしている場合、マルチパスは自動的に alua prioritizer を割り当てます。デバイスが ANA をサポートしている場合、マルチパスは自動的に ana prioritizer を割り当てます。

no に設定されている場合、またはデバイスが ALUA または ANA をサポートしていない場合、prio 属性によって優先順位が設定されます。

デフォルト値は yes です。

detect_pgpolicy

detect_pgpolicy が yes に設定され、マルチパスデバイスのすべてのパスが alua または sysfs prioritizer のいずれかで設定されている場合、マルチパスは自動的に path_grouping_policy を group_by_prio または group_by_tpg に設定します。

detect_pgpolicy が no に設定されている場合、パスグループ化ポリシーは failover に設定されます。

デフォルト値は yes です。

detect_pgpolicy_use_tpg

detect_pgpolicy が yes に設定され、ALUA 互換デバイスが検出された場合に設定されるパスグループ化ポリシーを制御します。

detect_pgpolicy_use_tpg が yes に設定されている場合、detect_pgpolicy は path_grouping_policy を group_by_tpg に設定します。

detect_pgpolicy_use_tpg が no に設定されている場合、detect_pgpolicy は path_grouping_policy を group_by_prio に設定します。

デフォルト値は no です。

uid_attribute

デバイスの WWID に使用する udev 属性を指定します。

デフォルト値はデバイスに依存し、SCSI デバイスの場合は ID_SERIAL、DASD デバイスの場合は ID_UID、NVMe デバイスの場合は ID_WWN です。

force_sync

yes に設定すると、このパラメーターはパスチェッカーが非同期モードで実行されないようにします。これは、一度に 1 つのチェッカーのみが実行されることを意味します。これは、多数の multipathd チェッカーが並行して実行され、CPU に大きな負荷がかかる可能性がある場合に役立ちます。

デフォルト値は no です。

strict_timing

yes に設定すると、multipathd デーモンはちょうど 1 秒後に新しいパスチェッカーループを開始し、各パスチェックが polling_interval に設定された秒数ちょうどで実行されるようにします。ビジー状態のシステムでは、パスチェックにかかる時間が 1 秒を超える場合があります。欠落した時間は、次のラウンドで考慮されます。パスチェックにかかる時間が polling_interval に設定された秒数よりを超える場合は、警告が出力されます。

デフォルト値は no です。

retrigger_tries、retrigger_delay

retrigger_tries パラメーターと retrigger_delay パラメーターを組み合わせて使用し、multipathd が uevent を再トリガーするようにします。udev が元の uevents を完全に処理できない場合、マルチパスはデバイスを使用できなくなります。retrigger_tries パラメーターは、デバイスが完全に設定されていない場合に、マルチパスが uevent を再トリガーしようとする回数を設定します。retrigger_delay パラメーターは、再試行の間隔 (秒) を設定します。これら両方のオプションでは 0 以上の数値を使用できます。retrigger_tries パラメーターを 0 に設定すると、再試行が無効になります。retrigger_delay パラメーターを 0 に設定すると、パスチェッカーの次のループで uevent が再発行されます。

retrigger_tries のデフォルト値は 3 です。retrigger_delay のデフォルト値は 10 です。

missing_uev_wait_timeout

この属性は、multipathd デーモンが新しく作成されたマルチパスデバイスの udev から変更イベントを受信するまで待機する秒数を制御します。その後、デバイスのリロードが自動的に有効になります。ほとんどの場合、multipathd は、最初のテーブルロードから変更 uevent を受け取るまで、デバイスでのリロードを遅らせます。

デフォルト値は 30 です。

deferred_remove

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

san_path_err_threshold, san_path_err_forget_rate, san_path_err_recovery_time

この 3 つの属性すべてを 0 より大きい整数に設定すると、multipathd デーモンを有効化し、パスチェッカーの失敗頻度を監視して、不安定なパスの復帰を阻止できます。san_path_err_forget_rate チェック内で、パスチェッカーの失敗回数が san_path_err_threshold 属性の値を超える場合、multipathd デーモンは、パスチェッカーが失敗することなく san_path_err_recovery_time 属性の値 (秒単位) が経過するまでパスを復元しません。

詳細は、multipath.conf(5) の 不安定なパスの検出 セクションを参照してください。

デフォルト値は no です。

marginal_path_double_failed_time、marginal_path_err_sample_time、marginal_path_err_rate_threshold、marginal_path_err_recheck_gap_time

marginal_path_double_failed_time、marginal_path_err_rate_threshold、marginal_path_err_recheck_gap_time を 0 より大きい整数に設定し、かつ marginal_path_err_sample_time を 120 より大きい整数に設定すると、multipathd デーモンを有効化し、繰り返し失敗するパスの I/O 失敗率をテストして、不安定なパスの復帰を阻止できます。

marginal_path_double_failed_time 属性に秒単位で設定された値の範囲内でパスが 2 回失敗した場合、パスがバックアップされているとパスチェッカーが判断すると、multipathd デーモンはパスをすぐには復元しません。代わりに、multipathd は、marginal_path_err_sample_time 属性に秒単位で設定された値のパスに対して、読み取り I/O の安定したストリームを発行します。I/O 1000 回あたりのエラー数が marginal_path_err_rate_threshold 属性に設定された値より多い場合、multipathd は marginal_path_err_recheck_gap_time 秒待機してから、読み取り I/O でパスをテストする別のサイクルを開始します。それ以外の場合、multipathd はパスを復元します。

詳細は、multipath.conf(5) の 不安定なパスの検出 セクションを参照してください。

デフォルト値は no です。

marginal_pathgroups

使用できる値を以下に示します。

on: 1 つのマージナルパス検出方法によりパスがマージナルであると判断された場合、システムはそのパスを復元し、別のパスグループに配置します。このグループは、すべての非マージナルパスグループが最初に試行された後にのみ有効になります。これにより、システムは引き続きいくつかのマージナルパスを使用でき、IO エラーが発生する可能性もなくなります。パスは、設定された監視時間が経過すると、すぐに通常のパスグループに戻ります。

off: delay_*_checks、marginal_path_*、および san_path_err_* 属性は、設定された時間の監視が完了するまで、システムが marginal または shaky パスを復帰させるのを阻止します。

fpin: multipathd デーモンは fpin 通知を受信し、パスの状態を marginal に設定し、on 値で記述されているようにパスを再グループ化します。

marginal_path_* および san_path_err_* 属性は、暗黙的に no に設定されます。

詳細は、multipath.conf(5) の 不安定なパスの検出 セクションを参照してください。

デフォルト値は no です。

log_checker_err

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

skip_kpartx

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

max_sectors_kb

このオプションを使用すると、マルチパスデバイスを最初にアクティブ化する前に、マルチパスデバイスの基になるすべてのパスで max_sectors_kb デバイスキューパラメーターを指定された値に設定できます。システムが新しいマルチパスデバイスを作成するたびに、デバイスはパスデバイスから max_sectors_kb 値を継承します。手動でこの値をマルチパスデバイス向けに高めたり、パスデバイス向けにこの値を低くすると、マルチパスデバイスはパスデバイスが許可するよりも大きな I/O 操作を作成する場合があります。max_sectors_kb パラメーターを使用すると、パスデバイス上にマルチパスデバイスを作成する前にこれらの値を簡単に設定でき、無効なサイズの I/O 操作が渡されることを回避できます。このパラメーターを設定しない場合、パスデバイスドライバーが自動的に設定し、マルチパスデバイスはパスデバイスから継承します。

ghost_delay

この属性は、ゴーストパスのみでデバイスを作成した後、systemd で使用できるようにマークするまで、マルチパスが待機する秒数を設定します。これにより、マルチパスがハードウェアハンドラーを実行してゴーストパスをアクティブパスに切り替える前に、アクティブパスが表示される時間が与えられます。

これを 0 または no に設定すると、マルチパスはすぐにゴーストパスのみを持つデバイスを準備完了としてマークします。

デフォルト値は no です。

enable_foreign

この属性は、外部ライブラリーを有効または無効にします。

値は正規表現です。名前が式と一致する場合、外部ライブラリーがロードされます。

デフォルトでは、外部ライブラリーは有効になっていません。NVMe ネイティブのマルチパスサポートを有効にするには nvme を使用します。すべての外部ライブラリーを有効にするには ".*" を使用します。

recheck_wwid

yes に設定すると、失敗したパスが復元されたときに、multipathd デーモンがパスの WWID を再チェックします。WWID に変更がある場合、パスは現在のマルチパスデバイスから削除され、新しいパスとして再度追加されます。multipathd デーモンは、パス WWID が手動で再追加された場合にも再度チェックします。

このオプションは、WWID を取得するためにデフォルトの uid_attribute、ID_SERIAL、または sysfs を使用するように設定された SCSI デバイスに対してのみ機能します。

デフォルト値は no です。

remove_retries

このオプションは、マルチパスが使用中のデバイスの削除を再試行する回数を設定します。各試行の間に、マルチパスは 1 秒間非アクティブになります。デフォルトの値は 0 で、マルチパスは削除を試行しません。

detect_checker

yes に設定すると、マルチパスは、デバイスが AsymmetricLogical Unit Access (ALUA) または Redundant Disk Array Controller (RDAC) をサポートしているかチェックします。デバイスが ALUA をサポートしている場合、マルチパスはそのデバイスに tur path_checker を割り当てます。デバイスが RDAC をサポートしている場合、multipathd デーモンはそのデバイスに rdac path_checker を割り当てます。デバイスが ALUA または RDAC をサポートしていない場合、または detect_checker が no に設定されている場合、path_checker 属性はパスチェッカーを設定します。

デフォルト値は yes です。

reservation_key

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

このパラメーターは file に設定することもできます。これにより、mpathpersist は、マルチパスデバイスの登録に使用される RESERVATION KEY を prkeys ファイルに自動的に格納します。multipathd デーモンは、このキーを使用して、表示される追加のパスを登録します。登録を削除すると、RESERVATION KEY が prkeys ファイルから自動的に削除されます。これは、デフォルトで unset になっています。永続的な予約が必要な場合は、この属性を file に設定します。

all_tg_pt

mpathpersist が キーを登録する際に はい に設定すると、1 つのホストから 1 つのターゲットポートへの登録済みキーを、1 つのホストからすべてのターゲットポートへのキーとして扱います。1 つのターゲットに 1 つのホストではなく、1 つのホストからすべてのターゲットポートで登録キーを自動的に設定および消去するアレイで mpathpersist を適切に使用するには、yes に設定する必要があります。デフォルト値は no です。

auto_resize

multipathd コマンドがマルチパスデバイスのサイズを自動的に変更できるタイミングを制御します。使用できる値を以下に示します。

never: multipathd は変更なしで動作します。これはデフォルト値です。

grow_only: デバイスのパスのサイズが拡大すると、multipathd はマルチパスデバイスのサイズを自動的に変更します。

grow_shrink: デバイスのパスのサイズが縮小または拡大すると、multipathd はマルチパスデバイスのサイズを自動的に変更します。

切断をパージ

はい に設定すると、multipathd は 切断状態にある SCSI パスデバイスを自動的に削除します。これは、LUN がマッピング解除されたり、ストレージアレイによって認識されなくなった場合に発生し、システム内に残ってしまう可能性のある古い SCSI デバイスをクリーンアップするのに役立ちます。

purge_disconnected は、デフォルトの tur パスチェッカーを使用する SCSI パスデバイスに対してのみ機能します。

デフォルト値は no です。