IV37296: HP SWAP BASE CALCULATION INCLUDES RESERVED AND MEMORY

APAR status

• Closed as program error.

Error description

• Agent uses a formula to calculate swap space on HP-UX systems
  that includes the reserve and memory values.
  
  EG:
  If he uses "swapinfo -ta" on a HP-UX testsystem the result is as
  follows:
  
  root# swapinfo -ta
  
  TYPE      AVAIL    USED    FREE  USED   LIMIT RESERVE  PRI  NAME
  dev     4194304   49956 4144348    1%       0       -    1
  /dev/vg00/lvol2
  reserve       - 3477012 -3477012
  memory  3224844 1315712 1909132   41%
  total   7419148 4842680 2576468   65%
  
  ITM reports 65% pct swap space used - But if we do not take care
  of
  reserve and memory there is only 1% used.
  
  The values of Percent Swap Space Used are those expected and
  documented.
  It is based on Total Swap Space (MB) that for HP-UX includes any
  part of memory available for the system.
  Is could be useful for this customer and probably others to have
  a Percent Swap Space Used that does not includes memory and
  reserve values, we are going to provide an algorithm change
  triggered by an environment variable.
  It this way the metrics Percent Swap Space Used will be based
  only on the sum of all swap spaces excluding memory.
  
  EG: in the case above, Percent Swap Space Used will report 1%
  instead of 65% as the customer would like to have.
  
  Detailed Recreation Procedure:
  Collect Percent Swap Space Used on an HP-UX before the fix and
  compare with "swapinfo -ta"
  And Collect Percent Swap Space Used on an HP-UX after the fix
  with the environment variable disabled and compare with
  "swapinfo -ta"
  
  Related Files and Output:
  add this to common unix os agent trace settings:(UNIT:kux14agt
  ALL) in order to trace sampled values for swap
  

Local fix

• N/A
  

Problem summary

• Percent of Total Swap Space includes reserve and memory usage on
  HP-UX systems.
  
  
  On HP-UX, the Monitoring Agent for UNIX OS calculates the
  percent Total Swap Space including the percent reserve and
  memory usage values. By including the percent memory and reserve
  usage values in the calculation of percent Total Swap Space
  usage it is possible to derive a Swap Space usage value that can
  be twenty-four percent higher than the device Swap Space value.
  
  In the following example, the agent determined that the percent
  Total Swap Space used is sixty-five (65) percent for the system.
  This calculated value matches the 'total' value returned to the
  user if one were to execute the swapinfo command on that system.
  root# swapinfo -ta
  
  TYPE      AVAIL    USED    FREE  USED   LIMIT RESERVE  PRI  NAME
  dev     4194304   49956 4144348    1%       0       -    1
  /dev/vg00/lvol2
  reserve       - 3477012 -3477012
  memory  3224844 1315712 1909132   41%
  total   7419148 4842680 2576468   65%
  
  
  In order for this APAR to be properly implemented in your
  environment, a new environment variable has been added.  See the
  "Install Actions" section of the APAR conclusion for more
  details.
  

Problem conclusion

• Install Actions
  
  The environment variable KUX_HP_SWAP_COUNTER_WITHOUT_MEMORY now
  exists as a configuration parameter for the Monitoring Agent for
  UNIX OS. When the environment variable is assigned a value of
  TRUE (KUX_HP_SWAP_COUNTER_WITHOUT_MEMORY=TRUE), the Swap Space
  counters will exclude the reserve and memory values for HP-UX
  Operating Systems only.
  
  
  The fix for this APAR is going to be included in the following
  maintenance vehicle:
      | fix pack | 6.2.3-TIV-ITM-FP0004
  

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 UNIX

• Fixed component ID

  5724C040U

Applicable component levels

• R623 PSY

     UP