/[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.58 Revision 1.59
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.58 2006/06/29 14:02:43 rane Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.59 2006/08/31 01:40:57 nightmorph 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>
8 8
9<author title="Author"> 9<author title="Author">
10 <mail link="neysx@gentoo.org">Xavier Neys</mail> 10 <mail link="neysx@gentoo.org">Xavier Neys</mail>
11</author> 11</author>
12<author title="Author"> 12<author title="Author">
13 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 13 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
14</author> 14</author>
15<author title="Author">Steven Wagner</author> 15<author title="Author">Steven Wagner</author>
16 16
17<abstract> 17<abstract>
18The Quick install guide covers the Gentoo install process in a non-verbose 18The Quick install guide covers the Gentoo install process in a non-verbose
19manner. Its purpose is to allow users to perform a stage3 install in no time. 19manner. Its purpose is to allow users to perform a stage3 install in no time.
20Users should already have prior experience with installing Gentoo Linux if they 20Users should already have prior experience with installing Gentoo Linux if they
21want to follow this guide. 21want to follow this guide.
22</abstract> 22</abstract>
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>5</version> 28<version>6</version>
29<date>2006-06-29</date> 29<date>2006-08-30</date>
30 30
31<chapter> 31<chapter>
32<title>Introduction</title> 32<title>Introduction</title>
33<section> 33<section>
34<body> 34<body>
35 35
36<p> 36<p>
37This guide contains all commands you should use to complete a stage3 37This guide contains all commands you should use to complete a stage3
38installation of Gentoo. You need a connection to the Internet to download the 38installation of Gentoo. You need a connection to the Internet to download the
39stage3 and Portage snapshots. 39stage3 and Portage snapshots.
40</p> 40</p>
41 41
42<p> 42<p>
43Timing output follows all commands that take more than a couple of seconds to 43Timing output follows all commands that take more than a couple of seconds to
44finish. Commands were timed on an AMD 2000 1.66 Ghz PC with 512 Mb of RAM and 44finish. Commands were timed on an AMD 2000 1.66 Ghz PC with 512 Mb of RAM and
66</chapter> 66</chapter>
67 67
68<chapter> 68<chapter>
69<title>Quick Install Guide</title> 69<title>Quick Install Guide</title>
70<section> 70<section>
71<title>Installation Media</title> 71<title>Installation Media</title>
72<body> 72<body>
73 73
74<p> 74<p>
75Download a CD from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. 75Download a CD from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>.
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.0/handbook-x86.xml">2006.0 x86 installation 81<uri link="/doc/en/handbook/2006.1/handbook-x86.xml">2006.1 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.
87</p> 87</p>
88 88
89</body> 89</body>
90</section> 90</section>
91<section> 91<section>
92<title>Booting the CD</title> 92<title>Booting the CD</title>
93<body> 93<body>
94 94
95<p> 95<p>
96Press 96Press
132<comment>(The following is an example, adapt it to your hardware)</comment> 132<comment>(The following is an example, adapt it to your hardware)</comment>
133livecd root # <i>modprobe 3w-9xxx</i> 133livecd root # <i>modprobe 3w-9xxx</i>
134livecd root # <i>modprobe r8169</i> 134livecd root # <i>modprobe r8169</i>
135</pre> 135</pre>
136 136
137</body> 137</body>
138</section> 138</section>
139<section> 139<section>
140<title>Network Configuration</title> 140<title>Network Configuration</title>
141<body> 141<body>
142 142
143<p> 143<p>
144If your network does not work already, you can use <c>net-setup</c> to configure 144If your network does not work already, you can use <c>net-setup</c> to configure
145your network. You might need to load support for your network card using 145your network. You might need to load support for your network card using
146<c>modprobe</c> prior to the configuration. If you have ADSL, use 146<c>modprobe</c> prior to the configuration. If you have ADSL, use
147<c>adsl-setup</c> and <c>adsl-start</c>. For PPTP support, first edit 147<c>pppoe-setup</c> and <c>pppoe-start</c>. For PPTP support, first edit
148<path>/etc/ppp/chap-secrets</path> and <path>/etc/ppp/options.pptp</path> and 148<path>/etc/ppp/chap-secrets</path> and <path>/etc/ppp/options.pptp</path> and
149then use <c>pptp &lt;server&nbsp;ip&gt;</c>. 149then use <c>pptp &lt;server&nbsp;ip&gt;</c>.
150</p> 150</p>
151 151
152<p> 152<p>
153For wireless access, use <c>iwconfig</c> to set the wireless parameters and then 153For wireless access, use <c>iwconfig</c> to set the wireless parameters and then
154use either <c>net-setup</c> again or run <c>ifconfig</c>, <c>dhcpcd</c> and/or 154use either <c>net-setup</c> again or run <c>ifconfig</c>, <c>dhcpcd</c> and/or
155<c>route</c> manually. 155<c>route</c> manually.
156</p> 156</p>
157 157
158<p> 158<p>
159If you are behind a proxy, do not forget to initialize your system using 159If you are behind a proxy, do not forget to initialize your system using
160<c>export http_proxy</c>, <c>ftp_proxy</c> and <c>RSYNC_PROXY</c>. 160<c>export http_proxy</c>, <c>ftp_proxy</c> and <c>RSYNC_PROXY</c>.
161</p> 161</p>
162 162
163<pre caption="Configure networking the guided way"> 163<pre caption="Configure networking the guided way">
164livecd root # <i>net-setup eth0</i> 164livecd root # <i>net-setup eth0</i>
165</pre> 165</pre>
166 166
167<p> 167<p>
168Alternatively, you can start networking manually. The following example assigns 168Alternatively, you can start networking manually. The following example assigns
169the IP address 192.168.1.10 to your PC and defines 192.168.1.1 as your router 169the IP address 192.168.1.10 to your PC and defines 192.168.1.1 as your router
170and name server. 170and name server.
171</p> 171</p>
172 172
173<pre caption="Configure networking the manual way"> 173<pre caption="Configure networking the manual way">
174livecd root # <i>ifconfig eth0 192.168.1.10/24</i> 174livecd root # <i>ifconfig eth0 192.168.1.10/24</i>
175livecd root # <i>route add default gw 192.168.1.1</i> 175livecd root # <i>route add default gw 192.168.1.1</i>
176livecd root # <i>echo nameserver 192.168.1.1 > /etc/resolv.conf</i> 176livecd root # <i>echo nameserver 192.168.1.1 &gt; /etc/resolv.conf</i>
177</pre> 177</pre>
178 178
179<p> 179<p>
180The installation CD allows you to start an <c>sshd</c> server, add additional 180The installation CD allows you to start an <c>sshd</c> server, add additional
181users, run <c>irssi</c> (a command-line chat client) and surf the web using 181users, run <c>irssi</c> (a command-line chat client) and surf the web using
182<c>lynx</c> or <c>links</c>. 182<c>lynx</c> or <c>links</c>.
183</p> 183</p>
184 184
185</body> 185</body>
186</section> 186</section>
187<section> 187<section>
188<title>Optional: connect to your new box over ssh</title> 188<title>Optional: connect to your new box over ssh</title>
189<body> 189<body>
190 190
191<p> 191<p>
313<comment>(Set the current date and time if required)</comment> 313<comment>(Set the current date and time if required)</comment>
314livecd ~ # <i>date 030600162006</i> <comment>(Format is MMDDhhmmYYYY)</comment> 314livecd ~ # <i>date 030600162006</i> <comment>(Format is MMDDhhmmYYYY)</comment>
315Mon Mar 6 00:16:00 UTC 2006 315Mon Mar 6 00:16:00 UTC 2006
316</pre> 316</pre>
317 317
318<p> 318<p>
319Next, download a stage from one of our <uri 319Next, download a stage from one of our <uri
320link="/main/en/mirrors.xml">mirrors</uri>. Go to <path>/mnt/gentoo</path> and 320link="/main/en/mirrors.xml">mirrors</uri>. Go to <path>/mnt/gentoo</path> and
321unpack the stage using <c>tar xjpf &lt;stage3 tarball&gt;</c>. 321unpack the stage using <c>tar xjpf &lt;stage3 tarball&gt;</c>.
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
328highlight the stage3 of your choice, probably stage3-i686-2006.0.tar.bz2 328highlight the stage3 of your choice, probably stage3-i686-2006.1.tar.bz2
329and press D to download it)</comment> 329and press D to download it)</comment>
330 330
331<comment>(<b>Or</b> download it directly with wget without choosing a nearby mirror)</comment> 331<comment>(<b>Or</b> download it directly with wget without choosing a nearby mirror)</comment>
332livecd ~ # <i>cd /mnt/gentoo</i> 332livecd ~ # <i>cd /mnt/gentoo</i>
333livecd gentoo # <i>wget http://gentoo.osuosl.org/releases/x86/current/stages/stage3-i686-2006.0.tar.bz2</i> 333livecd gentoo # <i>wget http://gentoo.osuosl.org/releases/x86/current/stages/stage3-i686-2006.1.tar.bz2</i>
334</pre> 334</pre>
335 335
336<pre caption="Unpack the stage3 archive"> 336<pre caption="Unpack the stage3 archive">
337livecd gentoo # <i>time tar xjpf stage3*</i> 337livecd gentoo # <i>time tar xjpf stage3*</i>
338 338
339real 1m13.157s 339real 1m13.157s
340user 1m2.920s 340user 1m2.920s
341sys 0m7.230s 341sys 0m7.230s
342</pre> 342</pre>
343 343
344<p> 344<p>
345Install the latest Portage snapshot. Proceed as for the stage3 archive: choose 345Install the latest Portage snapshot. Proceed as for the stage3 archive: choose
346a nearby mirror from our <uri link="/main/en/mirrors.xml">list</uri>, download 346a nearby mirror from our <uri link="/main/en/mirrors.xml">list</uri>, download
347the latest snapshot and unpack it. 347the latest snapshot and unpack it.
348</p> 348</p>
793</p> 793</p>
794 794
795<pre caption="Last edit of make.conf"> 795<pre caption="Last edit of make.conf">
796mybox etc # <i>nano -w make.conf</i> 796mybox etc # <i>nano -w make.conf</i>
797<comment>(Set -march to your CPU type in CFLAGS)</comment> 797<comment>(Set -march to your CPU type in CFLAGS)</comment>
798CFLAGS="-O2 -march=<i>athlon-xp</i> -pipe" 798CFLAGS="-O2 -march=<i>athlon-xp</i> -pipe"
799<comment>(Add the following line)</comment> 799<comment>(Add the following line)</comment>
800FEATURES="parallel-fetch ccache" 800FEATURES="parallel-fetch ccache"
801<comment>(Only add the following if you know what you're doing)</comment> 801<comment>(Only add the following if you know what you're doing)</comment>
802ACCEPT_KEYWORDS="~x86" 802ACCEPT_KEYWORDS="~x86"
803</pre> 803</pre>
804 804
805<p> 805<p>
806You might want to recompile your whole system twice to make full use of your 806You might want to recompile your whole system twice to make full use of your
807latest configuration changes. It would take quite a long time to complete and 807latest configuration changes. It would take quite a long time to complete and
808yield minimal speed benefits. It is recommended that you let your system 808yield minimal speed benefits. You can let your system optimise itself gradually
809optimise itself gradually over time when new versions of packages are 809over time when new versions of packages are released. However, recompiling is
810released. 810a still good idea from the standpoint of maintaining system consistency. Please
811see the <uri link="/doc/en/gcc-upgrading.xml">Gentoo GCC Upgrading Guide</uri>
812for a discussion on the benefits of ensuring a consistently built system and
813world.
811</p> 814</p>
812 815
813<p> 816<p>
814Recompiling only the packages that have already been updated since the release 817Recompiling only the packages that have already been updated since the release
815or that are affected by your new USE flags will take enough time. You might 818or that are affected by your new USE flags will take enough time. You might
816also have to remove packages that block your upgrade. Look for "[blocks 819also have to remove packages that block your upgrade. Look for "[blocks
817<brite>B</brite> ]" in the output of <c>emerge -vpuD --newuse world</c> and 820<brite>B</brite> ]" in the output of <c>emerge -vpuD --newuse world</c> and
818use <c>emerge -C</c> to remove them. 821use <c>emerge -C</c> to remove them.
819</p> 822</p>
820 823
821<pre caption="Update your packages"> 824<pre caption="Update your packages">
822<comment>(Install ccache)</comment> 825<comment>(Install ccache)</comment>
823mybox etc # <i>emerge ccache</i> 826mybox etc # <i>emerge ccache</i>
824 827
825<comment>(Please note that the switch to ~x86 causes many packages to be upgraded)</comment> 828<comment>(Please note that the switch to ~x86 causes many packages to be upgraded)</comment>

Legend:
Removed from v.1.58  
changed lines
  Added in v.1.59

  ViewVC Help
Powered by ViewVC 1.1.20