The current command for doing a hardware scan on a system is "bkr machine-test --inventory --ignore-system-status --machine <FQDN> --family <distro>"
This RFE proposes simplifying that to "bkr update-inventory --machine <FQDN> --family <distro>"
The dedicated command should make this capability more discoverable, as well as making it easier to inventory Manual systems (since it will use the new "force" option by default)
The guidance in other parts of the docs (e.g. adding a new system) should also be updated to reference the new command.
This would be a good candidate for a 19.x maintenance release.
For bug 1121462 we are adding a one-click "run inventory job" button to the system page, which will let the server figure out the most optimal distro to use (currently the rules for picking the distro are complicated due to smolt vs. lshw).
So I think bkr update-inventory should be the CLI equivalent of that -- it will be a one "click" command to just run an inventory job without caring about how it happens. So it won't expose any of the normal workflow options nor will it allow customising the distro, etc.
The --help and man for bkr update-inventory can point at bkr machine-test --inventory as an alternative when the user wants full control over how the job is defined, such as picking distros, adding extra tasks, repos, etc.
Beaker 21.0 has been released.