IT35747: REST API ANALYTICS COMMAND ERROR IN NAT ENVIRONMENT

APAR status

• Closed as program error.

Error description

• REST API analytics queries from external hosts to a IBM
  Spectrum Protect Plus host located in Network Address
  Translation (NAT) environment end with error message
  "Error: Error when getting <query dependent text>".
  
  Example queries :
  
  https://{hostname|IP}/ngp/analytics/vmbackupslacom
  https://{hostname|IP}/ngp/analytics/vmbackuphistory
  
  The following messages are written to
  /data/log/node-cdm-service/ecxngp.log on the IBM Spectrum
  Protect host :
  
  <timestamp> - info: REQUEST received from client at
                      IP=<IP or requesting host> ==> METHOD(GET)
                      URL(/ngp/analytics/vmbackuphistory)
                      SESSION ID(<SessionID>)
  <timestamp> - info: Established request ID=<RequestID> for
                      request=/ngp/analytics/vmbackuphistory in
                      session ID=<SessionID>
  Error: Error when getting hypervisor info
      at Request._callback (/opt/ECX/spp/analytics/models/
         vmbackuphistory.js:102:29)
      at self.callback (/opt/ECX/spp/node_modules/request/
         request.js:185:22)
      at Request.emit (events.js:198:13)
      at Request.onRequestError (/opt/ECX/spp/node_modules/
         request/request.js:881:8)
      at ClientRequest.emit (events.js:198:13)
      at Socket.socketErrorListener (_http_client.js:401:9)
      at Socket.emit (events.js:198:13)
      at emitErrorNT (internal/streams/destroy.js:91:8)
      at emitErrorAndCloseNT (internal/streams/destroy.js:59:3)
      at process._tickCallback (internal/process/
         next_tick.js:63:19)<timestamp> - info:
  
  and
  
  <timestamp> - info: REQUEST received from client at
                      IP=<IP or requesting host> ==> METHOD(GET)
                      URL(/ngp/analytics/vmbackupslacom)
                      SESSION ID(<SessionID>)
  <timestamp> - info: Established request ID=<RequestID> for
                      request=/ngp/analytics/vmbackupslacom in
                      session ID=<SessionID>
  Error: Error when getting storageprofile
      at Request._callback (/opt/ECX/spp/analytics/models/
         vmbackupslacom.js:110:29)
      at self.callback (/opt/ECX/spp/node_modules/request/
         request.js:185:22)
      at Request.emit (events.js:198:13)
      at Request.onRequestError (/opt/ECX/spp/node_modules/
         request/request.js:881:8)
      at ClientRequest.emit (events.js:198:13)
      at Socket.socketErrorListener (_http_client.js:401:9)
      at Socket.emit (events.js:198:13)
      at emitErrorNT (internal/streams/destroy.js:91:8)
      at emitErrorAndCloseNT (internal/streams/destroy.js:59:3)
      at process._tickCallback (internal/process/
         next_tick.js:63:19)<timestamp> - info:
  
  
  IBM Spectrum Protect Plus Versions Affected:
  IBM Spectrum Protect Plus 10.1.2 and higher
  
  Initial Impact: Medium
  
  Additional Keywords: SPP, SPPLUS, TS004481189, rest, api, query
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Plus levels 10.1.x                      *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See Error Description.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply the fixing level when available. This problem was      *
  * 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  "ngp/analytics" endpoints, which include "dbbackuphistory",
  "dbbackupslacom", "vmbackuphistory" and "vmbackupslacom", have
  been fixed to handle requests from within a Network Address
  Translation (NAT) environment.
  

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:

Fix information

• Fixed component name

  SP PLUS

• Fixed component ID

  5737SPLUS

Applicable component levels