summaryrefslogtreecommitdiff
path: root/vmdb/plugins/grub.mdwn
blob: c2abe5404d1dd3cb94c26e4a4d56c5317e2528b3 (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
Step: grub
-----------------------------------------------------------------------------

Install the GRUB bootloader to the image. Works on a PC, for
traditional BIOS booting or 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. (FIXME: these are valid for a
  PC; not sure what other archs require, if grub even works there.)

* `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.

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 }}"