Ransomware attackers specifically target and attempt to destroy backup systems to increase the probability of payment. Hardening your system is critical. Please ensure you have reviewed your platform security using the Security Hardening Checklist
Cohesity

COHESITY Documentation

Explore our documentation to get started, discover products & new features, access troubleshooting guides, register sources, platforms support.

Products
Data Security Alliance
Visit Cohesity.com
Demos
Support
Blogs
Developers
Partner Portals
Cohesity Community
© 2026 Cohesity, Inc. All Rights Reserved.
Terms of Use|
Privacy Policy|
Legal|
  1. Home
  2. Veritas NetBackup™ Administrator's Guide, Volume I
  3. Section V. Configuring backups
  4. Protecting the NetBackup catalog
  5. Archiving the catalog and restoring from the catalog archive
  6. Catalog archiving commands
Veritas NetBackup™ Administrator's Guide, Volume I

Catalog archiving commands

The catalog archiving option relies on three commands to designate a list of catalog .f files, then archive the files. A fourth command, bpcatres, is used to restore the files if necessary.

Catalog archiving uses the following commands.

Table: Catalog archiving commands

Command

Description

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

  • Compressed status (C). Indicates whether the catalog was compressed (positive_value) or was not compressed (0).

  • 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 23
Backupid         Backup Date           ...Catarcid  S C Files file
alpha_097238 Oct 24 10:47:12 2012 ... 973187218 1 0 alpha_097238_UBAK.f
alpha_097233 Oct 23 22:32:56 2012 ... 973187218 1 0 alpha_097233_FULL.f
alpha_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.

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

More Information

Creating a catalog archiving policy

Feedback

Was this page helpful?
Previous

Creating a catalog archiving policy

Next

Catalog archiving considerations

Feedback

Was this page helpful?