IT38294: NGP/ANALYTICS/VMBACKUPHISTORY REST API CALL FAILS WITH STATUS CODE "500"

APAR status

• Closed as program error.

Error description

• Running a REST API call to /ngp/analytics/vmbackuphistory on IBM
  Spectrum Protect Plus can fail with response code 500:
  
  curl -s -k -X GET -H "x-endeavour-sessionid:<session ID>" -H
  'Accept:application/json' -H 'Content-type:application/json'
  https://localhost:443/ngp/analytics/vmbackuphistory
  
  response :
  {?
  "timestamp":"2021-08-17T12:10:02.078+00:00",
  "status":500,
  "error":"Internal Server Error",
  "message":""
  }?
  
  Investigating the messages.log file on the IBM Spectrum Protect
  Plus host shows:
  <date> <hostname> node: <date> - #033[32minfo#033[39m:
  Request options for session ID(<session_id>):{"host":"localhost
  ","port":null,"path":"/api/site","method":"GET","headers":{"x-e
  ndeavour-sessionid":"<sessionid>","x-endeavour-locale":"en-us","
  son","x-forwarded-proto":"https","x-forwarded-port":443,"host":
  "<hostname>"},"rejectUnauthorized":false}
  <date> <hostname> node: <date> - #033[32minfo#033[39m:
  gethypervisorvm: start
  <date> <hostname> node: <date> - #033[32minfo#033[39m:
  gethypervisorvm: num version links found: 996
  <date> <hostname> node: <date> - #033[32minfo#033[39m:
  gethypervisorvm: promise.all called. count = 996
  <date> <hostname> java: <date>  WARN 1628 --- [-443-exec-81857]
  o.s.c.n.z.filters.post.SendErrorFilter   : Error during
  filtering
  <date> <hostname> java:
  com.netflix.zuul.exception.ZuulException: 429 TOO_MANY_REQUESTS
  
  The "429 TOO_MANY_REQUESTS" response code corresponds to
  reaching the rate limit that is implemented. Once the rate limit
  is reached, a 429 is returned for all subsequent requests until
  the rate of requests falls below the limit.
  
  | MDVREGR 10.1.7-ifix1-TIV_5737SPLUS |
  
  IBM Spectrum Protect Plus Versions Affected:
  IBM Spectrum Protect Plus 10.1.7-ifix2 and 10.1.8
  
  Additional Keywords: SPP, SPPlus, TS006534622
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Plus level 10.1.8 and 10.1.9            *
  ****************************************************************
  * 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.10. Note that this is subject to change at the          *
  * discretion of IBM.                                           *
  ****************************************************************
  

Problem conclusion

• IBM Spectrum Protect Plus ngp/analytics/vmbackuphistory report
  endpoint has been enhanced to handle http status 429
  "TOO_MANY_REQUESTS".   The rate limit has also been relaxed to
  accommodate most customer environments.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Modules/Macros

• Report
  

Fix information

• Fixed component name

  SP PLUS

• Fixed component ID

  5737SPLUS

Applicable component levels