About the NetBackup consistency check repair (NBCCR) utility
The NetBackup consistency check repair (NBCCR) utility is a command line tool that processes database-catalog repair actions. It automates the application of approved suggested repair actions. Cohesity technical support analyzes the data that the NBCC utility collects, and site-specific configuration information. This analysis results in the generation of a suggested repair actions (SRA) file. Before NBCCR is run, Cohesity technical support interacts with the customer to determine which repairs are needed. Undesirable repair actions are deleted or commented out of the SRA file. Each line of the SRA file contains one repair action that is paired with an associated parameter.
The NBCCR utility executes each repair action in several stages.
Table: Stages of repair
Stage | Name | Description |
|---|---|---|
Stage 1 | Data collection | NBCCR first collects the information that is required to perform a repair. |
Stage 2 | Repair qualification | Immediately before the suggested repair is applied, NBCCR verifies that the current status of the tape still qualifies for the requested repair. It recognizes that time has passed and the environment may have changed since the data was collected. If so, it reports in a history file that the repair is not qualified. |
Stage 3 | Repair | Finally, NBCCR performs up to three steps of repair for every repair entry in the SRA file. An element may be modified to enable the repair and steps may be necessary after the repair. If the repair fails during the repair operation, NBCCR tries to roll back the repair so that the corrective action does not introduce any new errors. |
NBCCR resides in the following location:
UNIX | /usr/openv/netbackup/bin/support/NBCCR |
Windows | install_path\NetBackup\bin\support\NBCCR.exe |
NBCCR accepts one input file, creates two output files, and uses one temporary file.
Input file | NBCCR accepts as input the Suggested Repair Action (SRA) file named On UNIX: On Windows: install_path |
Output files | NBCCR automatically creates a separate directory for each SRA file processed. The file name is based on the contents of the SRA file. The name of the directory is as follows: On UNIX: On Windows:
After repair processing is complete, NBCCR relocates the SRA file to the same directory. NBCCR also creates the following output files and places them in the same directory.
|
Temporary file | While it runs, the NBCCR utility uses To terminate NBCCR while it processes repairs, delete this file. This action causes NBCCR to complete the current repair, then shut down. Any other interruption causes undetermined results. |
The following sample NBCCR.output.txt files show the results of two MContents repairs. One where all images were found on tape and one where one or more images were not found on the tape:
Example 1: NBCCR found all images on the tape. The MContents repair action is successful.
MContents for ULT001 MediaServerExpireImagesNotOnTapeFlag ExpireImagesNotOnTape flag not set ULT001 MContents - All images in images catalog found on tape MContents ULT001 status: Success
Example 2: NBCCR did not find one or more images on the tape. The MContents repair action was not performed.
MContents for ULT000 MediaServerExpireImagesNotOnTapeFlag ExpireImagesNotOnTape flag not set Did NOT find Backup ID winmaster_123436 Copy 1 AssignTime 2011-02-11 01:19:13 (123436) on ULT000 Leaving winmaster_123436 Copy 1 on ULT000 in ImageDB ULT000 MContents - One or more images from images catalog NOT found on tape MContents ULT000 status: ActionFailed
A complete description of NBCCR is in the NetBackup Commands Reference Guide.