Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
nbftconfig — 配置与光纤传输 (FT) 服务器和 SAN 客户端相关的属性
大纲
[-addclient] [-deleteclient] [-changeclient] [-rescanclient] [rescanallclients] [-listclients] [-addserver] [-deleteserver] [-changeserver] [-listservers] [-listactive] [-setconfig] [-getconfig] [-verbose] [-help]
-[ac]addclient -C client_name [-M master_server] [-ftpref preferred | always | never] [-ftwait minutes] [-ftrwait minutes]
-[dc]deleteclient -C client_name
-[cc]changeclient -C client_name {-ftpref preferred | always | never] [-ftwait minutes] [-ftrwait minutes] | -np number_of_ports}
-[rc]rescanclient client_name
-[ra]rescanallclients
-[lc]listclients [-verbose] [-C client_name | -Me media_server | -M master_server]
-[ds]deleteserver -Me media_server
-[cs]changeserver -Me media_server [-l connection_limit] [-state active | disabled]
-[ls]listservers [-Me media_server | -M master_server] [-verbose]
-[la]listactive [-C client_name | -Me media_server] [-verbose]
-[lt]listtargets [-Me media_server] [-verbose]
-setconfig [-M master_server] {-ftpref preferred | always | never [-ftwait minutes] [-ftrwait minutes] | -np number_of_ports [-ncp number_of_clients_per_target_port]}
-getconfig [-M master_server] [-verbose]
-option -help
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/admincmd/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\admincmd\
描述
nbftconfig 是用于修改与光纤传输 (FT) 服务器关联的属性的 NetBackup 实用程序。它还在 EMM 数据库中创建 SAN 客户端实体。
nbftconfig 执行以下操作:
向 EMM 数据库添加新 SAN 客户端及其属性。
修改现有 SAN 客户端记录。
删除 SAN 客户端。
添加新 FT 服务器。
修改现有 FT 服务器记录的属性。
列出数据库中定义的 SAN 客户端。
列出数据库中定义的 FT 服务器。
按所有活动的光纤通道连接列出。
列出 FT 介质服务器的目标端口配置信息。
选项
- -addclient
向 EMM 数据库添加指定的 SAN 客户端。SAN 客户端代码安装到客户端后,通常由服务器自动发现 SAN 客户端。尽管如此,如果客户端向 EMM 服务器发出的通知丢失,请使用此命令手动添加客户端。使用此命令选项可以设置下列属性:
- -C client_name
指定要添加到数据库的 SAN 客户端的名称。
- -M master_server
指定与特定客户端关联的主服务器。如果省略此选项,则使用本地客户端的主服务器。
- -ftpref preferred | always | fail | never
确定是首选使用(默认条件)、始终必须使用还是从不使用介质服务器的光纤通道连接。如果未提供首选项,则使用主服务器的默认值。默认情况下,根据 EMM 服务器的全局定义设置该值。下面介绍了可能的 -ftpref 值:
首选。如果有一个 FT 设备在配置的等待期限(以分钟为单位)内可用,则使用 FT 设备。如果在等待期限过去之后 FT 设备不可用,则 NetBackup 将使用 LAN 连接进行操作。如果选择此选项,则还需指定备份和还原的等待期限。
始终。NetBackup 始终使用 FT 设备来备份和还原 SAN 客户端,并且等到有 FT 设备可用后才开始执行操作。
失败。如果 FT 设备不处于已启动和联机状态,则 NetBackup 判定作业失败。如果 FT 设备处于联机但是繁忙状态,则 NetBackup 会等到有设备可用时将下一个作业分配给该设备。FT 设备不存在的原因有多种,如任何 FT 设备都处于非活动状态或尚未配置,或者 SAN 客户端许可证过期。
从不。NetBackup 从不使用 FT 管道来备份和还原 SAN 客户端,而是使用 LAN 连接进行备份和还原。
如果为主服务器指定“从不”,则将在 NetBackup 环境中禁用“光纤传输”,您可以基于每个客户端配置是否使用 FT。如果为介质服务器指定“从不”,则将对该介质服务器禁用“光纤传输”。如果为 SAN 客户端指定“从不”,则将对该客户端禁用“光纤传输”。
- -ftrwait minutes
定义还原作业在使用标准网络连接前应等待可用光纤通道连接的分钟数。只有将 ftpref 类型设置为 preferred 时,此选项才有效。
- -ftwait minutes
定义备份作业在使用标准网络连接前应等待可用光纤通道连接的分钟数。只有将 ftpref 类型设置为 preferred 时,此选项才有效。
- -np number_of_ports
定义可以在一台介质服务器上同时使用的客户端端口的最大数目。如果将客户端端口的最大数目设置为 0,将使用所有端口。客户端端口的默认数目是 2。
- -deleteclient
从 EMM 数据库中删除指定的客户端。此选项可包含以下属性。
- -C client_name
指定要从数据库中删除的 SAN 客户端的名称。
- -changeclient
更改与特定 SAN 关联的选项。使用此命令选项可以设置下列属性:
- -C client_name
指定要添加到数据库的 SAN 客户端的名称。
- -ftpref preferred | always | never
确定是首选使用、始终必须使用还是从不使用介质服务器的光纤通道连接。如果未提供首选项,则使用主服务器的默认值。默认情况下,根据 EMM 服务器的全局定义设置该值。
- -ftwait minutes
定义备份作业在使用标准网络连接前应等待可用光纤通道连接的分钟数。只有将 ftpref 类型设置为 preferred 时,此选项才有效。
- -ftrwait minutes
定义还原作业在使用标准网络连接前应等待可用光纤通道连接的分钟数。只有将 ftpref 类型设置为 preferred 时,此选项才有效。
- -rescanallclients
扫描所有客户端中的新 FT 设备,一次最多扫描五个客户端。
- -rescanclient
扫描指定客户端中的新 FT 设备。使用此命令选项可以设置下列属性:
- client_name
指定要扫描的 SAN 客户端的名称。
- -listclients
显示 SAN 客户端及关联属性的列表。默认情况下,列出所有 SAN 客户端及属性子集。listclients 操作输出的信息取决于是否列出了所有客户端或与特定 SAN 客户端关联的属性。
使用此命令选项可以设置下列属性:
- -C client_name
指定您要列出其信息的 SAN 客户端的名称。如果省略此属性,listclients 将列出挂接到指定介质服务器或主服务器的所有客户端的信息。
- -Me media_server
指定 FT 服务器的名称(您要列出与其挂接的客户端的信息)。
- -M master_server
指定与 FT 服务器关联的主服务器。如果省略该选项,将返回所有 FT 服务器。
- -verbose
可以用详细模式和非详细模式(默认)显示输出。如果列出所有客户端(包括主服务器或介质服务器的所有客户端),则显示多客户端的信息(详细模式输出)。
将以详细模式显示客户端记录的以下信息:
SAN 客户端名称
版本 - 客户端 NetBackup 软件版本
状态 - SAN 客户端状态
主服务器名称
可与 SAN 客户端相连的 FT 服务器数
用法首选项(请参见 addclient)
用法首选项等待时间(请参见 addclient)
如果 listclients 命令包含某一特定 SAN 客户端,则显示该客户端的信息(单台客户端输出):
将以详细模式显示客户端设备记录的以下信息:
SAN 客户端设备状态
介质服务器名称
介质服务器状态
发现设备的介质服务器 HBA 端口号
介质服务器 HBA 端口模式
LUN - 与 HBA 端口关联的 LUN
默认情况是非详细模式输出。输出信息与详细模式相同,采用空格分隔的文本格式。客户端记录以字母 c 开头,设备记录以字母 d 开头。
- -deleteserver
从 EMM 数据库中删除指定的客户端。使用此命令选项可以设置下列属性:
- -Me media_server
指定要删除的 FT 服务器的名称。
- -changeserver
更改与 FT 服务器关联的属性。使用此命令选项可以设置下列属性:
- -Me media_server
指定要更改的 FT 服务器的名称。
- -M master_server
指定与特定介质服务器关联的主服务器。
- -l connection_limit
指定 FT 服务器支持的最大连接数。这是服务器的总连接数,而不是每个 LUN 或 HBA 的连接数。如果省略此选项,则使用 FT 服务器的默认连接限制。
- -state [active | disabled]
标识 FT 服务器的已分配状态。可能的值为 active 和 disabled。
- -listservers
此操作用于显示 FT 服务器及关联属性的列表。默认情况下,列出所有 FT 服务器:
与 listservers 命令关联的选项如下:
- -Me media_server
指定介质服务器的名称(您要列出与其挂接 FT 服务器的信息)。
- -M master_server
指定要列出与其挂接的 FT 服务器的主服务器的名称。
- -verbose
指定详细的服务器信息输出。
可以用详细模式和非详细模式(默认)显示输出。如果列出所有客户端(包括主服务器或介质服务器的所有客户端),则显示多客户端的信息(详细模式输出)。
将以详细模式显示服务器记录的以下输出信息:
SAN 客户端名称
FT 服务器名称
版本 - 服务器 NetBackup 软件版本
状态 - FT 服务器状态
连接限制
如果 listclients 命令包含某一特定 SAN 客户端,则显示该客户端的信息(单台客户端输出):
将以详细模式显示客户端设备记录的以下输出信息:
FT 服务器 HBA 端口
FT 服务器 HBA 端口模式
FT 服务器设备状态
关联的 LUN
FT 连接数 - 特定 HBA/LUN 上的活动 FT 连接数
默认情况是非详细模式输出。输出信息与详细模式相同,采用空格分隔的文本格式。介质服务器记录以字母 d 开头,设备记录以字母 d 开头。每台服务器上的每个 HBA 端口号在输出中各占一行内容。
- -listtargets
此操作用于显示 FT 介质服务器上所有目标端口的详细信息列表。默认情况下,列出所有 FT 服务器。
与 listtargets 命令关联的选项如下:
- -Me media_server
指定您要列出其目标端口配置的介质服务器的名称。如果未指定介质服务器,将列出所有 FT 介质服务器的目标端口信息。
- -verbose
指定详细的服务器信息输出。
可以用详细模式和非详细模式(默认)显示输出。列出所有客户端时,显示多客户端的信息(详细模式输出)。默认情况是非详细模式输出。输出信息与详细模式相同,采用空格分隔的文本格式。
示例 2 说明了 nbftconfig -listtargets -verbose 命令的用法及输出数据类别。
- -getconfig
检索 FT 服务器和 SAN 客户端属性的默认配置参数。
与 -getconfig 命令关联的选项如下:
- -M master_server
指定与 FT 服务器关联的主服务器。如果省略此选项,则使用本地计算机的主服务器。
- -verbose
指定详细的配置信息输出。
- -setconfig
设置 FT 服务器和 SAN 客户端属性的配置参数。使用此命令选项可以设置下列属性:
-ftpref preferred | always | never
确定是首选使用、始终必须使用还是从不使用介质服务器的光纤通道连接。默认情况下,根据 EMM 服务器的全局定义设置该值。
-ftpref 与 -np 或 -ncp 的使用是互斥的。
- -ftwait minutes
定义备份作业在使用标准网络连接前应等待可用光纤通道连接的分钟数。只有将 ftpref 类型设置为 preferred 时,才需要此选项。
- -ftrwait minutes
定义还原作业在使用标准网络连接前应等待可用光纤通道连接的分钟数。只有将 ftpref 类型设置为 preferred 时,才需要此选项。
- -ncp number_of_clients_per_target_port
指定任何 FT 介质服务器上允许的每目标端口客户端最大数量。
- -np number_of_ports
指定可以与 FT 介质服务器一起使用的客户端上的启动器端口数。
- -listactive
列出活动的 FT 连接。此命令应该至少能为每个 FT 连接获取下列信息:
SAN 客户端名称
客户端 HBA 编号
FT 服务器名称
服务器 HBA 编号
FT 通道 - FT 通道号
LUN
方向
作业号
与 listactive 命令关联的选项如下:
- -C client_name
指定 SAN 客户端的名称(您要列出其活动 FT 连接的信息)。如果省略此属性和介质服务器属性,则 -listactive 列出本地计算机的主服务器的信息。
- -Me media_server
指定 FT 服务器的名称(您要列出与其挂接的客户端的 FT 连接)。
- -verbose
指定详细的 FT 连接信息输出。
示例
示例 1 - 以详细模式列出主服务器 wendigo
的 FT 配置值。这些值在 nbftconfig -getconfig 命令中设置。
# nbftconfig -getconfig -verbose Master Server : wendigo.example.com Client Ports/Server: 2 Clients/Target port: 2 FT Preference : preferred Backup Wait Time : 15 Restore Wait Time : 5
示例 2 - 显示 -listtargets 选项如何以详细模式列出 FT 介质服务器 wendigo
上所有目标端口的配置详细信息。
# nbftconfig -listtargets -verbose FT Server Name : wendigo.example.com FT Server HBA Port : 1 FT Server Port WWN : 21:00:00:E0:8B:8F:CC:79 FT Server Port Mode : PTP FT Server Port Model : QLA234x Series FC Hba FT Server Port Vendor: Qlogic FT Server Device State : active Associated LUN : 0 Active Connections on LUN: 0 FT Server Device State : active Associated LUN : 1 Active Connections on LUN: 0 FT Server HBA Port : 0 FT Server Port WWN : 21:01:00:E0:8B:AF:CC:79 FT Server Port Mode : DISCONNECTED FT Server Port Model : QLA234x Series FC Hba FT Server Port Vendor: Qlogic FT Server Device State : active Associated LUN : 0 Active Connections on LUN: 0 FT Server Device State : active Associated LUN : 1 Active Connections on LUN: 0