Uploaded image for project: 'Observium'
  1. Observium
  2. OBS-5324

IBM i (Power): CPU, hardware model/version and hrDevice hardware status

    XMLWordPrintable

Details

    • Improvement
    • Resolution: Fixed
    • Minor
    • None
    • None
    • Discovery, OS, Poller

    Description

      Summary

      Extends the ibmi OS (IBM i on IBM Power): CPU utilisation, hardware model and OS version, and a status entity for every hardware resource (disk units/LUNs, IOAs, tape, optical, communication ports, processors). Before this, IBM i devices only showed generic HOST-RESOURCES data, with no version, no hardware, and no way to alert on a failed disk unit.

      Patch: 03-ibm-i.patch (attached). Apply from the Observium root with patch -p1 < 03-ibm-i.patch. It was built against trunk SVN BASE and applies cleanly.

      What it adds

      • CPU: processor from ibmiSystemCpuUtil (.1.3.6.1.4.1.2.6.4.5.1.0, in hundredths of a percent).
      • Version: parsed from sysDescr (for example V7R5M0).
      • Hardware: IBM i exposes no system model or serial scalar over SNMP. The main card enclosure (hrDeviceID.1) encodes <type><model><resource> as ASCII OID sub-identifiers under .1.3.6.1.4.1.2.9.1. This is decoded to machine type-model (for example 9105-22A) and mapped to a marketing name for Power9 and Power10 systems (for example Power S1022 (9105-22A)). Unknown type-models are shown raw.
      • Hardware status: hrDeviceStatus for every hrDevice, classified by hrDeviceType. The states are registered under the HOST-RESOURCES-MIB hrDeviceStatus type, so the normal status poller walks the table. A failed or degraded disk unit or IOA can then be alerted on.

      Files

      File Status Purpose
      includes/definitions/os/ibm.inc.php changed ibmi: version sysDescr_regex, MIBs, graphs
      includes/definitions/mibs/ibmi.inc.php new IBM-I-SYSTEM-MIB definition (processor)
      includes/discovery/status/ibm-i-system-mib.inc.php new hrDeviceStatus status entities, classified by device type
      includes/polling/os/ibmi.inc.php new Hardware type-model decoding and Power model names
      mibs/ibmi/IBM-I-SYSTEM-MIB new Minimal hand-written MIB (see note)

      Notes for maintainers

      • IBM-I-SYSTEM-MIB is hand-written. IBM doesn't publish a MIB file for these objects, so it only contains the objects verified against an IBM i 7.5 agent (currently just ibmiSystemCpuUtil).
      • Localised descriptions. hrDeviceDescr follows the system language/CCSID. On non-English systems accented characters can come through mangled (for example "Unit{ disco" for "Unità disco"). This is cosmetic only, and the descriptions are used as-is.
      • The Power model table only covers Power9 and Power10; it is easy to extend.

      Testing

      • Power10 system running IBM i 7.5. Disks are external FlashSystem LUNs, plus internal IOAs, tape, optical and communication resources.
      • php -l clean.

      Attachments

        Activity

          People

            landy Mike Stupalov
            rebeluca Luca Rebellato
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: