/[gentoo]/xml/htdocs/doc/en/gentoo-x86-install.xml
Gentoo

Diff of /xml/htdocs/doc/en/gentoo-x86-install.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.25 Revision 1.26
23 </author> 23 </author>
24 <author title="Editor"> 24 <author title="Editor">
25 <mail link="rajiv@gentoo.org">Rajiv Manglani</mail> 25 <mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
26 </author> 26 </author>
27 <abstract>These instructions step you through the process of installing Gentoo 27 <abstract>These instructions step you through the process of installing Gentoo
28 Linux 1.4_rc2. The Gentoo Linux installation process supports various installation 28 Linux 1.4_rc2. The Gentoo Linux installation process supports various installation
29 approaches, depending upon how much of the system you want to custom-build from 29 approaches, depending upon how much of the system you want to custom-build from
30 scratch. 30 scratch.
31 </abstract> 31 </abstract>
32 <version>2.3.1</version> 32 <version>2.3.1</version>
33 <date>1 January 2003</date> 33 <date>1 January 2003</date>
34 <chapter> 34 <chapter>
35 <title>About the Install</title> 35 <title>About the Install</title>
36 <section> 36 <section>
37 <body> 37 <body>
38
39<p>This new boot CD will boot from nearly any modern IDE CD-ROM drive, as well 38 <p>This new boot CD will boot from nearly any modern IDE CD-ROM drive, as well
40as many SCSI CD-ROM, assuming that your CD-ROM and BIOS both support booting. 39as many SCSI CD-ROM, assuming that your CD-ROM and BIOS both support booting.
41Included on the CD-ROM is Linux support for IDE (and PCI IDE) (built-in to the 40Included on the CD-ROM is Linux support for IDE (and PCI IDE) (built-in to the
42kernel) as well as support for all SCSI devices (available as modules.) In 41kernel) as well as support for all SCSI devices (available as modules.) In
43addition, we provide modules for literally every kind of network card that 42addition, we provide modules for literally every kind of network card that
44Linux supports, as well as tools to allow you to configure your network and 43Linux supports, as well as tools to allow you to configure your network and
45establish outbound (as well as inbound) <c>ssh</c> connections and download 44establish outbound (as well as inbound) <c>ssh</c> connections and download
46files. </p> 45files. </p>
47
48<p>To install from the build CD, you will need to have a 486+ processor and 46 <p>To install from the build CD, you will need to have a 486+ processor and
49ideally at least 64 Megabytes of RAM. (Gentoo linux has been successfully 47ideally at least 64 Megabytes of RAM. (Gentoo linux has been successfully
50built with 64MB of RAM + 64MB of swap space, but the build process is awfully 48built with 64MB of RAM + 64MB of swap space, but the build process is awfully
51slow under those conditions.)</p> 49slow under those conditions.)</p>
52
53<p>Gentoo Linux can be installed using one of three "stage" tarball files. The 50 <p>Gentoo Linux can be installed using one of three &quot;stage&quot; tarball files. The
54one you choose depends on how much of the system you want to compile yourself. 51one you choose depends on how much of the system you want to compile yourself.
55The stage1 tarball is used when one wants to bootstrap and build the entire 52The stage1 tarball is used when one wants to bootstrap and build the entire
56system from scratch. The stage2 tarball is used for building the entire system 53system from scratch. The stage2 tarball is used for building the entire system
57from scratch, except for the bootstrap part which is already performed for you. 54from scratch, except for the bootstrap part which is already performed for you.
58And the stage3 tarball already contains a basic Gentoo Linux system that has 55And the stage3 tarball already contains a basic Gentoo Linux system that has
59been optimized for your system.</p> 56been optimized for your system.</p>
60
61<p> So, how does one beging the install process? First, you'll want to decide 57 <p> So, how does one beging the install process? First, you'll want to decide
62which one of our LiveCD ISO images to grab from 58which one of our LiveCD ISO images to grab from
63<uri>http://www.ibiblio.org/gentoo/releases/1.4_rc2/x86/</uri>. 59<uri>http://www.ibiblio.org/gentoo/releases/1.4_rc2/x86/</uri>.
64In this directory, you'll see several subdirectories such as <c>athlon</c> 60In this directory, you'll see several subdirectories such as <c>athlon</c>
65for each of our various architecture-specific builds. Here's a low-down on 61for each of our various architecture-specific builds. Here's a low-down on
66each arch directory and what it contains:</p> 62each arch directory and what it contains:</p>
67<table> 63 <table>
68<tr><th>Architecture</th><th>Description</th></tr> 64 <tr>
65 <th>Architecture</th>
66 <th>Description</th>
67 </tr>
68 <tr>
69 <ti>x86</ti>
69<tr><ti>x86</ti><ti>Stage 1 tarballs and "gentoo-basic" liveCD -- will work on anything.</ti></tr> 70 <ti>Stage 1 tarballs and &quot;gentoo-basic&quot; liveCD -- will work on anything.</ti>
71 </tr>
72 <tr>
73 <ti>i586</ti>
70<tr><ti>i586</ti><ti>Stage 2 and 3 tarballs, GRP packages and liveCD for i586+ CPUs</ti></tr> 74 <ti>Stage 2 and 3 tarballs, GRP packages and liveCD for i586+ CPUs</ti>
75 </tr>
76 <tr>
77 <ti>i686</ti>
71<tr><ti>i686</ti><ti>Stage 2 and 3 tarballs, GRP packages and liveCD for i686+ CPUs</ti></tr> 78 <ti>Stage 2 and 3 tarballs, GRP packages and liveCD for i686+ CPUs</ti>
79 </tr>
80 <tr>
81 <ti>athlon</ti>
72<tr><ti>athlon</ti><ti>Stage 2 and 3 tarballs, GRP packages and liveCD for AMD Athlon CPUs</ti></tr> 82 <ti>Stage 2 and 3 tarballs, GRP packages and liveCD for AMD Athlon CPUs</ti>
83 </tr>
84 <tr>
85 <ti>athlon-xp</ti>
73<tr><ti>athlon-xp</ti><ti>Stage 2 and 3 tarballs, GRP packages and liveCD for AMD Athlon XP CPUs</ti></tr> 86 <ti>Stage 2 and 3 tarballs, GRP packages and liveCD for AMD Athlon XP CPUs</ti>
87 </tr>
88 <tr>
89 <ti>athlon-mp</ti>
74<tr><ti>athlon-mp</ti><ti>Stage 2 and 3 tarballs, GRP packages and liveCD for AMD Athlon MP CPUs</ti></tr> 90 <ti>Stage 2 and 3 tarballs, GRP packages and liveCD for AMD Athlon MP CPUs</ti>
91 </tr>
92 <tr>
93 <ti>pentium3</ti>
75<tr><ti>pentium3</ti><ti>Stage 2 and 3 tarballs, GRP packages and liveCD for Intel Pentium III and Pentium 4 CPUs</ti></tr> 94 <ti>Stage 2 and 3 tarballs, GRP packages and liveCD for Intel Pentium III and Pentium 4 CPUs</ti>
76</table> 95 </tr>
77 96 </table>
78<p>Inside each of these directories, 97 <p>Inside each of these directories,
79you'll find a <path>livecd/</path> directory that contains LiveCDs. While these LiveCDs 98you'll find a <path>livecd/</path> directory that contains LiveCDs. While these LiveCDs
80will boot on any architecture, the install-related tarballs are optimized for a particular 99will boot on any architecture, the install-related tarballs are optimized for a particular
81CPU type and will not work on all systems, except for the "gentoo-basic" LiveCD in the <path>x86</path> 100CPU type and will not work on all systems, except for the &quot;gentoo-basic&quot; LiveCD in the <path>x86</path>
82directory which can be used to install on anything. 101directory which can be used to install on anything.
83</p> 102</p>
84
85<p> The LiveCDs are full CD images that should be burned to a CDR or CD-RW 103 <p> The LiveCDs are full CD images that should be burned to a CDR or CD-RW
86using CD burning software. Currently, we have two types of LiveCDs. The first 104using CD burning software. Currently, we have two types of LiveCDs. The first
87carries the "gentoo-basic" label, and is approximately 40MB in size and lives 105carries the &quot;gentoo-basic&quot; label, and is approximately 40MB in size and lives
88in the <path>x86/livecd/</path> directory. This LiveCD is of minimal size to 106in the <path>x86/livecd/</path> directory. This LiveCD is of minimal size to
89allow for a initial quick download and contains a stage1 tarball that can be 107allow for a initial quick download and contains a stage1 tarball that can be
90found in <path>/mnt/cdrom/gentoo/</path> after the CD has booted.</p> 108found in <path>/mnt/cdrom/gentoo/</path> after the CD has booted.</p>
91
92<p>The second flavor of LiveCD we currently offer is labelled "livecd-grp." 109 <p>The second flavor of LiveCD we currently offer is labelled &quot;livecd-grp.&quot;
93These CDs (found in their respective <path>arch/livecd</path> directories) 110These CDs (found in their respective <path>arch/livecd</path> directories)
94contain stage1, 2 and 3 tarballs, and also contain a set of GRP packages 111contain stage1, 2 and 3 tarballs, and also contain a set of GRP packages
95optimized for a specific architecture. Using these LiveCDs, it will be possible 112optimized for a specific architecture. Using these LiveCDs, it will be possible
96for you to install a fully-functional Gentoo Linux system very quickly. The 113for you to install a fully-functional Gentoo Linux system very quickly. The
97downside is that these ISO images are large -- around 600MB -- so they can take 114downside is that these ISO images are large -- around 600MB -- so they can take
98a while to download.</p> 115a while to download.</p>
99
100<info>If for some reason your install gets interrupted at some point, you can 116 <info>If for some reason your install gets interrupted at some point, you can
101reboot and restart. For example, if you have partitioned, installed the stageX 117reboot and restart. For example, if you have partitioned, installed the stageX
102tarball, and are ready to chroot, you can restart the install if necessary. 118tarball, and are ready to chroot, you can restart the install if necessary.
103Just re-boot with the LiveCD, then mount your drives/partitions to 119Just re-boot with the LiveCD, then mount your drives/partitions to
104<path>/mnt</path> as normal. Basically, you can do this at about any point 120<path>/mnt</path> as normal. Basically, you can do this at about any point
105during the install, just not before partitioning for obvious reasons. </info> 121during the install, just not before partitioning for obvious reasons. </info>
106
107<warn>If you encounter a problem with any part of the install and wish to 122 <warn>If you encounter a problem with any part of the install and wish to
108report it as a bug, report it to <uri>http://bugs.gentoo.org</uri>. If the bug 123report it as a bug, report it to <uri>http://bugs.gentoo.org</uri>. If the bug
109needs to be moved upstream to the package maintainers (ie KDE) the 124needs to be moved upstream to the package maintainers (ie KDE) the
110<e>developers</e> will take care of that. </warn> 125<e>developers</e> will take care of that. </warn>
111
112<p>Now, let's quickly review the install process. First, we'll download, burn 126 <p>Now, let's quickly review the install process. First, we'll download, burn
113and boot a LiveCD. After getting a root prompt, we'll create partitions, create 127and boot a LiveCD. After getting a root prompt, we'll create partitions, create
114our filesystems, and extract either a stage1, stage2 or stage3 tarball. If we 128our filesystems, and extract either a stage1, stage2 or stage3 tarball. If we
115are using a stage1 or stage2 tarball, we will take the appropriate steps to get 129are using a stage1 or stage2 tarball, we will take the appropriate steps to get
116our systems to stage3. Once our systems are at stage3, we can configure them 130our systems to stage3. Once our systems are at stage3, we can configure them
117(tweaking config files, installing a bootloader, etc) and boot them and have a 131(tweaking config files, installing a bootloader, etc) and boot them and have a
118fully-functional Gentoo Linux system. Depending on what stage of the build 132fully-functional Gentoo Linux system. Depending on what stage of the build
119process you're starting from, here's what's required for installation: </p> 133process you're starting from, here's what's required for installation: </p>
120 134 <table>
121<table>
122 <tr> 135 <tr>
123 <th>stage tarball</th> 136 <th>stage tarball</th>
124 <th>requirements for installation</th> 137 <th>requirements for installation</th>
125 </tr> 138 </tr>
126 <tr> 139 <tr>
127 <ti>1</ti> 140 <ti>1</ti>
128 <ti>partition/filesystem setup, emerge sync, bootstrap, emerge system, emerge linux sources, final configuration</ti> 141 <ti>partition/filesystem setup, emerge sync, bootstrap, emerge system, emerge linux sources, final configuration</ti>
129 </tr> 142 </tr>
130 <tr> 143 <tr>
131 <ti>2</ti> 144 <ti>2</ti>
132 <ti>partition/filesystem setup, emerge sync, emerge system, emerge linux sources, final configuration</ti> 145 <ti>partition/filesystem setup, emerge sync, emerge system, emerge linux sources, final configuration</ti>
133 </tr> 146 </tr>
134 <tr> 147 <tr>
135 <ti>3</ti> 148 <ti>3</ti>
136 <ti>partition/filesystem setup, emerge sync, final configuration</ti> 149 <ti>partition/filesystem setup, emerge sync, final configuration</ti>
143 <title>Booting</title> 156 <title>Booting</title>
144 <section> 157 <section>
145 <body> 158 <body>
146 <p>Start by booting the LiveCD. If detected properly, you should see a fancy boot screen 159 <p>Start by booting the LiveCD. If detected properly, you should see a fancy boot screen
147 with the Gentoo Linux logo on it. At this screen, you can hit Enter to begin the boot process, 160 with the Gentoo Linux logo on it. At this screen, you can hit Enter to begin the boot process,
148 hit F2 for help, or pass kernel boot options by typing <c>gentoo opt1 opt2</c>, etc. 161 hit F2 for help, or pass kernel boot options by typing <c>gentoo opt1 opt2</c>, etc.
149 Once you hit Enter, you'll be 162 Once you hit Enter, you'll be
150 greeted with a lot of text output 163 greeted with a lot of text output
151 followed by the normal Gentoo Linux boot sequence. 164 followed by the normal Gentoo Linux boot sequence.
152 You will be automatically logged in as &quot;root&quot; and the root password will be 165 You will be automatically logged in as &quot;root&quot; and the root password will be
153 set to a random string for security purposes. 166 set to a random string for security purposes.
154 You should have a root (&quot;<c>#</c>&quot;) prompt on the current 167 You should have a root (&quot;<c>#</c>&quot;) prompt on the current
155 console, and can also open new root consoles by pressing Alt-F2, Alt-F3 and Alt-F4. 168 console, and can also open new root consoles by pressing Alt-F2, Alt-F3 and Alt-F4.
156 Get back to the one you started on by pressing (you guessed it) Alt-F1. 169 Get back to the one you started on by pressing (you guessed it) Alt-F1.
157 </p> 170 </p>
158
159 <p>You've probably also noticed that above your <c>#</c> prompt is a bunch of help text 171 <p>You've probably also noticed that above your <c>#</c> prompt is a bunch of help text
160 explaining how to do things like configure your network devices and where you can find 172 explaining how to do things like configure your network devices and where you can find
161 the Gentoo Linux stage tarballs and packages on your CD. 173 the Gentoo Linux stage tarballs and packages on your CD.
162 </p> 174 </p>
163 </body> 175 </body>
164 </section> 176 </section>
165 </chapter> 177 </chapter>
166 <chapter> 178 <chapter>
167 <title>Load Kernel Modules</title> 179 <title>Load Kernel Modules</title>
168 <section> 180 <section>
169 <body> 181 <body>
170 <p>If the PCI autodetection missed some of your hardware, you 182 <p>If the PCI autodetection missed some of your hardware, you
171 will have to load the appropriate modules manually. 183 will have to load the appropriate modules manually.
172 To view a list of all available network card modules, type <c>ls 184 To view a list of all available network card modules, type <c>ls
173 /lib/modules/*/kernel/drivers/net/*</c>. To load a particular module, 185 /lib/modules/*/kernel/drivers/net/*</c>. To load a particular module,
174 type: 186 type:
189 <note> 201 <note>
190 Support for a SCSI CD-ROMs and disks are built-in in the kernel. 202 Support for a SCSI CD-ROMs and disks are built-in in the kernel.
191 </note></p> 203 </note></p>
192 <p>If you are using hardware RAID, you'll need to load the 204 <p>If you are using hardware RAID, you'll need to load the
193 ATA-RAID modules for your RAID controller. 205 ATA-RAID modules for your RAID controller.
194 </p> 206 </p>
195 <pre caption="Loading RAID Modules"> 207 <pre caption="Loading RAID Modules">
196# <c>insmod ataraid</c> 208# <c>insmod ataraid</c>
197# <c>insmod pdcraid</c> 209# <c>insmod pdcraid</c>
198 <comment>(Promise Raid Controller)</comment> 210 <comment>(Promise Raid Controller)</comment>
199# <c>insmod hptraid</c> 211# <c>insmod hptraid</c>
200 <comment>(Highpoint Raid Controller)</comment> 212 <comment>(Highpoint Raid Controller)</comment>
201 </pre> 213 </pre>
202 <p>The Gentoo LiveCD should have enabled DMA on your disks, but if it did not, 214 <p>The Gentoo LiveCD should have enabled DMA on your disks, but if it did not,
203 <c>hdparm</c> can be used to set DMA on your drives. </p> 215 <c>hdparm</c> can be used to set DMA on your drives. </p>
204<pre caption="Setting DMA"><comment>Replace hdX with your disk device.</comment> 216 <pre caption="Setting DMA"><comment>Replace hdX with your disk device.</comment>
205# hdparm -d 1 /dev/hdX <comment>Enables DMA </comment> 217# hdparm -d 1 /dev/hdX <comment>Enables DMA </comment>
206# hdparm -d1 -A1 -m16 -u1 -a64 <comment>Enables DMA and other safe performance-enhancing options</comment> 218# hdparm -d1 -A1 -m16 -u1 -a64 <comment>Enables DMA and other safe performance-enhancing options</comment>
207# hdparm -X66 /dev/hdX <comment>Force-enables Ultra-DMA -- dangerous -- may cause some drives to mess up</comment> 219# hdparm -X66 /dev/hdX <comment>Force-enables Ultra-DMA -- dangerous -- may cause some drives to mess up</comment></pre>
208</pre>
209 </body> 220 </body>
210 </section> 221 </section>
211 </chapter> 222 </chapter>
212 <chapter> 223 <chapter>
213 <title>Loading PCMCIA Kernel Modules</title> 224 <title>Loading PCMCIA Kernel Modules</title>
214 <section> 225 <section>
215 <body> 226 <body>
216 <p>If you have a PCMCIA network card, you will need to do some additional 227 <p>If you have a PCMCIA network card, you will need to do some additional
217 trickery. 228 trickery.
218 </p> 229 </p>
219 <warn>To avoid problems with <c>cardmgr</c>, you <e>must</e> run it <e>before</e> you enter the chroot 230 <warn>To avoid problems with <c>cardmgr</c>, you <e>must</e> run it <e>before</e> you enter the chroot
220 portion of the install. </warn> 231 portion of the install. </warn>
221 <pre caption="Loading PCMCIA Modules"> 232 <pre caption="Loading PCMCIA Modules">
222# <i>insmod pcmcia_core</i> 233# <i>insmod pcmcia_core</i>
223# <i>insmod i82365</i> 234# <i>insmod i82365</i>
420 </tr> 431 </tr>
421 <tr> 432 <tr>
422 <ti>root partition, containing main filesystem (/usr, /home, etc)</ti> 433 <ti>root partition, containing main filesystem (/usr, /home, etc)</ti>
423 <ti>&gt;=1.5 Gigabytes</ti> 434 <ti>&gt;=1.5 Gigabytes</ti>
424 <ti>ReiserFS, ext3 recommended; ext2 ok</ti> 435 <ti>ReiserFS, ext3 recommended; ext2 ok</ti>
425 <ti>/dev/hda3</ti> 436 <ti>/dev/hda3</ti>
426 </tr> 437 </tr>
427 </table> 438 </table>
428 <p>Before creating filesystems, you may want to initialize the 439 <p>Before creating filesystems, you may want to initialize the
429 beginning of your HD using <c>dd</c>. Doing this will ensure that your new filesystem 440 beginning of your HD using <c>dd</c>. Doing this will ensure that your new filesystem
430 will not be mis-indentified by Linux's mounting code. 441 will not be mis-indentified by Linux's mounting code.
431 This can be done as follows: 442 This can be done as follows:
432 </p> 443 </p>
433 <pre caption="Initializing first 1024 Sectors of HD"> 444 <pre caption="Initializing first 1024 Sectors of HD">
434# <c>dd if=/dev/zero of=/dev/hdxy bs=1024 count=1024 </c> 445# <c>dd if=/dev/zero of=/dev/hdxy bs=1024 count=1024 </c>
435<comment>Replace /dev/hdxy with the device you wish to "clean."</comment> 446<comment>Replace /dev/hdxy with the device you wish to &quot;clean.&quot;</comment>
436 </pre> 447 </pre>
437 <p>At this point, create your partitions using <c>fdisk</c>. Note that your partitions 448 <p>At this point, create your partitions using <c>fdisk</c>. Note that your partitions
438 should be of type 82 if swap and 83 for regular filesystems (whether ReiserFS, ext2/3 or other). </p> 449 should be of type 82 if swap and 83 for regular filesystems (whether ReiserFS, ext2/3 or other). </p>
439 <note><c>cfdisk</c> is included on the install CD, and it is <i>considerably</i> easier to use than 450 <note><c>cfdisk</c> is included on the install CD, and it is <i>considerably</i> easier to use than
440 <c>fdisk</c>. Just type <c>cfdisk</c> to run it; by default, cfdisk will work with <b>/dev/hda</b>. If /dev/hda is not the hard disk you want to partition, give the right value to cfdisk as a parameter. For example: <c>cfdisk /dev/hde</c></note> 451 <c>fdisk</c>. Just type <c>cfdisk</c> to run it; by default, cfdisk will work with <b>/dev/hda</b>. If /dev/hda is not the hard disk you want to partition, give the right value to cfdisk as a parameter. For example: <c>cfdisk /dev/hde</c></note>
441
442
443<note>If <c>fdisk</c> or <c>cfdisk</c> instruct you to do so, please reboot to allow your system to detect the 452 <note>If <c>fdisk</c> or <c>cfdisk</c> instruct you to do so, please reboot to allow your system to detect the
444new partition configuration.</note> 453new partition configuration.</note>
445
446
447<note>If you are using RAID your partitions will be a little different. You 454 <note>If you are using RAID your partitions will be a little different. You
448will have the partitions like this: <path>/dev/ataraid/discX/partY</path> X is 455will have the partitions like this: <path>/dev/ataraid/discX/partY</path> X is
449the arrays you have made, so if you only have made 1 array, then it will be 456the arrays you have made, so if you only have made 1 array, then it will be
450disc0.Y is the partition number as in <path>/dev/hdaY</path> </note> 457disc0.Y is the partition number as in <path>/dev/hdaY</path> </note>
451
452
453
454<p>Once you've created your partitions, it's time to initialize 458 <p>Once you've created your partitions, it's time to initialize
455 the filesystems that will be used to house our data. Initialize swap as follows:</p> 459 the filesystems that will be used to house our data. Initialize swap as follows:</p>
456 <pre caption="Initializing Swap"> 460 <pre caption="Initializing Swap">
457# <c>mkswap /dev/hda2</c> 461# <c>mkswap /dev/hda2</c>
458 </pre> 462 </pre>
459 <p>You can use the <c>mke2fs</c> command to create ext2 filesystems.</p> 463 <p>You can use the <c>mke2fs</c> command to create ext2 filesystems.</p>
460 <pre caption="Creating an ext2 Filesystem"> 464 <pre caption="Creating an ext2 Filesystem">
461# <i>mke2fs /dev/hda1</i> 465# <i>mke2fs /dev/hda1</i>
462 </pre> 466 </pre>
463 <p>To create an XFS filesystem, use the <c>mkfs.xfs</c> command.</p> 467 <p>To create an XFS filesystem, use the <c>mkfs.xfs</c> command.</p>
464 <pre caption="Creating a XFS Filesystem"> 468 <pre caption="Creating a XFS Filesystem">
465# <c>mkfs.xfs /dev/hda3</c> 469# <c>mkfs.xfs /dev/hda3</c>
466 </pre> 470 </pre>
467 <note> 471 <note>
468 You may want to add a couple of additional flags to the <c>mkfs.xfs</c> command: <c>-d agcount=3 -l size=32m</c>. 472 You may want to add a couple of additional flags to the <c>mkfs.xfs</c> command: <c>-d agcount=3 -l size=32m</c>.
469 The <c>-d agcount=3</c> command will lower 473 The <c>-d agcount=3</c> command will lower
497 <body> 501 <body>
498 <p>Now, we'll activate our new swap, since we may need the additional virtual memory that 502 <p>Now, we'll activate our new swap, since we may need the additional virtual memory that
499 provides later: 503 provides later:
500 </p> 504 </p>
501 <pre caption="Activating Swap"> 505 <pre caption="Activating Swap">
502# <c>swapon /dev/hda2</c> 506# <c>swapon /dev/hda2</c>
503 </pre> 507 </pre>
504 <p>Next, we'll create the <path>/mnt/gentoo</path> and <path>/mnt/gentoo/boot</path> mountpoints, 508 <p>Next, we'll create the <path>/mnt/gentoo</path> and <path>/mnt/gentoo/boot</path> mountpoints,
505 and we'll mount our filesystems to these mountpoints. </p> 509 and we'll mount our filesystems to these mountpoints. </p>
506 <pre caption="Creating Mount Points"> 510 <pre caption="Creating Mount Points">
507# <c>mkdir /mnt/gentoo</c> 511# <c>mkdir /mnt/gentoo</c>
508# <c>mount /dev/hda3 /mnt/gentoo</c> 512# <c>mount /dev/hda3 /mnt/gentoo</c>
509# <c>mkdir /mnt/gentoo/boot</c> 513# <c>mkdir /mnt/gentoo/boot</c>
510# <c>mount /dev/hda1 /mnt/gentoo/boot</c> 514# <c>mount /dev/hda1 /mnt/gentoo/boot</c>
511 </pre> 515 </pre>
512 <p> 516 <p>
513 If you are setting up Gentoo 517 If you are setting up Gentoo
514 Linux with a separate <path>/usr</path> or <path>/var</path>, these would get mounted to 518 Linux with a separate <path>/usr</path> or <path>/var</path>, these would get mounted to
515 <path>/mnt/gentoo/usr</path> and <path>/mnt/gentoo/var</path>, respectively. 519 <path>/mnt/gentoo/usr</path> and <path>/mnt/gentoo/var</path>, respectively.
516 </p> 520 </p>
517 <p>Additionally, perform the following steps if you'd like to take advantage of your CD's set of pre-built 521 <p>If you decide to use the GRP (Gentoo Reference Platform), now is the time to set it up.
518"GRP" packages for openoffice, KDE, GNOME and Xfree86. First, ensure that you're using the required "gentoo-grp" 522</p>
519CD. Then, type:</p> 523 <p>First, you will need to <c>cd</c> to the location of the packages directory, for the
520<pre caption="Getting ready for GRP"> 524liveCD you will find it at <path>/mnt/cdrom/gentoo/packages</path>. In that directory you
521# install -d /mnt/gentoo/usr/portage/packages 525will find the <c>grp-install.sh</c> script, an <i>All</i> directory that contains all of the binary
522# mount --bind /mnt/cdrom/gentoo/packages /mnt/gentoo/usr/portage/packages 526packages, and a list of available GRP packages. To install any/all of these
527package sets you should do the following: </p>
528 <pre caption="Using GRP">
529# <c>sh grp-install.sh &lt;list of package lists&gt;</c>
530<comment>where &lt;list of package lists&gt; may be any of the *-list.txt files found in the same directory.</comment>
523</pre> 531</pre>
532 <p><c>grp-install.sh</c> can be run multiple times without replacing existing installations. You can
533do a <c>sh grp-install.sh</c> for a basic usage description if you are still a bit foggy.
534</p>
524 <impo>If your <e>boot</e> partition (the one holding the kernel) is ReiserFS, be sure to mount it 535 <impo>If your <e>boot</e> partition (the one holding the kernel) is ReiserFS, be sure to mount it
525 with the <c>-o notail</c> option so GRUB gets properly installed. Make sure 536 with the <c>-o notail</c> option so GRUB gets properly installed. Make sure
526 that <c>notail</c> ends up in your new <path>/etc/fstab</path> boot partition entry, too. 537 that <c>notail</c> ends up in your new <path>/etc/fstab</path> boot partition entry, too.
527 We'll get to that in a bit. 538 We'll get to that in a bit.
528 </impo> 539 </impo>
529 <impo>If you are having problems mounting your boot partition with ext2, try using 540 <impo>If you are having problems mounting your boot partition with ext2, try using
530 <c>mount /dev/hXX /mnt/gentoo/boot -t ext2 </c> </impo> 541 <c>mount /dev/hXX /mnt/gentoo/boot -t ext2 </c> </impo>
531 </body> 542 </body>
532 </section> 543 </section>
533 </chapter> 544 </chapter>
534 <chapter> 545 <chapter>
535 <title>Obtaining the Desired 'stage-x' Tarball</title> 546 <title>Obtaining the Desired 'stage-x' Tarball</title>
536 <section> 547 <section>
537 <body> 548 <body>
538 <p>If you want to start from a stage1 tarball, then you're already set 549 <p>If you want to start from a stage1 tarball, then you're already set
539 to go; you can find the stage1 tarball in <path>/mnt/cdrom/gentoo/</path>. 550 to go; you can find the stage1 tarball in <path>/mnt/cdrom/gentoo/</path>.
543 from one of the Gentoo mirror sites. </p> 554 from one of the Gentoo mirror sites. </p>
544 <pre caption="Downloading Required Stages"> 555 <pre caption="Downloading Required Stages">
545# <c>cd /mnt/gentoo</c> 556# <c>cd /mnt/gentoo</c>
546<comment>Use lynx to get the URL for your tarball</comment> 557<comment>Use lynx to get the URL for your tarball</comment>
547# <c>lynx http://www.ibiblio.org/pub/Linux/distributions/gentoo/releases/1.4_rc2/x86/</c> 558# <c>lynx http://www.ibiblio.org/pub/Linux/distributions/gentoo/releases/1.4_rc2/x86/</c>
548# <c>wget <comment>insert required stage tarball here.</comment></c> 559# <c>wget <comment>insert required stage tarball here.</comment></c>
549 </pre> 560 </pre>
550 </body> 561 </body>
551 </section> 562 </section>
552 </chapter> 563 </chapter>
553 <chapter> 564 <chapter>
554 <title>Unpacking the Stage Tarballs</title> 565 <title>Unpacking the Stage Tarballs</title>
555 <section> 566 <section>
556 <body> 567 <body>
557 <p>Now it's time to extract the compressed stage tarball of your choice to <path>/mnt/gentoo</path>. 568 <p>Now it's time to extract the compressed stage tarball of your choice to <path>/mnt/gentoo</path>.
558 Then, we'll <c>chroot</c> over to the new Gentoo Linux build installation to "enter" the new 569 Then, we'll <c>chroot</c> over to the new Gentoo Linux build installation to &quot;enter&quot; the new
559 Gentoo Linux system. 570 Gentoo Linux system.
560 </p> 571 </p>
561 <impo>Be sure to use the <c>p</c> option with <c>tar</c>. Forgetting to do this will 572 <impo>Be sure to use the <c>p</c> option with <c>tar</c>. Forgetting to do this will
562 cause certain files to have incorrect permissions.</impo> 573 cause certain files to have incorrect permissions.</impo>
563 <p>If you are using the &quot;from scratch, build everything&quot; install method, 574 <p>If you are using the &quot;from scratch, build everything&quot; install method,
564 you will want to use the <path>stage1-ix86-1.4_beta.tbz2</path> image. 575 you will want to use the <path>stage1-ix86-1.4_beta.tbz2</path> image.
565 If you're using one of our bigger CDs, you'll also have a choice of a stage2 and stage3 image. 576 If you're using one of our bigger CDs, you'll also have a choice of a stage2 and stage3 image.
566 These images allow you to save time at the expense of configurability (we've already chosen 577 These images allow you to save time at the expense of configurability (we've already chosen
567 compiler optimizations and default USE variables for you.) 578 compiler optimizations and default USE variables for you.)
568 </p> 579 </p>
569 <pre caption="Unpacking the Stages"> 580 <pre caption="Unpacking the Stages">
570# <c>cd /mnt/gentoo</c> 581# <c>cd /mnt/gentoo</c>
571# <c>tar -xvjpf /mnt/cdrom/gentoo/stage?-*.tbz2</c> 582# <c>tar -xvjpf /mnt/cdrom/gentoo/stage?-*.tbz2</c>
572# <c>mount -o bind /proc /mnt/gentoo/proc</c> 583# <c>mount -o bind /proc /mnt/gentoo/proc</c>
573# <c>cp /etc/resolv.conf /mnt/gentoo/etc/resolv.conf</c> 584# <c>cp /etc/resolv.conf /mnt/gentoo/etc/resolv.conf</c>
708 <body> 719 <body>
709 <p>The stage3 tarball is already configured for your system. There is not much to do for this stage, 720 <p>The stage3 tarball is already configured for your system. There is not much to do for this stage,
710 but it is a very good idea to update your system to the newest available packages. </p> 721 but it is a very good idea to update your system to the newest available packages. </p>
711 <note>If you have not already edited <path>/etc/make.conf</path> to fit your specifications, 722 <note>If you have not already edited <path>/etc/make.conf</path> to fit your specifications,
712 now would be a good time to do so. </note> 723 now would be a good time to do so. </note>
713 <pre caption="Getting up-to-date"> 724 <pre caption="Getting up-to-date">
714 # <c>emerge sync</c> 725 # <c>emerge sync</c>
715 # <c>emerge -up world</c> 726 # <c>emerge -up world</c>
716 <comment>lists [<i>packages</i>] to be installed</comment> 727 <comment>lists [<i>packages</i>] to be installed</comment>
717 # <c>emerge -u world</c> 728 # <c>emerge -u world</c>
718 </pre> 729 </pre>
719 </body> 730 </body>
720 </section> 731 </section>
721 </chapter> 732 </chapter>
722 <chapter> 733 <chapter>
723 <title>Using GRP</title> 734 <title>Using GRP</title>
724 <section> 735 <section>
725 <body> 736 <body>
726
727<p>If you bind mounted <path>/mnt/cdrom/gentoo/packages</path> previously, you can take advantage of pre-built GRP package sets 737 <p>If you bind mounted <path>/mnt/cdrom/gentoo/packages</path> previously, you can take advantage of pre-built GRP package sets
728to avoid compiling certain popular and large packages. Currently, we provide full builds of everything you need for <c>openoffice-bin</c>, 738to avoid compiling certain popular and large packages. Currently, we provide full builds of everything you need for <c>openoffice-bin</c>,
729<c>gnome</c>, <c>kde</c> and <c>xfree</c>. To merge these pre-built packages, type:</p> 739<c>gnome</c>, <c>kde</c> and <c>xfree</c>. To merge these pre-built packages, type:</p>
730<pre caption="Using GRP"> 740 <pre caption="Using GRP">
731# emerge --usepkgonly kde 741# emerge --usepkgonly kde
732</pre> 742</pre>
733<p>Optionally, you can use pre-built packages combined with any updates available in your new Portage tree by typing:</p> 743 <p>Optionally, you can use pre-built packages combined with any updates available in your new Portage tree by typing:</p>
734<pre caption="Using GRP with updates"> 744 <pre caption="Using GRP with updates">
735# emerge --usepkg openoffice-bin 745# emerge --usepkg openoffice-bin
736</pre> 746</pre>
737 </body> 747 </body>
738 </section> 748 </section>
739</chapter> 749 </chapter>
740
741 <chapter> 750 <chapter>
742 <title>Final Steps: Timezone</title> 751 <title>Final Steps: Timezone</title>
743 <section> 752 <section>
744 <body> 753 <body>
745 <p>At this point, you should have system that's ready for final configuration. 754 <p>At this point, you should have system that's ready for final configuration.
746 We'll start the configuration process by setting the timezone. By setting the timezone before building 755 We'll start the configuration process by setting the timezone. By setting the timezone before building
747 the kernel we ensure that users get reasonable <c>uname -a</c> output. 756 the kernel we ensure that users get reasonable <c>uname -a</c> output.
748 </p> 757 </p>
749 <p>Look for your timezone (or GMT if you using Greenwich Mean Time) in 758 <p>Look for your timezone (or GMT if you using Greenwich Mean Time) in
750 <path>/usr/share/zoneinfo</path>. Then, make a symbolic link by typing: 759 <path>/usr/share/zoneinfo</path>. Then, make a symbolic link by typing:
751 </p> 760 </p>
752 <pre caption="Creating a symbolic link for timezome"> 761 <pre caption="Creating a symbolic link for timezome">
753# <c>ln -sf /usr/share/zoneinfo/path/to/timezonefile /etc/localtime</c> 762# <c>ln -sf /usr/share/zoneinfo/path/to/timezonefile /etc/localtime</c>
754 </pre> 763 </pre>
755 <p>You might also want to check <path>/etc/rc.conf</path> to make sure your timezone settings 764 <p>You might also want to check <path>/etc/rc.conf</path> to make sure your timezone settings
915 Right now, we offer dcron, fcron and vcron. If you don't know which one to choose, 924 Right now, we offer dcron, fcron and vcron. If you don't know which one to choose,
916 you might as well grab vcron. They can be installed as follows: 925 you might as well grab vcron. They can be installed as follows:
917 </p> 926 </p>
918 <pre caption="Choosing a CRON Daemon"> 927 <pre caption="Choosing a CRON Daemon">
919# <c>emerge sys-apps/dcron</c> 928# <c>emerge sys-apps/dcron</c>
920# <c>crontab /etc/crontab</c> 929# <c>crontab /etc/crontab</c>
921<comment>or</comment> 930<comment>or</comment>
922# <c>emerge sys-apps/fcron</c> 931# <c>emerge sys-apps/fcron</c>
923# <c>crontab /etc/crontab</c> 932# <c>crontab /etc/crontab</c>
924<comment>or</comment> 933<comment>or</comment>
925# <c>emerge sys-apps/vcron</c> 934# <c>emerge sys-apps/vcron</c>
926<comment>You do not need to run <c>crontab /etc/crontab</c> if using vcron. </comment> 935<comment>You do not need to run <c>crontab /etc/crontab</c> if using vcron. </comment>
927<comment>Don't forget to add your *cron to the proper init level. </comment> 936<comment>Don't forget to add your *cron to the proper init level. </comment>
928# <c>rc-update add *cron default </c> 937# <c>rc-update add *cron default </c>
929 </pre> 938 </pre>
930 <!--<p>For more information how how cron works under Gentoo Linux, 939<!--<p>For more information how how cron works under Gentoo Linux,
931 see <uri link="http://lists.gentoo.org/pipermail/gentoo-announce/2002-April/000151.html">this announcement</uri>.</p>--> 940 see <uri link="http://lists.gentoo.org/pipermail/gentoo-announce/2002-April/000151.html">this announcement</uri>.</p>-->
932 <p>For more information on starting programs and daemons at startup, see the 941 <p>For more information on starting programs and daemons at startup, see the
933 <uri link="/doc/en/rc-scripts.xml">rc-script guide</uri>. 942 <uri link="/doc/en/rc-scripts.xml">rc-script guide</uri>.
934 </p> 943 </p>
935 </body> 944 </body>
936 </section> 945 </section>
937 </chapter> 946 </chapter>
938 <chapter> 947 <chapter>
939 <title>Final steps: Install Additional Packages</title> 948 <title>Final steps: Install Additional Packages</title>
940 <section> 949 <section>
941 <body> 950 <body>
942 <p>If you need rp-pppoe to connect to the net, be aware that at this point 951 <p>If you need rp-pppoe to connect to the net, be aware that at this point
943 it has not been installed. It would be the good time to do it. </p> 952 it has not been installed. It would be the good time to do it. </p>
944 <pre caption="Installing rp-pppoe"> 953 <pre caption="Installing rp-pppoe">
945# <c>emerge rp-pppoe</c> 954# <c>emerge rp-pppoe</c>
1328 bootdisk like this: 1337 bootdisk like this:
1329 </p> 1338 </p>
1330 <pre caption="Creating a GRUB Bootdisk"> 1339 <pre caption="Creating a GRUB Bootdisk">
1331# <c>mke2fs /dev/fd0</c> 1340# <c>mke2fs /dev/fd0</c>
1332# <c>mount /dev/fd0 /mnt/floppy</c> 1341# <c>mount /dev/fd0 /mnt/floppy</c>
1333# <c>mkdir -p /mnt/floppy/boot/grub</c> 1342# <c>mkdir -p /mnt/floppy/boot/grub</c>
1334# <c>cp /usr/share/grub/i386-pc/stage1 /mnt/floppy/boot/grub/</c> 1343# <c>cp /usr/share/grub/i386-pc/stage1 /mnt/floppy/boot/grub/</c>
1335# <c>cp /usr/share/grub/i386-pc/stage2 /mnt/floppy/boot/grub/</c> 1344# <c>cp /usr/share/grub/i386-pc/stage2 /mnt/floppy/boot/grub/</c>
1336 1345
1337# <c>grub</c> 1346# <c>grub</c>
1338 1347
1339grub&gt; <c>root (fd0)</c> 1348grub&gt; <c>root (fd0)</c>
1340grub&gt; <c>setup (fd0)</c> 1349grub&gt; <c>setup (fd0)</c>
1341grub&gt; <c>quit</c> 1350grub&gt; <c>quit</c>
1342 </pre> 1351 </pre>
1343 <p>Now reboot and load the floppy. At the floppy's <c>grub&gt;</c> prompt, you can now execute the necessary <c>root</c> 1352 <p>Now reboot and load the floppy. At the floppy's <c>grub&gt;</c> prompt, you can now execute the necessary <c>root</c>
1344 and <c>setup</c> commands.</p> 1353 and <c>setup</c> commands.</p>
1345 </body> 1354 </body>
1346 </section> 1355 </section>
1347 <section> 1356 <section>
1348 <title>LILO Bootdisks</title> 1357 <title>LILO Bootdisks</title>
1349 <body> 1358 <body>
1350 <p>If you are using LILO, it is also a good idea to make a bootdisk: 1359 <p>If you are using LILO, it is also a good idea to make a bootdisk:
1351 </p> 1360 </p>
1352 <pre caption="Making a LILO Bootdisk"> 1361 <pre caption="Making a LILO Bootdisk">
1353# <c>dd if=/boot/your_kernel of=/dev/fd0 </c> 1362# <c>dd if=/boot/your_kernel of=/dev/fd0 </c>
1354<comment>This will only work if your kernel is smaller than 1.4MB</comment> 1363<comment>This will only work if your kernel is smaller than 1.4MB</comment>
1355 </pre> 1364 </pre>
1356 </body> 1365 </body>
1357 </section> 1366 </section>
1358 </chapter> 1367 </chapter>

Legend:
Removed from v.1.25  
changed lines
  Added in v.1.26

  ViewVC Help
Powered by ViewVC 1.1.20