bkr-system-provision - Man Page

Provision a Beaker system

Synopsis

bkr system-provision [options]
[--ks-meta <variables>]
[--kernel-options <opts>]
[--kernel-options-post <opts>]
[--kickstart <file>]
[--no-reboot]
--distro-tree <id>
<fqdn>

Description

Provisions the given system with the given distro. Pass extra options to customise the OS installation.

The system must have its status set to Manual and be already reserved by the current user. To provision a system using the Beaker scheduler, submit a job using the Beaker web UI or a workflow command (such as bkr workflow-simple) instead.

Options

--distro-tree <id>

Provision the distro tree identified by <id>.

The distro tree id can be found in Beaker's web UI or by using bkr distro-trees-list.

--ks-meta <variables>

Pass additional kickstart metadata <variables> to Cobbler. The variables string is applied on top of any variables which are set by default for the chosen system and distro.

--kernel-options <opts>

Pass additional kernel options for during installation. The options string is applied on top of any install-time kernel options which are set by default for the chosen system and distro.

--kernel-options-post <opts>

Pass additional kernel options for after installation. The options string is applied on top of any post-install kernel options which are set by default for the chosen system and distro.

--kickstart <file>

Pass <file> as the kickstart for installation. If <file> is '-', the kickstart is read from stdin.

The kickstart must be a complete kickstart (not just a snippet). Beaker will not make any of the usual Beaker-related customisations to the kickstart; only the install location for the selected distro will be prepended to the top of the kickstart.

--no-reboot

Performs all the necessary steps to set up the system to be provisioned with the selected distro, but skips the final step of booting the system into the installation environment.

If --no-reboot is passed, this command will have no effect unless a system is subsequently rebooted by using bkr system-power (or by some other means).

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

Exit Status

Non-zero on error, otherwise zero.

Examples

Reserve a particular system, provision it, do some work on it, and then release it:

bkr system-reserve system1.example.invalid
bkr system-provision --kernel-opts "nogpt" \
                     --distro-tree 12345 \
                     system1.example.invalid
# do some work on the system
bkr system-release system1.example.invalid

History

Prior to version 0.9.1, this command accepted --distro instead of --distro-tree.

See Also

bkr-workflow-simple(1), bkr-system-power(1), bkr(1)

Author

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

Referenced By

bkr(1), bkr-system-power(1).

Feb 11, 2024 29.1 Beaker