NetBackup™ 命令参考指南

Last Published:
Product(s): NetBackup (10.0)
  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.  
      bpcleanrestore
    22.  
      bpclient
    23.  
      bpclimagelist
    24.  
      bpclntcmd
    25.  
      bpclusterutil
    26.  
      bpcompatd
    27.  
      bpconfig
    28.  
      bpdbjobs
    29.  
      bpdbm
    30.  
      bpdgclone
    31.  
      bpdown
    32.  
      bpduplicate
    33.  
      bperror
    34.  
      bpexpdate
    35.  
      bpfis
    36.  
      bpflist
    37.  
      bpgetconfig
    38.  
      bpgetdebuglog
    39.  
      bpimage
    40.  
      bpimagelist
    41.  
      bpimmedia
    42.  
      bpimport
    43.  
      bpinst
    44.  
      bpkeyfile
    45.  
      bpkeyutil
    46.  
      bplabel
    47.  
      bplist
    48.  
      bpmedia
    49.  
      bpmedialist
    50.  
      bpminlicense
    51.  
      bpnbat
    52.  
      bpnbaz
    53.  
      bppficorr
    54.  
      bpplcatdrinfo
    55.  
      bpplclients
    56.  
      bppldelete
    57.  
      bpplinclude
    58.  
      bpplinfo
    59.  
      bppllist
    60.  
      bpplsched
    61.  
      bpplschedrep
    62.  
      bpplschedwin
    63.  
      bppolicynew
    64.  
      bpps
    65.  
      bprd
    66.  
      bprecover
    67.  
      bprestore
    68.  
      bpretlevel
    69.  
      bpschedule
    70.  
      bpschedulerep
    71.  
      bpsetconfig
    72.  
      bpstsinfo
    73.  
      bpstuadd
    74.  
      bpstudel
    75.  
      bpstulist
    76.  
      bpsturep
    77.  
      bptestbpcd
    78.  
      bptestnetconn
    79.  
      bptpcinfo
    80.  
      bpup
    81.  
      bpverify
    82.  
      cat_convert
    83.  
      cat_export
    84.  
      cat_import
    85.  
      configureCerts
    86.  
      configureMQ
    87.  
      configurePorts
    88.  
      configureWebServerCerts
    89.  
      create_nbdb
    90.  
      csconfig cldinstance
    91.  
      csconfig cldprovider
    92.  
      csconfig meter
    93.  
      csconfig reinitialize
    94.  
      csconfig throttle
    95.  
      duplicatetrace
    96.  
      importtrace
    97.  
      jbpSA
    98.  
      jnbSA
    99.  
      ltid
    100.  
      mklogdir
    101.  
      nbauditreport
    102.  
      nbcallhomeproxyconfig
    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.  
      nbfp
    135.  
      nbftadm
    136.  
      nbftconfig
    137.  
      nbgetconfig
    138.  
      nbhba
    139.  
      nbholdutil
    140.  
      nbhostidentity
    141.  
      nbhostmgmt
    142.  
      nbhypervtool
    143.  
      nbidpcmd
    144.  
      nbimageshare
    145.  
      nbinstallcmd
    146.  
      nbjm
    147.  
      nbkmiputil
    148.  
      nbkmscmd
    149.  
      nbkmsutil
    150.  
      nboraadm
    151.  
      nborair
    152.  
      nbpem
    153.  
      nbpemreq
    154.  
      nbmlb
    155.  
      nbperfchk
    156.  
      nbplupgrade
    157.  
      nbrb
    158.  
      nbrbutil
    159.  
      nbregopsc
    160.  
      nbreplicate
    161.  
      nbrepo
    162.  
      nbrestorevm
    163.  
      nbseccmd
    164.  
      nbserviceusercmd
    165.  
      nbsetconfig
    166.  
      nbsmartdiag
    167.  
      nbsnapimport
    168.  
      nbsnapreplicate
    169.  
      nbsqladm
    170.  
      nbstl
    171.  
      nbstlutil
    172.  
      nbstop
    173.  
      nbsu
    174.  
      nbsvrgrp
    175.  
      netbackup_deployment_insights
    176.  
      resilient_clients
    177.  
      restoretrace
    178.  
      stopltid
    179.  
      tldd
    180.  
      tldcd
    181.  
      tpautoconf
    182.  
      tpclean
    183.  
      tpconfig
    184.  
      tpext
    185.  
      tpreq
    186.  
      tpunmount
    187.  
      verifytrace
    188.  
      vltadm
    189.  
      vltcontainers
    190.  
      vlteject
    191.  
      vltinject
    192.  
      vltoffsitemedia
    193.  
      vltopmenu
    194.  
      vltrun
    195.  
      vmadd
    196.  
      vmchange
    197.  
      vmcheckxxx
    198.  
      vmd
    199.  
      vmdelete
    200.  
      vmoprcmd
    201.  
      vmphyinv
    202.  
      vmpool
    203.  
      vmquery
    204.  
      vmrule
    205.  
      vmupdate
    206.  
      vnetd
    207.  
      vssat
    208.  
      vwcp_manage
    209.  
      vxlogcfg
    210.  
      vxlogmgr
    211.  
      vxlogview
    212.  
      W2KOption
  3.  
    索引

名称

bpnbat — 在 NetBackup 中执行身份验证任务

大纲

bpnbat [-AddDomain | -RemoveDomain] Private_Domain

bpnbat [-AddMachine]

bpnbat [-AddUser | -RemoveUser] Name Private_Domain

bpnbat -GetBrokerCert Broker_Name Broker_Port

bpnbat -Login [-Info answer_file] [-cf credential_file] [-LoginType AT|WEB|APIKEY|WEBUI] [-skipDomainValidation]

bpnbat -LoginMachine

bpnbat -Logout [-LogoutType AT|WEB|APIKEY|WEBUI] [-cf credential_file]

bpnbat -RemoveBrokerCert host_name

bpnbat -RenewCred [-cf credential_file]

bpnbat -ShowBrokerCerts

bpnbat -ShowMachines

bpnbat -Version

bpnbat -WhoAmI [-cf credential_file] [-Verify]

 

On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/

On Windows systems, the directory path to this command is install_path\NetBackup\bin\

描述

bpnbat 命令是允许用户使用 Veritas Product Authentication and Authorization Service 的工具。

此服务包含以下两个不同的部分:

  • 身份验证 - 验证您的身份

  • 授权 - 检查您可以执行的操作

bpnbat 使用户可以在 NetBackup 中执行身份验证任务。

如果命令需要密码,它将不回显密码或星号,那样将会使他人显著缩小密码搜索范围。

NetBackup Access Control 要求用户的主目录能够正常工作。

必须有管理员权限才能运行以下命令选项:-AddDomain-RemoveDomain-AddMachine-AddUser-RemoveUser-LoginMachine-ShowMachines

选项

[-AddDomain | -RemoveDomain] Private_Domain

使用这些选项,身份验证服务器上的本地管理员可以在专用 Veritas Domain 数据库中添加或删除域。从任何操作系统中都无法访问这些域。它们仅在 Veritas Product Authentication and Authorization Service 内才有意义。它们将用于集中命名机构不可用的情况(如 PDC/AD 或 NIS 域)。

-AddMachine

在专用的 Veritas Product Authentication 中注册计算机。该标识位于专用域 NBU_Machines@at.server.name 中。对您的身份验证代理 (root + ab) 运行此选项。

[-AddUser | -RemoveUser] Private_Domain

使身份验证服务器上的本地管理员可以在专用 Veritas Domain 数据库的域中添加或删除用户。这些帐户仅在 Veritas Product Authentication and Authorization Service 内才有意义。它们将用于集中命名机构不可用的情况(如 PDC/AD 或 NIS 域)。

-GetBrokerCert

获取代理证书而无需向代理验证身份。

-Login [-Info answer_file] [-cf credential_file] [-LoginType AT|WEB|APIKEY|WEBUI][-requestApproval]

向系统标识您的身份。不带任何选项运行此命令时,系统将提示您输入名称、密码、域、身份验证类型和服务器以进行身份验证。名称、密码、域和域类型的组合可以在企业范围的网络中创建唯一标识。首次联系代理时,将询问您是否愿意信任该代理并对它们进行身份验证。不能使用不可信的代理。

注意:

要执行某些授权令牌和基于主机 ID 的证书相关操作,必须使用 bpnbat -login 命令。

-Info 选项可接受应答文件中的用户名、密码和域信息。在应答文件中,密码是可选项。您也可以将证书放置在凭据文件(如已指定)或默认位置。如果您未提供密码,则在运行此命令时,系统将提示您输入密码。

-Info 选项可接受应答文件中的用户名、密码和域信息。在应答文件中,密码是可选项。您也可以将证书放置在凭据文件(如已指定)或默认位置。如果您未提供密码,则在运行此命令时,系统将提示您输入密码。-Info 选项仅适用于 ATWEBAPIKEY 登录。

-requestApproval 选项仅适用于 WEBUI 登录。使用此选项可请求 NetBackup 命令行界面执行权限。

对于 APIKEY 登录类型,应答文件应按以下顺序包含详细信息:

User name
API key
Master server

应答文件示例:

administrator
A1WMg0EmC4pKBXlZjL61qlqJ0YE4-IRacjViMKLg9pUVaU-XJAnroQNawlnKLaNx
nbmaster1

警告:

将用户名和密码保存在纯文本文件中,将存在潜在的安全问题。对该文本文件具有读访问权限的未授权用户可获取 Veritas Product Authentication and Authorization Service 的用户名和密码,以使用 bpnbat 命令手动进行身份验证。确保安全地访问应答文本文件。

应答文件是指包含所需信息条目的文本文件。

WEB 的应答文件必须包含按以下所示顺序显示的四行:

            domain type
domain
user name
password
          

以下是一个示例应答文件:

NT
Sample_Domain
administrator
s@Mpl3

AT 的应答文件必须包含按以下所示顺序显示的四行:

            domain type
domain
user name
password
authentication broker
          

以下是一个示例应答文件:

unixpwd
Sample_Domain
root
s@Mpl3
Sample_Domain

如之前所述,密码是可选值。域类型值必须是以下所示值之一:

  • NIS

  • NIS+

  • NT

  • vx

  • unixpwd

如果使用应答文件,请确保服务器上已配置适当的 AUTHENTICATION_DOMAIN。请参见《NetBackup 安全和加密指南》

NetBackup Web 管理控制台服务 (nbwmc) 始终在 NetBackup 主服务器上运行。身份验证代理通常也在 NetBackup 主服务器上运行。但在某些情况下,身份验证代理在主机而非主服务器上运行。

APIKEY 的应答文件必须包含所示的三行:

            Login name
API key
Master server
          

如果 -LoginTypeAT,则仅对主服务器执行 NetBackup AT 代理登录。如果 -LoginTypeWEBAPIKEY,则仅对身份验证代理或主服务器执行 NetBackup Web 应用程序登录。如果未指定 -LoginType,且身份验证代理位于主服务器上,则同时执行 ATWEB 登录。如果未指定 -LoginType,且身份验证代理不位于主服务器上,则 WEB 登录将成功,AT 登录将失败。AT 登录失败且安全服务状态码为 96。如果 -LoginTypeAPIKEY,则仅执行 API 密钥登录。如果 –cf-LoginTypeWEB,则 APIKEY 选项不适用。

-LoginMachine

标识使用 Veritas Security Subsystem 专用域 NBU_Machines@at.server.name 中的帐户的计算机。对 NetBackup 介质服务器、主服务器和客户端运行此选项。此选项类似于以用户身份登录身份验证代理。

-Logout [-cf credential_file] [-LogoutType AT|WEB|APIKEY|WEBUI]

使当前用户的凭据失效,用户需要重新登录才能继续。如果没有 -cf 选项,存储在默认位置的凭据将失效。-cf 选项指向实际的凭据文件,可以允许用户显式指定要失效的凭据。

如果 -LogoutTypeAT,则仅执行 NetBackup AT 代理注销。如果 -LogoutTypeWEBWEBUIAPIKEY,则执行 NetBackup Web 应用程序注销。如果未指定 -LogoutType,则同时执行 ATwebWEBUI 注销。–cf 选项仅适用于 AT 注销。

-RemoveBrokerCert server.name.com

对除 root 用户(管理员)之外的全部用户,删除对指定身份验证代理的信任。可以使用此命令来删除不再信任的代理。例如,身份验证代理移到公司的其他部门。

-RenewCred [-cf credential_file]

续订 VxSS 存储的当前用户凭据或通过 -cf 选项指定的凭据文件。

-ShowBrokerCerts

列出用户当前信任的所有代理。NetBackup 信任列出的任何代理来处理发送给它的身份验证请求。

-ShowMachines

列出所有使用 -AddMachines 选项添加到专用 Veritas Security Subsystem 数据库的计算机域中的计算机。还会显示 DNS 是否完全解析了计算机名称。对您的身份验证代理 (root + ab) 运行此选项。

-skipDomainValidation

使用此选项可跳过身份验证域验证。仅适用于 ATWEB 登录。

-Version

检索可执行文件的版本。

-WhoAmI [-cf credential_file] [-Verify]

指定当前在 Veritas Product Authentication and Authorization Service 中使用的标识。它列出以下内容:

  • 名称

  • 如果登录类型为 API 密钥,则域显示为 vrts.apikey

    对于 WEBUI 登录类型,如果请求批准,以执行 NetBackup 命令行界面,则域显示为 CLI

  • 发布凭据的身份验证代理

  • 证书的失效时间

  • 创建凭据时使用的域类型

示例

示例 1 - 用户使用 -Login 和默认端口号连接到名为 test.domain.veritas.com 的身份验证代理(它是处理身份验证过程的服务器)。使用 NIS 帐户。因此,除了用户和密码,还会提供与该 NIS 帐户关联的域名。

# bpnbat -Login
Authentication Broker: test.domain.veritas.com
Authentication port[ Enter = default]:
Authentication type (NIS, NISPLUS, WINDOWS, vx, unixpwd): NIS
Domain: domain.veritas.com
Name: username
Password: 
You do not currently trust the server: test.domain.veritas.com, do 
you wish to trust it? (y/n): y
Operation completed successfully.

示例 2 - -WhoAmI 选项验证您当前在 Veritas Product Authentication and Authorization Service 中使用的标识。

# bpnbat -WhoAmI
Name: user name
Domain: domain.veritas.com
Issued by: /CN=broker/OU=root@eek.example.com/O=vx
Expiry Date: Oct 27 20:57:43 2009 GMT
Authentication method: NIS
Operation completed successfully.

示例 3 - 将计算机添加到计算机标识列表中:

# bpnbat -AddMachine
Machine Name: auto.domain.veritas.com
Password: 
Operation completed successfully.

接下来,会显示计算机标识列表:

# bpnbat -ShowMachines
auto.domain.veritas.com
Operation completed successfully

然后它将计算机登录到指定的身份验证代理中:

# bpnbat -LoginMachine
Does this machine use Dynamic Host Configuration Protocol (DHCP)? 
(y/n) n
Authentication Broker: test.domain.veritas.com
Authentication port[ Enter = default]: 
Name: auto.domain.veritas.com
Password: 
Operation completed successfully.

最后,将计算机登录到指定的身份验证代理并出现一个问题:

如果用户的配置中有多个 NIC,或者键入的代理名称有误,则会再次显示提示。使用户还有一次机会输入正确的代理名称。以下示例假设 sleemanNB 为专用 NIC 名称。Veritas Product Authentication and Authorization Service 用来建立身份验证域的公用 NIC 名称是 sleeman.example.com。如果用户使用 -loginmachine 命令时出现了故障(包括错误的计算机名称、密码或代理名称等),则用户还有一次机会为身份验证代理输入显式主服务器主机名。请参考以下示例:

# bpnbat -LoginMachine
Does this machine use Dynamic Host Configuration Protocol (DHCP)? 
(y/n) n
Authentication Broker: sleemanNB
Authentication port[ Enter = default]: 
Machine Name: challenger
Password: 
Primary host name of broker: sleeman.example.com
Operation completed successfully.

示例 4 - 获取代理证书而无需向代理验证身份。它需要一个代理 (test.domain.veritas.com) 和一个端口(默认为 0)

# bpnbat -GetBrokerCert test.domain.veritas.com 0
Operation completed successfully.

示例 5 - 列出用户当前信任的所有代理。

# bpnbat -ShowBrokerCerts
Name: root
Domain: root@test.domain.veritas.com
Issued by: /CN=root/OU=root@test.domain.veritas.com/O=vx
Expiry Date: Jun 12 20:45:19 2006 GMT
Authentication method: Veritas Private Security

Name: root
Domain: root@auto.domain.veritas.com
Issued by: /CN=root/OU=root@auto.domain.veritas.com/O=vx
Expiry Date: Feb 17 19:05:39 2006 GMT
Authentication method: Veritas Private Security
Operation completed successfully.

示例 6 - 当用户不再愿意信任某个代理时,可以使用 -RemoveBrokerCert 选项删除它。在以下示例中,将身份验证代理移到公司的其他部门。

# bpnbat -RemoveBrokerCert test.domain.veritas.com
Operation completed successfully.

现在,用户可以使用 -ShowBrokerCerts 选项来显示当前的证书。不再显示以前删除的证书。

示例 7 - 说明如何使用应答文件为自动执行命令(cron 等)提供登录信息。

对于 UNIX:UNIX NIS 域名是 location.example.com、此域的用户名是 bgrable、密码是 hello456bpnbat -login 相应的应答文件必须包含以下四行:

NIS
location.example.com 
bgrable
hello456

如果应答文件位于 /docs 中,且名为 login.txt,则 bpnbat 命令将执行以下操作:

# bpnbat -login -info /docs/vslogin.txt

运行 bpnbat -login 命令后,可运行诸如 bpbackup 的命令而不会出现身份验证错误。

对于 Windows:Windows 域名是 corporate,该域的用户名是 jsmith,用户密码是 hello123。bpnbat -login 相应的应答文件必须包含以下四行:

NT
corporate 
jsmith
hello123

如果应答文件位于 /docs 中,且名为 login.txt,则 bpnbat 命令将执行以下操作:

# bpnbat -login -info c:\docs\vslogin.txt

运行 bpnbat -login 命令后,可运行诸如 bpbackup 的命令而不会出现身份验证错误。

示例 8 - 如何将 -LoginType 参数与 bpnbat -login 命令配合使用。

# bpnbat -login -LoginType AT
Authentication Broker: server.domain.com
Authentication port [0 is default]: 0
Authentication type (NIS, NISPLUS, WINDOWS, vx, unixpwd, ldap): unixpwd
Domain:  server.domain.com
Login Name: root
Password:
Operation completed successfully.
# bpnbat -login -LoginType WEB
Authentication Broker: server.domain.com
Authentication port [0 is default]: 0
Authentication type (NIS, NISPLUS, WINDOWS, vx, unixpwd, ldap): unixpwd
Domain:  server.domain.com
Login Name: root
Password:
Operation completed successfully.

另请参见

请参见bpnbaz(1m)。

请参见nbcertcmd(1m)。