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

名称

vltrun — 运行 NetBackup Vault 会话

大纲

vltrun -haltdups -vjobs vault_jobid [profile | robot/vault/profile] [-preview] [-verbose | -v] [-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\

描述

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)。