1BKR-SYSTEM-PROVISION(1)             Beaker             BKR-SYSTEM-PROVISION(1)
2
3
4

NAME

6       bkr-system-provision - Provision a Beaker system
7

SYNOPSIS

9       bkr system-provision [options]
10         [--ks-meta <variables>]
11         [--kernel-options <opts>]
12         [--kernel-options-post <opts>]
13         [--kickstart <file>]
14         [--no-reboot]
15         --distro-tree <id>
16         <fqdn>
17
18

DESCRIPTION

20       Provisions  the  given system with the given distro. Pass extra options
21       to customise the OS installation.
22
23       The system must have its status set to Manual and be  already  reserved
24       by  the current user. To provision a system using the Beaker scheduler,
25       submit a job using the Beaker web UI or a workflow command (such as bkr
26       workflow-simple) instead.
27

OPTIONS

29       --distro-tree <id>
30              Provision the distro tree identified by <id>.
31
32              The  distro  tree id can be found in Beaker's web UI or by using
33              bkr distro-trees-list.
34
35       --ks-meta <variables>
36              Pass additional kickstart metadata <variables> to  Cobbler.  The
37              variables  string  is  applied on top of any variables which are
38              set by default for the chosen system and distro.
39
40       --kernel-options <opts>
41              Pass additional kernel options for during installation. The  op‐
42              tions  string  is  applied on top of any install-time kernel op‐
43              tions which are set by default for the chosen system and distro.
44
45       --kernel-options-post <opts>
46              Pass additional kernel options for after installation.  The  op‐
47              tions  string  is  applied on top of any post-install kernel op‐
48              tions which are set by default for the chosen system and distro.
49
50       --kickstart <file>
51              Pass <file> as the kickstart for installation. If <file> is '-',
52              the kickstart is read from stdin.
53
54              The kickstart must be a complete kickstart (not just a snippet).
55              Beaker will not make any of the usual Beaker-related  customisa‐
56              tions  to  the  kickstart; only the install location for the se‐
57              lected distro will be prepended to the top of the kickstart.
58
59       --no-reboot
60              Performs all the necessary steps to set up the system to be pro‐
61              visioned  with  the selected distro, but skips the final step of
62              booting the system into the installation environment.
63
64              If --no-reboot is passed, this command will have no  effect  un‐
65              less a system is subsequently rebooted by using bkr system-power
66              (or by some other means).
67
68       Common bkr options are described in the Options section of bkr(1).
69

EXIT STATUS

71       Non-zero on error, otherwise zero.
72

EXAMPLES

74       Reserve a particular system, provision it, do some work on it, and then
75       release it:
76
77          bkr system-reserve system1.example.invalid
78          bkr system-provision --kernel-opts "nogpt" \
79                               --distro-tree 12345 \
80                               system1.example.invalid
81          # do some work on the system
82          bkr system-release system1.example.invalid
83

HISTORY

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

SEE ALSO

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

AUTHOR

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

95       2013-2022 Red Hat, Inc.
96
97
98
99
10028.3                             May 21, 2022          BKR-SYSTEM-PROVISION(1)
Impressum