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

名称

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

 

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\

描述

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