mkvdiskhostmap

mkvdiskhostmap コマンドは、ボリュームとホストの間に新しいマッピングを作成するために使用します。これにより、指定したホストからそのボリュームにアクセスして、入出力 (I/O) 操作を行うことができるようになります。

構文


>>-mkvdiskhostmap--+---------+-- -host--+-host_id---+----------->
                   '- -force-'          '-host_name-'   

>--+----------------------+--+-vdisk_name-+--------------------><
   '- -scsi--scsi_num_arg-'  '-vdisk_id---'

パラメーター

-force: (オプション) 通常は許可されていない、ボリュームからホストへの複数割り当てを許可します。
-host host_id | host_name: (必須) ボリュームのマップ先のホストを ID または名前のいずれかで指定します。
-scsi scsi_num_arg: (オプション) 指定のホスト上でこのボリュームに割り当てる SCSI 論理装置番号 (LUN) ID を指定します。 scsi_num_arg パラメーターには、ボリュームへのアクセス権限を提供しているすべての入出力グループで指定のホスト上のボリュームに割り当てられる SCSI LUN ID が入ります。ホスト・システムをチェックして、指定のホスト・バス・アダプター (HBA) 上で次に使用可能な SCSI LUN ID を確認する必要があります。 -scsi パラメーターを指定しない場合、アクセス権限を提供する各入出力グループ内で次に使用可能な SCSI LUN ID がホストに提供されます。-scsi パラメーターは、NVMe ホストではサポートされていません。NVMe プロトコルを使用するホストにボリュームがマップされると、システムによってボリューム名前空間 ID (NSID) が割り当てられます。
vdisk_name | vdisk_id: (必須) ホストにマップするボリュームを ID または名前で指定します。

説明

このコマンドは、ボリュームと指定のホスト間の新規のマッピングを作成します。ホストには、ボリュームは、ディスクが直接ホストに接続している場合と同様に見えます。このコマンドが処理された後に、ホストはボリュームに対して入出力トランザクションを実行できるようになります。

オプションで、SCSI LUN ID を SCSI ホストのマッピングに割り当てることができます。ホストの HBA は、ホストに接続された装置をスキャンする際に、ホストのファイバー・チャネル・ポートにマップされたすべてのボリュームを発見します。装置が見つかると、それぞれの装置に ID (SCSI LUN ID) が割り振られます。例えば、最初に検出されたディスクには SCSI LUN 0、などが割り振られます。必要な場合、SCSI LUN ID を割り当てることによって、HBA がボリュームをディスカバーする順序を制御できます。 SCSI LUN ID を指定しない場合、そのホストにすでにマッピングが存在すれば、クラスターが自動的に次の有効な SCSI LUN ID を割り当てます。 mkvdiskhostmap コマンドを発行すると、割り当てられた SCSI LUN ID 番号が返されます。

NVMe の場合、SCSI LUN ID は無関係であるため、システムは代わりに NSID を割り当てます。NSID は変更することができません。 NVMe ボリュームへのマッピングを作成すると、NSID が返されます (NSID は vdisk_ID + 1 です)。

mkvdiskhostmap コマンドは、次の場合に失敗します。

このマッピングが作成されている対象のホストが、ボリューム・アクセス・セット内のどの入出力グループとも関連付けられていない
ボリュームが、アクセス・セット内に複数の入出力グループを持っており、ボリュームにマップされているホストが、複数の入出力グループからマッピングされているボリュームをサポートしていない
ホスト・プロトコルがボリューム・プロトコルと非互換である
ボリュームに複数のアクセス入出力グループがあり、ホスト・プロトコルが NVMe である

要確認: iSCSI ホストは、複数の入出力グループ (および単一の入出力グループ) からアクセスできるボリュームにアクセスできます。

別の SCSI LUN ID を生成する場合、返されるのは 1 つのみです。返される ID は、ボリュームがマップされたいた入出力グループのうち、最も大きい番号の入出力グループの ID です。他の値を表示するには、lshostvdiskmap または lsvdiskhostmap を発行します。

SCSI LUN ID は、ボリュームがマップされている入出力グループのうち、もっとも大きい番号の入出力グループのものが使用されます。

一部の HBA デバイス・ドライバーは、SCSI LUN ID 内にギャップを検出すると停止します。例えば、次のとおりです。

ボリューム 1 が、SCSI LUN ID 1 をもつホスト 1 にマップされている。
ボリューム 2 が、SCSI LUN ID 2 をもつホスト 1 にマップされている。
ボリューム 3 が、SCSI LUN ID 4 をもつホスト 1 にマップされている。

ID 3 にマップされた SCSI LUN がないため、デバイス・ドライバーが HBA をスキャンする際にボリューム 1 と 2 を識別した後に停止します。パフォーマンスを最適にするには、必ず SCSI LUN ID の割り振りが連続するようにしてください。

複数のボリュームの割り当てを作成することが可能です (例えば、複数のホストに同一のボリュームを割り当てることができます。これは、1 つのボリュームを複数のホストに割り当てるクラスター化システムのホストにとって特に有用となります)。通常は、複数のホストがディスクにアクセスできる場合に破損が発生しやすいため、ボリュームからのホストへの複数の割り当ては使用されません。ただし、特定のマルチパス環境では、ボリュームは複数のホストにマップされている必要があります。これには、IBM® SAN ファイル・システムが含まれます。複数のホストにマップするには、mkvdiskhostmap コマンドで -force パラメーターを使用する必要があります。例: mkvdiskhostmap -host host1 -force 4 mkvdiskhostmap -host host2 -force 4

注: 複数のホストに同一のボリュームを割り当てる場合は、すべてのホストに同一の SCSI ID を使用する必要があります。

これらのコマンドは、ボリューム 4 について、ホストからボリュームへのマッピングを 2 つ (host1 と host2 へのマップ) 作成します。既にボリュームがホストにマップされている場合は、-force パラメーターを省略するとマッピングが失敗します。

(このマッピングの対象である) ホスト・オブジェクトが、ボリュームが属する入出力グループに関連付けられていない場合も、コマンドは失敗します。

ホスト (タイプ hide_secondary) と、リモート・コピー関係の 2 次ボリュームのボリュームとの間に新規マッピングが作成される場合、以下のようになります。

マッピングは構成の目的で作成されます (変更または削除が可能です)
2 次ボリュームはホストに提示されません

マップされたボリュームがホストに提示されるのは、以下の場合です。

ホスト・タイプが hide_secondary 以外のタイプに変更された
-access を指定することによってリモート・コピー関係が停止された
リモート・コピー関係が削除されたか切り替えられたために、ボリュームが 2 次ボリュームではなくなった

注: ボリュームがアクティブ/アクティブ関係における補助ボリュームである場合や、あらゆるタイプの関係における変更ボリュームである場合、このコマンドを指定することはできません。

要確認: このコマンドは、ファイル・システムによって所有されているボリュームに対しては使用できません。

注: NVMe 仕様の制限によって、HyperSwap® ボリュームおよび複数のアクセス入出力グループを持つボリュームは、NVMe ホストにマップすることができません。

呼び出し例

mkvdiskhostmap -host host1 -scsi 1 5

結果出力:

Virtual Disk to Host map, id [1], successfully created