[patch] Updates to the Netbooting & Bootloader sections

bug_86054_fix.diff (text/plain), 5.64 KB, created by Stuart Longland (RETIRED) on 2005-03-20 16:34:06 UTC

Index: en/handbook/hb-install-mips-bootloader.xml
===================================================================
RCS file: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-bootloader.xml,v
retrieving revision 1.10
diff -u -r1.10 hb-install-mips-bootloader.xml
--- en/handbook/hb-install-mips-bootloader.xml	21 Mar 2005 00:24:40 -0000	1.10
+++ en/handbook/hb-install-mips-bootloader.xml	21 Mar 2005 00:24:55 -0000
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
 
-<!-- $Header: /var/www/www.gentoo.org/raw_cvs/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-bootloader.xml,v 1.10 2005/02/14 14:59:19 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-bootloader.xml,v 1.10 2005/03/21 00:24:40 stuartl Exp $ -->
 
 <sections>
 
@@ -231,10 +231,18 @@
 version installed), and is very simple.
 </p>
 
+<note>
+Just a tip.  When installing kernels, I usually create two kernel images,
+<path>kernel.gz.working</path> -- a known working kernel, and
+<path>kernel.gz.new</path> -- a kernel that's just been compiled.  You can
+either use symlinks to point to the current "new" and "working" kerneks,
+or just rename the kernel images.
+</note>
+
 <pre caption="A basic default.colo">
 <comment>#:CoLo:#</comment>
 mount hda1
-load /vmlinux-working.gz
+load /kernel.gz.working
 execute root=/dev/hda3 ro console=ttyS0,115200
 </pre>
 
@@ -250,6 +258,18 @@
 my Cobalt server:
 </p>
 
+<impo>
+Please note that you need to be using CoLo v1.12 or v1.13 to use the
+<c>menu</c> command.  The following example won't work with v1.11.
+</impo>
+
+<impo>
+The <c>menu</c> command was replaced by the <c>select</c> command in CoLo
+v1.14.  If you've installed a later version by hand, have a look at
+<path>menu.colo</path> in the <path>examples</path> subdirectory of the CoLo
+distribution.
+</impo>
+
 <pre caption="Menu-based configuration">
 <comment>#:CoLo:#</comment>
 
@@ -257,7 +277,7 @@
 mount hda1
 menu "Which Kernel?" 50 Working working New new
 lcd "Loading Linux" {menu-option}
-load /vmlinux.gz.{menu-option}
+load /kernel.gz.{menu-option}
 lcd "Booting..."
 execute root=/dev/hda5 ro console=ttyS0,115200
 boot
Index: en/handbook/hb-install-mips-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-kernel.xml,v
retrieving revision 1.18
diff -u -r1.18 hb-install-mips-kernel.xml
--- en/handbook/hb-install-mips-kernel.xml	21 Mar 2005 00:24:40 -0000	1.18
+++ en/handbook/hb-install-mips-kernel.xml	21 Mar 2005 00:24:55 -0000
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
 
-<!-- $Header: /var/www/www.gentoo.org/raw_cvs/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml,v 1.12 2005/03/04 23:11:06 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-kernel.xml,v 1.18 2005/03/21 00:24:40 stuartl Exp $ -->
 
 <sections>
 
@@ -146,6 +146,12 @@
   </li>
 </ul>
 
+<note>
+More kernel configuration examples can be found on the Gentoo/MIPS Hardware
+Support Database, which is located at
+<uri>http://stuartl.longlandclan.hopto.org/gentoo/mips/</uri>
+</note>
+
 <p>
 Once you have found a configuration, download it into your kernel source
 directory, and rename it to <path>.config</path>.  From there, you can run
@@ -186,9 +192,16 @@
 <path>/boot</path>. 
 </p>
 
+<note>
+On Cobalt servers, the bootloader will expect to see a compressed kernel image.
+Remember to <c>gzip -9</c> the file once it is in <path>/boot</path>.
+</note>
+
 <pre caption="Installing the kernel">
 # <i>cp vmlinux /boot/kernel-2.4.24</i>
 # <i>cp System.map /boot/System.map-2.4.24</i>
+<comment>(Cobalt Servers -- Compressing the kernel image)</comment>
+# <i>gzip -9v /boot/kernel-2.4.24</i>
 </pre>
 
 <p>
Index: en/handbook/hb-install-mips-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-medium.xml,v
retrieving revision 1.40
diff -u -r1.40 hb-install-mips-medium.xml
--- en/handbook/hb-install-mips-medium.xml	21 Mar 2005 00:00:39 -0000	1.40
+++ en/handbook/hb-install-mips-medium.xml	21 Mar 2005 00:24:55 -0000
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
 
-<!-- $Header: /var/www/www.gentoo.org/raw_cvs/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml,v 1.9 2005/02/14 14:59:19 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo-doc/en/handbook/hb-install-mips-medium.xml,v 1.40 2005/03/21 00:00:39 stuartl Exp $ -->
 
 <sections>
 
@@ -886,16 +886,24 @@
 convenient.  Inside the <path>colo-1.XX/binaries</path> directory created,
 you should find under a file named <path>colo-chain.elf</path>.  Gzip this
 file up and place it in <path>/nfsroot</path> calling it
-<path>vmlinux_raq-2800.gz</path>.  You can do this in one hit using these
-commands:
+<path>vmlinux_raq-2800.gz</path>.  Also, in some cases, you will need to
+create a symbolic link called <path>boot</path> that points back to 
+<path>/nfsroot</path>.  You can do this in one hit using these commands:
 </p>
 
 <pre caption="Putting CoLo in the nfsroot">
 # <i>tar -xzvf colo-1.XX.tar.gz</i>
 # <i>cd colo-1.XX/binaries</i>
 # <i>gzip -9vc colo-chain.elf &gt; /nfsroot/vmlinux_raq-2800.gz</i>
+# <i>cd /nfsroot</i>
+# <i>ln . boot</i>
 </pre>
 
+<note>
+  If the latest CoLo release fails to boot, you may wish to try an earlier
+  release.  Version 1.16 and earlier are known to work.
+</note>
+
 </body>
 </subsection>