IT23977: SUCCESSFUL 'RESTORE VM' DESPITE SERVER STORAGE POOL ACCESS ERRORS ANS1314E

IBM Spectrum Protect client 7.1.8.x interim fix downloads

APAR status

• Closed as program error.

Error description

• The 'RESTORE VM' operation ONLY from Periodic FULL or INCR
  legacy backup images (as opposed to IFFUL or IFINCR incremental
  forever type of backups) can complete successfully despite
  storage pool errors that prevents some data to be restored.
  This produces a restored VMware guest that is corrupted and for
  example cannot boot or is missing disk data.
  
  Example of restore process output :
  
  Starting Full VM restore of VMware Virtual Machine '<vm guest
  name>' target node name='<datacenter node>', data mover node
  name='<datamover node>'
  Restoring virtual machine '<vm guest name>' to new VM with name
  '<vm guest name>'.
  Restoring VM configuration information for '<vm guest name>'
  Restoring disk [<target datastore>] <vm guest name>/<vm guest
  name>.vmdk (Hard Disk 1), Capacity: 107,374,182,400
  (nbd)[receiving]
  Restoring FULL (<backup timestamp>) - bytes to restore:
  53,176,107,008
  Restoring disk [<target datastore>] <vm guest name>/<vm guest
  name>_1.vmdk (Hard Disk 2), Capacity: 10,737,418,240
  (nbd)[receiving]
  Restoring FULL (<backup timestamp>) - bytes to restore:
  223,346,688
  Restoring disk [<target datastore>] <vm guest name>/<vm guest
  name>_3.vmdk (Hard Disk 3), Capacity: 397,284,474,880
  (nbd)[receiving]
  Restoring FULL (<backup timestamp>) - bytes to restore:
  362,210,656,256
  Restoring disk [<target datastore>] <vm guest name>/<vm guest
  name>_4.vmdk (Hard Disk 4), Capacity: 64,424,509,440
  (nbd)[receiving]
  Restoring FULL (<backup timestamp>) - bytes to restore:
  51,226,214,400
  Restoring disk [<target datastore>] <vm guest name>/<vm guest
  name>_5.vmdk (Hard Disk 5), Capacity: 268,435,456,000
  (nbd)[receiving]
  Restoring FULL (<backup timestamp>) - bytes to restore:
  111,956,066,304
  Successful Full VM restore of Virtual Machine '<vm guest name>'
  Successful Full VM restore of VMware Virtual Machine '<vm guest
  name>' target node name='<datacenter node>', data mover node
  name='<datamover node>'
  Total number of objects restored:             1
  Total number of objects failed:               0
  Total number of bytes transferred:       146.30 GB
  Data transfer time:                   20,232.87 sec
  Network data transfer rate:            7,582.20 KB/sec
  Aggregate data transfer rate:          7,234.48 KB/sec
  Elapsed processing time:               05:53:25
  
  As seen above it appears to complete successfully, but in the
  dsmerror.log you can for example see several errors like :
  
  ANS1314E File data currently unavailable on server
  
  IBM Spectrum Protect Versions Affected:
  IBM Spectrum Protect Backup-Archive Client version
  7.1.3.0 and higher on Windows x64 and Linux x86 platforms.
  Note: The Backup-Archive Client is a prerequisite to using the
  Data Protection for VMware. In Data Protection for VMware
  environments, the Backup-Archive Client is also known as the
  data mover.
  
  This problem also affects IBM Spectrum Protect for Virtual
  Environments: Data Protection for VMware 8.1. If you are using
  Data Protection for VMware 8.1, refer to APAR IT22337
  
   | MDVREGR 7.1.3.0 5725TVEVM |
   | MDVREGR 8.1.0.0 5725TVEVM |
  
  Initial Impact: High
  
  Additional Keywords: tsm4ve tdp4ve corruption cannot start
  vmware guest VM restore
  

Local fix

• Ensure the client can access the legacy backup data to restore
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect for Virtual Environments Data           *
  * Protection for VMware versions 7.1.3, 7.1.4, 7.1.6 and  8.1  *
  * running on all Microsoft Windows x64 and Linux x86           *
  * platforms.                                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * see ERROR description                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Backup-Archive    *
  * Client version 7.1.8.2 on Windows x64 and Linux x86          *
  * platforms.                                                   *
  * Note 1: The Backup-Archive Client is a prerequisite to using *
  * the Data Protection for VMware. In Data Protection for       *
  * VMware environments, the Backup-Archive Client is also known *
  * as the data mover.                                           *
  * Note 2: This is subject to change at the discretion of IBM.  *
  ****************************************************************
  

Problem conclusion

• Errors during vm restore of legacy Periodic Full and Incremental
  backups are now correctly handled.
  

Temporary fix

Comments

APAR Information

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

  IT22337

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

Modules/Macros

• dsmagent
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R71L PSY

     UP

• R71W PSY

     UP