IJ36972: XX.ENVIRONMENT FILES CONTAINING MULTIPLE = AFTER THE EXPORT ARE BROKEN AFTER INSTALLING SP9

IBM Tivoli Monitoring 6.3.0 Fix Pack 7 Service Pack 10 (6.3.0.7-TIV-ITM-SP0010)

APAR status

• Closed as program error.

Error description

• On Non Windows platforms, XX.environment files containing
  multiple = after the export are broken after installing SP9
  This causes the itmcmd agent/server command to fail to stop or
  start the component with the XX.environment file containing an
  entry with multiple = on a single line.
  
  RECREATE INSTRUCTIONS:
  1) Install the 6.3.0.7 TEMS.
  2) Apply any SP less than SP9
  3) Configure the TEMS
  4) Create the file <CANDLEHOME>/config/ms.environment
  5) Add the following line to ms.environment
  KBB_RAS1=$KBB_RAS1 (UNIT:kshdsr,entry:'login'
  DET)(UNIT:kshdsr,entry:'create'
  STATE)(UNIT:kshdhtp,Entry='getHeaderValue'
  all)(UNIT:kshprs,Entry:'WSQL_ParsePostRequest'
  ALL)(UNIT:kpxreqi,Entry:'checkForStaleBinding' NONE)
  6) Start the TEMS
  7) NOTICE: It starts successfully.
  8) Stop the TEMS
  9) NOTICE: It stops successfully.
  10) Apply SP9
  11) Start the TEMS
  12) ERROR: It fails to start.
  13) Review the <CANDLEHOME>/logs/ms.env file
  14) ERROR: the KBB_RAS1 variable shows an empty value.
  

Local fix

• 1) Make a backup copy of <CANDLEHOME>/bin/sourceEnv.sh
  
  2) Modify <CANDLEHOME>/bin/sourceEnv.sh
  
  3) Locate the line with the following text:
   sourceEnv_sed="${sourceEnv_sed};s/\(^export.*\)=\(.*\)/\1=\"\2
  \"/";
  
  4) Replace the line with the following text:
   sourceEnv_sed="${sourceEnv_sed};s/\(^export[^=]*\)=\(.*\)/\1=\
  "\2\"/";
  5) Save <CANDLEHOME>/bin/sourceEnv.sh
  

Problem summary

• On Non Windows platforms, XX.environment files containing
  multiple = after the export are broken after installing SP9
  This causes the itmcmd agent/server command to fail to stop or
  start the component with the XX.environment file containing an
  entry with multiple = on a single line.
  

Problem conclusion

• The script sourceEnv.sh has been changed to fix the problem.
  
  The fix for this APAR is contained in the following maintenance
  packages:
  
     | service pack | 6.3.0.7-TIV-ITM-SP0010
  

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

  OMEG DIST INSTA

• Fixed component ID

  5608A41CI

Applicable component levels