/[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.45
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.45 2005/08/09 13:24:25 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>
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.5</version>
23<date>2005-07-10</date> 25<date>2005-08-09</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 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>
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
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
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>
136Mount the <path>/proc</path> file system first, copy over the
134Mount the <path>/proc</path> file system first and then chroot into your Gentoo 137<path>/etc/resolv.conf</path> file and then chroot into your Gentoo
135environment. 138environment.
136</p> 139</p>
137 140
138<pre caption="Preparing and chrooting"> 141<pre caption="Preparing and chrooting">
139# <i>mount -t proc none /mnt/gentoo/proc</i> 142# <i>mount -t proc none /mnt/gentoo/proc</i>
143# <i>cp /etc/resolv.conf /mnt/gentoo/etc/</i>
140# <i>chroot /mnt/gentoo /bin/bash</i> 144# <i>chroot /mnt/gentoo /bin/bash</i>
141# <i>env-update</i> &amp;&amp; <i>source /etc/profile</i> 145# <i>env-update</i> &amp;&amp; <i>source /etc/profile</i>
142</pre> 146</pre>
143 147
144<p> 148<p>
145If 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
146update your Portage tree. 150update your Portage tree.
147</p> 151</p>
148 152
149<p> 153<p>
150Next, 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
151default one should suffice for most users; subprofiles are available for 155default 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 156different kernels (like <path>2.4/</path> for 2.4-kernel based profiles). Change
153the profile using <c>ln -sf</c>. 157the profile using <c>ln -sf</c>.
154</p> 158</p>
155 159
156<ul> 160<ul>
157 <li> 161 <li>
158 Bootstrapping (not available for networkless installations) happens using 162 Bootstrapping (not available for network less installations) happens using
159 <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.
160 </li> 164 </li>
161 <li> 165 <li>
162 System installation (not available for networkless installations) happens 166 System installation (not available for network less installations) happens
163 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
164 altered the default CFLAGS/CXXFLAGS). 168 altered the default CFLAGS/CXXFLAGS).
165 </li> 169 </li>
166</ul> 170</ul>
167 171
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> 172</body>
178</section> 173</section>
179<section> 174<section>
180<title>Kernel Configuration</title> 175<title>Kernel Configuration</title>
181<body> 176<body>
186<c>ln -sf</c>. 181<c>ln -sf</c>.
187</p> 182</p>
188 183
189<p> 184<p>
190Install a kernel source (<c>gentoo-sources</c> and <c>vanilla-sources</c> are 185Install a kernel source (<c>gentoo-sources</c> and <c>vanilla-sources</c> are
191available for networkless installations) and configure it using <c>make 186available for network less installations) and configure it using <c>make
192menuconfig</c> followed by <c>make&nbsp;&amp;&amp;make&nbsp;modules_install</c> 187menuconfig</c> followed by <c>make&nbsp;&amp;&amp;make&nbsp;modules_install</c>
193inside <path>/usr/src/linux</path>. Copy the <path>arch/i386/bzImage</path> file 188inside <path>/usr/src/linux</path>. Copy the <path>arch/i386/bzImage</path> file
194over to <path>/boot</path>. You can also <c>emerge&nbsp;genkernel</c> 189over to <path>/boot</path>. You can also <c>emerge&nbsp;genkernel</c>
195and use <c>genkernel&nbsp;--udev&nbsp;all</c>. 190and use <c>genkernel&nbsp;--udev&nbsp;all</c>.
196</p> 191</p>
220</pre> 215</pre>
221 216
222<p> 217<p>
223Edit <path>/etc/conf.d/hostname</path> and <path>/etc/conf.d/domainname</path>, 218Edit <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 219run <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 220<path>/etc/conf.d/net</path> to
226configure your network. Add the <c>net.eth0</c> initscript to the default 221configure 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> 222run 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. 223init script and add them to the default run level as well.
229</p> 224</p>
230 225
231<p> 226<p>
232Edit <path>/etc/hosts</path>; examples are given below: 227Edit <path>/etc/hosts</path>; examples are given below:
233</p> 228</p>
242<comment>(For a dynamic IP)</comment> 237<comment>(For a dynamic IP)</comment>
243127.0.0.1 localhost.homenetwork tux localhost 238127.0.0.1 localhost.homenetwork tux localhost
244</pre> 239</pre>
245 240
246<p> 241<p>
247Emerge <c>pcmcia-cs</c> and add it to the default runlevel if you need it. 242Emerge <c>pcmcia-cs</c> and add it to the default run level if you need it.
248</p> 243</p>
249 244
250<p> 245<p>
251Set the root password using <c>passwd</c>. 246Set the root password using <c>passwd</c>.
252</p> 247</p>
296splashimage=(hd0,0)/grub/splash.xpm.gz 291splashimage=(hd0,0)/grub/splash.xpm.gz
297 292
298<comment># genkernel users</comment> 293<comment># genkernel users</comment>
299title=Gentoo Linux 2.6.11-r3 294title=Gentoo Linux 2.6.11-r3
300root (hd0,0) 295root (hd0,0)
301kernel /kernel-2.6.11-gentoo-r3 root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev 296kernel /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 297initrd /initramfs-genkernel-x86-2.6.11-gentoo-r3
303 298
304<comment># non-genkernel users (no initrd)</comment> 299<comment># non-genkernel users (no initrd)</comment>
305title=Gentoo Linux 2.6.11 r3 300title=Gentoo Linux 2.6.11 r3
306root (hd0,0) 301root (hd0,0)
307kernel /kernel-2.6.11-gentoo-r3 root=/dev/hda3 302kernel /kernel-2.6.11-gentoo-r3 root=/dev/hda3
324 label=gentoo 319 label=gentoo
325 read-only 320 read-only
326 root=/dev/hda3 321 root=/dev/hda3
327 322
328<comment># For genkernel users</comment> 323<comment># For genkernel users</comment>
329image=/boot/kernel-2.6.11-gentoo-r3 324image=/boot/kernel-genkernel-x86-2.6.11-gentoo-r3
330 label=gentoo 325 label=gentoo
331 read-only 326 read-only
332 root=/dev/ram0 327 root=/dev/ram0
333 append="init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev" 328 append="init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev"
334 initrd=/boot/initrd-2.6.11-gentoo-r3 329 initrd=/boot/initramfs-genkernel-x86-2.6.11-gentoo-r3
335 330
336<comment># For dual-booting</comment> 331<comment># For dual-booting</comment>
337other=/dev/hda6 332other=/dev/hda6
338 label=windows 333 label=windows
339</pre> 334</pre>
358Log in as <c>root</c>, then add one or more users for day-to-day use using 353Log in as <c>root</c>, then add one or more users for day-to-day use using
359<c>useradd&nbsp;-m&nbsp;-G&nbsp;&lt;groups&gt;&nbsp;&lt;username&gt;</c>. 354<c>useradd&nbsp;-m&nbsp;-G&nbsp;&lt;groups&gt;&nbsp;&lt;username&gt;</c>.
360</p> 355</p>
361 356
362<p> 357<p>
363If you performed a networkless installation, mount the packages CD at 358If you performed a network less installation, mount the packages CD at
364<path>/mnt/cdrom</path> and <c>export&nbsp;PKGDIR="/mnt/cdrom"</c> after which 359<path>/mnt/cdrom</path> and <c>export&nbsp;PKGDIR="/mnt/cdrom"</c> after which
365you can <c>emerge&nbsp;-k&nbsp;&lt;package&gt;</c> to install additional 360you can <c>emerge&nbsp;-k&nbsp;&lt;package&gt;</c> to install additional
366software like <c>kde</c>. 361software like <c>kde</c>.
367</p> 362</p>
368 363

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

  ViewVC Help
Powered by ViewVC 1.1.20