/[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.9 Revision 1.24
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.9 2004/03/06 17:23:24 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.24 2004/10/16 20:20:25 vapier Exp $ -->
3 3
4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 4<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5 5
6<guide link="/doc/en/quickinstall.xml"> 6<guide link="/doc/en/gentoo-x86-quickinstall.xml">
7<title>Gentoo Linux Install Reference</title> 7<title>Gentoo Linux Install Reference</title>
8<author title="Author">Steven Wagner</author> 8<author title="Author">Steven Wagner</author>
9<author title="Editor"> 9<author title="Editor">
10 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 10 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
11</author> 11</author>
16installing Gentoo Linux if they want to follow this guide. 16installing Gentoo Linux if they want to follow this guide.
17</abstract> 17</abstract>
18 18
19<license/> 19<license/>
20 20
21<version>1.5</version> 21<version>1.18</version>
22<date>March 4th, 2004</date> 22<date>October 10, 2004</date>
23 23
24<chapter> 24<chapter>
25<title>Quick Install Reference</title> 25<title>Quick Install Reference</title>
26<section> 26<section>
27<body> 27<body>
29<p> 29<p>
30The installation ISOs are on the <uri link= 30The installation ISOs are on the <uri link=
31"http://www.gentoo.org/main/en/mirrors.xml">Gentoo 31"http://www.gentoo.org/main/en/mirrors.xml">Gentoo
32Mirrors</uri>. Detailed descriptions of the different CDs are 32Mirrors</uri>. Detailed descriptions of the different CDs are
33available in the <uri link="http://store.gentoo.org">Gentoo 33available in the <uri link="http://store.gentoo.org">Gentoo
34Store</uri>. CD 1 contains everything you need to install Gentoo Linux 34Store</uri>. A universal CD contains everything you need to install Gentoo Linux
35quickly and without a connection to the Internet. CD 2 is optional and 35quickly and without a connection to the Internet. A Package CD is optional and
36contains pre-compiled packages such as KDE, GNOME, OpenOffice, 36contains pre-compiled packages such as KDE, GNOME, OpenOffice,
37Mozilla, Evolution and more. 37Mozilla, Evolution and more.
38</p> 38</p>
39 39
40<p> 40<p>
41Boot 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
42see 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
43continue with the default kernel. You'll eventually receive a prompt. 43continue with the default kernel. You'll eventually receive a prompt.
44</p> 44</p>
45 45
46<pre caption="Beginning settings"> 46<pre caption="Beginning settings">
67Continue by mounting the partitions and extracting the appropriate stage 67Continue by mounting the partitions and extracting the appropriate stage
68file. 68file.
69</p> 69</p>
70 70
71<pre caption="Preparing the Installation"> 71<pre caption="Preparing the Installation">
72(Activate the swap partition) # <i>swapon /dev/hdax</i> 72(Activate the swap partition) # <i>swapon /dev/hdax</i>
73(Mount the root partition) # <i>mount /dev/hdax /mnt/gentoo</i> 73(Mount the root partition) # <i>mount /dev/hdax /mnt/gentoo</i>
74(Create the boot mountpoint) # <i>mkdir /mnt/gentoo/boot</i> 74(Create the boot mountpoint) # <i>mkdir /mnt/gentoo/boot</i>
75(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>
76(Go to the mountpoint) # <i>cd /mnt/gentoo</i> 76(Go to the mountpoint) # <i>cd /mnt/gentoo</i>
77(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>
78(<comment>or</comment> download the latest tarball...) # <i>lynx http://www.gentoo.org/main/en/mirrors.xml</i> 78(<comment>or</comment> download the latest tarball...)
79( ... 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>
80(Optional: 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 \
82 -C /mnt/gentoo/usr</i>
81(Optional: copy over distfiles) # <i>cp -R /mnt/cdrom/distfiles /mnt/gentoo/usr/portage/distfiles</i> 83(Optional: copy over distfiles) # <i>cd /mnt/gentoo/usr/portage; mkdir distfiles;</i>
82(Select a mirror) # <i>mirrorselect -a -s4 -o &gt;&gt; /mnt/gentoo/etc/make.conf</i> 84 # <i>cp /mnt/cdrom/distfiles/* distfiles/</i>
83(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>
84(Mount the proc filesystem) # <i>mount -t proc none /mnt/gentoo/proc</i> 89(Mount the proc filesystem) # <i>mount -t proc none /mnt/gentoo/proc</i>
85(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>
86(Load the necessary variables) # <i>env-update; source /etc/profile</i> 91(Load the necessary variables) # <i>env-update; source /etc/profile</i>
87(Network-only, non-GRP: update Portage) # <i>emerge sync</i> 92(Network-only, non-GRP: update Portage)
93 # <i>emerge --sync</i>
88</pre> 94</pre>
89 95
90<p> 96<p>
91Now we install Gentoo: 97Now we install Gentoo:
92</p> 98</p>
93 99
94<pre caption = "Installing Gentoo"> 100<pre caption = "Installing Gentoo">
95(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>
96(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>
97(Stage1, Stage2 only: install base system) # <i>emerge system</i> 104(Stage1, Stage2 only: install base system)
105 # <i>emerge system</i>
98</pre> 106</pre>
99 107
100<p> 108<p>
101Next we set up the necessary information: 109Next we set up the necessary information:
102</p> 110</p>
103 111
104<pre caption = "Setting up Configuration Files"> 112<pre caption = "Setting up Configuration Files">
105(Set timezone information) # <i>ln -sf /usr/share/zoneinfo/<comment>&lt;path to time zone file&gt;</comment> /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>
106(Edit fstab file) # <i>nano -w /etc/fstab</i> 114(Edit fstab file) # <i>nano -w /etc/fstab</i>
107</pre> 115</pre>
108 116
109<p> 117<p>
110Use 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
111<path>/etc/fstab</path>: 119<path>/etc/fstab</path>:
112</p> 120</p>
113 121
114<pre caption="/etc/fstab"> 122<pre caption="/etc/fstab">
115# &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;
116/dev/hdax /boot ext2 noauto,noatime 1 2 124/dev/hdax /boot ext2 noauto,noatime 1 2
117/dev/hdax none swap sw 0 0 125/dev/hdax none swap sw 0 0
118/dev/hdax / reiserfs noatime 0 1 126/dev/hdax / reiserfs noatime 0 1
119/dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0 127/dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0
120none /proc proc defaults 0 0 128none /proc proc defaults 0 0
121none /dev/shm tmpfs defaults 0 0 129none /dev/shm tmpfs nodev,nosuid,noexec 0 0
122</pre> 130</pre>
123 131
124<p> 132<p>
125Continue by installing the Linux kernel: 133Continue by installing the Linux kernel:
126</p> 134</p>
127 135
128<pre caption="Installing the Kernel"> 136<pre caption="Installing the Kernel">
129(Install the kernel sources) # <i>emerge <comment>&lt;kernel-package-here&gt;</comment></i> 137(Install the kernel sources) # <i>emerge <comment>&lt;kernel-package-here&gt;</comment></i>
130(Configure your kernel using genkernel...) # <i>emerge genkernel; genkernel --menuconfig all</i> 138(Configure your kernel using genkernel...)
131(<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>
132( (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)
133( (3) Compile your kernel) # <i>make dep &amp;&amp; make clean bzImage modules modules_install</i> 143( (3) Compile your kernel)
144 (for a 2.4 kernel) # <i>make dep &amp;&amp; make clean bzImage modules modules_install</i>
145 (for a 2.6 kernel) # <i>make &amp;&amp; make modules_install</i>
134( (4) Copy over the kernel) # <i>cp arch/i386/boot/bzImage /boot; cp System.map /boot</i> 146( (4) Copy over the kernel) # <i>cp arch/i386/boot/bzImage /boot; cp System.map /boot</i>
135</pre> 147</pre>
136 148
137<p> 149<p>
138Now install other tools you might want: 150Now install other tools you might want:
139</p> 151</p>
140 152
141<pre caption = "Install important system tools"> 153<pre caption = "Install important system tools">
142(Install system logger; choice: sysklogd, metalog, msyslog, syslog-ng) # <i>emerge syslog-ng </i> 154(Install system logger; choice: sysklogd, metalog, msyslog, syslog-ng)
143(Have the systemlogger automatically started at boot) # <i>rc-update add syslog-ng default</i> 155 # <i>emerge syslog-ng </i>
156(Have the systemlogger automatically started at boot)
157 # <i>rc-update add syslog-ng default</i>
144(Install cron daemon; choice: vixie-cron, dcron, fcron) # <i>emerge vixie-cron</i> 158(Install cron daemon; choice: vixie-cron, dcron, fcron)
159 # <i>emerge vixie-cron</i>
145(Have the cron daemon automatically started at boot) # <i>rc-update add vixie-cron default</i> 160(Have the cron daemon automatically started at boot)
161 # <i>rc-update add vixie-cron default</i>
146(genkernel users only: install hotplug) # <i>emerge hotplug</i> 162(genkernel users only: install hotplug) # <i>emerge hotplug</i>
147(genkernel users only: have hotplug automatically started at boot) # <i>rc-update add hotplug default</i> 163(genkernel users only: have hotplug automatically started at boot)
148(ALSA users only: install alsa-utils) # <i>emerge alsa-utils</i> 164 # <i>rc-update add hotplug default</i>
149(ALSA users only: have alsa-utils automatically started at boot ) # <i>rc-update add alsasound default</i>
150(Non-ext2,ext3 users only; choice: reiserfsprogs, xfsprogs, jfsutils) # <i>emerge reiserfsprogs</i> 165(Non-ext2,ext3 users only; choice: reiserfsprogs, xfsprogs, jfsutils)
166 # <i>emerge reiserfsprogs</i>
151(Domain name init script) # <i>rc-update add domainname default</i> 167(Domain name init script) # <i>rc-update add domainname default</i>
152</pre> 168</pre>
153 169
154<p> 170<p>
155If you need specialised kernel ebuilds, now is a good time to install them: 171If you need specialised kernel ebuilds, now is a good time to install them:
156</p> 172</p>
157 173
158<pre caption = "Install Specialised Kernel Ebuilds"> 174<pre caption = "Install Specialised Kernel Ebuilds">
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>) 175# <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>)
160# <i>VIDEO_CARDS="yourcard" emerge xfree-drm</i> (for ATI Radeon up to 9200, Rage128, Matrox, Voodoo and other cards) 176# <i>VIDEO_CARDS="yourcard" emerge xfree-drm</i> (for ATI Radeon up to 9200, Rage128,
177 Matrox, Voodoo and other cards)
161</pre> 178</pre>
162 179
163<p> 180<p>
164Finalise the settings for your Gentoo system: 181Finalise the settings for your Gentoo system:
165</p> 182</p>
166 183
167<pre caption = "Finalise the Configuration Settings"> 184<pre caption = "Finalise the Configuration Settings">
168(Set root password) # <i>passwd</i> 185(Set root password) # <i>passwd</i>
169(Create a user) # <i>useradd your_user -m -G users,wheel,audio -s /bin/bash</i> 186(Create a user) # <i>useradd your_user -m -G users,wheel,audio -s /bin/bash</i>
170(Set password for that user) # <i>passwd your_user</i> 187(Set password for that user) # <i>passwd your_user</i>
171(Set the system hostname) # <i>echo mymachine &gt; /etc/hostname</i> 188(Set the system hostname) # <i>echo mymachine &gt; /etc/hostname</i>
172(Set the system domainname) # <i>echo mydomain.com &gt; /etc/dnsdomainname</i> 189(Set the system domainname) # <i>echo mydomain.com &gt; /etc/dnsdomainname</i>
173(Set the hostsfile, ex:"127.0.0.1 localhost mymachine") # <i>nano -w /etc/hosts</i> 190(Set the hostsfile, ex:"127.0.0.1 localhost mymachine")
191 # <i>nano -w /etc/hosts</i>
174(Configure basic system settings; follow comments) # <i>nano -w /etc/rc.conf</i> 192(Configure basic system settings; follow comments)
193 # <i>nano -w /etc/rc.conf</i>
175</pre> 194</pre>
176 195
177<pre caption = "Set up Networking"> 196<pre caption = "Set up Networking">
178(Setup networking; dhcp-users should set iface_eth0="dhcp") # <i>nano -w /etc/conf.d/net</i> 197(Setup networking; dhcp-users should set iface_eth0="dhcp")
198 # <i>nano -w /etc/conf.d/net</i>
199(List modules to be loaded at startup)
179(List modules to be loaded at startup) # <i>nano -w /etc/modules.autoload.d/kernel-<comment>&lt;version&gt;</comment></i> 200 # <i>nano -w /etc/modules.autoload.d/kernel-<comment>&lt;version&gt;</comment></i>
180(Non-PCMCIA only: start networking automatically at boot) # <i>rc-update add net.eth0 default</i> 201(Non-PCMCIA only: start networking automatically at boot)
202 # <i>rc-update add net.eth0 default</i>
181(Only if you have multiple network interfaces:) 203(Only if you have multiple network interfaces:)
204 (1) Create initscripts for each interface)
182 (1) Create initscripts for each interface) # <i>ln -s /etc/init.d/net.eth0 /etc/init.d/net.ethx</i> 205 # <i>ln -s /etc/init.d/net.eth0 /etc/init.d/net.ethx</i>
183 (2) Automatically start at boot if no PCMCIA) # <i>rc-update add net.ethx default</i> 206 (2) Automatically start at boot if no PCMCIA)
207 # <i>rc-update add net.ethx default</i>
184(PCMCIA only: verify /etc/conf.d/pcmcia and load PCMCIA at boot) # <i>rc-update add pcmcia boot</i> 208(PCMCIA only: verify /etc/conf.d/pcmcia and load PCMCIA at boot)
209 # <i>rc-update add pcmcia boot</i>
185</pre> 210</pre>
186 211
187<p> 212<p>
188Now install a bootloader. 213Now install a bootloader.
189</p> 214</p>
211<pre caption="Install and configure LILO"> 236<pre caption="Install and configure LILO">
212# <i>emerge lilo</i> 237# <i>emerge lilo</i>
213# <i>nano -w /etc/lilo.conf</i> 238# <i>nano -w /etc/lilo.conf</i>
214boot=/dev/hda 239boot=/dev/hda
215prompt 240prompt
216delay=50 241timeout=50
217default=gentoo 242default=gentoo
218 243
219image=/boot/kernel-<comment>&lt;kernel version&gt;</comment> 244image=/boot/kernel-<comment>&lt;kernel version&gt;</comment>
220 label=gentoo 245 label=gentoo
221 read-only 246 read-only
232<p> 257<p>
233Now unmount all partitions and reboot into your new system: 258Now unmount all partitions and reboot into your new system:
234</p> 259</p>
235 260
236<pre caption="Finishing off and installing GUI"> 261<pre caption="Finishing off and installing GUI">
237(Exiting the chroot) # <i>exit; cd /</i> 262(Exiting the chroot) # <i>exit; cd /</i>
238(Unmounting partitions) # <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i> 263(Unmounting partitions) # <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i>
239(Reboot; Remove the install CD from the tray) # <i>reboot</i> 264(Reboot; Remove the universal CD from the tray)
265 # <i>reboot</i>
240(After booting:) 266(After booting:)
241(ADSL-users only) # <i>adsl-setup</i> 267(ADSL-users only) # <i>adsl-setup</i>
242(GRP-users only) 268(GRP-users only)
243( (1) Mount CD2) # <i>mount /dev/cdrom /mnt/cdrom</i> 269 (1) Mount Package CD # <i>mount /dev/cdrom /mnt/cdrom</i>
270 (2) Copy over packages # <i>mkdir /usr/portage/packages</i>
244( (2) Copy over packages) # <i>cp -a /mnt/cdrom/packages/* /usr/portage/packages/</i> 271 # <i>cp -a /mnt/cdrom/* /usr/portage/packages/</i>
245( (3) Install extra software) # <i>USE="bindist" emerge -k xfree gnome kde mozilla openoffice-bin</i> 272 (3) Install extra software# <i>USE="bindist" emerge -k xfree gnome kde mozilla openoffice-bin</i>
246( (4) Configure your Xserver) # <i>/usr/X11R6/bin/xf86config</i> 273 (4) Configure your Xserver# <i>/usr/X11R6/bin/xf86config</i>
247</pre> 274</pre>
248 275
249<p> 276<p>
250You can get more information from the <uri 277You can get more information from the <uri
251link="http://www.gentoo.org/doc/en/index.xml">Gentoo 278link="http://www.gentoo.org/doc/en/index.xml">Gentoo

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

  ViewVC Help
Powered by ViewVC 1.1.20