跳过导航链接 | |
退出打印视图 | |
手册页第 1M 部分:系统管理命令 Oracle Solaris 11 Information Library (简体中文) |
- 管理 Internet 存储名称服务 (Internet Storage Name Service, iSNS) 服务器
isnsadm options
isnsadm subcommand [subcommand_options] [operand]
isnsadm 命令是 Internet 存储名称服务 (Internet Storage Name Service, iSNS) 服务器的命令行接口。isnsadm 包括一组子命令(将分别在它们的各自部分中进行描述),每个子命令用于完成 iSNS 服务器管理功能中的一种。
对于将更改 iSNS 配置的任何操作都需要 solaris.isnsmgr.write 授权。请参见 isns(1M)。对于读取操作,该命令不需要特殊的授权。
isnsadm 有一组常规选项和一组特定于子命令的选项。第一个类别在“选项”部分中进行了描述,第二个类别在每个子命令描述上下文中进行了描述。
所支持的选项如下:
显示上下文帮助。停止解析任何后续参数。
显示版本信息。停止解析任何后续参数。
一个或多个 isnsadm 子命令使用下列操作数。
iSCSI 目标或 iSCSI 启动器符号名称。最大长度为 223 个字符的字符串。
搜索域符号名称。最大长度为 256 个字符的字符串。
搜索域集符号名称。最大长度为 256 个字符的字符串。
isnsadm 命令支持下面描述的子命令。
add-dd 子命令用于将搜索域添加到搜索域集中。
add-dd 子命令的语法如下所示:
# isnsadm add-dd option discovery-domain-name, ...
add-dd 具有以下选项:
指定一个搜索域集。
add-node 子命令用于将节点添加到指定的搜索域。
add-node 子命令的语法如下所示:
# isnsadm add-node option iscsi-node-name,...
add-node 具有以下选项:
指定一个搜索域。
create-dd 子命令用于使用您指定的名称创建搜索域。
create-dd 子命令的语法如下所示:
# isnsadm create-dd discovery-domain-name, ...
create-dd 没有选项。
create-dd-set 子命令用于使用您指定的名称创建搜索域集。
create-dd-set 子命令的语法如下所示:
# isnsadm create-dd-set discovery-domain-set-name, ...
create-dd-set 没有选项。
delete-dd 子命令用于删除具有您指定的名称的搜索域。
delete-dd 子命令的语法如下所示:
# isnsadm delete-dd discovery-domain-name, ...
delete-dd 没有选项。
delete-dd-set 子命令用于删除具有您指定的名称的搜索域集。
delete-dd-set 子命令的语法如下所示:
# isnsadm delete-dd-set discovery-domain-set-name, ...
delete-dd-set 没有选项。
disable-dd-set 子命令用于禁用搜索域集。
disable-dd-set 子命令的语法如下所示:
# isnsadm disable-dd-set discovery-domain-set-name, ...
disable-dd-set 没有选项。
enable-dd-set 子命令用于启用搜索域集。
enable-dd-set 子命令的语法如下所示:
# isnsadm enable-dd-set discovery-domain-set-name, ...
enable-dd-set 没有选项。
list-dd 子命令用于显示关于搜索域的信息。如果未指定操作数,则它会列出 iSNS 服务器上当前存在的所有搜索域。
list-dd 子命令的语法如下所示:
# isnsadm list-dd [option] [discovery-domain-name, ...]
list-dd 支持以下选项:
显示搜索域的成员内容。
list-dd-set 子命令用于列出 iSNS 服务器上存在的搜索域集(包括启用的和禁用的)。请注意,没有 dd-set 注册。如果未指定操作数,它将列出所有搜索域集。
list-dd-set 子命令的语法如下所示:
# isnsadm list-dd-set [option] [discovery-domain-set-name, ...]
list-dd-set 支持以下选项:
显示搜索域集内的所有搜索域。
list-node 子命令用于显示当前已向 iSNS 服务器注册的节点的相关信息,以及未向其注册且属于非缺省搜索域的节点的相关信息。对于后一种情况,节点将其类型字段显示为 unknown(未知)。如果未指定操作数,list-node 将列出 iSNS 服务器已知的所有节点。
list-node 子命令的语法如下所示:
# isnsadm list-node [options] [iscsi-node-name, ...]
list-node 支持以下选项:
对列表进行过滤以便只显示 iSCSI 目标节点。
对列表进行过滤以便只显示 iSCSI 启动器节点。
显示节点的详细信息。不使用此选项时,只会显示名称、别名和类型信息。
modify-dd 子命令用于修改指定的搜索域的属性。
modify-dd 子命令的语法如下所示:
# isnsadm modify-dd option discovery-domain-name
modify-dd 具有以下选项:
指定要向现有的搜索域应用的搜索域新名称。
modify-dd-set 子命令用于修改搜索域集。
modify-dd-set 子命令的语法如下所示:
# isnsadm modify-dd-set option discovery-domain-set-name
modify-dd-set 具有以下选项:
指定要向现有的搜索域集应用的搜索域集新名称。
remove-dd 子命令用于删除与指定的搜索域集的关联。
remove-dd 子命令的语法如下所示:
# isnsadm remove-dd option discovery-domain-name, ...
remove-dd 具有以下选项:
指定将从中删除搜索域的搜索域集。
remove-node 子命令用于删除节点。
remove-node 子命令的语法如下所示:
# isnsadm remove-node option iscsi-node-name, ...
remove-node 具有以下选项:
指定将从中删除节点的搜索域。
show-config 子命令用于显示 iSNS 服务器的管理设置。注意,可以通过服务管理工具(请参见 smf(5))修改这些设置。请参见 isns(1M)。
show-config 子命令的语法如下所示:
# isnsadm show-config
show-config 没有选项。
示例 1 显示客户机
下面的示例使用 list-node 子命令显示客户机。
# isnsadm list-node -v iSCSI Name: iqn.1986-03.com.sun:01:000e0c9f10da.45173FEA.engr Alias: STK5320_NAS Type: Target Network Entity: SE5310 Portal: 172.20.57.95:3260 Portal Group: 1 Portal: 172.20.56.95:3260 Portal Group: 1 DD Name: Default iSCSI Name: iqn.1986-03.com.sun:01:000e0c9f10da.454F00A2.acct Alias: Type: Target Network Entity: SE5310 Portal: 172.20.57.95:3260 Portal Group: 1 Portal: 172.20.56.95:3260 Portal Group: 1 DD Name: Default iSCSI Name: iqn.1986-03.com.sun:01:e00000000000.46fd8e2b Alias: host-x2100 Type: Initiator Network Entity: iqn.1986-03.com.sun:01:e00000000000.46fd8e2b Portal: 172.20.236.123:58530 Portal Group: 1 DD Name: Default
示例 2 显示搜索域
下面的示例使用 list-dd 子命令显示搜索域。
# isnsadm list-dd -v DD name: Default DD set(s): Default iSCSI Name: iqn.1986-03.com.sun:01:000e0c9f10da.45173FEA.engr iSCSI Name: iqn.1986-03.com.sun:01:000e0c9f10da.454F00A2.acct iSCSI name: iqn.1986-03.com.sun:01:e00000000000.46fd8e2b DD name: acct-dd DD name: engineering-dd
示例 3 添加节点
下面的示例使用 add-node 子命令将节点添加到搜索域中,从而创建搜索域成员身份。
# isnsadm add-node -d engineering-dd \ iqn.1986-03.com.sun:01:000e0c9f10da.454F00A2.engr
示例 4 删除节点
下面的示例使用 remove-node 子命令将节点从搜索域中删除,从而删除搜索域成员身份。
# isnsadm remove-node -d acct-dd \ iqn.1986-03.com.sun:01:000e0c9f10da.454F00A2.acct
示例 5 创建搜索域集
下面的示例使用 create-dd-set 子命令创建搜索域集。
# isnsadm create-dd-set operation-dd-set
示例 6 显示搜索域集
下面的示例使用 list-dd-set 子命令显示搜索域集。
# isnsadm list-dd-set -v DD Set name: Default State: Disabled DD Name: Default DD Set name: operation-dd-set State: Disabled
示例 7 添加搜索域
下面的示例使用 add-dd 子命令将搜索域添加到搜索域集中。
# isnsadm add-dd -s operation-dd-set engineering-dd
示例 8 显示搜索域集
下面的示例使用 list-dd-set 子命令显示搜索域集的属性。
# isnsadm list-dd-set DD Set name: Default State: Disabled DD Name: Default DD Set name: operation-dd-set State: Disabled DD Name: engineering-dd
示例 9 启用搜索域集
下面的示例使用 enable-dd-set 子命令启用搜索域集。
# isnsadm enable-dd-set Default
示例 10 禁用搜索域集
下面的示例使用 disable-dd-set 子命令禁用搜索域集。
# isnsadm disable-dd-set Default
示例 11 显示管理设置
下面的示例使用 show-config 子命令显示当前的管理设置。
# isnsadm show-config Data Store Location: /etc/isns/isnsdata.xml Entity Status Inquiry Non-Response Threshold: 3 Management SCN Enabled: yes Authorized Control Node Names: -
有关以下属性的说明,请参见 attributes(5):
|
iscsiadm(1M)、isns(1M)、attributes(5)、smf(5)
如果调用某个子命令时使用了多个操作数,并且在一个或多个(并非全部)操作数上失败,则 isnsadm 会显示一条指示部分失败的一般消息,并显示失败操作数的列表。要查看有关某个特定操作数的错误,可以对该失败操作数发出同一子命令。