Difference between revisions of "Boot-Update"
(I fixed up the document structure.) |
(→GRUB 0.97 (grub-legacy) Quick Start) |
||
| (11 intermediate revisions by 6 users not shown) | |||
| Line 1: | Line 1: | ||
| − | Funtoo boot-update provides a unified mechanism for configuring the GRUB 1.9x (sys-boot/grub) and GRUB 0.97 (sys-boot/grub-legacy) boot loaders. It is the recommended, official way to configure Funtoo Linux systems for booting. | + | Funtoo boot-update provides a unified mechanism for configuring the GRUB 1.9x (sys-boot/[[grub]]) and GRUB 0.97 (sys-boot/grub-legacy) boot loaders. It is the recommended, official way to configure Funtoo Linux systems for booting. |
= Current Versions = | = Current Versions = | ||
| − | * sys-boot/boot-update-1. | + | * sys-boot/boot-update-1.5.2 |
= Man Pages = | = Man Pages = | ||
| Line 9: | Line 9: | ||
Consult the following man pages for detailed, up-to-date information on configuration file settings and command-line arguments: | Consult the following man pages for detailed, up-to-date information on configuration file settings and command-line arguments: | ||
| − | * | + | * boot-update(8) |
| − | * | + | * boot.conf(5) |
= GRUB 1.97+ Quick Start = | = GRUB 1.97+ Quick Start = | ||
| Line 16: | Line 16: | ||
If using sys-boot/grub-1.97+, perform the following steps: | If using sys-boot/grub-1.97+, perform the following steps: | ||
| − | * Partition disk using | + | * Partition disk using GPT/GUID (recommended) or MBR partitions. |
* Install kernel/initrd to /boot | * Install kernel/initrd to /boot | ||
| Line 25: | Line 25: | ||
<pre>boot-update</pre> | <pre>boot-update</pre> | ||
This will auto-generate the complex <tt>/boot/grub/grub.cfg</tt> required for booting. Re-run <tt>boot-update</tt> every time your available kernels/initrds or <tt>/etc/boot.conf</tt> configuration changes. | This will auto-generate the complex <tt>/boot/grub/grub.cfg</tt> required for booting. Re-run <tt>boot-update</tt> every time your available kernels/initrds or <tt>/etc/boot.conf</tt> configuration changes. | ||
| − | |||
= GRUB 0.97 (grub-legacy) Quick Start = | = GRUB 0.97 (grub-legacy) Quick Start = | ||
| Line 35: | Line 34: | ||
<pre>emerge sys-boot/boot-update | <pre>emerge sys-boot/boot-update | ||
| − | emerge sys-boot/grub-legacy | + | emerge ">=sys-boot/grub-legacy-0.97-r11" |
grub-install-legacy /dev/sda</pre> | grub-install-legacy /dev/sda</pre> | ||
| + | Due to an issue with grub-legacy, you may see the following message: | ||
| + | <pre># grub-install-legacy /dev/sda | ||
| + | The file /boot/grub-legacy/stage1 not read correctly. | ||
| + | </pre> | ||
| + | Should you receive this message you will have to install grub-legacy from the grub shell. | ||
| + | Assuming /boot is /dev/sda1 and you want to install grub to the MBR, you would run the following: | ||
| + | <pre>grub-legacy | ||
| + | root (hd0,0) | ||
| + | setup (hd0) | ||
| + | quit | ||
| + | </pre> | ||
| + | When adjusting to fit your setup, remember 'root' is the location of your boot partition, 'setup' is where you want to install grub, and don't forget about grub's unique naming conventions for harddrives/partitions. For more information run: | ||
| + | <pre>info grub-legacy</pre> | ||
| + | |||
Ensure that <tt>/etc/fstab</tt> is correct, and edit <tt>/etc/boot.conf</tt> to reflect your installation. Ensure a <tt>generate grub-legacy</tt> setting in the <tt>boot</tt> section. Then run: | Ensure that <tt>/etc/fstab</tt> is correct, and edit <tt>/etc/boot.conf</tt> to reflect your installation. Ensure a <tt>generate grub-legacy</tt> setting in the <tt>boot</tt> section. Then run: | ||
| Line 43: | Line 56: | ||
Re-run <tt>boot-update</tt> every time your available kernels/initrds or <tt>/etc/boot.conf</tt> configuration changes. | Re-run <tt>boot-update</tt> every time your available kernels/initrds or <tt>/etc/boot.conf</tt> configuration changes. | ||
| + | |||
[[Category:HOWTO]] | [[Category:HOWTO]] | ||
| + | [[Category:Projects]] | ||
| + | [[Category:Funtoo features]] | ||
Revision as of 07:56, 18 November 2012
Funtoo boot-update provides a unified mechanism for configuring the GRUB 1.9x (sys-boot/grub) and GRUB 0.97 (sys-boot/grub-legacy) boot loaders. It is the recommended, official way to configure Funtoo Linux systems for booting.
Contents |
Current Versions
- sys-boot/boot-update-1.5.2
Man Pages
Consult the following man pages for detailed, up-to-date information on configuration file settings and command-line arguments:
- boot-update(8)
- boot.conf(5)
GRUB 1.97+ Quick Start
If using sys-boot/grub-1.97+, perform the following steps:
- Partition disk using GPT/GUID (recommended) or MBR partitions.
- Install kernel/initrd to /boot
emerge sys-boot/boot-update grub-install --no-floppy /dev/sda
Ensure that /etc/fstab is correct, and edit /etc/boot.conf to reflect your installation. Then run:
boot-update
This will auto-generate the complex /boot/grub/grub.cfg required for booting. Re-run boot-update every time your available kernels/initrds or /etc/boot.conf configuration changes.
GRUB 0.97 (grub-legacy) Quick Start
If using sys-boot/grub-legacy-0.97, perform the following steps:
- Partition disk using MBR partitions (GPT not supported)
- Install kernel/initrd to /boot
emerge sys-boot/boot-update emerge ">=sys-boot/grub-legacy-0.97-r11" grub-install-legacy /dev/sda
Due to an issue with grub-legacy, you may see the following message:
# grub-install-legacy /dev/sda The file /boot/grub-legacy/stage1 not read correctly.
Should you receive this message you will have to install grub-legacy from the grub shell. Assuming /boot is /dev/sda1 and you want to install grub to the MBR, you would run the following:
grub-legacy root (hd0,0) setup (hd0) quit
When adjusting to fit your setup, remember 'root' is the location of your boot partition, 'setup' is where you want to install grub, and don't forget about grub's unique naming conventions for harddrives/partitions. For more information run:
info grub-legacy
Ensure that /etc/fstab is correct, and edit /etc/boot.conf to reflect your installation. Ensure a generate grub-legacy setting in the boot section. Then run:
boot-update
This will auto-generate the /boot/grub-legacy/grub.conf required for booting. Note that grub-legacy-0.97-r11 and later stores grub.conf in the /boot/grub-legacy directory.
Re-run boot-update every time your available kernels/initrds or /etc/boot.conf configuration changes.
