/[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.40 Revision 1.49
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.40 2005/07/10 20:28:33 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.49 2005/10/14 13:24:25 neysx 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>
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.1</version> 24<version>2.8</version>
23<date>2005-07-10</date> 25<date>2005-10-14</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>
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 networkless
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>
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>
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
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>
125For a networkless installation, copy over the source code files from
126<path>/mnt/cdrom/distfiles/</path> to
127<path>/mnt/gentoo/usr/portage/distfiles/</path>.
128</p>
129
130<p>
123Edit <path>/mnt/gentoo/etc/make.conf</path> to suit your needs (USE flag, CFLAGS 131Edit <path>/mnt/gentoo/etc/make.conf</path> to suit your needs (USE flags,
124and CXXFLAGS). You can use the <c>nano</c> editor for this. 132CFLAGS and CXXFLAGS). You can use the <c>nano</c> editor for this.
125</p> 133</p>
126 134
127</body> 135</body>
128</section> 136</section>
129<section> 137<section>
130<title>Installing the Gentoo Base System</title> 138<title>Installing the Gentoo Base System</title>
131<body> 139<body>
132 140
133<p> 141<p>
142Mount the <path>/proc</path> file system first, copy over the
134Mount the <path>/proc</path> file system first and then chroot into your Gentoo 143<path>/etc/resolv.conf</path> file and then chroot into your Gentoo
135environment. 144environment.
136</p> 145</p>
137 146
138<pre caption="Preparing and chrooting"> 147<pre caption="Preparing and chrooting">
139# <i>mount -t proc none /mnt/gentoo/proc</i> 148# <i>mount -t proc none /mnt/gentoo/proc</i>
149# <i>cp /etc/resolv.conf /mnt/gentoo/etc/</i>
140# <i>chroot /mnt/gentoo /bin/bash</i> 150# <i>chroot /mnt/gentoo /bin/bash</i>
141# <i>env-update</i> &amp;&amp; <i>source /etc/profile</i> 151# <i>env-update</i> &amp;&amp; <i>source /etc/profile</i>
142</pre> 152</pre>
143 153
144<p> 154<p>
146update your Portage tree. 156update your Portage tree.
147</p> 157</p>
148 158
149<p> 159<p>
150Next, make sure <path>/etc/make.profile</path> points to the right profile. The 160Next, make sure <path>/etc/make.profile</path> points to the right profile. The
151default one should suffice for most users; subprofiles are available for 161default one should suffice for most users; sub profiles are available for
152different kernels (like <path>2.4/</path> for 2.4-kernel based profiles). Change 162different kernels (like <path>2.4/</path> for 2.4-kernel based profiles). Change
153the profile using <c>ln -sf</c>. 163the profile using <c>ln -sfn</c>.
154</p> 164</p>
155 165
156<ul> 166<ul>
157 <li> 167 <li>
158 Bootstrapping (not available for networkless installations) happens using 168 Bootstrapping (not available for networkless installations) happens using
163 using <c>emerge&nbsp;-e&nbsp;system</c> (or <c>-N</c> if you haven't 173 using <c>emerge&nbsp;-e&nbsp;system</c> (or <c>-N</c> if you haven't
164 altered the default CFLAGS/CXXFLAGS). 174 altered the default CFLAGS/CXXFLAGS).
165 </li> 175 </li>
166</ul> 176</ul>
167 177
168<p>
169Stage3 users (except those performing a networkless installation) need to
170upgrade the baselayout package:
171</p>
172
173<pre caption="Upgrading baselayout">
174# <i>CONFIG_PROTECT="-*" emerge baselayout</i>
175</pre>
176
177</body> 178</body>
178</section> 179</section>
179<section> 180<section>
180<title>Kernel Configuration</title> 181<title>Kernel Configuration</title>
181<body> 182<body>
187</p> 188</p>
188 189
189<p> 190<p>
190Install a kernel source (<c>gentoo-sources</c> and <c>vanilla-sources</c> are 191Install a kernel source (<c>gentoo-sources</c> and <c>vanilla-sources</c> are
191available for networkless installations) and configure it using <c>make 192available for networkless installations) and configure it using <c>make
192menuconfig</c> followed by <c>make&nbsp;&amp;&amp;make&nbsp;modules_install</c> 193menuconfig</c> followed by
194<c>make&nbsp;&amp;&amp;&nbsp;make&nbsp;modules_install</c> inside
193inside <path>/usr/src/linux</path>. Copy the <path>arch/i386/bzImage</path> file 195<path>/usr/src/linux</path>. Copy the <path>arch/i386/boot/bzImage</path> file
194over to <path>/boot</path>. You can also <c>emerge&nbsp;genkernel</c> 196over to <path>/boot</path>. You can also <c>emerge&nbsp;genkernel</c> and use
195and use <c>genkernel&nbsp;--udev&nbsp;all</c>. 197<c>genkernel&nbsp;all</c>.
196</p> 198</p>
197 199
198<p> 200<p>
199Genkernel users will need to <c>emerge&nbsp;coldplug</c> and 201Genkernel users will need to <c>emerge&nbsp;coldplug</c> and
200<c>rc-update&nbsp;add&nbsp;coldplug&nbsp;default</c>. 202<c>rc-update&nbsp;add&nbsp;coldplug&nbsp;default</c>.
220</pre> 222</pre>
221 223
222<p> 224<p>
223Edit <path>/etc/conf.d/hostname</path> and <path>/etc/conf.d/domainname</path>, 225Edit <path>/etc/conf.d/hostname</path> and <path>/etc/conf.d/domainname</path>,
224run <c>rc-update&nbsp;add&nbsp;domainname&nbsp;default</c> and edit 226run <c>rc-update&nbsp;add&nbsp;domainname&nbsp;default</c> and edit
225<path>/etc/conf.d/net</path> and <path>/etc/resolv.conf</path> to 227<path>/etc/conf.d/net</path> to
226configure your network. Add the <c>net.eth0</c> initscript to the default 228configure your network. Add the <c>net.eth0</c> init script to the default
227runlevel. If you have multiple NICs, symlink them to the <c>net.eth0</c> 229run level. If you have multiple NICs, symlink them to the <c>net.eth0</c>
228init script and add them to the default runlevel as well. 230init script and add them to the default run level as well.
229</p> 231</p>
230 232
231<p> 233<p>
232Edit <path>/etc/hosts</path>; examples are given below: 234Edit <path>/etc/hosts</path>; examples are given below:
233</p> 235</p>
242<comment>(For a dynamic IP)</comment> 244<comment>(For a dynamic IP)</comment>
243127.0.0.1 localhost.homenetwork tux localhost 245127.0.0.1 localhost.homenetwork tux localhost
244</pre> 246</pre>
245 247
246<p> 248<p>
247Emerge <c>pcmcia-cs</c> and add it to the default runlevel if you need it. 249Emerge <c>pcmcia-cs</c> and add it to the default run level if you need it.
248</p> 250</p>
249 251
250<p> 252<p>
251Set the root password using <c>passwd</c>. 253Set the root password using <c>passwd</c>.
252</p> 254</p>
262<section> 264<section>
263<title>Installing System Tools</title> 265<title>Installing System Tools</title>
264<body> 266<body>
265 267
266<p> 268<p>
2672.4 kernel users need to <c>emerge&nbsp;--unmerge&nbsp;udev</c> and 269Users of a 2.4 kernel need to run <c>emerge&nbsp;--unmerge&nbsp;udev</c> and
268<c>emerge&nbsp;devfsd</c>. 270<c>emerge&nbsp;devfsd</c>.
269</p> 271</p>
270 272
271<p> 273<p>
272Install a system logger like <c>syslog-ng</c> and add it to the default 274Install a system logger like <c>syslog-ng</c> and add it to the default
296splashimage=(hd0,0)/grub/splash.xpm.gz 298splashimage=(hd0,0)/grub/splash.xpm.gz
297 299
298<comment># genkernel users</comment> 300<comment># genkernel users</comment>
299title=Gentoo Linux 2.6.11-r3 301title=Gentoo Linux 2.6.11-r3
300root (hd0,0) 302root (hd0,0)
301kernel /kernel-2.6.11-gentoo-r3 root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev 303kernel /kernel-genkernel-x86-2.6.11-gentoo-r3 root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev
302initrd /initrd-2.6.11-gentoo-r3 304initrd /initramfs-genkernel-x86-2.6.11-gentoo-r3
303 305
304<comment># non-genkernel users (no initrd)</comment> 306<comment># non-genkernel users (no initrd)</comment>
305title=Gentoo Linux 2.6.11 r3 307title=Gentoo Linux 2.6.11 r3
306root (hd0,0) 308root (hd0,0)
307kernel /kernel-2.6.11-gentoo-r3 root=/dev/hda3 309kernel /kernel-2.6.11-gentoo-r3 root=/dev/hda3
324 label=gentoo 326 label=gentoo
325 read-only 327 read-only
326 root=/dev/hda3 328 root=/dev/hda3
327 329
328<comment># For genkernel users</comment> 330<comment># For genkernel users</comment>
329image=/boot/kernel-2.6.11-gentoo-r3 331image=/boot/kernel-genkernel-x86-2.6.11-gentoo-r3
330 label=gentoo 332 label=gentoo
331 read-only 333 read-only
332 root=/dev/ram0 334 root=/dev/ram0
333 append="init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev" 335 append="init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev"
334 initrd=/boot/initrd-2.6.11-gentoo-r3 336 initrd=/boot/initramfs-genkernel-x86-2.6.11-gentoo-r3
335 337
336<comment># For dual-booting</comment> 338<comment># For dual-booting</comment>
337other=/dev/hda6 339other=/dev/hda6
338 label=windows 340 label=windows
339</pre> 341</pre>
370Thanks for installing Gentoo! 372Thanks for installing Gentoo!
371</p> 373</p>
372 374
373</body> 375</body>
374</section> 376</section>
375</chapter> 377</chapter>
376</guide> 378</guide>

Legend:
Removed from v.1.40  
changed lines
  Added in v.1.49

  ViewVC Help
Powered by ViewVC 1.1.20