/[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.14
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.14 2004/06/30 22:31:37 neysx Exp $ -->
3
4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5
2<guide link="/doc/en/quickinstall.xml"> 6<guide link="/doc/en/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.11</version>
18<date>November 1, 2003</date> 22<date>June 30, 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>
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?-*.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...) # <i>links http://www.gentoo.org/main/en/mirrors.xml</i>
73( ... and extract) # <i>tar -xvjpf stage*</i> 79( ... and extract) # <i>tar -xvjpf stage*</i>
74(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>
75(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>
76(GRP-only: copy over packages) # <i>cp -a /mnt/cdrom/packages /mnt/gentoo/usr/portage/packages</i>
77(Select a mirror) # <i>mirrorselect -i -o &gt;&gt; /mnt/gentoo/etc/make.conf</i> 82(Select a mirror) # <i>mirrorselect -a -s4 -o | grep -ve '^Netselect' &gt;&gt; /mnt/gentoo/etc/make.conf</i>
78(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>
79(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>
80(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>
81(Load the necessary variables) # <i>env-update; source /etc/profile</i> 86(Load the necessary variables) # <i>env-update; source /etc/profile</i>
82(Network-only, non-GRP: update Portage) # <i>emerge sync</i> 87(Network-only, non-GRP: update Portage) # <i>emerge sync</i>
83</pre> 88</pre>
84 89
95<p> 100<p>
96Next we set up the necessary information: 101Next we set up the necessary information:
97</p> 102</p>
98 103
99<pre caption = "Setting up Configuration Files"> 104<pre caption = "Setting up Configuration Files">
100(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>
101(Edit fstab file) # <i>nano -w /etc/fstab</i> 106(Edit fstab file) # <i>nano -w /etc/fstab</i>
102</pre> 107</pre>
103 108
104<p> 109<p>
105Use 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
106<path>/etc/fstab</path>: 111<path>/etc/fstab</path>:
107</p> 112</p>
108 113
109<pre caption="/etc/fstab"> 114<pre caption="/etc/fstab">
110# &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;
111/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
112/dev/hdax / reiserfs noatime 0 1 118/dev/hdax / reiserfs noatime 0 1
113/dev/hdax none swap sw 0 0
114/dev/cdroms/cdrom0 /mnt/cdrom iso9660 noauto,ro,user 0 0 119/dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0
115none /proc proc defaults 0 0 120none /proc proc defaults 0 0
116none /dev/shm tmpfs defaults 0 0 121none /dev/shm tmpfs defaults 0 0
117/dev/hdax /mnt/dosc ntfs ro,noatime,umask=0222 0 0
118</pre> 122</pre>
119 123
120<p> 124<p>
121Continue by installing the Linux kernel: 125Continue by installing the Linux kernel:
122</p> 126</p>
123 127
124<pre caption="Installing the Kernel"> 128<pre caption="Installing the Kernel">
125(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>
126(Configure your kernel using genkernel...) # <i>emerge -k genkernel; genkernel</i> 130(Configure your kernel using genkernel...) # <i>emerge genkernel; genkernel --menuconfig all</i>
127(<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>
128( (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)
129( (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>
130( (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>
131</pre> 135</pre>
133<p> 137<p>
134Now install other tools you might want: 138Now install other tools you might want:
135</p> 139</p>
136 140
137<pre caption = "Install important system tools"> 141<pre caption = "Install important system tools">
138(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>
139(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>
140(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>
141(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>
142(genkernel users only: install hotplug) # <i>emerge -k hotplug</i> 146(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> 147(genkernel users only: have hotplug automatically started at boot) # <i>rc-update add hotplug default</i>
144(Non-ext2,ext3 users only; choice: reiserfsprogs, xfsprogs, jfsutils) # <i>emerge -k reiserfsprogs</i> 148(Non-ext2,ext3 users only; choice: reiserfsprogs, xfsprogs, jfsutils) # <i>emerge reiserfsprogs</i>
149(Domain name init script) # <i>rc-update add domainname default</i>
145</pre> 150</pre>
146 151
147<p> 152<p>
148If you need specialised kernel ebuilds, now is a good time to install them: 153If you need specialised kernel ebuilds, now is a good time to install them:
149</p> 154</p>
150 155
151<pre caption = "Install Specialised Kernel Ebuilds"> 156<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>) 157# <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) 158# <i>VIDEO_CARDS="yourcard" emerge xfree-drm</i> (for ATI Radeon up to 9200, Rage128, Matrox, Voodoo and other cards)
154</pre> 159</pre>
155 160
156<p> 161<p>
157Finalise the settings for your Gentoo system: 162Finalise the settings for your Gentoo system:
161(Set root password) # <i>passwd</i> 166(Set root password) # <i>passwd</i>
162(Create a user) # <i>useradd your_user -m -G users,wheel,audio -s /bin/bash</i> 167(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> 168(Set password for that user) # <i>passwd your_user</i>
164(Set the system hostname) # <i>echo mymachine &gt; /etc/hostname</i> 169(Set the system hostname) # <i>echo mymachine &gt; /etc/hostname</i>
165(Set the system domainname) # <i>echo mydomain.com &gt; /etc/dnsdomainname</i> 170(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> 171(Set the hostsfile, ex:"127.0.0.1 localhost mymachine") # <i>nano -w /etc/hosts</i>
172(Configure basic system settings; follow comments) # <i>nano -w /etc/rc.conf</i>
167</pre> 173</pre>
168 174
169<pre caption = "Set up Networking"> 175<pre caption = "Set up Networking">
170(Setup networking; dhcp-users should set iface_eth0="dhcp") # <i>nano -w /etc/conf.d/net</i> 176(Setup networking; dhcp-users should set iface_eth0="dhcp") # <i>nano -w /etc/conf.d/net</i>
171(List modules to be loaded at startup) # <i>nano -w /etc/modules.autoload.d/kernel-2.4</i> 177(List modules to be loaded at startup) # <i>nano -w /etc/modules.autoload.d/kernel-<comment>&lt;version&gt;</comment></i>
172(Configure basic system settings; follow comments) # <i>nano -w /etc/rc.conf</i>
173(Non-PCMCIA only: start networking automatically at boot) # <i>rc-update add net.eth0 default</i> 178(Non-PCMCIA only: start networking automatically at boot) # <i>rc-update add net.eth0 default</i>
174(Only if you have multiple network interfaces:) 179(Only if you have multiple network interfaces:)
175 (1) Create initscripts for each interface) # <i>ln -s /etc/init.d/net.eth0 /etc/init.d/net.ethx</i> 180 (1) Create initscripts for each interface) # <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> 181 (2) Automatically start at boot if no PCMCIA) # <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> 182(PCMCIA only: verify /etc/conf.d/pcmcia and load PCMCIA at boot) # <i>rc-update add pcmcia boot</i>
178</pre> 183</pre>
179 184
180<p> 185<p>
181Now install a bootloader. Left is for grub, right for lilo: 186Now install a bootloader.
182</p> 187</p>
183 188
184<pre caption = "Install and Configure a bootloader"> 189<pre caption="Install and configure GRUB">
185# <i>emerge -k grub</i> | # <i>emerge -k lilo</i> 190# <i>emerge grub</i>
186# <i>grub</i> | # <i>nano -w /etc/lilo.conf</i> 191# <i>grub</i>
187grub&gt; <i>root (hd0,0)</i> (Boot partition) | boot=/dev/hda 192grub&gt; <i>root (hd0,0)</i>
188grub&gt; <i>setup (hd0)</i> (Install on MBR) | prompt 193grub&gt; <i>setup (hd0)</i>
189grub&gt; <i>quit</i> | timeout=50 194grub&gt; <i>quit</i>
190# <i>nano -w /boot/grub/grub.conf</i> | default=gentoo 195# <i>nano -w /boot/grub/grub.conf</i>
191 default 0 | 196default 0
192 timeout 15 | <comment># Genkernel only:</comment> 197timeout 15
193 splashimage=(hd0,0)/grub/splash.xpm.gz | image=/boot/kernel-<comment>&lt;kernel version&gt;</comment> 198splashimage=(hd0,0)/grub/splash.xpm.gz
194 | root=/dev/hda3 199
195 title=Gentoo Linux | label=gentoo 200title=Gentoo Linux
196 root (hd0,0) | 201 root (hd0,0)
197 <comment># Genkernel only:</comment> | <comment># Non-genkernel only:</comment> 202 <comment># genkernel users:</comment>
203 kernel /kernel-<comment>&lt;kernel version&gt;</comment> root=/dev/ram0 init=/linuxrc real_root=/dev/hda3
204 initrd /initrd-<comment>&lt;kernel version&gt;</comment>
205 <comment># non-genkernel users:</comment>
198 kernel (hd0,0)/kernel-<comment>&lt;kernel version&gt;</comment> root=/dev/hda3 | image=/boot/bzImage 206 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 207</pre>
200 <comment># Non-genkernel only:</comment> | label=gentoo 208
201 kernel (hd0,0)/bzImage | 209<pre caption="Install and configure LILO">
202 | <comment># For dualbooting:</comment> 210# <i>emerge lilo</i>
203 <comment># For dualbooting:</comment> | other=/dev/hda<comment>X</comment> 211# <i>nano -w /etc/lilo.conf</i>
204 title=Windows XP | label=windows 212boot=/dev/hda
205 root (hd0,5) | 213prompt
206 chainloader (hd0,5)+1 | # <i>/sbin/lilo</i> 214timeout=50
215default=gentoo
216
217image=/boot/kernel-<comment>&lt;kernel version&gt;</comment>
218 label=gentoo
219 read-only
220 <comment># genkernel users:</comment>
221 append="init=/linuxrc real_root=/dev/hda3"
222 root=/dev/ram0
223 initrd=/boot/initrd-<comment>&lt;kernel version&gt;</comment>
224 <comment># non-genkernel users:</comment>
225 root=/dev/hda3
226
227# <i>/sbin/lilo</i>
207</pre> 228</pre>
208 229
209<p> 230<p>
210Now unmount all partitions and reboot into your new system: 231Now unmount all partitions and reboot into your new system:
211</p> 232</p>
212 233
213<pre caption="Finishing off and installing GUI"> 234<pre caption="Finishing off and installing GUI">
214(Updating configuration files) # <i>etc-update</i>
215(Exiting the chroot) # <i>exit; cd /</i> 235(Exiting the chroot) # <i>exit; cd /</i>
216(Unmounting partitions) # <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i> 236(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> 237(Reboot; Remove the universal CD from the tray) # <i>reboot</i>
218(After booting:) 238(After booting:)
219(ADSL-users only) # <i>adsl-setup</i> 239(ADSL-users only) # <i>adsl-setup</i>
220(GRP-users only, optional CD2 usage) 240(GRP-users only)
221( (1) Mount CD2) # <i>mount /dev/cdrom /mnt/cdrom</i> 241 (1) Mount Package CD # <i>mount /dev/cdrom /mnt/cdrom</i>
222( (2) Copy over packages) # <i>cp -a /mnt/cdrom/packages/* /usr/portage/packages/</i> 242 (2) Copy over packages # <i>mkdir /usr/portage/packages</i>
243 # <i>cp -a /mnt/cdrom/* /usr/portage/packages/</i>
223( (3) Install extra software) # <i>emerge -k xfree gnome kde mozilla openoffice-bin</i> 244 (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> 245 (4) Configure your Xserver # <i>/usr/X11R6/bin/xf86config</i>
225</pre> 246</pre>
226 247
227<p>
228You can get more information from the <uri link="http://www.gentoo.org/doc/en/index.xml">Gentoo Documentation</uri>.
229</p> 248<p>
249You can get more information from the <uri
250link="http://www.gentoo.org/doc/en/index.xml">Gentoo
251Documentation</uri>.
252</p>
253</body>
254</section>
230</body></chapter> 255</chapter>
231
232</guide> 256</guide>
233 257

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

  ViewVC Help
Powered by ViewVC 1.1.20