IBM Support

Known Issues and Limitations: Version 6.4 Tivoli Storage Manager for Virtual Environments

Preventive Service Planning


Abstract

This document details the Known Issues & Limitations for IBM Tivoli Manager for Virtual Environments V6.4.

Content

Data Protection for VMware vCenter plug-in Issues and Limitations

  • Different times display in Backup tab and Restore tab
    When viewing the time stamp for the same task, the time displayed in the "Last Ran" column in the Backup tab is different from the time displayed in the "Restore Point" column in the Restore tab.

    This situation occurs when the system where the Data Protection for VMware vCenter plug-in is installed and the Tivoli Storage Manager server have different time zone settings.

    Workaround: Synchronize the time zone settings. (86211)

  • Backup operation on Linux and Windows continues although error message displays
    When the VMCLI service stops during a backup operation, the backup operation displays an error in the Data Protection for VMware vCenter plug-in; however, the backup operation continues on the Tivoli Storage Manager server until complete.

    When the current backup operation continues on the Tivoli Storage Manager server, and you restart the VMCLI service, the following message displays in the Data Protection for VMware vCenter plug-in:
      ERROR ANS5176W(RC4383) The requested virtual machine operation cannot be performed because a virtual machine backup or restore operation is already in progress. Please retry the operation after the first operation completes.

    This is a known issue regarding how the error is processed in the Data Protection for VMware vCenter plug-in when the VMCLI service stops.

    Workaround: Ignore the error message as the backup operation continues until complete. (84730)

  • Data Protection for VMware vCenter plug-in help page is inconsistent with the server locale


  • When the Data Protection for VMware vCenter plug-in help page is accessed through the "Learn more" link for the first time, the help displays in the language specified by the locale setting of the processor that runs the Data Protection for VMware vCenter plug-in, not the language specified by the locale of the VMware vSphere Client. In this situation, after the Data Protection for VMware vCenter plug-in help page displays, click at least two links within the help, then close the help. The next time the help is started from the "Learn more" link, it displays in the language specified by the locale setting of the VMware vSphere Client.

    This is a known issue caused by inconsistent locale settings among the processor that runs the Data Protection for VMware vCenter plug-in and the VMware vSphere Client. The Data Protection for VMware vCenter plug-in does not support running in an environment that contains inconsistent locale settings among the processor that runs the Data Protection for VMware vCenter plug-in, the VMware vSphere Client, and the Tivoli Storage Manager server.

    Workaround: Specify the same locale settings among the processor that runs the Data Protection for VMware vCenter plug-in, the VMware vSphere Client, and the Tivoli Storage Manager server. (86543)

  • Reports tab shows incomplete number of virtual machines being processed
    During a backup operation, the Reports tab shows two numbers in the Details category of the table. For example:
      Processing virtual machine: 10 / 11

    The first number (10) is the number of virtual machines that have been processed (backed up). The second number (11) is the total number of virtual machines to be processed in the backup operation.

    During a backup operation, the total number of virtual machines is routinely refreshed by the Data Protection for VMware vCenter plug-in during backup processing. This refresh action changes the numbers that are shown. Depending on the number of virtual machines being backed up, additional time is needed until the total number of virtual machines stabilizes. Then, the number of virtual machines that have been processed changes until the backup operation completes.

    This issue is working as designed.

    Workaround: Understand the refresh action changes both numbers until the backup operation completes. (86961)

  • Data Protection for VMware vCenter plug-in displays in two vCenters

The Data Protection for VMware vCenter plug-in is displayed in two vCenters because it is registered to both vCenters. Although the Data Protection for VMware vCenter plug-in supports operations in only one vCenter, it is possible for it to be registered to two vCenters.

This situation occurs because of the following scenario:
1. The Data Protection for VMware vCenter plug-in was uninstalled.
2. During the uninstall process, when prompted to unregister the Data Protection for VMware vCenter plug-in, this unregister task was skipped.
3. The Data Protection for VMware vCenter plug-in was reinstalled and registered to a different vCenter.

As a result, the Data Protection for VMware vCenter plug-in is registered (and displays) in two vCenters.

Workaround: During the uninstall process, when prompted to unregister the Data Protection for VMware vCenter plug-in, make sure to select this task so that the Data Protection for VMware vCenter plug-in does not display in two vCenters. (88668)

  • Host is displayed as UNKNOWN in Data Protection for VMware vCenter plug-in

When restoring Virtual Machines that were backed up with Data Protection for VMware 6.2.x, the Virtual Machine's ESXi host name is not displayed, and instead the host shows the name as "UNKNOWN".
However, the Virtual Machine can be restored without issues. (89150)

  • Data Protection for VMware vCenter plug-in attempts to back up invalid VMs

A VM must be in the 'connected' state to be accessed for backup by the Data Protection for VMware vCenter plug-in. A VM that is not in the 'connected' state cannot be accessed for backup and is considered an invalid VM. When an invalid VM exists in the VMware vCenter, the Data Protection for VMware vCenter plug-in attempts to back up this invalid VM anyway, even when the invalid VM is not selected. Pending any unforeseeable issues with the VMs selected for backup, the Data Protection for VMware vCenter plug-in completes the backup operation but the following error message is returned:

ANS2721E (RC4400) The virtual machine backup operation completed. However, one or more virtual machine backups failed.

Workaround: Check the console output and error logs for information about why the connection state was invalid. For example, an error message similar to the following is returned in the dsmerror.log file:

ANS2713E The virtual machine 'vmonion-rest' is in an invalid connection state 'inaccessible'. As a result, it cannot be backed up.

In this scenario, the invalid VM 'vmonion-rest' was not originally selected; however, the Data Protection for VMware vCenter plug-in attempted to back it up anyway. (90516)


Data Protection for VMware Issues and Limitations
  • VMCLI Derby database is corrupted

When the VMCLI Derby database (VMCLIDB) becomes corrupted, the service.properties file in the ${DERBY_HOME}/VMCLIDB folder is deleted. In this situation, the VMCLI daemon cannot start the Derby database.

This is a known issue that can occur when the Derby database is shutting down.

Workaround: To to recover a corrupted VMCLI Derby database (VMCLIDB), complete one of the following procedures:

Copy the service.properties file from the latest Derby database backup located on your file system.
1. Locate the latest Derby database backup located on your file system. The default location is <install_dir>/derby_backups. For example, on Linux, the default location is /opt/tivoli/tsm/tdpvmware/common/derby_backups.
2. Copy the service.properties file from the backup (located on your file system) to the corrupted VMCLI Derby database (VMCLIDB). For example, on Linux, issue a command similar to the following:
cp /opt/tivoli/tsm/tdpvmware/common/derby_backups/20120903000020157/VMCLIDB/service.properties /home/tdpvmware/tdpvmware/VMCLIDB

Use the service.properties file from a new VMCLI Derby database
1. Rename the corrupted VMCLIDB.
2. Start the VMCLI daemon.
3. Stop the VMCLI daemon.
4. Copy the service.properties file from the new VMCLIDB to the corrupted VMCLIDB.
5. Delete the new VMCLIDB.
6. Rename the corrupted VMCLIDB to its original name.

After completing either of these workaround procedures, the VMCLI daemon should start successfully. (86868)

  • Backup of the Windows 2008 R2 virtual machine with a hidden and/or off-line Microsoft System Reserved (MSR) partition fails

Data Protection for VMware is unable to process a hidden or off-line Microsoft System Reserved (MSR) partition. VMware vStorage API calls require that the partition is online and visible (not hidden) before it can be backed up.

The following VMware knowledge document describes the requirement for visible MSR partitions:
http://kb.vmware.com/kb/2008012

If you try to back up a partition that is hidden or off-line, the backup fails. The following errors are recorded in the dsmerror.log file:
    ANS9365E VMware vStorage API error.
    TSM function name : visdkWaitForTask
    TSM file : vmvisdk.cpp (3754)
    API return code : 60
    API error message : An error occurred while quiescing the
    virtual machine. See the virtual machine's event log for
    details.
    An unexpected error was encountered.
    TSM function name : vmVddkFullVMOpenVMDKs
    TSM function : snapMoRefP is null
    TSM return code : 115
    TSM file : vmbackvddk.cpp (7436)
    ANS4151E Failure mounting Virtual Machine '<MachineName>'.
    RC=115

Workaround: Enter the following diskpart commands from a command prompt window:
    C:\>Diskpart
    C:\Diskpart> List volume
    C:\Diskpart> Select volume 1 (volume 1 contains the system reserved partition)
    C:\Diskpart> Online volume (This brings the volume online)
    C:\Diskpart> detail partition

The output of the "detail partition" option reveals the partition attributes. For example, it lists the selected volume's partition number, partition type (07=NTFS), and its hidden and active status:
    Partition 1
    Type : 07
    Hidden: No
    Active: Yes
    Offset in Bytes: 1048576

If the partition type is "07" and if the hidden attribute is "no", type EXIT to close diskpart and try backing up the disk again.

If the partition type is not "07", type the following to set the type to 07 and unhide the partition:
    C:\Diskpart> set id=07 override

Type EXIT to close diskpart and try backing up the disk again.

  • Guest VM operating system that is displayed in Data Protection for VMware Recovery Agent GUI might be incorrect

The operating system for the guest VM (that displays in the "Select snapshot" field) is determined by the operating system assigned to that guest VM in the vCenter. Therefore, if the guest VM operating system is assigned incorrectly in the vCenter, the guest VM operating system in the "Select snapshot" field also displays incorrectly.

Workaround: Assign the correct guest VM operating system in the vCenter. (88729)

  • FULL VM vStor backup (IFFULL, IFINCR, FULL, INCR) failures

Consistent backup failures have been experienced with some Tivoli Storage Manager version 6.4 Backup-Archive Client Linux installations on all supported Linux platforms, that are used as the data mover for VMware backups.

Workaround: Download and install the Tivoli Storage Manager Backup-Archive Client 6.4.0.1 interim fix (IC88237).

  • Message "NBD_ERR_NETWORK_CONNECT

When using NBD transport, the following error in the dsmerror.log may indicate that a VMware limit of ESX host connections has been exceeded. User action is to reduce the vmmaxparallel and vmlimitperhost options to limit the number of TSM connections to the ESX host.


ANS9365E VMware vStorage API error.
TSM function name : VixDiskLib_Open
TSM file : vmvddksdk.cpp (1748)
API return code : 14009
API error message : NBD_ERR_NETWORK_CONNECT


Futher VMware documentation can be found here:
http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1022543

  • Concurrent backup or restore of the same VM guest is not supported

In this scenario, a VM guest backup or restore operation is running. Before processing completes, a second backup or restore operation of the same VM guest is started. This type of concurrent backup or restore of the same VM guest is not supported. If you attempt to run multiple concurrent operations of the same VM guest, the second operation fails. In addition, the first operation might also fail. This is a known limitation.

Workaround: Run only one operation of a VM guest at a time. For example, if you are backing up a given VM guest, do not attempt to run another backup or restore operation of that same VM guest. Likewise, if you are restoring a given VM guest, do not attempt to run another backup or restore operation of that same VM guest.

  • Recovery Agent does not support restoring logical volumes or VMDKs 2 TB or larger

Attempts to perform mount or instant restore operations of VMs on a logical volume or VMDK with the Tivoli Storage Manager Recovery Agent fails in these situations:
-the logical volumes are equal to, or greater than, 2 TB
-the VMDK is equal to, or greater than, 2 TB

To perform mount or instant restore operations of VMs on a logical volume or VMDK with the Tivoli Storage Manager Recovery Agent, the logical volume size must be less than 2 TB and each VMDK size must be less than 2TB.

Workaround: Specify the vmskipmaxvmdks yes option in the Tivoli® Storage Manager backup-archive client options file during a backup operation. This option setting ensures that VMware VMDKs that are 2 TB (or smaller) are backed up and omits any VMDKs that are larger than 2 TB.

  • Transport mode does not failover

In this scenario, the vmvstortransport option is specified during a backup vm and restore vm operation. The specified transport mode becomes unavailable during processing and the operation fails. The Tivoli Storage Manager backup-archive client does not failover to another transport mode when the specified transport mode
becomes unavailable during an operation.

When this occurs, the dsmerror.log contains a reference to "VixDiskLib_Write" or "VixDiskLib_Read".

  • Data mover cannot back up itself

In this scenario, the data mover that runs the backup operation attempts to back up its own disks. This scenario is not supported.
As a result, the backup operation fails. A data mover must be backed up by a different data mover.

Workaround: Verify that the data mover that runs the backup operation does not attempt to back up its own disks.

[{"Product":{"code":"SS8TDQ","label":"Tivoli Storage Manager for Virtual Environments"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Data Protection for VMware","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"6.4","Edition":"All Editions","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
17 June 2018

UID

swg21609441