nightmorph 12/09/11 22:49:21
Modified: hb-install-alpha-bootloader.xml
hb-install-alpha-kernel.xml
hb-install-ia64-kernel.xml
hb-install-sparc-bootloader.xml
hb-install-sparc-kernel.xml
hb-install-x86+amd64-bootloader.xml
hb-install-x86+amd64-kernel.xml
Log:
update handbooks for initramfs changes needed for separate /usr and other
partitions. bug #415175, bug #434550, bug #434554, bug #434732
Revision Changes Path
1.25 xml/htdocs/doc/en/handbook/hb-install-alpha-bootloader.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-bootloader.xml?rev=1.25&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-bootloader.xml?rev=1.25&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-bootloader.xml?r1=1.24&r2=1.25
Index: hb-install-alpha-bootloader.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-bootloader.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- hb-install-alpha-bootloader.xml 9 May 2011 19:47:22 -0000 1.24
+++ hb-install-alpha-bootloader.xml 11 Sep 2012 22:49:20 -0000 1.25
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-bootloader.xml,v
1.24 2011/05/09 19:47:22 nightmorph Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-bootloader.xml,v
1.25 2012/09/11 22:49:20 nightmorph Exp $ -->
<sections>
-<version>11</version>
-<date>2011-05-09</date>
+<version>12</version>
+<date>2012-09-11</date>
<section>
<title>Making your Choice</title>
@@ -72,14 +72,31 @@
</note>
<p>
-Additionally, you can make Gentoo boot automatically by setting up the
-aboot configuration file and some SRM variables. You can try setting
-these variables from Linux, but it may be easier to do so from the SRM
-console itself.
+Although <c>aboot</c> is now installed, we still need to write a configuration
+file for it. Aboot only requires one line for each configuration, so we
+can do this:
</p>
-<pre caption="Automatically booting Gentoo">
+<pre caption="Creating /etc/aboot.conf">
# <i>echo '0:2/boot/vmlinux.gz root=/dev/sda2' > /etc/aboot.conf</i>
+
+<comment>
+If, while building the Linux kernel, you opted to include an initramfs to boot
+from, then you will need to change the configuration by referring to this
+initramfs file and telling the initramfs where your real root device is at:
+</comment>
+
+# <i>echo '0:2/boot/vmlinux.gz initrd=/boot/<keyval id="genkernel-initrd"/>
real_root=/dev/sda2' > /etc/aboot.conf</i>
+</pre>
+
+
+<p>
+Additionally, you can make Gentoo boot automatically by setting up some SRM
+variables. You can try setting these variables from Linux, but it may be easier
+to do so from the SRM console itself.
+</p>
+
+<pre caption="Automatically booting Gentoo">
# <i>cd /proc/srm_environment/named_variables</i>
# <i>echo -n 0 > boot_osflags</i>
# <i>echo -n '' > boot_file</i>
1.51 xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml?rev=1.51&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml?rev=1.51&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml?r1=1.50&r2=1.51
Index: hb-install-alpha-kernel.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml,v
retrieving revision 1.50
retrieving revision 1.51
diff -u -r1.50 -r1.51
--- hb-install-alpha-kernel.xml 27 Mar 2012 17:46:07 -0000 1.50
+++ hb-install-alpha-kernel.xml 11 Sep 2012 22:49:20 -0000 1.51
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml,v
1.50 2012/03/27 17:46:07 swift Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml,v
1.51 2012/09/11 22:49:20 nightmorph Exp $ -->
<sections>
-<version>13</version>
-<date>2012-03-27</date>
+<version>14</version>
+<date>2012-09-11</date>
<section>
<title>Timezone</title>
@@ -266,12 +266,12 @@
# <i>cp arch/alpha/boot/vmlinux.gz /boot/</i>
</pre>
-<p>
-Now continue with <uri link="#kernel_modules">Kernel Modules</uri>.
-</p>
-
</body>
</subsection>
+<subsection>
+<include href="hb-install-initramfs.xml"/>
+</subsection>
+
</section>
<section id="genkernel">
<title>Alternative: Using genkernel</title>
1.27 xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml?rev=1.27&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml?rev=1.27&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml?r1=1.26&r2=1.27
Index: hb-install-ia64-kernel.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- hb-install-ia64-kernel.xml 27 Mar 2012 17:46:07 -0000 1.26
+++ hb-install-ia64-kernel.xml 11 Sep 2012 22:49:20 -0000 1.27
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml,v
1.26 2012/03/27 17:46:07 swift Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml,v
1.27 2012/09/11 22:49:20 nightmorph Exp $ -->
<sections>
-<version>16</version>
-<date>2012-03-27</date>
+<version>17</version>
+<date>2012-09-11</date>
<section>
<title>Timezone</title>
@@ -255,15 +255,67 @@
</pre>
<p>
-When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path>. Use whatever name you feel is appropriate for your kernel
-choice and remember it as you will need it later on when you configure your
-bootloader. Remember to replace <c><keyval id="kernel-name"/></c> with the
-name and version of your kernel.
+When the kernel has finished compiling, copy the kernel image to
<path>/</path>.
+Use whatever name you feel is appropriate for your kernel choice and remember
it
+as you will need it later on when you configure your bootloader. Remember to
+replace <c>vmlinuz</c> with the name and version of your kernel.
</p>
<pre caption="Installing the kernel">
-# <i>cp vmlinux.gz /boot/<keyval id="kernel-name"/></i>
+# <i>cp vmlinux.gz /boot/vmlinuz</i>
+</pre>
+
+</body>
+</subsection>
+<subsection id="initramfs">
+<title>(Optional) Building an Initramfs</title>
+<body>
+
+<p>
+If you use a specific partition layout where important file system locations
+(like <path>/usr</path> or <path>/var</path>) are on separate partitions, then
+you will need to setup an initramfs so that this partition can be mounted
before
+it is needed.
+</p>
+
+<p>
+Without an initramfs, you risk that the system will not boot up properly as the
+tools that are responsible for mounting the file systems need information that
+resides on those file systems. An initramfs will pull in the necessary files
+into an archive which is used right after the kernel boots, but before the
+control is handed over to the <c>init</c> tool. Scripts on the initramfs will
+then make sure that the partitions are properly mounted before the system
+continues booting.
+</p>
+
+<p>
+To install an initramfs, install <c>genkernel</c> first, then have it
+generate an initramfs for you.
+</p>
+
+<pre caption="Building an initramfs">
+# <i>emerge genkernel</i>
+# <i>genkernel --bootdir=/. --no-mountboot --install initramfs</i>
+</pre>
+
+<p>
+If you need specific support in the initramfs, such as lvm or raid, add in the
+appropriate options to genkernel. See <c>genkernel --help</c> for more
+information, or the next example which enables support for LVM and software
raid
+(mdadm):
+</p>
+
+<pre caption="Building an initramfs with support for LVM and software raid">
+# <i>genkernel --bootdir=/. --no-mountboot --lvm --mdadm --install
initramfs</i>
+</pre>
+
+<p>
+The initramfs will be stored in <path>/</path>. You can find the file by simply
+listing the files starting with <path>initramfs</path>:
+</p>
+
+<pre caption="Checking the initramfs file name">
+# <i>ls /initramfs*</i>
</pre>
<p>
@@ -302,7 +354,7 @@
</pre>
<p>
-Now, compile your kernel sources by running <c>genkernel all</c>. Be aware
+Now, compile your kernel sources by running <c>genkernel</c>. Be aware
though, as <c>genkernel</c> compiles a kernel that supports almost all
hardware,
this compilation will take quite a while to finish!
</p>
@@ -313,7 +365,7 @@
</note>
<pre caption="Running genkernel">
-# <i>genkernel all</i>
+# <i>genkernel --bootdir=/. --no-mountboot all</i>
</pre>
<p>
@@ -327,7 +379,7 @@
</p>
<pre caption="Checking the created kernel image name and initrd">
-# <i>ls /boot/kernel* /boot/initramfs*</i>
+# <i>ls /kernel* /initramfs*</i>
</pre>
</body>
1.25 xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml?rev=1.25&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml?rev=1.25&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml?r1=1.24&r2=1.25
Index: hb-install-sparc-bootloader.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- hb-install-sparc-bootloader.xml 9 May 2011 19:47:22 -0000 1.24
+++ hb-install-sparc-bootloader.xml 11 Sep 2012 22:49:20 -0000 1.25
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml,v
1.24 2011/05/09 19:47:22 nightmorph Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-bootloader.xml,v
1.25 2012/09/11 22:49:20 nightmorph Exp $ -->
<sections>
-<version>5</version>
-<date>2011-05-09</date>
+<version>6</version>
+<date>2012-09-11</date>
<section>
<title>Making your Choice</title>
@@ -52,8 +52,9 @@
<p>
Below you'll find an example <path>silo.conf</path> file. It uses the
-partitioning scheme we use throughout this book and
-<path>kernel-<keyval id="kernel-version"/></path> as kernelimage.
+partitioning scheme we use throughout this book, <path>kernel-<keyval
+id="kernel-version"/></path> as kernelimage and <path><keyval
+id="genkernel-initrd"/></path> as initramfs.
</p>
<pre caption="Example /etc/silo.conf">
@@ -63,6 +64,7 @@
image = /boot/<keyval id="kernel-name"/>
label = linux
+ append = "initrd=/boot/<keyval id="genkernel-initrd"/> real_root=/dev/sda1"
</pre>
<p>
1.44 xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml?rev=1.44&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml?rev=1.44&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml?r1=1.43&r2=1.44
Index: hb-install-sparc-kernel.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -r1.43 -r1.44
--- hb-install-sparc-kernel.xml 27 Mar 2012 17:46:07 -0000 1.43
+++ hb-install-sparc-kernel.xml 11 Sep 2012 22:49:21 -0000 1.44
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml,v
1.43 2012/03/27 17:46:07 swift Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml,v
1.44 2012/09/11 22:49:21 nightmorph Exp $ -->
<sections>
-<version>13</version>
-<date>2012-03-27</date>
+<version>14</version>
+<date>2012-09-11</date>
<section>
<title>Timezone</title>
@@ -298,12 +298,12 @@
# <i>cp arch/sparc/boot/image /boot/<keyval id="kernel-name"/></i>
</pre>
-<p>
-Now continue with <uri link="#kernel_modules">Kernel Modules</uri>.
-</p>
-
</body>
</subsection>
+<subsection>
+<include href="hb-install-initramfs.xml"/>
+</subsection>
+
</section>
<section id="kernel_modules">
<title>Kernel Modules</title>
1.28
xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml?rev=1.28&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml?rev=1.28&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml?r1=1.27&r2=1.28
Index: hb-install-x86+amd64-bootloader.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- hb-install-x86+amd64-bootloader.xml 5 Aug 2012 01:21:49 -0000 1.27
+++ hb-install-x86+amd64-bootloader.xml 11 Sep 2012 22:49:21 -0000 1.28
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v
1.27 2012/08/05 01:21:49 nightmorph Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-bootloader.xml,v
1.28 2012/09/11 22:49:21 nightmorph Exp $ -->
<sections>
-<version>11</version>
-<date>2012-08-04</date>
+<version>12</version>
+<date>2012-09-11</date>
<section>
<title>Making your Choice</title>
@@ -621,6 +621,20 @@
</p>
<p>
+If, while building the Linux kernel, you opted to include an initramfs to boot
+from, then you will need to change the configuration by referring to this
+initramfs file and telling the initramfs where your real root device is at:
+</p>
+
+<pre caption="ELILO snippet for initramfs-enabled kernel-builds">
+image=/vmlinuz
+ label=Gentoo
+ <i>initrd=/<keyval id="genkernel-initrd"/></i>
+ <i>append = "initrd=<keyval id="genkernel-initrd"/> real_root=/dev/sda2
console=ttyS0,9600"</i>
+ read-only
+</pre>
+
+<p>
When configuration is done, just run <c>elilo --efiboot</c>. The
<c>--efiboot</c> option adds a menu entry for Gentoo Linux to the EFI Boot
Manager.
1.48 xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml
file :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml?rev=1.48&view=markup
plain:
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml?rev=1.48&content-type=text/plain
diff :
http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml?r1=1.47&r2=1.48
Index: hb-install-x86+amd64-kernel.xml
===================================================================
RCS file:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml,v
retrieving revision 1.47
retrieving revision 1.48
diff -u -r1.47 -r1.48
--- hb-install-x86+amd64-kernel.xml 12 Apr 2012 15:53:31 -0000 1.47
+++ hb-install-x86+amd64-kernel.xml 11 Sep 2012 22:49:21 -0000 1.48
@@ -4,7 +4,7 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml,v
1.47 2012/04/12 15:53:31 swift Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-kernel.xml,v
1.48 2012/09/11 22:49:21 nightmorph Exp $ -->
<sections>
@@ -13,8 +13,8 @@
explains how to configure your kernel.
</abstract>
-<version>17</version>
-<date>2012-04-12</date>
+<version>18</version>
+<date>2012-09-11</date>
<section>
<title>Timezone</title>
@@ -356,63 +356,10 @@
</body>
</subsection>
-<subsection id="initramfs">
-<title>(Optional) Building an Initramfs</title>
-<body>
-
-<p>
-If you use a specific partition layout where important file system locations
-(like <path>/usr</path> or <path>/var</path>) are on separate partitions, then
-you will need to setup an initramfs so that this partition can be mounted
before
-it is needed.
-</p>
-
-<p>
-Without an initramfs, you risk that the system will not boot up properly as the
-tools that are responsible for mounting the file systems need information that
-resides on those file systems. An initramfs will pull in the necessary files
-into an archive which is used right after the kernel boots, but before the
-control is handed over to the <c>init</c> tool. Scripts on the initramfs will
-then make sure that the partitions are properly mounted before the system
-continues booting.
-</p>
-
-<p>
-To install an initramfs, install <c>genkernel</c> first, then have it
-generate an initramfs for you.
-</p>
-
-<pre caption="Building an initramfs">
-# <i>emerge genkernel</i>
-# <i>genkernel --install initramfs</i>
-</pre>
-
-<p>
-If you need specific support in the initramfs, such as lvm or raid, add in the
-appropriate options to genkernel. See <c>genkernel --help</c> for more
-information, or the next example which enables support for LVM and software
raid
-(mdadm):
-</p>
-
-<pre caption="Building an initramfs with support for LVM and software raid">
-# <i>genkernel --lvm --mdadm --install initramfs</i>
-</pre>
-
-<p>
-The initramfs will be stored in <path>/boot</path>. You can find the file by
-simply listing the files starting with <path>initramfs</path>:
-</p>
-
-<pre caption="Checking the initramfs file name">
-# <i>ls /boot/initramfs*</i>
-</pre>
-
-<p>
-Now continue with <uri link="#kernel_modules">Kernel Modules</uri>.
-</p>
-
-</body>
+<subsection>
+<include href="hb-install-initramfs.xml"/>
</subsection>
+
</section>
<section id="genkernel">
<title>Alternative: Using genkernel</title>
