APAR status
Closed as program error.
Error description
When processing VMware guests having a name that includes spaces, IBM Spectrum Protect Plus backup job will display the following type of messages in the virgo log (in path /opt/virgo/serviceability/logs/log.log) and vSnap log (in path /opt/vsnap/log) : Let's assume the guest name is as follows : 'VMname with spaces' The virgo log will be similar to : [<timestamp>] INFO .. Vsnap Call https://SRV01196:8900/api/vo lume/121/path?path=<folder<z>>/VMname with spaces method GET [<timestamp>] INFO .. {"error":{"message":"Could not find None in path /vsnap/vpool<x>/fs<yy>/<folder<z>>/VMname with spaces","type":"IncorrectParameterError"}} [<timestamp>] INFO .. reason : {"error":{"message":"Could not find None in path /vsnap/vpool<x>/fs<yy>/<folder<z>>/VMname with spaces","type":"IncorrectParameterError"}} [<timestamp>] INFO .. reason : {"message":"Could not find None in path /vsnap/vpool<x>/fs<yy>/<folder<z>>/VMname with spaces","type":"IncorrectParameterError"} message :"Could not find None in path /vsnap/vpool<x>/fs<yy>/<folder<z>>/VMname with spaces"type :"IncorrectParameterError" [<timestamp>] INFO .. vsnap storage object get exception : com.catalogic.ecx.servic eprovider.common.storage.exception.StorageGenericException: message :"Could not find None in path /vsnap/vpool<x>/fs<yy>/<folder<z>>/VMname with spaces"type :"IncorrectParameterError" [<timestamp>] INFO .. Unable Get backup folder path message :"Could not find None in path /vsnap/vpool<x>/fs<yy>/<folder<z>>/VMname with spaces"type :"IncorrectParameterError" The vSnap log will be similar to : [<timestamp>] INFO pid-28562 vsnap.api API request started: GET /volume/121/path?path=<folder<z>>/VMname with spaces | Body: None [<timestamp>] WARNING pid-28562 vsnap.linux.system Return code 1: find /vsnap/vpool<x>/fs<yy>/<folder<z>>/VMname with spaces -printf '%y %P' [<timestamp>] WARNING pid-28562 vsnap.linux.system Ouput: ['find: /vsnap/vpool<x>/fs<yy>/<folder<z>>/VMname: No such file or directory', 'find: with: No such file or directory', 'find: spaces: No such file or directory'] [<timestamp>] ERROR pid-28562 vsnap.linux.system Command failed: find: /vsnap/vpool<x>/fs<yy>/<folder<z>>/VMname: No such file or directory', 'find: with: No such file or directory', 'find: spaces: No such file or directory'] [<timestamp>] ERROR pid-28562 vsnap.api Traceback (most recent call last): File "/src/workspace/vsnap/linux/system.py", line 235, in get_file_paths File "/src/workspace/vsnap/linux/system.py", line 456, in run_shell_command vsnap.common.errors.CommandFailureError: Command failed: find: /vsnap/vpool<x>/fs<yy>/<folder<z>>/VMname: No such file or directory', 'find: with: No such file or directory', 'find: spaces: No such file or directory'] During handling of the above exception, another exception occurred: Traceback (most recent call last): File "/opt/vsnap/venv/lib64/python3.6/site-packages/flask/app.py", line 1950, in full_dispatch_request rv = self.dispatch_request() File "/opt/vsnap/venv/lib64/python3.6/site-packages/flask/app.py", line 1936, in dispatch_request return self.view_functions[rule.endpoint](**req.view_args) File "/src/workspace/vsnap/api/core/common.py", line 69, in decorated File "/src/workspace/vsnap/api/rest.py", line 384, in api_volume_get_path_info File "/src/workspace/vsnap/core.py", line 1316, in volume_path_info_get File "/src/workspace/vsnap/linux/system.py", line 247, in get_file_paths vsnap.common.errors.IncorrectParameterError: Could not find None in path /vsnap/vpool<x>/fs<yy>/<folder<z>>/VMname with spaces [<timestamp>] ERROR pid-28562 vsnap.api API request failed with internal server error The above errors do not prevent the completion of the affected guests backups. The responsible vSnap API is only used for collecting some path information to be cataloged for reporting purposes. IBM Spectrum Protect Plus Versions Affected: IBM Spectrum Protect Plus 10.1.5 and 10.1.6 Initial Impact: Medium Additional Keywords: SPP, SPPLUS, TS004165143, blank, whitespace, space
Local fix
Rename the VMware guest without spaces. For example replacing the spaces with underscores '_'.
Problem summary
**************************************************************** * USERS AFFECTED: * * IBM Spectrum Protect Plus leve 10.1.5 and 10.1.6. * **************************************************************** * PROBLEM DESCRIPTION: * * See ERROR DESCRIPTION * **************************************************************** * RECOMMENDATION: * * Apply the fixing level when available. This problem is * * currently projected to be fixed IBM Spectrum Protect Plus * * level 10.1.7. * * Note that this is subject to change at the discretion of * * IBM. * ****************************************************************
Problem conclusion
In the API call for retrieving path information, vSnap did not handle space characters in the path name while invoking certain OS commands. The problem has been resolved by updating the vSnap code to handle spaces correctly.
Temporary fix
Comments
APAR Information
APAR number
IT34181
Reported component name
SP PLUS
Reported component ID
5737SPLUS
Reported release
A16
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2020-09-11
Closed date
2020-11-19
Last modified date
2020-11-19
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":"A16","Line of Business":{"code":"LOB26","label":"Storage"}}]
Document Information
Modified date:
31 January 2024