IT35347: BROCADE SWITCH PROBE FAILS USING BROCADE REST API (NULLPOINTEREXCEPTION)

IBM Spectrum Control 5.4.3 (May 2021)

APAR status

• Closed as program error.

Error description

• PROBE ERRORS
     ?   BTADS0113E Error encountered while
  processing a probe job.
  com.ibm.tpc.discovery.interfaces.DiscoveryException:
  com.ibm.tpc.common.api.TPCException:
  
      ?    BTAFM0722E Error
  occurred while processing information for port
  ***/***.
  
     ?    2020-09-21 12:07:31.152
     ?   BTADS0102E The
  probe with the run ID 381859 completed with
  errors
  [BrocadeSwitchPostProcess-*.*.*.*]
  [BrocadeRESTParseAndPersist.processPortMap] [ERROR] Exception
  processing and persisting port information for: ***/***
  java.lang.NullPointerException  at com.ibm.tpc.fabric.collection
  .BrocadeRESTParseAndPersist.processPortMap(BrocadeRESTParseAndPe
  rsist.java:775)  at com.ibm.tpc.fabric.collection.BrocadeRESTPar
  seAndPersist.persistFullProbe(BrocadeRESTParseAndPersist.java:35
  2)
  
  
  TRACE ERRORS
  2020-09-21 12:07:31.136+0200
  [BrocadeSwitchPostProcess-*.*.*.*]
  [BrocadeRESTParseAndPersist.processPortMap] [ERROR] Exception
  processing and persisting port information for:
  ***/***java.lang.NullPointerException
   at com.ibm.tpc.fabric.col
  lection.BrocadeRESTParseAndPersist.processPortMap(BrocadeRESTPar
  seAndPersist.java:775)
   at com.ibm.tpc.fabric.collection.Brocade
  RESTParseAndPersist.persistFullProbe(BrocadeRESTParseAndPersist.
  java:352)
  2020-09-21 12:07:31.136+0200
  [BrocadeSwitchPostProcess-*.*.*.*]
  [Brocade_Switch_PostProcess.parse] [ERROR] Exception while
  persisting switch!
  2020-09-21 12:07:31.136+0200
  [BrocadeSwitchPostProcess-*.*.*.*]
  [Brocade_Switch_PostProcess.process] [ERROR] Encountered error
  while parsing output file.
  com.ibm.tpc.discovery.interfaces.DiscoveryException:
  com.ibm.tpc.common.api.TPCException: BTAFM0722E Error occurred
  while processing information for port
  ***/***.
  com.ibm.tpc.discovery.interfaces.DiscoveryException:
  com.ibm.tpc.discovery.interfaces.DiscoveryException:
  com.ibm.tpc.common.api.TPCException: BTAFM0722E Error occurred
  while processing information for port ***.***.
   at com.ibm.tpc.d
  isk.discovery.Brocade_Switch_PostProcess.parse(Brocade_Switch_Po
  stProcess.java:253)
   at com.ibm.tpc.disk.discovery.Brocade_Switc
  h_PostProcess.process(Brocade_Switch_PostProcess.java:408)
  Cause
  d by: com.ibm.tpc.discovery.interfaces.DiscoveryException:
  com.ibm.tpc.common.api.TPCException: BTAFM0722E Error occurred
  while processing information for port ***.***
   at com.ibm.tpc.di
  sk.discovery.Brocade_Switch_PostProcess.parse(Brocade_Switch_Pos
  tProcess.java:237)
  2020-09-21 12:07:31.136+0200
  [BrocadeSwitchPostProcess-*.*.*.*]
  [Brocade_Switch_PostProcess.process] [LOG] BTADS0113E Error
  encountered while processing a probe job.
  com.ibm.tpc.discovery.interfaces.DiscoveryException:
  com.ibm.tpc.common.api.TPCException: BTAFM0722E Error occurred
  while processing information for port ***/***. 
  
  DB2 Version
  used for Server:DB2 v11.1.4041.600
  
  The defect is against
  component:
  Server/Manager build/release (TPC):5.4.0.0
  Agent
  build/release (TPC):Build ?20200805-1701?
  Server/Manager (OS):
  Windows 2016
  Agent(OS):  Brocade 8.2.1.c
  Problem as described
  by customer: Unable to start a probe / performance monitor for
  two Brocade DCX 8510-8 switches in SC.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Control users monitoring Brocade switches if    *
  * zones are not configured properly                            *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Spectrum Control users may be unable to start                *
  * a probe or performance monitor for Brocade                   *
  * DCX 8510-8 switches.                                         *
  *                                                              *
  * There is an NullPointer exception while processing           *
  * the output of a Brocade REST API probe.                      *
  *                                                              *
  * This issue was raised while persisting port                  *
  * information.  And may be triggered if the port name          *
  * is either too long (34 characters) or contains an            *
  * invalid character.                                           *
  *                                                              *
  * The errors appear consistent in the order of                 *
  * PROBE > Error while process information for                  *
  * PORT > java.lang.NullPointerException                        *
  * And due to this exception, the probes for Brocade            *
  * switch fail.                                                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• The fix for this APAR is targeted for the following release:
  
  IBM Spectrum Control 5.4.2   [ 5.4.3-IBM-SC ]
  
  ( release target 2Q 2021 / May )
  
  http://www.ibm.com/support/docview.wss?&uid=swg21320822
  
  The target dates for future releases do not represent a formal
  commitment by IBM. The dates are subject to change without
  notice.
  

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

  TPC

• Fixed component ID

  5608TPC00

Applicable component levels