Add read-only HMC LIC firmware inventory diagnostics

Open
  • Is something wrong?
#3,540 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
38/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
python

Research direction

Start with the HMC driver after blockers #1817, #1822, and #1824 land, then read the capability limits in docs/design/m4-byo-host.md:168-174 and resource enumeration in src/kdive/domain/catalog/resources.py:17-22. Implement the fixed read-only LIC selectors with bounded output, structured parsing, and redaction; test selector restrictions, level differences, unknown and error cases, truncation, and redaction. Done means reporting installed, activated, and accepted levels with provenance while keeping unsupported or unavailable data explicit and performing no firmware mutation.

Written by the indexing model from the issue text.

Description

area:control-retrieve effort:S priority:P2 provider:powervm status:blocked type:feature

Problem

The PowerVM diagnostic path lacks read-only LIC firmware inventory metadata needed to describe the environment when comparing failures. OpenPower-only firmware selectors must not be treated as universal PowerVM support.

Part of #1814. Follow-up to the capability survey in #1816, explicitly approved for filing and campaign enqueueing. Hardware operations remain held.

Blocked by #1817
Blocked by #1822
Blocked by #1824

Evidence

  • docs/design/m4-byo-host.md:168-174 limits OOB widening to surveyed capabilities with a named caller. The BYO doctor report (#1824) is the caller for this contribution.

  • src/kdive/domain/catalog/resources.py:17-22 currently enumerates local, fault-injection, and remote-libvirt resources; the BYO skeleton and HMC driver are prerequisites, rather than an existing implemented HMC capability.

  • IBM documents lslic -t sys, io, and sriov, including installed, activated, and accepted levels; BMC/PNOR selectors have platform restrictions: https://www.ibm.com/docs/en/power11/9824-22A?topic=commands-lslic . This is documented command support, not a hardware proof.

Expected

The BYO doctor contribution reports available installed, activated, and accepted firmware levels with selector/platform/version provenance. Unsupported and unavailable data remain explicit. The path performs no firmware update or activation.

Proposed approach

Extend the existing HMC driver after its prerequisite lands with fixed read-only LIC inventory selectors, bounded duration/output, structured parsing, deterministic redaction, and diagnostic artifact references. Test supported selector construction, platform restrictions, differing levels, unknown fields, empty/error/truncation paths, and redaction. Document reporting limits. Keep this one inventory contribution in one PR; no firmware mutation, automatic compatibility or allocation veto, arbitrary command runner, new public MCP tool, or hardware operation is authorized by this tracking issue.

Dominant language
Python
Stars
0
Forks
0
Avg merge
9h 13m
Merged PRs (30d)
197

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from randomparity/kdive

All issues in randomparity/kdive

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.