APAR status
Closed as program error.
Error description
Querying the IBM Spectrum Protect Server for objects backed up for a node using the Client Management Service (CMS) web interface can return the http error 500 when the node option file contains the option 'ASNODENAME'. Here is an example on Linux : /opt/tivoli/tsm/client/ba/bin/dsm.sys SERVERNAME SERVER1 COMMMETHOD TCPIP TCPPORT 1500 TCPSERVERADDRESS 1.2.3.4 NODENAME NODE_A ASNODENAME NODE_B PASSWORDACCESS GENERATE ERRORLOGNAME /var/log/tsm/NODE_A.log The CMS configuration must have the required FILE_RESTORE capability enabled to be able to run the queries for the backed up objects stored on the server as seen below : /opt/tivoli/tsm/cms/bin/CmsConfig.sh enable NODE_A FILE_RESTORE Enable capability Finished enabling capability. /opt/tivoli/tsm/cms/bin/CmsConfig.sh list Listing CMS configuration 1.2.3.4:1500 NODE_A Capabilities: [LOG_QUERY, DAEMON_QUERY, DAEMON_UPDATE, FILE_RESTORE] Opt Path: /opt/tivoli/tsm/client/ba/bin/dsm.opt Sys Path: /opt/tivoli/tsm/client/ba/bin/dsm.sys Log File: /var/log/tsm/NODE_A.log en_US MM/dd/yyyy HH:mm:ss UTF-8 Trying the following queries will return the errors : URL : https://<CMS host>:9028/tsmcms/backupSystems/NODE_A/savedObjects Message : Error 500: java.lang.StringIndexOutOfBoundsException: String index out of range: -2 URL : https://<CMS host>:9028/tsmcms/backupSystems/NODE_A/savedObjects?path=/tmp/te st_1 Message : Error 500: java.lang.NumberFormatException: For input string: "---" Customer/L2 Diagnostics : Looking into the CMS log : /opt/tivoli/tsm/cms/Liberty/usr/servers/cmsServer/logs/message.l og The following type of errors will be seen : [ERROR ] An unhandled exception occurred which will be propagated to the container. [ERROR ] SRVE0777E: Exception thrown by application class 'java.lang.String.substring:1,377' java.lang.StringIndexOutOfBoundsException: String index out of range: -2 [ERROR ] An unhandled exception occurred which will be propagated to the container. [ERROR ] SRVE0777E: Exception thrown by application class 'java.lang.NumberFormatException.forInputString:76' java.lang.NumberFormatException: For input string: "---" These messages are happening because from the client query response, the code sees an unexpected line : "Accessing as node: NODE_B" that causes the parser to fail. For our example, the client queries outputs that are used look as follow : dsmc -se=SERVER1 IBM Spectrum Protect Command Line Backup-Archive Client Interface Client Version 8, Release 1, Level 0.2 Client date/time: <client_timestamp> (c) Copyright by IBM Corporation and other(s) 1990, 2017. All Rights Reserved. Node Name: NODE_A Session established with server SERVER1: Linux/x86_64 Server Version 7, Release 1, Level 4.100 Server date/time: <server_timestamp> Last access: <timestamp> Accessing as node: NODE_B Protect> q fi # Last Incr Date Type File Space Name - ---------------- ---- --------------- 1 00/00/0 00:00:00 ext4 /tmp Protect> q ba /dss/dsstestfs01/ Size Backup Date Mgmt Class A/I File ------- ------------------- ---------- --- ----------- 4,096 B 11/11/2017 14:00:00 STANDARD A /tmp/test_1 When the client option 'ASNODENAME' is used, the extra line : "Accessing as node: <nodename>" will be seen and that is causing the parser to fail. IBM Spectrum Protect Versions Affected: IBM Spectrum Protect Operations Center 7.x and 8.1.x on all supported platforms Initial Impact: Low Additional Keywords: cms asnode query
Local fix
Prefer using the option 'asnodename' in the client commands or schedules instead of in the client option file.
Problem summary
**************************************************************** * USERS AFFECTED: * * All IBM Spectrum Protect Client Management Services users. * **************************************************************** * PROBLEM DESCRIPTION: * * See error description. * **************************************************************** * RECOMMENDATION: * * Apply fixing level when available. This problem is currently * * projected to be fixed in levels 8.1.6. Note that this is * * subject to change at the discretion of IBM. * ****************************************************************
Problem conclusion
This problem was fixed. Affected platforms for reported release: AIX, Linux, and Windows. Platforms fixed: AIX, Linux, and Windows.
Temporary fix
Comments
APAR Information
APAR number
IT23425
Reported component name
TSM OPERATIONS
Reported component ID
5608E01UI
Reported release
811
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2017-12-08
Closed date
2018-05-23
Last modified date
2018-05-23
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 OPERATIONS
Fixed component ID
5608E01UI
Applicable component levels
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"811","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}}]
Document Information
Modified date:
23 May 2018