IV38381: WATCHDOG PROCESS (KCAWD) NOT START IF CANDLEHOME IS A SUBSET OF KCAWD CANDLEHOME ALREADY RUNNING.

IBM Tivoli Monitoring 6.2.3 Fix Pack 5 (6.2.3-TIV-ITM-FP0005)
IBM Tivoli Monitoring 6.2.3 Fix Pack 4 (6.2.3-TIV-ITM-FP0004)

APAR status

• Closed as program error.

Error description

• Watchdog process (kcawd) does not start if CANDLEHOME path is a
  subset of a CANDLEHOME path where kcawd is already running on
  the system
  
  For example, kcawd already running under /opt/IBM/itm__11  then
  when kcawd is to be started in /opt/IBM/itm__1 it will think it
  is already running and not start it.
  

Local fix

Problem summary

• Watchdog process (kcawd) does not start if another Watchdog
  process is already running on the system with a value for
  CANDLEHOME which is a superset of the first.  For example, it
  determines that kcawd for CANDLEHOME=/opt/IBM/ITM_1 is already
  running if there is a kcawd already running with a
  CANDLEHOME=/opt/IBM/ITM_10, since the first CANDLEHOME name is a
  subset of the second value.  This can occur on the Monitoring
  Agent for Linux or UNIX.
  

Problem conclusion

• The code was incorrectly comparing the value for CANDLEHOME and
  the process command path for the kcawd process.   The code was
  changed to correctly compare the path names.
  
  
  The fix for this APAR is contained in the following maintenance
  packages:
  
    | fix pack | 6.2.3-TIV-ITM-FP0004
    | fix pack | 6.3.0-TIV-ITM-FP0002
  

Temporary fix

• Start the OS Agent (which starts the Watchdog kcawd process) on
  the CANDLEHOME which is the shorter name first.  For example if
  there are two CANDLEHOMEs, /opt/IBM/ITM_1 and /opt/IBM/ITM_10,
  start the OS agent under /opt/IBM/ITM_1 first.  Once the
  Watchdog process (kcawd) has started, then start the OS agent
  under the longer CANDLEHOME name.
  

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

  ITM AGENT LINUX

• Fixed component ID

  5724C04LN

Applicable component levels

• R623 PSY

     UP