/[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.5 Revision 1.9
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.5 2003/11/15 00:35:19 neysx Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.9 2004/03/06 17:23:24 swift Exp $ -->
3
4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5
3<guide link="/doc/en/quickinstall.xml"> 6<guide link="/doc/en/quickinstall.xml">
4<title>Gentoo Linux Install Reference</title> 7<title>Gentoo Linux Install Reference</title>
5<author title="Author">Steven Wagner</author> 8<author title="Author">Steven Wagner</author>
6<author title="Editor"> 9<author title="Editor">
7 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 10 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
8</author> 11</author>
9 12
10<abstract> 13<abstract>
11The Quick install reference covers all details of the install process in a 14The Quick install reference covers all details of the install process in a
12non-verbose manner. Users should already have prior experience with 15non-verbose manner. Users should already have prior experience with
13installing gentoo linux if they want to follow this guide. 16installing Gentoo Linux if they want to follow this guide.
14</abstract> 17</abstract>
15 18
16<license/> 19<license/>
17 20
18<version>1.1</version> 21<version>1.5</version>
19<date>November 1, 2003</date> 22<date>March 4th, 2004</date>
20 23
21<chapter> 24<chapter>
22<title>Quick Install Reference</title> 25<title>Quick Install Reference</title>
26<section>
23<body> 27<body>
24 28
25<p> 29<p>
26The installation ISOs are on the <uri link= 30The installation ISOs are on the <uri link=
27"http://www.gentoo.org/main/en/mirrors.xml">Gentoo Mirrors</uri>. Detailed 31"http://www.gentoo.org/main/en/mirrors.xml">Gentoo
28descriptions of the different CDs are available in the <uri 32Mirrors</uri>. Detailed descriptions of the different CDs are
29link="http://store.gentoo.org">Gentoo Store</uri>. CD 1 contains 33available in the <uri link="http://store.gentoo.org">Gentoo
30everything you need to install Gentoo Linux quickly and without a 34Store</uri>. CD 1 contains everything you need to install Gentoo Linux
31connection to the Internet. CD2 is optional and contains pre-compiled packages 35quickly and without a connection to the Internet. CD 2 is optional and
32such as KDE, GNOME, OpenOffice, Mozilla, Evolution and more. 36contains pre-compiled packages such as KDE, GNOME, OpenOffice,
37Mozilla, Evolution and more.
33</p> 38</p>
34 39
35<p> 40<p>
36Boot from the first Gentoo CD. Press &lt;F1&gt; and/or &lt;F2&gt; to 41Boot from the first Gentoo CD. Press &lt;F1&gt; and/or &lt;F2&gt; to
37see what boot options are available. Press &lt;ENTER&gt; at the bootscreen to 42see what boot options are available. Press &lt;ENTER&gt; at the bootscreen to
… …
44# <i>net-setup eth0</i> (Configure the network) 49# <i>net-setup eth0</i> (Configure the network)
45# <i>fdisk /dev/hda</i> (Partition your drive) 50# <i>fdisk /dev/hda</i> (Partition your drive)
46</pre> 51</pre>
47 52
48<p> 53<p>
49The recommended setup is a 64 meg boot volume with ext3, a swap partition 54The recommended setup is a 64 meg boot volume with ext2, a swap partition
50twice the size of your available RAM, and the rest for your root partition 55twice the size of your available RAM, and the rest for your root partition
51using ReiserFS. 56using ReiserFS.
52</p> 57</p>
53 58
54<p> 59<p>
… …
68(Mount the root partition) # <i>mount /dev/hdax /mnt/gentoo</i> 73(Mount the root partition) # <i>mount /dev/hdax /mnt/gentoo</i>
69(Create the boot mountpoint) # <i>mkdir /mnt/gentoo/boot</i> 74(Create the boot mountpoint) # <i>mkdir /mnt/gentoo/boot</i>
70(Mount the boot partition) # <i>mount /dev/hdax /mnt/gentoo/boot</i> 75(Mount the boot partition) # <i>mount /dev/hdax /mnt/gentoo/boot</i>
71(Go to the mountpoint) # <i>cd /mnt/gentoo</i> 76(Go to the mountpoint) # <i>cd /mnt/gentoo</i>
72(Extract a stage tarball...) # <i>tar -xvjpf /mnt/cdrom/stages/stage?-*.tar.bz2</i> 77(Extract a stage tarball...) # <i>tar -xvjpf /mnt/cdrom/stages/stage?-*.tar.bz2</i>
73(<comment>or</comment> download the latest tarball...) # <i>links http://gentoo.oregonstate.edu/releases/x86/1.4/</i> 78(<comment>or</comment> download the latest tarball...) # <i>lynx http://www.gentoo.org/main/en/mirrors.xml</i>
74( ... and extract) # <i>tar -xvjpf stage*</i> 79( ... and extract) # <i>tar -xvjpf stage*</i>
75(GRP-only: unpack a portage tree) # <i>tar -xvjf /mnt/cdrom/snapshots/portage-*.tar.bz2 -C /mnt/gentoo/usr</i> 80(Optional: unpack a portage tree) # <i>tar -xvjf /mnt/cdrom/snapshots/portage-*.tar.bz2 -C /mnt/gentoo/usr</i>
76(GRP-only: copy over distfiles) # <i>cp -R /mnt/cdrom/distfiles /mnt/gentoo/usr/portage/distfiles</i> 81(Optional: copy over distfiles) # <i>cp -R /mnt/cdrom/distfiles /mnt/gentoo/usr/portage/distfiles</i>
77(GRP-only: copy over packages) # <i>cp -a /mnt/cdrom/packages /mnt/gentoo/usr/portage/packages</i>
78(Select a mirror) # <i>mirrorselect -i -o &gt;&gt; /mnt/gentoo/etc/make.conf</i> 82(Select a mirror) # <i>mirrorselect -a -s4 -o &gt;&gt; /mnt/gentoo/etc/make.conf</i>
79(Copy over nameserver information) # <i>cp /etc/resolv.conf /mnt/gentoo/etc/resolv.conf</i> 83(Copy over nameserver information) # <i>cp /etc/resolv.conf /mnt/gentoo/etc/resolv.conf</i>
80(Mount the proc filesystem) # <i>mount -t proc proc /mnt/gentoo/proc</i> 84(Mount the proc filesystem) # <i>mount -t proc none /mnt/gentoo/proc</i>
81(Chroot into the new environment) # <i>chroot /mnt/gentoo /bin/bash</i> 85(Chroot into the new environment) # <i>chroot /mnt/gentoo /bin/bash</i>
82(Load the necessary variables) # <i>env-update; source /etc/profile</i> 86(Load the necessary variables) # <i>env-update; source /etc/profile</i>
83(Network-only, non-GRP: update Portage) # <i>emerge sync</i> 87(Network-only, non-GRP: update Portage) # <i>emerge sync</i>
84</pre> 88</pre>
85 89
… …
96<p> 100<p>
97Next we set up the necessary information: 101Next we set up the necessary information:
98</p> 102</p>
99 103
100<pre caption = "Setting up Configuration Files"> 104<pre caption = "Setting up Configuration Files">
101(Set timezone information) # <i>ln -sf /usr/share/zoneinfo/path/to/timezonefile /etc/localtime</i> 105(Set timezone information) # <i>ln -sf /usr/share/zoneinfo/<comment>&lt;path to time zone file&gt;</comment> /etc/localtime</i>
102(Edit fstab file) # <i>nano -w /etc/fstab</i> 106(Edit fstab file) # <i>nano -w /etc/fstab</i>
103</pre> 107</pre>
104 108
105<p> 109<p>
106Use the following as a <e>template</e> (don't copy verbatim) for 110Use the following as a <e>template</e> (don't copy verbatim) for
107<path>/etc/fstab</path>: 111<path>/etc/fstab</path>:
108</p> 112</p>
109 113
110<pre caption="/etc/fstab"> 114<pre caption="/etc/fstab">
111# &lt;fs&gt; &lt;mountpoint&gt; &lt;type&gt; &lt;opts&gt; &lt;dump/pass&gt; 115# &lt;fs&gt; &lt;mountpoint&gt; &lt;type&gt; &lt;opts&gt; &lt;dump/pass&gt;
112/dev/hdax /boot ext3 noauto,noatime 1 2 116/dev/hdax /boot ext2 noauto,noatime 1 2
117/dev/hdax none swap sw 0 0
113/dev/hdax / reiserfs noatime 0 1 118/dev/hdax / reiserfs noatime 0 1
114/dev/hdax none swap sw 0 0
115/dev/cdroms/cdrom0 /mnt/cdrom iso9660 noauto,ro,user 0 0 119/dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0
116none /proc proc defaults 0 0 120none /proc proc defaults 0 0
117none /dev/shm tmpfs defaults 0 0 121none /dev/shm tmpfs defaults 0 0
118/dev/hdax /mnt/dosc ntfs ro,noatime,umask=0222 0 0
119</pre> 122</pre>
120 123
121<p> 124<p>
122Continue by installing the Linux kernel: 125Continue by installing the Linux kernel:
123</p> 126</p>
124 127
125<pre caption="Installing the Kernel"> 128<pre caption="Installing the Kernel">
126(Install the kernel sources) # <i>emerge -k sys-kernel/gentoo-sources</i> 129(Install the kernel sources) # <i>emerge <comment>&lt;kernel-package-here&gt;</comment></i>
127(Configure your kernel using genkernel...) # <i>emerge -k genkernel; genkernel</i> 130(Configure your kernel using genkernel...) # <i>emerge genkernel; genkernel --menuconfig all</i>
128(<comment>or</comment> (1) manually build your kernel) # <i>cd /usr/src/linux; make menuconfig;</i> 131(<comment>or</comment> (1) manually build your kernel) # <i>cd /usr/src/linux; make menuconfig;</i>
129( (2) Include VM fs, /proc fs, /dev fs, /dev fs auto mount at boot) 132( (2) Include VM fs, /proc fs, /dev fs, /dev fs auto mount at boot)
130( (3) Compile your kernel) # <i>make dep &amp;&amp; make clean bzImage modules modules_install</i> 133( (3) Compile your kernel) # <i>make dep &amp;&amp; make clean bzImage modules modules_install</i>
131( (4) Copy over the kernel) # <i>cp arch/i386/boot/bzImage /boot; cp System.map /boot</i> 134( (4) Copy over the kernel) # <i>cp arch/i386/boot/bzImage /boot; cp System.map /boot</i>
132</pre> 135</pre>
… …
134<p> 137<p>
135Now install other tools you might want: 138Now install other tools you might want:
136</p> 139</p>
137 140
138<pre caption = "Install important system tools"> 141<pre caption = "Install important system tools">
139(Install system logger; choice: sysklogd, metalog, msyslog, syslog-ng) # <i>emerge -k app-admin/syslog-ng </i> 142(Install system logger; choice: sysklogd, metalog, msyslog, syslog-ng) # <i>emerge syslog-ng </i>
140(Have the systemlogger automatically started at boot) # <i>rc-update add syslog-ng default</i> 143(Have the systemlogger automatically started at boot) # <i>rc-update add syslog-ng default</i>
141(Install cron daemon; choice: vcron, dcron, fcron) # <i>emerge -k sys-apps/vcron</i> 144(Install cron daemon; choice: vixie-cron, dcron, fcron) # <i>emerge vixie-cron</i>
142(Have the cron daemon automatically started at boot) # <i>rc-update add vcron default</i> 145(Have the cron daemon automatically started at boot) # <i>rc-update add vixie-cron default</i>
143(genkernel users only: install hotplug) # <i>emerge -k hotplug</i> 146(genkernel users only: install hotplug) # <i>emerge hotplug</i>
144(genkernel users only: have hotplug automatically started at boot) # <i>rc-update add hotplug default</i> 147(genkernel users only: have hotplug automatically started at boot) # <i>rc-update add hotplug default</i>
148(ALSA users only: install alsa-utils) # <i>emerge alsa-utils</i>
149(ALSA users only: have alsa-utils automatically started at boot ) # <i>rc-update add alsasound default</i>
145(Non-ext2,ext3 users only; choice: reiserfsprogs, xfsprogs, jfsutils) # <i>emerge -k reiserfsprogs</i> 150(Non-ext2,ext3 users only; choice: reiserfsprogs, xfsprogs, jfsutils) # <i>emerge reiserfsprogs</i>
151(Domain name init script) # <i>rc-update add domainname default</i>
146</pre> 152</pre>
147 153
148<p> 154<p>
149If you need specialised kernel ebuilds, now is a good time to install them: 155If you need specialised kernel ebuilds, now is a good time to install them:
150</p> 156</p>
151 157
152<pre caption = "Install Specialised Kernel Ebuilds"> 158<pre caption = "Install Specialised Kernel Ebuilds">
153# <i>emerge -k pcmcia-cs</i> (or <i>emu10k1</i>, <i>nforce-net</i>, <i>nforce-audio</i>, <i>e100</i>, <i>e1000</i>, <i>ati-drivers</i>, <i>rp-pppoe</i>) 159# <i>emerge pcmcia-cs</i> (or <i>nforce-net</i>, <i>nforce-audio</i>, <i>e100</i>, <i>e1000</i>, <i>ati-drivers</i>, <i>rp-pppoe</i>)
154# <i>VIDEO_CARDS="yourcard" emerge xfree-drm</i> (for ATI Radeon up to 9200, Rage128, Matrox, Voodoo and other cards) 160# <i>VIDEO_CARDS="yourcard" emerge xfree-drm</i> (for ATI Radeon up to 9200, Rage128, Matrox, Voodoo and other cards)
155</pre> 161</pre>
156 162
157<p> 163<p>
158Finalise the settings for your Gentoo system: 164Finalise the settings for your Gentoo system:
… …
162(Set root password) # <i>passwd</i> 168(Set root password) # <i>passwd</i>
163(Create a user) # <i>useradd your_user -m -G users,wheel,audio -s /bin/bash</i> 169(Create a user) # <i>useradd your_user -m -G users,wheel,audio -s /bin/bash</i>
164(Set password for that user) # <i>passwd your_user</i> 170(Set password for that user) # <i>passwd your_user</i>
165(Set the system hostname) # <i>echo mymachine &gt; /etc/hostname</i> 171(Set the system hostname) # <i>echo mymachine &gt; /etc/hostname</i>
166(Set the system domainname) # <i>echo mydomain.com &gt; /etc/dnsdomainname</i> 172(Set the system domainname) # <i>echo mydomain.com &gt; /etc/dnsdomainname</i>
167(Set the hostsfile, at least set "127.0.0.1 mymachine") # <i>nano -w /etc/hosts</i> 173(Set the hostsfile, ex:"127.0.0.1 localhost mymachine") # <i>nano -w /etc/hosts</i>
174(Configure basic system settings; follow comments) # <i>nano -w /etc/rc.conf</i>
168</pre> 175</pre>
169 176
170<pre caption = "Set up Networking"> 177<pre caption = "Set up Networking">
171(Setup networking; dhcp-users should set iface_eth0="dhcp") # <i>nano -w /etc/conf.d/net</i> 178(Setup networking; dhcp-users should set iface_eth0="dhcp") # <i>nano -w /etc/conf.d/net</i>
172(List modules to be loaded at startup) # <i>nano -w /etc/modules.autoload.d/kernel-2.4</i> 179(List modules to be loaded at startup) # <i>nano -w /etc/modules.autoload.d/kernel-<comment>&lt;version&gt;</comment></i>
173(Configure basic system settings; follow comments) # <i>nano -w /etc/rc.conf</i>
174(Non-PCMCIA only: start networking automatically at boot) # <i>rc-update add net.eth0 default</i> 180(Non-PCMCIA only: start networking automatically at boot) # <i>rc-update add net.eth0 default</i>
175(Only if you have multiple network interfaces:) 181(Only if you have multiple network interfaces:)
176 (1) Create initscripts for each interface) # <i>ln -s /etc/init.d/net.eth0 /etc/init.d/net.ethx</i> 182 (1) Create initscripts for each interface) # <i>ln -s /etc/init.d/net.eth0 /etc/init.d/net.ethx</i>
177 (2) Automatically start at boot if no PCMCIA) # <i>rc-update add net.ethx default</i> 183 (2) Automatically start at boot if no PCMCIA) # <i>rc-update add net.ethx default</i>
178(PCMCIA only: verify /etc/conf.d/pcmcia and load PCMCIA at boot) # <i>rc-update add pcmcia boot</i> 184(PCMCIA only: verify /etc/conf.d/pcmcia and load PCMCIA at boot) # <i>rc-update add pcmcia boot</i>
179</pre> 185</pre>
180 186
181<p> 187<p>
182Now install a bootloader. Left is for grub, right for lilo: 188Now install a bootloader.
183</p> 189</p>
184 190
185<pre caption = "Install and Configure a bootloader"> 191<pre caption="Install and configure GRUB">
186# <i>emerge -k grub</i> | # <i>emerge -k lilo</i> 192# <i>emerge grub</i>
187# <i>grub</i> | # <i>nano -w /etc/lilo.conf</i> 193# <i>grub</i>
188grub&gt; <i>root (hd0,0)</i> (Boot partition) | boot=/dev/hda 194grub&gt; <i>root (hd0,0)</i>
189grub&gt; <i>setup (hd0)</i> (Install on MBR) | prompt 195grub&gt; <i>setup (hd0)</i>
190grub&gt; <i>quit</i> | timeout=50 196grub&gt; <i>quit</i>
191# <i>nano -w /boot/grub/grub.conf</i> | default=gentoo 197# <i>nano -w /boot/grub/grub.conf</i>
192 default 0 | 198default 0
193 timeout 15 | <comment># Genkernel only:</comment> 199timeout 15
194 splashimage=(hd0,0)/grub/splash.xpm.gz | image=/boot/kernel-<comment>&lt;kernel version&gt;</comment> 200splashimage=(hd0,0)/grub/splash.xpm.gz
195 | root=/dev/hda3 201
196 title=Gentoo Linux | label=gentoo 202title=Gentoo Linux
197 root (hd0,0) | 203 root (hd0,0)
198 <comment># Genkernel only:</comment> | <comment># Non-genkernel only:</comment> 204 <comment># genkernel users:</comment>
205 kernel /kernel-<comment>&lt;kernel version&gt;</comment> root=/dev/ram0 init=/linuxrc real_root=/dev/hda3
206 initrd /initrd-<comment>&lt;kernel version&gt;</comment>
207 <comment># non-genkernel users:</comment>
199 kernel (hd0,0)/kernel-<comment>&lt;kernel version&gt;</comment> root=/dev/hda3 | image=/boot/bzImage 208 kernel /kernel-<comment>&lt;kernel version&gt;</comment> root=/dev/hda3
200 initrd (hd0,0)/initrd-<comment>&lt;kernel version&gt;</comment> | root=/dev/hda3 209</pre>
201 <comment># Non-genkernel only:</comment> | label=gentoo 210
202 kernel (hd0,0)/bzImage | 211<pre caption="Install and configure LILO">
203 | <comment># For dualbooting:</comment> 212# <i>emerge lilo</i>
204 <comment># For dualbooting:</comment> | other=/dev/hda<comment>X</comment> 213# <i>nano -w /etc/lilo.conf</i>
205 title=Windows XP | label=windows 214boot=/dev/hda
206 root (hd0,5) | 215prompt
207 chainloader (hd0,5)+1 | # <i>/sbin/lilo</i> 216delay=50
217default=gentoo
218
219image=/boot/kernel-<comment>&lt;kernel version&gt;</comment>
220 label=gentoo
221 read-only
222 <comment># genkernel users:</comment>
223 append="init=/linuxrc real_root=/dev/hda3"
224 root=/dev/ram0
225 initrd=/boot/initrd-<comment>&lt;kernel version&gt;</comment>
226 <comment># non-genkernel users:</comment>
227 root=/dev/hda3
228
229# <i>/sbin/lilo</i>
208</pre> 230</pre>
209 231
210<p> 232<p>
211Now unmount all partitions and reboot into your new system: 233Now unmount all partitions and reboot into your new system:
212</p> 234</p>
213 235
214<pre caption="Finishing off and installing GUI"> 236<pre caption="Finishing off and installing GUI">
215(Updating configuration files) # <i>etc-update</i>
216(Exiting the chroot) # <i>exit; cd /</i> 237(Exiting the chroot) # <i>exit; cd /</i>
217(Unmounting partitions) # <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i> 238(Unmounting partitions) # <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i>
218(Reboot; Remove the install CD from the tray) # <i>reboot</i> 239(Reboot; Remove the install CD from the tray) # <i>reboot</i>
219(After booting:) 240(After booting:)
220(ADSL-users only) # <i>adsl-setup</i> 241(ADSL-users only) # <i>adsl-setup</i>
221(GRP-users only, optional CD2 usage) 242(GRP-users only)
222( (1) Mount CD2) # <i>mount /dev/cdrom /mnt/cdrom</i> 243( (1) Mount CD2) # <i>mount /dev/cdrom /mnt/cdrom</i>
223( (2) Copy over packages) # <i>cp -a /mnt/cdrom/packages/* /usr/portage/packages/</i> 244( (2) Copy over packages) # <i>cp -a /mnt/cdrom/packages/* /usr/portage/packages/</i>
224( (3) Install extra software) # <i>emerge -k xfree gnome kde mozilla openoffice-bin</i> 245( (3) Install extra software) # <i>USE="bindist" emerge -k xfree gnome kde mozilla openoffice-bin</i>
225( (4) Configure your Xserver) # <i>/usr/X11R6/bin/xf86config</i> 246( (4) Configure your Xserver) # <i>/usr/X11R6/bin/xf86config</i>
226</pre> 247</pre>
227 248
228<p> 249<p>
229You can get more information from the <uri link="http://www.gentoo.org/doc/en/index.xml">Gentoo Documentation</uri>. 250You can get more information from the <uri
251link="http://www.gentoo.org/doc/en/index.xml">Gentoo
252Documentation</uri>.
230</p> 253</p>
254</body>
255</section>
231</body></chapter> 256</chapter>
232
233</guide> 257</guide>
234 258
Legend:
Removed from v.1.5  
changed lines
  Added in v.1.9
  ViewVC Help
Powered by ViewVC 1.1.20