Product SiteDocumentation Site

A.2.2. bootloader (required) - Configure Boot Loader

Specifies how the boot loader should be installed.

Important

You should always use a password to protect your boot loader. An unprotected boot loader can allow a potential attacker to modify the system's boot options and gain unauthorized access to the system.

Important

Some systems require a special partition for installing the boot loader. The type and size of this partition depends on whether the disk you are installing the boot loader to uses the Master Boot Record (MBR) or a GUID Partition Table (GPT) schema. For more information, see Section 5.4.8.1, “Boot Loader Installation”.
--append=
Specifies additional kernel parameters. To specify multiple parameters, separate them with spaces. For example:
bootloader --location=mbr --append="hdd=ide-scsi ide=nodma"
The rhgb and quiet parameters are always used, even if you do not specify them here or do not use the --append= command at all.
--boot-drive=
Specifies which drive the boot loader should be written to, and therefore which drive the computer will boot from. If you use a multipath device as the boot drive, specify only one member of the device.

Important

The --boot-drive= option is currently being ignored in Fedora installations on IBM System z systems using the zipl boot loader. When zipl is installed, it determines the boot drive on its own.
--leavebootorder
Prevents the installation program from making changes to the existing list of bootable images on UEFI or ISeries/PSeries systems.
--driveorder=
Specifies which drive is first in the BIOS boot order. For example:
bootloader --driveorder=sda,hda
--location=
Specifies where the boot record is written. Valid values are the following:
  • mbr - The default option. Depends on whether the drive uses the Master Boot Record (MBR) or GUID Partition Table (GPT) scheme:
    • On a GPT-formatted disk, this option will install stage 1.5 of the boot loader into the BIOS boot partition.
    • On an MBR-formatted disk, stage 1.5 will be installed into the empty space between the MBR and the first partition.
  • partition - Install the boot loader on the first sector of the partition containing the kernel.
  • none - Do not install the boot loader.
In most cases, this option does not need to be specified.
--password=
If using GRUB2 as the boot loader, sets the boot loader password to the one specified with this option. This should be used to restrict access to the GRUB2 shell, where arbitrary kernel options can be passed.
If a password is specified, GRUB2 will also ask for a user name. The user name is always root.
--iscrypted
Normally, when you specify a boot loader password using the --password= option, it will be stored in the Kickstart file in plain text. If you want to encrypt the password, use this option and an encrypted password.
To generate an encrypted password, use the grub2-mkpasswd-pbkdf2 command, enter the password you want to use, and copy the command's output (the hash starting with grub.pbkdf2) into the Kickstart file. An example bootloader Kickstart entry with an encrypted password will look similar to the following:
bootloader --iscrypted --password=grub.pbkdf2.sha512.10000.5520C6C9832F3AC3D149AC0B24BE69E2D4FB0DBEEDBD29CA1D30A044DE2645C4C7A291E585D4DC43F8A4D82479F8B95CA4BA4381F8550510B75E8E0BB2938990.C688B6F0EF935701FF9BD1A8EC7FE5BD2333799C98F28420C5CC8F1A2A233DE22C83705BB614EA17F3FDFDF4AC2161CEA3384E56EB38A2E39102F5334C47405E
--timeout=
Specifies the amount of time the boot loader will wait before booting the default option (in seconds).
--default=
Sets the default boot image in the boot loader configuration.
--extlinux
Use the extlinux boot loader instead of GRUB2. This option only works on systems supported by extlinux.
--disabled
Do not attempt to install a boot loader. This option overrides all other boot loader configuration; all other boot loader options will be ignored and no boot loader packages will be installed.
--nombr
Install the boot loader configuration and support files, but do not modify the MBR.