IBM Support

IT35747: REST API ANALYTICS COMMAND ERROR IN NAT ENVIRONMENT

Subscribe

You can track all active APARs for this component.

 

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 number

    IT35747

  • 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

    2021-02-01

  • Closed date

    2021-02-11

  • Last modified date

    2021-02-11

  • 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