Catalog archiving commands

bpcatlist

The bpcatlist command queries the catalog data. Then, bpcatlist lists the portions of the catalog that are based on selected parameters. For example, date, client, policy, schedule name, backup ID, the age of the backup image, or the date range of the backup image. bpcatlist outputs the formatted image summary information of matched images to standard output.

The other catalog archiving commands, bpcatarc, bpcatrm, and bpcatres, all depend on input from bpcatlist by a piped command.

For example, to archive (backup and delete) all of the .f files that were created before January 1, 2012, the following would be entered:

bpcatlist -client all -before Jan 1 2012 | bpcatarc | bpcatrm

bpcatlist is also used to provide status information.

For each catalog, it lists the following information:

• Backup ID (Backupid)

• Backup date (Backup Date)

• Catalog archive ID (catarcid). After one .f file is successfully backed up, a catalog archive ID is entered into the catarcid field in the image file. This field is zero (0) if the image was never archived.

• Archived status (S). Indicates whether the catalog was archived (2) or was not archived (1).

• Catalog file name (Files file)

The following is an example of the bpcatlist output, showing all of the backups for client alpha since October 23:

# bpcatlist -client alpha -since Oct 23Backupid Backup Date ...Catarcid S C Files filealpha_097238 Oct 24 10:47:12 2012 ... 973187218 1 0 alpha_097238_UBAK.falpha_097233 Oct 23 22:32:56 2012 ... 973187218 1 0 alpha_097233_FULL.falpha_097232 Oct 23 19:53:17 2012 ... 973187218 1 0 alpha_097232_UBAK.f

More information is available in the NetBackup Commands Reference Guide.

bpcatarc

The bpcatarc command reads the output from bpcatlist and backs up the selected list of .f files. After one .f file is successfully backed up, a catalog archive ID is entered into the catarcid field in the image file. For archiving of the.f files to proceed, a policy by the name of catarc is required. The policy is based on a User Backup type schedule. The schedule for catarc must include in its window the time bpcatarc command is run.

See Creating a catalog archiving policy

bpcatrm

The bpcatrm command reads the output from bpcatlist or bpcatarc. If the image file has valid catarcid entries, bpcatrm deletes selected image.f files from the online catalog.

bpcatrm does not remove one .f file unless the file has been previously backed up using the catarc policy.

bpcatres

Use the bpcatres command to restore the catalog. The bpcatres command reads the output from bpcatlist and restores selected archived.f files to the catalog. For example:

bpcatlist -client all -before Jan 1 2012 | bpcatres