IT08242: MOUNT CLEAN UP FAILS WITH ANS3130E RC = 6523

IBM Spectrum Protectâ„¢ Client 7.1.4 Downloads and READMEs

APAR status

• Closed as program error.

Error description

• The clean up of Windows VM mounted for file-level restore using
  the Tivoli Storage Manager for Virtual Environments - Data
  Protection for VMware GUI or the client command line can fail
  with the following errors when the iSCSI targets on the Windows
  mount proxy systems were removed at the Operating system level:
  
  ANS3122E The Microsoft iSCSI Initiator Service encountered an
  error. The Windows error is (0xefff0003: Connection Failed.).
  ANS3131E The operation to disconnect the iSCSI targets from the
  Windows data mover failed.
  ANS3130E The mount cleanup operation for virtual machine '<VM
  guest name>' failed with rc = 6523
  ANS4449E A cleanup of the file-level restore of VMware Virtual
  Machine '<VM guest name>' failed. The data center node name is
  '<data center node name>', the mount proxy node name is '<mount
  proxy node name>'
  
  Tivoli Storage Manager Versions Affected:
  Tivoli Storage Manager for Virtual Environments - Data
  Protection for VMware 7.1.1 or higher on Windows an Linux
  
  Customer/L2 Diagnostics
  
  Using a SERVICE VM trace on the mount proxy node will show :
  
  <timestamp> [007548] [7720] :
  ..\..\common\vm\vmFileLevelRestoreWindowsFunctions.cpp(4174):
  vmFileLevelRestoreWindowsFunctions::DisconnectiSCSITargets:
  Refresh iSCSI Portal Send Targets
  <timestamp> [007548] [7720] :
  ..\..\common\vm\vmFileLevelRestoreWindowsFunctions.cpp( 553):
  vmFileLevelRestoreWindowsFunctions::DisconnectiSCSITargets:
  Failed with windows errorcode 0xefff0003 (Connection Failed.)
  <timestamp> [007548] [7720] :
  ..\..\common\vm\vmFileLevelRestoreWindowsFunctions.cpp(4029):
  EXIT  <=====
  vmFileLevelRestoreWindowsFunctions::DisconnectiSCSITargets, rc
  = 6523
  rc = 6523 means RC_VM_NO_ISCSI_FOUND
  
  Initial Impact: Medium
  
  Additional Keywords: zztsm tsm4ve tdp4ve mount RA iscsi remove
  delete filelevel
  

Local fix

• Ensure that all file-level restore mount operations have been
  cleaned up.
  After that, open with a text editor and edit the file
  vmFileLevelRestoreDataSet.xml in C:\ProgramData\Tivoli\TSM\.
  Remove all lines between the entries "<vmFileLevelRestoreData>"
  and "</vmFileLevelRestoreData>".
  Note the lines mentioned above have to remain in the file as
  well as the line containing "<?xml version='1.0'
  encoding='ISO-8859-1' ?>".
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Tivoli Storage Manager for Virtual Environments component    *
  * Data Protection for VMware versions 7.1.0, 7.1.1 and 7.1.2   *
  * running on all Microsoft Windows platforms                   *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See error description.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Tivoli Storage    *
  * Manager Client on Windows 7.1.4                              *
  * 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.  *
  ****************************************************************
  The Tivoli Storage Manager Backup and Archive Client dsmc
  command terminates the mount clean up operation for virtual
  machines with return code 6523. That makes the subsequent
  cleanup fail.
  

Problem conclusion

• IBM Tivoli Storage Manager Backup and Archive Client  has been
  fixed to identify the corresponding error conditions and ignored
  them. Now the the clean up works correctly.
  

Temporary fix

• Tivoli Storage Manager Client on Windows 7.1.3.1
  Note1: 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 the Tivoli Storage Manager Client in their environment.
  Note 2: This is subject to change at the discretion of IBM.
  

Comments

APAR Information

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

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

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R71W PSN

     UP