IV65679: NEW ZFS FIELDS

IBM Tivoli Monitoring: UNIX (R) OS Agent 6.2.3.3-TIV-ITM_UNIX-IF0010
IBM Tivoli Monitoring: Unix(R) OS Agent 6.3.0.3-TIV-ITM_UNIX-IF0003
IBM Tivoli Monitoring 6.3.0 Fix Pack 5 (6.3.0-TIV-ITM-FP0005)
IBM(R) Tivoli(R) Monitoring: UNIX(R) OS Agent 6.2.3.5-TIV-ITM_UNIX-IF0004

APAR status

• Closed as new function.

Error description

• New ZFS Fields, RFE 53836
  

Local fix

• n/a
  

Problem summary

• Add new fields to the UNIXDISK attribute group for ZFS
  properties and disable the use of libzfs.
  
  
  Add new fields to the UNIXDISK attribute group for the following
  ZFS properties:
  
  quota
  reservation
  refquota - available in zpool version 9 and higher
  refreservation - available in zpool version 9 and highe
  usedbydataset - available in zpool version 13 and highe
  usedbychildren - available in zpool version 13 and higher
  usedbysnapshots - available in zpool version 13 and higher
  usedbyrefreservation  - available in zpool version 13 and higher
  zfs_space_used - the space occupied by the dataset; It also
  contains the used space of other dataset occupying its space.
  zfs_space_used_percent that is the percentage of zfs_space_used
  on the size of the disk.  The size on disk is computed with the
  following algorithm:
  
  1) size = ZFS pool size
  2) if the quota is defined and it is less than ZFS pool size,
  then size = quota; the quota is also checked for all the parent
  datasets up to the root.
  3) if the refquota is defined and it is less than ZFS pool size
  and quotas, then
  size = refquota.
  
  A new environment variable KUX_USELIBZFS has been added that
  control the use of the libzfs.so to collect the ZFS metrics.
  Its default value is 0, setting it to 1 the agent uses the api
  of libzfs.so to collect the ZFS metrics; this can be useful
  when the command ZFS is not available.  Note: The zpool version
  is visible with the command: zpool upgrade -v
  
  See the APAR Conclusion for more details of each of the new
  attributes.
  

Problem conclusion

• Fix/Problem Conclusion: Ten new attributes added to the Unix
   Disk attribute group:
  
  1. ZFS Quota (KBytes)
     The ZFS property QUOTA that limits the amount of disk space
     that a dataset and its descendants can consume.
     Note: the value -1 indicates Not Available, -2 indicates Not
       Collected, 9,223,372,036,854,775,807 indicates
       Value_Exceeds_Maximum, and -9,223,372,036,854,775,808
       indicates  Value_Exceeds_Minimum.
  
  2. ZFS RefQuota (KBytes)
     The ZFS property REFQUOTA that sets the amount of disk space
     that a dataset can consume.
     Note: the value -1 indicates Not Available, -2 indicates Not
       Collected, 9,223,372,036,854,775,807 indicates
       Value_Exceeds_Maximum, and -9,223,372,036,854,775,808
       indicates Value_Exceeds_Minimum.
  
  3. ZFS Reservation (KBytes)
     The ZFS property RESERVATION that sets the amount of reserved
     space guaranteed to a dataset and its descendants.
     Note: the value -1 indicates Not Available, -2 indicates Not
       Collected, 9,223,372,036,854,775,807 indicates
       Value_Exceeds_Maximum, and -9,223,372,036,854,775,808
       indicates Value_Exceeds_Minimum.
  
  4. ZFS RefReservation (KBytes)
     The ZFS property REFRESERVATION that sets the amount of
     reserved space guaranteed to a dataset.
     Note: the value -1 indicates Not Available, -2 indicates Not
       Collected, 9,223,372,036,854,775,807 indicates
       Value_Exceeds_Maximum, and -9,223,372,036,854,775,808
       indicates Value_Exceeds_Minimum.
  
  5. ZFS Used by Dataset (KBytes)
     The ZFS property USEDBYDATASET that shows the amount of space
     used by a dataset.
     Note: the value -1 indicates Not Available, -2 indicates Not
       Collected, 9,223,372,036,854,775,807 indicates
       Value_Exceeds_Maximum, and -9,223,372,036,854,775,808
       indicates Value_Exceeds_Minimum.
  
  6. ZFS Used by Children (KBytes)
     The ZFS property USEDBYCHILDREN that shows the amount of
     space used by the children of a dataset.
     Note: the value -1 indicates Not Available, -2 indicates Not
       Collected, 9,223,372,036,854,775,807 indicates
       Value_Exceeds_Maximum, and -9,223,372,036,854,775,808
       indicates Value_Exceeds_Minimum.
  
  7. ZFS Used by Snapshots (KBytes)
     The ZFS property USEDBYSNAPSHOTS that shows the amount of
     space used by the snapshots of a dataset.
     Note: the value -1 indicates Not Available, -2 indicates Not
       Collected, 9,223,372,036,854,775,807 indicates
       Value_Exceeds_Maximum, and -9,223,372,036,854,775,808
       indicates Value_Exceeds_Minimum.
  
  8. ZFS Used by RefReservation\(KBytes)
     The ZFS property USEDBYREFRESERVATION that shows the amount
     of space guaranteed for a dataset.
     Note: the value -1 indicates Not Available, -2 indicates Not
       Collected, 9,223,372,036,854,775,807 indicates
       Value_Exceeds_Maximum, and -9,223,372,036,854,775,808
       indicates Value_Exceeds_Minimum.
  
  9. ZFS Space Used (KBytes)
     The amount of space used in the dataset total size, expressed
     in kilobytes and calculated as the difference between the
     size and the space available. Because space is shared within
     a pool, the total space used will include also the possible
     part of space used by other datasets in the dataset total
     size.
     Note: the value -1 indicates Not Available, -2 indicates Not
       Collected, 9,223,372,036,854,775,807 indicates
       Value_Exceeds_Maximum, and -9,223,372,036,854,775,808
       indicates Value_Exceeds_Minimum.
  
  10. ZFS Space Used Percent
      The complementary of Space Available Percent, it is
      calculated as 100 - Space Available Percent. In this
      percentage all the busy space is considered, even if this
      space is not all used by this specific dataset.
      Valid entries are whole numbers up to 100, such as 65 for
      65%.
      Note: the value -1 indicates Not Available and -2 indicates
        Not Collected.
  
  
  The fix for this APAR is included in the following maintenance
  vehicle:
  
     | interim fix | 6.2.3.3-TIV-ITM_UNIX-IF0010 |
     | interim fix | 6.2.3.5-TIV-ITM_UNIX-IF0004 |
     | fix pack | 6.3.0-TIV-ITM-FP0005 |
  
  Note: Search the IBM technical support web site for maintenance
  package availability.
  

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

• R630 PSY

     UP