APAR status
Closed as program error.
Error description
Using IBM Spectrum Protect Plus, the backup of Microsoft SQL or Exchange databases might stop. Here is an example for a Microsoft Exchange backup with the following messages seen in the job log : SUMMARY,<timestamp>,CTGGA2398,Starting job for policy exch_<SLAName>. id -> <JobID>. IBM Spectrum Protect Plus version 10.1.7-3040. ... DETAIL,<timestamp>,CTGGG1125,[<ExchangeServerAddress>] The Exchange agent is running as user <DomainName>\<User> in group <DomainName>\<groupName> . DETAIL,<timestamp>,CTGGG1103,[<ExchangeServerAddress>] Starting backup DETAIL,<timestamp>,CTGGG1128,[<ExchangeServerAddress>] "Maximum concurrent databases" is set to 10. DETAIL,<timestamp>,CTGGG1129,[<ExchangeServerAddress>] There are 1 databases in the job and 1 will be backed up concurrently. DETAIL,<timestamp>,CTGGG1055,[<ExchangeServerAddress>] Mailbox history successfully backed up. ERROR,<timestamp>,CTGGG1010,[<ExchangeServerAddress>] Failed to copy files to the mounted target volume. ERROR,<timestamp>,CTGGG1116,[<ExchangeServerAddress>] Agent failed to properly finalize the Exchange VSS backup. ... ERROR,<timestamp>,CTGGA2653,<InstanceName> ==> <DBName> ([Backup of all databases failed: 0 file(s) backed up. Total 0 B data transferred. Backup failed: ]) This APAR applies if in the job log bundle collected from the User Interface by clicking on the button 'Download.zip' the following lines are found : <timestamp> .. INFO cbt - To parse backupmetadata file [c:\ProgramData\SPP\mnt\SPPB_ <vSnapVolumeName>\appMetadata.json] <timestamp> .. DEBUG winagent - Command output [Parsing exception: [c:\ProgramData\SPP\mnt\SPPB_ <vSnapVolumeName>\appMetadata.json(51): garbage after data]] The above error is encountered when the IBM Spectrum Protect Plus Microsoft SQL Agent or IBM Spectrum Protect Plus Exchange Agent file 'appMetadata.json' cannot be accessed. For example if the Microsoft SQL or Exchange host security policy prevents from accessing any file on the root location of a volume or an antivirus program is locking access to the file or file path. In the above example, the file "appMetadata.json" is located in the root location of the vSnap iSCSI presented volume "SPPB_<vSnapVolumeName>". The Microsoft SQL or Exchange Spectrum Protect Plus Agent mounts the iSCSI vSnap volumes in "c:\ProgramData\SPP\mnt" IBM Spectrum Protect Plus Versions Affected: IBM Spectrum Protect Plus 10.1.5 and higher | MDVREGR 10.1.4 5737SPLUS | Initial Impact: Medium Additional Keywords: SPP, SPPLUS, TS004620323, antivirus, permission, MSSQL, Exchange
Local fix
Review the Microsoft SQL or Exchange host security rules to allow access to files that will be generated during backups in the path "c:\programdata\SPP". If applicable, exclude path "c:\programdata\SPP" from any antivirus scanner.
Problem summary
**************************************************************** * USERS AFFECTED: * * IBM Spectrum Protect Plus levels 10.1.5, 10.1.6 and 10.1.7. * **************************************************************** * PROBLEM DESCRIPTION: * * See Error Description. * **************************************************************** * RECOMMENDATION: * * Apply the fixing level when available. This problem is * * currently projected to be fixed in IBM Spectrum Protect Plus * * level 10.1.8. Note that this is subject to change at the * * discretion of IBM. * ****************************************************************
Problem conclusion
The backup metadata file was moved to a subfolder on the backup target volume, so backups run successfully.
Temporary fix
Comments
APAR Information
APAR number
IT35778
Reported component name
SP PLUS
Reported component ID
5737SPLUS
Reported release
A17
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2021-02-03
Closed date
2021-03-01
Last modified date
2021-03-01
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
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":"A17","Line of Business":{"code":"LOB26","label":"Storage"}}]
Document Information
Modified date:
31 January 2024