Knowledge Base

The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides

Search the VMware Knowledge Base (KB)

View by Article ID

VMware Data Recovery: Enabling verbose logging and datarecovery.ini options

Purpose

This article provides:

Steps to create the VMware Data Recovery (VDR) datarecovery.ini configuration file.
Information about datarecovery.ini configuration options.
Details on setting verbose logging on the VDR Appliance.

Resolution

To create the datarecovery.ini file:

Log in to the datarecovery appliance with the credentials:

Username: root
Password: vmw@re
Run this command to stop the datarecovery service:

service datarecovery stop
Create the file /var/vmware/datarecovery/datarecovery.ini.
Add [Options] to the first line in the file. You must include this header tag.
Populate the file with the appropriate options after the [Options] tag.

Example:

[Options] SetVCBLogging=6 SetVolumesLogging=6 SetRAPILogging=6 DisableHotaddCopy=1
Run this command to start the datarecovery service:

service datarecovery start

This table lists the datarecovery.ini file options:

Note: For a complete list of options, see datarecovery.ini Reference in the vSphere 5 Documentation Center.

Option	Description	Syntax	Default Value	Value Range
MaxLogFiles	Sets the maximum number of log files before log rotation occurs	`MaxLogFiles=20`	10
DisableHotaddCopy	Disables SCSI Hot-Add or forces the use of Network copy	`DisableHotaddCopy=1`	0	0 - 1
DisableNetworkCopy	Disables Network copy as an option	`DisableNetworkCopy=1`	0	0 - 1
SetVCBLogging	Sets the internal logging level for vcbAPI	`SetVCBLogging=6`	3	0 - 7
SetRAPILogging	Sets the internal logging level for VDR API	`SetRAPILogging=6`	3	0 - 7
SetEngineLogging	Sets the internal logging level for VDR engine	`SetEngineLogging=6`	3	0 - 7
SetDevicesLogging	Sets the internal logging level for interactions with dedupe store	`SetDevicesLogging=6`	3	0 - 7
SetAppLogging	Sets the internal logging level for basic application logic	`SetAppLogging=6`	3	0 - 7
SetVolumesLogging	Sets the internal logging level for interactions with virtual machines and volumes	`SetVolumesLogging=6`	3	0 - 7
SetBackupSetsLogging	Sets the internal logging level for catalog operations	`SetBackupSetsLogging=6`	3	0 - 7
IntegrityCheckInterval	Sets the number of days before doing an integrity check. For more information, see the Integrity check section of the VMware Data Recovery Administration Guide.	`IntegrityCheckInterval=7`	1	1 - 7
BackupRetryInterval	Sets the time in minutes to retry a source	`BackupRetryInterval=20`	30	1 +
RetentionPolicyInterval	Sets the number of days before doing an reclaim on the dedupe store	`RetentionPolicyInterval=7`	1	1 - 7
DedupeCheckOnRecatalog	Indicates if an integrity check should be run after a recatalog	`DedupeCheckOnRecatalog=1`	0	0 - 1
EnableFileRestore	Enables file level restores	`EnableFileRestore=1`	1	0 - 1
MaxBackupRestoreTasks	Sets the maximum number of simultaneous backup and restore tasks	`MaxBackupRestoreTasks=1`	8	1 - 8
BackupUnusedData	Enables backup of swap partitions in Linux virtual machines and Pagefile.sys in Windows virtual machines. Enabling this attribute causes swap data to be backed up as it was in Data Recovery 1.2 and earlier.	BackupUnusedData=1	0	0-1

Notes:

The default logging level is 3. In most cases, logging level of 6 is enough to diagnose an issue.
Any option that is not listed in the file uses the default value.

Additional Information

For more information, see the Understanding the datarecovery.ini File section of the VMware Data Recovery Administration Guide.

Update History

08/02/2010 - Added link to VMware Data Recovery Administration Guide

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.

Feedback

1 2 3 4 5

1 2 3 4 5

Actions

Bookmark Document

KB: