Repairing corrupt UDR files


Use the UDR Viewer command-line utility to display information about UDR data files, test the files for corruption, and repair the corrupted files. The command syntax and basic commands are as follows:

udrviewer -r udrRoot | -u udrFile [nmtsqd] [i b-e]
   -r udrRoot  - UDR root directory
   -u udrFile  - name of UDR file
   -n  display node info for each node in the repository
   -m  display metrics for all spills
   -s  summarize all spills
   -i  intervals to view and optionally summarize
   -t  test file for corruption
   -T  test file for corruption and repair if corrupt
   -q  display queue headers
   -p  pause for user input at the end of execution
   -d  disable validity checks
Information

You can also use the Agent to automatically repair corrupted UDR files during the Agent startup process. For more information, see Automatically repairing files with Agent.

Manually repairing files with UDR Viewer

If the Agent cannot repair the corrupted UDR files, you can use the -T option to manually test and repair them. If a file is corrupted and the repair process is successful, the repaired file becomes the original UDR file (with the .udr extension) and the corrupted file is backed up (with the .bak extension appended to the file name).

Warning

Important

You might see unexpected results when the data that you are attempting to repair is not from the same platform on which you are running the utility.

The following table describes the commands to use for repairing corrupted files:

Task

Command to use

To test and repair an individual UDR file

UDRviewer -u udrFileName -T

To test and repair all files in the repository

UDRviewer -r udrRepository -T

To view online Help for UDR Viewer

UDRviewer -h

Automatically repairing files by using the Agent

You can use the Agent to automatically repair, backup, log, and notify users about corrupted UDR files by enabling parameters in the Agent.cfg configuration file. The Agent can repair corrupted UDR files either in history or as part of a collection request during the Agent startup process. 

Warning

Important

The Agent tests the UDR files in history provided that the files already exist and are a part of the current history configuration.

Parameters related to corrupted UDR files

The following table describes the key parameters in the Agent configuration file that define how the Agent responds to corrupted UDR files during the history and collection requests.


Enabling and disabling the backup and repair options

By default, the backup and repair options are disabled. The following table describes the behavior when these options are enabled and disabled.

For more information about the Agent.cfg file and corrupted UDR file parameters, see Configuring the Continuous Optimization Agent.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Helix Continuous Optimization 22.1