Important Update: Cohesity Products Documentation
All Cohesity product documentation are now managed via the Cohesity Docs Portal: https://docs.cohesity.com/HomePage/Content/home.htm. Some documentation available here may not reflect the latest information or may no longer be accessible.
NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
- acsd
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpcleanrestore
- bpclient
- bpclimagelist
- bpclntcmd
- bpclusterutil
- bpcompatd
- bpconfig
- bpdbjobs
- bpdbm
- bpdgclone
- bpdown
- bpduplicate
- bperror
- bpexpdate
- bpfis
- bpflist
- bpgetconfig
- bpgetdebuglog
- bpimage
- bpimagelist
- bpimmedia
- bpimport
- bpinst
- bpkeyfile
- bpkeyutil
- bplabel
- bplist
- bpmedia
- bpmedialist
- bpminlicense
- bpnbat
- bpnbaz
- bppficorr
- bpplcatdrinfo
- bpplclients
- bppldelete
- bpplinclude
- bpplinfo
- bppllist
- bpplsched
- bpplschedrep
- bpplschedwin
- bppolicynew
- bpps
- bprd
- bprecover
- bprestore
- bpretlevel
- bpschedule
- bpschedulerep
- bpsetconfig
- bpstsinfo
- bpstuadd
- bpstudel
- bpstulist
- bpsturep
- bptestbpcd
- bptestnetconn
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configureCerts
- configureMQ
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig reinitialize
- csconfig throttle
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- mklogdir
- msdpcldutil
- msdpimgutil
- nbauditreport
- nbcallhomeproxyconfig
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcmdrun
- nbcomponentupdate
- nbcplogs
- nbcredkeyutil
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdb2adutl
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbepicfile
- nbfindfile
- nbfirescan
- nbfp
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhsmcmd
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nblogparser
- nbmariadb
- nbmysql
- nbmlb
- nborair
- nboracmd
- nbpem
- nbpemreq
- nbmariadb
- nbmlb
- nbperfchk
- nbpgsql
- nbplupgrade
- nbrb
- nbrbutil
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbserviceusercmd
- nbsetconfig
- nbshvault
- nbsmartdiag
- nbsnapimport
- nbsnapreplicate
- nbsqlcmd
- nbsqlite
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- netbackup_deployment_insights
- resilient_clients
- restoretrace
- stopltid
- tiermover
- tldd
- tldcd
- tpautoconf
- tpclean
- tpconfig
- tpext
- tpreq
- tpunmount
- verifytrace
- vltadm
- vltcontainers
- vlteject
- vltinject
- vltoffsitemedia
- vltopmenu
- vltrun
- vmadd
- vmchange
- vmcheckxxx
- vmd
- vmdelete
- vmoprcmd
- vmphyinv
- vmpool
- vmquery
- vmrule
- vmupdate
- vnetd
- vssat
- vwcp_manage
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
Name
bpcatlist — list selected parts of NetBackup catalog
SYNOPSIS
[-server server_name] [-client client_name] [-since [ctime | [-since-days nnn | -since-weeks nnn | -since-months nnn | -before-days nnn | -before-weeks nnn | -before-months nnn]] [-before [ctime | [-since-days nnn | -since-weeks nnn | -since-months nnn | -before-days nnn | -before-weeks nnn | -before-months nnn]] [-date ctime] [-policy policy_name] [-sched sched_name] [-id backup_id] [-catarc catarc_id] [-version] [-online | -offline]
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
bpcatlist is the starting point for all catalog archiving operations. Use bpcatlist to select the specific parts of the NetBackup catalog with which you want to work. All files-file (image .f files), the largest files in a NetBackup catalog, that are selected for bpcatarc, bpcatres, or bpcatrm, are first selected with bpcatlist. The output of bpcatlist is piped to the action you want to perform.
OPTIONS
- -server server_name
Indicates the name of the NetBackup server. Default: server_name is the first server name listed in the
bp.conffile.- -client client_name
Creates a list of backup images for client_name. Default: client_name is CLIENT_NAME in bp.conf or the current host name.
To select all clients, use -client all.
- -since [ctime | [-since-days nnn | -since-weeks nnn | -since-months nnn | -before-days nnn | -before-weeks nnn | -before-months nnn]]
Lists backup images since the specified time that is expressed in ctime (for example, Fri Oct 12 00:00:00 2012).
If no year is specified, bpcatlist uses the current year by default.
The following command lists all images after December 31, 2012:
bpcatlist -since 2012
Additional examples are found in the Examples section.
- -before [ctime | [-since-days nnn | -since-weeks nnn | -since-months nnn | -before-days nnn | -before-weeks nnn | -before-months nnn]]
Lists backup images before the specified time that is expressed in ctime (for example, Fri Oct 12 00:00:00 2012). If no year is specified, bpcatlist uses the current year by default.
- -date ctime
Lists of backup images for the specified date that is expressed in ctime (for example, Fri Oct 12 00:00:00 2012). If no date is specified, bpcatlist uses the current date by default.
Additional examples are found in the Examples section.
- -catarc catarc_id
Lists the files-file that were archived with the specified catarc_id. For example:
-catarc 1022754972
- -policy policy_name
Lists the backups that the indicated policy_name for the specified client creates.
- -sched sched_name
Lists the backups that are created following schedule_name for the specified client.
- -id backup_id
Creates a list for the specified backup_id.
- -online
Lists only files-file that are online.
- -offline
Lists only files-file that are offline.
- -version
Displays the bpcatlist version and exit.
EXAMPLES
Displayed dates must be specified in ctime (for example, Fri Mar 16 00:00:00 2012) date format. Displayed dates may be cut and specified without modification.
Example 1 - List a backup for a specific date and time.
# bpcatlist -date Mon Aug 19 14:16:28 2013
Example 2 - List all backups between the two specified dates of the current year. When no year is specified, the current year is used by default.
# bpcatlist -since Fri Jul 5 00:00:00 -before Mon Aug 2 00:00:00
Example 3 - List the backups that are two to three months old.
# bpcatlist -before-months 2 -since-months 3
-since and -before use the following equivalent values:
-since-days nnn -since-weeks nnn -since-months nnn -before-days nnn -before-weeks nnn -before-months nnn
For example, the setting -since-days 14 is equivalent to -since-weeks 2.