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

名称

cat_convert — 运行 NetBackup 目录库格式转换实用程序

大纲

cat_convert -a2b [-o] [-s] [-v] source_file_directory [target_file_directory]

cat_convert -dump [-short] [-noheader] [-nopath] [-nodata] [-srec num] [-erec num] [-sep char] source_file

cat_convert -check source_file

cat_convert -decompress compressed_filetarget_file_directory

 

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

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

描述

cat_convert 用于在版本 3.4、4.0v 或 4.5 ASCII 格式与 4.5 或更高版本的二进制格式之间转换 NetBackup 目录库 .f 文件。它可自动检测源目录库文件格式并将其转换成其他格式。

-dump 选项使用户能查看二进制目录库映像 .f (dot-f) 文件的内容。它将在 stdout 上以可读格式回显 .f 文件的内容。它还有一些帮助选项,可用来将输出限制为仅显示文件中的某些记录或者某些输出列。

-check 选项可对指定的二进制 .f 文件执行一致性检查。

-decompress 选项允许您解压缩已使用 .Zl 压缩格式压缩的指定二进制 .f 文件。在 UNIX 平台上,它还支持 .Z 格式的解压缩。

如果 cat_convert 检测到存在不一致,实用程序最多会生成以下四个报告,具体取决于所报告的不一致的类型:

  • 无效索引节点报告

    此报告列出了无效的索引节点。下面是一个示例:

    Type Problem Additional Information
    Dir  No Data Path element name: SUNWmlib
    Dir  No Name Filenum: 7
    File No Data Path element name: vmd.uds
    File No Data Path element name: bpcompatd.uds
    File No Name Filenum: 8356
    Dir  No Name Filenum: 8374
    

    下面描述了此报告中的列信息:

    • Type - 显示该项是文件还是目录。

    • Problem - 显示导致无效索引节点的原因是无数据还是无名称。

    • Additional information - 与索引节点关联的路径元素名称、目录库收到的索引节点的 filenum 字段,或一条错误消息。

  • 无效目录报告

    此报告列出了不一致的目录。下面是一个示例:

    Index InodeIndex 1stChild 1stDir LastChild NextIndex NextDir Name
     2539      2230     5605F    -1      5605F   788763F     -1 JSP.cla
    21281      2229    43380F    -1   1122108F   257809F  56110 fr.tmp
    24157      3330    53103F    -1   2688747F       -1F     -1 UNKNOWN
    36766      4406    98367F    -1     98367F       -1F     -1 Root
    97393      5134   471040F    -1   3136322F       -1F     -1 udst.js
    
    Total Directories: 150307
          Total Files: 1137006

    下面描述了此报告中的列信息:

    • Index - 报告给目录库的目录相对位置。

    • Inode Index - 备份正在进行时用于存储索引节点信息的临时文件的索引。

    • 1st Child - 所列目录下的第一个子项(文件或目录)的索引。如果没有子项,则此值为 -1。如果第一个子项是文件,则索引后跟字符 F;如果第一个子项是目录,则索引后跟字符 D。

    • 1st Dir - 所列目录下的第一个目录的索引。如果没有子目录,则此值为 -1。

    • Last Child - 所列目录下的最后一个子项(文件或目录)的索引。如果没有子项,则此值为 -1。如果最后一个子项是文件,则索引后跟字符 F;如果最后一个子项是目录,则索引后跟字符 D。

    • Next Index - 所列文件的下一个同级项(文件或目录)。如果没有同级项,则此值为 -1。如果下一个同级项是文件,则索引后跟字符 F;如果下一个同级项是目录,则索引后跟字符 D。

    • Next Dir - 所列目录的下一个同级项的索引。如果没有同级目录,则此值为 -1。

    • Name - 目录的短名称(如果有),或 UNKNOWN(如没有)。

  • 无效文件报告

    此报告列出不一致的文件。以下是此报告的格式:

    Index   Inode Index  Next Index   Name
    2364          12180        2368F  Report.doc
    39774         16642       39776D  UNKNOWN

    下面描述了此报告中的列信息:

    • Index - 报告给目录库的文件相对位置。

    • Inode Index - 备份正在进行时用于存储索引节点信息的临时文件的索引。

    • Next Index - 所列文件的下一个同级项(文件或目录)。如果没有同级项,则此值为 -1。如果下一个同级项是文件,则索引后跟字符 F;如果下一个同级项是目录,则索引后跟字符 D。

    • Name - 目录的短名称(如果有),或 UNKNOWN(如没有)。

  • 无效目录或文件报告

    此报告列出不一致的文件和目录。以下是此报告的格式:

    Index   Inode    Type          Name
    2363    11134    Directory     /Documents/Directory 1
    13679   10077    Directory     /Documents/Directory 2
    Total Directories: 460724
          Total Files: 3426572

    下面描述了此报告中的列信息:

    • Index - 报告给目录库的文件相对位置。

    • Inode - 报告给目录库的文件或目录的索引节点号。

    • Type - 显示该项是文件还是目录。

    • Name - 目录的短名称(如果有),或 UNKNOWN(如没有)。

由于此报告遍历目录树,可能无法列出前两个报告中报告的所有文件或目录。报告提供了文件或目录的完全限定名称,因此在解决问题时很有用。它还提供了文件和目录的总数。

这些报告未本地化。

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

选项

-a2b

将 NetBackup 3.4、4.0V、4.5 ASCII 格式的 .f 目录库文件转换为 NetBackup 4.5 二进制格式的 .f 文件。

-check source_file

检查二进制 .f 文件的一致性。source_file 必须是完全限定的路径。不一致可能是由错误的 FlashBackup 或 NDMP 类型备份导致的。如果此实用程序未检测到不一致问题,则静默结束,并返回一个零返回代码。如果此实用程序检测到任何不一致问题,则返回不一致问题的数量,并最多输出三个报告(具体取决于所报告的不一致的类型)。

-decompress compressed_filetarget_file_directory

解压缩指定的二进制 .f 压缩文件。compressed_file 必须是完全限定路径。-decompress 用于解压缩已使用 .Zl 压缩格式压缩的目录库文件。在 UNIX 上,它还支持 .Z 格式的解压缩。target_directory 是解压缩操作放置解压缩文件的目录。

-dump

允许用户查看目录库映像 .f 文件的内容。

-erec num

修改 cat_convert -dump 的输出。在此记录编号处停止显示记录。

注意:

该记录编号不一定要与输出的第一列中的文件号相同。

-nodata

删除 cat_convert -dump 输出的数据列。数据列会导致输出非常大量的内容。

-noheader

修改 cat_convert -dump 的输出。此选项用于修改 cat_convert -dump 的输出。删除该列标题。

-nopath

修改 cat_convert -dump 的输出。删除该路径列。路径列会导致输出非常大量的内容。

-o

用新的内容重写原始目录库文件内容并转换格式。-o 不能与 target_file_directory 一起使用。

-s

在控制台窗口中显示统计信息。

-sep char

此选项用于修改 cat_convert -dump 的输出。此选项用于修改 cat_convert -dump 的输出。使用 char 分隔列,而不是使用默认的空格分隔。例如,可以使用该命令生成用逗号分隔的输出。

-short

此选项用于修改 cat_convert -dump 的输出。将输出限制为通常情况下显示的列的子集。

-srec num

此选项用于修改 cat_convert -dump 的输出。此选项用于修改 cat_convert -dump 的输出。从此记录编号开始显示记录。

注意:

该记录编号不一定要与输出的第一列中的文件号相同。

target_file_directory

-v

显示当前的进度信息。

指定要转换的以下项之一:

  • 要指定目标文件,源必须是一个文件。

  • 要指定目标目录,源必须是一个目录。

    如果源是一个目录,必须使用 -a2b

    通过这种转换创建的新文件将被转换为指定格式,并在目标目录中使用原文件名。

如果在转换源文件时未指定目标文件或目录,则转换过程创建的文件会附带一个后缀(_bin.f_ascii.f)。

如果 catalog .f 文件大小超过 4 MB,二进制目录库将使输出文件保持分开状态。并将它们放在 catstore 目录中。

示例

示例 1

# cat_convert -a2b abc.f

如果 abc.f 为 ASCII 格式,则 target_file_pathabc_bin.f

示例 2

# cat_convert -a2b abc.f

abc.f 的内容将转换为二进制。

示例 3

# cat_convert -dump -short abc.f

abc.f 的内容将以用户可以阅读的格式显示在 stdout 中。

另请参见

请参见cat_export(1m)。

请参见cat_import(1m)。