Go to main content

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

退出打印视图

更新时间: 2018年8月8日 星期三
 
 

ndmpadm(8)

名称

ndmpadm - 管理网络数据管理协议活动

用法概要

/usr/sbin/ndmpadm [-? ] subcommand [options] [direct-object]

描述

可使用 ndmpadm 命令查询 ndmpd(8) 守护进程,以获取活动会话的状态,终止会话,查询备份设备以及设置或获取当前 NDMP(Network Data Management Protocol,网络数据管理协议)服务变量和属性。ndmpadm 是作为一组子命令实现的(其中很多子命令都有自己的直接对象),下面将分别对这些子命令进行说明。某些子命令支持选项,这些选项将与子命令一起介绍。

ndmpadm 命令支持以下子命令:

disable

禁用指定的验证口令处理。

enable

启用指定的验证口令处理。

get

获取 NDMP 配置属性值。

kill-sessions

终止活动会话。

set

设置 NDMP 配置属性的值。

show-devices

获取与服务器连接的磁带设备列表。

show-sessions

显示活动 NDMP 会话的详细信息。

选项

支持以下选项:

–?

显示所有子命令和选项的列表。

子命令

ndmpadm 命令支持下述子命令。

add-elig 子命令

add-elig 子命令的语法如下:

# ndmpadm add-elig {-t <res_type>} [<res_id> ...]

此子命令可使类型为 <res_type> 的一个或多个资源对 NDMP 可用。操作数 <res_id> 标识要使其可用的资源。但是,如果省略 <res_id>,则 add-elig 会取消限制资源类型 <res_type>,从而实际上使该类型的任何资源均对 NDMP 可用。

delete-elig 子命令

delete-elig 子命令的语法如下:

# ndmpadm delete-elig {-t <res_type>} [<res_id> ...]

此子命令可从 NDMP 的可用资源列表中删除类型为 <res_type> 的一个或多个资源。操作数 <res_id> 标识要删除的资源。如果 <res_id> 指定 show-elig 未列出的资源,delete-elig 子命令将不成功。如果在调用该子命令时忽略了 <res_id>,则指定类型的所有资源对 NDMP 不再可用,从而导致随后 show-elig 输出 <none>


注 -  delete-elig 的负面影响是立即终止使用所删除资源的任何正在进行的 NDMP 备份/恢复。

disable 子命令

disable 子命令的语法如下:

# ndmpadm disable -a auth-type

该子命令为 NDMP 客户机的远程访问禁用 auth-type 指定的验证类型。auth-type 的有效值为 cram-md5cleartext

enable 子命令

enable 子命令的语法如下:

# ndmpadm enable -a auth-type -u username

该子命令提示输入两次用户口令以进行确认,并使用 NDMP 客户机访问的给定用户名和口令激活指定的验证类型。用户名最大长度为 559 个字符,口令最大长度为 256 个字符。auth-type 的有效值为 cram-md5cleartext

get 子命令

get 子命令的语法如下:

# ndmpadm get [-p] [property] [[-p] property=value]...

属性名与用于 set 子命令的属性名相同,如下所述。如果未指定属性,get 子命令将返回所有配置属性。

kill-sessions 子命令

可以使用 kill-sessions 子命令终止会话编号 ID

kill-sessions 子命令的语法如下:

# ndmpadm kill-sessions ID

set 子命令

set 子命令的语法如下:

# ndmpadm set [-p] property=value [[-p] property=value]...

ndmp(5) 手册页中介绍了可使用 set 子命令设置的属性。

show-devices 子命令

show-devices 子命令的语法如下:

# ndmpadm show-devices

该子命令可列出当前连接到系统的磁带驱动器和库的名称、供应商、序列号以及其他信息。

show-elig 子命令

show-elig 子命令的语法如下:

# ndmpadm show-elig {-t <res_type>}

列出对 NDMP 可用的类型为 <res_type> 的资源。NDMP 备份/恢复不能使用不可用的资源。尝试运行引用 show-elig 未列出的资源的备份/恢复将失败。

show-elig 列出的以下资源 ID 具有特殊含义:

<none>

指定类型的任何资源均对 NDMP 不可用。

<any>

指定类型的任何资源均对 NDMP 可用。

show-sessions 子命令

show-sessions 子命令显示会话的详细信息。show-sessions 子命令的语法如下:

# ndmpadm show-sessions [-i tape,scsi,data,diskpool,mover,fileserver] [ID]

show-sessions 子命令支持以下参数:

–i tape,scsi,data,diskpool,mover,
fileserver

标识要获取其数据的接口的类型。如果未指定接口,show-sessions 将显示所有类型的接口的信息。

ID

标识要显示其数据的特定会话。如果未指定 IDshow-sessions 将显示所有会话的数据。

示例

示例 1 获取所有 NDMP 连接的状态

以下命令将获取所有连接的状态。

# ndmpadm show-devices
示例 2 获取特定类型的连接的状态

以下命令将获取磁带和 SCSI 接口的状态。

# ndmpadm show-sessions -i scsi,tape
示例 3 限制协议版本

以下命令将限制 NDMP 协议使用版本 3。

# ndmpadm set -p version=3
示例 4 获取当前版本号

以下命令将获取当前正在运行的 NDMP 的版本号。

# ndmpadm get -p version
示例 5 断开特定会话

以下命令将断开会话 5。会话编号是之前通过 ndmpadm show-sessions 命令获取的。

# ndmpadm kill-session 5
示例 6 获取所有 NDMP 属性的值

以下命令将获取所有 NDMP 属性的值。

# ndmpadm get
示例 7 启用 CRAM-MD5 验证

以下命令将启用 CRAM-MD5 验证。

# ndmpadm enable -a cram-md5 -u admin
Enter new password:*****
Re-enter password:*****
示例 8 禁用明文口令验证

以下命令将禁用明文口令验证。

# ndmpadm disable -a cleartext

退出状态

0

成功完成。

1

出现错误(如 ndmpd 守护进程未在运行),使得 ndmpadm 无法联系守护进程。

2

指定的命令行选项无效。

属性

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

属性类型
属性值
可用性
service/storage/ndmp
接口稳定性
Committed(已确定)

另请参见

dump(1)tar(1)ndmp(5)attributes(7)smf(7)ndmpd(8)ndmpstat(8)svccfg(8)syslogd(8)

附注

ndmpd(1) 由 smf(7) 管理,其服务标识符为:

ndmpd(8) 守护进程由服务管理工具 (smf(7)) 管理,其服务标识符为:

svc:/system/ndmpd

还可使用 svccfg(8) 来对此服务执行管理操作(如设置和获取属性)。例如,启用直接访问恢复 (Direct Access Recovery,DAR) 模式:

# svccfg -s svc:/system/ndmpd
svc:/system/ndmpd> setprop ndmpd/dar-support = yes

...以及获取属性列表:

# svccfg -s svc:/system/ndmpd
svc:/system/ndmpd> listprop