/[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.45 - (hide annotations) (download) (as text)
Tue Aug 9 13:24:25 2005 UTC (9 years ago) by swift
Branch: MAIN
Changes since 1.44: +3 -12 lines
File MIME type: application/xml
For 2005.1, no more baselayout update needed for stage3 users

1 swift 1.1 <?xml version='1.0' encoding="UTF-8"?>
2 swift 1.45 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.44 2005/08/04 07:01:46 swift 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 swift 1.45 <version>2.5</version>
25     <date>2005-08-09</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     with the <e>universal</e> installation CD you can perform a network less
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 swift 1.44 Install a Portage snapshot if you are performing a network less 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     Edit <path>/mnt/gentoo/etc/make.conf</path> to suit your needs (USE flag, CFLAGS
126     and CXXFLAGS). You can use the <c>nano</c> editor for this.
127     </p>
128    
129     </body>
130     </section>
131     <section>
132     <title>Installing the Gentoo Base System</title>
133     <body>
134    
135     <p>
136 swift 1.41 Mount the <path>/proc</path> file system first, copy over the
137     <path>/etc/resolv.conf</path> file and then chroot into your Gentoo
138 swift 1.38 environment.
139     </p>
140    
141     <pre caption="Preparing and chrooting">
142     # <i>mount -t proc none /mnt/gentoo/proc</i>
143 swift 1.41 # <i>cp /etc/resolv.conf /mnt/gentoo/etc/</i>
144 swift 1.38 # <i>chroot /mnt/gentoo /bin/bash</i>
145     # <i>env-update</i> &amp;&amp; <i>source /etc/profile</i>
146 swift 1.1 </pre>
147    
148     <p>
149 swift 1.44 If you are not running a network less installation, issue <c>emerge --sync</c> to
150 swift 1.38 update your Portage tree.
151 swift 1.1 </p>
152    
153     <p>
154 swift 1.38 Next, make sure <path>/etc/make.profile</path> points to the right profile. The
155 swift 1.44 default one should suffice for most users; sub profiles are available for
156 swift 1.38 different kernels (like <path>2.4/</path> for 2.4-kernel based profiles). Change
157     the profile using <c>ln -sf</c>.
158 swift 1.1 </p>
159    
160 swift 1.38 <ul>
161     <li>
162 swift 1.44 Bootstrapping (not available for network less installations) happens using
163 swift 1.38 <c>scripts/bootstrap.sh</c> in the <path>/usr/portage</path> directory.
164     </li>
165     <li>
166 swift 1.44 System installation (not available for network less installations) happens
167 swift 1.38 using <c>emerge&nbsp;-e&nbsp;system</c> (or <c>-N</c> if you haven't
168     altered the default CFLAGS/CXXFLAGS).
169     </li>
170     </ul>
171    
172     </body>
173     </section>
174     <section>
175     <title>Kernel Configuration</title>
176     <body>
177    
178 swift 1.1 <p>
179 swift 1.38 Set your time zone information by changing the <path>/etc/localtime</path>
180     symbolic link to the correct location in <path>/usr/share/zoneinfo</path> using
181     <c>ln -sf</c>.
182     </p>
183    
184     <p>
185     Install a kernel source (<c>gentoo-sources</c> and <c>vanilla-sources</c> are
186 swift 1.44 available for network less installations) and configure it using <c>make
187 swift 1.38 menuconfig</c> followed by <c>make&nbsp;&amp;&amp;make&nbsp;modules_install</c>
188     inside <path>/usr/src/linux</path>. Copy the <path>arch/i386/bzImage</path> file
189     over to <path>/boot</path>. You can also <c>emerge&nbsp;genkernel</c>
190     and use <c>genkernel&nbsp;--udev&nbsp;all</c>.
191     </p>
192 swift 1.1
193     <p>
194 swift 1.38 Genkernel users will need to <c>emerge&nbsp;coldplug</c> and
195     <c>rc-update&nbsp;add&nbsp;coldplug&nbsp;default</c>.
196 swift 1.1 </p>
197    
198 swift 1.38 </body>
199     </section>
200     <section>
201     <title>Configuring the System</title>
202     <body>
203 swift 1.1
204     <p>
205 swift 1.38 Edit your <path>/etc/fstab</path>; an example follows:
206 swift 1.1 </p>
207    
208 swift 1.38 <pre caption="Example fstab">
209     /dev/hda1 /boot ext2 defaults,noatime 1 2
210     /dev/hda2 none swap sw 0 0
211     /dev/hda3 / ext3 noatime 0 1
212     none /proc proc defaults 0 0
213     none /dev/shm tmpfs nodev,nosuid,noexec 0 0
214     /dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0
215 swift 1.1 </pre>
216    
217     <p>
218 swift 1.38 Edit <path>/etc/conf.d/hostname</path> and <path>/etc/conf.d/domainname</path>,
219     run <c>rc-update&nbsp;add&nbsp;domainname&nbsp;default</c> and edit
220 swift 1.41 <path>/etc/conf.d/net</path> to
221 swift 1.44 configure your network. Add the <c>net.eth0</c> init script to the default
222     run level. If you have multiple NICs, symlink them to the <c>net.eth0</c>
223     init script and add them to the default run level as well.
224 swift 1.38 </p>
225    
226     <p>
227     Edit <path>/etc/hosts</path>; examples are given below:
228 swift 1.1 </p>
229    
230 swift 1.38 <pre caption="Example /etc/hosts">
231     <comment>(For static IPs)</comment>
232     127.0.0.1 localhost
233     192.168.0.5 jenny.homenetwork jenny
234     192.168.0.6 benny.homenetwork benny
235     192.168.0.7 tux.homenetwork tux
236    
237     <comment>(For a dynamic IP)</comment>
238     127.0.0.1 localhost.homenetwork tux localhost
239 swift 1.1 </pre>
240    
241     <p>
242 swift 1.44 Emerge <c>pcmcia-cs</c> and add it to the default run level if you need it.
243 swift 1.1 </p>
244    
245 swift 1.38 <p>
246     Set the root password using <c>passwd</c>.
247     </p>
248 swift 1.1
249     <p>
250 swift 1.38 Set the necessary system configuration in <path>/etc/rc.conf</path>,
251     <path>/etc/conf.d/rc</path>, <path>/etc/conf.d/keymaps</path>,
252     <path>/etc/conf.d/clock</path>.
253 swift 1.1 </p>
254    
255 swift 1.38 </body>
256     </section>
257     <section>
258     <title>Installing System Tools</title>
259     <body>
260    
261     <p>
262     2.4 kernel users need to <c>emerge&nbsp;--unmerge&nbsp;udev</c> and
263     <c>emerge&nbsp;devfsd</c>.
264     </p>
265 swift 1.1
266     <p>
267 swift 1.38 Install a system logger like <c>syslog-ng</c> and add it to the default
268     run level. Do the same for a cron daemon like <c>vixie-cron</c> (optional).
269 swift 1.1 </p>
270    
271 swift 1.38 <p>
272     Install the necessary file system tools (<c>xfsprogs</c>, <c>reiserfsprogs</c>
273     or <c>jfsutils</c>) and networking tools (<c>dhcpcd</c> or <c>rp-pppoe</c>).
274     </p>
275 swift 1.1
276 swift 1.38 </body>
277     </section>
278     <section>
279     <title>Configuring the Bootloader</title>
280     <body>
281 swift 1.1
282     <p>
283 swift 1.38 Emerge <c>grub</c> or <c>lilo</c>. Edit <path>/boot/grub/grub.conf</path> or
284     <path>/etc/lilo.conf</path> to your likings. Below you will find an example for
285     each.
286 swift 1.1 </p>
287    
288 swift 1.38 <pre caption="Example grub.conf">
289 swift 1.9 default 0
290 swift 1.38 timeout 30
291 swift 1.9 splashimage=(hd0,0)/grub/splash.xpm.gz
292    
293 swift 1.38 <comment># genkernel users</comment>
294     title=Gentoo Linux 2.6.11-r3
295     root (hd0,0)
296 swift 1.42 kernel /kernel-genkernel-x86-2.6.11-gentoo-r3 root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev
297     initrd /initramfs-genkernel-x86-2.6.11-gentoo-r3
298 swift 1.38
299     <comment># non-genkernel users (no initrd)</comment>
300     title=Gentoo Linux 2.6.11 r3
301     root (hd0,0)
302     kernel /kernel-2.6.11-gentoo-r3 root=/dev/hda3
303    
304     <comment># Only in case you want to dual-boot</comment>
305     title=Windows XP
306     root (hd0,5)
307     makeactive
308     chainloader +1
309 swift 1.9 </pre>
310    
311 swift 1.38 <pre caption="Example lilo.conf">
312 swift 1.9 boot=/dev/hda
313     prompt
314 swift 1.11 timeout=50
315 swift 1.9 default=gentoo
316    
317 swift 1.38 <comment># For non-genkernel users</comment>
318     image=/boot/kernel-2.6.11-gentoo-r3
319     label=gentoo
320     read-only
321     root=/dev/hda3
322    
323     <comment># For genkernel users</comment>
324 swift 1.42 image=/boot/kernel-genkernel-x86-2.6.11-gentoo-r3
325 swift 1.9 label=gentoo
326     read-only
327     root=/dev/ram0
328 swift 1.38 append="init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev"
329 swift 1.42 initrd=/boot/initramfs-genkernel-x86-2.6.11-gentoo-r3
330 swift 1.9
331 swift 1.38 <comment># For dual-booting</comment>
332     other=/dev/hda6
333     label=windows
334 swift 1.1 </pre>
335    
336     <p>
337 swift 1.38 GRUB users need to install GRUB in the MBR using
338     <c>grub-install&nbsp;/dev/hda</c> after copying <path>/proc/mounts</path> to
339     <path>/etc/mtab</path>. LILO users need to run <c>/sbin/lilo</c>.
340 swift 1.1 </p>
341    
342 swift 1.38 <p>
343     Exit the chrooted environment, unmount all file systems and reboot.
344     </p>
345    
346     </body>
347     </section>
348     <section>
349     <title>Finalizing the Installation</title>
350     <body>
351    
352     <p>
353     Log in as <c>root</c>, then add one or more users for day-to-day use using
354     <c>useradd&nbsp;-m&nbsp;-G&nbsp;&lt;groups&gt;&nbsp;&lt;username&gt;</c>.
355     </p>
356    
357     <p>
358 swift 1.44 If you performed a network less installation, mount the packages CD at
359 swift 1.38 <path>/mnt/cdrom</path> and <c>export&nbsp;PKGDIR="/mnt/cdrom"</c> after which
360     you can <c>emerge&nbsp;-k&nbsp;&lt;package&gt;</c> to install additional
361     software like <c>kde</c>.
362     </p>
363 swift 1.1
364     <p>
365 swift 1.38 Thanks for installing Gentoo!
366 aaby 1.7 </p>
367 neysx 1.31
368 aaby 1.7 </body>
369     </section>
370     </chapter>
371 swift 1.1 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20