grub-install: In docs suggest manually creating device.map (RHBZ#484986).
authorRichard Jones <rjones@redhat.com>
Thu, 3 Jun 2010 10:48:41 +0000 (11:48 +0100)
committerRichard Jones <rjones@redhat.com>
Mon, 12 Jul 2010 07:31:04 +0000 (08:31 +0100)
(cherry picked from commit dccd9b8f525cfae49b89c38066d752e6c054c7f6)

src/generator.ml

index a52ddce..9c13d40 100755 (executable)
@@ -2327,7 +2327,18 @@ See also: C<guestfs_scrub_device>.");
    "install GRUB",
    "\
 This command installs GRUB (the Grand Unified Bootloader) on
-C<device>, with the root directory being C<root>.");
+C<device>, with the root directory being C<root>.
+
+Note: If grub-install reports the error
+\"No suitable drive was found in the generated device map.\"
+it may be that you need to create a C</boot/grub/device.map>
+file first that contains the mapping between grub device names
+and Linux device names.  It is usually sufficient to create
+a file containing:
+
+ (hd0) /dev/vda
+
+replacing C</dev/vda> with the name of the installation device.");
 
   ("cp", (RErr, [Pathname "src"; Pathname "dest"]), 87, [],
    [InitBasicFS, Always, TestOutput (