NetBackup™ 命令参考指南

Last Published:
Product(s): NetBackup & Alta Data Protection (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.  
    索引

名称

vltcontainers — 在逻辑上将卷移到容器中

大纲

vltcontainers -run [-rn robot_number]

vltcontainers -run -usingbarcodes [-rn robot_number]

vltcontainers -run -vltcid container_id -vault vault_name -sessionid session_id

vltcontainers -run -vltcid container_id -f file_name [-rn robot_number] [-usingbarcodes]

vltcontainers -view [-vltcid container_id]

vltcontainers -change -vltcid container_id -rd return_date

vltcontainers -delete -vltcid container_id

vltcontainers -version

 

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\

描述

vltcontainers 可将从一个或多个保管库会话中弹出的介质逻辑添加到容器中。它还可以查看、设置或更改场外容器或已经位于场外保管库中的容器的返回日期。vltcontainers 还可以从 NetBackup 和介质管理器目录库中删除容器。

可以按如下方式将介质 ID 添加到容器中:

  • 使用键盘输入容器和介质 ID。

  • 使用键盘接口条形码读取器扫描容器 ID 和介质 ID。键盘接口读取器也称为键盘“楔接”读取器,因为它们可在计算机上的键盘和键盘端口之间建立连接(或楔接)。

  • 使用一个输入文件,该文件包含将添加到一个容器中的所有介质的介质 ID 或等效条形码数字。要将介质添加到多个容器中,请使用键盘或键盘接口条形码读取器输入 ID。或者,再次运行 vltcontainers 命令并指定不同的容器和文件名选项。

  • 将特定会话弹出的所有介质添加到一个容器中。要将来自一个弹出会话的介质添加到多个容器中,请使用键盘或键盘接口条形码读取器输入 ID。

NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。/usr/openv/msg/.conf 文件 (UNIX) 和 install_path\VERITAS\msg\LC.CONF 文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。

有关更多信息,请参见 NetBackup 管理指南,第 II 卷中的“关于指定 NetBackup 安装的区域设置”主题。

从许可使用保管库的 NetBackup 主服务器运行 vltcontainers 命令。

如果以下具有公共写入权限的目录存在,则 vltcontainers 会写入其每日调试日志文件(log.DDMMYY,其中 DDMMYY 是当前日期)中:

UNIX 系统:usr/openv/netbackup/logs/vault

Windows 系统:install_path\netbackup\logs\vault

由于并非所有写入该文件的可执行文件都是以管理员或 root 用户身份运行的,因此需要公共写入权限。

选项

-change

更改容器的默认返回日期。容器的默认返回日期是容器中最后返回的卷的日期。它需要 -vltcid container_id 选项。

-delete

从 NetBackup 和介质管理器目录库中删除容器记录。仅当容器中不包含任何介质时,才能将其删除。

-f file_name

指定要从中读取介质 ID 的文件。文件中列出的所有介质都会添加到 -vltcid 选项指定的容器中。该文件可以是介质 ID 的列表(每行一个 ID)。或者,该文件也可以是由条形码读取器扫描到文件中的条形码等效数字列表(每行一个条形码)。

-rd return_date

指定容器的返回日期。

返回日期的格式取决于区域设置。

-rn robot_number

指定机械手,该机械手用于确定 vltcontainers 命令从中获取介质信息的 EMM 服务器。如果不使用 -rn robot_number-rn robot_number,会将主服务器视为 EMM 服务器。只有可添加到容器的介质才是 EMM 服务器上的数据库中的介质。

-run

将介质逻辑添加到容器中。如果不指定其他选项,则必须使用键盘输入容器 ID 和介质 ID。要使用条形码读取器扫描容器和介质 ID,请指定 -usingbarcodes 选项。要添加由特定会话弹出的介质,请使用 -vault vault_name-sessionid session_id 选项。要添加在文件中指定的介质,请使用 -f file_name 选项。要指定主服务器以外的 EMM 服务器,请使用 -rn robot_number 选项。

-sessionid session_id

保管库会话 ID。指定的会话弹出的所有介质都将添加到 -vltcid 选项指定的容器中。

-usingbarcodes

指定键盘接口条形码读取器,该读取器可扫描容器 ID 和介质 ID,或在 -f file_name-f file_name 指定的文件中使用的条形码数字。键盘接口条形码读取器(又称键盘楔接条形码读取器)将键盘和计算机上的键盘端口连接起来。

-vault vault_name

弹出介质的配置文件所属的保管库的名称。还必须指定弹出介质(以便添加到容器中)的会话 ID (-sessionid)。

-version

显示 vltcontainers 的版本,然后退出。

-view [-vltcid container_id]

显示为所有容器指定的返回日期。使用 -vltcid container_id 选项和参数可显示特定容器的返回日期。

-vltcid container_id

指定容器 ID。容器 ID 可以是由最多 29 个字母数字字符(不包含空格)组成的字符串。-rd return_date 选项和参数用于更改容器返回日期。

示例

示例 1 - 使用以下命令可以:

  • 将从 0 号机械手弹出的卷添加到容器中。

  • 使用条形码读取器扫描容器 ID 和介质 ID。

# vltcontainers -run -usingbarcodes -rn 0

示例 2 - 查看容器 ABC123 的返回日期:

# vltcontainers -view -vltcid ABC123

示例 3 - 将容器 ABC123 的返回日期更改为 2012 年 12 月 7 日:

# vltcontainers -change -vltcid ABC123 -rd 12/07/2012

示例 4 - 从 NetBackup 和介质管理器目录库中删除容器 ABC123,请使用以下命令:

# vltcontainers -delete -vltcid ABC123

示例 5 - 将保管库 MyVault_Cntr 的会话 4 弹出的所有介质添加到容器 ABC123 中,请使用以下命令:

# vltcontainers -run -vltcid ABC123 -vault MyVault_Cntr -sessionid 4

示例 6 - 将在 medialist 文件中列出且从 0 号机械手弹出的介质添加到容器 ABC123 中:

UNIX 系统:

# vltcontainers -run -vltcid ABC123 -f 
/home/jack/medialist -rn 0

Windows 系统:

# vltcontainers -run -vltcid ABC123 -f 
C:\home\jack\medialist -rn 0

示例 7 - 使用以下命令可以:

  • 将从挂接到主服务器的机械手弹出的介质添加到容器 ABC123 中

  • medialist 文件中读取该介质的条形码

UNIX systems: # vltcontainers -run -vltcid ABC123 -f 
/home/jack/medialist -usingbarcodes
Windows systems: # vltcontainers -run -vltcid ABC123 -f 
C:\home\jack\medialist -usingbarcodes

返回值

保管库退出时的状态码可能会大于 255。此类状态码称为扩展退出状态码。对于此类情况,返回到系统的退出状态为 252。实际退出状态将按如下格式写入 stderr:EXIT status = exit status

《NetBackup 故障排除指南》和《NetBackup 故障排除向导》中介绍了扩展的退出状态值。

文件

UNIX 系统:

/usr/openv/netbackup/vault/sessions/cntrDB
/usr/openv/netbackup/db/vault/vault.xml
/usr/openv/netbackup/logs/vault

Windows 系统:

install_path\NetBackup\vault\sessions\cntrDB
install_path\NetBackup\db\vault\vault.xml
install_path\NetBackup\logs\vault

另请参见

请参见vltoffsitemedia(1m)。

请参见vltopmenu(1m)。