bkr-machine-test - Man Page

Generate Beaker job to test a system

Synopsis

bkr machine-test --machine <#cmdoption-bkr-machine> <fqdn> [--inventory] [workflow options] [options]

Description

Generates a Beaker job to test the system identified by <fqdn>.

Options

--inventory

Include the /distribution/inventory task in the generated job, in order to update the system's details in Beaker.

Common workflow options are described in the Workflow options <#workflow-options> section of bkr(1).

Common bkr options are described in the Options <#common-options> section of bkr(1).

Exit Status

Non-zero on error, otherwise zero.

Examples

Test a particular system on RHEL5 and RHEL6, including running the inventory task:

bkr machine-test --machine=system1.example.invalid --inventory \
        --family RedHatEnterpriseLinuxServer5 \
        --family RedHatEnterpriseLinux6

Attempt to run the inventory task on faultysystem.example.invalid even though it is marked as Broken:

bkr machine-test --ignore-system-status --inventory \
         --machine=faultysystem.example.invalid

See Also

bkr(1)

Author

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

Referenced By

bkr(1), bkr-update-inventory(1).

Jan 16, 2026 29.2 Beaker