Search the VMware Knowledge Base (KB)
View by Article ID

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

  • 37 Ratings

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:

  1. Log in to the datarecovery appliance with the credentials:

    Username: root
    Password: vmw@re

  2. Run this command to stop the datarecovery service:

    service datarecovery stop

  3. Create and/or edit the file /var/vmware/datarecovery/datarecovery.ini using the editor VI, run the command:

    # vi /var/vmware/datarecovery/datarecovery.ini

  4. Add [Options] to the first line in the file. You must include this header tag.
  5. Populate the file with the appropriate options after the [Options] tag.

    For example:

    [Options]
    SetVCBLogging=6
    SetVolumesLogging=6
    SetRAPILogging=6
    DisableHotaddCopy=1

  6. Save the file and write changes, in the VI editor:

    1. Press escape to exit edit mode
    2. Type :wq! and hit return

  7. 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 between reclaim operations RetentionPolicyInterval=7 2 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.
 

Tags

enable-logging

See Also

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

  • 37 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.

What can we do to improve this information? (4000 or fewer characters)




Please enter the Captcha code before clicking Submit.
  • 37 Ratings
Actions
KB: