/[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.43 Revision 1.44
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.43 2005/08/01 12:12:22 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.44 2005/08/04 07:01:46 swift 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"> 6<guide link="/doc/en/gentoo-x86-quickinstall.xml">
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="swift@gentoo.org">Sven Vermeulen</mail> 10 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
11</author> 11</author>
12<author title="Author">Steven Wagner</author> 12<author title="Author">Steven Wagner</author>
13 13
14<abstract> 14<abstract>
15The Quick install guide covers the Gentoo install process in a 15The Quick install guide covers the Gentoo install process in a
16non-verbose manner. Users should already have prior experience with 16non-verbose manner. Users should already have prior experience with
17installing Gentoo Linux if they want to follow this guide. 17installing Gentoo Linux if they want to follow this guide.
18</abstract> 18</abstract>
19 19
20<!-- The content of this document is licensed under the CC-BY-SA license -->
21<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
20<license/> 22<license/>
21 23
22<version>2.4</version> 24<version>2.4</version>
23<date>2005-08-01</date> 25<date>2005-08-04</date>
24 26
25<chapter> 27<chapter>
26<title>Quick Install Guide</title> 28<title>Quick Install Guide</title>
27<section> 29<section>
28<title>Installation Media</title> 30<title>Installation Media</title>
29<body> 31<body>
30 32
31<p> 33<p>
32Download a CD from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. 34Download a CD from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>.
33You can find the ISOs in 35You can find the ISOs in
34<path>releases/&lt;architecture&gt;/&lt;release&gt;/installcd</path>. The 36<path>releases/&lt;architecture&gt;/&lt;release&gt;/installcd</path>. The
35<e>minimal</e> installation cd is only useful for internet-based installations; 37<e>minimal</e> installation CD is only useful for Internet-based installations;
36with the <e>universal</e> installation cd you can perform a networkless 38with the <e>universal</e> installation CD you can perform a network less
37installation as well. 39installation as well.
38</p> 40</p>
39 41
40<p> 42<p>
41<uri link="/doc/en/faq.xml#isoburning">Burn</uri> the CD and boot it. Press 43<uri link="/doc/en/faq.xml#isoburning">Burn</uri> the CD and boot it. Press
42<c>F2</c> at the boot screen to find out what boot options exist. Once booted, 44<c>F2</c> at the boot screen to find out what boot options exist. Once booted,
43you need to start the <c>pcmcia</c> init script if you need PCMCIA support. 45you need to start the <c>pcmcia</c> init script if you need PCMCIA support.
44</p> 46</p>
45 47
46<p> 48<p>
47The installation cds allow you to start an <c>sshd</c> server, add additional 49The installation CDs allow you to start an <c>sshd</c> server, add additional
48users, run <c>irssi</c> (a command-line chat client) and surf the web using 50users, run <c>irssi</c> (a command-line chat client) and surf the web using
49<c>lynx</c> or <c>links2</c>. 51<c>lynx</c> or <c>links2</c>.
50</p> 52</p>
51 53
52</body> 54</body>
53</section> 55</section>
54<section> 56<section>
55<title>Network Configuration</title> 57<title>Network Configuration</title>
56<body> 58<body>
57 59
58<p> 60<p>
59If your network does not work already, you can use <c>net-setup</c> to configure 61If your network does not work already, you can use <c>net-setup</c> to configure
60your network. You might need to load support for your network card using 62your network. You might need to load support for your network card using
61<c>modprobe</c> prior to the configuration. If you have ADSL, use 63<c>modprobe</c> prior to the configuration. If you have ADSL, use
62<c>adsl-setup</c> and <c>adsl-start</c>. For PPTP support, first edit 64<c>adsl-setup</c> and <c>adsl-start</c>. For PPTP support, first edit
63<path>/etc/ppp/chap-secrets</path> and <path>/etc/ppp/options.pptp</path> and 65<path>/etc/ppp/chap-secrets</path> and <path>/etc/ppp/options.pptp</path> and
64then use <c>pptp &lt;server&nbsp;ip&gt;</c>. 66then use <c>pptp &lt;server&nbsp;ip&gt;</c>.
65</p> 67</p>
66 68
67<p> 69<p>
68For wireless access, use <c>iwconfig</c> to set the wireless parameters and then 70For wireless access, use <c>iwconfig</c> to set the wireless parameters and then
69use eiter <c>net-setup</c> again or run <c>ifconfig</c>, <c>dhcpcd</c> and/or 71use either <c>net-setup</c> again or run <c>ifconfig</c>, <c>dhcpcd</c> and/or
70<c>route</c> manually. 72<c>route</c> manually.
71</p> 73</p>
72 74
73<p> 75<p>
74If you are behind a proxy, do not forget to initialise your system using 76If you are behind a proxy, do not forget to initialize your system using
75<c>export http_proxy</c>, <c>ftp_proxy</c> and <c>RSYNC_PROXY</c>. 77<c>export http_proxy</c>, <c>ftp_proxy</c> and <c>RSYNC_PROXY</c>.
76</p> 78</p>
77 79
78</body> 80</body>
79</section> 81</section>
80<section> 82<section>
81<title>Preparing the Disks</title> 83<title>Preparing the Disks</title>
82<body> 84<body>
83 85
84<p> 86<p>
85Use <c>fdisk</c> or <c>cfdisk</c> to create your partition layout. You need at 87Use <c>fdisk</c> or <c>cfdisk</c> to create your partition layout. You need at
86least a swap partition (type 82) and one Linux partition (type 83). 88least a swap partition (type 82) and one Linux partition (type 83).
87</p> 89</p>
88 90
89<p> 91<p>
90Use <c>mke2fs</c>, <c>mke2fs -j</c>, <c>mkreiserfs</c>, <c>mkfs.xfs</c> and 92Use <c>mke2fs</c>, <c>mke2fs -j</c>, <c>mkreiserfs</c>, <c>mkfs.xfs</c> and
91<c>mkfs.jfs</c> to create file systems on your Linux partitions. Initialise your 93<c>mkfs.jfs</c> to create file systems on your Linux partitions. Initialize your
92swap partition using <c>mkswap</c> and <c>swapon</c>. 94swap partition using <c>mkswap</c> and <c>swapon</c>.
93</p> 95</p>
94 96
95<p> 97<p>
96Mount the freshly created file systems on <path>/mnt/gentoo</path>. Create 98Mount the freshly created file systems on <path>/mnt/gentoo</path>. Create
97directories for the other mount points (like <path>/mnt/gentoo/boot</path>) if 99directories for the other mount points (like <path>/mnt/gentoo/boot</path>) if
98you need them. 100you need them.
99</p> 101</p>
100 102
101</body> 103</body>
102</section> 104</section>
103<section> 105<section>
104<title>Setting Up The Stage</title> 106<title>Setting Up The Stage</title>
105<body> 107<body>
106 108
107<p> 109<p>
108First make sure your date is set correctly using <c>date MMDDhhmmYYYY</c>. Next, 110First make sure your date is set correctly using <c>date MMDDhhmmYYYY</c>. Next,
109download a stage from one of our <uri link="/main/en/mirrors.xml">mirrors</uri> 111download a stage from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>
110or use the one available on the installation CD 112or use the one available on the installation CD
111(<path>/mnt/cdrom/stages</path>). Go to <path>/mnt/gentoo</path> and unpack the 113(<path>/mnt/cdrom/stages</path>). Go to <path>/mnt/gentoo</path> and unpack the
112stage using <c>tar&nbsp;-xvjpf&nbsp;&lt;stage&nbsp;tarball&gt;</c>. 114stage using <c>tar&nbsp;-xvjpf&nbsp;&lt;stage&nbsp;tarball&gt;</c>.
113</p> 115</p>
114 116
115<p> 117<p>
116Install a Portage snapshot if you are performing a networkless installation: go 118Install a Portage snapshot if you are performing a network less installation: go
117to <path>/mnt/gentoo/usr</path> and run 119to <path>/mnt/gentoo/usr</path> and run
118<c>tar&nbsp;-xvjf&nbsp;/mnt/cdrom/snapshots/&lt;snapshot&gt;</c>. Other users 120<c>tar&nbsp;-xvjf&nbsp;/mnt/cdrom/snapshots/&lt;snapshot&gt;</c>. Other users
119can download a portage snapshot and install it likewise. 121can download a portage snapshot and install it likewise.
120</p> 122</p>
121 123
122<p> 124<p>
123Edit <path>/mnt/gentoo/etc/make.conf</path> to suit your needs (USE flag, CFLAGS 125Edit <path>/mnt/gentoo/etc/make.conf</path> to suit your needs (USE flag, CFLAGS
124and CXXFLAGS). You can use the <c>nano</c> editor for this. 126and CXXFLAGS). You can use the <c>nano</c> editor for this.
125</p> 127</p>
126 128
127</body> 129</body>
128</section> 130</section>
129<section> 131<section>
130<title>Installing the Gentoo Base System</title> 132<title>Installing the Gentoo Base System</title>
131<body> 133<body>
132 134
133<p> 135<p>
134Mount the <path>/proc</path> file system first, copy over the 136Mount the <path>/proc</path> file system first, copy over the
135<path>/etc/resolv.conf</path> file and then chroot into your Gentoo 137<path>/etc/resolv.conf</path> file and then chroot into your Gentoo
136environment. 138environment.
137</p> 139</p>
138 140
139<pre caption="Preparing and chrooting"> 141<pre caption="Preparing and chrooting">
140# <i>mount -t proc none /mnt/gentoo/proc</i> 142# <i>mount -t proc none /mnt/gentoo/proc</i>
141# <i>cp /etc/resolv.conf /mnt/gentoo/etc/</i> 143# <i>cp /etc/resolv.conf /mnt/gentoo/etc/</i>
142# <i>chroot /mnt/gentoo /bin/bash</i> 144# <i>chroot /mnt/gentoo /bin/bash</i>
143# <i>env-update</i> &amp;&amp; <i>source /etc/profile</i> 145# <i>env-update</i> &amp;&amp; <i>source /etc/profile</i>
144</pre> 146</pre>
145 147
146<p> 148<p>
147If you are not running a networkless installation, issue <c>emerge --sync</c> to 149If you are not running a network less installation, issue <c>emerge --sync</c> to
148update your Portage tree. 150update your Portage tree.
149</p> 151</p>
150 152
151<p> 153<p>
152Next, make sure <path>/etc/make.profile</path> points to the right profile. The 154Next, make sure <path>/etc/make.profile</path> points to the right profile. The
153default one should suffice for most users; subprofiles are available for 155default one should suffice for most users; sub profiles are available for
154different kernels (like <path>2.4/</path> for 2.4-kernel based profiles). Change 156different kernels (like <path>2.4/</path> for 2.4-kernel based profiles). Change
155the profile using <c>ln -sf</c>. 157the profile using <c>ln -sf</c>.
156</p> 158</p>
157 159
158<ul> 160<ul>
159 <li> 161 <li>
160 Bootstrapping (not available for networkless installations) happens using 162 Bootstrapping (not available for network less installations) happens using
161 <c>scripts/bootstrap.sh</c> in the <path>/usr/portage</path> directory. 163 <c>scripts/bootstrap.sh</c> in the <path>/usr/portage</path> directory.
162 </li> 164 </li>
163 <li> 165 <li>
164 System installation (not available for networkless installations) happens 166 System installation (not available for network less installations) happens
165 using <c>emerge&nbsp;-e&nbsp;system</c> (or <c>-N</c> if you haven't 167 using <c>emerge&nbsp;-e&nbsp;system</c> (or <c>-N</c> if you haven't
166 altered the default CFLAGS/CXXFLAGS). 168 altered the default CFLAGS/CXXFLAGS).
167 </li> 169 </li>
168</ul> 170</ul>
169 171
170<p> 172<p>
171Stage3 users (except those performing a networkless installation) need to 173Stage3 users (except those performing a network less installation) need to
172upgrade the baselayout package: 174upgrade the baselayout package:
173</p> 175</p>
174 176
175<pre caption="Upgrading baselayout"> 177<pre caption="Upgrading baselayout">
176# <i>CONFIG_PROTECT="-*" emerge baselayout</i> 178# <i>CONFIG_PROTECT="-*" emerge baselayout</i>
177</pre> 179</pre>
178 180
179</body> 181</body>
180</section> 182</section>
181<section> 183<section>
182<title>Kernel Configuration</title> 184<title>Kernel Configuration</title>
183<body> 185<body>
184 186
185<p> 187<p>
186Set your time zone information by changing the <path>/etc/localtime</path> 188Set your time zone information by changing the <path>/etc/localtime</path>
187symbolic link to the correct location in <path>/usr/share/zoneinfo</path> using 189symbolic link to the correct location in <path>/usr/share/zoneinfo</path> using
188<c>ln -sf</c>. 190<c>ln -sf</c>.
189</p> 191</p>
190 192
191<p> 193<p>
192Install a kernel source (<c>gentoo-sources</c> and <c>vanilla-sources</c> are 194Install a kernel source (<c>gentoo-sources</c> and <c>vanilla-sources</c> are
193available for networkless installations) and configure it using <c>make 195available for network less installations) and configure it using <c>make
194menuconfig</c> followed by <c>make&nbsp;&amp;&amp;make&nbsp;modules_install</c> 196menuconfig</c> followed by <c>make&nbsp;&amp;&amp;make&nbsp;modules_install</c>
195inside <path>/usr/src/linux</path>. Copy the <path>arch/i386/bzImage</path> file 197inside <path>/usr/src/linux</path>. Copy the <path>arch/i386/bzImage</path> file
196over to <path>/boot</path>. You can also <c>emerge&nbsp;genkernel</c> 198over to <path>/boot</path>. You can also <c>emerge&nbsp;genkernel</c>
197and use <c>genkernel&nbsp;--udev&nbsp;all</c>. 199and use <c>genkernel&nbsp;--udev&nbsp;all</c>.
198</p> 200</p>
199 201
200<p> 202<p>
201Genkernel users will need to <c>emerge&nbsp;coldplug</c> and 203Genkernel users will need to <c>emerge&nbsp;coldplug</c> and
202<c>rc-update&nbsp;add&nbsp;coldplug&nbsp;default</c>. 204<c>rc-update&nbsp;add&nbsp;coldplug&nbsp;default</c>.
203</p> 205</p>
204 206
205</body> 207</body>
206</section> 208</section>
207<section> 209<section>
208<title>Configuring the System</title> 210<title>Configuring the System</title>
213</p> 215</p>
214 216
215<pre caption="Example fstab"> 217<pre caption="Example fstab">
216/dev/hda1 /boot ext2 defaults,noatime 1 2 218/dev/hda1 /boot ext2 defaults,noatime 1 2
217/dev/hda2 none swap sw 0 0 219/dev/hda2 none swap sw 0 0
218/dev/hda3 / ext3 noatime 0 1 220/dev/hda3 / ext3 noatime 0 1
219none /proc proc defaults 0 0 221none /proc proc defaults 0 0
220none /dev/shm tmpfs nodev,nosuid,noexec 0 0 222none /dev/shm tmpfs nodev,nosuid,noexec 0 0
221/dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0 223/dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0
222</pre> 224</pre>
223 225
224<p> 226<p>
225Edit <path>/etc/conf.d/hostname</path> and <path>/etc/conf.d/domainname</path>, 227Edit <path>/etc/conf.d/hostname</path> and <path>/etc/conf.d/domainname</path>,
226run <c>rc-update&nbsp;add&nbsp;domainname&nbsp;default</c> and edit 228run <c>rc-update&nbsp;add&nbsp;domainname&nbsp;default</c> and edit
227<path>/etc/conf.d/net</path> to 229<path>/etc/conf.d/net</path> to
228configure your network. Add the <c>net.eth0</c> initscript to the default 230configure your network. Add the <c>net.eth0</c> init script to the default
229runlevel. If you have multiple NICs, symlink them to the <c>net.eth0</c> 231run level. If you have multiple NICs, symlink them to the <c>net.eth0</c>
230init script and add them to the default runlevel as well. 232init script and add them to the default run level as well.
231</p> 233</p>
232 234
233<p> 235<p>
234Edit <path>/etc/hosts</path>; examples are given below: 236Edit <path>/etc/hosts</path>; examples are given below:
235</p> 237</p>
236 238
237<pre caption="Example /etc/hosts"> 239<pre caption="Example /etc/hosts">
238<comment>(For static IPs)</comment> 240<comment>(For static IPs)</comment>
239127.0.0.1 localhost 241127.0.0.1 localhost
240192.168.0.5 jenny.homenetwork jenny 242192.168.0.5 jenny.homenetwork jenny
241192.168.0.6 benny.homenetwork benny 243192.168.0.6 benny.homenetwork benny
242192.168.0.7 tux.homenetwork tux 244192.168.0.7 tux.homenetwork tux
243 245
244<comment>(For a dynamic IP)</comment> 246<comment>(For a dynamic IP)</comment>
245127.0.0.1 localhost.homenetwork tux localhost 247127.0.0.1 localhost.homenetwork tux localhost
246</pre> 248</pre>
247 249
248<p> 250<p>
249Emerge <c>pcmcia-cs</c> and add it to the default runlevel if you need it. 251Emerge <c>pcmcia-cs</c> and add it to the default run level if you need it.
250</p> 252</p>
251 253
252<p> 254<p>
253Set the root password using <c>passwd</c>. 255Set the root password using <c>passwd</c>.
254</p> 256</p>
255 257
256<p> 258<p>
257Set the necessary system configuration in <path>/etc/rc.conf</path>, 259Set the necessary system configuration in <path>/etc/rc.conf</path>,
258<path>/etc/conf.d/rc</path>, <path>/etc/conf.d/keymaps</path>, 260<path>/etc/conf.d/rc</path>, <path>/etc/conf.d/keymaps</path>,
259<path>/etc/conf.d/clock</path>. 261<path>/etc/conf.d/clock</path>.
260</p> 262</p>
261 263
262</body> 264</body>
263</section> 265</section>
264<section> 266<section>
350Exit the chrooted environment, unmount all file systems and reboot. 352Exit the chrooted environment, unmount all file systems and reboot.
351</p> 353</p>
352 354
353</body> 355</body>
354</section> 356</section>
355<section> 357<section>
356<title>Finalizing the Installation</title> 358<title>Finalizing the Installation</title>
357<body> 359<body>
358 360
359<p> 361<p>
360Log in as <c>root</c>, then add one or more users for day-to-day use using 362Log in as <c>root</c>, then add one or more users for day-to-day use using
361<c>useradd&nbsp;-m&nbsp;-G&nbsp;&lt;groups&gt;&nbsp;&lt;username&gt;</c>. 363<c>useradd&nbsp;-m&nbsp;-G&nbsp;&lt;groups&gt;&nbsp;&lt;username&gt;</c>.
362</p> 364</p>
363 365
364<p> 366<p>
365If you performed a networkless installation, mount the packages CD at 367If you performed a network less installation, mount the packages CD at
366<path>/mnt/cdrom</path> and <c>export&nbsp;PKGDIR="/mnt/cdrom"</c> after which 368<path>/mnt/cdrom</path> and <c>export&nbsp;PKGDIR="/mnt/cdrom"</c> after which
367you can <c>emerge&nbsp;-k&nbsp;&lt;package&gt;</c> to install additional 369you can <c>emerge&nbsp;-k&nbsp;&lt;package&gt;</c> to install additional
368software like <c>kde</c>. 370software like <c>kde</c>.
369</p> 371</p>
370 372
371<p> 373<p>
372Thanks for installing Gentoo! 374Thanks for installing Gentoo!
373</p> 375</p>
374 376
375</body> 377</body>
376</section> 378</section>
377</chapter> 379</chapter>
378</guide> 380</guide>

Legend:
Removed from v.1.43  
changed lines
  Added in v.1.44

  ViewVC Help
Powered by ViewVC 1.1.20