手册页部分 1M: 系统管理命令

退出打印视图

更新时间: 2014 年 7 月
 
 

isnsadm(1M)

名称

isnsadm - 管理 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 有一组常规选项和一组特定于子命令的选项。第一个类别在“选项”部分中进行了描述,第二个类别在每个子命令描述上下文中进行了描述。

选项

支持以下选项:

–?, –-help

显示上下文帮助。停止解析任何后续参数。

–V–-version

显示版本信息。停止解析任何后续参数。

操作数

一个或多个 isnsadm 子命令使用下列操作数。

iscsi-node-name

iSCSI 目标或 iSCSI 启动器符号名称。最大长度为 223 个字符的字符串。

discovery-domain-name

搜索域符号名称。最大长度为 256 个字符的字符串。

discovery-domain-set-name

搜索域集符号名称。最大长度为 256 个字符的字符串。

子命令

子命令

isnsadm 命令支持下面描述的子命令。

add-dd

add-dd 子命令用于将搜索域添加到搜索域集中。

add-dd 子命令的语法如下所示:

# isnsadm add-dd option 
discovery-domain-name, ...

add-dd 具有以下选项:

–s discovery-domain-set-name

指定一个搜索域集。

add-node

add-node 子命令用于将节点添加到指定的搜索域。

add-node 子命令的语法如下所示:

# isnsadm add-node option 
iscsi-node-name,...

add-node 具有以下选项:

–d,–-dd discovery-domain-name

指定一个搜索域。

create-dd

create-dd 子命令用于使用您指定的名称创建搜索域。

create-dd 子命令的语法如下所示:

# isnsadm create-dd discovery-domain-name, ...

create-dd 没有选项。

create-dd-set

create-dd-set 子命令用于使用您指定的名称创建搜索域集。

create-dd-set 子命令的语法如下所示:

# isnsadm create-dd-set discovery-domain-set-name
, ...

create-dd-set 没有选项。

delete-dd

delete-dd 子命令用于删除具有您指定的名称的搜索域。

delete-dd 子命令的语法如下所示:

# isnsadm delete-dd discovery-domain-name, ...

delete-dd 没有选项。

delete-dd-set

delete-dd-set 子命令用于删除具有您指定的名称的搜索域集。

delete-dd-set 子命令的语法如下所示:

# isnsadm delete-dd-set discovery-domain-set-name
, ...

delete-dd-set 没有选项。

disable-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 子命令用于启用搜索域集。

enable-dd-set 子命令的语法如下所示:

# isnsadm enable-dd-set discovery-domain-set-name
, ...

enable-dd-set 没有选项。

list-dd

list-dd 子命令用于显示关于搜索域的信息。如果未指定操作数,则它会列出 iSNS 服务器上当前存在的所有搜索域。

list-dd 子命令的语法如下所示:

# isnsadm list-dd [option] [
discovery-domain-name, ...]

list-dd 支持以下选项:

–v–-verbose

显示搜索域的成员内容。

list-dd-set

list-dd-set 子命令用于列出 iSNS 服务器上存在的搜索域集(包括启用的和禁用的)。请注意,没有 dd-set 注册。如果未指定操作数,它将列出所有搜索域集。

list-dd-set 子命令的语法如下所示:

# isnsadm list-dd-set [option] [
discovery-domain-set-name, ...]

list-dd-set 支持以下选项:

–v–-verbose

显示搜索域集内的所有搜索域。

list-node

list-node 子命令用于显示当前已向 iSNS 服务器注册的节点的相关信息,以及未向其注册且属于非缺省搜索域的节点的相关信息。对于后一种情况,节点将其类型字段显示为 unknown(未知)。如果未指定操作数,list-node 将列出 iSNS 服务器已知的所有节点。

list-node 子命令的语法如下所示:

# isnsadm list-node [options] [
iscsi-node-name, ...]

list-node 支持以下选项:

–t, –-target

对列表进行过滤以便只显示 iSCSI 目标节点。

–i, –-initiator

对列表进行过滤以便只显示 iSCSI 启动器节点。

–v–-verbose

显示节点的详细信息。不使用此选项时,只会显示名称、别名和类型信息。

modify-dd

modify-dd 子命令用于修改指定的搜索域的属性。

modify-dd 子命令的语法如下所示:

# isnsadm modify-dd option 
discovery-domain-name

modify-dd 具有以下选项:

–n discovery-domain-name

指定要向现有的搜索域应用的搜索域新名称。

modify-dd-set

modify-dd-set 子命令用于修改搜索域集。

modify-dd-set 子命令的语法如下所示:

# isnsadm modify-dd-set option 
discovery-domain-set-name

modify-dd-set 具有以下选项:

–n discovery-domain-set-name

指定要向现有的搜索域集应用的搜索域集新名称。

remove-dd

remove-dd 子命令用于删除与指定的搜索域集的关联。

remove-dd 子命令的语法如下所示:

# isnsadm remove-dd option 
discovery-domain-name, ...

remove-dd 具有以下选项:

–s discovery-domain-set-name

指定将从中删除搜索域的搜索域集。

remove-node

remove-node 子命令用于删除节点。

remove-node 子命令的语法如下所示:

# isnsadm remove-node option 
iscsi-node-name, ...

remove-node 具有以下选项:

–d discovery-domain-name

指定将从中删除节点的搜索域。

show-config

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)

属性类型
属性值
可用性
service/storage/isns
接口稳定性
Volatile(可变)

另请参见

iscsiadm(1M)isns(1M)attributes(5)smf(5)

附注

如果调用某个子命令时使用了多个操作数,并且在某些操作数上失败,则 isnsadm 将输出一条指示部分失败的一般消息,并显示失败操作数的列表。要查看有关某个特定操作数的错误,可以对该失败操作数发出同一子命令。

如果调用某个子命令时使用了多个操作数,并且在一个或多个(并非全部)操作数上失败,则 isnsadm 会显示一条指示部分失败的一般消息,并显示失败操作数的列表。要查看有关某个特定操作数的错误,可以对该失败操作数发出同一子命令。