IT17767: UNEXPECTED INCREMENTAL BACKUP INSTEAD OF SNAPDIFF DIFFERENCE SNAPSHOT PROCESSING WHEN USING REMOTE DESKTOP CONNECTION

IBM Spectrum Protectâ„¢ Client 8.1.2 Downloads and READMEs

APAR status

• Closed as program error.

Error description

• A snapdiff backup (snapshot difference) performed by an user
  that is connected remotely using Microsoft Remote Desktop, will
  be a traditional incremental backup instead of the expected
  differences snapshot when the user disconnects from the remote
  session between backup runs.
  If snapdiff backups are scheduled, the next scheduled backup
  after a remotely connected user initiated backup will also
  again be a traditional increment backup.
  
  The client uses a staging directory to keep snapdiff
  information between backup runs.
  The client option used to define that directory is
  STAGINGDIRECTORY.
  By default, when this option is not set, the location of this
  directory follows these rules :
  The client checks for the existence of the USER environment
  variables in the following order, and uses the first path found:
  1. The path that is specified by the TMP user variable
  2. The path that is specified by the TMP system variable
  3. The path that is specified by the TEMP user variable
  4. The path that is specified by the TEMP system variable
  5. The Windows system directory
  
  The unexpected traditional incremental backup is seen because
  the snapdiff information stored in the staging directory used
  to enable difference snapshot backup is deleted because the
  directory itself is deleted when the user logs off from the
  Remote Desktop session.
  
  Tivoli Storage Manager \ Spectrum Protect Versions Affected:
  All supported versions of Tivoli Storage Manager \ Spectrum
  Protect Client on Windows only
  
  Initial Impact: Low
  
  Additional Keywords: TSM rfe 95278 cache Netapp
  

Local fix

• Avoid using a remote desktop connected user to perform the
  backups
  or
  define a custom location that will not be affected with the
  client option : STAGINGDIRECTORY
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Backup-archive client versions 6.4, 7.1 and 8.1.0 running on *
  * all Microsoft Windows platforms.                             *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Backup-Archive    *
  * Client version 8.1.2 on all Microsoft Windows x64 and Linux  *
  * x86 platforms                                                *
  * Note that this is subject to change at the discretion of     *
  * IBM.                                                         *
  ****************************************************************
  

Problem conclusion

• Beginning with version 8.1.2 snapshot differential backups on
  both Windows and Linux x86/86_64 platforms no longer use the
  stagingdirectory option
  for storing snapshot differential change log files. The new
  option snapdiffchangelogdir is used to specify the location of
  the snapshot differential change log files.
  
  See in What's New and Stagingdirectory topics in the 8.1
  Knowledge center:
  http://www.ibm.com/support/knowledgecenter/SSEQVQ_8.1.0/client/r
  _new_for_version.html
  http://www.ibm.com/support/knowledgecenter/SSEQVQ_8.1.0/client/r
  _opt_stagingdirectory.html
  

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:

Modules/Macros

• dsmc
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R81W PSY

     UP

• R81L PSY

     UP