/[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.114 Revision 1.115
39 <author title="Editor"> 39 <author title="Editor">
40 <mail link="peesh@gentoo.org">Jorge Paulo</mail> 40 <mail link="peesh@gentoo.org">Jorge Paulo</mail>
41 </author> 41 </author>
42 <author title="Editor"> 42 <author title="Editor">
43 <mail link="carl@gentoo.org">Carl Anderson</mail> 43 <mail link="carl@gentoo.org">Carl Anderson</mail>
44 </author> 44 </author>
45 <author title="Editor"> 45 <author title="Editor">
46 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 46 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
47 </author> 47 </author>
48 <abstract>These instructions step you through the process of installing Gentoo 48 <abstract>These instructions step you through the process of installing Gentoo
49 Linux 1.4_rc4. The Gentoo Linux installation process supports various installation 49 Linux 1.4_rc4. The Gentoo Linux installation process supports various installation
50 approaches, depending upon how much of the system you want to custom-build from 50 approaches, depending upon how much of the system you want to custom-build from
51 scratch. 51 scratch.
52 </abstract> 52 </abstract>
53<version>2.6.1</version> 53<version>2.6.1</version>
54 <date>7 May 2003</date> 54 <date>8 May 2003</date>
55 <chapter> 55 <chapter>
56 <title>About the Install</title> 56 <title>About the Install</title>
57 <section> 57 <section>
58 <body> 58 <body>
59 <p>This new boot CD will boot from nearly any modern IDE CD-ROM drive, as well 59 <p>This new boot CD will boot from nearly any modern IDE CD-ROM drive, as well
60as many SCSI CD-ROM drives, assuming that your CD-ROM and BIOS both support booting. 60as many SCSI CD-ROM drives, assuming that your CD-ROM and BIOS both support booting.
61Included on the CD-ROM is Linux support for IDE (and PCI IDE) (built-in to the 61Included on the CD-ROM is Linux support for IDE (and PCI IDE) (built-in to the
62kernel) as well as support for all SCSI devices (available as modules.) In 62kernel) as well as support for all SCSI devices (available as modules.) In
63addition, we provide modules for literally every kind of network card that 63addition, we provide modules for literally every kind of network card that
64Linux supports, as well as tools to allow you to configure your network and 64Linux supports, as well as tools to allow you to configure your network and
65establish outbound (as well as inbound) <c>ssh</c> connections and to download 65establish outbound (as well as inbound) <c>ssh</c> connections and to download
66files. </p> 66files. </p>
67 <p>To install from the build CD, you will need to have a 486+ processor and 67 <p>To install from the build CD, you will need to have a 486+ processor and
68ideally at least 64 Megabytes of RAM. (Gentoo Linux has been successfully 68ideally at least 64 Megabytes of RAM. (Gentoo Linux has been successfully
69built with 64MB of RAM + 64MB of swap space, but the build process is awfully 69built with 64MB of RAM + 64MB of swap space, but the build process is awfully
385 <title>Manual Static Configuration</title> 385 <title>Manual Static Configuration</title>
386 <body> 386 <body>
387 <p>We need to setup just enough networking so that we can download 387 <p>We need to setup just enough networking so that we can download
388 sources for the system build, as well as the required localhost interface. 388 sources for the system build, as well as the required localhost interface.
389 Type in the following commands, replacing 389 Type in the following commands, replacing
390 $IFACE with your network interface (typically <c>eth0</c>), $IPNUM 390 $IFACE with your network interface (typically <c>eth0</c>), $IPNUM
391 with your IP address, $BCAST with your broadcast address, and $NMASK 391 with your IP address, $BCAST with your broadcast address, and $NMASK
392 with your network mask. For the <c>route</c> command, replace 392 with your network mask. For the <c>route</c> command, replace
393 $GTWAY with your default gateway. 393 $GTWAY with your default gateway.
394 </p> 394 </p>
395<pre caption="Static IP Network Configuration"> 395<pre caption="Static IP Network Configuration">
396# <c>ifconfig $IFACE $IPNUM broadcast $BCAST netmask $NMASK</c> 396# <c>ifconfig $IFACE $IPNUM broadcast $BCAST netmask $NMASK</c>
397# <c>/sbin/route add -net default gw $GTWAY netmask 0.0.0.0 metric 1</c> 397# <c>/sbin/route add -net default gw $GTWAY netmask 0.0.0.0 metric 1</c>
398</pre> 398</pre>
399 <p>Now it is time to create the <path>/etc/resolv.conf</path> 399 <p>Now it is time to create the <path>/etc/resolv.conf</path>
400 file so that name resolution (finding Web/FTP sites by name, rather than just by IP address) will work.</p> 400 file so that name resolution (finding Web/FTP sites by name, rather
401 than just by IP address) will work. You can use <c>nano -w
402 /etc/resolv.conf</c> to create <path>/etc/resolv.conf</path>.
403 <c>nano</c> is a small and easy-to-use editor.</p>
401 <p>Here is a template to follow for creating your /etc/resolv.conf file: </p> 404 <p>Here is a template to follow for creating your /etc/resolv.conf file: </p>
402<pre caption="/etc/resolv.conf template"> 405<pre caption="/etc/resolv.conf template">
403domain mydomain.com 406domain mydomain.com
404nameserver 10.0.0.1 407nameserver 10.0.0.1
405nameserver 10.0.0.2 408nameserver 10.0.0.2
406</pre> 409</pre>
407 <p>Replace <c>10.0.0.1</c> and <c>10.0.0.2</c> with the IP addresses of your 410 <p>Replace <c>10.0.0.1</c> and <c>10.0.0.2</c> with the IP addresses of your
408 primary and secondary DNS servers respectively.</p> 411 primary and secondary DNS servers respectively.</p>
409 </body> 412 </body>
410 </section> 413 </section>
411 <section> 414 <section>
412 <title>Proxy Configuration</title> 415 <title>Proxy Configuration</title>
413 <body> 416 <body>
414 <p>If you are behind a proxy, it is necessary to configure your proxy before 417 <p>If you are behind a proxy, it could be necessary to configure your proxy before
415 you continue. We will export some variables to set up the proxy accordingly. 418 you continue. We will export some variables to set up the proxy accordingly.
416 </p> 419 </p>
417<pre caption="Setting a Proxy"> 420<pre caption="Setting a Proxy">
421<codenote>If the proxy restricts HTTP traffic:</codenote>
418# <c>export http_proxy=&quot;machine.company.com:1234&quot; </c> 422# <c>export http_proxy=&quot;machine.company.com:1234&quot; </c>
423<codenote>If the proxy restricts FTP traffic:</codenote>
419# <c>export ftp_proxy=&quot;$http_proxy&quot; </c> 424# <c>export ftp_proxy=&quot;machine.company.com&quot; </c>
425<codenote>If the proxy restricts RSYNC traffic:</codenote>
420# <c>export RSYNC_PROXY=&quot;$http_proxy&quot; </c> 426# <c>export RSYNC_PROXY=&quot;machine.company.com&quot; </c>
421</pre> 427</pre>
422 </body> 428 </body>
423 </section> 429 </section>
424 <section> 430 <section>
425 <title>Networking is go!</title> 431 <title>Networking is go!</title>
426 <body> 432 <body>
427 <p>Networking should now be configured and usable. You should be able to use the included 433 <p>Networking should now be configured and usable. You should be able to use the included
428 <c>ssh</c>, <c>scp</c>, <c>lynx</c>, <c>irssi</c> and <c>wget</c> commands to connect to other machines on your LAN or the Internet.</p> 434 <c>ssh</c>, <c>scp</c>, <c>lynx</c>, <c>irssi</c> and <c>wget</c> commands to connect to other machines on your LAN or the Internet.</p>
429 </body> 435 </body>
430 </section> 436 </section>
431 <section> 437 <section>
432 <title>I don't have networking!</title> 438 <title>I don't have networking!</title>
433 <body>If you don't have networking there is some help in the 439 <body>If you don't have networking there is some help in the
434 <uri link="http://forums.gentoo.org/">Gentoo Forums</uri>. 440 <uri link="http://forums.gentoo.org/">Gentoo Forums</uri>.
435 Some useful links can be found at <uri>http://forums.gentoo.org/viewtopic.php?t=43025</uri>. 441 Some useful links can be found at <uri>http://forums.gentoo.org/viewtopic.php?t=43025</uri>.
575</p> 581</p>
576 582
577<p> 583<p>
578All partitions <c>hda5</c> and higher are logical partitions. The numbers 1 584All partitions <c>hda5</c> and higher are logical partitions. The numbers 1
579through 4 are reserved for primary or extended partitions. </p> 585through 4 are reserved for primary or extended partitions. </p>
580 586
581<p> So, In our example, <c>hda1</c> through <c>hda3</c> are primary partitions. 587<p> So, In our example, <c>hda1</c> through <c>hda3</c> are primary partitions.
582<c>hda4</c> is an extended partition that contains logical partitions 588<c>hda4</c> is an extended partition that contains logical partitions
583<c>hda5</c> through <c>hda9</c>. You would never actually 589<c>hda5</c> through <c>hda9</c>. You would never actually
584<i>use</i> <c>/dev/hda4</c> for storing any filesystems directly -- it simply 590<i>use</i> <c>/dev/hda4</c> for storing any filesystems directly -- it simply
585acts as a container for partitions <c>hda5</c> through <c>hda9</c>. </p> 591acts as a container for partitions <c>hda5</c> through <c>hda9</c>. </p>
586 592
587<p> Also, notice that each partition has an "Id", also called a "partition 593<p> Also, notice that each partition has an "Id", also called a "partition
588type". Whenever you create a new partition, you should ensure that the 594type". Whenever you create a new partition, you should ensure that the
589partition type is set correctly. '83' is the correct partition type for 595partition type is set correctly. '83' is the correct partition type for
590partitions that will be housing Linux filesystems, and '82' is the correct 596partitions that will be housing Linux filesystems, '82' is the correct
597partition type for Linux swap partitions and 'fd' is the recommended partition
591partition type for Linux swap partitions. You set the partition type using the 598type for Software RAID partitions. You set the partition type using the
592<c>t</c> option in <c>fdisk</c>. The Linux kernel uses the partition type 599<c>t</c> option in <c>fdisk</c>. The Linux kernel uses the partition type
593setting to auto-detect filesystems and swap devices on the disk at boot-time. 600setting to auto-detect filesystems and swap devices on the disk at boot-time.
594</p> 601</p>
595</body> 602</body>
596</section> 603</section>
597<section> 604<section>
598<title>Using fdisk to set up partitions</title> 605<title>Using fdisk to set up partitions</title>
599<body> 606<body>
600 607
601<p>Now that you've had your introduction to the way disk partitioning is 608<p>Now that you've had your introduction to the way disk partitioning is
602done under Linux, it's time to walk you through the process of setting up disk 609done under Linux, it's time to walk you through the process of setting up disk
603partitions for your Gentoo Linux installation. After we walk you through the 610partitions for your Gentoo Linux installation. After we walk you through the
604process of creating partitions on your disk, your partition configuration will 611process of creating partitions on your disk, your partition configuration will
605look like this: </p> 612look like this: </p>
606 613
647 654
648 655
649<p>Before we partition the disk, here's a quick technical overview of the 656<p>Before we partition the disk, here's a quick technical overview of the
650suggested partition and filesystem configuration to use when installing Gentoo 657suggested partition and filesystem configuration to use when installing Gentoo
651Linux:</p> 658Linux:</p>
652 659
653<table> 660<table>
654 <tr> 661 <tr>
655 <th>Partition</th> 662 <th>Partition</th>
656 <th>Size</th> 663 <th>Size</th>
657 <th>Type</th> 664 <th>Type</th>
658 <th>example device</th> 665 <th>example device</th>
659 </tr> 666 </tr>
660 <tr> 667 <tr>
661 <ti>boot partition, containing kernel(s) and boot information</ti> 668 <ti>boot partition, containing kernel(s) and boot information</ti>
662 <ti>100 Megabytes</ti> 669 <ti>32 Megabytes</ti>
663 <ti>ext2/3 highly recommended (easiest); if ReiserFS then mount with <c>-o notail</c></ti> 670 <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 te size; in these cases 64 Megabytes is recommended</ti>
664 <ti>/dev/hda1</ti> 671 <ti>/dev/hda1</ti>
665 </tr> 672 </tr>
666 <tr> 673 <tr>
667 <ti>swap partition (no longer a 128 Megabyte limit, now 2GB)</ti> 674 <ti>swap partition (no longer a 128 Megabyte limit, now 2GB)</ti>
668 <ti>Generally, configure a swap area that is between one to two times the size of the physical RAM 675 <ti>Generally, configure a swap area that is between one to two times the size of the physical RAM
669 in your system.</ti> 676 in your system.</ti>
670 <ti>Linux swap</ti> 677 <ti>Linux swap</ti>
671 <ti>/dev/hda2</ti> 678 <ti>/dev/hda2</ti>
672 </tr> 679 </tr>
673 <tr> 680 <tr>
674 <ti>root partition, containing main filesystem (/usr, /home, etc)</ti> 681 <ti>root partition, containing main filesystem (/usr, /home, etc)</ti>
675 <ti>&gt;=1.5 Gigabytes</ti> 682 <ti>&gt;=1.5 Gigabytes</ti>
676 <ti>ReiserFS, ext3 recommended; ext2 ok</ti> 683 <ti>ReiserFS, ext3 recommended; ext2 ok</ti>
677 <ti>/dev/hda3</ti> 684 <ti>/dev/hda3</ti>
678 </tr> 685 </tr>
719 726
720<pre caption="An empty partition table"> 727<pre caption="An empty partition table">
721Disk /dev/hda: 30.0 GB, 30005821440 bytes 728Disk /dev/hda: 30.0 GB, 30005821440 bytes
722240 heads, 63 sectors/track, 3876 cylinders 729240 heads, 63 sectors/track, 3876 cylinders
723Units = cylinders of 15120 * 512 = 7741440 bytes 730Units = cylinders of 15120 * 512 = 7741440 bytes
724 731
725 Device Boot Start End Blocks Id System 732 Device Boot Start End Blocks Id System
726 733
727Command (m for help): 734Command (m for help):
728</pre> 735</pre>
729 736
730<p>Now that the in-memory partition table is empty, we're ready to create a 737<p>Now that the in-memory partition table is empty, we're ready to create a
731boot partition. To do this, type <c>n</c> to create a new partition, then 738boot partition. To do this, type <c>n</c> to create a new partition, then
732<c>p</c> to tell fdisk you want a primary partition. Then type <c>1</c> to 739<c>p</c> to tell fdisk you want a primary partition. Then type <c>1</c> to
733create the first primary partition. When prompted for the first cylinder, hit 740create the first primary partition. When prompted for the first cylinder, hit
734enter. When prompted for the last cylinder, type <c>+100M</c> to create a 741enter. When prompted for the last cylinder, type <c>+32M</c> to create a
735partition 100MB in size. You can see output from these steps below:</p> 742partition 32MB in size. You can see output from these steps below:</p>
743
744<note>
745Journaled filesystems require extra space for their journal. Default settings
746require about 33 Megabytes of space. Therefor, if you are using a journaled
747filesystem for <path>/boot</path>, you should type <c>+64M</c> when prompted
748for the last cylinder.
749</note>
736 750
737<pre caption="Steps to create our boot partition"> 751<pre caption="Steps to create our boot partition">
738Command (m for help): n 752Command (m for help): n
739Command action 753Command action
740 e extended 754 e extended
741 p primary partition (1-4) 755 p primary partition (1-4)
742p 756p
743Partition number (1-4): 1 757Partition number (1-4): 1
744First cylinder (1-3876, default 1): 758First cylinder (1-3876, default 1):
745Using default value 1 759Using default value 1
746Last cylinder or +size or +sizeM or +sizeK (1-3876, default 3876): +100M 760Last cylinder or +size or +sizeM or +sizeK (1-3876, default 3876): +32M
747</pre> 761</pre>
748 762
749<p>Now, when you type <c>p</c>, you should see the following partition printout:</p> 763<p>Now, when you type <c>p</c>, you should see the following partition printout:</p>
750 764
751<pre caption="Our first partition has been created"> 765<pre caption="Our first partition has been created">
752Command (m for help): p 766Command (m for help): p
753 767
754Disk /dev/hda: 30.0 GB, 30005821440 bytes 768Disk /dev/hda: 30.0 GB, 30005821440 bytes
755240 heads, 63 sectors/track, 3876 cylinders 769240 heads, 63 sectors/track, 3876 cylinders
756Units = cylinders of 15120 * 512 = 7741440 bytes 770Units = cylinders of 15120 * 512 = 7741440 bytes
757 771
758 Device Boot Start End Blocks Id System 772 Device Boot Start End Blocks Id System
759/dev/hda1 1 14 105808+ 83 Linux 773/dev/hda1 1 14 105808+ 83 Linux
760</pre> 774</pre>
761 775
1605 <path>/etc/modules.autoload</path> file (you can also add any options you 1619 <path>/etc/modules.autoload</path> file (you can also add any options you
1606 need to the same line.) When Gentoo Linux boots, these modules will be automatically 1620 need to the same line.) When Gentoo Linux boots, these modules will be automatically
1607 loaded. Of particular importance is your ethernet card module, if you happened to compile 1621 loaded. Of particular importance is your ethernet card module, if you happened to compile
1608 it as a module: 1622 it as a module:
1609 </p> 1623 </p>
1610<pre caption="/etc/modules.autoload"><comment>This is assuming that you are using a 3com card. 1624<pre caption="/etc/modules.autoload"><comment>This is assuming that you are using a 3com card.
1611Check <path>/lib/modules/`uname -r`/kernel/drivers/net</path> for your card. </comment> 1625Check <path>/lib/modules/`uname -r`/kernel/drivers/net</path> for your card. </comment>
16123c59x 16263c59x
1613</pre> 1627</pre>
1614 <p>Edit the <path>/etc/conf.d/net</path> script to get your network configured for your 1628 <p>Edit the <path>/etc/conf.d/net</path> script to get your network configured for your
1615 first boot: </p> 1629 first boot: </p>
1616<pre caption="Boot time Network Configuration"> 1630<pre caption="Boot time Network Configuration">
1617# <c>nano -w /etc/conf.d/net</c> 1631# <c>nano -w /etc/conf.d/net</c>
1618# <c>rc-update add net.eth0 default</c> 1632# <c>rc-update add net.eth0 default</c>
1619</pre> 1633</pre>
1620 <p>If you have multiple network cards you need to create additional <path>net.eth<comment>x</comment></path> 1634 <p>If you have multiple network cards or tokenring interfaces, you need to create additional <path>net.eth<comment>x</comment></path> or <path>net.tr<comment>x</comment></path>
1621 scripts for each one (<comment>x</comment> = 1, 2, ...): </p> 1635 scripts respectively for each one (<comment>x</comment> = 1, 2, ...): </p>
1622<pre caption="Multiple Network Interfaces"> 1636<pre caption="Multiple Network Interfaces">
1623# <c>cd /etc/init.d</c> 1637# <c>cd /etc/init.d</c>
1624# <c>cp net.eth0 net.eth<comment>x</comment></c> 1638# <c>cp net.eth0 net.eth<comment>x</comment></c>
1625# <c>rc-update add net.eth<comment>x</comment> default</c> 1639# <c>rc-update add net.eth<comment>x</comment> default</c>
1626</pre> 1640</pre>
1627 <p>If you have a PCMCIA card installed, have a quick look into 1641 <p>If you have a PCMCIA card installed, have a quick look into
1628 <path>/etc/init.d/pcmcia</path> to verify that things seem all right for your setup, 1642 <path>/etc/init.d/pcmcia</path> to verify that things seem all right for your setup,
1629 then add this line to the top of <path>/etc/init.d/net.ethx</path>: 1643 then add this line to the top of <path>/etc/init.d/net.ethx</path>:
1630 </p> 1644 </p>
1631<pre caption="PCMCIA depend in /etc/init.d/net.ethx"> 1645<pre caption="PCMCIA depend in /etc/init.d/net.ethx">
1632depend() { 1646depend() {
1633 need pcmcia 1647 need pcmcia
1634} 1648}
1635</pre> 1649</pre>
1636 <p>This makes sure that the PCMCIA drivers are autoloaded whenever your network is loaded. 1650 <p>This makes sure that the PCMCIA drivers are autoloaded whenever your network is loaded.

Legend:
Removed from v.1.114  
changed lines
  Added in v.1.115

  ViewVC Help
Powered by ViewVC 1.1.20