summaryrefslogtreecommitdiff
path: root/vmdb/plugins/grub.mdwn
blob: 037d4d358464d72bd4c75e2f4e33627b208c3b53 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
Step: grub
-----------------------------------------------------------------------------

Install the GRUB bootloader to the image. Works on a PC for
traditional BIOS booting and both a PC and arm64 machines for modern
UEFI booting. Does not (yet?) support Secure Boot.

Warning: This is the least robust part of vmdb2.

Step keys:

* `grub` — REQUIRED; value MUST be one of `uefi` and `bios`, for
  a UEFI or a BIOS boot, respectively. Only PC systems support the
  `bios` option.

* `tag` — REQUIRED; value is the tag for the root filesystem.

* `efi` — REQUIRED for UEFI; value is the tag for the EFI
  filesystem.

* `console` — OPTIONAL; set to `serial` to configure the image
  to use a serial console.

* `image-dev` — OPTIONAL; which device to install GRUB onto; this
  is needed when installing to a real hard drive, instead of an image.

* `quiet` — OPTIONAL; should the kernel be configured to boot
  quietly? Default is no.

* `timeout` — OPTIONAL; set the grub menu timeout, in seconds.
  Defaults to 0 seconds.

Example (in the .vmdb file):

    - grub: bios
      tag: root

Same, but for UEFI:

    - grub: uefi
      tag: root
      efi: efi
      console: serial

Install to a real hard disk (named with the `--image` option):

    - grub: uefi
      tag: root
      efi: efi
      image-dev: "{{ image }}"