手册页部分 5: 标准、环境和宏

退出打印视图

更新时间: 2014 年 7 月
 
 

suri(5)

名称

suri - 存储 URI

描述

存储 URI 用于唯一标识不同节点间的存储对象。

支持以下存储 URI:

设备 URI

dev:<local-path-under-/dev>
dev:///<path-with-dev>
dev:<absolute-path-with-dev>

示例:

dev:dsk/c0t0d0s0
dev:///dev/dsk/c0t0d0s0
dev:/dev/dsk/c0t0d0s0

设备 URI 用于以现有设备的形式指定对象。设备 URI 的所有形式在功能上都是等同的。通常,首选使用不具有授权部分而具有隐含 “/dev/” 前缀的 “dev:dsk” 格式。该路径必须是 /dev 名称空间中的一个设备。

该设备路径中的各个组成部分只能包含 POSIX.1-2008 可移植文件名字符集中的字符:0-9a-zA-Z._-。

逻辑单元 URI

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>

示例:

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

逻辑单元 URI 用于指定通过光纤通道或串行连接 SCSI 连接的逻辑单元。在仅具有 luname 的 URI 格式中,ID 用于描述逻辑单元名称。在 initiator,target,luname 格式中,initiator 用于指定启动器端口,target 用于指定目标端口,这两者共同指定逻辑单元的路径,该逻辑单元的名称必须与该 URI 在仅具有 luname 的格式中的 luname 部分匹配。

ID 采用 SCSI-3 VPD 页面 (0x83) 逻辑单元名称来表示,该名称的格式为十六进制数字(64/128 位)。ID 不区分大小写。仅支持基于 NAA 或 EUI-64 标识符的逻辑单元名称。有关标识符格式的信息,请参见“附注”部分。

通常,建议将仅具有 luname 的 URI 与多路径结合使用。如果采用仅具有 luname 的 URI 而禁用了多路径,则会为指定的逻辑单元选择一个随机路径。要避免分配此随机路径,可以使用 initiator,target,luname URI 格式为逻辑单元选择一个特定路径。如果采用 initiator,target,luname URI 格式并启用了多路径,则多路径框架可控制用于访问该逻辑单元的路径,而该 URI 仅用于标识该单元,而不是访问路径。

如果启动器和/或目标 ID 不匹配,但根据逻辑单元名称找到该逻辑单元,则会通过备用路径访问该单元。

iSCSI URI

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://<host>[:<port>]/target.<IQN>,lun.<LUN>

IQN 代表 iSCSI Qualified Name(iSCSI 限定名),采用 iqn.YYYY-MM.<org-naming-auth>[:<string-defined-by-org>] 格式。RFC 3721 文档《Internet Small Computer Systems Interface (iSCSI) Naming and Discovery》中定义了 IQN 格式并通过示例对其进行了详细阐述。建议 <string-defined-by-org> 为通用唯一标识符 (Universally Unique Identifier, UUID)。

请注意,如果从启动器、目标和 LUN 到逻辑单元名称的映射配置为独立于启动器,则使用目标、LUN 格式的 iSCSI URI 将只在主机之间可传输。

示例:

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:3620/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:3620/target.iqn.com.sun:02:d0f2d311-f703,lun.3
iscsi:///target.iqn.com.sun:02:d0f2d311-f703,lun.6
iscsi://[::1]/target.iqn.com.sun:02:d0f2d311-f703,lun.2
iscsi://hostname:3620/target.iqn.com.sun:4db41b76-e3d7-cd2f-bf2d-9abef784d76c,lun.0

iSCSI URI 可根据可通过 iSCSI 协议访问的逻辑单元编号指定对象。可选 hostname[:<port>] 授权部分用于提供使用者设置发送目标搜索地址所需的信息。IPv6 地址必须括在方括号中。

ID 的格式在“逻辑单元 URI”部分进行了说明。有关基于 NAA 和 EUI-64 的标识符格式的信息,请参见“附注”部分。

获取 URI

要通过手动生成 URI 来避免错误,建议使用 suriadm(1M) 子命令 lookup-uri 根据现有系统设备路径来生成 URI。此类设备路径必须通过其他方式进行标识。对于光纤通道设备,可以使用 fcadm(1M)。对于串行连接 SCSI 设备,可以使用 sasinfo(1M)。对于 iSCSI 设备,可以使用 iscsiadm(1M)

属性

有关下列属性的说明,请参见 attributes(5)

属性类型
属性值
可用性
system/library/storage/suri
接口稳定性
Committed(已确定)

另请参见

fcadm(1M)iscsiadm(1M)sasinfo(1M)suriadm(1M)attributes(5)

《Small Computer System Interface-3》(SCSI-3)

附注

NAA 代表 Name Address Authority(名称地址授权机构),它是标识符中的一个字段,用于指定该标识符的格式和长度。NAA 标识符格式在《SCSI Primary Commands - 3》规范的 "7.6.3.6 NAA identifier format" 部分进行了定义。WWN(World Wide Name,全局名称)标识符采用 NAA 标识符格式。EUI-64 代表 64 位扩展唯一标识符,其格式由 IEEE 进行了定义。