IV73792: OS AGENT CRASHES IF <USER> STANZA MISSING IN KCIRUNAS.CFG FLIE

IBM Tivoli Monitoring 6.3.0 Fix Pack 6 (6.3.0-TIV-ITM-FP0006)

APAR status

• Closed as program error.

Error description

• The Monitoring Agent for Linux OS terminates shortly after
  startup if the kcirunas.cfg has been updated for an agent that
  Watchdog is monitoring and is missing the <user>stanza for an
  instance.
  
  Recreate steps:
  1.  Have Watchdog monitor a non-OS agent (such as MQ agent).
  
  2.  Update the kcirunas.cfg file, with no <user> </user> stanza
  for an instance.
    <productCode>mq</productCode>
             <instance>
                   <name>None</name>
                   <autoStart>no</autoStart>
             </instance>
             <instance>
                   <name>QAA2438R1</name>
                   <user>mocandle</user>
             </instance>
  
  3.  Watchdog reads the kcirunas.cfg to see if an agent should be
  restarted with a different userid if it needs to be restarted.
  

Local fix

• 1. Add the <user> stanza in kcirunas.cfg file, for example:
    <instance>
         <name>None</name>
         <user>mquser</user>
         <autoStart>no</autoStart>
    </instance>
    <instance>
         <name>QAA2438R1</name>
         <user>mocandle</user>
    </instance>
  
  2. Start the agent.
  
  Related Files and Output:
  None.
  

Problem summary

• The Monitoring Agent for Linux OS terminates shortly after
  startup if the kcirunas.cfg has been updated for an agent that
  Watchdog is monitoring and is missing the <user> stanza for an
  instance.
  
  For example, the <user> stanza is missing the from the Instance
  "None" below:
  
  <productCode>mq</productCode>
  <instance>
  <name>None</name>
  <autoStart>no</autoStart>
  </instance>
  <instance>
  <name>QAA2438R1</name>
  <user>mocandle</user>
  </instance>
  

Problem conclusion

• Code has been added to handle the condition when the stanza for
  an instance is missing.
  
  The fix for this APAR is contained in the following maintenance
  packages:
  
    | fix pack | 6.3.0-TIV-ITM-FP0006
  

Temporary fix

• Add the <user> stanza in kcirunas.cfg file, for example:
  
  <instance>
    <name>None</name>;
    <user>mquser</user>      <== add this line
    <autoStart>no</autoStart>
  </instance>
  <instance>
    <name>QAA2438RT</name>
    <user>mocandle</user>
  </instance>
  

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

• R630 PSY

     UP