BKR-UPDATE-INVENTORY(1)

📦
version 29.2 · 3 versions
, in epel 9

🌸 NAME 🌸

okay bestie, this is the BKR-UPDATE-INVENTORY(1) page — the command is bkr-update-inventory, and it submits a inventory job for the system 💅✨

✨ SYNOPSIS ✨

bkr update-inventory [options]
  [--xml | --pretty-xml]
  [--dry-run | --wait]
  [<fqdn>...]

🦋 DESCRIPTION 🦋

So what's the vibe? It submits a job to scan the given system and update its hardware details recorded in Beaker 🫶. The Beaker server will automatically select the most suitable distro tree based on the system's architecture and the availability of the distro trees — iconic auto-picking behavior, honestly.

If you want to customize the distro selection or add other tasks to the job, use bkr machine-test --inventory instead. That command supports the complete set of workflow options for customizing your job, so it's giving full-control main character energy 👑.

Common bkr options are described in the Options section of bkr(1) — go check that bestie for the generic stuff.

New in version 21 🌟.

💖 OPTIONS 💖

  • --xml — Print the generated Job XML that was submitted. Use this with --dry-run if you just want to see what would be submitted. Perfect for the "show me the receipts" vibe 🧾✨
  • --pretty-xml — Pretty print the generated Job XML that was submitted. Use this with --dry-run if you just want to see what would be submitted. Fancy formatting only, no cap 💅
  • --dry-run — Do not submit the job(s) to Beaker. Use this with --xml or --pretty-xml to see what would be submitted. Preview-only mode, bestie 🙈
  • --wait — Watch the newly submitted jobs for state changes and print them to stdout. The command will not exit until all submitted jobs have finished. See bkr-job-watch(1) for the watch-y details 👀💜

🔥 EXIT STATUS 🔥

1 if any jobs failed submission or execution (when --wait is used), otherwise zero. That's the whole mood: failed submission or execution with --wait gives 1, everything else gives zero 💀✅

🌈 EXAMPLES 🌈

Submit an inventory job for test1.example.com:

bkr update-inventory test1.example.com

Do not submit an inventory job, but just pretty print the generated job XML:

bkr update-inventory --dry-run --pretty-xml test1.example.com

🎀 SEE ALSO 🎀

bkr(1), bkr-machine-test(1), — go read those if you want the full lore 🌸

👑 AUTHOR 👑

The Beaker team <beaker-devel@lists.fedorahosted.org> 💌

2013-2025 Red Hat, Inc.

okay that's the whole page, bestie — source/version 29.2, dated May 26, 2025, signing off with fairy dust 🧚✨💖

📦 where this page comes from