Veritas NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
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.conf
file.- -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.