suri - storage URIs
ストレージ URI はさまざまなノード全体でストレージオブジェクトを一意に識別します。
個々のスライスを参照できる dev URI は別として、ほかのすべての URI タイプは常にディスク全体を表します。こうしたディスクはスライスのないデバイスパスとして表されます。たとえば、/dev/dsk/c0t0d0 や /dev/dsk/c0t5000c5000288fa25d0 です。Such a device path without a slice may not exist for all disks on the system and the consumer of storage URIs must be prepared for that.zpool(8) は、/dev/dsk/cXtXdX リンクが存在しない場合でも、既存のブロック型デバイスの cXtXdX デバイスパスを常に受け入れます。
すべてのストレージ URI タイプがストレージオブジェクトの作成をサポートしているわけではありません。各タイプの説明については、下を参照してください。ストレージオブジェクトの作成をサポートする URI タイプの場合は、suriadm create サブコマンドを –p create-size オプションとともに使用します。ストレージオブジェクトは、手動でも作成できます。ストレージオブジェクトがマッピングプロセスの一部として作成されることはサポートされていません。
次のストレージ URI がサポートされています。
dev:<local-path-under-/dev> dev://<absolute-path-to-device> dev:<absolute-path-to-device>
Examples:
dev:dsk/c0t0d0s0 dev:///dev/dsk/c0t0d0s0 dev:/dev/dsk/c0t0d0s0 dev:chassis/SYS/HD1/disk
The device URI specifies an object in the form of an existing device.すべての形式の dev URI は機能的に同等です。The dev:dsk format with no authority section and an implied /dev/ path prefix is usually preferred.The path must always identify a device within the /dev name space.
Components of the device path may only include characters from the POSIX.1-2008 Portable Filename Character Set, 0-9a-zA-Z._-.
The dev URI type does not support the create operation.
lu:luname.naa.<ID> lu:luname.eui.<ID> lu:initiator.naa.<ID>,target.naa.<ID>,luname.naa.<ID> lu:initiator.naa.<ID>,target.naa.<ID>,luname.eui.<ID>
Examples:
lu:luname.naa.5000c5000288fa25 lu:luname.eui.0021280001cf80f6 lu:initiator.naa.2100001d38089fb0,target.naa.2100001d38089fb0,luname.naa.5000c5000288fa25 lu:initiator.naa.2100001d38089fb0,target.naa.2100001d38089fb0,luname.eui.0021280001cf80f6
Logical unit URI specifies a logical unit attached via Fibre Channel or serial-attached SCSI.luname のみの URI 形式では、ID は論理ユニット名を示します。initiator、target、luname 形式で、initiator はイニシエータポートを指定し、target はターゲットポートを指定します。さらにこれらはまとめて、luname のみの形式の場合のように、名前が URI の luname 部分に一致している必要がある論理ユニットへのパスを指定します。
ID は 16 進数 (64/128 ビット) でフォーマットされた SCSI-3 VPD ページ (0x83) 論理ユニット名を使用して表されます。ID は大文字と小文字が区別されません。NAA または EUI-64 識別子に基づいた論理ユニット名のみがサポートされています。識別子の形式については、「ノート」を参照してください。
一般に、luname のみの URI と組み合わせてマルチパスを使用することが推奨されます。マルチパスが無効で、luname のみの URI が使用されている場合、指定した論理ユニットへのランダムパスが選択されます。このランダムパスの割り当てを回避するには、initiator, target, luname URI 形式を使用して論理ユニットへの特定のパスを選択できます。マルチパスが有効で、initiator, target, luname URI 形式を使用している場合、マルチパスフレームワークによって、論理ユニットにアクセスするために使用するパスが制御され、URI はアクセスパスではなく、ユニットを識別するためにのみ使用されます。
イニシエータやターゲット ID が一致していないが、論理ユニットが論理ユニット名に基づいて見つかった場合、ユニットには代替パス経由でアクセスされます。
The lu URI type does not support the create operation.
iscsi:///luname.naa.<ID> iscsi:///luname.eui.<ID> iscsi://<host>[:<port>]/luname.naa.<ID> iscsi://<host>[:<port>]/luname.eui.<ID> iscsi:///target.<IQN>,lun.<LUN> iscsi:///target.eui.<ID>,lun.<LUN> iscsi://<host>[:<port>]/target.<IQN>,lun.<LUN> iscsi://<host>[:<port>]/target.eui.<ID>,lun.<LUN>
IQN stands for iSCSI Qualified Name, which has the form iqn.YYYY-MM.<org-naming-auth>[:<string-defined-by-org>].IQN 形式は、『RFC 3721, Internet Small Computer Systems Interface (iSCSI) Naming and Discovery』で定義され、詳しく説明されています。It is recommended that <string-defined-by-org> be a Universally Unique Identifier (UUID).
The use of the target,lun form of the iSCSI URI will only be transferable between hosts if the mapping from the initiator, target, and LUN to the logical unit name is configured to be independent of the initiator.
Examples:
iscsi:///luname.eui.0021280001cf80f6 iscsi:///luname.naa.600144f03d70c80000004ea57da10001 iscsi://[::1]/luname.naa.600144f03d70c80000004ea57da10001 iscsi://127.0.0.1/luname.naa.600144f03d70c80000004ea57da10001 iscsi://127.0.0.1:3260/luname.naa.600144f03d70c80000004ea57da10001 iscsi://hostname:3260/luname.eui.0021280001cf80f6 iscsi://hostname:3260/luname.naa.600144f03d70c80000004ea57da10001 iscsi://127.0.0.1/target.iqn.com.sun:02:d0f2d311-f703,lun.0 iscsi://127.0.0.1/target.eui.bbbbbbbbbbff0011,lun.0 iscsi://127.0.0.1:3260/target.iqn.com.sun:02:d0f2d311-f703,lun.3 iscsi://127.0.0.1:3260/target.eui.bbbbbbbbbbff0011,lun.3 iscsi:///target.iqn.com.sun:02:d0f2d311-f703,lun.6 iscsi:///target.eui.bbbbbbbbbbff0011,lun.6 iscsi://[::1]/target.iqn.com.sun:02:d0f2d311-f703,lun.2 iscsi://[::1]/target.eui.bbbbbbbbbbff0011,lun.2 iscsi://hostname:3260/target.iqn.com.sun:4db41b76-e3d7-cd2f-bf2d-9abef784d76c,lun.0 iscsi://hostname:3260/target.eui.bbbbbbbbbbff0011,lun.0
iSCSI URI は iSCSI プロトコル経由でアクセス可能な論理ユニット番号に基づいてオブジェクトを指定します。Optional hostname[:<port>] authority section provides information for a consumer to set up a send-targets discovery address.IPv6 アドレスは角括弧で囲む必要があります。
ID の形式については、「論理ユニット URI」セクションで説明しています。NAA および EUI-64 ベースの識別子形式の詳細については、「ノート」を参照してください。
The iscsi URI type does not support the create operation.
nfs://<user>:<group>@<host>[:<port>]/<nfs-share-path>/<file>
Examples:
nfs://admin:staff@host/export/test/nfs_file nfs://admin:staff@host:1000/export/test/nfs_file
The NFS URI specifies an object based on a labeled lofi device created on the given NFS file.NFS ファイルは、ユーザーとグループから取得された資格情報を使用してアクセスされます。ユーザーとグループは usernames または userids として指定できます。ホストは IPv4 アドレス、IPv6 アドレス、またはホスト名として指定できます。IPv6 アドレスは角括弧で囲む必要があります。
Components of the NFS share path may only include characters from the POSIX.1-2008 Portable Filename Character Set, 0-9a-zA-Z._-.
The nfs URI type supports the create operation.
file://<user>:<group>@<host>/<file-path>
Examples:
file://admin:staff@/filepath file://admin:staff@localhost/filepath
The file URI specifies an object based on a labeled lofi device created on the given local file.ファイルは、ユーザーとグループから取得された資格情報を使用してアクセスされます。ユーザーとグループは usernames または userids として指定できます。ホストを指定する必要はありませんが、指定する場合は localhost である必要があります。
Components of the file path may only include characters from the POSIX.1-2008 Portable Filename Character Set, 0-9a-zA-Z._-.
The file URI type supports the create operation, and may also be mapped to a removable/read-only device.
URI を手動で生成することによるエラーを避けるには、suriadm(8) のサブコマンド lookup-uri を使用して、既存のシステムデバイスパス、論理ユニット名、またはその他の情報に基づいて URI を生成することをお勧めします。詳細は、suriadm(8) のマニュアルページを参照してください。このような情報は、ほかの手段を使用して事前に識別されます。ファイバチャネルデバイスの場合は、fcadm(8) を使用できます。Serial Attached SCSI デバイスの場合は、sasinfo(8) を使用できます。iSCSI デバイスの場合は、iscsiadm(8) を使用できます。
属性についての詳細は、マニュアルページの attributes(7) を参照してください。
|
attributes(7), fcadm(8), iscsiadm(8), lofi(4D), sasinfo(8), suriadm(8), zpool(8)
『Small Computer System Interface-3 (SCSI-3)』
RFC 3986 - Uniform Resource Identifier (URI): Generic Syntax
NAA は Name Address Authority の略であり、形式とその識別子の長さを指定する識別子内のフィールドです。NAA 識別子の形式は、SCSI Primary Commands - 3 仕様の 7.6.3.6 NAA 識別子形式に関するセクションに定義されています。WWN (World Wide Name) 識別子では NAA 識別子形式が使われます。EUI-64 は、64 ビットの拡張一意識別子を表し、その形式は IEEE によって定義されています。