Veritas NetBackup™ 命令参考指南

Last Published:
Product(s): NetBackup (8.3)
  1. 介绍
    1.  
      关于 NetBackup 命令
    2.  
      浏览多个菜单级别
    3.  
      NetBackup 命令约定
    4.  
      NetBackup 介质管理器命令说明
    5.  
      IPv6 更新
  2. 附录 A. NetBackup 命令
    1.  
      acsd
    2.  
      add_media_server_on_clients
    3.  
      backupdbtrace
    4.  
      backuptrace
    5.  
      bmrc
    6.  
      bmrconfig
    7.  
      bmrepadm
    8.  
      bmrprep
    9.  
      bmrs
    10.  
      bmrsrtadm
    11.  
      bp
    12.  
      bparchive
    13.  
      bpbackup
    14.  
      bpbackupdb
    15.  
      bpcatarc
    16.  
      bpcatlist
    17.  
      bpcatres
    18.  
      bpcatrm
    19.  
      bpcd
    20.  
      bpchangeprimary
    21.  
      bpclient
    22.  
      bpclimagelist
    23.  
      bpclntcmd
    24.  
      bpclusterutil
    25.  
      bpcompatd
    26.  
      bpconfig
    27.  
      bpdbjobs
    28.  
      bpdbm
    29.  
      bpdgclone
    30.  
      bpdown
    31.  
      bpduplicate
    32.  
      bperror
    33.  
      bpexpdate
    34.  
      bpfis
    35.  
      bpflist
    36.  
      bpgetconfig
    37.  
      bpgetdebuglog
    38.  
      bpimage
    39.  
      bpimagelist
    40.  
      bpimmedia
    41.  
      bpimport
    42.  
      bpinst
    43.  
      bpkeyfile
    44.  
      bpkeyutil
    45.  
      bplabel
    46.  
      bplist
    47.  
      bpmedia
    48.  
      bpmedialist
    49.  
      bpminlicense
    50.  
      bpnbat
    51.  
      bpnbaz
    52.  
      bppficorr
    53.  
      bpplcatdrinfo
    54.  
      bpplclients
    55.  
      bppldelete
    56.  
      bpplinclude
    57.  
      bpplinfo
    58.  
      bppllist
    59.  
      bpplsched
    60.  
      bpplschedrep
    61.  
      bpplschedwin
    62.  
      bppolicynew
    63.  
      bpps
    64.  
      bprd
    65.  
      bprecover
    66.  
      bprestore
    67.  
      bpretlevel
    68.  
      bpschedule
    69.  
      bpschedulerep
    70.  
      bpsetconfig
    71.  
      bpstsinfo
    72.  
      bpstuadd
    73.  
      bpstudel
    74.  
      bpstulist
    75.  
      bpsturep
    76.  
      bptestbpcd
    77.  
      bptestnetconn
    78.  
      bptpcinfo
    79.  
      bpup
    80.  
      bpverify
    81.  
      cat_convert
    82.  
      cat_export
    83.  
      cat_import
    84.  
      configureCerts
    85.  
      configureCertsForPlugins
    86.  
      configureMQ
    87.  
      configurePorts
    88.  
      configureWebServerCerts
    89.  
      create_nbdb
    90.  
      csconfig cldinstance
    91.  
      csconfig cldprovider
    92.  
      csconfig meter
    93.  
      csconfig throttle
    94.  
      csconfig reinitialize
    95.  
      duplicatetrace
    96.  
      importtrace
    97.  
      jbpSA
    98.  
      jnbSA
    99.  
      ltid
    100.  
      manageClientCerts
    101.  
      mklogdir
    102.  
      nbauditreport
    103.  
      nbcatsync
    104.  
      NBCC
    105.  
      NBCCR
    106.  
      nbcertcmd
    107.  
      nbcertupdater
    108.  
      nbcldutil
    109.  
      nbcloudrestore
    110.  
      nbcomponentupdate
    111.  
      nbcplogs
    112.  
      nbcredkeyutil
    113.  
      nbdb_admin
    114.  
      nbdb_backup
    115.  
      nbdb_move
    116.  
      nbdb_ping
    117.  
      nbdb_restore
    118.  
      nbdb_unload
    119.  
      nbdb2adutl
    120.  
      nbdbms_start_server
    121.  
      nbdbms_start_stop
    122.  
      nbdc
    123.  
      nbdecommission
    124.  
      nbdelete
    125.  
      nbdeployutil
    126.  
      nbdevconfig
    127.  
      nbdevquery
    128.  
      nbdiscover
    129.  
      nbdna
    130.  
      nbemm
    131.  
      nbemmcmd
    132.  
      nbfindfile
    133.  
      nbfirescan
    134.  
      nbftadm
    135.  
      nbftconfig
    136.  
      nbgetconfig
    137.  
      nbhba
    138.  
      nbholdutil
    139.  
      nbhostidentity
    140.  
      nbhostmgmt
    141.  
      nbhypervtool
    142.  
      nbidpcmd
    143.  
      nbimageshare
    144.  
      nbinstallcmd
    145.  
      nbjm
    146.  
      nbkmiputil
    147.  
      nbkmscmd
    148.  
      nbkmsutil
    149.  
      nboraadm
    150.  
      nborair
    151.  
      nbpem
    152.  
      nbpemreq
    153.  
      nbmlb
    154.  
      nbperfchk
    155.  
      nbplupgrade
    156.  
      nbrb
    157.  
      nbrbutil
    158.  
      nbregopsc
    159.  
      nbreplicate
    160.  
      nbrepo
    161.  
      nbrestorevm
    162.  
      nbseccmd
    163.  
      nbsetconfig
    164.  
      nbsnapimport
    165.  
      nbsnapreplicate
    166.  
      nbsqladm
    167.  
      nbstl
    168.  
      nbstlutil
    169.  
      nbstop
    170.  
      nbsu
    171.  
      nbsvrgrp
    172.  
      resilient_clients
    173.  
      restoretrace
    174.  
      stopltid
    175.  
      tldd
    176.  
      tldcd
    177.  
      tpautoconf
    178.  
      tpclean
    179.  
      tpconfig
    180.  
      tpext
    181.  
      tpreq
    182.  
      tpunmount
    183.  
      verifytrace
    184.  
      vltadm
    185.  
      vltcontainers
    186.  
      vlteject
    187.  
      vltinject
    188.  
      vltoffsitemedia
    189.  
      vltopmenu
    190.  
      vltrun
    191.  
      vmadd
    192.  
      vmchange
    193.  
      vmcheckxxx
    194.  
      vmd
    195.  
      vmdelete
    196.  
      vmoprcmd
    197.  
      vmphyinv
    198.  
      vmpool
    199.  
      vmquery
    200.  
      vmrule
    201.  
      vmupdate
    202.  
      vnetd
    203.  
      vssat
    204.  
      vwcp_manage
    205.  
      vxlogcfg
    206.  
      vxlogmgr
    207.  
      vxlogview
    208.  
      W2KOption
  3.  
    索引

名称

nbftconfig — 配置与光纤传输 (FT) 服务器和 SAN 客户端相关的属性

大纲

nbftconfig [-addclient] [-deleteclient] [-changeclient] [-rescanclient] [rescanallclients] [-listclients] [-addserver] [-deleteserver] [-changeserver] [-listservers] [-listactive] [-setconfig] [-getconfig] [-verbose] [-help]

nbftconfig -[ac]addclient -C client_name [-M master_server] [-ftpref preferred | always | never] [-ftwait minutes] [-ftrwait minutes]

nbftconfig -[dc]deleteclient -C client_name

nbftconfig -[cc]changeclient -C client_name {-ftpref preferred | always | never] [-ftwait minutes] [-ftrwait minutes] | -np number_of_ports}

nbftconfig -[rc]rescanclient client_name

nbftconfig -[ra]rescanallclients

nbftconfig -[lc]listclients [-verbose] [-C client_name | -Me media_server | -M master_server]

nbftconfig -[ds]deleteserver -Me media_server

nbftconfig -[cs]changeserver -Me media_server [-l connection_limit] [-state active | disabled]

nbftconfig -[ls]listservers [-Me media_server | -M master_server] [-verbose]

nbftconfig -[la]listactive [-C client_name | -Me media_server] [-verbose]

nbftconfig -[lt]listtargets [-Me media_server] [-verbose]

nbftconfig -setconfig [-M master_server] {-ftpref preferred | always | never [-ftwait minutes] [-ftrwait minutes] | -np number_of_ports [-ncp number_of_clients_per_target_port]}

nbftconfig -getconfig [-M master_server] [-verbose]

nbftconfig -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