IV01794: KFW_TOPOLOGY_CLUSTER_LIST BEING MIS-READ FROM CQ.INI

IBM Tivoli Monitoring 6.2.2 Fix Pack 8 (6.2.2-TIV-ITM-FP0008)
IBM Tivoli Monitoring 6.2.2 Fix Pack 9 (6.2.2-TIV-ITM-FP0009)
IBM Tivoli Monitoring 6.2.2 Fix Pack 6 (6.2.2-TIV-ITM-FP0006)

APAR status

• Closed as program error.

Error description

• Environment:
  
    ITM 622 FP4.
  Problem Description:
    After installing 6.2.2 FP4, the KFW_TOPOLOGY_CLUSTER_LIST
    parameter in cq.ini is not read/parsed correctly.
  
    KFW_TOPOLOGY_CLUSTER_LIST parameter shown in the cq.ini.
  KFW_TOPOLOGY_CLUSTER_LIST=%CHOP.K31 %CHOP.LAWAV %CHOP.K32
  %CHOP.K01
  %BMedora.KP7
  
  KfwServices4dd13c89-01.log shows:
  (4DD13CFE.0002-1:kbbssge.c,52,"BSS1_GetEnv")
  KFW_TOPOLOGY_CLUSTER_LIST="
     "
  (4 spaces)
  It appears it is only picking up the spaces between the entries.
  
  Analysis and Steps to Reproduce:
  At 6.2.2 FP2, the following set in cq.ini
  and it worked fine:
  
  KFW_TOPOLOGY_CLUSTER_LIST=%CHOP.K31 %CHOP.LAWAV %CHOP.K32
  %CHOP.K01
  %BMedora.KP7
  
  The cq.config got updated correctly, and the TEPS logs showed
  the proper
  value:
  
  (4DD15AF5.0073-1:kbbssge.c,52,"BSS1_GetEnv")
  KFW_TOPOLOGY_CLUSTER_LIST="%CHOP.K31 %CHOP.LAWAV %CHOP.K32
  %CHOP.K01
  %BMedora.KP7"
  
  Next, upgrade to to 6.2.2 FP4.  After restarting
  the TEPS, it does not
  read the KFW_TOPOLOGY_CLUSTER_LIST value correctly, and the logs
  show:
  
  (4DDB381F.0073-1:kbbssge.c,52,"BSS1_GetEnv")
  KFW_TOPOLOGY_CLUSTER_LIST="
      "
  Note that there are four spaces there; it seems like it's not
  handling
  the values correctly, and is leaving just the four spaces from
  the
  original value instead.  The consequence as stated by the
  customer is
  that there is "...Confusion for TEP users navigating to
  clustered
  Agents. Un-needed navigator update traffic when clustered agents
  are
  moved/restarted between cluster nodes."
  

Local fix

• The following work-around was suggested which was tested
  successfully
  internally.
  
  1) Edit the cq.ini file.
  
  2) Change the KBB_VARPREFIX and KBB_RAS1_LOG lines from
  
  KBB_VARPREFIX=%
  KBB_RAS1_LOG=%(CTIRA_LOG_PATH)/$RUNNINGHOSTNAME$_$PRODUCTCODE$_%
  (systask
  )_%(sysutcstart)-.log
  INVENTORY=%(CTIRA_LOG_PATH)/$RUNNINGHOSTNAME$_$PRO
  DUCTCODE$_%(systask).inv COUNT=03 LIMIT=5 PRESERVE=1 MAXFILES=9
  
  to
  
  KBB_VARPREFIX=^
  KBB_RAS1_LOG=^(CTIRA_LOG_PATH)/$RUNNINGHOSTNAME$_$PRODUCTCODE$_^
  (systask
  )_^(sysutcstart)-.log
  INVENTORY=^(CTIRA_LOG_PATH)/$RUNNINGHOSTNAME$_$PRO
  DUCTCODE$_^(systask).inv COUNT=03 LIMIT=5 PRESERVE=1 MAXFILES=9
  
  3) Do not modify the KFW_TOPOLOGY_CLUSTER_LIST line
  4) Save the cq.ini file and restart the Portal Server.
  

Problem summary

• KFW_TOPOLOGY_CLUSTER_LIST is mis-read from cq.ini after
  ITM622FP4
  
  In 6.2.2 FP4, 'KBB_VARPREFIX' was changed to '%' which resulted
  in a problem reading KFW_TOPOLOGY_CLUSTER_LIST.
  'KFW_TOPOLOGY_CLUSTER_LIST' is defined with '%' and it's
  mis-read after FP4.
  Below is an example of KFW_TOPOLOGY_CLUSTER_LIST
  
  KFW_TOPOLOGY_CLUSTER_LIST=%CHOP.K31 %CHOP.LAWAV %CHOP.K32
  %CHOP.K01  %BMedora.KP7
  
  The cq.config got updated correctly, and the portal server logs
  showed the proper value in ITM622 FP2:
  KFW_TOPOLOGY_CLUSTER_LIST="%CHOP.K31 %CHOP.LAWAV %CHOP.K32
  %CHOP.K01 %BMedora.KP7"
  
  However after 6.2.2 FP4, it does not read the
  KFW_TOPOLOGY_CLUSTER_LIST value correctly, and the logs show:
  
  KFW_TOPOLOGY_CLUSTER_LIST="      "
  

Problem conclusion

• Changed the 'KBB_VARPREFIX' value from '%' to '^' since '%' is
  used to define KFW_TOPOLOGY_CLUSTER_LIST.
  
  The fix for this APAR is contained in the following maintenance
  packages:
  
    | fix pack | 6.2.2-TIV-ITM-FP0006
  

Temporary fix

• Change the KBB_VARPREFIX and KBB_RAS1_LOG lines from
  KBB_VARPREFIX=%
  KBB_RAS1_LOG=%(CTIRA_LOG_PATH)/$RUNNINGHOSTNAME$_$PRODUCTCODE$_%
  (systask)_%(sysutcstart)-.log
  INVENTORY=%(CTIRA_LOG_PATH)/$RUNNINGHOSTNAME$_$PRODUCTCODE$_%(sy
  stask).inv COUNT=03 LIMIT=5 PRESERVE=1 MAXFILES=9
  to
  KBB_VARPREFIX=^
  KBB_RAS1_LOG=^(CTIRA_LOG_PATH)/$RUNNINGHOSTNAME$_$PRODUCTCODE$_^
  (systask)_^(sysutcstart)-.log
  INVENTORY=^(CTIRA_LOG_PATH)/$RUNNINGHOSTNAME$_$PRODUCTCODE$_^(sy
  stask).inv COUNT=03 LIMIT=5 PRESERVE=1 MAXFILES=9
  
  Do not modify the KFW_TOPOLOGY_CLUSTER_LIST line.
  

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

  TEPS

• Fixed component ID

  5724C04PS

Applicable component levels

• R622 PSY

     UP