/usr/sbin/suriadm command [options] [operands]
/usr/sbin/suriadm parse [-H] [-o p,p,...] URI /usr/sbin/suriadm normalize URI /usr/sbin/suriadm map [-H] [-o p,p,...] URI /usr/sbin/suriadm lookup-mapping [-H] [-o p,p,...] URI /usr/sbin/suriadm unmap URI /usr/sbin/suriadm lookup-uri [-t uri-type] device-path /usr/sbin/suriadm lookup-uri [-t uri-type] -p mapped-dev=<device-path> /usr/bin/suriadm lookup-uri [-t uri-type] -p luname=<luname> /usr/sbin/suriadm lookup-uri [-t uri-type] -p target=<target> -p lun=<LUN>
suriadm 命令行管理工具允许系统用户通过存储 URI 管理存储对象。该命令可以对映射进行解析、映射和取消映射,并可查询映射的状态以及查找存储 URI。
支持的存储 URI 在 suri(5) 手册页中进行了定义。
支持以下子命令:
解析给定的 URI,并显示缺省的属性列表。如果使用 –H,则输出将省略标头。如果使用 –o,则仅显示所提供的列表中的属性。–o 选项表示输出位于一行上,其中,属性值以制表符分隔,可由另一个命令进一步处理。
–o 选项允许使用的属性名称包括:uri-type、uri、path、mapped-dev、initiator、target、luname、lun、hostname 和 port。
基于 URI 类型的标准化规范对存储 URI 字符串进行解析和标准化。显示标准化的 URI,不接受任何选项。
对于 iSCSI 或逻辑单元 URI,此子命令将 URI 中的所有字母字符转换为小写字符。
对于 iSCSI URI,此子命令还删除 URI 中存在的缺省 iSCSI 端口 "3260"。
对于设备 URI 类型,所有跟随在 URI 类型名称之后的前导正斜杠和路径组件开头出现的 "/dev"(如果存在)将被删除。
解析存储 URI,必要时配置存储子系统以实例化与所提供的 URI 对应的设备,并显示设备路径。如果该设备已实例化,则 map 操作将仅查找设备路径。
对于 iSCSI URI,如果存在 URI 授权部分,则该子命令将添加一个 send-targets 搜索地址,主机名将解析到该地址。
对于逻辑单元和 dev URI 类型,该子命令对系统配置没有任何影响。
解析 URI 并查找存储 URI 与本地系统设备路径所表示的对象之间的现有映射。该命令将显示缺省的属性列表。选项 –H 和 –o 与在 parse 子命令中使用时的含义相同。
解析假定已映射的对象,并对其取消映射。不显示任何属性,也不接受任何选项。
对于 iSCSI URI,该子命令将删除 URI 授权部分(如果有)中的主机名要解析到的搜索地址。
对于逻辑单元和 dev URI 类型,该子命令对系统配置没有任何影响。
根据本地系统设备路径查找并显示 URI。–t 允许使用的 URI 类型包括 dev、lu 和 iscsi。如果未指定 –t 选项,则输出将包含与任何 URI 类型的设备路径匹配的所有 URI。使用属性选项 "–p" 是可选的。
基于逻辑单元名称查找并显示 LU 和 iSCSI URI。–t 允许使用的 URI 类型为 lu 和 iscsi。如果未指定 –t 选项,输出将包含所有标识给定逻辑单元名称匹配的逻辑单元的 URI。
如果逻辑单元名称没有隐式 ID 类型(例如在基于 IQN 的名称中),则必须显式说明 ID 类型。请参见“示例”部分。
基于目标端口和 LUN 查找并显示 URI。–t 允许使用的 URI 类型为 lu 和 iscsi。如果未指定 –t 选项,输出将包含所有标识指定目标和 LUN 匹配的逻辑单元的 URI。通常,输出中仅显示一个 URI 类型,即使不使用 –t 选项也是如此。
目标必须包含一个标识符类型和标识符,二者用句点进行分隔。支持的 ID 类型为 "naa" 和 "iqn"。光纤通道目标端口始终是基于 NAA 的名称。iSCSI 目标端口始终是基于 IQN 的名称。请参见“示例”部分。
LUN 是一个十进制数字。
以下命令将解析 iSCSI URI 并显示缺省的属性列表。
$ suriadm parse iscsi://10.0.0.1:3260/luname.naa.0123456789abcdef PROPERTY VALUE uri-type iscsi hostname 10.0.0.1 port 3260 luname naa.0123456789abcdef target - lun -
$ suriadm parse iscsi://10.0.0.1:3260/target.iqn.1990-12.com.sun\ :cng-002,lun.3 PROPERTY VALUE uri-type iscsi hostname 10.0.0.1 port 3260 luname - target iqn.1990-12.com.sun:cng-002 lun 3示例 2 映射 iSCSI URI 并显示设备名称
以下命令将映射 iSCSI URI 并显示已映射的本地系统设备名称。此命令的作用是自动添加一个 send-targets 搜索地址(如果还没有该地址)。
$ suriadm map iscsi://127.0.0.1/luname.naa.\ 600144F0F4977D4000004F7EC8F00001 PROPERTY VALUE mapped-dev /dev/dsk/c0t600144F0F4977D4000004F7EC8F00001d0s2示例 3 查找映射
以下命令将查找现有的 iSCSI 映射。
$ suriadm lookup-mapping iscsi://127.0.0.1/\ luname.naa.600144F0F4977D4000004F7EC8F00001 PROPERTY VALUE mapped-dev /dev/dsk/c0t600144F0F4977D4000004F7EC8F00001d0s2示例 4 解析逻辑单元 URI
以下命令将解析 initiator/target/luname 逻辑单元 URI。
$ suriadm parse lu:initiator.naa.2101001b32ae7ab5,\ target.naa.2100001d38089fb0,luname.naa.500000e012942880 PROPERTY VALUE uri-type lu luname naa.500000e012942880 initiator naa.2101001b32ae7ab5 target naa.2100001d38089fb0示例 5 映射逻辑单元 URI,查找 URI
以下命令序列将映射逻辑单元 URI,然后根据找到的设备名称查找匹配的逻辑单元 URI。
$ suriadm map lu:luname.naa.5000c5000288fa25 PROPERTY VALUE mapped-path /dev/dsk/c7t26d0s2 $ suriadm lookup-uri -t lu /dev/dsk/c7t26d0s2 lu:luname.naa.5000c5000288fa25 lu:initiator.naa.500605b000ae7010,target.naa.\ 5001636000019c11,naa.5000c5000288fa25示例 6 查找匹配的 URI
以下命令将在不指定 URI 类型的情况下查找与特定设备名称匹配的所有 URI。
$ suriadm lookup-uri /dev/dsk/c7t26d0s2 lu:luname.naa.5000c5000288fa25 lu:initiator.naa.500605b000ae7010,target.naa.5001636000019c11,\ luname.naa.5000c5000288fa25 dev:dsk/c7t26d0s2示例 7 解析 URI,显示选定属性
以下命令将解析 URI,然后仅显示选定属性,所有属性都显示在同一行中,以制表符分隔,并且没有标头。
$ suriadm map -Ho uri-type,luname,mapped-path \ lu:luname.naa.5000c5000288fa25 lu naa.5000c5000288fa25 /dev/dsk/c7t26d0s2示例 8 查找逻辑单元 URI
以下命令将查找可通过多个路径访问的设备的逻辑单元 URI。
$ suriadm lookup-uri -t lu /dev/dsk/c11t2000001D38089FB0d0 lu:luname.naa.2000001d38089fb0 lu:initiator.naa.2101001b32ae7ab5,target.naa.2100001d38089fb0,luname.\ naa.2000001d38089fb0 lu:initiator.naa.2100001b328e7ab5,target.naa.2200001d38089fb0,luname.\ naa.2000001d38089fb0示例 9 尝试解析错误的 URI
以下命令将尝试解析语法错误的 URI。
$ suriadm parse lu:luname.naa.0123456789 Failed to parse URI "lu:luname.naa.0123456789": GUID part in "luname.naa.GUID" not 16 or 32 character hexadecimal number: "0123456789"示例 10 尝试映射无法访问 LU 的 LU URI
以下命令将尝试映射无法从系统中访问逻辑单元名称的 LU URI。
$ suriadm map lu:luname.naa.0123456789abcdef Failed to map URI "lu:luname.naa.0123456789abcdef": No such logical unit "naa.0123456789abcdef" found示例 11 查找不存在的设备路径的 URI
以下命令将尝试查找不存在的设备路径的 URI。
$ suriadm lookup-uri /dev/dsk/nonexistent Failed to map "/dev/dsk/nonexistent" to URI: No such device: "/dev/dsk/nonexistent"示例 12 查找 dev URI
以下命令序列说明了这样一个事实:dev URI 是接受指定分片的磁盘路径名的唯一 URI 类型。
$ suriadm lookup-uri -t dev /dev/dsk/c0t500000E012942880d0s0 dev:dsk/c0t500000E012942880d0s0 $ suriadm lookup-uri -t iscsi \ /dev/dsk/c0t600144F03E0A0C0000004FAB3B660001d0s0 Failed to look up "iscsi" URI for device: \ "/dev/dsk/c0t600144F03E0A0C0000004FAB3B660001d0s0": \ Device path with slice does not represent entire disk示例 13 标准化 URI
以下命令标准化 iSCSI URI。
$ suriadm normalize iscsi://10.0.0.1:3260/luname.naa.0123456789ABCDEF iscsi://10.0.0.1/luname.naa.0123456789abcdef
以下调用标准化 dev URI。
$ suriadm normalize dev:/dev/dsk/c0t0d0 dev:dsk/c0t0d0
$ suriadm normalize dev:///dev/dsk/c0t0d0 dev:dsk/c0t0d0示例 14 基于目标和 LUN 获取 URI
以下命令显示如何基于目标和 LUN 获取 URI。
$ suriadm lookup-uri -p target=naa.2100001d38089fb0 -p lun=0 lu:luname.naa.500000e012942880 lu:initiator.naa.2101001b32ae7ab5,target.naa.2100001d38089fb0,luname.naa.50000 0e012942880
$ suriadm lookup-uri -p lun=0 -p target=iqn.1986-03.com.sun:02:9548ddf8-dc44-63a1-b773-e7ac335a760f iscsi://10.0.0.1/luname.naa.600144f0a5320b470000527d66740009 iscsi://10.0.0.1/target.iqn.1986-03.com.sun:02:9548ddf8-dc44-63a1-b773-e7ac335 a760f,lun.0示例 15 基于逻辑单元名称获取 LU URI
以下命令显示如何基于逻辑单元名称获取 LU URI:
$ suriadm lookup-uri -t lu -p luname=naa.5000cca012b66e90 lu:luname.naa.5000cca012b66e90 lu:initiator.naa.5080020000fafcf8,target.naa.5000cca012b66e91,luname.naa.5000c ca012b66e90
命令成功。
命令失败。
有关下列属性的说明,请参见 attributes(5):
|
stmsboot(1M)、svcadm(1M)、attributes(5)、suri(5)、scsi_vhci(7D)、libsuri(3LIB)
《Small Computer System Interface-3》(SCSI-3)
如果使用 iSCSI URI,则必须启用 svc:/network/iscsi/initiator 服务,除非正在执行解析操作。如果正在处理 iSCSI URI 而该服务已禁用,则会自动临时启用 iSCSI 启动器服务。从不通过 suriadm 命令禁用该服务。