A fix is available
APAR status
Closed as program error.
Error description
When a VMware guest name is ending with a '.' (period), the 'Backup VM' command will fail at the end of the backup in the local staging directory cleanup phase with the following errors seen in the data mover node's dsmerror.log : As many messages as there are megablocks representing the VM guest the following one : ANS5250E An unexpected error was encountered. IBM Spectrum Protect function name : vcmLogger::trace IBM Spectrum Protect function : CacheManager::remove_element: Failed to save element: Path: 'C:\mnt\tsmvmbackup\fullvm\CDF_Local\vmname.\Hard Disk 1' Job: 1001 MB Number: <xxx> IBM Spectrum Protect return code : 115 IBM Spectrum Protect file :..\..\common\vm\vmbackvcm.cpp(218) (where "xxx" corresponds to the number of the megablock) then ANS5250E An unexpected error was encountered. IBM Spectrum Protect function name : vcmLogger::trace IBM Spectrum Protect function : VolumeControl::write_bitmap: can't open file 'C:\mnt\tsmvmbackup\fullvm\CDF_Local\vmname.\Hard Disk 1' for writing IBM Spectrum Protect return code : 115 IBM Spectrum Protect file :..\..\common\vm\vmbackvcm.cpp(218) ANS5250E An unexpected error was encountered. IBM Spectrum Protect function name : vcmLogger::trace IBM Spectrum Protect function : VolumeControlManager::write_object: write_bitmap() failed (id='Path: 'C:\mnt\tsmvmbackup\fullvm\CDF_Local\vmname.\Hard Disk 1' Job: 1001') IBM Spectrum Protect return code : 115 IBM Spectrum Protect file :..\..\common\vm\vmbackvcm.cpp(218) ANS5250E An unexpected error was encountered. IBM Spectrum Protect function name : vcmLogger::trace IBM Spectrum Protect function : CacheManager::remove_element: Failed to save element: Path: 'C:\mnt\tsmvmbackup\fullvm\CDF_Local\vmname.\Hard Disk 1' Job: 1001 IBM Spectrum Protect return code : 115 IBM Spectrum Protect file :..\..\common\vm\vmbackvcm.cpp(218) ANS5250E An unexpected error was encountered. IBM Spectrum Protect function name : vcmLogger::trace IBM Spectrum Protect function : VolumeControlManager::get_first_valid_megablock_in_volume: get_elemnt from cache failed (id='Path: 'C:\mnt\tsmvmbackup\fullvm\CDF_Local\vmname. \Hard Disk 1' Job: 1001') IBM Spectrum Protect return code : 115 IBM Spectrum Protect file :..\..\common\vm\vmbackvcm.cpp(218) ANS0361I DIAG: VmBackupControlFiles(): Error -1 in access vcm lib to get the list of ctl's ANS5250E An unexpected error was encountered. IBM Spectrum Protect function name : vcmLogger::trace IBM Spectrum Protect function : VolumeControlManager::remove_volume_from_cache: Volume not in cache, nothing to remove (id='Path: 'C:\mnt\tsmvmbackup\fullvm\CDF_Local\vmname.\Hard Disk 1' Job: 1001') IBM Spectrum Protect return code : 115 IBM Spectrum Protect file :..\..\common\vm\vmbackvcm.cpp(218) ANS4174E Full VM backup of VMware Virtual Machine 'vmname.' failed with RC=-1 mode=Incremental Forever - Full, target node name='<datacenter node>', data mover node name='<datac mover node>' Products affected: IBM Spectrum Protect for Virtual Environments: Data Protection for VMware version 8.1 on Windows x64 and Linux x86_64 platforms. This problem also affects IBM Spectrum Protect Backup-Archive Client which is the data mover for Data Protection for VMware 7.1. If you are using Data Protection for VMware 7.1 refer to APAR IT24006. Initial Impact: Medium Additional Keywords: tsm4ve tdp4ve backup vm internal error
Local fix
Rename the guest to avoid the trailing '.' (period) character and retry the backup
Problem summary
**************************************************************** * USERS AFFECTED: * * Data Protection for VMware Data Mover versions 7.1 and 8.1 * * running on all on Windows x64 and Linux x86_64 platforms * **************************************************************** * PROBLEM DESCRIPTION: * * See ERROR DESCRIPTION * **************************************************************** * RECOMMENDATION: * * This issue is projected to be fixed in the Data Protection * * for VMware Data Mover version 8.1.4 on Windows x64 and Linux * * x86_64 platforms. * * Note 1: This is subject to change at the discretion of IBM. * ****************************************************************
Problem conclusion
Now client displays the message that the VM names end with a period is not supported.
Temporary fix
Comments
APAR Information
APAR number
IT20941
Reported component name
TSM CLIENT
Reported component ID
5698ISMCL
Reported release
81W
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2017-06-08
Closed date
2018-02-11
Last modified date
2018-02-11
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
IT24006 IT24019
Modules/Macros
dsmc
Fix information
Fixed component name
TSM FOR VE DP V
Fixed component ID
5725TVEVM
Applicable component levels
R81W PSY
UP
R81L PSY
UP
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SS8TDQ","label":"Tivoli Storage Manager for Virtual Environments"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"81W","Line of Business":{"code":"LOB26","label":"Storage"}}]
Document Information
Modified date:
07 January 2022