用法概要

请告诉我们如何提高我们的文档：

Your rating has been updated

感谢您的反馈！

您的反馈将非常有助于我们提供更好的文档。您是否愿意参与我们的内容改进并提供进一步的意见？

stmfadm

- SCSI 目标模式框架命令行接口

stmfadm add-hg-member [-F] -g, --group-name group-name group-member...

stmfadm add-tg-member -g, --group-name group-name group-member...

stmfadm add-view [-n, --lun logical-unit-number
     -t, --target-group group-name -h, --host-group group-name] lu-name

stmfadm create-hg group-name

stmfadm create-lu [-p, --lu-prop logical-unit-property=val
     -s, --size size] lu-file

stmfadm create-tg group-name

stmfadm delete-hg group-name

stmfadm delete-lu lu-name

stmfadm delete-tg group-name

stmfadm import-lu lu-file

stmfadm list-hg [-v] [host-group-name...]

stmfadm list-tg [-v] [target-group-name...]

stmfadm list-lu [-v] [lu-name...]

stmfadm list-target [-v] [target-name...]

stmfadm list-view [-v] -l, --lu-name lu-name [entry-name...]

stmfadm list-state

stmfadm modify-lu [-p, --lu-prop logical-unit-property=val
     -s, --size size, -f, --file] lu-name|lu-file

stmfadm online-lu lu-name

stmfadm offline-lu lu-name

stmfadm online-target target-name

stmfadm offline-target target-name

stmfadm remove-hg-member -g, --group-name group-name group-member...

stmfadm remove-tg-member -g, --group-name group-name group-member...

stmfadm remove-view -l, --lu-name lu-name entry-name

描述

stmfadm 命令用于在 SCSI 目标模式框架 (SCSI Target Mode Framework, STMF) 内配置逻辑单元。该框架与本手册页使用以下术语：

启动器

负责向 SCSI 目标和逻辑单元发出 SCSI I/O 命令的设备。

target

负责为逻辑单元接收 SCSI I/O 命令的设备。

逻辑单元

目标内负责执行 SCSI I/O 命令的设备。

逻辑单元号

目标内的逻辑单元的标识符。

启动器组

启动器组是指一个或多个可组合用于同一视图（请参见下文）的启动器的集合。除非将 -F 选项与 add-hg-member 子命令一起使用，否则一个启动器不能成为多个启动器组的成员。

目标组

目标组是指一个或多个在创建视图（请参见下文）时可采用相同方式进行处理的 SCSI 目标端口的集合。一个特定 SCSI 启动器可以看到的逻辑单元集是由视图的组合集确定的。

每个逻辑单元都具有一组视图条目，每个视图条目指定一个目标组、主机组和一个 LUN。在通过该目标组进行连接时，来自该主机组的启动器能够识别并连接到使用指定 LUN 的该逻辑单元。您可以使用视图来限制特定启动器可以看到的逻辑单元集，并分配将使用的 LUN 集。

视图

视图定义了启动器组、目标组和逻辑单元号与指定逻辑单元的关联关系。添加到逻辑单元的任何视图条目不能与该逻辑单元中现有的视图条目相冲突。尝试复制任何指定启动器、目标与逻辑单元号的关联关系时，系统会将视图条目视为冲突条目。例如，逻辑单元 LU_0 包含与之关联的以下视图条目：

Logical Unit: LU_0
            View Entry: 0    
                initiator group: HostA
                target group: All targets
                logical unit number: 32

如果您尝试了以下操作：

# stmf add-view -n 31 -h HostA LU_0

...此操作将返回一个错误并显示一条消息，指出视图条目与一个或多个现有视图条目相冲突。之所以会产生此冲突，是因为现有视图条目 0 已经为启动器组 HostA 将 LU_0 映射到了逻辑单元号 32。

子命令

stmfadm 命令支持下列子命令。

add-view [-n, --lun logical-unit-number -t, --target-group group-name -h, --host-group group-name] lu-name

将一个逻辑单元视图条目添加到逻辑单元 lu-name，其中 lu-name 是逻辑单元的 STMF 名称，如 list-lu 子命令所示。add-view 子命令为用户提供了针对逻辑单元的访问控制实施机制，并为包含启动器和目标的给定集合的逻辑单元提供了逻辑单元号的分配方法。必须至少有一个应用的视图，然后才能将逻辑单元提供给启动器使用。每个视图条目都将分配一个条目名称，在 remove-view 和 list-view 子命令中可使用该名称来引用条目。

add-view 支持以下选项：

-n, --lun logical-unit-number: logical-unit-number 是为此视图条目分配给逻辑单元的一个整数，其范围是 0-16383。如果未指定此选项，则将由 STMF 框架来分配逻辑单元号。
-t, --target-group group-name: group-name 是之前使用 STMF create-tg 子命令创建的目标组的名称。如果未指定此选项，将可通过所有目标使用此逻辑单元。
-h, -host-group group-name: group-name 是之前使用 STMF create-hg 子命令创建的主机组的名称。如果未指定此选项，此逻辑单元将可供登录到 STMF 框架的所有启动器使用。

add-hg-member [-F, -–force] -g group-name group member...

向主机组添加主机组成员。group-name 必须是使用 create-hg 子命令创建的一个现有组。group member 可以指定为 name_type.name_value，其中 name_type 可以为下列项之一：

wwn
iqn
eui

...name_value 是启动器名称的值。例如，要向主机组 HostA 添加光纤通道启动器端口全局名称 200000e08b909221，应使用的命令为：

# stmfadm add-hg-member -g HostA wwn.200000e08b909221

要向 HostA 添加名为 iqn.1986-03.com.sun:01.46f7e262 的 ISCSI 启动器节点成员，应使用的命令为：

# stmfadm add-hg-member -g HostA iqn.1986-03.com.sun:01.46f7e262

此外，还可以使用成员的 SCSI 名称字符串标识符来指定成员。要使用 SCSI 名称字符串标识符添加上述两个启动器，应使用的命令为：

# stmfadm add-hg-member -g HostA eui.200000e08b909221
# stmfadm add-hg-member -g HostA iqn.1986-03.com.sun:01.46f7e262

使用 -F 选项时，一个主机组成员可以成为多个主机组的成员。不使用该选项时，一个主机组成员只能成为一个组的成员。

add-tg-member -g group-name group member...

向目标组添加目标组成员。group-name 必须是使用 create-tg 子命令创建的一个现有组。group member 可以指定为 name_type.name_value，其中 name_type 可以为下列项之一：

wwn
iqn
eui

...name_value 是目标名称的值。例如，要向目标组 TG0 添加光纤通道目标端口全局名称 501000e092376af7，应使用的命令为：

# stmfadm add-tg-member -g TG0 wwn.501000e092376af7

要向 TG0 添加名为 iqn.1986-03.com.sun:target.01.01110 的 ISCSI 目标成员，应使用的命令为：

# stmfadm add-tg-member -g TG0 iqn.1986-03.com.sun:target.01.01110

此外，还可以使用成员的 SCSI 名称字符串标识符来指定成员。要使用 SCSI 名称字符串标识符添加上述两个目标，应使用的命令为：

# stmfadm add-tg-member -g TG0 eui.501000e092376af7
# stmfadm add-tg-member -g TG0 iqn.1986-03.com.sun:target.01.01110

一个目标组的成员不能充当多个目标组的成员。

create-hg group-name

创建名为 group-name 的启动器组。group-name 是最大长度为 255 个 Unicode 字符的字符串。组名在 STMF 系统内必须是唯一的。

create-lu [-p, --lu-prop logical-unit-property=val --s, --size size] lu-file

创建一个可以向 STMF 注册的逻辑单元。对于 -p 选项，logical-unit-property 可以是以下属性之一：

alias: 最多为 255 个字符，表示设备的用户定义名称。缺省值为后备存储的名称。
blk: 指定设备的块大小。缺省值为 512，但是不要将该值设置为高于 4096 KB。
guid: 表示有效的 NAA 注册扩展标识符，为三十二位十六进制 ASCII 字符。缺省值由 STMF 设置为一个生成的值。
host-id: 表示分配的主机 ID 的八位十六进制 ASCII 字符。这将用来为逻辑单元生成全局唯一标识符 (Globally Unique Identifier, GUID)。缺省值是由 hostid(1) 返回的值。
meta: 元数据文件名。该属性在指定后将用于保存逻辑单元的 SCSI 元数据。无缺省值。
mgmt-url: 最多为 1024 个字符，表示管理网络地址 URL。通过一对引号 (") 括起以空格分隔的 URL，可将多个 URL 作为一个参数进行传递。
oui: 组织唯一标识符。表示分配的 IEEE OUI 公司 ID 的六位十六进制 ASCII 字符。这将用来生成设备标识符 (GUID)。缺省值为 00144F。
pid: 符合 SCSI SPC-3 规范的十六字符产品标识。此值将反映在为设备返回的标准 INQUIRY 数据中。缺省值为 COMSTAR。
serial: 序列号. 指定 SCSI 重要产品数据序列号（第 80h 页）。这是一个最大长度为 252 字节的字符值。没有缺省值。
vid: 符合 SCSI SPC-3 规范的八字符供应商标识。此值将反映在为设备返回的标准 INQUIRY 数据中。缺省值为 SUN。
wcd: 禁用回写高速缓存。指定 true 或 false 以确定回写高速缓存禁用行为。缺省值是由 lu-file 参数指定的后备存储设备的回写高速缓存设置。
wcms: 可更改写入高速缓存设置。指定为 true 或 false。如果为 true，启动器中的 SCSI MODE SELECT 可以更改高速缓存模式页上的 WRITE CACHE ENABLE 位。如果为 false，WRITE CACHE ENABLE 位不可更改。此设置不影响 stmfadm 或 libstmf(3LIB) 函数对写入高速缓存禁用设置的修改能力。缺省设置为 true。
wp: 写保护位。指定 true 或 false 以确定设备是否报告为有写保护。缺省值是 /。

对于 -s 选项，size 是一个整数，后跟下列字母之一，表示大小的单位：

k: 千字节
m: 兆字节
g: 千兆字节
t: 兆兆字节
p: 千兆兆字节
e: 艾字节

lu-file 是用作逻辑单元的后备存储的文件。如果未指定 -s 选项，将使用指定的 lu-file 的大小作为逻辑单元的大小。向 STMF 注册的逻辑单元需要空间来存储元数据。当将 zvol 指定为后备存储设备时，缺省情况下将使用 zvol 的一个特殊属性来包含元数据。对于所有其他设备，缺省行为是使用设备的前 64k 空间。另一种替代方法是在 create-lu 命令中使用 meta 属性指定其他文件来包含元数据。建议使用可为逻辑单元元数据提供足够空间的文件，最好为 64k。

create-tg group-name

创建名为 group-name 的目标组。group-name 是最大长度为 255 个 Unicode 字符的字符串。组名在 STMF 系统内必须是唯一的。

delete-hg group-name

删除由 group-name 标识的主机组。

delete-lu lu-name

删除使用 stmfadm create-lu 创建的现有逻辑单元。这可以有效地从 STMF 框架中卸载逻辑单元。逻辑单元上的任何现有数据将保持不变。

delete-tg group-name

删除由 group-name 标识的目标组。

import-lu lu-file

将之前使用 stmfadm create-lu 创建且后来又使用 stmfadm delete-lu 从 STMF 中删除的逻辑单元导入并装入到 STMF 中。成功后，该逻辑单元将重新可供 STMF 使用。lu-file 是在 stmfadm create-lu 命令中使用的文件名。如果此逻辑单元使用一个单独的元数据文件，则在此处必须使用在 stmfadm create-lu 命令中使用的 meta 属性值中的文件名。

list-hg [-v,--verbose] [host-group-name...]

列出系统中 host-group-name 所指的主机组的相关信息。如果未指定 host-group-name，则会列出系统中的所有主机组。如果指定了 --v 或 --verbose 选项，则会显示主机组内的所有成员。

list-lu [-v,--verbose] [lu-name...]

列出系统中 lu-name 所指的逻辑单元的相关信息。如果未指定 lu-name，则会列出系统中的所有逻辑单元。如果指定了 -v 或 --verbose 选项，则会显示关于逻辑单元的更多信息。

list-target [-v,--verbose] [target-name...]

列出系统中 target-name 所指的目标端口的相关信息。如果未指定目标名称，则会列出系统中的所有目标端口。如果指定了 -v 或 --verbose 选项，则会显示关于目标的更多信息以及已登录启动器的 SCSI 会话信息。

list-tg [-v,--verbose] [target-group-name...]

列出系统中 target-group-name 所指的目标组的相关信息。如果未指定 target-group-name，则会列出系统中的所有目标组。如果指定了 --v 或 --verbose 选项，则会显示目标组内的所有成员。

list-view [-v, -–verbose] --l, --lu-name lu-name [entry-name...]

为 lu-name 所指的逻辑单元列出视图条目。如果未指定 entry-name，则会为指定的逻辑单元列出所有视图条目。

如果指定了 -v 选项，则会显示与视图关联的为每主机分配的逻辑单元号有关的更多信息。

modify-lu [-p, --lu-prop logical-unit-property=val --s, --size size, -f, --file] lu-name|lu-file

修改使用 stmfadm create-lu 命令创建的逻辑单元的属性。对于 -p 选项，logical-unit-property 可以是以下属性之一：

alias: 最多为 255 个字符，表示设备的用户定义名称。缺省值为后备存储的名称。
mgmt-url: 最多为 1024 个字符，表示管理网络地址 URL。通过一对引号 (") 括起以空格分隔的 URL，可将多个 URL 作为一个参数进行传递。
wcd: 禁用回写高速缓存。指定 true 或 false 以确定回写高速缓存禁用行为。缺省值是由 lu-file 参数指定的后备存储设备的回写高速缓存设置。
wp: 写保护位。指定 true 或 false 以确定设备是否报告为有写保护。缺省值是 /。
wcms: 可更改写入高速缓存设置。指定为 true 或 false。如果为 true，启动器中的 SCSI MODE SELECT 可以更改高速缓存模式页上的 WRITE CACHE ENABLE 位。如果为 false，WRITE CACHE ENABLE 位不可更改。此设置不影响 stmfadm 或 libstmf(3LIB) 函数对写入高速缓存禁用设置的修改能力。缺省设置为 true。

对于 -s 选项，size 是一个整数，后跟下列字母之一，表示大小的单位：

k: 千字节
m: 兆字节
g: 千兆字节
t: 兆兆字节
p: 千兆兆字节
e: 艾字节

lu-name 是要修改的逻辑单元的 guid。如果指定了 -f 选项，此操作数将解释为文件名。这提供了修改当前未导入到 STMF 中的逻辑单元的功能。

online-lu lu-name

使当前已向 STMF 注册的某个逻辑单元联机。

online-target target-name

使指定的目标联机。

offline-lu lu-name

使当前已向 STMF 注册的某个逻辑单元脱机。

offline-target target-name

使指定的目标脱机。

list-state

列出 STMF 的运行状态和配置状态。

remove-hg-member -g group-name group member

从主机组中删除主机组成员。group-name 必须是使用 create-hg 子命令创建的一个现有组。group member 可以指定为 name_type.name_value，其中 name_type 可以为下列项之一：

wwn
iqn
eui

...name_value 是启动器名称的值。例如，要从 HostA 主机组中删除光纤通道启动器端口全局名称 200000e08b909221，应使用的命令为：

# stmfadm remove-hg-member -g HostA wwn.200000e08b909221

要从 HostA 删除名为 iqn.1986-03.com.sun:01.46f7e262 的 ISCSI 启动器节点成员，应使用的命令为：

# stmfadm remove-hg-member -g HostA iqn.1986-03.com.sun:01.46f7e262

此外，还可以使用成员的 SCSI 名称字符串标识符来指定成员。要使用 SCSI 名称字符串标识符删除上述两个启动器，应使用的命令为：

# stmfadm remove-hg-member -g HostA eui.200000e08b909221
# stmfadm remove-hg-member -g HostA iqn.1986-03.com.sun:01.46f7e262

remove-tg-member -g group-name group member

从目标组中删除目标组成员。group-name 必须是使用 create-tg 子命令创建的一个现有组。group member 可以指定为 name_type.name_value，其中 name_type 可以为下列项之一：

wwn
iqn
eui

...name_value 是目标名称的值。例如，要从目标组 TG0 中删除光纤通道目标端口全局名称 501000e092376af7，应使用的命令为：

# stmfadm remove-tg-member -g TG0 wwn.501000e092376af7

要从 TG0 中删除名为 iqn.1986-03.com.sun:target.01.01110 的 ISCSI 目标成员，应使用的命令为：

# stmfadm remove-tg-member -g TG0 iqn.1986-03.com.sun:target.01.01110

此外，还可以使用成员的 SCSI 名称字符串标识符来指定成员。要使用 SCSI 名称字符串标识符删除上述两个目标，应使用的命令为：

# stmfadm remove-tg-member -g TG0 eui.501000e092376af7
# stmfadm remove-tg-member -g TG0 iqn.1986-03.com.sun:target.01.01110

remove-view --l, --lu-name lu-name entry-name

从逻辑单元中删除一个或多个逻辑单元视图条目。

示例

示例 1 创建具有两个启动器端口的主机组

以下命令使用 create-hg 和 add-hg-member 子命令创建一个主机组并向该主机组添加两个启动器端口。

# stmfadm create-hg host-group-a
# stmfadm add-hg-member -g host-group-a wwn.210105b0000d92d0

示例 2 向逻辑单元添加视图条目

以下命令使用了 add-view 子命令，因此可以从 host-group-a 访问某个逻辑单元。

# stmfadm add-view -h host-group-a 6000AE40C5000000000046FC4FEA001C

示例 3 列出视图条目

以下命令使用 list-view 子命令为指定的逻辑单元列出所有视图条目。

# stmfadm list-view -l 6000AE40C5000000000046FC4FEA001C
View Entry: 0 
                Host group      : host-group-a
                Target group   : All 
                LUN               : 0

属性

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

属性类型	属性值
可用性	system/storage/scsi-target-mode-framework
接口稳定性	Committed（已确定）

另请参见

hostid(1)、sbdadm(1M)、libstmf(3LIB)、attributes(5)

跳过导航链接
退出打印视图
	手册页第 1M 部分：系统管理命令 Oracle Solaris 11.1 Information Library (简体中文)