Skip to content

feat(ipmctl): add pinned Debian 13 source installer - #1

Merged
climateamante merged 1 commit into
mainfrom
feature/ipmctl
Aug 2, 2026
Merged

climateamante merged 1 commit into
mainfrom
feature/ipmctl

Conversation

@climateamante

@climateamante climateamante commented Aug 1, 2026 •

Copy link
Copy Markdown
Contributor

Purpose

Install Intel's final ipmctl CLI on stock Debian 13 Trixie for Intel Optane Persistent Memory, including PMem 200, without making GitHub Actions maintain archived C and EDK2 source one compiler warning at a time.

Debian 13 does not provide an ipmctl package. Intel archived upstream and does not promise further fixes or releases. This repository therefore owns one explicit downstream build policy: a pinned target-host source build, a finite compatibility pack, and read-only verification.

The prior five-commit implementation was replaced in place by the reviewed one-commit candidate f2b4122. Draft PR #2 served only as a safe review vehicle for that replacement and is superseded by this PR.

Exact source policy

  • ipmctl tag v03.00.00.0538
    • commit a71f2fb1c90dd07f9862b71c789881132193e8f9
    • required installed version 03.00.00.0538
  • EDK2 tag edk2-stable202511
    • commit 46548b1adac82211d8d11da12dd914f41e7aa775
  • Debian 13 amd64
  • stock /usr/bin/cmake, Release build, two jobs
  • install prefix /usr/local

The finite meta-intel-derived compatibility pack contains:

  1. EDK2 host OS/unit-test guards, regenerated as an exact binary Git delta to preserve the pinned CRLF Base.h blob: ac6f0ea143c357c582135472defe8e936a63d7997221a29d4d0e4c349d7ac013.
  2. Removal of -Werror from C Release flags while retaining C++ Release -Werror: d1928dc874219578abbc9eab5cc7a826ccf88457bd148f268aff367d134321b8.
  3. Removal of executable-only -pie from shared-library linker flags: f926a6b07ad33b09f09032e6fd06a9229855d9d0501cfc7e67ecbb4c3c28a031.

Every patch is vendored with provenance and checked for checksum, sole target, exact preimage, strict applicability, reverse applicability, exact postimage, and a clean Git diff. The installer does not invoke patch_OS.sh or updateedk.sh, use permissive patch flags, discover patches online, or add warning-specific source repairs.

Published interface

After merge and successful www deployment, the PMem server needs no repository clone:

wget -qO /tmp/devs-guide-ipmctl.sh \
  https://devs-guide.github.io/debian/setup/cli/ipmctl.sh

bash /tmp/devs-guide-ipmctl.sh install
bash /tmp/devs-guide-ipmctl.sh verify

install stages the published Ansible files, installs only the opt-in build dependency group, fetches exact tags, builds as the invoking user under ~/.cache/devs-guide/ipmctl, and uses privilege only for packages, CMake installation, ldconfig, and the receipt under /var/lib/devs-guide/ipmctl.

verify requires exact version and complete linkage, then independently reports DIMMs, topology, memory resources, and current/pending goal output. Exit 1 is software failure; exit 2 means the software installed but hardware output still requires human review.

The wrapper never creates or deletes goals, changes firmware or security state, formats DIMMs, manages namespaces, or reboots. The installed CLI itself remains powerful; destructive commands are manual, out of scope, and require separate review.

Simplification and publication policy

  • Removes hosted ipmctl compilation and source-network verification.
  • Removes goal mutation, inventory normalization, the large ipmctl facts schema, compatibility matrix, helpers, and fixture corpus.
  • Reduces the public interface to install and verify.
  • Changes LLM-host requirements to live version/Memory Mode evidence with diagnostic goal output.
  • Pull requests run static contracts and assemble the Pages artifact without deployment.
  • Only a successful push to main receives contents: write and deploys www.

This PR intentionally uses publish first, then validate on the real PMem server so the target can consume one reviewed Pages entrypoint without cloning Git. GitHub validation proves repository and publication integrity; it does not prove archived source compilation or PMem hardware readiness.

Acceptance

Before merge:

  • Refreshed validate-runtime passes.
  • Refreshed build-www passes.
  • deploy-www is skipped for the pull request.
  • Human review accepts the publish-before-hardware-validation order.

After merge:

  • The main workflow validates, builds, and deploys www successfully.
  • Published runner/playbook/patch files match the merged source.
  • The intended Debian 13 amd64 PMem-200 server runs the published installer.
  • /usr/local/bin/ipmctl version reports exactly 03.00.00.0538.
  • ldd /usr/local/bin/ipmctl has no unresolved entry.
  • Receipt and CMake install manifest contain the reviewed provenance.
  • All four read-only probe outputs are retained and accepted by a human reviewer.
  • A second install validates receipt/binary/version/linkage, skips rebuilding, and repeats verification.
  • Hardware/BIOS/DIMM-layout readiness is judged independently from successful compilation.

If target-host installation fails, preserve its logs and submit an evidence-backed follow-up from feature/ipmctl; do not rewrite main or rerun blindly.

@climateamante
climateamante marked this pull request as draft August 2, 2026 05:22
@climateamante climateamante changed the title fix(ipmctl): ship reviewed Debian 13 PMem source build feat(ipmctl): add pinned Debian 13 source installer Aug 2, 2026
@climateamante

Copy link
Copy Markdown
Contributor Author

Canonical pre-merge checkpoint for f2b4122: refreshed validate-runtime passed, refreshed build-www passed, and deploy-www skipped by pull-request policy in workflow run 30734028207. Human approval accepted the publish-first remote-validation order.

@climateamante
climateamante marked this pull request as ready for review August 2, 2026 05:27
@climateamante
climateamante merged commit 59964bd into main Aug 2, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant