bkr-update-inventory man page

bkr-update-inventory — Submits a inventory job for the system

Synopsis

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

Description

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.

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.

Common bkr options are described in the Options section of bkr(1).

(Note: this command requires Python 2.6 or later)

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.

--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.

--dry-run

Do not submit the job(s) to Beaker. Use this with --xml or --pretty-xml to see what would be submitted.

--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).

Exit Status

1 if any jobs failed submission or execution (when –wait is used), otherwise 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),

Author

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

Referenced By

bkr(1).

Oct 03, 2017 24.4 Beaker