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

IBM Spectrum Protect client 7.1.6.x interim fix downloads
IBM Spectrum Protectâ„¢ Client 7.1.8 Downloads and READMEs

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 Backup-Archive Client version
  7.1.6 on Linux and Windows
  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.0. If you are using
  Data Protection for VMware 8.1.0, refer to APAR IT20002.
  
  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 Backup-Archive Client 7.1.6 which is a part of the  *
  * following products:                                          *
  * -Spectrum Protect for Mail: Data Protection Microsoft        *
  * Exchange Server 7.1                                          *
  * -Spectrum Protect for Databases: Data Protection for         *
  * Microsoft SQL Server 7.1                                     *
  * who perform restore from VMVSS backups.  Which was done by   *
  * IBM Spectrum Protect for Virtual Environments Data           *
  * Protection for VMware Data Mover version 7.1  on Windows x64 *
  * platform                                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Backup-Archive    *
  * Client version 7.1.6.5 and 7.1.8 on all Microsoft Windows    *
  * x64 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

• IBM Spectrum Protect Client 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:

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

  IT20002

Modules/Macros

• dsmc
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R71W PSY

     UP