Details
-
Improvement
-
Resolution: Fixed
-
Minor
-
None
-
None
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.