|
 |
28f7f8 |
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
|
|
|
ecb9bb |
From: Robert Marshall <rmarshall@redhat.com>
|
|
|
ecb9bb |
Date: Mon, 16 Mar 2015 16:34:51 -0400
|
|
|
28f7f8 |
Subject: [PATCH] Update info with grub.cfg netboot selection order (#1148650)
|
|
|
ecb9bb |
|
|
|
ecb9bb |
Added documentation to the grub info page that specifies the order
|
|
|
ecb9bb |
netboot clients will use to select a grub configuration file.
|
|
|
ecb9bb |
|
|
|
ecb9bb |
Resolves rhbz#1148650
|
|
|
ecb9bb |
---
|
|
|
ecb9bb |
docs/grub.texi | 42 ++++++++++++++++++++++++++++++++++++++++++
|
|
|
ecb9bb |
1 file changed, 42 insertions(+)
|
|
|
ecb9bb |
|
|
|
ecb9bb |
diff --git a/docs/grub.texi b/docs/grub.texi
|
|
|
28f7f8 |
index 6b112c18804..ef09c832482 100644
|
|
|
ecb9bb |
--- a/docs/grub.texi
|
|
|
ecb9bb |
+++ b/docs/grub.texi
|
|
|
ecb9bb |
@@ -2414,6 +2414,48 @@ grub-mknetdir --net-directory=/srv/tftp --subdir=/boot/grub -d /usr/lib/grub/i38
|
|
|
ecb9bb |
Then follow instructions printed out by grub-mknetdir on configuring your DHCP
|
|
|
ecb9bb |
server.
|
|
|
ecb9bb |
|
|
|
ecb9bb |
+The grub.cfg file is placed in the same directory as the path output by
|
|
|
ecb9bb |
+grub-mknetdir hereafter referred to as FWPATH. GRUB will search for its
|
|
|
ecb9bb |
+configuration files in order using the following rules where the appended
|
|
|
ecb9bb |
+value corresponds to a value on the client machine.
|
|
|
ecb9bb |
+
|
|
|
ecb9bb |
+@example
|
|
|
ecb9bb |
+@group
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg-@samp{(UUID OF NIC)}
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg-@samp{(MAC ADDRESS OF NIC)}
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg-@samp{(IPv4 OR IPv6 ADDRESS)}
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg
|
|
|
ecb9bb |
+@end group
|
|
|
ecb9bb |
+@end example
|
|
|
ecb9bb |
+
|
|
|
ecb9bb |
+The client will only attempt to look up an IPv6 address config once, however,
|
|
|
ecb9bb |
+it will try the IPv4 multiple times. The concrete example below shows what
|
|
|
ecb9bb |
+would happen under the IPv4 case.
|
|
|
ecb9bb |
+
|
|
|
ecb9bb |
+@example
|
|
|
ecb9bb |
+@group
|
|
|
ecb9bb |
+UUID: 7726a678-7fc0-4853-a4f6-c85ac36a120a
|
|
|
ecb9bb |
+MAC: 52:54:00:ec:33:81
|
|
|
ecb9bb |
+IPV4: 10.0.0.130 (0A000082)
|
|
|
ecb9bb |
+@end group
|
|
|
ecb9bb |
+@end example
|
|
|
ecb9bb |
+
|
|
|
ecb9bb |
+@example
|
|
|
ecb9bb |
+@group
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg-7726a678-7fc0-4853-a4f6-c85ac36a120a
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg-52-54-00-ec-33-81
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg-0A000082
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg-0A00008
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg-0A0000
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg-0A000
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg-0A00
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg-0A0
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg-0A
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg-0
|
|
|
ecb9bb |
+@samp{(FWPATH)}/grub.cfg
|
|
|
ecb9bb |
+@end group
|
|
|
ecb9bb |
+@end example
|
|
|
ecb9bb |
+
|
|
|
ecb9bb |
After GRUB has started, files on the TFTP server will be accessible via the
|
|
|
ecb9bb |
@samp{(tftp)} device.
|
|
|
ecb9bb |
|