Verify Archiver Tool

The Verify Archiver tool validates the stubs on the source disk against the data stored in the secondary storage, and reports the discrepancies for appropriate action. For example, if there are stubs on the source disk with no corresponding data in the secondary storage, such stubs are considered as dangling stubs and might need further investigation.

Before You Begin

Configure an exclusion for the cvverifyarchive.exe key to avoid the Verify Archiver tool causing recalls of DMNAS stubs.

1. Start the Registry Editor on the computer where the file archiver agent is installed.

2. Navigate to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\cvmhsm\Parameters\.

3. Right-click Parameters, point at New and click String Value.

4. In the Value Name box, type ExcludeProcessX.

   Where X is the next consecutive number in the list (i.e. ExcludeProcess1, ExcludeProcess2, etc.)) for any process that should not initiate recalls.

   All ExcludeProcess names must be truncated to a maximum 15 character string value or the Windows OS Kernel Mode will not process the exclusion properly. This would result in the exclusion being ignored, unexpected recalls occurring and other unexplained stub activities.

   For example:

   Processnamelong (Truncated from Processnamelongerthen15characters.exe to meet 15 character limit)

5. Add the following process to be excluded at Commvault's driver for file recalls:

   • cvverifyarchive.exe

6. Restart the Commvault services for the registry to take effect.

Procedure

• From the command prompt go to the software_installation_directory/Base folder, and run the following command by using one or more of the following parameters:

  Parameters	Mandatory	Description
  -clientName	Yes	Client computer name for verifying stubs for all content under the client
  -instanceName	Yes	Instance name
  -appID or -backupsetName and -subclientName	Yes	The unique subclient ID, or the backup set name and the subclient name
  -outCSVPath	No	Output directory where files must be stored
  -path	No	Path to the stubs for verifying. If no path is provided, all valid paths under the subclient content are verified.
  -help	No	Shows the help message and exits

Syntax

 
cvVerifyArchive.exe -intanceName InstanceName -clientName ClientName -outCSVPath OutputDirectoryForFileStorage -subclientName SubclientName -backupsetName BackupsetName -path PathForStubsToBeVerified
    

Note: The parameters used in this tool are case-sensitive.

Example

cvVerifyArchive.exe -instanceName "Instance001" -clientName "abc.xyz.com" -outCSVPath "C:\Temp\" -subclientName "subclient001" -backupsetName "backupset001" -path "C:\SubclientContent\OptionalSubFolderToSearch"
    

Results

The tool lists the dangling stubs on the client computer.

Related Topic

You can use workflows to verify archived files. For more information, see Verifying Archived Files Using Workflows.