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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.40 - (show annotations) (download) (as text)
Sun Jul 10 20:28:33 2005 UTC (9 years, 2 months ago) by swift
Branch: MAIN
Changes since 1.39: +5 -4 lines
File MIME type: application/xml
Coding Style update, no content change

1 <?xml version='1.0' encoding="UTF-8"?>
2 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.39 2005/07/10 20:27:33 swift Exp $ -->
3
4 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5
6 <guide link="/doc/en/gentoo-x86-quickinstall.xml">
7 <title>Gentoo Linux x86 Quick Install Guide</title>
8
9 <author title="Author">
10 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
11 </author>
12 <author title="Author">Steven Wagner</author>
13
14 <abstract>
15 The Quick install guide covers the Gentoo install process in a
16 non-verbose manner. Users should already have prior experience with
17 installing Gentoo Linux if they want to follow this guide.
18 </abstract>
19
20 <license/>
21
22 <version>2.1</version>
23 <date>2005-07-10</date>
24
25 <chapter>
26 <title>Quick Install Guide</title>
27 <section>
28 <title>Installation Media</title>
29 <body>
30
31 <p>
32 Download a CD from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>.
33 You can find the ISOs in
34 <path>releases/&lt;architecture&gt;/&lt;release&gt;/installcd</path>. The
35 <e>minimal</e> installation cd is only useful for internet-based installations;
36 with the <e>universal</e> installation cd you can perform a networkless
37 installation as well.
38 </p>
39
40 <p>
41 <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,
43 you need to start the <c>pcmcia</c> init script if you need PCMCIA support.
44 </p>
45
46 <p>
47 The installation cds allow you to start an <c>sshd</c> server, add additional
48 users, run <c>irssi</c> (a command-line chat client) and surf the web using
49 <c>lynx</c> or <c>links2</c>.
50 </p>
51
52 </body>
53 </section>
54 <section>
55 <title>Network Configuration</title>
56 <body>
57
58 <p>
59 If your network does not work already, you can use <c>net-setup</c> to configure
60 your 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
62 <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
64 then use <c>pptp &lt;server&nbsp;ip&gt;</c>.
65 </p>
66
67 <p>
68 For wireless access, use <c>iwconfig</c> to set the wireless parameters and then
69 use eiter <c>net-setup</c> again or run <c>ifconfig</c>, <c>dhcpcd</c> and/or
70 <c>route</c> manually.
71 </p>
72
73 <p>
74 If you are behind a proxy, do not forget to initialise your system using
75 <c>export http_proxy</c>, <c>ftp_proxy</c> and <c>RSYNC_PROXY</c>.
76 </p>
77
78 </body>
79 </section>
80 <section>
81 <title>Preparing the Disks</title>
82 <body>
83
84 <p>
85 Use <c>fdisk</c> or <c>cfdisk</c> to create your partition layout. You need at
86 least a swap partition (type 82) and one Linux partition (type 83).
87 </p>
88
89 <p>
90 Use <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
92 swap partition using <c>mkswap</c> and <c>swapon</c>.
93 </p>
94
95 <p>
96 Mount the freshly created file systems on <path>/mnt/gentoo</path>. Create
97 directories for the other mount points (like <path>/mnt/gentoo/boot</path>) if
98 you need them.
99 </p>
100
101 </body>
102 </section>
103 <section>
104 <title>Setting Up The Stage</title>
105 <body>
106
107 <p>
108 First make sure your date is set correctly using <c>date MMDDhhmmYYYY</c>. Next,
109 download a stage from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>
110 or use the one available on the installation CD
111 (<path>/mnt/cdrom/stages</path>). Go to <path>/mnt/gentoo</path> and unpack the
112 stage using <c>tar&nbsp;-xvjpf&nbsp;&lt;stage&nbsp;tarball&gt;</c>.
113 </p>
114
115 <p>
116 Install a Portage snapshot if you are performing a networkless installation: go
117 to <path>/mnt/gentoo/usr</path> and run
118 <c>tar&nbsp;-xvjf&nbsp;/mnt/cdrom/snapshots/&lt;snapshot&gt;</c>. Other users
119 can download a portage snapshot and install it likewise.
120 </p>
121
122 <p>
123 Edit <path>/mnt/gentoo/etc/make.conf</path> to suit your needs (USE flag, CFLAGS
124 and CXXFLAGS). You can use the <c>nano</c> editor for this.
125 </p>
126
127 </body>
128 </section>
129 <section>
130 <title>Installing the Gentoo Base System</title>
131 <body>
132
133 <p>
134 Mount the <path>/proc</path> file system first and then chroot into your Gentoo
135 environment.
136 </p>
137
138 <pre caption="Preparing and chrooting">
139 # <i>mount -t proc none /mnt/gentoo/proc</i>
140 # <i>chroot /mnt/gentoo /bin/bash</i>
141 # <i>env-update</i> &amp;&amp; <i>source /etc/profile</i>
142 </pre>
143
144 <p>
145 If you are not running a networkless installation, issue <c>emerge --sync</c> to
146 update your Portage tree.
147 </p>
148
149 <p>
150 Next, make sure <path>/etc/make.profile</path> points to the right profile. The
151 default one should suffice for most users; subprofiles are available for
152 different kernels (like <path>2.4/</path> for 2.4-kernel based profiles). Change
153 the profile using <c>ln -sf</c>.
154 </p>
155
156 <ul>
157 <li>
158 Bootstrapping (not available for networkless installations) happens using
159 <c>scripts/bootstrap.sh</c> in the <path>/usr/portage</path> directory.
160 </li>
161 <li>
162 System installation (not available for networkless installations) happens
163 using <c>emerge&nbsp;-e&nbsp;system</c> (or <c>-N</c> if you haven't
164 altered the default CFLAGS/CXXFLAGS).
165 </li>
166 </ul>
167
168 <p>
169 Stage3 users (except those performing a networkless installation) need to
170 upgrade the baselayout package:
171 </p>
172
173 <pre caption="Upgrading baselayout">
174 # <i>CONFIG_PROTECT="-*" emerge baselayout</i>
175 </pre>
176
177 </body>
178 </section>
179 <section>
180 <title>Kernel Configuration</title>
181 <body>
182
183 <p>
184 Set your time zone information by changing the <path>/etc/localtime</path>
185 symbolic link to the correct location in <path>/usr/share/zoneinfo</path> using
186 <c>ln -sf</c>.
187 </p>
188
189 <p>
190 Install a kernel source (<c>gentoo-sources</c> and <c>vanilla-sources</c> are
191 available for networkless installations) and configure it using <c>make
192 menuconfig</c> followed by <c>make&nbsp;&amp;&amp;make&nbsp;modules_install</c>
193 inside <path>/usr/src/linux</path>. Copy the <path>arch/i386/bzImage</path> file
194 over to <path>/boot</path>. You can also <c>emerge&nbsp;genkernel</c>
195 and use <c>genkernel&nbsp;--udev&nbsp;all</c>.
196 </p>
197
198 <p>
199 Genkernel users will need to <c>emerge&nbsp;coldplug</c> and
200 <c>rc-update&nbsp;add&nbsp;coldplug&nbsp;default</c>.
201 </p>
202
203 </body>
204 </section>
205 <section>
206 <title>Configuring the System</title>
207 <body>
208
209 <p>
210 Edit your <path>/etc/fstab</path>; an example follows:
211 </p>
212
213 <pre caption="Example fstab">
214 /dev/hda1 /boot ext2 defaults,noatime 1 2
215 /dev/hda2 none swap sw 0 0
216 /dev/hda3 / ext3 noatime 0 1
217 none /proc proc defaults 0 0
218 none /dev/shm tmpfs nodev,nosuid,noexec 0 0
219 /dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0
220 </pre>
221
222 <p>
223 Edit <path>/etc/conf.d/hostname</path> and <path>/etc/conf.d/domainname</path>,
224 run <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
226 configure your network. Add the <c>net.eth0</c> initscript to the default
227 runlevel. If you have multiple NICs, symlink them to the <c>net.eth0</c>
228 init script and add them to the default runlevel as well.
229 </p>
230
231 <p>
232 Edit <path>/etc/hosts</path>; examples are given below:
233 </p>
234
235 <pre caption="Example /etc/hosts">
236 <comment>(For static IPs)</comment>
237 127.0.0.1 localhost
238 192.168.0.5 jenny.homenetwork jenny
239 192.168.0.6 benny.homenetwork benny
240 192.168.0.7 tux.homenetwork tux
241
242 <comment>(For a dynamic IP)</comment>
243 127.0.0.1 localhost.homenetwork tux localhost
244 </pre>
245
246 <p>
247 Emerge <c>pcmcia-cs</c> and add it to the default runlevel if you need it.
248 </p>
249
250 <p>
251 Set the root password using <c>passwd</c>.
252 </p>
253
254 <p>
255 Set the necessary system configuration in <path>/etc/rc.conf</path>,
256 <path>/etc/conf.d/rc</path>, <path>/etc/conf.d/keymaps</path>,
257 <path>/etc/conf.d/clock</path>.
258 </p>
259
260 </body>
261 </section>
262 <section>
263 <title>Installing System Tools</title>
264 <body>
265
266 <p>
267 2.4 kernel users need to <c>emerge&nbsp;--unmerge&nbsp;udev</c> and
268 <c>emerge&nbsp;devfsd</c>.
269 </p>
270
271 <p>
272 Install a system logger like <c>syslog-ng</c> and add it to the default
273 run level. Do the same for a cron daemon like <c>vixie-cron</c> (optional).
274 </p>
275
276 <p>
277 Install the necessary file system tools (<c>xfsprogs</c>, <c>reiserfsprogs</c>
278 or <c>jfsutils</c>) and networking tools (<c>dhcpcd</c> or <c>rp-pppoe</c>).
279 </p>
280
281 </body>
282 </section>
283 <section>
284 <title>Configuring the Bootloader</title>
285 <body>
286
287 <p>
288 Emerge <c>grub</c> or <c>lilo</c>. Edit <path>/boot/grub/grub.conf</path> or
289 <path>/etc/lilo.conf</path> to your likings. Below you will find an example for
290 each.
291 </p>
292
293 <pre caption="Example grub.conf">
294 default 0
295 timeout 30
296 splashimage=(hd0,0)/grub/splash.xpm.gz
297
298 <comment># genkernel users</comment>
299 title=Gentoo Linux 2.6.11-r3
300 root (hd0,0)
301 kernel /kernel-2.6.11-gentoo-r3 root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev
302 initrd /initrd-2.6.11-gentoo-r3
303
304 <comment># non-genkernel users (no initrd)</comment>
305 title=Gentoo Linux 2.6.11 r3
306 root (hd0,0)
307 kernel /kernel-2.6.11-gentoo-r3 root=/dev/hda3
308
309 <comment># Only in case you want to dual-boot</comment>
310 title=Windows XP
311 root (hd0,5)
312 makeactive
313 chainloader +1
314 </pre>
315
316 <pre caption="Example lilo.conf">
317 boot=/dev/hda
318 prompt
319 timeout=50
320 default=gentoo
321
322 <comment># For non-genkernel users</comment>
323 image=/boot/kernel-2.6.11-gentoo-r3
324 label=gentoo
325 read-only
326 root=/dev/hda3
327
328 <comment># For genkernel users</comment>
329 image=/boot/kernel-2.6.11-gentoo-r3
330 label=gentoo
331 read-only
332 root=/dev/ram0
333 append="init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev"
334 initrd=/boot/initrd-2.6.11-gentoo-r3
335
336 <comment># For dual-booting</comment>
337 other=/dev/hda6
338 label=windows
339 </pre>
340
341 <p>
342 GRUB users need to install GRUB in the MBR using
343 <c>grub-install&nbsp;/dev/hda</c> after copying <path>/proc/mounts</path> to
344 <path>/etc/mtab</path>. LILO users need to run <c>/sbin/lilo</c>.
345 </p>
346
347 <p>
348 Exit the chrooted environment, unmount all file systems and reboot.
349 </p>
350
351 </body>
352 </section>
353 <section>
354 <title>Finalizing the Installation</title>
355 <body>
356
357 <p>
358 Log 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>.
360 </p>
361
362 <p>
363 If you performed a networkless installation, mount the packages CD at
364 <path>/mnt/cdrom</path> and <c>export&nbsp;PKGDIR="/mnt/cdrom"</c> after which
365 you can <c>emerge&nbsp;-k&nbsp;&lt;package&gt;</c> to install additional
366 software like <c>kde</c>.
367 </p>
368
369 <p>
370 Thanks for installing Gentoo!
371 </p>
372
373 </body>
374 </section>
375 </chapter>
376 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20