APAR status
Closed as program error.
Error description
Clone volumes on the vSnap with names prefixed with "vsnap_arc_upload_" are used during archive jobs and are expected to be cleaned up upon archive completion. This type of volume still can be present after a crash of the vSnap host while an archive operation was running. The maintenance job in IBM Spectrum Protect Plus cannot expire archive snapshots due to these left over clone volumes. In the maintenance job log the following messages will be seen each day with a growing list of snapshots that cannot be expired : INFO,..,CTGGA1914,Delete Cloud Snapshot <xxxx> on partner archive partner id <vSnapArchivePartnerId> on vSnap. INFO,..,CTGGA1911,Cloud Snapshot delete session started for snapshot <xxxx> partner type archive partnerId <vSnapArchivePartnerId> cloud session null on cloud <yyyy> WARN,..,The following snapshot(s) with active clone(s) could not be deleted. <snapshot list seen in next lines> IBM Spectrum Protect Plus Versions Affected: IBM Spectrum Protect Plus 10.1.x Additional Keywords: SPP, SPPLUS, TS007044930
Local fix
Manually clean up the left over clone volumes : 1. Ensure no archive jobs are currently active. As long as no archive jobs are running, any volumes named "vsnap_arc_upload_" should not exist. 2. Use this command to list and delete them: vsnap volume show | grep vsnap_arc_upload_ | awk '{print $1}' | while read cloneId; do echo "Deleting clone volume id $cloneId"; vsnap volume delete --id $cloneId --force --noprompt; done
Problem summary
**************************************************************** * USERS AFFECTED: * * IBM Spectrum Protect Plus levels 10.1.4, 10.1.5, 10.1.6, * * 10.1.7, 10.1.8 * **************************************************************** * PROBLEM DESCRIPTION: * * See Error Description * **************************************************************** * RECOMMENDATION: * * Apply fixing level when available. This problem is currently * * projected to be fixed in IBM Spectrum Protect Plus level * * 10.1.9. Note that this is subject to change at the * * discretion of IBM. * ****************************************************************
Problem conclusion
The problem occurred because temporary clone volumes created by the archive upload process could be left behind in some cases if the vSnap server crashed abruptly. The leftover clones prevent expiration of the underlying snapshots, thus causing warnings or errors in the Maintenance job. The problem has been resolved by implementing code fixes to detect and clean up leftover archive clones during vSnap startup.
Temporary fix
Comments
APAR Information
APAR number
IT39164
Reported component name
SP PLUS
Reported component ID
5737SPLUS
Reported release
A18
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2021-11-22
Closed date
2021-12-01
Last modified date
2021-12-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Modules/Macros
vSnap Archive
Fix information
Fixed component name
SP PLUS
Fixed component ID
5737SPLUS
Applicable component levels
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSNQFQ","label":"IBM Spectrum Protect Plus"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"A18","Line of Business":{"code":"LOB26","label":"Storage"}}]
Document Information
Modified date:
31 January 2024