nbcatsync

nbcatsync — run a utility that resyncs the disk media IDs in the image catalog after catalog recovery operations complete

SYNOPSIS

<nbu_dir_path>nbcatsync -backupid catalog_backup_id [-prune_catalog] [-no_sync_slp] [-dryrun] [-keepgoing]

<nbu_dir_path>nbcatsync -sync_dr_file dr_file_path [-copy number] [-dryrun]

On Windows systems, <nbu_dir_path> is <install_path>NetBackup\bin\

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 following: 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 what the nbcatsync utility can do before it does it. Since nbcatsync actions are not reversible, 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 any unexpected errors while it looks 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 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_filedr_file_path

Specifies the DR file at the DR site that corresponds to the catalog backup image to restore from. Do not put a space between the -sync_dr_file option and the dr_file_path variable.

EXAMPLES

EXAMPLE 1

In this example, nbcatsync fixes 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

This example performs a dry run of fixing the disk media ID references in the image headers of image ID 00010 restored from the catalog backup. When you are satisfied with the results, you can repeat the command without the -dryrun option.

# nbcatsync -backupid 00010 -dryrun