/[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.49 - (hide annotations) (download) (as text)
Fri Oct 14 13:24:25 2005 UTC (8 years, 11 months ago) by neysx
Branch: MAIN
Changes since 1.48: +10 -9 lines
File MIME type: application/xml
#109269 ln -sf should be ln -sfn, missing space in make command

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

  ViewVC Help
Powered by ViewVC 1.1.20