/[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.7 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.7 2003/12/21 12:06:22 aaby 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>
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.2</version> 21<version>1.5</version>
19<date>December 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>
23<section> 26<section>
24<body> 27<body>
70(Mount the root partition) # <i>mount /dev/hdax /mnt/gentoo</i> 73(Mount the root partition) # <i>mount /dev/hdax /mnt/gentoo</i>
71(Create the boot mountpoint) # <i>mkdir /mnt/gentoo/boot</i> 74(Create the boot mountpoint) # <i>mkdir /mnt/gentoo/boot</i>
72(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>
73(Go to the mountpoint) # <i>cd /mnt/gentoo</i> 76(Go to the mountpoint) # <i>cd /mnt/gentoo</i>
74(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>
75(<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>
76( ... and extract) # <i>tar -xvjpf stage*</i> 79( ... and extract) # <i>tar -xvjpf stage*</i>
77(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>
78(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>
79(GRP-only: copy over packages) # <i>cp -a /mnt/cdrom/packages /mnt/gentoo/usr/portage/packages</i>
80(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>
81(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>
82(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>
83(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>
84(Load the necessary variables) # <i>env-update; source /etc/profile</i> 86(Load the necessary variables) # <i>env-update; source /etc/profile</i>
85(Network-only, non-GRP: update Portage) # <i>emerge sync</i> 87(Network-only, non-GRP: update Portage) # <i>emerge sync</i>
86</pre> 88</pre>
87 89
98<p> 100<p>
99Next we set up the necessary information: 101Next we set up the necessary information:
100</p> 102</p>
101 103
102<pre caption = "Setting up Configuration Files"> 104<pre caption = "Setting up Configuration Files">
103(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>
104(Edit fstab file) # <i>nano -w /etc/fstab</i> 106(Edit fstab file) # <i>nano -w /etc/fstab</i>
105</pre> 107</pre>
106 108
107<p> 109<p>
108Use 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
109<path>/etc/fstab</path>: 111<path>/etc/fstab</path>:
110</p> 112</p>
111 113
112<pre caption="/etc/fstab"> 114<pre caption="/etc/fstab">
113# &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;
114/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
115/dev/hdax / reiserfs noatime 0 1 118/dev/hdax / reiserfs noatime 0 1
116/dev/hdax none swap sw 0 0
117/dev/cdroms/cdrom0 /mnt/cdrom iso9660 noauto,ro,user 0 0 119/dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0
118none /proc proc defaults 0 0 120none /proc proc defaults 0 0
119none /dev/shm tmpfs defaults 0 0 121none /dev/shm tmpfs defaults 0 0
120/dev/hdax /mnt/dosc ntfs ro,noatime,umask=0222 0 0
121</pre> 122</pre>
122 123
123<p> 124<p>
124Continue by installing the Linux kernel: 125Continue by installing the Linux kernel:
125</p> 126</p>
126 127
127<pre caption="Installing the Kernel"> 128<pre caption="Installing the Kernel">
128(Install the kernel sources) # <i>emerge -k gentoo-sources</i> 129(Install the kernel sources) # <i>emerge <comment>&lt;kernel-package-here&gt;</comment></i>
129(Configure your kernel using genkernel...) # <i>emerge -k genkernel; genkernel</i> 130(Configure your kernel using genkernel...) # <i>emerge genkernel; genkernel --menuconfig all</i>
130(<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>
131( (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)
132( (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>
133( (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>
134</pre> 135</pre>
136<p> 137<p>
137Now install other tools you might want: 138Now install other tools you might want:
138</p> 139</p>
139 140
140<pre caption = "Install important system tools"> 141<pre caption = "Install important system tools">
141(Install system logger; choice: sysklogd, metalog, msyslog, syslog-ng) # <i>emerge -k syslog-ng </i> 142(Install system logger; choice: sysklogd, metalog, msyslog, syslog-ng) # <i>emerge syslog-ng </i>
142(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>
143(Install cron daemon; choice: vcron, dcron, fcron) # <i>emerge -k vcron</i> 144(Install cron daemon; choice: vixie-cron, dcron, fcron) # <i>emerge vixie-cron</i>
144(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>
145(genkernel users only: install hotplug) # <i>emerge -k hotplug</i> 146(genkernel users only: install hotplug) # <i>emerge hotplug</i>
146(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>
147(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>
148</pre> 152</pre>
149 153
150<p> 154<p>
151If 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:
152</p> 156</p>
153 157
154<pre caption = "Install Specialised Kernel Ebuilds"> 158<pre caption = "Install Specialised Kernel Ebuilds">
155# <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>)
156# <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)
157</pre> 161</pre>
158 162
159<p> 163<p>
160Finalise the settings for your Gentoo system: 164Finalise the settings for your Gentoo system:
164(Set root password) # <i>passwd</i> 168(Set root password) # <i>passwd</i>
165(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>
166(Set password for that user) # <i>passwd your_user</i> 170(Set password for that user) # <i>passwd your_user</i>
167(Set the system hostname) # <i>echo mymachine &gt; /etc/hostname</i> 171(Set the system hostname) # <i>echo mymachine &gt; /etc/hostname</i>
168(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>
169(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>
170</pre> 175</pre>
171 176
172<pre caption = "Set up Networking"> 177<pre caption = "Set up Networking">
173(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>
174(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>
175(Configure basic system settings; follow comments) # <i>nano -w /etc/rc.conf</i>
176(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>
177(Only if you have multiple network interfaces:) 181(Only if you have multiple network interfaces:)
178 (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>
179 (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>
180(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>
181</pre> 185</pre>
182 186
183<p> 187<p>
184Now install a bootloader. Left is for grub, right for lilo: 188Now install a bootloader.
185</p> 189</p>
186 190
187<pre caption = "Install and Configure a bootloader"> 191<pre caption="Install and configure GRUB">
188# <i>emerge -k grub</i> | # <i>emerge -k lilo</i> 192# <i>emerge grub</i>
189# <i>grub</i> | # <i>nano -w /etc/lilo.conf</i> 193# <i>grub</i>
190grub&gt; <i>root (hd0,0)</i> (Boot partition) | boot=/dev/hda 194grub&gt; <i>root (hd0,0)</i>
191grub&gt; <i>setup (hd0)</i> (Install on MBR) | prompt 195grub&gt; <i>setup (hd0)</i>
192grub&gt; <i>quit</i> | timeout=50 196grub&gt; <i>quit</i>
193# <i>nano -w /boot/grub/grub.conf</i> | default=gentoo 197# <i>nano -w /boot/grub/grub.conf</i>
194 default 0 | 198default 0
195 timeout 15 | <comment># Genkernel only:</comment> 199timeout 15
196 splashimage=(hd0,0)/grub/splash.xpm.gz | image=/boot/kernel-<comment>&lt;kernel version&gt;</comment> 200splashimage=(hd0,0)/grub/splash.xpm.gz
197 | root=/dev/hda3 201
198 title=Gentoo Linux | label=gentoo 202title=Gentoo Linux
199 root (hd0,0) | 203 root (hd0,0)
200 <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>
201 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
202 initrd (hd0,0)/initrd-<comment>&lt;kernel version&gt;</comment> | root=/dev/hda3 209</pre>
203 <comment># Non-genkernel only:</comment> | label=gentoo 210
204 kernel (hd0,0)/bzImage | 211<pre caption="Install and configure LILO">
205 | <comment># For dualbooting:</comment> 212# <i>emerge lilo</i>
206 <comment># For dualbooting:</comment> | other=/dev/hda<comment>X</comment> 213# <i>nano -w /etc/lilo.conf</i>
207 title=Windows XP | label=windows 214boot=/dev/hda
208 root (hd0,5) | 215prompt
209 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>
210</pre> 230</pre>
211 231
212<p> 232<p>
213Now unmount all partitions and reboot into your new system: 233Now unmount all partitions and reboot into your new system:
214</p> 234</p>
215 235
216<pre caption="Finishing off and installing GUI"> 236<pre caption="Finishing off and installing GUI">
217(Updating configuration files) # <i>etc-update</i>
218(Exiting the chroot) # <i>exit; cd /</i> 237(Exiting the chroot) # <i>exit; cd /</i>
219(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>
220(Reboot; Remove the install CD from the tray) # <i>reboot</i> 239(Reboot; Remove the install CD from the tray) # <i>reboot</i>
221(After booting:) 240(After booting:)
222(ADSL-users only) # <i>adsl-setup</i> 241(ADSL-users only) # <i>adsl-setup</i>
223(GRP-users only, optional CD2 usage) 242(GRP-users only)
224( (1) Mount CD2) # <i>mount /dev/cdrom /mnt/cdrom</i> 243( (1) Mount CD2) # <i>mount /dev/cdrom /mnt/cdrom</i>
225( (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>
226( (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>
227( (4) Configure your Xserver) # <i>/usr/X11R6/bin/xf86config</i> 246( (4) Configure your Xserver) # <i>/usr/X11R6/bin/xf86config</i>
228</pre> 247</pre>
229 248
230<p> 249<p>
231You can get more information from the <uri 250You can get more information from the <uri

Legend:
Removed from v.1.7  
changed lines
  Added in v.1.9

  ViewVC Help
Powered by ViewVC 1.1.20