IV16778: ALLOW MEMORYTHRESHOLD TO USE VMRSS INSTEAD OF VMSIZE.

IBM Tivoli Monitoring 6.2.2 Fix Pack 9 (6.2.2-TIV-ITM-FP0009)

APAR status

• Closed as program error.

Error description

• The Watchdog code which is part of the OS agent
  can monitor one or more agents and if they are not running will
  restart
  them.  The Watchdog code also allows a memoryThreshold value to
  optionally be set and when set will restart the agent if the
  memory used
  by the agent being monitored exceeds the threshold.  The value
  of the
  memory is obtained from the operating system, currently it uses
  VMSize
  (virtual memory).  In some environments the virtual memory and
  physical
  memory used by a process are very different.  Allow the option
  to have
  the memoryThreshold use VmRSS (physical memory).
  

Local fix

Problem summary

• Allow the Watchdog process to set a physical memory threshold
  rather than virtual memory for the Linux OS agents.
  
  The Watchdog process is the part of the OS agent that ensures
  the agent is running. This process also can monitor the memory
  growth of the OS agent and will restart it if the memory usage
  exceeds a user-defined threshold. The value for memory usage is
  obtained from the operating system, currently as virtual memory.
  In some environments, virtual memory and physical memory used by
  a process are very different. There is a need to provide an
  option to monitor physical memory instead of virtual memory for
  the OS agent process.
  
  For this APAR fix to be effective, a new environment variable
  has been added. See the Install Actions section of the APAR
  conclusion for more details.
  

Problem conclusion

• A new environment variable KCA_USE_VMRSS allows the user to
  monitor the Linux OS agent physical memory instead of virtual
  memory.  If this variable is not set to "true", virtual memory
  will continue to be used.
  
  Install Actions:
  
  Set KCA_USE_VMRSS to "true" in the lz.ini file for the physical
  memory value to be used instead of virtual memory, and restart
  the agent.
      KCA_USE_VMRSS=true
  
  
  
  The fix for this APAR is contained in the following maintenance
  packages:
  
    | fix pack | 6.2.2-TIV-ITM-FP0009
    | fix pack | 6.2.3-TIV-ITM-FP0002
  

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

  ITM AGENT LINUX

• Fixed component ID

  5724C04LN

Applicable component levels

• R622 PSY

     UP