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

Legend:
Removed from v.1.4  
changed lines
  Added in v.1.21

  ViewVC Help
Powered by ViewVC 1.1.20