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

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

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

Revision 1.63 Revision 1.78
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.63 2006/09/29 14:11:46 nightmorph Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.78 2007/06/01 22:58:24 rane Exp $ -->
3 3
4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5 5
6<guide link="/doc/en/gentoo-x86-quickinstall.xml" lang="en"> 6<guide link="/doc/en/gentoo-x86-quickinstall.xml" lang="en">
7<title>Gentoo Linux x86 Quick Install Guide</title> 7<title>Gentoo Linux x86 Quick Install Guide</title>
23 23
24<!-- The content of this document is licensed under the CC-BY-SA license --> 24<!-- The content of this document is licensed under the CC-BY-SA license -->
25<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 25<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
26<license/> 26<license/>
27 27
28<version>8</version> 28<version>19</version>
29<date>2006-09-16</date> 29<date>2007-06-02</date>
30 30
31<chapter> 31<chapter>
32<title>Introduction</title> 32<title>Introduction</title>
33<section> 33<section>
34<body> 34<body>
76You can find the minimal CD ISO in 76You can find the minimal CD ISO in
77<path>releases/x86/&lt;release&gt;/installcd</path> or the LiveCD ISO in 77<path>releases/x86/&lt;release&gt;/installcd</path> or the LiveCD ISO in
78<path>releases/x86/&lt;release&gt;/livecd</path>. The <e>minimal</e> 78<path>releases/x86/&lt;release&gt;/livecd</path>. The <e>minimal</e>
79installation CD is only useful for Internet-based installations. You can use 79installation CD is only useful for Internet-based installations. You can use
80the <e>LiveCD</e> to perform a networkless installation as documented in the 80the <e>LiveCD</e> to perform a networkless installation as documented in the
81<uri link="/doc/en/handbook/2006.1/handbook-x86.xml">2006.1 x86 installation 81<uri link="/doc/en/handbook/2007.0/handbook-x86.xml">2007.0 x86 installation
82handbook</uri>. The minimal CD is recommended. 82handbook</uri>. The minimal CD is recommended.
83</p> 83</p>
84 84
85<p> 85<p>
86<uri link="/doc/en/faq.xml#isoburning">Burn</uri> the CD and boot it. 86<uri link="/doc/en/faq.xml#isoburning">Burn</uri> the CD and boot it.
322</p> 322</p>
323 323
324<pre caption="Download a stage3 archive"> 324<pre caption="Download a stage3 archive">
325livecd ~ # <i>cd /mnt/gentoo</i> 325livecd ~ # <i>cd /mnt/gentoo</i>
326livecd gentoo # <i>links http://www.gentoo.org/main/en/mirrors.xml</i> 326livecd gentoo # <i>links http://www.gentoo.org/main/en/mirrors.xml</i>
327<comment>(Pick a mirror, move to the releases/x86/current/stages directory 327<comment>(Pick a mirror, move to the releases/x86/current/stages directory highlight the
328highlight the stage3 of your choice, probably stage3-i686-2006.1.tar.bz2 328stage3 of your choice, probably the i686 stage3 and press D to download it)</comment>
329and press D to download it)</comment>
330 329
331<comment>(<b>Or</b> download it directly with wget without choosing a nearby mirror)</comment> 330<comment>(<b>Or</b> download it directly with wget without choosing a nearby mirror)</comment>
332livecd ~ # <i>cd /mnt/gentoo</i> 331livecd ~ # <i>cd /mnt/gentoo</i>
333livecd gentoo # <i>wget http://gentoo.osuosl.org/releases/x86/current/stages/stage3-i686-2006.1.tar.bz2</i> 332livecd gentoo # <i>wget ftp://gentoo.osuosl.org/pub/gentoo/releases/x86/current/stages/stage3-i686*tar.bz2</i>
334</pre> 333</pre>
335 334
336<pre caption="Unpack the stage3 archive"> 335<pre caption="Unpack the stage3 archive">
337livecd gentoo # <i>time tar xjpf stage3*</i> 336livecd gentoo # <i>time tar xjpf stage3*</i>
338 337
387</pre> 386</pre>
388 387
389</body> 388</body>
390</section> 389</section>
391<section> 390<section>
392<title>Set your timezone</title> 391<title>Set your time zone</title>
393<body> 392<body>
394 393
395<p>
396Set your time zone information by copying the correct file from
397<path>/usr/share/zoneinfo</path> over the <path>/etc/localtime</path> file.
398</p> 394<p>
395Set your time zone information by using the correct listing in
396<path>/usr/share/zoneinfo</path>.
397</p>
399 398
400<pre caption="Copy your timezone file"> 399<pre caption="Setting your timezone">
400livecd / # <i>ls /usr/share/zoneinfo</i>
401<comment>(Using Brussels as an example)</comment> 401<comment>(Using Brussels as an example)</comment>
402livecd / # <i>cp /usr/share/zoneinfo/Europe/Brussels /etc/localtime</i> 402livecd / # <i>cp /usr/share/zoneinfo/Europe/Brussels /etc/localtime</i>
403
403livecd / # <i>date</i> 404livecd / # <i>date</i>
404Wed Mar 8 00:46:05 CET 2006 405Wed Mar 8 00:46:05 CET 2006
405</pre> 406</pre>
406 407
407</body> 408</body>
432<section> 433<section>
433<title>Kernel Configuration</title> 434<title>Kernel Configuration</title>
434<body> 435<body>
435 436
436<p> 437<p>
437Install a kernel source (usually <c>gentoo-sources</c> or 438Install a kernel source (usually <c>gentoo-sources</c>), configure it, compile
438<c>vanilla-sources</c>), configure it, compile it and copy the
439<path>arch/i386/boot/bzImage</path> file to <path>/boot</path>. 439it and copy the <path>arch/i386/boot/bzImage</path> file to <path>/boot</path>.
440</p> 440</p>
441 441
442<pre caption="Install a kernel source, compile it and install the kernel"> 442<pre caption="Install a kernel source, compile it and install the kernel">
443livecd etc # <i>time emerge gentoo-sources</i> 443livecd etc # <i>time emerge gentoo-sources</i>
444 444
498<comment>(If you want to reconnect via ssh after you have rebooted your new box:)</comment> 498<comment>(If you want to reconnect via ssh after you have rebooted your new box:)</comment>
499livecd conf.d # <i>rc-update add sshd default</i> 499livecd conf.d # <i>rc-update add sshd default</i>
500</pre> 500</pre>
501 501
502<note> 502<note>
503Emerge <c>pcmcia-cs</c> and add it to the default run level if you need it. 503Emerge <c>pcmciautils</c> if you need support for PCMCIA cards.
504</note> 504</note>
505 505
506<p> 506<p>
507Set the root password using <c>passwd</c>. 507Set the root password using <c>passwd</c>.
508</p> 508</p>
513Retype new UNIX password: <comment>type_the_password_again</comment> 513Retype new UNIX password: <comment>type_the_password_again</comment>
514passwd: password updated successfully 514passwd: password updated successfully
515</pre> 515</pre>
516 516
517<p> 517<p>
518Edit <path>/etc/conf.d/clock</path> to define the time zone you used
519previously.
520</p>
521
522<pre caption="Edit /etc/conf.d/clock">
523livecd conf.d # <i>nano -w /etc/conf.d/clock</i>
524TIMEZONE="Europe/Brussels"
525</pre>
526
527<p>
518Check the system configuration in <path>/etc/rc.conf</path>, 528Check the system configuration in <path>/etc/rc.conf</path>,
519<path>/etc/conf.d/rc</path>, <path>/etc/conf.d/keymaps</path>, 529<path>/etc/conf.d/rc</path>, <path>/etc/conf.d/keymaps</path> and edit any of
520<path>/etc/conf.d/clock</path> and edit any of those files if required. 530those files if required.
521</p> 531</p>
522 532
523<pre caption="Optional: edit some config files"> 533<pre caption="Optional: edit some config files">
524livecd conf.d # <i>nano -w /etc/rc.conf</i> 534livecd conf.d # <i>nano -w /etc/rc.conf</i>
525livecd conf.d # <i>nano -w /etc/conf.d/rc</i> 535livecd conf.d # <i>nano -w /etc/conf.d/rc</i>
526livecd conf.d # <i>nano -w /etc/conf.d/keymaps</i> 536livecd conf.d # <i>nano -w /etc/conf.d/keymaps</i>
527livecd conf.d # <i>nano -w /etc/conf.d/clock</i>
528</pre> 537</pre>
529 538
530</body> 539</body>
531</section> 540</section>
532<section> 541<section>
555livecd conf.d # <i>rc-update add vixie-cron default</i> 564livecd conf.d # <i>rc-update add vixie-cron default</i>
556</pre> 565</pre>
557 566
558<p> 567<p>
559Install the necessary file system tools (<c>xfsprogs</c>, <c>reiserfsprogs</c> 568Install the necessary file system tools (<c>xfsprogs</c>, <c>reiserfsprogs</c>
560or <c>jfsutils</c>) and networking tools (<c>dhcpcd</c> or <c>rp-pppoe</c>) if 569or <c>jfsutils</c>) and networking tools (<c>dhcpcd</c> or <c>ppp</c>) if you
561you need any. 570need any.
562</p> 571</p>
563 572
564<pre caption="Install extra tools if required"> 573<pre caption="Install extra tools if required">
565livecd conf.d # <i>emerge xfsprogs</i> <comment>(If you use the XFS file system)</comment> 574livecd conf.d # <i>emerge xfsprogs</i> <comment>(If you use the XFS file system)</comment>
566livecd conf.d # <i>emerge jfsutils</i> <comment>(If you use the JFS file system)</comment> 575livecd conf.d # <i>emerge jfsutils</i> <comment>(If you use the JFS file system)</comment>
567livecd conf.d # <i>emerge reiserfsprogs</i> <comment>(If you use the Reiser file system)</comment> 576livecd conf.d # <i>emerge reiserfsprogs</i> <comment>(If you use the Reiser file system)</comment>
568livecd conf.d # <i>emerge dhcpcd</i> <comment>(If you need a DHCP client)</comment> 577livecd conf.d # <i>emerge dhcpcd</i> <comment>(If you need a DHCP client)</comment>
569livecd conf.d # <i>USE="-X" emerge rp-pppoe</i> <comment>(If you need PPPoE ADSL connectivity)</comment> 578livecd conf.d # <i>emerge ppp</i> <comment>(If you need PPPoE ADSL connectivity)</comment>
570</pre> 579</pre>
571 580
572</body> 581</body>
573</section> 582</section>
574<section> 583<section>
722<section> 731<section>
723<title>Last configuration touches</title> 732<title>Last configuration touches</title>
724<body> 733<body>
725 734
726<p> 735<p>
727Start by selecting nearby mirrors either by defining the <c>RSYNC</c> and 736Start by selecting nearby mirrors either by defining the <c>SYNC</c> and
728<c>GENTOO_MIRRORS</c> variables in <path>/etc/make.conf</path> or by using 737<c>GENTOO_MIRRORS</c> variables in <path>/etc/make.conf</path> or by using
729<c>mirrorselect</c>. You can also define the number of concurrent compilation 738<c>mirrorselect</c>. You can also define the number of concurrent compilation
730processes at this point. 739processes at this point.
731</p> 740</p>
732 741
746</p> 755</p>
747 756
748<pre caption="View USE flags in use and enable or disable some"> 757<pre caption="View USE flags in use and enable or disable some">
749mybox ~ # <i>emerge -vpe world</i> 758mybox ~ # <i>emerge -vpe world</i>
750<comment>(Portage displays the packages and their USE flags, as an example, let's 759<comment>(Portage displays the packages and their USE flags, as an example, let's
751disable ipv6 and fortran, and enable userlocales and unicode)</comment> 760disable ipv6 and fortran, and enable unicode)</comment>
752mybox ~ # <i>echo 'USE="nptl nptlonly -ipv6 -fortran userlocales unicode"' >> /etc/make.conf</i> 761mybox ~ # <i>echo 'USE="nptl nptlonly -ipv6 -fortran unicode"' >> /etc/make.conf</i>
753</pre> 762</pre>
754 763
755<p>
756If you enabled the <c>userlocales</c> USE flag for versions of glibc that still
757support it, you should edit <path>/etc/locales.build</path> and define the
758locales you want to build.
759</p> 764<p>
760 765Recent versions of glibc use <path>/etc/locale.gen</path> to define locale
761<p> 766settings.
762Later versions of glibc ignore the userlocales USE flag and use
763<path>/etc/locale.gen</path> instead. If you are upgrading glibc to such a
764version, you should create <path>/etc/locale.gen</path> <e>and remove</e>
765<path>/etc/locales.build</path>. Check the output of <c>emerge -vpe world</c>
766to know whether glibc supports the userlocales USE flag.
767</p> 767</p>
768 768
769<pre caption="Define locales"> 769<pre caption="Define locales">
770mybox ~ # <i>cd /etc</i> 770mybox ~ # <i>cd /etc</i>
771<comment>(For versions of glibc with the userlocales USE flag)</comment>
772mybox etc # <i>nano -w locales.build</i>
773
774<comment>(For recent versions of glibc, convert locales.build)</comment>
775mybox etc # <i>grep '^[^#].*' locales.build | sed 's:/: :' >locale.gen</i>
776mybox etc # <i>rm locales.build</i>
777mybox etc # <i>nano -w locale.gen</i> 771mybox etc # <i>nano -w locale.gen</i>
778</pre> 772</pre>
779 773
780<p> 774<p>
781Last but not least, you may want to alter the <c>CFLAGS</c> variable in your 775Last but not least, you may want to alter the <c>CFLAGS</c> variable in your
881<comment>(Look at the list of packages and their USE flags, 875<comment>(Look at the list of packages and their USE flags,
882then edit make.conf if required.</comment> 876then edit make.conf if required.</comment>
883mybox etc # <i>nano -w /etc/make.conf</i> 877mybox etc # <i>nano -w /etc/make.conf</i>
884<comment>(The following USE flags have been defined)</comment> 878<comment>(The following USE flags have been defined)</comment>
885USE="nptl nptlonly -ipv6 -fortran unicode svg hal dbus \ 879USE="nptl nptlonly -ipv6 -fortran unicode svg hal dbus \
886 -kde -qt -arts -eds -esd gnome gstreamer gtk -xmms firefox" 880 -kde -qt3 -qt4 -arts -eds -esd gnome gstreamer gtk firefox"
887 881
888mybox etc # <i>time emerge gnome</i> 882mybox etc # <i>time emerge gnome</i>
889<comment>(326 packages have been emerged)</comment> 883<comment>(326 packages have been emerged)</comment>
890 884
891real 520m44.532s 885real 520m44.532s
898<comment>(Look at the list of packages and their USE flags, 892<comment>(Look at the list of packages and their USE flags,
899then edit make.conf if required.</comment> 893then edit make.conf if required.</comment>
900mybox etc # <i>nano -w /etc/make.conf</i> 894mybox etc # <i>nano -w /etc/make.conf</i>
901<comment>The following USE flags have been defined)</comment> 895<comment>The following USE flags have been defined)</comment>
902USE="nptl nptlonly -ipv6 -fortran unicode svg hal dbus \ 896USE="nptl nptlonly -ipv6 -fortran unicode svg hal dbus \
903 kde qt -arts -eds -esd -gnome -gstreamer -gtk -xmms -firefox" 897 kde qt3 qt4 -arts -eds -esd -gnome -gstreamer -gtk -firefox"
904 898
905mybox etc # <i>time emerge kde-meta</i> 899mybox etc # <i>time emerge kde-meta</i>
906<comment>(391 packages have been emerged)</comment> 900<comment>(391 packages have been emerged)</comment>
907 901
908real 1171m25.318s 902real 1171m25.318s

Legend:
Removed from v.1.63  
changed lines
  Added in v.1.78

  ViewVC Help
Powered by ViewVC 1.1.20