NetBackup™ Commands Reference Guide

Last Published:
Product(s): NetBackup & Alta Data Protection (10.1)
  1. Introduction
    1.  
      About NetBackup commands
    2.  
      Navigating multiple menu levels
    3.  
      NetBackup command conventions
    4.  
      NetBackup Media Manager command notes
    5.  
      IPV6 updates
  2. Appendix A. NetBackup Commands
    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.  
      msdpcldutil
    102.  
      nbauditreport
    103.  
      nbcallhomeproxyconfig
    104.  
      nbcatsync
    105.  
      NBCC
    106.  
      NBCCR
    107.  
      nbcertcmd
    108.  
      nbcertupdater
    109.  
      nbcldutil
    110.  
      nbcloudrestore
    111.  
      nbcomponentupdate
    112.  
      nbcplogs
    113.  
      nbcredkeyutil
    114.  
      nbdb_admin
    115.  
      nbdb_backup
    116.  
      nbdb_move
    117.  
      nbdb_ping
    118.  
      nbdb_restore
    119.  
      nbdb_unload
    120.  
      nbdb2adutl
    121.  
      nbdbms_start_server
    122.  
      nbdbms_start_stop
    123.  
      nbdc
    124.  
      nbdecommission
    125.  
      nbdelete
    126.  
      nbdeployutil
    127.  
      nbdevconfig
    128.  
      nbdevquery
    129.  
      nbdiscover
    130.  
      nbdna
    131.  
      nbemm
    132.  
      nbemmcmd
    133.  
      nbfindfile
    134.  
      nbfirescan
    135.  
      nbfp
    136.  
      nbftadm
    137.  
      nbftconfig
    138.  
      nbgetconfig
    139.  
      nbhba
    140.  
      nbholdutil
    141.  
      nbhostidentity
    142.  
      nbhostmgmt
    143.  
      nbhypervtool
    144.  
      nbidpcmd
    145.  
      nbimageshare
    146.  
      nbinstallcmd
    147.  
      nbjm
    148.  
      nbkmiputil
    149.  
      nbkmscmd
    150.  
      nbkmsutil
    151.  
      nboraadm
    152.  
      nborair
    153.  
      nbpem
    154.  
      nbpemreq
    155.  
      nbmlb
    156.  
      nbperfchk
    157.  
      nbplupgrade
    158.  
      nbrb
    159.  
      nbrbutil
    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.  
    Index

Name

nbfindfile — search files or folders based on simple search criteria

SYNOPSIS

nbfindfile -c client_name[,...] -p search_pattern [-s mm/dd/yyyy [hh:mm:ss] | -s_ut unix_time] [-e mm/dd/yyyy [hh:mm:ss] | -e_ut unix_time] [-backupid backup_id] [-policy policy_name] [-keyword "keyword_phrase"] [-extn file_extn[,...]] [-st sched_type] [-pt policy_type] [-kb_min min_size_kb] [-kb_max max_size_kb] [-mtime_min mm/dd/yyyy [hh:mm:ss]] [-mtime_max mm/dd/yyyy [hh:mm:ss]] [-atime_min mm/dd/yyyy [hh:mm:ss]] [-atime_max mm/dd/yyyy [hh:mm:ss]] [-ctime_min mm/dd/yyyy [hh:mm:ss]] [-ctime_max mm/dd/yyyy [hh:mm:ss]] [-only_dirs | -only_files] [-max_results number] [-case_sen] [-l [-ctime | -atime] | -raw] [-help | -h]

 

On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/

On Windows systems, the directory path to this command is install_path\NetBackup\bin\admincmd\

DESCRIPTION

The nbfindfile command lets you search files or folders based on simple search criteria like file name and path including wildcard and backup date range. Users can specify a set of clients, possibly belonging to different master servers, for which backups are to be searched. You can specify advanced search criteria including policy type, schedule type, policy name, policy associated keywords, file extensions, file modification date range, and file size.

OPTIONS

-atime

Displays the last access time of objects in place of the last modification time. Requires the -l option.

-atime_max mm/dd/yyyy [hh:mm:ss]

Specifies the maximum last access time of objects to be returned. The default is infinite.

-atime_min mm/dd/yyyy [hh:mm:ss]

Specifies the minimum last access time of objects to be returned. The default is 01/01/1970 00:00:00.

-backupid backup_id

The backup ID of the backup image that should be searched.

-c client_name[,...]

Specifies the names of the NetBackup clients whose backups need to be searched. The client names must be specified as they appear in the NetBackup configuration. Multiple clients can be specified as a list that is separated by commas.

-case_sen

Performs case sensitive matching.

-ctime

Displays the last change time of objects in place of the last modification time. Requires the -l option.

-ctime_max mm/dd/yyyy [hh:mm:ss]

Specifies the maximum last change time of objects to be returned. The default is infinite.

-ctime_min mm/dd/yyyy [hh:mm:ss]

Specifies the minimum last change time of objects to be returned. The default is 01/01/1970 00:00:00.

-e mm/dd/yyyy [hh:mm:ss] | -e_ut unix_time

Specifies the end date for the search. Backups that occurred at or before the specified date and time are searched. The default is the current date and time.

-extn file_extn[,...]

Returns only the files with the specified extensions. For example, -extn txt,do*,jp?.

-h | -help

Displays usage information.

-kb_max max_size_kb

Specifies the maximum size in kilobytes (1024 bytes) of files to be returned. The default is infinite.

-kb_min min_size_kb

Specifies the minimum size in kilobytes (1024 bytes) of files to be returned. The default is 0 (zero).

-keyword "keyword_phrase"

Searches only the backup images that contain a matching keyword phrase are searched. The keyword phrase can contain wildcards (*, ?) and square bracket expressions. Examples are [Kk]ey*, [a-z]e?, and [!K]ey.

-l

Displays output in long list format. The last modification time of objects is shown by default.

-max_results number

Specifies the maximum number of results to be displayed. The default is infinite.

-mtime_max mm/dd/yyyy [hh:mm:ss]

Specifies the maximum last modification time of objects to be returned. The default is infinite.

-mtime_min mm/dd/yyyy [hh:mm:ss]

Specifies the minimum last modification time of objects to be returned. The default is 01/01/1970 00:00:00.

-only_dirs | -only_files

Specifies the type of objects to be returned.

-p search_pattern

Specifies the search pattern. File and directory entries matching this pattern are displayed.

-policy policy_name

Searches only the backup images that are created using the specified policy.

-pt policy_type

Searches only the backups with the specified policy type. Valid values for policy_type: Any, Standard, FlashBackup, MS-Windows, NDMP, FlashBackup-Windows.

-r

Displays raw output.

-s mm/dd/yyyy [hh:mm:ss] | -s_ut unix_time

Specifies the start date for the search. Backups that occurred at or after the specified date and time are searched. The default is 30 days before the end date.

-st sched_type

Specifies a schedule type for the image selection. The default is any schedule type. Valid values, in either uppercase or lowercase, are as follows:

  • ANY

  • FULL (full backup)

  • INCR (differential-incremental backup)

  • CINC (cumulative-incremental backup)

  • UBAK (user backup)

  • UARC (user archive)

  • SCHED

  • USER (user backup and user archive)

  • NOT_ARCHIVE (all backups except user archive)