A fix is available
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 number
IT08242
Reported component name
TSM FOR VE DP V
Reported component ID
5725TVEVM
Reported release
71W
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2015-04-13
Closed date
2015-08-10
Last modified date
2015-08-10
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
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"71W","Line of Business":{"code":"LOB26","label":"Storage"}}]
Document Information
Modified date:
08 January 2022