Skip to content

Commit

Permalink
update boot-requirements.md
Browse files Browse the repository at this point in the history
  • Loading branch information
wfeldt committed Mar 26, 2019
1 parent eab6bff commit 5ef1ab9
Showing 1 changed file with 57 additions and 16 deletions.
73 changes: 57 additions & 16 deletions doc/boot-requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,23 +10,32 @@
- and it is not a suitable EFI partition (not enough size, invalid filesystem)
- **requires only a new /boot/efi partition**
- and it is a suitable EFI partition (enough size, valid filesystem)
- **only requires to use the existing EFI partition**
- and it is on the boot disk
- **only requires to use the existing EFI partition**
- and it is not on the boot disk
- **requires only a new /boot/efi partition**
- with a LVM-based proposal
- if there are no EFI partitions
- **requires only a new /boot/efi partition**
- if there is already an EFI partition
- and it is not a suitable EFI partition (not enough size, invalid filesystem)
- **requires only a new /boot/efi partition**
- and it is a suitable EFI partition (enough size, valid filesystem)
- **only requires to use the existing EFI partition**
- and it is on the boot disk
- **only requires to use the existing EFI partition**
- and it is not on the boot disk
- **requires only a new /boot/efi partition**
- with an encrypted proposal
- if there are no EFI partitions
- **requires only a new /boot/efi partition**
- if there is already an EFI partition
- and it is not a suitable EFI partition (not enough size, invalid filesystem)
- **requires only a new /boot/efi partition**
- and it is a suitable EFI partition (enough size, valid filesystem)
- **only requires to use the existing EFI partition**
- and it is on the boot disk
- **only requires to use the existing EFI partition**
- and it is not on the boot disk
- **requires only a new /boot/efi partition**

## needed partitions in a PPC64 system
- in a non-PowerNV system (KVM/LPAR)
Expand All @@ -35,19 +44,28 @@
- **requires only a new PReP partition (to allocate Grub2)**
- **does not require a separate /boot partition (Grub2 can handle this setup)**
- if there is already a suitable PReP partition in the disk
- **does not require any partition (PReP will be reused and Grub2 can handle this setup)**
- and it is on the boot disk
- **does not require any partition (PReP will be reused and Grub2 can handle this setup)**
- and it is not on the boot disk
- **requires only a new PReP partition (to allocate Grub2)**
- with a LVM-based proposal
- if there are no suitable PReP partitions in the target disk
- **requires only a new PReP partition (to allocate Grub2)**
- **does not require a separate /boot partition (Grub2 can handle this setup)**
- if there is already a suitable PReP partition in the disk
- **does not require any partition (PReP will be reused and Grub2 can handle this setup)**
- and it is on the boot disk
- **does not require any partition (PReP will be reused and Grub2 can handle this setup)**
- and it is not on the boot disk
- **requires only a new PReP partition (to allocate Grub2)**
- with an encrypted proposal
- if there are no suitable PReP partitions in the target disk
- **requires only a new PReP partition (to allocate Grub2)**
- **does not require a separate /boot partition (Grub2 can handle this setup)**
- if there is already a suitable PReP partition in the disk
- **does not require any partition (PReP will be reused and Grub2 can handle this setup)**
- and it is on the boot disk
- **does not require any partition (PReP will be reused and Grub2 can handle this setup)**
- and it is not on the boot disk
- **requires only a new PReP partition (to allocate Grub2)**
- in bare metal (PowerNV)
- with a partitions-based proposal
- **does not require any booting partition (no Grub stage1, PPC firmware parses grub2.cfg)**
Expand All @@ -64,6 +82,7 @@
- when aiming for the minimal size
- **requires /boot to be at least 100 MiB large**
- when proposing a PReP partition
- **requires it to be on the boot disk**
- **requires it to be a non-encrypted partition**
- **requires it to be bootable (ms-dos partition table) for some firmwares to find it**
- **requires it to be primary since some firmwares cannot find logical partitions**
Expand Down Expand Up @@ -134,6 +153,7 @@
- and there is no firmware partition in the system
- **only requires to use the existing EFI partition**
- when proposing a new EFI partition
- **requires /boot/efi to be on the boot disk**
- **requires /boot/efi to be a non-encrypted vfat partition**
- **requires /boot/efi to be close enough to the beginning of disk**
- when aiming for the recommended size
Expand All @@ -152,7 +172,7 @@
- **requires only a /boot/zipl partition (to allocate Grub2)**
- with an encrypted proposal
- **requires only a /boot/zipl partition (to allocate Grub2)**
- trying to install in a zfcp disk (no DASD)
- trying to install in a zFCP disk (no DASD)
- with a partitions-based proposal
- not using Btrfs (i.e. /boot is within a XFS or ext2/3/4 partition)
- **does not require additional partitions (the firmware can find the kernel)**
Expand All @@ -176,9 +196,10 @@
- with an encrypted proposal
- **requires only a /boot/zipl partition (to allocate Grub2)**
- when proposing a /boot/zipl partition
- **proposes /boot/zipl to be a non-encrypted partition in the boot disk**
- **proposes /boot/zipl to be formated as ext2**
- **proposes /boot/zipl to be at most 300 MiB (anything bigger would mean wasting space)**
- **requires /boot/zipl to be on the boot disk**
- **requires /boot/zipl to be a non-encrypted partition**
- **requires /boot/zipl to be formated as ext2**
- **requires /boot/zipl to be at most 300 MiB (anything bigger would mean wasting space)**
- when aiming for the recommended size (first proposal attempt)
- **requires /boot/zipl to be at least 200 MiB (Grub2, one kernel+initrd and extra space)**
- when aiming for the minimal size
Expand All @@ -193,40 +214,58 @@
- and it is not a suitable EFI partition (not enough size, invalid filesystem)
- **requires only a new /boot/efi partition**
- and it is a suitable EFI partition (enough size, valid filesystem)
- **only requires to use the existing EFI partition**
- and it is on the boot disk
- **only requires to use the existing EFI partition**
- and it is not on the boot disk
- **requires only a new /boot/efi partition**
- with a LVM-based proposal
- if there are no EFI partitions
- **requires only a new /boot/efi partition**
- if there is already an EFI partition
- and it is not a suitable EFI partition (not enough size, invalid filesystem)
- **requires only a new /boot/efi partition**
- and it is a suitable EFI partition (enough size, valid filesystem)
- **only requires to use the existing EFI partition**
- and it is on the boot disk
- **only requires to use the existing EFI partition**
- and it is not on the boot disk
- **requires only a new /boot/efi partition**
- with an encrypted proposal
- if there are no EFI partitions
- **requires only a new /boot/efi partition**
- if there is already an EFI partition
- and it is not a suitable EFI partition (not enough size, invalid filesystem)
- **requires only a new /boot/efi partition**
- and it is a suitable EFI partition (enough size, valid filesystem)
- **only requires to use the existing EFI partition**
- and it is on the boot disk
- **only requires to use the existing EFI partition**
- and it is not on the boot disk
- **requires only a new /boot/efi partition**
- not using UEFI (legacy PC)
- with GPT partition table
- in a partitions-based proposal
- if there is no GRUB partition
- **requires a new GRUB partition**
- if there is already a GRUB partition
- **does not require any particular volume**
- and it is on the boot disk
- **does not require any particular volume**
- and it is not on the boot disk
- **requires a new GRUB partition**
- in a LVM-based proposal
- if there is no GRUB partition
- **requires a new GRUB partition**
- if there is already a GRUB partition
- **does not require any particular volume**
- and it is on the boot disk
- **does not require any particular volume**
- and it is not on the boot disk
- **requires a new GRUB partition**
- in an encrypted proposal
- if there is no GRUB partition
- **requires a new GRUB partition**
- if there is already a GRUB partition
- **does not require any particular volume**
- and it is on the boot disk
- **does not require any particular volume**
- and it is not on the boot disk
- **requires a new GRUB partition**
- with a MS-DOS partition table
- if the MBR gap is big enough to embed Grub
- in a partitions-based proposal
Expand Down Expand Up @@ -258,6 +297,7 @@
- when aiming for the minimal size
- **requires /boot to be at least 100 MiB large**
- when proposing a new GRUB partition
- **requires it to be on the boot disk**
- **requires it to have the correct id**
- **requires it to be a non-encrypted partition**
- when aiming for the recommended size
Expand All @@ -267,6 +307,7 @@
- **requires it to be at least 2 MiB (Grub2 stages 1+2 and needed Grub modules)**
- **requires it to be at most 8 MiB (anything bigger would mean wasting space)**
- when proposing a new EFI partition
- **requires /boot/efi to be on the boot disk**
- **requires /boot/efi to be a non-encrypted vfat partition**
- **requires /boot/efi to be close enough to the beginning of disk**
- when aiming for the recommended size
Expand Down

0 comments on commit 5ef1ab9

Please sign in to comment.