Fixes are available
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 number
IV01794
Reported component name
TEPS
Reported component ID
5724C04PS
Reported release
622
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2011-06-14
Closed date
2011-07-12
Last modified date
2012-01-05
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
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSCTLMQ","label":"ITM Tivoli Enterprise Portal Server V6"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"622","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
05 January 2012