Veritas NetBackup™ 命令参考指南

Last Published:
Product(s): NetBackup (8.2)
  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.  
      configureCertsForPlugins
    85.  
      configureMQ
    86.  
      configurePorts
    87.  
      configureWebServerCerts
    88.  
      create_nbdb
    89.  
      csconfig cldinstance
    90.  
      csconfig cldprovider
    91.  
      csconfig meter
    92.  
      csconfig throttle
    93.  
      csconfig reinitialize
    94.  
      duplicatetrace
    95.  
      importtrace
    96.  
      jbpSA
    97.  
      jnbSA
    98.  
      ltid
    99.  
      manageClientCerts
    100.  
      mklogdir
    101.  
      nbauditreport
    102.  
      nbcatsync
    103.  
      NBCC
    104.  
      NBCCR
    105.  
      nbcertcmd
    106.  
      nbcertupdater
    107.  
      nbcldutil
    108.  
      nbcloudrestore
    109.  
      nbcomponentupdate
    110.  
      nbcplogs
    111.  
      nbdb_admin
    112.  
      nbdb_backup
    113.  
      nbdb_move
    114.  
      nbdb_ping
    115.  
      nbdb_restore
    116.  
      nbdb_unload
    117.  
      nbdbms_start_server
    118.  
      nbdbms_start_stop
    119.  
      nbdc
    120.  
      nbdecommission
    121.  
      nbdelete
    122.  
      nbdeployutil
    123.  
      nbdevconfig
    124.  
      nbdevquery
    125.  
      nbdiscover
    126.  
      nbdna
    127.  
      nbemm
    128.  
      nbemmcmd
    129.  
      nbfindfile
    130.  
      nbfirescan
    131.  
      nbftadm
    132.  
      nbftconfig
    133.  
      nbgetconfig
    134.  
      nbhba
    135.  
      nbholdutil
    136.  
      nbhostidentity
    137.  
      nbhostmgmt
    138.  
      nbhypervtool
    139.  
      nbimageshare
    140.  
      nbinstallcmd
    141.  
      nbjm
    142.  
      nbkmsutil
    143.  
      nboraadm
    144.  
      nborair
    145.  
      nbpem
    146.  
      nbpemreq
    147.  
      nbperfchk
    148.  
      nbplupgrade
    149.  
      nbrb
    150.  
      nbrbutil
    151.  
      nbregopsc
    152.  
      nbreplicate
    153.  
      nbrepo
    154.  
      nbrestorevm
    155.  
      nbseccmd
    156.  
      nbsetconfig
    157.  
      nbsnapimport
    158.  
      nbsnapreplicate
    159.  
      nbsqladm
    160.  
      nbstl
    161.  
      nbstlutil
    162.  
      nbstop
    163.  
      nbsu
    164.  
      nbsvrgrp
    165.  
      resilient_clients
    166.  
      restoretrace
    167.  
      stopltid
    168.  
      tl4d
    169.  
      tl8d
    170.  
      tl8cd
    171.  
      tldd
    172.  
      tldcd
    173.  
      tlhd
    174.  
      tlhcd
    175.  
      tlmd
    176.  
      tpautoconf
    177.  
      tpclean
    178.  
      tpconfig
    179.  
      tpext
    180.  
      tpreq
    181.  
      tpunmount
    182.  
      verifytrace
    183.  
      vltadm
    184.  
      vltcontainers
    185.  
      vlteject
    186.  
      vltinject
    187.  
      vltoffsitemedia
    188.  
      vltopmenu
    189.  
      vltrun
    190.  
      vmadd
    191.  
      vmchange
    192.  
      vmcheckxxx
    193.  
      vmd
    194.  
      vmdelete
    195.  
      vmoprcmd
    196.  
      vmphyinv
    197.  
      vmpool
    198.  
      vmquery
    199.  
      vmrule
    200.  
      vmupdate
    201.  
      vnetd
    202.  
      vssat
    203.  
      vwcp_manage
    204.  
      vxlogcfg
    205.  
      vxlogmgr
    206.  
      vxlogview
    207.  
      W2KOption

名称

vltrun — 运行 NetBackup Vault 会话

大纲

vltrun -haltdups -vjobs vault_jobid [profile | robot/vault/profile] [-preview] [-verbose | -v] [-version]

 

在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/

在 Windows 系统中,此命令的目录路径为 install_path\NetBackup\bin\

描述

vltrun 通过发出一系列对保管库引擎的调用来驱动 NetBackup Vault 会话。会话中还可以选择包含用户提供的通知脚本的标注。

选项

profile | robot/vault/profile

指定配置文件的名称或保管库参数文件中嵌套的机械手编号、保管库和配置文件。如果使用 profile 而不指定 robotvault,则配置文件必须在保管库参数文件中是唯一的。必须指定此选项。

-vjob vault_jobid

指定当前复制的处于活动状态的保管库作业的作业 ID。

-haltdups

终止所有关联的、活动保管库复制作业。

-preview

为要在保管库会话中进行保管的映像生成预览列表。结果将写入会话目录下的 preview.list 文件。

-verbose | -v

在保管库调试日志中生成详细的会话报告。

-version

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

用法

按以下顺序执行 vltrun 会话:

  • 运行 vlt_start_notify 脚本。

  • 清点介质。

  • 为返回到机械手的保管库介质初始化介质管理器数据库。

  • 生成要进行保管的预览映像的列表。

  • 复制映像。

  • 清点介质管理器数据库(第一次)。

  • 为 NetBackup 目录库备份而分配介质。

  • 清点介质管理器数据库(第二次)。

  • 清点映像。

  • 暂停介质。

  • 运行 vlt_end_notify 脚本。

  • 再次清点映像。

  • 分配插槽 ID。

  • 备份 NetBackup 目录库。

  • 清点介质管理器数据库(第三次,也是最后一次)。

  • 运行 vlt_ejectlist_notify 脚本。

  • 生成弹出列表。

  • 运行 vlt_starteject_notify 脚本。

  • 弹出并报告。

  • 运行 vlt_end_notify 脚本。

可以通过以下任何一种方式运行 vltrun

  • 直接从命令行运行。

  • 通过 NetBackup 策略预定。在这种情况下,该策略必须包含 Vault 类型,并且该策略的文件列表必须包含 vltrun 命令。

  • 在保管库界面或 vltadm 中,为配置文件运行 Start Session 命令。

vltrun 使用 profile|robot/vault/profile 选项来运行保管库会话。如果保管库配置中没有其他具有相同名称的配置文件,则可以使用该选项的 profile 形式。在这种情况下,使用配置文件名就足以唯一地标识配置信息。

如果多个配置文件具有相同的名称,则应使用 robot/vault/profile 形式来唯一地标识该配置。

不要在保管库会话运行时修改保管库配置。

会话启动时,它将创建一个目录,用于存放 vltrun 和保管库引擎在会话期间创建的文件。

保管库会话使用以下目录:

UNIX 系统:

/usr/openv/netbackup/vault/sessions/vault_name/sidxxx

Windows 系统:

install_path\NetBackup\vault\sessions\vault_name\sidxxx

xxx 变量是分配给该会话的唯一整数。对于每个保管库名称,将从 1 开始按顺序分配会话标识符。

如果已在保管库属性中配置了电子邮件地址,则在会话结束后,会将电子邮件发送到此地址。该电子邮件将报告会话结果。默认情况下,将电子邮件发送给 root。

vltrun 将在会话目录中生成名为 summary.log 的会话概述文件。

通过在 NetBackup 二进制文件的目录 (/usr/openv/netbackup/bin) 中安装通知脚本,可在会话的几个时刻控制保管库进程。有关通知脚本的更多信息,请参考 NetBackup Vault 管理指南

可以在 NetBackup 活动监视器中监视 vltrun 会话的进度。

活动监视器主窗口上的“操作”字段使用以下状态显示保管库会话的进度:

  • 正在选择映像。

  • 正在复制映像。

  • 正在选择介质。

  • 目录库备份。

  • 弹出并报告。

  • 结束。

如果创建以下具有公共写入权限的目录,则 vltrun 将在此目录下创建每日调试日志:

UNIX 系统:

usr/openv/netbackup/logs/vault

Windows 系统:

install_path\netbackup\logs\vault

该日志称为 log.DDMMYY(其中 DDMMYY 为当前日期)。然后就可使用此文件进行故障排除。

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

可以调整此日志文件中提供的日志记录信息的级别,方法是:通过 NetBackup 管理控制台上的“主机属性”,在主服务器属性的“日志记录”页上调整保管库的日志记录级别参数。

可以使用 vltrun -haltdups 命令来终止活动保管库复制作业。启动 -haltdups 脚本,该脚本将向主保管库作业(当前处于复制步骤阶段)发送 SIGUSR2 信号。然后将信号自动传播到所有保管库复制实例,而不等待任何当前复制作业实例完成。该步骤完成后,主保管库作业将继续其余步骤。

接收到 SIGUSR2 信号后,将显示下列终止保管库复制作业消息的作业详细信息:管理员请求了终止 (150)。

必须有管理员权限才能运行此命令。

示例

示例 1 - 保管配置文件 my_profile。

# vltrun my_profile

示例 2 - 保管机械手 0 的映像、保管库 Financials 和配置文件 Weekly。

# vltrun 0/Financials/Weekly

示例 3 - 终止 ID 为 1 的活动保管库复制作业。

# vltrun -haltdups -vjob 1

返回值

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

文件

UNIX 系统:

/usr/openv/netbackup/vault
/usr/openv/netbackup/bp.conf
/usr/openv/netbackup/logs/bpcd/log.mmddyy
/usr/openv/netbackup/logs/vault/log.mmddyy
/usr/openv/netbackup/db/vault/vault.xml
/usr/openv/netbackup/vault/sessions/vault_name/sidxxx
/usr/openv/netbackup/vault/sessions/vault_name/sidxxx/summar
y.log
/usr/openv/netbackup/vault/sessions/vault_name/sidxxx/detail
.log

Windows 系统:

install_path\NetBackup\vault
install_path\NetBackup\bp.conf
install_path\NetBackup\logs\bpbrmvlt\mmddyy.log
install_path\NetBackup\logs\bpcd\mmddyy.log
install_path\NetBackup\logs\vault\mmddyy.log
install_path\NetBackup\db\vault\vault.xml
install_path\NetBackup\vault\sessions\vault_name\sidxxxinstall_path\NetBackup\vault\sessions\vault_name\sidxxx\summ
ary.log
install_path\NetBackup\vault\sessions\vault_name\sidxxx\deta
il.log

另请参见

请参见vltadm(1m)。

请参见vlteject(1m)。

请参见vltinject(1m)。

请参见vltoffsitemedia(1m)。

请参见vltopmenu(1m)。