日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
GMULTIPATH(8) FreeBSD システム管理者マニュアル GMULTIPATH(8)
名称
gmultipath -- ディスクマルチパス制御ユーティリティ
書式
gmultipath create [-ARv] name prov ...
gmultipath label [-ARv] name prov ...
gmultipath configure [-APRv] name
gmultipath add [-v] name prov
gmultipath remove [-v] name prov
gmultipath fail [-v] name prov
gmultipath restore [-v] name prov
gmultipath rotate [-v] name
gmultipath prefer [-v] name prov
gmultipath getactive [-v] name
gmultipath destroy [-v] name
gmultipath stop [-v] name
gmultipath clear [-v] prov ...
gmultipath list
gmultipath status
gmultipath load
gmultipath unload
解説
gmultipath ユーティリティは、デバイスのマルチパス (multipath) 設定のため
に使用されます。
次の 2 つの異なるメソッドを使用して、マルチパスのデバイスを設定することが
できます: ``manual'' (手動) または ``automatic'' (自動) です。``manual''
メソッドを使用するとき、メタデータは、デバイスに格納されないので、マルチ
パスのデバイスは、それが必要とされるたびに、手動によって設定されなければ
なりません。また、追加のデバイスのパスも、自動的に検出されないでしょう。
``automatic'' メソッドは、デバイスとすべてのそのパスを検出するために、
ディスク上のメタデータを使用します。メタデータは、基本的なディスクデバイ
スの最後のセクタを使用し、デバイス名と UUID を含んでいます。UUID は、共用
記憶域環境でユニークであることを保証しますが、一般的に、使用するためには
あまりにも扱いにくいです。名前は、デバイスインタフェースを通してエクス
ポートされたものです。
gmultipath への最初の引数は、実行される動作を示します:
create あらゆるディスク上のメタデータを書き込まずに、``manual'' メソッ
ドでマルチパスのデバイスを作成します。どのように適切にデバイスパ
スを識別かは、管理者の責任です。カーネルは、すべての与えられたプ
ロバイダに同じメディアとセクタサイズがあることを単にチェックしま
す。
-A オプションは、アクティブ/アクティブモードを有効にし、-R オプ
ションは、アクティブ/読み込みモードをを有効にし、そうでなけれ
ば、アクティブ/パッシブモードがデフォルトで使用されます。
label ``automatic'' メソッドでマルチパスのデバイスを作成します。指定さ
れた name を使用して、ディスク上のメタデータで最初に与えられたプ
ロバイダをラベル付けします。与えられたプロバイダの残りは、これら
のメタデータを検出するために再テストされます。関係のないプロバイ
ダの指定に対して確実に保護します。検出されたメタデータに一致しな
いプロバイダは、デバイスに追加されません。
-A オプションは、アクティブ/アクティブモードを有効にし、-R オプ
ションは、アクティブ/読み込みモードをを有効にし、そうでなけれ
ば、アクティブ/パッシブモードがデフォルトで使用されます。
configure
与えられたマルチパスデバイスを設定します。
-A オプションは、アクティブ/アクティブモードを有効にし、-P オプ
ションは、アクティブ/パッシブモードを有効にし、-R オプションは、
アクティブ/読み込み点検モードを有効にします。
add 与えられたマルチパスのデバイスへのパスとして与えられたプロバイダ
を追加します。(別のデバイスパスであることを確実と思うが、正常な
``automatic'' の方法でそのメタデータが可能ではないと試食する
(tasting)) 利用者が何を行っているか知らないなら、通常、
``manual'' メソッドで作成されたデバイスに対してのみ使用されるべ
きです。訳注: tasting の意味不明。
remove 与えられたマルチパスのデバイスのパスとして与えられたプロバイダを
削除します。最後のパスが削除されたなら、マルチパスのデバイスは、
破壊されます。
fail 指定されたマルチパスのデバイスのパスとして指定されたプロバイダを
失敗としてマークします。他のパスが存在するなら、新しい要求は、そ
こに転送されます。
restore 指定されたマルチパスのデバイスのパスとして指定されたプロバイダを
要求を扱うことを可能にして、使用できるとしてマークします。
rotate アクティブ/パッシブモードでアクティブなプロバイダ/パスを次の利用
可能なプロバイダに変更します。
prefer アクティブ/パッシブモードでアクティブなプロバイダ/パスを指定され
たプロバイダに変更します。
getactive
現在のアクティブな(複数の)プロバイダ/(複数の)パスを取得します。
destroy メタデータをクリアして与えられたマルチパスのデバイスを破壊しま
す。
stop メタデータをクリアせずに与えられたマルチパスのデバイスを停止しま
す。
clear 与えられたデバイスでメタデータをクリアします。
list geom(8) を参照してください。
status geom(8) を参照してください。
load geom(8) を参照してください。
unload geom(8) を参照してください。
SYSCTL 変数
MULTIPATH GEOM クラスの振る舞いを制御するために、次の sysctl(8) 変数を使
用することができます。
kern.geom.multipath.debug: 0
MULTIPATH GEOM クラスのデバッグレベル。これは、0 (デフォルト) ま
たは無効にする 1 に設定できます、またはおしゃべり (chattiness) の
様々な形式を有効にすることができます。
kern.geom.multipath.exclusive: 1
個別のパスのアクセスを防いで、基本的なプロバイダを排他的にオープ
ンします。
終了ステータス
終了ステータスは、成功すれば 0、コマンドが失敗するなら 1 です。
マルチパスアーキテクチャ
これは、デバイスの知識のないか、または組み込みに一致するサイズ以外の仮定
の複数のパスのアーキテクチャです。したがって、ユーザは、同じ基本的なディ
スクデバイスへの複数のパスを実際に表す、プロバイダを選択で何らかの注意を
払わなければなりません。この理由は、識別を示すことができる、複数の基本的
な転送タイプにわたっていくつかの基準があることですが、あらゆる点で、その
ような識別は、めったに最も確実であると見なすことができません。
例えば、ファイバチャネルディスクオブジェクトの World Word Port Name を使
用するなら、利用者は、異なったパス (または、バラバラにされた織物でも) で
同じ WWPN を持っている 2 つのディスクが同じディスクであると見なされるかも
しれないと信じるかもしれません。ほとんど常にこれは、安全な仮定です、利用
者が、WWPN がイーサネット MAC アドレスのような、ソフトプログラマブル実体
であると気が付くませ、設定ミスされたディレクタクラススイッチは、同じデバ
イスに複数のパスを見つけたと間違って信じているように利用者を導くかもしれ
ません。これは極端で理論的な場合ですが、同じデバイスを参照する複数のパス
名のどれが決定するためのポリシが、正しい設定の選択を行うそれら自体の記憶
域サブシステムのツールと知識を使用するシステムオペレータに残されるかもし
れないことを示すことは十分可能です。
サポートされたアクティブ/パッシブ、アクティブ/読み込みとアクティブ/アク
ティブ操作モードがあります。アクティブ/パッシブモードにおいて、1 つのパス
だけには、いずれかの時点で進歩した I/O があります。この I/O は、I/O が、
一般的な I/O エラーまたは "存在しないデバイス" エラーで返るまで続きます。
これが起こるとき、そのパスは、FAIL とマークされ、リスト中の次のパスは、ア
クティブとして選択され、失敗した I/O は、再発行されました。アクティブ/ア
クティブモードで、FAIL とマークされないすべてのパスは、同時に I/O を操作
します。要求は、負荷を均一にするためにパスの間で配信されます。能力がある
デバイスについて、すべてのパスの利用可能な帯域幅を利用することができま
す。アクティブ/読み込みモードで、FAIL とマークされないすべてのパスは、同
時に読み込みを操作しますが、アクティブ/アクティブモードと異なり、1 つのパ
スだけが、いずれかの時点で書き込み要求を操作します。(依存する書き込みを送
る前に、必要な書き込みの完了を待たない) 上記の層がデータの一貫性のために
それを必要とするなら、オリジナルの書き込み要求の順序に密接に従います。
新しいデバイスをシステムに追加するとき、MULTIPATH GEOM クラスは、これらの
新しいデバイスを経験する機会が与えられます。新しいデバイスに MULTIPATH
ディスク上のメタデータのラベルがあるなら、デバイスは、新しい MULTIPATH
GEOM を作成するか、または既存の MULTIPATH GEOM のためのパスのリストに追加
するかのいずれかで使用されます。
それは、ファイバチャネルディスクデバイスをベースとする isp(4) と mpt(4)
で合理的に動作するメカニズムです。これらのデバイスに関しては、デバイスが
見えなくなるとき (例えば、ケーブルの引き抜き、またはスイッチの電源障害の
ために)、デバイスは、積極的に死んだとマークされ、それへの I/O は失敗しま
す。これによって、単に記述された MULTIPATH 失敗イベントが生じます。
ファイバチャネルイベントが、新しいデバイスに到達したことを (例えば、 Fab ric Domain Controller からの RSCN イベントの到着)isp(4) または mpt(4) ホ
ストバスアダプタのいずれかに通知するとき、再スキャンが起こり、任意の (現
在) 新しいデバイスのアタッチメントと設定が起こり、上で説明された好みのイ
ベントを引き起こすかもしれません。
これは、このマルチパスのアーキテクチャが 1 回限りのパスのフェイルオーバ
(障害迂回) ではありませんが、失敗したパスが (自動的に、またはその他で) 修
理される限りは、安定した状態であると見なすことができることを意味します。
自動再スキャンは、、必要条件ではありません。ファイバチャネルもそうではあ
りません。同じフェイルオーバ (障害迂回) メカニズムは、伝統的な "パラレル"
SCSI に対して同様に良く動作しますが、修理されたデバイスリンクの再アタッチ
メントを引き起こすために camcontrol(8) で手動の介入を必要とします。
使用例
次の例は、利用できる複数のパスデバイスを見つけて、それらのために
MULTIPATH GEOM クラスを作成するためにどのように camcontrol(8) を使用する
かを示しています。
mysys# camcontrol devlist
<ECNCTX @WESTVILLE > at scbus0 target 0 lun 0 (da0,pass0)
<ECNCTX @WESTVILLE > at scbus0 target 0 lun 1 (da1,pass1)
<ECNCTX @WESTVILLE > at scbus1 target 0 lun 0 (da2,pass2)
<ECNCTX @WESTVILLE > at scbus1 target 0 lun 1 (da3,pass3)
mysys# camcontrol inquiry da0 -S
ECNTX0LUN000000SER10ac0d01
mysys# camcontrol inquiry da2 -S
ECNTX0LUN000000SER10ac0d01
利用者が 2 つのディスクパスを比較するためにシリアル番号を使用したからに
は、これらが同じデバイスへの複数のパスであると結論を出すためには完全に無
理ではありません。しかしながら、それらの記憶域に詳しいユーザだけがこの判
断をするための資格があります。
そして、利用者は、指定された FRED という MULTIPATH GEOM クラスをラベル付
けして、作成するために gmultipath コマンドを使用することができます。
gmultipath label -v FRED /dev/da0 /dev/da2
disklabel -Bw /dev/multipath/FRED auto
newfs /dev/multipath/FREDa
mount /dev/multipath/FREDa /mnt....
結果のコンソール出力は、次のようになります:
GEOM_MULTIPATH: da0 added to FRED
GEOM_MULTIPATH: da0 is now active path in FRED
GEOM_MULTIPATH: da2 added to FRED
ブート時に gmultipath モジュールをロードするためには、次のエントリを
/boot/loader.conf に追加します:
geom_multipath_load="YES"
関連項目
geom(4), isp(4), mpt(4), loader.conf(5), camcontrol(8), geom(8),
mount(8), newfs(8), sysctl(8)
歴史
gmultipath ユーティリティは、FreeBSD 7.0 ではじめて登場しました。
作者
Matthew Jacob <mjacob@FreeBSD.org>
Alexander Motin <mav@FreeBSD.org>
FreeBSD 13.2 March 17, 2022 FreeBSD 13.2