Using GNU GRUB 2 in openSUSE
============================

Though GRUB 2 provides various feature enhancements over previous GRUB
version (referred to as "GRUB", or "GRUB Legacy"), it did not reach its
stability and feature completness yet, and thus is not ready to replace
it for the whole user base. This package is primarily intended to
encourage testing and accelerate distribution integration.

It is generally safe to install the package. It is able to co-exist with
existing GRUB installation and adds itself to the GRUB menu upon
installation, so you'll able to select GRUB 2 from GRUB menu during
the boot.

Utilities
---------

The GRUB 2 utilities are prefixed (or postfixed) with 'grub2':

grub2-editenv
grub2-mkimage
grub2-mkelfimage
grub2-mkrescue
grub2-emu
grub2-install
grub2-mkdevicemap
grub2-probe
grub2-setup
update-grub2

Documentation
-------------

The GRUB 2 lacks documentation. While you are encouraged to contribute
the documentation, you can use the GRUB 2 Wiki [1] as primary source of
information pertaining to this development snapshot.

[1] http://grub.enbug.org/

If you intend to install grub2 as your primary boot loader refer to
the GRUB 2 Wiki for information on how to set it up.

Support channels
----------------

If you find a bug in this package, report them to the openSUSE Bugzilla [2].

[2] http://bugzilla.novell.com/

Installation
------------

There is not yet any support in openSUSE to configure and install
grub2. To install it for the first time, run (replace /dev/sdaX with
your boot partition or use /dev/sda for the MBR):

# grub2-install --no-floppy /dev/sdaX
# grub2-mkconfig -o /boot/grub2/grub.cfg

To just update the configuration after the kernel changes, run
# grub2-mkconfig -o /boot/grub2/grub.cfg

For testing, you might want to pass --grub-setup=/bin/true to
grub2-install - this way, grub2 is not setup in the MBR and you can
use grub to chainload a grub2 configuration.

In the grub menu.lst, just add (after changing the hd0,1 parameter):
title GNU GRUB 2 -- openSUSE 12.1 - GNU GRUB 2
    kernel (hd0,1)/boot/grub2/core.img

Warning
-------
Currently, perl-Bootloader does not support grub2 as bootloader.

Therefore you need to run the following after each kernel change:
# grub2-mkconfig -o /boot/grub2/grub.cfg