vSphere Data Protection 6.1.2 Release Notes

vSphere Data Protection 6.1.2 Release Notes | 15 March, 2016

These release notes include the following topics:

Benefits and Features

Read about the benefits and features of this product at the following links:

vSphere Data Protection 6.1.2 supports in-place upgrade, that is, upgrade from 6.1 and 6.1.1 to 6.1.2.

Note: In-place upgrade is supported from vSphere Data Protection 6.1 onwards.

Supported Environments

For information on supported environments, see the VMware Interoperability Matrix.

Known Problems and Limitations

The following are the known problems and limitations in this release of vSphere Data Protection.

VMware Issues

  • Support for routed / NAT / Firewall / IDS / TSNR between the vSphere Data Protection appliance and vCenter Server (1292848)

    When configuring the network for the vSphere Data Protection appliance and vCenter Server, modifying network address information using NAT or other configuration methods (for example: firewall, IDS, or TSNR) is not supported. When those tools are deployed as part of the virtual network, some vSphere Data Protection functionality may not work as designed.

  • Powering On a virtual machine fails when the backed up virtual machine was connected to DVS and restored to other ESX (222475)

    When powering on a virtual machine after you restore it, vCenter Server returns a PowerOnFailure error similar to the following:

    DRS cannot find a host to power on or migrate the virtual machine. Network interface 'Network adapter 1' uses network '77 d3 02 50 5f 76 ca d7-db f9 42 6c 0f 6f 87 1f', which is not accessible

    This error message occurs when the environment where you restore the virtual machine does not have the network connection that was present when you backed up the virtual machine. For instance, a user backs up a virtual machine that is connected to a distributed vSwitch. Then the user restores the virtual machine to an ESX host that is part of a Distributed Resource Scheduler (DRS) cluster. The vSwitch does not exist in the DRS cluster. Powering on the virtual machine, therefore, fails.

    Workaround

     Edit the virtual machine settings, set the network connection to the network adaptor, and then power on the virtual machine.

  • The VM MAC conflict alarm appears after you restore a virtual machine to an alternate location (1588177)

    After you successfully restore a virtual machine that either vCenter Server 6.0 P2 or vCenter Server 6.0 U2 manages, to an alternate location, the VM MAC conflict alarm appears on vCenter Server though the MAC address has changed during the restore.

    Workaround

    Acknowledge the alarm and clear it.

Interoperability Issues

  • In a Virtual SAN environment, the image-level restore to original location operation is allowed, but the disk-level restore to original location operation is grayed out, after migrating the entire virtual machine to another datastore (58839)

    Workaround

    Either restore the entire virtual machine with an image-level backup or restore the disk level backup as a new disk on the original virtual machine.

Upgrade Issues

  • ISO detection fails during upgrade from vSphere Data Protection 6.1 to 6.1.1 (244505)

    Workaround

    Before you upgrade the vSphere Data Protection appliance, perform the following steps:

    1. From the vSphere Data Protection 6.1.1 installation package on the vSphere Data Protection appliance that you want to upgrade, copy the VDP61_Iso_Hotfix.tar.gz file to any directory, for example, /root on the same vSphere Data Protection appliance.
    2. Extract the VDP61_Iso_Hotfix.tar.gz file by running the following command:

      tar -zxvf VDP61_Iso_Hotfix.tar.gz

    3. Go to the VDP61_Iso_Hotfix directory.
    4. Add the execute permissions to the VDP61_Iso_Hotfix.sh file by running the following command:

      chmod a+x VDP61_Iso_Hotfix.sh

    5. Run the VDP61_Iso_Hotfix.sh file:

      ./VDP61_Iso_Hotfix.sh

    The hotfix checks whether it is running on vSphere Data Protection 6.1. If the hotfix cannot detect vSphere Data Protection 6.1, it exits without applying any changes.

    The hotfix backs up the vdr-configure.war file of vSphere Data Protection 6.1 to the /VDP_Files directory. You require the vdr-configure.war file if you want to revert vSphere Data Protection to the state, in which it was before running the hotfix.

VMDK Issues

  • Incorrect behavior of the vSphere Data Protection appliance when more disks are added to the same SCSI slots (59774)

    The vSphere Data Protection appliance initiates a restore operation with the same SCSI IDs on the same existing virtual machine assigned to two different restore points. In addition, the Summary page incorrectly indicates that two new virtual disks will be added. The Restore operation completes successfully without informing the user that only the first single disk was added, and the second disk simply replaced the first disk.

vSphere Data Protection Issues

  • A password change on a configured vCenter Server instance is not allowed on the vSphere Data Protection appliance, even after the vCenter Server password has expired (59497)

    The vSphere Data Protection-Configure application does not allow a password change for the configured vCenter Server instance if backups are in a Running state on the server. If the user password on the configured vCenter Server instance has already expired, no tasks are posted on the task console, and, consequently, the tasks cannot be canceled.

    Workaround

    Perform the following steps:

    1. Wait until all the backups and tasks finish in the vSphere Data Protection appliance and then change the password.
    2. Restart the vSphere Data Protection appliance in the maintenance window, and then log into the vSphere Data Protection-Configure user interface and change the vCenter Server password from the vSphere Data Protection-Configure user interface.

  • The Performance Assessment Test (PAT) result changes to Never Run when the datastore name is changed (59784)

    In this scenario, the user opens the vSphere Data Protection-Configure user interface, clicks the Storage tab, selects a datastore, and clicks the Run performance analysis on storage configuration checkbox. The performance analysis test completes successfully and the results of the performance analysis are displayed correctly. If the user changes the name of the datastore, however, the performance analysis results erroneously indicate the status as Never Run.

  • The vSphere Data Protection GUI displays an error message in the Firefox browser when you edit a Data Domain device (231126)

    If you edit a Data Domain device by using the vSphere Data Protection GUI or the vSphere Data Protection configuration utility in the Firefox browser, an error message, which states that editing the Data Domain device has failed, appears even though the configuration is correct.

    Workaround

    Use either the Chrome browser or the Internet Explorer browser.

  • The Configuration tab page displays the services are not running messages after either restarting vSphere Data Protection or initial configuration (235086)

    After either restarting vSphere Data Protection or initial configuration, the Configuration tab page of the vSphere Data Protection configuration utility displays the following messages, and the proxies’ status in red.

    • Backup and recovery services are not running.
    • File Level Restore service is not running.

    The messages disappear after 20 minutes.

    Workaround

    To make the messages immediately disappear, click the refresh button beside Proxies.

  • The status of the Data Domain devices on the Storage tab page appears wrong after either changing the vSphere Data Protection password or restarting the management service (237934)

    After either changing the vSphere Data Protection password or restarting the management service, the following message appears on the Storage tab page for the Data Domain devices:

    Data Domain storage status not available. Unable to retrieve ssh key file pair.

    However, after approximately 20 minutes, the Data Domain devices appear online.

  • The vCenter Server certificate does not appear in the vCenter Registration window though the certificate is uploaded during the initial configuration of vCenter Server (238242)

    Though the vCenter Server certificate is uploaded during the initial configuration of vCenter Server, the certificate does not appear in the vCenter Registration window of the vSphere Data Protection configuration utility. Also, the user selection does not persist.

    You must upload the vCenter Server certificate whenever you register vCenter Server.

  • If a vCenter Server instance has vSphere Data Protection appliances of multiple versions, the UI of any vSphere Data Protection version displays the features of the latest version (235357)

Backup Issues

  • Loading clients takes a significant amount of time when editing or cloning a backup job (50334)

    The edit or clone action of a backup job for a SharePoint server (upgraded plug-in) takes 5 to 10 minutes to load clients. In addition, some delay occurs when loading clients for Microsoft Exchange and SQL servers that were created before an upgrade.

    This is a known issue that will be fixed in a future release.

Migration Issues

  • A backup verification job does not migrate the verification script parameters (238608)

    After migrating a backup verification job that contains the verification script parameters to an Avamar server, clicking More Options… on the Avamar Administrator > Policy Management > Edit virtual machine Backup Validation Group > Overview page does not display the verification script parameters of the migrated job.

  • After migrating to vSphere Data Protection 6.1, you cannot restore the application data to the original location by clicking Reset (240401)
  • The backup jobs that do not have active clients do not migrate to vSphere Data Protection 6.1.1 (244970)

    Migrating a backup job that has all MC_Retired clients (virtual machines) from vSphere Data Protection 6.1 or earlier to 6.1.1 fails because the clients are not active, that is, they are retired (deleted).

Restore Issues

  • If a virtual machine is deleted during a vSphere Data Protection restore operation, the virtual machine is not properly removed from the vSphere Data Protection inventory. This causes an error when editing the backup jobs that included the deleted virtual machine as source. Additionally, if a virtual machine is created with the same name, attempts to add the virtual machine to a backup job will fail. (35110)

    Workaround

    As a best practice, avoid deleting virtual machines during restore operations. If this error does occur, create the virtual machine with a new name and add it to a new backup job.

  • File Level Restore (FLR): "Error 10007: Miscellaneous error" is displayed for most of the FLR failures (45699)

    The "Error 10007: Miscellaneous error" message is displayed for most of the FLR failures. In addition, FLR does not display any error message in cases where there is a restore failure due to the disk being full or a long file path. Therefore, it is impossible to determine the root cause of the FLR failure.

  • Deleted disks are skipped when restoring to original location (53004)

    If the target virtual machine no longer has the same disk footprint as the original virtual machine that was backed up (if the disks have been removed or deleted from the virtual machine), performing a "Restore to original location" operation, after selecting a restore point timestamp in the Restore pane, will silently fail to restore the missing disk of the virtual machine.

    Workaround

    Restore the disk to its original location after manually adding the missing disk to the virtual machine. Ensure the disk is the same size as it was when the virtual machine was backed up. If this workaround fails, restore the disk to a new location to create a new virtual machine. When the restore task completes, detach the restored disks from the new virtual machine and attach them to the required virtual machine using the information in "Detaching and Reattaching Storage" of the vSphere Data Protection Administration Guide.

  • Canceling a restore operation does not delete the restored data on a virtual machine (237125)

    While performing a restore to a different virtual machine that is not the source virtual machine, if you cancel the operation, the cancelation succeeds, but the already restored data that is part of the canceled restore is not deleted from the virtual machine.

  • Restoring to the same source location on a virtual machine by selecting the Restore along with configuration option fails (237015)

    If the source virtual disks are removed on a virtual machine, and you restore the same virtual disks to the same source location on the virtual machine by selecting the Restore along with configuration option, the operation fails.

    Workaround

    Perform the restore to an alternate location.

Replication Issues

  • Replication of replicated clients under a particular tenant on the target server fails (194669)

    The replication of replicated clients from a source to a target server under a particular tenant account fails with the following error message:

    Specified account ( ) does not fall within the current authorization domain.

    In addition, the failure occurs with the following source/target combinations:

    • Source server: vSphere Data Protection Advanced and Target Server: vSphere Data Protection Advanced/Replication Target Identity (RTI)
    • Source server: RTI and Target Server: RTI/vSphere Data Protection Advanced

  • Replication Recovery: Replication logs are filling up the root partition - need to create a symlink to another partition (195196)

    The replication logs are currently going to the /space partition and not to the root partition.

    Workaround

    Manage the replication logs in the /usr/local/Avamar/var/client directory (the space partition).

Operating System Issues

Microsoft Application Issues

  • On Microsoft Exchange clients, there are many warning messages in the avagent log that print frequently and fill up the logs (56723)

    The Microsoft Exchange client is left registered with two vSphere Data Protection Advanced appliances on vCenter Server, which is causing this issue.

  • You cannot back up the SharePoint Server databases if the database names contain unicode characters (192449)
  • You cannot perform GLR on an Exchange client if you install the GLR plug-in by using the repair option of the Exchange client installer (238439)

    You cannot perform GLR on an Exchange client if the GLR plug-in is not installed. Even if you install the GLR plug-in by using the repair option of the Exchange client installer, you cannot perform GLR.

    Workaround

    1. Uninstall the Exchange client.
    2. Run the Exchange client installer.
    3. On the Feature selection page, select the GLR feature.
    4. Complete the installation.

  • SharePoint virtual directories are not restored (248324)

    Performing a full backup of a web application does not back up the SharePoint virtual directories. So, if you delete the source web application and the SharePoint virtual directories, and restore the backed up web application, the SharePoint virtual directories are not restored. You cannot open the sites that are under the web application.

    Workaround

    1. Back up the full image of virtual machine.
    2. To restore the required virtual directories, perform a File Level Restore of the backed up virtual machine image.
  • On a Client Access Server (CAS) host that does not have a Mailbox (MBX) server role, EMC Avamar Exchange Backup User Configuration tool crashes while starting the VMwareVDPBackupuser services for an existing account (249184)

    Workaround

    Manually start the services.

  • GLR to Exchange Server 2013 that has only the MBX role sometimes fails (249522)

    Before you perform GLR, ensure that you meet the following prerequisites:

    • You have started the Backup Agent service by using the domain\VMwareVDPBackupUser account.
    • You have removed the LAN setting proxy.
    • You have restarted the mailbox servers, for which the restart is pending.
    • You have not mounted any RDB in the environment, and deleted the stale entries of RDBs.
    • You have successfully created the MFCMAPI (32-bit) profile.

    Despite meeting these prerequisites, sometimes GLR fails and displays the following similar error message:

    2016-01-14 17:24:01 avmapi Error <0000>: Error 0x80040111 opening message store

    2016-01-14 17:24:01 avmapi Error <13547>: Error MAPI_E_LOGON_FAILED. (code: 0X80040111), avmapi_misc::open_mapi_session avmapi_misc.cpp:1363

    2016-01-14 17:24:01 avmapi Info <0000>: Logon failed for CAS: E13MBX3.MsApp-ExchBlrQa.com.

    In this case, perform the following workaround:

    Workaround

    1. Install the latest MAPI CDO kit from Microsoft website.
    2. Enable the VMwareVDPBackupUser account.

      To ensure that the account is enabled, log in to the VMwareVDPBackupUser account's mailbox and send a few emails.

    3. If the VMwareVDPBackupUser account is not enabled, run the following command:

      Get-ExchangeServer | Add-ADPermission -User VMwareVDPBackupUser@domain.com -ExtendedRights Receive-As,Send-As

    4. If the Exchange Server uses the SSL certificate authentication, create the avmapi.cmd file in the ..\avp\var directory on the Exchange Server.
    5. Set the following flags in the avmapi.cmd file:
      • --av_pr_profile_rpc_proxy_server_flags=19
      • --debug

    Despite performing this workaround, if GLR fails, perform GLR on the Exchange Server that has both the CAS role and the MBX role.

Automatic Backup Verification (ABV) Issues

  • ABV: Verification job fails after renaming the datastore (55790)

    This error can occur if you rename or move the destination datastore outside of vSphere Data Protection.

    Workaround

    Edit the verification job and select the renamed or moved destination datastore as the new destination. For instructions, refer to "Editing a Backup Verification Job" in the vSphere Data Protection Administration Guide.

  • Improper error messages are reported if the Verification job failed because of connection issues due to Data Domain (56619)

    The backup cannot be restored and the Verification job fails because the vSphere Data Protection appliance cannot talk to the Data Domain. It is expected for the Verification job to fail; however, the proper error message does not display and the user does not know the root of the failure.

  • ABV does not start if the last backup completed with an exception (206091)

Fixed Problems

The following table lists the problems that have been fixed in this release of vSphere Data Protection:

Defect Number Description

244248

Migration to vSphere Data Protection 6.1 fails with authentication failed

248700 vSphere Data Protection performance degraded due to more frequent replications queries
246842 Create vSphere Data Protection 6.1.2 version (OS Rollup – Openssh and Openssl)
246849 The vSphere Data Protection email report shows wrong status about the DDVE Boost license
233385 An ABV job details report never appear under the completion column in the vSphere Data Protection plug-in though the ABV job succeeded
247377 Disk expansion fails if number of VMDKs does not match mapping
247297 Av_boot error - unknown flag name tomcat version expected
248596 vSphere Data Protection server is making many unnecessary DNS Lookups to Data Domain system
248683 Fall back to non-quiescent snapshot functionality is inverted
237352 The size of a user mailbox does not appear during GLR restore
247481 Minimum disk space requirement for upgrades must be corrected
252554 The vSphere Data Protection link on the web client does not list the vSphere Data Protection appliances that are deployed on a particular vCenter Server
252275 vSphere Data Protection exposed to CVE-2015-7547 vulnerability