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.  
    索引

名称

nbseccmd — 运行 NetBackup 安全配置服务实用程序

大纲

nbseccmd -drpkgpassphrase

nbseccmd -getNBKeysize [-server master_server_name] [-json]

nbseccmd -getpassphraseconstraints [-workflow | -w NetBackup workflow type] [-json]

nbseccmd -getsecurityconfig [[-autoaddhostmapping] | [-insecurecommunication] | [-dteglobalmode] | [-dtemediamode -mediaserver media_server_name] | [-externalcertidentity]] [-masterserver master_server_name]

nbseccmd -nbcaList [-state value] [-json]

nbseccmd -nbcaMigrate -initiateMigration | -i -keysize key_value -activateNewCA | -a -completeMigration | -c -decommissionCA | -d -fingerprint certificate_fingerprint -summary | -s -hostsPendingTrustPropagation | -pt -syncMigrationDB | -S -hostsPendingRenewal | -pr [-reason description_for_auditing] [-json] [-force] [-quiet]

nbseccmd -setpassphraseconstraints [-workflow | -w NetBackup workflow type] [-lowercase | -l minimum required lowercase characters] [-uppercase | -u minimum required uppercase characters] [-specialcharacter | -s minimum required special characters] [-digit | -d minimum required digits] [-minlength | -ml minimum required passphrase length]

nbseccmd -setsecurityconfig [[[-autoaddhostmapping | -insecurecommunication] off|on] | [-dteglobalmode 0|1|2] | [-dtemediamode off|on -mediaserver media_server_name}] | [-externalcertidentity dn|cn]] [-masterserver master_server_name]

nbseccmd -setuptrustedmaster -add | -update | -remove -masterserver master_server_name -remotemasterserver remote_master_server [-domainname domain_name] [-username username] -fpfile filename

nbseccmd -setuptrustedmaster –add | -update | -remove -info answer_file

nbseccmd -help

 

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

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

描述

使用 nbseccmd 命令在各主服务器之间建立信任关系。

如果启用了 NetBackup Access Control (NBAC),则必须具有 root 或管理员权限才能使用此命令。

注意:

如果源或目标主服务器版本为 NetBackup 8.0 或更早版本,请参考适用于 8.0 或更早版本的《NetBackup 命令指南》。在 NetBackup 8.1 中此命令已进行了多次更改。

选项

-activatenewca | -a

使用此选项激活可以开始颁发未来 NetBackup 证书的新 NetBackup CA。

-autoaddhostmapping [on|off]

使用此选项管理将主机 ID 添加到主机名或主服务器自动检测到的 IP 地址的行为。

主机可能具有多个与之关联的主机名称或 IP 地址。为了使主机之间成功通信,所有相关主机名和 IP 地址都必须映射到相应的主机 ID。在通信期间,NetBackup 可能会检测到与某个主机 ID 相关的新主机名或 IP 地址。

使用 -getsecurityconfig 时,此选项不使用参数,并且会报告 -autoaddhostmapping 值的当前设置。

使用 -setsecurityconfig 选项后,此选项将启用或禁用自动主机映射。使用 on 参数自动将主机 ID 映射到主机名或检测到的 IP 地址。使用 off 参数禁用此操作。

-completeMigration | -c

使用此选项可完成 NetBackup CA 迁移过程 ,并清除主服务器上的迁移状态。

-decommissionCA | -d

使用此选项可停用具有给定指纹的 NetBackup CA。

-digit | -d

指定密码中最少应包含多少个数字。

-domainname domain_name

指定在 -username 中指定的用户所属的域。系统会提示您输入密码以验证远程主服务器主机的凭据。

对于使用 NetBackup 证书的目标主服务器,需要使用 -domainname 选项。

-drpkgpassphrase

-drpkgpassphrase 选项用于指定用来加密灾难恢复软件包的密码。如果密码已存在,则会被覆盖。

注意:

必须设置密码才能成功备份目录。无法设置密码会导致目录备份失败。

灾难恢复软件包用于存储 NetBackup 主服务器,该软件包会在目录库备份期间创建。

这些软件包将使用此处指定的密码进行加密。发生灾难后,在主服务器上重新安装 NetBackup 时,必须提供此密码。

使用此命令前,必须运行 bpnbat 命令登录:

bpnbat -login -loginType WEB

设置密码时,请注意:

  • 如果未使用 -setpassphraseconstraints 选项设置密码约束,则密码必须至少包含 8 个字符,最多包含 1024 个字符。如果设置了密码约束,请确保遵从所有这些约束。

  • 新密码必须不同于现有密码。

  • 您必须是具有管理员或 root 权限的已获授权的用户或者必须是增强审核用户才能运行 nbseccmd -drpkgpassphrase 命令。

  • 密码仅支持以下列出的字符:

    • 空格

    • 大写和小写字母字符(A 到 Z、a 到 z)

    • 数字(0 到 9)

    • 显示的特殊字符:~ ! @ # $ % ^ & * ( ) _ + - = ` { } [ ] | : ; ' " , . / ? < >

    小心:

    如果输入不受支持的字符,可能会在灾难恢复软件包还原期间遇到问题。密码可能未验证,您可能无法还原灾难恢复软件包。

-dteglobalmode 0|1|2

指定要在全局级别设置的传输中数据加密模式。-dteglobalmode 选项可以具有以下值:

  • 0PREFERRED_OFF:指定在 NetBackup 域中禁用传输中数据加密。更改 NetBackup 客户端设置以覆盖此值。

  • 1PREFERRED_ON:指定仅对 NetBackup 9.1 及更高版本的客户端启用传输中数据加密。更改 NetBackup 客户端设置以覆盖此值。

  • 2ENFORCED:指定如果 NetBackup 客户端设置为 AutomaticOn,则强制执行传输中数据加密。选择此选项后,对于传输中数据加密设置为 Off 的 NetBackup 客户端以及版本低于 9.1 的主机,作业将失败。默认情况下,NetBackup 9.1 客户端的传输中数据加密设置为 Off。对于 NetBackup 10.0 及更高版本客户端,传输中数据加密设置为 Automatic

-dtemediamode off|on -mediaserver media_server_name

使用此选项可为数据传输作业中涉及的特定介质服务器禁用 DTE。可在主服务器上使用 nbseccmd 命令更改或查看 DTE 介质服务器设置。

-externalcertidentity dn|cn

使用此选项可更改外部 CA 签名证书的唯一证书标识属性。如果该选项设置为 dn,则将证书的完整可分辨名称视为唯一属性。如果该选项设置为 cn,则仅将证书的公用名称视为唯一标识属性。

-fingerprint certificate_fingerprint

指定需要停用的 NetBackup CA 的指纹。将此选项与 -decommissionCA 一起使用。指纹可以是 SHA-1 或 SHA-256 算法。

-fpfile filename

此选项可接受验证远程主服务器的根证书所需的根证书指纹信息。您可以将指纹详细信息存储在文本文件中。

-force

取消确认提示。-force 选项用于跳过对等待信任传播或证书续订的主机的检查。-force 选项用于激活新的 CA 并完成迁移。将此选项与 -completeMigration-activatenewCA 一起使用。

-getNBKeysize master_server_name

检索给定主服务器的 NetBackup CA 的密钥大小。

-getpassphraseconstraints workflow

检索特定工作流程的密码约束。如果未指定工作流程,则列出所有工作流程的密码约束。

-getsecurityconfig -autoaddhostmapping | -insecurecommunication | externalcertidentity

使用此选项获取 NetBackup 的安全配置信息。使用 -autoaddhostmapping 选项时,您将获取 -autoaddhostmapping 选项的值。使用 -insecurecommunication 选项时,您将获取 -insecurecommunication 选项的值。使用 -externalcertidentity 选项时,您将获取 -externalcertidentity 选项的值。

-hostsPendingRenewal | -pr

使用此选项可检索需要续订证书的主机列表。

-hostspendingtrustpropagation | -pt

使用此选项可检索在其信任存储区中没有所需 CA 证书的主机列表。

-info answerfile

-info 选项可接受设置可信主服务器所需的信息。此信息会存储在应答文件(文本文件)中。它包含以下条目:

masterserver:
remotemasterserver:
trusttype:
domainname:
username:
password:
token:
fpfile:

在应答文件中,password 是可选项。如果您未提供密码,则在运行此命令时,系统将提示您输入密码。

注意:

trusttype 值仅对 8.0 及更早版本的主服务器有效。trusttype 的可能值包括 mutualtrustremoteonlylocalonlylocalonlytrusttype 不需要域名或用户凭据。

应答文件中的条目必须与此示例所示的格式一致。

Example sample file:

masterserver:testmaster1
remotemasterserver:testmaster2
trusttype:mutualtrust
domainname:testdomain
username:Administrator
password:abc123
-initiateMigration | -i

使用此选项可启动 NetBackup 证书颁发机构 (CA) 迁移。它为 NetBackup 设置具有指定证书密钥大小的新 CA。新 CA 以待机模式运行,直到 CA 被激活或迁移状态转为 ACTIVATED

此操作不会更改根 CA。

在启动 CA 迁移之前,请确认未将具有 NetBackup 版本 8.1.2.1 或早期版本的介质服务器配置为云存储服务器。这些介质服务器上的备份将会失败。

-insecurecommunication [on | off]

使用此选项以在 NetBackup 环境内管理不安全通信。on 参数可启用与 NetBackup 环境中的所有 NetBackup 主机的不安全通信。使用 off 参数可禁用不安全通信。

Veritas 在 NetBackup 8.1 中实现了 8.0 和更低版本中没有的新安全功能。NetBackup 与 8.0 和更低版本主机之间的通信不安全。为了提高安全性,请将所有主机升级到最新版本的 NetBackup,然后将 on 参数与此选项结合使用。此操作可确保仅在 NetBackup 主机之间进行安全通信。

-json

在单独一行上以 JSON 格式打印数据。

-keysize key_value

将此选项与 -initiateMigration 选项结合使用可为要设置的新 NetBackup CA 指定证书密钥大小。密钥大小必须为以下所示大小之一:2048、4096、8192 或 16384 位。

小心:

应谨慎选择适合您环境的密钥大小。选择较大的密钥大小可能会降低性能。应考虑所有因素来确定适用于您环境的正确密钥大小。

-lowercase | -l

指定密码中最少应包含多少个小写字符。

-masterserver master_server_name

指定用户登录到的主服务器的名称。自动映像复制会为当前主服务器或源主服务器使用此名称。

-minlength | -ml

指定所需的最小密码长度。

-nbcamigrate

将现有的 NetBackup CA 迁移到新的 CA。

-nbcaList

使用此选项可列出 NetBackup 域中的 NetBackup CA。

-quiet

取消提示消息以进一步继续操作。可将此选项与 -initiateMigration 选项一起使用。

-reason description_for_auditing

指定存储在此操作审核记录中的原因。

-remotemasterserver remote_master_server

指定要建立信任关系的远程主服务器的名称。自动映像复制会为目标主服务器使用此名称。

-remoteonly | -localonly | -mutualtrust

指定建立信任关系必须采用的方式。是本地主服务器(源)信任远程主服务器(目标)还是相反。如果这两个选项均未指定,则会建立双向信任关系 (-mutualtrust)。

-setpassphraseconstraints

设置特定 NetBackup 工作流程的密码约束。例如,灾难恢复 (DR) 软件包。

-setsecurityconfig -autoaddhostmapping | -insecurecommunication | externalcertidentity

使用此选项设置 NetBackup 的安全配置信息。使用 -autoaddhostmapping 选项时,您将设置添加主机名和 IP 地址的行为。使用 -insecurecommunication 选项时,您将设置安全通信的行为。使用 -externalcertidentity 选项时,需要设置唯一外部证书标识属性的行为。

-setuptrustedmaster -add | -update | -remove

添加、更新或删除主服务器之间的域间信任。要更新信任关系,请在源服务器和目标服务器上运行 -update 选项。这两台服务器都必须运行版本 8.1 或更高版本。如果要在建立信任关系后将源或目标主服务器升级至 8.1 版或更高版本,则必须使用 -update 选项。要删除可信主服务器,不需要域、用户名和密码。

您可以将使用外部证书的信任关系更新为使用 NetBackup 证书的信任关系,反之亦然。

您必须先运行 bpnbat 命令以删除可信主服务器,然后才能使用 -setuptrustedmaster 选项。在本地登录要删除的主服务器并使用 bpnbat 命令,如下所示:bpnbat -login -loginType WEB

要删除使用外部证书添加的信任关系,不需要运行 bpnbat -login 命令。

specialcharacter | -s

指定密码中最少应包含多少个特殊字符。

-state value

将此选项与 -nbcaList 选项一起使用,以检索特定状态(例如 ACTIVEABANDONEDDECOMMISSIONED)的 NetBackup CA。使用逗号分隔的状态可过滤出具有多种状态的结果。

-summary

检索 NetBackup CA 迁移信息。它显示当前 NetBackup CA 迁移状态和当前负责证书颁发的 NetBackup CA 的指纹。

-syncMigrationDB | -S

使用当前 NetBackup CA 证书详细信息更新 CA 迁移数据库。

-uppercase | -u

指定密码中最少应包含多少个大写字符。

-username username

指定远程主服务器主机的登录用户名。此选项与 -domainname 选项结合使用。系统会提示您输入密码以验证远程主服务器主机的凭据。如果仅指定域名,系统会提示您输入远程主服务器的授权令牌。

对于使用 NetBackup 证书的目标主服务器,需要使用 -username 选项。

-workflow | -w

指定要为其设置密码的 NetBackup 工作流程。例如,要为 DR 软件包设置密码,则应将 -workflow 选项的值设置为 DR_PKG

示例

示例 1 - 使用用户凭据设置可信主服务器。

nbseccmd -setuptrustedmaster -add -masterserver testmaster1
-remotemasterserver testmaster2 -domainname testdomain -username 
Administrator
Password:******

The SHA1 fingerprint of root certificate is 
C7:87:7F:9D:13:B4:67:F6:D9:65:F4:95:EC:DC:D4:50:8C:20:18:BF.

Are you sure you want to continue using this certificate ? (y/n): y

The validation of root certificate fingerprint is successful.
CA certificate stored successfully from server testmaster2.
testdomain.com.
Host certificate received successfully from server testmaster2.
testdomain.com.
Trusted master operation successful.

示例 2 - 使用身份验证令牌设置可信主服务器。

nbseccmd -setuptrustedmaster -add -masterserver testmaster1
-remotemasterserver testmaster2 -domainname testdomain
Authorization Token:***** 
The SHA1 fingerprint of root certificate is 
C7:87:7F:9D:13:B4:67:F6:D9:65:F4:95:EC:DC:D4:50:8C:20:18:BF.
Are you sure you want to continue using this certificate ? (y/n): y
The validation of root certificate fingerprint is successful.
CA certificate stored successfully from server testmaster2.
testdomain.com.
Host certificate received successfully from server testmaster2.
testdomain.com.
Trusted master operation successful.

示例 3 - 使用 -fpfile 设置可信主服务器。

nbseccmd -setuptrustedmaster -add -masterserver testmaster1
-remotemasterserver testmaster2 -domainname testdomain -username 
Administrator
-fpfile C:\fp_file

Password:******

The validation of root certificate fingerprint is successful.
CA certificate stored successfully from server testmaster2.
testdomain.com.
Host certificate received successfully from server testmaster2.
testdomain.com.
Trusted master operation successful.

示例 4 - 使用应答文件设置可信主服务器。

nbseccmd -setuptrustedmaster -add -info C:\nbseccmd_answerfile.txt

The validation of root certificate fingerprint is successful.
CA certificate stored successfully from server testmaster2.
testdomain.com.
Host certificate received successfully from server testmaster2.
testdomain.com.
Trusted master operation successful.

示例 5 - 将源和主服务器升级至 8.1 版或更高版本后更新信任关系。

-setuptrustedmaster -update -masterserver testmaster1 -remotemasterserver 
testmaster2
Authorization Token:
Authenticity of root certificate cannot be established.
The SHA1 fingerprint of root certificate is finger_print_details
Are you sure you want to continue using this certificate ? (y/n): y
The validation of root certificate fingerprint is successful.
CA certificate stored successfully from server testmaster2.
Host certificate received successfully from server testmaster2.
Trusted master operation successful

示例 6 - 删除可信主服务器。

-setuptrustedmaster -remove -masterserver testmaster2 -remotemasterserver 
testmaster1

Certificate revoke request processed successfully.
Trusted master operation successful