/[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.176 Revision 1.177
1<?xml version="1.0" encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<guide link="/doc/en/gentoo-x86-install.xml"> 3<guide link="/doc/en/gentoo-x86-install.xml">
4<title>Gentoo Linux 1.4 Installation Instructions</title> 4<title>Gentoo Linux 1.4 Installation Instructions</title>
5
5<author title="Chief Architect"> 6<author title="Chief Architect">
6 <mail link="drobbins@gentoo.org">Daniel Robbins</mail> 7 <mail link="drobbins@gentoo.org">Daniel Robbins</mail>
7</author> 8</author>
8<author title="Author">Chris Houser</author> 9<author title="Author">
9<author title="Author">Jerry Alexandratos</author> 10 Chris Houser
11</author>
12<author title="Author">
13 Jerry Alexandratos
14</author>
10<author title="Ghost, Reviewer"> 15<author title="Ghost, Reviewer">
11 <mail link="g2boojum@gentoo.org">Grant Goodyear</mail> 16 <mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
12</author> 17</author>
13<author title="Editor"> 18<author title="Editor">
14 <mail link="zhen@gentoo.org">John P. Davis</mail> 19 <mail link="zhen@gentoo.org">John P. Davis</mail>
15</author> 20</author>
16<author title="Editor"> 21<author title="Editor">
17 <mail link="Pierre-Henri.Jondot@wanadoo.fr">Pierre-Henri Jondot</mail> 22 <mail link="Pierre-Henri.Jondot@wanadoo.fr">Pierre-Henri Jondot</mail>
18</author> 23</author>
19<author title="Editor"> 24<author title="Editor">
20 <mail link="stocke2@gentoo.org">Eric Stockbridge</mail> 25 <mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
21</author> 26</author>
22<author title="Editor"> 27<author title="Editor">
23 <mail link="rajiv@gentoo.org">Rajiv Manglani</mail> 28 <mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
24</author> 29</author>
25<author title="Editor"> 30<author title="Editor">
26 <mail link="seo@gentoo.org">Jungmin Seo</mail> 31 <mail link="seo@gentoo.org">Jungmin Seo</mail>
27</author> 32</author>
28<author title="Editor"> 33<author title="Editor">
29 <mail link="zhware@gentoo.org">Stoyan Zhekov</mail> 34 <mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
30</author> 35</author>
31<author title="Editor"> 36<author title="Editor">
32 <mail link="jhhudso@gentoo.org">Jared Hudson</mail> 37 <mail link="jhhudso@gentoo.org">Jared Hudson</mail>
33</author>
34<author title="Editor">Colin Morey</author>
35<author title="Editor">
36 <mail link="peesh@gentoo.org">Jorge Paulo</mail>
37</author> 38</author>
38<author title="Editor"> 39<author title="Editor">
40 Colin Morey
41</author>
42<author title="Editor">
43 <mail link="peesh@gentoo.org">Jorge Paulo</mail>
44</author>
45<author title="Editor">
39 <mail link="carl@gentoo.org">Carl Anderson</mail> 46 <mail link="carl@gentoo.org">Carl Anderson</mail>
40</author> 47</author>
41<author title="Editor, Reviewer"> 48<author title="Editor, Reviewer">
42 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 49 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
43</author> 50</author>
44<author title="Editor"> 51<author title="Editor">
45 <mail link="avenj@gentoo.org">Jon Portnoy</mail> 52 <mail link="avenj@gentoo.org">Jon Portnoy</mail>
46</author> 53</author>
47<author title="Editor"> 54<author title="Editor">
48 <mail link="klasikahl@gentoo.org">Zack Gilburd</mail> 55 <mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
49</author> 56</author>
50<author title="Editor"> 57<author title="Editor">
51 <mail link="erwin@gentoo.org">Erwin</mail> 58 <mail link="erwin@gentoo.org">Erwin</mail>
52</author> 59</author>
53<author title="Reviewer"> 60<author title="Reviewer">
54 <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail> 61 <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
55</author> 62</author>
56<author title="Reviewer"> 63<author title="Reviewer">
57 <mail link="spyderous@gentoo.org">Donnie Berkholz</mail> 64 <mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
58</author> 65</author>
59<author title="Reviewer"> 66<author title="Reviewer">
60 <mail link="antifa@gentoo.org">Ken Nowack</mail> 67 <mail link="antifa@gentoo.org">Ken Nowack</mail>
61</author> 68</author>
62<author title="Editor, Reviewer"> 69<author title="Editor, Reviewer">
63 <mail link="bennyc@gentoo.org">Benny Chuang</mail> 70 <mail link="bennyc@gentoo.org">Benny Chuang</mail>
64</author> 71</author>
65 72
66<abstract> 73<abstract>
67These instructions step you through the process of installing Gentoo 74These instructions step you through the process of installing Gentoo
68Linux 1.4, release version (not _rc versions). The Gentoo Linux installation 75Linux 1.4, release version (not _rc versions). The Gentoo Linux installation
90 97
91<p> 98<p>
92One significant change in relation to the official 1.4 release is 99One significant change in relation to the official 1.4 release is
93our new 2-CD installation set, which can be ordered from <uri 100our new 2-CD installation set, which can be ordered from <uri
94link="http://store.gentoo.org">The Gentoo Linux Store</uri>, in 101link="http://store.gentoo.org">The Gentoo Linux Store</uri>, in
95addition to being available on our 102addition to being available on our <uri
96<uri link="http://www.gentoo.org/main/en/mirrors.xml">mirrors</uri>. 103link="http://www.gentoo.org/main/en/mirrors.xml">mirrors</uri>.
97We currently have 2-CD installation sets for x86 (486 and above), 104We currently have 2-CD installation sets for x86 (486 and above),
98i686 (Pentium Pro, Pentium II, Athlon/Duron and above), Pentium III, 105i686 (Pentium Pro, Pentium II, Athlon/Duron and above), Pentium III,
99Pentium 4 and Athlon XP. To see what 2-CD set is right for you, read 106Pentium 4 and Athlon XP. To see what 2-CD set is right for you, read
100the detailed descriptions of each product in the <uri 107the detailed descriptions of each product in the <uri
101link="http://store.gentoo.org">store</uri>. The store descriptions 108link="http://store.gentoo.org">store</uri>. The store descriptions
113</section> 120</section>
114<section> 121<section>
115<title>The Installation CDs</title> 122<title>The Installation CDs</title>
116<body> 123<body>
117 124
125<p>
118<p>So, about the 2 CD set -- here's what's on each CD. The first 126So, about the 2 CD set -- here's what's on each CD. The first
119CD ("CD 1") is called "Live CD Installation" and is a bootable CD-ROM, 127CD ("CD 1") is called "Live CD Installation" and is a bootable CD-ROM,
120meaning that you can put "CD 1" in your drive and run Gentoo Linux 128meaning that you can put "CD 1" in your drive and run Gentoo Linux
121directly from the CD. You can then use this CD-based version of 129directly from the CD. You can then use this CD-based version of
122Gentoo to install Gentoo Linux 1.4 to your hard disk. In addition 130Gentoo to install Gentoo Linux 1.4 to your hard disk. In addition
123to containing a bootable Gentoo Linux environment, CD 1 131to containing a bootable Gentoo Linux environment, CD 1
255team) the <e>Gentoo Linux developers</e> will take care of that for you. 263team) the <e>Gentoo Linux developers</e> will take care of that for you.
256</impo> 264</impo>
257 265
258<note> 266<note>
259The installation instructions in the LiveCD may not be as up-to-date as our 267The installation instructions in the LiveCD may not be as up-to-date as our
268Web documentation at
260Web documentation at <uri>http://www.gentoo.org/doc/en/gentoo-x86-install.xml</uri>. 269<uri>http://www.gentoo.org/doc/en/gentoo-x86-install.xml</uri>.
261Refer to our Web documentation for the most up-to-date installation 270Refer to our Web documentation for the most up-to-date installation
262instructions. 271instructions.
263</note> 272</note>
264 273
265</body> 274</body>
290<tcolumn width="0.75in"/> 299<tcolumn width="0.75in"/>
291<tcolumn width="1in"/> 300<tcolumn width="1in"/>
292<tcolumn width="1.25in"/> 301<tcolumn width="1.25in"/>
293<tcolumn width="3.5in"/> 302<tcolumn width="3.5in"/>
294<tr> 303<tr>
295 <th>Stage Tarball</th> 304 <th>Stage Tarball</th>
296 <th>Internet Access Required</th> 305 <th>Internet Access Required</th>
297 <th>Media Required</th> 306 <th>Media Required</th>
298 <th>Steps</th> 307 <th>Steps</th>
299</tr>
300<tr> 308</tr>
309<tr>
301 <ti>1</ti> 310 <ti>1</ti>
302 <ti>Yes</ti> 311 <ti>Yes</ti>
303 <ti><e>basic</e> or <e>CD 1</e></ti> 312 <ti><e>basic</e> or <e>CD 1</e></ti>
313 <ti>
304 <ti>partition/filesystem setup, emerge sync, bootstrap, emerge system, final config</ti> 314 Partition/filesystem setup, emerge sync, bootstrap, emerge system, final
305</tr> 315 config
316 </ti>
306<tr> 317</tr>
318<tr>
307 <ti>2</ti> 319 <ti>2</ti>
308 <ti>Yes</ti> 320 <ti>Yes</ti>
309 <ti><e>basic</e> or <e>CD 1</e></ti> 321 <ti><e>basic</e> or <e>CD 1</e></ti>
310 <ti>partition/filesystem setup, emerge sync, emerge system, final config</ti> 322 <ti>Partition/filesystem setup, emerge sync, emerge system, final config</ti>
311</tr>
312<tr> 323</tr>
324<tr>
313 <ti>3</ti> 325 <ti>3</ti>
314 <ti>No if using <e>CD 1</e>, Yes otherwise</ti> 326 <ti>No if using <e>CD 1</e>, Yes otherwise</ti>
315 <ti><e>basic</e> or <e>CD 1</e></ti> 327 <ti><e>basic</e> or <e>CD 1</e></ti>
328 <ti>
316 <ti>partition/filesystem setup, emerge sync (not required if using <e>CD 1</e>), final config</ti> 329 Partition/filesystem setup, emerge sync (not required if using <e>CD 1</e>),
317</tr> 330 final config
331 </ti>
318<tr> 332</tr>
333<tr>
319 <ti>3+GRP</ti> 334 <ti>3+GRP</ti>
320 <ti>No</ti> 335 <ti>No</ti>
321 <ti><e>CD 1</e>, <e>CD 2</e> optionally</ti> 336 <ti><e>CD 1</e>, <e>CD 2</e> optionally</ti>
322 <ti>partition/filesystem setup, final config, install CD 1 pre-built packages (optional), reboot, install extra pre-built packages like KDE and GNOME (if using "CD 2")</ti> 337 <ti>
338 Partition/filesystem setup, final config, install CD 1 pre-built packages
339 (optional), reboot, install extra pre-built packages like KDE and GNOME
340 (if using "CD 2")
341 </ti>
323</tr> 342</tr>
324</table> 343</table>
325 344
326<note> 345<note>
327Hardware ATA RAID users should read the section about ATA RAID on the bottom 346Hardware ATA RAID users should read the section about ATA RAID on the bottom
352If you are installing Gentoo Linux on a system with more than one 371If you are installing Gentoo Linux on a system with more than one
353processor ("SMP"), then you should type <c>smp</c> instead of 372processor ("SMP"), then you should type <c>smp</c> instead of
354<c>gentoo</c> at the prompt. This will allow the LiveCD to see all 373<c>gentoo</c> at the prompt. This will allow the LiveCD to see all
355the processors in your system, not just the first one. 374the processors in your system, not just the first one.
356</p> 375</p>
357 376
358<p> 377<p>
359Consult the following table for a partial list of available kernels and 378Consult the following table for a partial list of available kernels and
360options or press F2 and F3 to view the help screens. 379options or press F2 and F3 to view the help screens.
361</p> 380</p>
362 381
363<table> 382<table>
364<tcolumn width="2in"/> 383<tcolumn width="2in"/>
365<tcolumn width="4in"/> 384<tcolumn width="4in"/>
366<tr><th>Available kernels</th><th>Description</th></tr> 385<tr>
367<tr><ti>gentoo</ti><ti>standard gentoo kernel (default)</ti></tr> 386 <th>Available kernels</th>
368<tr><ti>nofb</ti><ti>framebuffer mode disabled</ti></tr> 387 <th>Description</th>
388</tr>
389<tr>
390 <ti>gentoo</ti>
391 <ti>Standard gentoo kernel (default)</ti>
392</tr>
393<tr>
394 <ti>nofb</ti>
395 <ti>Framebuffer mode disabled</ti>
396</tr>
397<tr>
398 <ti>smp</ti>
369<tr><ti>smp</ti><ti>loads a smp kernel in noframebuffer mode</ti></tr> 399 <ti>Loads a smp kernel in noframebuffer mode</ti>
400</tr>
401<tr>
402 <ti>acpi</ti>
370<tr><ti>acpi</ti><ti>enables acpi=on + loads acpi modules during init</ti></tr> 403 <ti>Enables acpi=on + loads acpi modules during init</ti>
371<tr><ti>memtest</ti><ti>boots the memory testing program</ti></tr> 404</tr>
405<tr>
406 <ti>memtest</ti>
407 <ti>Boots the memory testing program</ti>
408</tr>
372</table> 409</table>
373 410
374<table> 411<table>
375<tcolumn width="2in"/> 412<tcolumn width="2in"/>
376<tcolumn width="4in"/> 413<tcolumn width="4in"/>
377<tr><th>Available boot options</th><th>Description</th></tr> 414<tr>
378<tr><ti>doataraid</ti><ti>loads ide raid modules from initrd</ti></tr> 415 <th>Available boot options</th>
379<tr><ti>dofirewire</ti><ti>modprobes firewire modules in initrd (for firewire cdroms,etc.)</ti></tr> 416 <th>Description</th>
380<tr><ti>dokeymap</ti><ti>enable keymap selection for non-us keyboard layouts</ti></tr> 417</tr>
381<tr><ti>dopcmcia</ti><ti>starts pcmcia service</ti></tr> 418<tr>
382<tr><ti>doscsi</ti><ti>scan for scsi devices (breaks some ethernet cards)</ti></tr> 419 <ti>doataraid</ti>
383<tr><ti>noapm</ti><ti>disables apm module load</ti></tr> 420 <ti>Loads ide raid modules from initrd</ti>
421</tr>
422<tr>
423 <ti>dofirewire</ti>
424 <ti>Modprobes firewire modules in initrd (for firewire cdroms,etc.)</ti>
425</tr>
426<tr>
427 <ti>dokeymap</ti>
428 <ti>Enable keymap selection for non-us keyboard layouts</ti>
429</tr>
430<tr>
431 <ti>dopcmcia</ti>
432 <ti>Starts pcmcia service</ti>
433</tr>
434<tr>
435 <ti>doscsi</ti>
436 <ti>Scan for scsi devices (breaks some ethernet cards)</ti>
437</tr>
438<tr>
439 <ti>noapm</ti>
440 <ti>Disables apm module load</ti>
441</tr>
442<tr>
443 <ti>nodetect</ti>
384<tr><ti>nodetect</ti><ti>causes hwsetup/kudzu and hotplug not to run</ti></tr> 444 <ti>Causes hwsetup/kudzu and hotplug not to run</ti>
445</tr>
446<tr>
447 <ti>nodhcp</ti>
385<tr><ti>nodhcp</ti><ti>dhcp does not automatically start if nic detected</ti></tr> 448 <ti>Dhcp does not automatically start if nic detected</ti>
386<tr><ti>nohotplug</ti><ti>disables loading hotplug service</ti></tr> 449</tr>
387<tr><ti>noraid</ti><ti>disables loading of evms modules</ti></tr> 450<tr>
388<tr><ti>nousb</ti><ti>disables usb module load from initrd, disables hotplug</ti></tr> 451 <ti>nohotplug</ti>
452 <ti>Disables loading hotplug service</ti>
453</tr>
454<tr>
455 <ti>noraid</ti>
456 <ti>Disables loading of evms modules</ti>
457</tr>
458<tr>
459 <ti>nousb</ti>
460 <ti>Disables usb module load from initrd, disables hotplug</ti>
461</tr>
462<tr>
463 <ti>ide=nodma</ti>
389<tr><ti>ide=nodma</ti><ti>force disabling of dma for malfunctioning ide devices</ti></tr> 464 <ti>Force disabling of dma for malfunctioning ide devices</ti>
390<tr><ti>cdcache</ti><ti>cache the entire runtime portion of cd in ram. This uses 40mb of RAM, but allows you to umount <path>/mnt/cdrom</path> and mount another cdrom</ti></tr> 465</tr>
466<tr>
467 <ti>cdcache</ti>
468 <ti>
469 Cache the entire runtime portion of cd in ram. This uses 40mb of RAM, but
470 allows you to umount <path>/mnt/cdrom</path> and mount another cdrom.
471 </ti>
472</tr>
391</table> 473</table>
392 474
393<p> 475<p>
394Once you hit Enter, you will be greeted with an even fancier boot 476Once you hit Enter, you will be greeted with an even fancier boot
395screen and progress bar. 477screen and progress bar.
446/lib/modules/`uname -r`/kernel/drivers/net/*</c>. To load a particular module, 528/lib/modules/`uname -r`/kernel/drivers/net/*</c>. To load a particular module,
447type: 529type:
448</p> 530</p>
449 531
450<pre caption="PCI Modules Configuration"> 532<pre caption="PCI Modules Configuration">
533<comment>(replace pcnet32 with your NIC module)</comment>
451# <i>modprobe pcnet32</i> 534# <i>modprobe pcnet32</i>
452<comment>(replace pcnet32 with your NIC module)</comment>
453</pre> 535</pre>
454 536
455<p> 537<p>
456Likewise, if you want to be able to access any SCSI hardware that wasn't 538Likewise, if you want to be able to access any SCSI hardware that wasn't
457detected during the initial boot autodetection process, you will need to 539detected during the initial boot autodetection process, you will need to
458load the appropriate modules from <path>/lib/modules</path>, again using 540load the appropriate modules from <path>/lib/modules</path>, again using
459<c>modprobe</c>: 541<c>modprobe</c>:
460</p> 542</p>
461 543
462<pre caption="Loading SCSI Modules"> 544<pre caption="Loading SCSI Modules">
545<comment>(replace aic7xxx with your SCSI adapter module)</comment>
463# <i>modprobe aic7xxx</i> 546# <i>modprobe aic7xxx</i>
464<comment>(replace aic7xxx with your SCSI adapter module)</comment> 547<comment>(sd_mod is the module for SCSI disk support)</comment>
465# <i>modprobe sd_mod</i> 548# <i>modprobe sd_mod</i>
466<comment>(sd_mod is the module for SCSI disk support)</comment>
467</pre> 549</pre>
468 550
469<note> 551<note>
470Support for SCSI CD-ROMs and disks are built-in in the kernel. 552Support for SCSI CD-ROMs and disks are built-in in the kernel.
471</note> 553</note>
474<b>Advanced users:</b> The Gentoo LiveCD should have enabled DMA 556<b>Advanced users:</b> The Gentoo LiveCD should have enabled DMA
475on your disks so that disk transfers are as fast as possible, but if it did not, 557on your disks so that disk transfers are as fast as possible, but if it did not,
476<c>hdparm</c> can be used to set DMA on your drives as follows: 558<c>hdparm</c> can be used to set DMA on your drives as follows:
477<pre caption="Setting DMA"> 559<pre caption="Setting DMA">
478<comment>(Replace hdX with your disk device)</comment> 560<comment>(Replace hdX with your disk device)</comment>
561<comment>(Enables DMA:)</comment>
479# <i>hdparm -d 1 /dev/hdX</i> 562# <i>hdparm -d 1 /dev/hdX</i>
480<comment>(Enables DMA)</comment> 563<comment>(Enables DMA and other safe performance-enhancing options:)</comment>
481# <i>hdparm -d1 -A1 -m16 -u1 -a64 /dev/hdX</i> 564# <i>hdparm -d1 -A1 -m16 -u1 -a64 /dev/hdX</i>
482<comment>(Enables DMA and other safe performance-enhancing options)</comment> 565<comment>(Force-enables Ultra-DMA -- dangerous -- may cause some drives to mess up:)</comment>
483# <i>hdparm -X66 /dev/hdX</i> 566# <i>hdparm -X66 /dev/hdX</i>
484<comment>(Force-enables Ultra-DMA -- dangerous -- may cause some drives to mess up)</comment>
485</pre> 567</pre>
486</note> 568</note>
487 569
488 570
489</body> 571</body>
490</section> 572</section>
491</chapter> 573</chapter>
492<chapter> 574<chapter>
493<title>Optional Networking configuration</title> 575<title>Optional Networking configuration</title>
501set up automatically for you. If so, you should be able to take advantage of 583set up automatically for you. If so, you should be able to take advantage of
502the many included network-aware commands on the LiveCD such as <c>ssh</c>, 584the many included network-aware commands on the LiveCD such as <c>ssh</c>,
503<c>scp</c>, <c>ping</c>, <c>irssi</c>, <c>wget</c> and <c>links</c>, among 585<c>scp</c>, <c>ping</c>, <c>irssi</c>, <c>wget</c> and <c>links</c>, among
504others. 586others.
505</p> 587</p>
506 588
507<p> 589<p>
508If networking has been configured for you, the <c>/sbin/ifconfig</c> command 590If networking has been configured for you, the <c>/sbin/ifconfig</c> command
509should list some internet interfaces besides lo, such as eth0: 591should list some internet interfaces besides lo, such as eth0:
510</p> 592</p>
511 593
564ethernet device. 646ethernet device.
565</p> 647</p>
566 648
567</body> 649</body>
568</section> 650</section>
569
570<section> 651<section>
571<title>Automatic Network Configuration </title> 652<title>Automatic Network Configuration </title>
572<body> 653<body>
573 654
574<p> 655<p>
624 705
625<table> 706<table>
626<tcolumn width="1.25in"/> 707<tcolumn width="1.25in"/>
627<tcolumn width="4in"/> 708<tcolumn width="4in"/>
628<tcolumn width="1.25in"/> 709<tcolumn width="1.25in"/>
629<tr><th>Information</th><th>Description</th><th>Example value</th></tr> 710<tr>
630<tr><ti>IP address</ti><ti>The IP address you want to assign to your network card</ti><ti>192.168.1.2</ti></tr> 711 <th>Information</th>
631<tr><ti>Broadcast address</ti><ti>The IP address which will broadcast the packets to all the hosts in the network</ti><ti>192.168.1.255</ti></tr> 712 <th>Description</th>
632<tr><ti>Network mask</ti><ti>The mask which is used together with the IP address to see what part of the address is for network-identification and host-identification</ti><ti>255.255.255.0</ti></tr> 713 <th>Example value</th>
633<tr><ti>Gateway</ti><ti>The IP address of the computer which will forward the packets that are not meant for the local network (most of the time the computer which shares the internet connection)</ti><ti>192.168.1.1</ti></tr> 714</tr>
715<tr>
716 <ti>IP address</ti>
717 <ti>The IP address you want to assign to your network card</ti>
718 <ti>192.168.1.2</ti>
719</tr>
720<tr>
721 <ti>Broadcast address</ti>
722 <ti>
723 The IP address which will broadcast the packets to all the hosts in the
724 network
725 </ti>
726 <ti>192.168.1.255</ti>
727</tr>
728<tr>
729 <ti>Network mask</ti>
730 <ti>
731 The mask which is used together with the IP address to see what part of the
732 address is for network-identification and host-identification
733 </ti>
734 <ti>255.255.255.0</ti>
735</tr>
736<tr>
737 <ti>Gateway</ti>
738 <ti>
739 The IP address of the computer which will forward the packets that are not
740 meant for the local network (most of the time the computer which shares the
741 internet connection)
742 </ti>
743 <ti>192.168.1.1</ti>
744</tr>
634</table> 745</table>
635 746
636<p> 747<p>
637Type in the following commands, replacing <c>$IFACE</c> with your network 748Type in the following commands, replacing <c>$IFACE</c> with your network
638interface (typically <c>eth0</c>), <c>$IPNUM</c> with your IP address, 749interface (typically <c>eth0</c>), <c>$IPNUM</c> with your IP address,
670primary and secondary DNS servers respectively. 781primary and secondary DNS servers respectively.
671</p> 782</p>
672 783
673</body> 784</body>
674</section> 785</section>
675
676<section> 786<section>
677<title>Proxy Configuration</title> 787<title>Proxy Configuration</title>
678<body> 788<body>
679 789
680<p> 790<p>
682before you continue. We will export some variables to set up the proxy 792before you continue. We will export some variables to set up the proxy
683accordingly. 793accordingly.
684</p> 794</p>
685 795
686<pre caption="Setting a Proxy"> 796<pre caption="Setting a Proxy">
687<comment>If the proxy restricts HTTP traffic:</comment> 797<comment>(If the proxy restricts HTTP traffic:)</comment>
688# <i>export http_proxy="http://machine.company.com:1234"</i> 798# <i>export http_proxy="http://machine.company.com:1234"</i>
689<comment>If the proxy restricts FTP traffic:</comment> 799<comment>(If the proxy restricts FTP traffic:)</comment>
690# <i>export ftp_proxy="ftp://machine.company.com"</i> 800# <i>export ftp_proxy="ftp://machine.company.com"</i>
691<comment>If the proxy restricts RSYNC traffic:</comment> 801<comment>(If the proxy restricts RSYNC traffic:)</comment>
692# <i>export RSYNC_PROXY="rsync://machine.company.com"</i> 802# <i>export RSYNC_PROXY="rsync://machine.company.com"</i>
693</pre> 803</pre>
694 804
695</body> 805</body>
696</section> 806</section>
697
698<section> 807<section>
699<title>Networking is go!</title> 808<title>Networking is go!</title>
700<body> 809<body>
701 810
702<p> 811<p>
720</p> 829</p>
721 830
722<pre caption="Setting your system's date"> 831<pre caption="Setting your system's date">
723# <i>date</i> 832# <i>date</i>
724Thu Feb 27 09:04:42 CST 2003 833Thu Feb 27 09:04:42 CST 2003
725<comment>(If your date is wrong, set your date with this next command)</comment> 834<comment>(If your date is wrong, set your date with this next command:)</comment>
726# <i>date 022709042003</i> 835# <i>date 022709042003</i>
727<comment>(date MMDDhhmmCCYY)</comment> 836<comment>(date MMDDhhmmCCYY)</comment>
728</pre> 837</pre>
729 838
730</body> 839</body>
900setting to auto-detect filesystems and swap devices on the disk at boot-time. 1009setting to auto-detect filesystems and swap devices on the disk at boot-time.
901</p> 1010</p>
902 1011
903</body> 1012</body>
904</section> 1013</section>
905
906<section> 1014<section>
907<title>Using fdisk to set up partitions</title> 1015<title>Using fdisk to set up partitions</title>
908<body> 1016<body>
909 1017
910<p> 1018<p>
973<tcolumn width="1.5in"/> 1081<tcolumn width="1.5in"/>
974<tcolumn width="2.5in"/> 1082<tcolumn width="2.5in"/>
975<tcolumn width="2.5in"/> 1083<tcolumn width="2.5in"/>
976<tcolumn width="1in"/> 1084<tcolumn width="1in"/>
977<tr> 1085<tr>
978 <th>Partition</th> 1086 <th>Partition</th>
979 <th>Size</th> 1087 <th>Size</th>
980 <th>Type</th> 1088 <th>Type</th>
981 <th>example device</th> 1089 <th>Example device</th>
982</tr>
983<tr> 1090</tr>
1091<tr>
984 <ti>boot partition, containing kernel(s) and boot information</ti> 1092 <ti>Boot partition, containing kernel(s) and boot information</ti>
985 <ti>32 Megabytes</ti> 1093 <ti>32 Megabytes</ti>
986 <ti>ext2/3 highly recommended (easiest); if ReiserFS then mount with <c>-o notail</c>. If you will be using ext3 or ReiserFS, you must add the size of the journal to the partitionsize; in these cases 64 Megabytes is recommended</ti> 1094 <ti>
1095 Ext2/3 highly recommended (easiest); if ReiserFS then mount with <c>-o
1096 notail</c>. If you will be using ext3 or ReiserFS, you must add the size of
1097 the journal to the partitionsize; in these cases 64 Megabytes is
1098 recommended.
1099 </ti>
987 <ti><path>/dev/hda1</path></ti> 1100 <ti><path>/dev/hda1</path></ti>
988</tr>
989<tr> 1101</tr>
1102<tr>
990 <ti>swap partition (no longer a 128 Megabyte limit, now 2GB)</ti> 1103 <ti>Swap partition (no longer a 128 Megabyte limit, now 2GB)</ti>
991 <ti>Generally, configure a swap area that is between one and two times the size of the physical RAM in your system</ti> 1104 <ti>
1105 Generally, configure a swap area that is between one and two times the
1106 size of the physical RAM in your system
1107 </ti>
992 <ti>Linux swap</ti> 1108 <ti>Linux swap</ti>
993 <ti><path>/dev/hda2</path></ti> 1109 <ti><path>/dev/hda2</path></ti>
994</tr>
995<tr> 1110</tr>
1111<tr>
996 <ti>root partition, containing main filesystem (/usr, /home, etc.)</ti> 1112 <ti>Root partition, containing main filesystem (/usr, /home, etc.)</ti>
997 <ti>&gt;=1.5 Gigabytes</ti> 1113 <ti>&gt;=1.5 Gigabytes</ti>
998 <ti>ReiserFS, ext3 recommended; ext2 ok</ti> 1114 <ti>ReiserFS, ext3 recommended; ext2 ok</ti>
999 <ti><path>/dev/hda3</path></ti> 1115 <ti><path>/dev/hda3</path></ti>
1000</tr> 1116</tr>
1001</table> 1117</table>
1002 1118
1003<p> 1119<p>
1004OK, now to create the partitions as in the example and table above. First, 1120OK, now to create the partitions as in the example and table above. First,
1070</note> 1186</note>
1071 1187
1072<pre caption="Steps to create our boot partition"> 1188<pre caption="Steps to create our boot partition">
1073Command (m for help): <i>n</i> 1189Command (m for help): <i>n</i>
1074Command action 1190Command action
1075e extended 1191 e extended
1076p primary partition (1-4) 1192 p primary partition (1-4)
1077<i>p</i> 1193<i>p</i>
1078Partition number (1-4): <i>1</i> 1194Partition number (1-4): <i>1</i>
1079First cylinder (1-3876, default 1): <comment>(Hit Enter)</comment> 1195First cylinder (1-3876, default 1): <comment>(Hit Enter)</comment>
1080Using default value 1 1196Using default value 1
1081Last cylinder or +size or +sizeM or +sizeK (1-3876, default 3876): <i>+32M</i> 1197Last cylinder or +size or +sizeM or +sizeK (1-3876, default 3876): <i>+32M</i>
1161allow your system to detect the new partition configuration. 1277allow your system to detect the new partition configuration.
1162</note> 1278</note>
1163 1279
1164</body> 1280</body>
1165</section> 1281</section>
1166
1167<section> 1282<section>
1168<title>Creating filesystems</title> 1283<title>Creating filesystems</title>
1169<body> 1284<body>
1170 1285
1171<p> 1286<p>
1380 1495
1381</body> 1496</body>
1382</section> 1497</section>
1383</chapter> 1498</chapter>
1384 1499
1385
1386<chapter> 1500<chapter>
1387<title>Stage tarballs and chroot</title> 1501<title>Stage tarballs and chroot</title>
1388<section> 1502<section>
1389<title>Selecting the desired stage tarball</title> 1503<title>Selecting the desired stage tarball</title>
1390<body> 1504<body>
1502-- even without a network connection. 1616-- even without a network connection.
1503</p> 1617</p>
1504 1618
1505</body> 1619</body>
1506</section> 1620</section>
1507
1508<section> 1621<section>
1509<title>Selecting Mirrors (Optional)</title> 1622<title>Selecting Mirrors (Optional)</title>
1510<body> 1623<body>
1511 1624
1512<p> 1625<p>
1514mirrors based on your location, or manually pick a mirror from a list. 1627mirrors based on your location, or manually pick a mirror from a list.
1515Unfortunately, <c>mirrorselect</c> does not work well behind all routers. 1628Unfortunately, <c>mirrorselect</c> does not work well behind all routers.
1516</p> 1629</p>
1517 1630
1518<pre caption="Using mirrorselect"> 1631<pre caption="Using mirrorselect">
1519<comment>To select a mirror automatically:</comment> 1632<comment>(To select a mirror automatically:)</comment>
1520# <i>mirrorselect -a -s4 -o &gt;&gt; /mnt/gentoo/etc/make.conf</i> 1633# <i>mirrorselect -a -s4 -o &gt;&gt; /mnt/gentoo/etc/make.conf</i>
1521<comment>To select a mirror interactively:</comment> 1634<comment>(To select a mirror interactively:)</comment>
1522# <i>mirrorselect -i -o &gt;&gt; /mnt/gentoo/etc/make.conf</i> 1635# <i>mirrorselect -i -o &gt;&gt; /mnt/gentoo/etc/make.conf</i>
1523</pre> 1636</pre>
1524 1637
1525<p> 1638<p>
1526If for some reason <c>mirrorselect</c> fails you should be able to 1639If for some reason <c>mirrorselect</c> fails you should be able to
1757<warn> 1870<warn>
1758If you start from stage2, don't change the CHOST variable in 1871If you start from stage2, don't change the CHOST variable in
1759<path>/etc/make.conf</path>. Doing so results in strange and 1872<path>/etc/make.conf</path>. Doing so results in strange and
1760broad compilation failures. 1873broad compilation failures.
1761</warn> 1874</warn>
1762 1875
1763<p> 1876<p>
1764The stage2 tarball already has the bootstrapping done for you. All that you 1877The stage2 tarball already has the bootstrapping done for you. All that you
1765have to do is install the rest of the system: 1878have to do is install the rest of the system:
1766</p> 1879</p>
1767 1880
1793 1906
1794</body> 1907</body>
1795</section> 1908</section>
1796</chapter> 1909</chapter>
1797 1910
1798
1799<chapter> 1911<chapter>
1800<title>Starting from Stage3</title> 1912<title>Starting from Stage3</title>
1801<section> 1913<section>
1802<body> 1914<body>
1803 1915
1814 1926
1815<p> 1927<p>
1816The stage3 tarball provides a fully-functional basic Gentoo system, 1928The stage3 tarball provides a fully-functional basic Gentoo system,
1817so no building is required. 1929so no building is required.
1818</p> 1930</p>
1819 1931
1820<note> 1932<note>
1821<b>Advanced users:</b> However, since the stage3 tarball is pre-built, it 1933<b>Advanced users:</b> However, since the stage3 tarball is pre-built, it
1822may be slightly out-of-date. If this is a concern for you, you can 1934may be slightly out-of-date. If this is a concern for you, you can
1823automatically update your existing stage3 to contain the most up-to-date 1935automatically update your existing stage3 to contain the most up-to-date
1824versions of all system packages by making a backup of 1936versions of all system packages by making a backup of
1827the backup afterwards. Note that this could take a long time if your stage3 is 1939the backup afterwards. Note that this could take a long time if your stage3 is
1828very old; otherwise, this process will generally be quick and will allow you 1940very old; otherwise, this process will generally be quick and will allow you
1829to benefit from the very latest Gentoo updates and fixes. In any case, feel 1941to benefit from the very latest Gentoo updates and fixes. In any case, feel
1830free to skip these steps and proceed to the next section if you like. 1942free to skip these steps and proceed to the next section if you like.
1831</note> 1943</note>
1832 1944
1833</body> 1945</body>
1834</section> 1946</section>
1835</chapter> 1947</chapter>
1836
1837 1948
1838<chapter> 1949<chapter>
1839<title>Setting your time zone</title> 1950<title>Setting your time zone</title>
1840<section> 1951<section>
1841<body> 1952<body>
1910 2021
1911</body> 2022</body>
1912</section> 2023</section>
1913</chapter> 2024</chapter>
1914 2025
1915
1916<chapter> 2026<chapter>
1917<title>Installing the kernel and system logger</title> 2027<title>Installing the kernel and system logger</title>
1918<section> 2028<section>
1919<title>Kernel selections</title> 2029<title>Kernel selections</title>
1920<body> 2030<body>
1921 2031
1922<p> 2032<p>
1923There are two options for installing a kernel. You can either configure your 2033There are two options for installing a kernel. You can either configure your
1924own kernel or use the <c>genkernel</c> utility to configure and compile your 2034own kernel or use the <c>genkernel</c> utility to configure and compile your
1925kernel automatically. 2035kernel automatically.
1926</p> 2036</p>
1927 2037
1928<p> 2038<p>
1929Whether configuring a kernel by hand or using <c>genkernel</c>, 2039Whether configuring a kernel by hand or using <c>genkernel</c>,
1930you'll need to merge the Linux kernel sources you'd like to use. 2040you'll need to merge the Linux kernel sources you'd like to use.
1931Gentoo provides several kernel ebuilds; a list can be found 2041Gentoo provides several kernel ebuilds; a list can be found
1932<uri link="/doc/en/gentoo-kernel.xml">here</uri>. If you are uncertain 2042<uri link="/doc/en/gentoo-kernel.xml">here</uri>. If you are uncertain
1980</p> 2090</p>
1981 2091
1982<pre caption="Emerging genkernel"> 2092<pre caption="Emerging genkernel">
1983# <i>emerge -k genkernel</i> 2093# <i>emerge -k genkernel</i>
1984</pre> 2094</pre>
1985 2095
1986<p> 2096<p>
1987Now, compile your kernel sources by running <c>genkernel</c>: 2097Now, compile your kernel sources by running <c>genkernel</c>:
1988</p> 2098</p>
1989 2099
1990<note> 2100<note>
2196<table> 2306<table>
2197<tcolumn width="1in"/> 2307<tcolumn width="1in"/>
2198<tcolumn width="4in"/> 2308<tcolumn width="4in"/>
2199<tcolumn width="2in"/> 2309<tcolumn width="2in"/>
2200<tr> 2310<tr>
2201 <th>Ebuild</th> 2311 <th>Ebuild</th>
2202 <th>Purpose</th> 2312 <th>Purpose</th>
2203 <th>Command</th> 2313 <th>Command</th>
2204</tr>
2205<tr> 2314</tr>
2315<tr>
2206 <ti>nvidia-kernel</ti> 2316 <ti>nvidia-kernel</ti>
2207 <ti>Accelerated NVIDIA graphics for XFree86</ti> 2317 <ti>Accelerated NVIDIA graphics for XFree86</ti>
2208 <ti><c>emerge -k nvidia-kernel</c></ti> 2318 <ti><c>emerge -k nvidia-kernel</c></ti>
2209</tr>
2210<tr> 2319</tr>
2320<tr>
2211 <ti>nforce-net</ti> 2321 <ti>nforce-net</ti>
2212 <ti>On-board ethernet controller on NVIDIA NForce(2) motherboards</ti> 2322 <ti>On-board ethernet controller on NVIDIA NForce(2) motherboards</ti>
2213 <ti><c>emerge nforce-net</c></ti> 2323 <ti><c>emerge nforce-net</c></ti>
2214</tr>
2215<tr> 2324</tr>
2325<tr>
2216 <ti>nforce-audio</ti> 2326 <ti>nforce-audio</ti>
2217 <ti>On-board audio on NVIDIA NForce(2) motherboards</ti> 2327 <ti>On-board audio on NVIDIA NForce(2) motherboards</ti>
2218 <ti><c>emerge nforce-audio</c></ti> 2328 <ti><c>emerge nforce-audio</c></ti>
2219</tr>
2220<tr> 2329</tr>
2330<tr>
2221 <ti>e100</ti> 2331 <ti>e100</ti>
2222 <ti>Intel e100 Fast Ethernet Adapters</ti> 2332 <ti>Intel e100 Fast Ethernet Adapters</ti>
2223 <ti><c>emerge e100</c></ti> 2333 <ti><c>emerge e100</c></ti>
2224</tr>
2225<tr> 2334</tr>
2335<tr>
2226 <ti>e1000</ti> 2336 <ti>e1000</ti>
2227 <ti>Intel e1000 Gigabit Ethernet Adapters</ti> 2337 <ti>Intel e1000 Gigabit Ethernet Adapters</ti>
2228 <ti><c>emerge e1000</c></ti> 2338 <ti><c>emerge e1000</c></ti>
2229</tr>
2230<tr> 2339</tr>
2340<tr>
2231 <ti>emu10k1</ti> 2341 <ti>emu10k1</ti>
2232 <ti>Creative Sound Blaster Live!/Audigy support</ti> 2342 <ti>Creative Sound Blaster Live!/Audigy support</ti>
2233 <ti><c>emerge emu10k1</c></ti> 2343 <ti><c>emerge emu10k1</c></ti>
2234</tr>
2235<tr> 2344</tr>
2345<tr>
2236 <ti>ati-drivers</ti> 2346 <ti>ati-drivers</ti>
2237 <ti>Accelerated ATI Radeon 8500+/FireGL graphics for XFree86</ti> 2347 <ti>Accelerated ATI Radeon 8500+/FireGL graphics for XFree86</ti>
2238 <ti><c>emerge ati-drivers</c></ti> 2348 <ti><c>emerge ati-drivers</c></ti>
2239</tr>
2240<tr> 2349</tr>
2350<tr>
2241 <ti>xfree-drm</ti> 2351 <ti>xfree-drm</ti>
2352 <ti>
2242 <ti>Accelerated graphics for ATI Radeon up to 9200, Rage128, Matrox, Voodoo and other cards for XFree86</ti> 2353 Accelerated graphics for ATI Radeon up to 9200, Rage128, Matrox, Voodoo and
2354 other cards for XFree86
2355 </ti>
2243 <ti><c>VIDEO_CARDS="yourcard" emerge xfree-drm</c></ti> 2356 <ti><c>VIDEO_CARDS="yourcard" emerge xfree-drm</c></ti>
2244</tr> 2357</tr>
2245</table> 2358</table>
2246 2359
2247<p> 2360<p>
2248The <c>nvidia-kernel</c>, <c>ati-drivers</c> and <c>xfree-drm</c> packages 2361The <c>nvidia-kernel</c>, <c>ati-drivers</c> and <c>xfree-drm</c> packages
2330it has not been installed. It would be the good time to do it: 2443it has not been installed. It would be the good time to do it:
2331</p> 2444</p>
2332 2445
2333<pre caption="Installing rp-pppoe"> 2446<pre caption="Installing rp-pppoe">
2334# <i>USE="-X" emerge rp-pppoe</i> 2447# <i>USE="-X" emerge rp-pppoe</i>
2335<comment>GRP users should type the following:</comment> 2448<comment>(GRP users should type the following:)</comment>
2336# <i>emerge -K rp-pppoe</i> 2449# <i>emerge -K rp-pppoe</i>
2337</pre> 2450</pre>
2338 2451
2339<note> 2452<note>
2340The <i>USE="-X"</i> prevents pppoe from installing its optional X interface, 2453The <i>USE="-X"</i> prevents pppoe from installing its optional X interface,
2341which is a good thing, because X and its dependencies would also be emerged. 2454which is a good thing, because X and its dependencies would also be emerged.
2342You can always recompile <i>rp-pppoe</i> with X support later. The GRP version 2455You can always recompile <i>rp-pppoe</i> with X support later. The GRP version
2343of rp-pppoe has the optional X interface enabled. If you're not using GRP, compile from 2456of rp-pppoe has the optional X interface enabled. If you're not using GRP,
2344source as in the first example. 2457compile from source as in the first example.
2345</note> 2458</note>
2346<!-- this pkg is a candidate for moving from .tbz2 to distfiles/ (source) --> 2459<!-- this pkg is a candidate for moving from .tbz2 to distfiles/ (source) -->
2347 2460
2348 2461
2349<note> 2462<note>
2378# <i>emerge -k sys-apps/pcmcia-cs</i> 2491# <i>emerge -k sys-apps/pcmcia-cs</i>
2379</pre> 2492</pre>
2380 2493
2381<!-- fix the bug or fix the docs, don't send the user in circles 2494<!-- fix the bug or fix the docs, don't send the user in circles
2382(drobbins) 2495(drobbins)
2383 <warn>You will have to re-emerge <i>pcmcia-cs</i> after installation to get PCMCIA 2496<warn>You will have to re-emerge <i>pcmcia-cs</i> after installation to get PCMCIA
2384 to work. 2497to work.
2385 </warn> 2498</warn>
2386 --> 2499-->
2387 2500
2388</body> 2501</body>
2389</section> 2502</section>
2390</chapter> 2503</chapter>
2391 2504
2467</pre> 2580</pre>
2468 2581
2469</body> 2582</body>
2470</section> 2583</section>
2471</chapter> 2584</chapter>
2472
2473 2585
2474<chapter> 2586<chapter>
2475<title>Modifying /etc/hosts</title> 2587<title>Modifying /etc/hosts</title>
2476<section> 2588<section>
2477<body> 2589<body>
2495</note> 2607</note>
2496 2608
2497</body> 2609</body>
2498</section> 2610</section>
2499</chapter> 2611</chapter>
2500
2501 2612
2502<chapter> 2613<chapter>
2503<title>Final Network Configuration</title> 2614<title>Final Network Configuration</title>
2504<section> 2615<section>
2505<title>Loading the Kernel Modules</title> 2616<title>Loading the Kernel Modules</title>
2688 2799
2689<pre caption="GRUB on the MBR"> 2800<pre caption="GRUB on the MBR">
2690grub&gt; <i>root (hd0,0)</i> <comment>(Your boot partition)</comment> 2801grub&gt; <i>root (hd0,0)</i> <comment>(Your boot partition)</comment>
2691grub&gt; <i>setup (hd0)</i> <comment>(Where the boot record is installed; here, it is the MBR)</comment> 2802grub&gt; <i>setup (hd0)</i> <comment>(Where the boot record is installed; here, it is the MBR)</comment>
2692</pre> 2803</pre>
2693 2804
2694<pre caption="GRUB not on the MBR"> 2805<pre caption="GRUB not on the MBR">
2695<comment>Alternatively, if you wanted to install the bootloader somewhere other than the MBR:</comment> 2806<comment>Alternatively, if you wanted to install the bootloader somewhere other than the MBR:</comment>
2696grub&gt; <i>root (hd0,0)</i> <comment>(Your boot partition)</comment> 2807grub&gt; <i>root (hd0,0)</i> <comment>(Your boot partition)</comment>
2697grub&gt; <i>setup (hd0,4)</i> <comment>(Where the boot record is installed; here it is /dev/hda5)</comment> 2808grub&gt; <i>setup (hd0,4)</i> <comment>(Where the boot record is installed; here it is /dev/hda5)</comment>
2698grub&gt; <i>quit</i> 2809grub&gt; <i>quit</i>
2721available hard drives and hitting the TAB key after writing <c> root (hd0,</c> 2832available hard drives and hitting the TAB key after writing <c> root (hd0,</c>
2722would make GRUB print the list of partitions on the first hard drive. 2833would make GRUB print the list of partitions on the first hard drive.
2723Checking the syntax of the GRUB location with completion should really help 2834Checking the syntax of the GRUB location with completion should really help
2724to make the right choice. 2835to make the right choice.
2725</note> 2836</note>
2726 2837
2727<p> 2838<p>
2728Gentoo Linux is now installed, but we need to create the 2839Gentoo Linux is now installed, but we need to create the
2729<path>/boot/grub/grub.conf</path> file so that we get a nice GRUB boot menu 2840<path>/boot/grub/grub.conf</path> file so that we get a nice GRUB boot menu
2730when the system reboots. Here is how to do it. 2841when the system reboots. Here is how to do it.
2731</p> 2842</p>
2849lba32 2960lba32
2850default=linux 2961default=linux
2851 2962
2852<comment># Use something like the following 4 lines if you compiled your kernel yourself</comment> 2963<comment># Use something like the following 4 lines if you compiled your kernel yourself</comment>
2853image=/boot/bzImage 2964image=/boot/bzImage
2854 label=linux 2965 label=linux
2855 read-only 2966 read-only
2856 root=/dev/hda3 2967 root=/dev/hda3
2857 2968
2858<comment># If you used genkernel, use something like this:</comment> 2969<comment># If you used genkernel, use something like this:</comment>
2859image=/boot/kernel-KV 2970image=/boot/kernel-KV
2860 label=gk_linux 2971 label=gk_linux
2861 root=/dev/hda3 2972 root=/dev/hda3
2862 initrd=/boot/initrd-KV 2973 initrd=/boot/initrd-KV
2863 append="root=/dev/hda3 init=/linuxrc" 2974 append="root=/dev/hda3 init=/linuxrc"
2864 2975
2865 2976
2866<comment># For dual booting windows/other OS</comment> 2977<comment># For dual booting windows/other OS</comment>
2867other=/dev/hda1 2978other=/dev/hda1
2868 label=dos 2979 label=dos
2869</pre> 2980</pre>
2870 2981
2871<warn> 2982<warn>
2872Substitute <c>KV</c> with the kernel version you have installed, and 2983Substitute <c>KV</c> with the kernel version you have installed, and
2873make sure that <c>default=</c> points to your label (<c>gk_linux</c> if 2984make sure that <c>default=</c> points to your label (<c>gk_linux</c> if
2874you used genkernel). 2985you used genkernel).
2875</warn> 2986</warn>
2876 2987
2877<ul> 2988<ul>
2989<li>
2878<li><c>boot=/dev/hda</c> tells LILO to install itself on the first hard disk on the first IDE controller.</li> 2990 <c>boot=/dev/hda</c> tells LILO to install itself on the first hard disk on
2991 the first IDE controller
2992</li>
2993<li>
2879<li><c>map=/boot/map</c> states the map file. In normal use, this should not be modified. </li> 2994 <c>map=/boot/map</c> states the map file. In normal use, this should not be
2880<li><c>install=/boot/boot.b</c> tells LILO to install the specified file as the new boot sector. In normal use, this should not be altered. If the install line is missing, LILO will assume a default of <path>/boot/boot.b</path> as the file to be used. </li> 2995 modified
2881<li>The existence of <c>prompt</c> tells LILO to display the classic <e>lilo:</e> prompt at bootup. While it is not recommended that you remove the prompt line, if you do remove it, you can still get a prompt by holding down the [Shift] key while your machine starts to boot. </li> 2996</li>
2882<li><c>timeout=50</c> sets the amount of time that LILO will wait for user input before proceeding with booting the default line entry. This is measured in tenths of a second, with 50 as the default. </li> 2997<li>
2883<li><c>lba32</c> describes the hard disk geometry to LILO. Another common entry here is linear. You should not change this line unless you are very aware of what you are doing. Otherwise, you could put your system in an unbootable state. </li> 2998 <c>install=/boot/boot.b</c> tells LILO to install the specified file as the
2884<li><c>default=linux</c> refers to the default operating system for LILO to boot from the options listed below this line. The name linux refers to the label line below in each of the boot options. </li> 2999 new boot sector. In normal use, this should not be altered. If the install
3000 line is missing, LILO will assume a default of <path>/boot/boot.b</path> as
3001 the file to be used.
3002</li>
3003<li>
3004 The existence of <c>prompt</c> tells LILO to display the classic <e>lilo:</e>
3005 prompt at bootup. While it is not recommended that you remove the prompt line,
3006 if you do remove it, you can still get a prompt by holding down the [Shift]
3007 key while your machine starts to boot.
3008</li>
3009<li>
3010 <c>timeout=50</c> sets the amount of time that LILO will wait for user input
3011 before proceeding with booting the default line entry. This is measured in
3012 tenths of a second, with 50 as the default.
3013</li>
3014<li>
3015 <c>lba32</c> describes the hard disk geometry to LILO. Another common entry
3016 here is linear. You should not change this line unless you are very aware of
3017 what you are doing. Otherwise, you could put your system in an unbootable
3018 state.
3019</li>
3020<li>
3021 <c>default=linux</c> refers to the default operating system for LILO to boot
3022 from the options listed below this line. The name linux refers to the label
3023 line below in each of the boot options.
3024</li>
3025<li>
2885<li><c>image=/boot/bzImage</c> specifies the linux kernel to boot with this particular boot option. </li> 3026 <c>image=/boot/bzImage</c> specifies the linux kernel to boot with this
2886<li><c>label=linux</c> names the operating system option in the LILO screen. In this case, it is also the name referred to by the default line. </li> 3027 particular boot option
2887<li><c>read-only</c> specifies that the root partition (see the root line below) is read-only and cannot be altered during the boot process. </li> 3028</li>
3029<li>
3030 <c>label=linux</c> names the operating system option in the LILO screen. In
3031 this case, it is also the name referred to by the default line.
3032</li>
3033<li>
3034 <c>read-only</c> specifies that the root partition (see the root line below)
3035 is read-only and cannot be altered during the boot process.
3036</li>
3037<li>
2888<li><c>root=/dev/hda3</c> tells LILO what disk partition to use as the root partition. </li> 3038 <c>root=/dev/hda3</c> tells LILO what disk partition to use as the root
3039 partition
3040</li>
2889</ul> 3041</ul>
2890 3042
2891<p> 3043<p>
2892After you have edited your <path>lilo.conf</path> file, it is time to run LILO 3044After you have edited your <path>lilo.conf</path> file, it is time to run LILO
2893to load the information into the MBR: 3045to load the information into the MBR:
2917<table> 3069<table>
2918<tcolumn width="1in"/> 3070<tcolumn width="1in"/>
2919<tcolumn width="1in"/> 3071<tcolumn width="1in"/>
2920<tcolumn width="1in"/> 3072<tcolumn width="1in"/>
2921<tcolumn width="1in"/> 3073<tcolumn width="1in"/>
2922<tr><ti></ti><th>640x480</th><th>800x600</th><th>1024x768</th><th>1280x1024</th></tr> 3074<tr>
2923<tr><th>8 bpp</th><ti>769</ti><ti>771</ti><ti>773</ti><ti>775</ti></tr> 3075 <ti></ti>
2924<tr><th>16 bpp</th><ti>785</ti><ti>788</ti><ti>791</ti><ti>794</ti></tr> 3076 <th>640x480</th>
2925<tr><th>32 bpp</th><ti>786</ti><ti>789</ti><ti>792</ti><ti>795</ti></tr> 3077 <th>800x600</th>
3078 <th>1024x768</th>
3079 <th>1280x1024</th>
3080</tr>
3081<tr>
3082 <th>8 bpp</th>
3083 <ti>769</ti>
3084 <ti>771</ti>
3085 <ti>773</ti>
3086 <ti>775</ti>
3087</tr>
3088<tr>
3089 <th>16 bpp</th>
3090 <ti>785</ti>
3091 <ti>788</ti>
3092 <ti>791</ti>
3093 <ti>794</ti>
3094</tr>
3095<tr>
3096 <th>32 bpp</th>
3097 <ti>786</ti>
3098 <ti>789</ti>
3099 <ti>792</ti>
3100 <ti>795</ti>
3101</tr>
2926</table> 3102</table>
2927 3103
2928<p> 3104<p>
2929LILO-users will have to add <c>vga=xxx</c> on top of their configuration 3105LILO-users will have to add <c>vga=xxx</c> on top of their configuration
2930file. 3106file.
2960like this: 3136like this:
2961</p> 3137</p>
2962 3138
2963<pre caption="Creating a GRUB Bootdisk"> 3139<pre caption="Creating a GRUB Bootdisk">
2964# <i>cd /usr/share/grub/i386-pc/</i> 3140# <i>cd /usr/share/grub/i386-pc/</i>
2965# <i>cat stage1 stage2 > /dev/fd0</i> 3141# <i>cat stage1 stage2 &gt; /dev/fd0</i>
2966</pre> 3142</pre>
2967 3143
2968<p> 3144<p>
2969Now reboot and load the floppy. At the floppy's <c>grub&gt;</c> prompt, you 3145Now reboot and load the floppy. At the floppy's <c>grub&gt;</c> prompt, you
2970can now execute the necessary <c>root</c> and <c>setup</c> commands. 3146can now execute the necessary <c>root</c> and <c>setup</c> commands.
2983<p> 3159<p>
2984If you are using LILO, it is also a good idea to make a bootdisk: 3160If you are using LILO, it is also a good idea to make a bootdisk:
2985</p> 3161</p>
2986 3162
2987<pre caption="Making a Bootdisk"> 3163<pre caption="Making a Bootdisk">
3164<comment>(This will only work if your kernel is smaller than 1.4MB)</comment>
2988# <i>dd if=/boot/your_kernel of=/dev/fd0 </i> 3165# <i>dd if=/boot/your_kernel of=/dev/fd0 </i>
2989<comment>(This will only work if your kernel is smaller than 1.4MB)</comment>
2990</pre> 3166</pre>
2991 3167
2992</body> 3168</body>
2993</section> 3169</section>
2994</chapter> 3170</chapter>
3094</body> 3270</body>
3095</section> 3271</section>
3096</chapter> 3272</chapter>
3097 3273
3098<!-- 3274<!--
3099 Gentoo Stats is down currently. Commenting out for the 3275 Gentoo Stats is down currently. Commenting out for the
3100 time being. I've also changed double-dash to dash-space-dash 3276 time being. I've also changed double-dash to dash-space-dash
3101 because otherwise commenting fails. 3277 because otherwise commenting fails.
3102<chapter> 3278<chapter>
3103<title>Gentoo-Stats</title> 3279<title>Gentoo-Stats</title>
3104<section> 3280<section>
3105<body> 3281<body>
3106 3282
3122are the things that we are monitoring right now through our "gentoo-stats" 3298are the things that we are monitoring right now through our "gentoo-stats"
3123program: 3299program:
3124</p> 3300</p>
3125 3301
3126<ul> 3302<ul>
3127<li>installed packages and their version numbers</li> 3303 <li>installed packages and their version numbers</li>
3304 <li>
3128<li>CPU information: speed (MHz), vendor name, model name, CPU flags (like "mmx" or "3dnow")</li> 3305 CPU information: speed (MHz), vendor name, model name, CPU flags (like "mmx"
3306 or "3dnow")
3307 </li>
3308 <li>
3129<li>memory information (total available physical RAM, total available swap space)</li> 3309 Memory information (total available physical RAM, total available swap
3310 space)
3311 </li>
3130<li>PCI cards and network controller chips</li> 3312 <li>PCI cards and network controller chips</li>
3131<li>the Gentoo Linux profile your machine is using (that is, where the <path>/etc/make.profile</path> link is pointing to).</li> 3313 <li>
3314 The Gentoo Linux profile your machine is using (that is, where the
3315 <path>/etc/make.profile</path> link is pointing to)
3316 </li>
3132</ul> 3317</ul>
3133 3318
3134<p> 3319<p>
3135We are aware that disclosure of sensitive information is a threat to most 3320We are aware that disclosure of sensitive information is a threat to most
3136Gentoo Linux users (just as it is to the developers). 3321Gentoo Linux users (just as it is to the developers).
3137</p> 3322</p>
3138 3323
3139<ul> 3324<ul>
3140<li>Unless you modify the gentoo-stats program, it will never transmit sensitive information such as your passwords, configuration data, shoe size...</li> 3325 <li>
3326 Unless you modify the gentoo-stats program, it will never transmit sensitive
3327 information such as your passwords, configuration data, shoe size...
3328 </li>
3329 <li>
3141<li>Transmission of your e-mail addresses is optional and turned off by default.</li> 3330 Transmission of your e-mail addresses is optional and turned off by default
3142<li>The IP address your data transmission originates from will never be logged in such a way that we can identify you. There are no "IP address/system ID" pairs.</li> 3331 </li>
3332 <li>
3333 The IP address your data transmission originates from will never be logged
3334 in such a way that we can identify you. There are no "IP address/system ID"
3335 pairs.
3336 </li>
3143</ul> 3337</ul>
3144 3338
3145<p> 3339<p>
3146The installation is easy - just run the following commands: 3340The installation is easy - just run the following commands:
3147</p> 3341</p>
3188attention to the next steps in order for them to succesfully 3382attention to the next steps in order for them to succesfully
3189install Gentoo Linux: 3383install Gentoo Linux:
3190</p> 3384</p>
3191 3385
3192<ul> 3386<ul>
3193<li>Be sure to start the LiveCD with the <c>doataraid</c> kerneloption.</li> 3387 <li>Be sure to start the LiveCD with the <c>doataraid</c> kerneloption</li>
3194<li>If you've forgotten to select <c>doataraid</c> during bootup, or the modules mysteriously didn't load, load them as needed: 3388 <li>
3389 If you've forgotten to select <c>doataraid</c> during bootup, or the modules
3390 mysteriously didn't load, load them as needed:
3195<pre caption = "Loading RAID modules"> 3391<pre caption = "Loading RAID modules">
3196# <i>modprobe ataraid</i> 3392# <i>modprobe ataraid</i>
3197<comment>For Promise Raid Controllers:</comment> 3393<comment>(For Promise Raid Controllers:)</comment>
3198# <i>modprobe pdcraid</i> 3394# <i>modprobe pdcraid</i>
3199<comment>For Highpoint Raid Controllers:</comment> 3395<comment>(For Highpoint Raid Controllers:)</comment>
3200# <i>modprobe hptraid</i> 3396# <i>modprobe hptraid</i>
3201</pre></li> 3397</pre>
3398 </li>
3399 <li>
3202<li>Some ATA RAID Controllers require you to reboot after partitioning; formatting will otherwise fail.</li> 3400 Some ATA RAID Controllers require you to reboot after partitioning;
3401 formatting will otherwise fail
3402 </li>
3203<li>Before chrooting, mount the devicetree into the new environment: 3403 <li>Before chrooting, mount the devicetree into the new environment:
3204<pre caption = "Mounting /dev into /mnt/gentoo/dev"> 3404<pre caption = "Mounting /dev into /mnt/gentoo/dev">
3205# <i>mount -o bind /dev /mnt/gentoo/dev</i> 3405# <i>mount -o bind /dev /mnt/gentoo/dev</i>
3206</pre></li> 3406</pre>
3407 </li>
3207<li>During kernel configuration, select the required RAID options: 3408 <li>During kernel configuration, select the required RAID options:
3208<pre caption = "RAID in the Linux Kernel Configuration"> 3409<pre caption = "RAID in the Linux Kernel Configuration">
3209<comment>For Highpoint RAID controllers:</comment> 3410<comment>For Highpoint RAID controllers:</comment>
3210ATA/IDE/MFM/RLL support ---&gt; 3411ATA/IDE/MFM/RLL support ---&gt;
3211[*] HPT36X/37X chipset support 3412[*] HPT36X/37X chipset support
3212[*] Support for IDE Raid controllers 3413[*] Support for IDE Raid controllers
3216[*] PROMISE PDC202{46|62|65|67} support 3417[*] PROMISE PDC202{46|62|65|67} support
3217<comment>and/or</comment> 3418<comment>and/or</comment>
3218[*] PROMISE PDC202{68|69|70|71|75|76|77} support 3419[*] PROMISE PDC202{68|69|70|71|75|76|77} support
3219[*] Support for IDE Raid controllers 3420[*] Support for IDE Raid controllers
3220[*] Support Promise software RAID (Fasttrak(tm)) 3421[*] Support Promise software RAID (Fasttrak(tm))
3221</pre></li> 3422</pre>
3222<li>When using GRUB add <c>--stage2=/boot/grub/stage2</c> when running <c>grub</c> to the <c>setup</c> command: 3423 </li>
3424 <li>
3425 When using GRUB add <c>--stage2=/boot/grub/stage2</c> when running
3426 <c>grub</c> to the <c>setup</c> command:
3223<pre caption = "Installing GRUB for Hardware RAID systems"> 3427<pre caption = "Installing GRUB for Hardware RAID systems">
3224grub&gt; <i>root (hd0,0)</i> 3428grub&gt; <i>root (hd0,0)</i>
3225grub&gt; <i>setup --stage2=/boot/grub/stage2 (hd0)</i> 3429grub&gt; <i>setup --stage2=/boot/grub/stage2 (hd0)</i>
3226grub&gt; <i>quit</i> 3430grub&gt; <i>quit</i>
3227</pre> 3431</pre>
3228Also, in the GRUB configuration be sure to point the <c>root</c> 3432 Also, in the GRUB configuration be sure to point the <c>root</c>
3229to the appropriate RAID device: 3433 to the appropriate RAID device:
3230<pre caption = "grub.conf for RAID"> 3434<pre caption = "grub.conf for RAID">
3231title=My Gentoo Linux on RAID 3435title=My Gentoo Linux on RAID
3232root (hd0,0) 3436root (hd0,0)
3233kernel (hd0,0)/boot/bzImage root=/dev/ataraid/dXpY 3437kernel (hd0,0)/boot/bzImage root=/dev/ataraid/dXpY
3234</pre></li> 3438</pre>
3439 </li>
3440 <li>
3235<li>LILO users should set the <c>root</c> option to the appropriate RAID device: 3441 LILO users should set the <c>root</c> option to the appropriate RAID device:
3236<pre caption = "lilo.conf for RAID"> 3442<pre caption = "lilo.conf for RAID">
3237image=/boot/bzImage 3443image=/boot/bzImage
3238label=linux 3444label=linux
3239read-only 3445read-only
3240root=/dev/ataraid/dXpY 3446root=/dev/ataraid/dXpY
3241</pre></li> 3447</pre>
3448 </li>
3242</ul> 3449</ul>
3243 3450
3244<p> 3451<p>
3245If you still have problems installing Gentoo Linux on your Hardware 3452If you still have problems installing Gentoo Linux on your Hardware
3246RAID, be sure to report them on <uri>http://bugs.gentoo.org</uri>. 3453RAID, be sure to report them on <uri>http://bugs.gentoo.org</uri>.

Legend:
Removed from v.1.176  
changed lines
  Added in v.1.177

  ViewVC Help
Powered by ViewVC 1.1.20