Veritas NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
Name
nbcatsync — run a utility that resyncs the disk media IDs in the image catalog after catalog recovery operations complete
SYNOPSIS
-backupid catalog_backup_id [-prune_catalog] [-no_sync_slp] [-dryrun] [-keepgoing]
-sync_dr_file dr_file_path [-copy number] [-dryrun]
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
nbcatsync is a post-processing utility that is used in the catalog restore process.
After bprecover restores the actual catalog files, the nbcatsync utility can do the following:
Fix the disk media IDs in the fragment records.
Mark all recovered images as SS_COMPLETED.
Restore disabled functionality.
Prune images from the catalog which were not found on any currently configured disk volumes. The -prune_catalog option deletes catalog entries for the images that do not exist locally.
Constrain the operation to a set of images based on the catalog restore that was performed.
You can easily create a list of affected backup images for any given catalog restore option. The catalog backup image .f
file lists the images that the catalog restore recovers. This file lists the images to which you can constrain the operations of the nbcatsync utility.
The utility uses the current device configuration in EMM to obtain a list of disk volumes to scan for the image fragments that are found in the image list. After the EMM database, the images on currently configured storage, and the image catalog have all been reconciled, nbcatsync tries to turn on normal NetBackup processing.
Note:
Use the nbcatsync -dryrun option to validate the nbcatsync utility operation before the utility actually does it. Because nbcatsync actions are irreversible, you would have to perform bprecover -wizard again to get the previous contents of the image catalog.
OPTIONS
- -backupid catalog_backup_id
Specifies the catalog backup ID that contains a set of backup images. This option enables nbcatsync to fix disk media ID references in the image headers that are restored from this catalog backup image ID.
- -copy number
Specifies the copy of the catalog to be restored. This option allows catalog recovery from a non-primary copy.
- -dryrun
Gives the user a chance to validate actions nbcatsync normally perform. It lists all the modifications that can occur if the nbcatsync command does run.
- -keepgoing
Ignores bad disk volumes. Otherwise, nbcatsync aborts when it encounters an unexpected error while it searches for images on a disk volume.
- -no_sync_slp
Prevents the scrubbing of the storage lifecycle policy which removes the EMM image records and sets the SS_COMPLETED state in the image catalog to zero. Normally, nbcatsync disassociates images from any storage lifecycle policy processing that is performed at the primary site. Then nbcatsync can apply appropriate storage lifecycle policy settings for the DR site on the fixed images. However, when -no_sync_slp is specified, nbcatsync does not change these settings of fixed images, so use this option with care.
- -prune_catalog
Prunes all non-existent images. -prune_catalog removes copies of images on the disk volumes that are not found on any of the disk volumes at the DR site. If none of the copies of an image are located, the image itself is deleted.
- -sync_dr_file dr_file_path
Specifies the DR file at the DR site that corresponds to the catalog backup image to restore from.
EXAMPLES
Example 1 - Fix the disk media ID references in DR file test.txt
, so that bprecover can find the catalog backup image. At the DR site, run the following command:
# nbcatsync -sync_dr_file test.txt
Example 2 - Perform a dry run of fixing the disk media ID references in the image headers of image ID rg9pctrain05_1254127131 that is restored from the catalog backup. When you are satisfied with the results, you can repeat the command without the -dryrun option.
# nbcatsync -backupid rg9pctrain05_1254127131 -dryrun