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
42              options  string  is  applied  on  top of any install-time kernel
43              options which are set by default for the chosen system and  dis‐
44              tro.
45
46       --kernel-options-post <opts>
47              Pass  additional  kernel  options  for  after  installation. The
48              options string is applied on  top  of  any  post-install  kernel
49              options  which are set by default for the chosen system and dis‐
50              tro.
51
52       --kickstart <file>
53              Pass <file> as the kickstart for installation. If <file> is '-',
54              the kickstart is read from stdin.
55
56              The kickstart must be a complete kickstart (not just a snippet).
57              Beaker will not make any of the usual Beaker-related  customisa‐
58              tions  to  the  kickstart;  only  the  install  location for the
59              selected distro will be prepended to the top of the kickstart.
60
61       --no-reboot
62              Performs all the necessary steps to set up the system to be pro‐
63              visioned  with  the selected distro, but skips the final step of
64              booting the system into the installation environment.
65
66              If --no-reboot is passed,  this  command  will  have  no  effect
67              unless  a  system  is  subsequently  rebooted  by using bkr sys‐
68              tem-power (or by some other means).
69
70       Common bkr options are described in the Options section of bkr(1).
71

EXIT STATUS

73       Non-zero on error, otherwise zero.
74

EXAMPLES

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

HISTORY

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

SEE ALSO

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

AUTHOR

94       The Beaker team <beaker-devel@lists.fedorahosted.org>
95
97       2013-2021 Red Hat, Inc.
98
99
100
101
10228.2                             Feb 17, 2021          BKR-SYSTEM-PROVISION(1)
Impressum