IJ37913: XX.ENVIRONMENT FILES CONTAINING SPACES IN THE VALUES AFTER = ARE BROKEN ON SOLARIS AFTER INSTALLING SP9

IBM Tivoli Monitoring 6.3.0 Fix Pack 7 Service Pack 12 (6.3.0.7-TIV-ITM-SP0012)

APAR status

• Closed as program error.

Error description

• On Solaris platform, XX.environment files containing spaces in
  the value after the = 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 spaces in the value.
  
  RECREATE INSTRUCTIONS:
  1) Install the 6.3.0.7 OS agent.
  2) Apply any SP less than SP9.
  3) Configure the OS agent.
  4) Create the file <CANDLEHOME>/config/ux.environment.
  5) Add the following line to ux.environment:
  KDC_FAMILIES=EPHEMERAL:Y HTTP_SERVER:N ${KDC_FAMILIES}
  6) Start the OS agent.
  7) NOTICE: It starts successfully.
  8) Stop the OS agent.
  9) NOTICE: It stops successfully.
  10) Apply SP9.
  11) Start the OS agent.
  12) ERROR: It fails to start with messages like the following:
  Processing. Please wait...
  Starting Monitoring Agent for UNIX OS ...
  KCIIN0521E ...Error encountered during product startup.
  ...Please check log file, if one exists, and env.config, ux.ini
  or ux.environment if it exists in /opt/IBM/ITM/config for
  possible errors.
  KCIIN0198E Unable to start agent. Please, check log file.
  13) Review the <CANDLEHOME>/logs/ux.env file.
  14) ERROR: The file contains only a line like the following:
  /opt/IBM/ITM/config/ux.sh[6]: .[51]: .[63]: .[1]: export:
  HTTP_SERVER:N: is not an identifier
  

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:
   \(^export
  4) Replace the line with the following text:
   sourceEnv_sed="${sourceEnv_sed};s/^\(export[^=]*\)=\(.*\)/\1=\
  "\2\"/";
  5) Save <CANDLEHOME>/bin/sourceEnv.sh
  

Problem summary

• XX.environment files containing spaces in the values after = are
   broken on Solaris after installing SP9
  
  
  On Solaris platform, XX.environment files containing spaces in
  the value after the = 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 spaces in the value.
  

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-SP0012
  

Temporary 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:
  `  \(^export`
  4) Replace the line with the following text:
  `
  sourceEnv_sed="${sourceEnv_sed};s/^\(export[^=]\)=\(.\)/\1=\"\2\
  "/";`
  5) Save <CANDLEHOME>/bin/sourceEnv.sh
  

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