IT05265: "BACKUP VM" MAY FAIL TO PASS THE DISK VERIFICATION CHECK WITH ERRORS ANS9921E/ANS9919E

TSM client 7.1.1.x interim fix downloads
IBM Tivoli Storage Manager (TSM) Client 7.1.2 Downloads and READMEs
IBM Tivoli Storage Manager Client 6.4.3 Downloads and READMEs

APAR status

• Closed as program error.

Error description

• Tivoli Storage Manager ifincr "backup vm" may be completed with
  status failure (RC12) if client fails the virtual machine disk
  verification check.
  
  The client's console shows the following errors:
  
  ANS9921E Virtual machine disk, <VMNAME> (Hard Disk 1),
  verification check failed (1234567890/1234567890).
  ANS9919E Failed to find the expected control files for <VMNAME>.
  
  The problem occurs if  the "size on disk" value doesn't match a
  multiple of 16kb of the sector size declared in the vm control
  file.
  
  Customer/L2 diagnostic:
  
  Example:
  ***********************************
  VmVerifyIfSingleDisk():
       Found disk: Hard Disk 2
       Verifying disk backup ctls: checking size on disk vs ctl
  size
                                   coverage: Hard Disk 2.
       Num of CTLs = 425; type = IFFULL
       Skipping BITMAP.DAT file
       VM / Disk         : <VMNAME>/ Hard Disk 2
       capacity          : 32226647040
       size on disk      : 28151880704
       ctl coverage size : 28151889920
       disk included     : Yes
       prev backup ifincr: No
       ctl matches size  : No
       ctl found         : Yes
       bitmap found      : Yes
       disk used         : Yes
       result            : OK; Prev backup full; will recheck next
  ifincr
  ***********************************
  
  Generally the "ctl coverage size" is equal to the "size on
  disk". In this case the "ctl coverage size" matches the next
  16KB multiple and it should be enough to allow for a successful
  backup, however the check on the "size on disk" fails and makes
  the "backup vm" command exit with a failure.
  
  The problem occurs if the value of the "size on disk" is not a
  multiple of 16KB (16384 bytes). In the example given above the
  value "28151880704" is not a multiple of 16K.
  
  A trace gathered for an earlier VM backup belonging to the same
  ifincr chain may also show the following message:
  
  ************************
  ..\..\common\vm\vmbackvddk.cpp(6163): VmProcessExtent(): Extent
  not multiple of numSectorsPerRec 32; Last block partial read of
  14 sectors
  ************************
  
  The fullvm backup feature is not affected by this defect because
  the check is performed only during the incremental vm backup.
  
  | MDVREGR 6.4.2.001-TIV_5698MCL |
  | MDVREGR 7.1.1.000-TIV_5698MCL |
  
  Tivoli Storage Manager Versions Affected:
  All supported Tivoli Storage Manager Client on all supported
  platforms.
  
  Initial Impact:
  Medium
  
  Additional Keywords:
  vm backup fail zz62 zz63 zz64 zz71 disk vmdk ctl
  

Local fix

• The disk check can be disabled, but the check was put into place
  to detect unrecoverable backups described by Flash (Alert)
  number 1684022,
  TSM data mover backups of VMware guests might be unrecoverable:
  http://www.ibm.com/support/docview.wss?uid=swg21684022
  
  If, after reading the flash and determining its applicability,
  you decide to temporarily suspend the check so that the VM can
  be backed up, then disable disk size verification by adding the
  following line in the dsm.opt file:
  VMVERIFYIFLATEST NO
  
  The VMVERIFYIFLATEST option should be re-enabled afterwards.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Tivoli Storage Manager for Virtual Environments              *
  * Data Protection for VMware versions 6.4.2.1, 6.4.2.2 and 7.1 *
  * running on all Microsoft Windows and Linux x86_64 platforms. *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Tivoli Storage    *
  * Manager Client on Windows and Linux x86_64 in levels         *
  * 6.4.3 and 7.1.2                                              *
  * Note 1: The Tivoli Storage Manager (TSM) Client is a         *
  * prerequisite to using the Data Protection for VMware.        *
  * In Data Protection for VMware environments, the TSM Client   *
  * is also known as the data mover.                             *
  * Note 2: This is subject to change at the discretion of IBM.  *
  *                                                              *
  ****************************************************************
  

Problem conclusion

• Disk verification is successful, if ctl coverage is greater then
  disk size on disk, disk size on disk is not multiple of 16kb and
  the difference is less then 16kb.
  

Temporary fix

• A fix for this problem is currently targeted for Tivoli
  Storage Manager Client interim fix package 6.4.2.3 and 7.1.1.4.
  
  Note: Until a Data Protection for VMware packaged fix of a
  fixing Tivoli Storage Manager Client level is available,
  Data Protection for VMware customers can install an use a
  fixed level of the Tivoli Storage Manager Client in their
  environment
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Modules/Macros

• dsmagent None
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R64L PSY

     UP

• R64W PSY

     UP

• R71L PSY

     UP

• R71W PSY

     UP