IT20002: RESTORE FROM VMVSS BACKUP MAY FAIL WITH ANS1235E (RC114) IF LZ4 COMPRESSION IS ENABLED

Download Information: Version 8.1.0.x Data Protection for VMware
Download Information: Version 8.1.2 IBM Spectrum Protectâ„¢ for Virtual Environments

APAR status

• Closed as program error.

Error description

• Starting with IBM Spectrum Protect Backup Archive Client
  version 7.1.6 LZ4 compression can be used.
  
  Given the following scenario:
  - Use inguest application protection with IBM Spectrum Protect
    for Virtual Environments
    include.vmtsmvss MYSQLSERVERVM
  - Data Mover is configured to use client compression
  - Target Storage Pool on IBM Spectrum Protect Server 7.1.6
    is type container storage pool
  
  If all of the above points are true the restore of the protected
  application fails using IBM Spectrum Protect for Mail:
  Data Protection for Microsoft Exchange Server or IBM Spectrum
  Protect for Databases: Data Protection for Microsoft SQL Server.
  
  The reported error message for SQL Server databases is:
  ACO5060E A Tivoli Storage Manager API error has occurred.
  
  For Exchange Server it is:
  ACN5060E A Tivoli Storage Manager API error has occurred.
  
  Customer/L2 Diagnostics:
  A service trace of backup archive client shows the real problem
  is that the APPProtectionDBInfo.xml cannot be decompressed:
  
  ..\..\common\ut\instr.cpp(1502): 2016-11-01 10:45:31.283 TID:
  4024, Begin: API Compression       , Suspend: Other
  ..\..\common\ut\cmputil.cpp( 764): ExpUtilLz4::cmExpandData():
  m_expLen = 0
  ..\..\common\ut\cmputil.cpp( 774): ExpUtilLz4::cmExpandData():
  m_outBuffer is empty, m_expLen = 0
  ..\..\common\ut\cmputil.cpp( 777): ExpUtilLz4::cmExpandData():
  Expand 10 bytes to -4 in m_outBuffer
  ..\..\common\ut\cmputil.cpp( 785): ExpUtilLz4::cmExpandData():
  LZ4_decompress_safe failed rc = -4
  ..\..\common\ut\cmputil.cpp( 830): ExpUtilLz4::cmExpandData():
  Expansion error, rc = 114, m_cmpLen = 0, m_status = 2
  ..\..\common\ut\instr.cpp(1511): 2016-11-01 10:45:31.283 TID:
  4024, End: Compression           , Resume: Transaction
  ..\..\common\ut\instr.cpp(1511): 2016-11-01 10:45:31.283 TID:
  4024, End: API Compression       , Resume: Other
  ..\..\common\ut\cmputil.cpp( 838): ExpUtilLz4::cmExpandData():
  EXIT: status = 2, outActSize = 0, rc = 114
  ..\..\common\ba\restcore.cpp( 840): rcWriteFile(): rc(114),
  cmStatus(2), outBuffSize(32768), actSize(0)
  ..\..\common\ba\restcore.cpp( 947): RestoreFiles: RC: 114
  received from fioWrite
  Failed ==>
  \\mysqlserver\c$\adsm.sys\vss_staging\MYINST\NODENAME\DateTimeSt
  amp\APPPROTECTIONDBINFO.XML
  
  Products affected:
  IBM Spectrum Protect for Virtual Environments: Data Protection
  for VMware version 8.1.0 on Windows
  
  This problem also affects IBM Spectrum Protect Backup-Archive
  Client which is the data mover for Data Protection for
  VMware 7.1.6. If you are using Data Protection for VMware
  7.1.6 refer to APAR IT17683.
  
  Initial Impact:
  Medium
  
  
  Additional Keywords:
  TSM ISP spectrum protection VMware agent less dm LZ4
  database-level recovery
  

Local fix

• 1. Do not use client compression on data mover together with
     include.vmtsmvss option
  
  2. Use TESTFLAG NOLZ4 in data mover option file to force client
     compression to fall back to legacy LZW compression
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Users of IBM Spectrum Protect for Virtual Environments Data  *
  * Protection for VMware 8.1.0 which is used in conjunction     *
  * with the following products:                                 *
  * -Spectrum Protect for Mail: Data Protection Microsoft        *
  * Exchange Server 8.1                                          *
  * -Spectrum Protect for Databases: Data Protection for         *
  * Microsoft SQL Server 8.1                                     *
  * and who perform restore from VMVSS backups,  which was done  *
  * by  IBM Spectrum Protect for Virtual Environments Data       *
  * Protection for VMware Data Mover version 8.1  on Windows x64 *
  * platform                                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * see ERROR Description                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Data Protection   *
  * for VMware Data Mover version 8.1.0.2 and 8.1.2 on all       *
  * Microsoft Windows x64 platforms                              *
  * Note 1: This is subject to change at the discretion of IBM.  *
  ****************************************************************
  

Problem conclusion

• IBM Spectrum Protect for Virtual Environments Data Protection
  for VMware Data Mover has been updated so that now it is
  possible to perform restore of the protected application using
  IBM Spectrum Protect for Mail: Data Protection for Microsoft
  Exchange Server or IBM Spectrum Protect for Databases: Data
  Protection for Microsoft SQL Server when LZ4 compression is
  enabled.
  

Temporary fix

Comments

APAR Information

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

  IT17683

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

Modules/Macros

• dsmc
  

Fix information

• Fixed component name

  TSM FOR VE DP V

• Fixed component ID

  5725TVEVM

Applicable component levels

• R81W PSY

     UP