1 |
swift |
1.1 |
<?xml version='1.0' encoding="UTF-8"?> |
2 |
fox2mike |
1.36 |
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.35 2005/05/23 17:01:12 swift Exp $ --> |
3 |
swift |
1.8 |
|
4 |
|
|
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
5 |
|
|
|
6 |
neysx |
1.16 |
<guide link="/doc/en/gentoo-x86-quickinstall.xml"> |
7 |
neysx |
1.31 |
<title>Gentoo Linux x86 Quick Install Guide</title> |
8 |
swift |
1.1 |
<author title="Author">Steven Wagner</author> |
9 |
|
|
<author title="Editor"> |
10 |
|
|
<mail link="swift@gentoo.org">Sven Vermeulen</mail> |
11 |
|
|
</author> |
12 |
|
|
|
13 |
|
|
<abstract> |
14 |
neysx |
1.31 |
The Quick install guide covers all details of the install process in a |
15 |
swift |
1.1 |
non-verbose manner. Users should already have prior experience with |
16 |
aaby |
1.7 |
installing Gentoo Linux if they want to follow this guide. |
17 |
swift |
1.2 |
</abstract> |
18 |
|
|
|
19 |
swift |
1.1 |
<license/> |
20 |
swift |
1.2 |
|
21 |
fox2mike |
1.36 |
<version>1.29</version> |
22 |
|
|
<date>2005-06-12</date> |
23 |
swift |
1.1 |
|
24 |
|
|
<chapter> |
25 |
neysx |
1.31 |
<title>Quick Install Guide</title> |
26 |
aaby |
1.7 |
<section> |
27 |
swift |
1.1 |
<body> |
28 |
|
|
|
29 |
|
|
<p> |
30 |
neysx |
1.31 |
The installation ISOs are on the <uri link="/main/en/mirrors.xml">Gentoo |
31 |
aaby |
1.7 |
Mirrors</uri>. Detailed descriptions of the different CDs are |
32 |
|
|
available in the <uri link="http://store.gentoo.org">Gentoo |
33 |
neysx |
1.13 |
Store</uri>. A universal CD contains everything you need to install Gentoo Linux |
34 |
|
|
quickly and without a connection to the Internet. A Package CD is optional and |
35 |
aaby |
1.7 |
contains pre-compiled packages such as KDE, GNOME, OpenOffice, |
36 |
|
|
Mozilla, Evolution and more. |
37 |
swift |
1.1 |
</p> |
38 |
|
|
|
39 |
|
|
<p> |
40 |
neysx |
1.13 |
Boot from the Universal CD. Press <F1> and/or <F2> to |
41 |
swift |
1.1 |
see what boot options are available. Press <ENTER> at the bootscreen to |
42 |
|
|
continue with the default kernel. You'll eventually receive a prompt. |
43 |
|
|
</p> |
44 |
|
|
|
45 |
swift |
1.32 |
<pre caption="Initial settings"> |
46 |
|
|
# <i>date</i> (Make sure your time and date is correct. If wrong, set it with <i>date MMDDhhmmCCYY</i>) |
47 |
|
|
# <i>modprobe module_name</i> <comment>(Optional - Load any necessary modules)</comment> |
48 |
|
|
# <i>net-setup eth0</i> <comment>(Configure the network)</comment> |
49 |
|
|
# <i>fdisk /dev/hda</i> <comment>(Partition your drive)</comment> |
50 |
swift |
1.1 |
</pre> |
51 |
|
|
|
52 |
|
|
<p> |
53 |
aaby |
1.7 |
The recommended setup is a 64 meg boot volume with ext2, a swap partition |
54 |
swift |
1.1 |
twice the size of your available RAM, and the rest for your root partition |
55 |
|
|
using ReiserFS. |
56 |
|
|
</p> |
57 |
|
|
|
58 |
|
|
<p> |
59 |
|
|
Initialise your partitions using <c>mke2fs</c> (Ext2), <c>mke2fs |
60 |
|
|
-j</c> (Ext3), <c>mkreiserfs</c> (ReiserFS), <c>mkfs.xfs</c> (XFS), |
61 |
|
|
<c>mkfs.jfs</c> (JFS) and <c>mkswap</c> (swap partition). For instance: |
62 |
|
|
<c>mke2fs -j /dev/hda3</c>. |
63 |
|
|
</p> |
64 |
|
|
|
65 |
|
|
<p> |
66 |
|
|
Continue by mounting the partitions and extracting the appropriate stage |
67 |
|
|
file. |
68 |
|
|
</p> |
69 |
|
|
|
70 |
swift |
1.32 |
<warn> |
71 |
|
|
For ext3 partitions, you need to specify <c>mount -t ext3</c> explicitly. This |
72 |
|
|
is due to a bug in the e2fsprogs package. |
73 |
|
|
</warn> |
74 |
|
|
|
75 |
swift |
1.1 |
<pre caption="Preparing the Installation"> |
76 |
swift |
1.21 |
(Activate the swap partition) # <i>swapon /dev/hdax</i> |
77 |
|
|
(Mount the root partition) # <i>mount /dev/hdax /mnt/gentoo</i> |
78 |
|
|
(Create the boot mountpoint) # <i>mkdir /mnt/gentoo/boot</i> |
79 |
|
|
(Mount the boot partition) # <i>mount /dev/hdax /mnt/gentoo/boot</i> |
80 |
|
|
(Go to the mountpoint) # <i>cd /mnt/gentoo</i> |
81 |
|
|
(Extract a stage tarball...) # <i>tar -xvjpf /mnt/cdrom/stages/stage<your stage>.tar.bz2</i> |
82 |
|
|
(<comment>or</comment> download the latest tarball...) |
83 |
|
|
# <i>links http://www.gentoo.org/main/en/mirrors.xml</i> |
84 |
|
|
( ... and extract) # <i>tar -xvjpf stage<your stage>.tar.bz2</i> |
85 |
|
|
(Optional: unpack a portage tree)# <i>tar -xvjf /mnt/cdrom/snapshots/portage-*.tar.bz2 \ |
86 |
|
|
-C /mnt/gentoo/usr</i> |
87 |
|
|
(Optional: copy over distfiles) # <i>cd /mnt/gentoo/usr/portage; mkdir distfiles;</i> |
88 |
|
|
# <i>cp /mnt/cdrom/distfiles/* distfiles/</i> |
89 |
|
|
(Select a mirror) # <i>mirrorselect -a -s4 -o | grep 'GENTOO_MIRRORS=' \ |
90 |
|
|
>> /mnt/gentoo/etc/make.conf</i> |
91 |
|
|
(Copy over nameserver information) |
92 |
|
|
# <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/resolv.conf</i> |
93 |
|
|
(Mount the proc filesystem) # <i>mount -t proc none /mnt/gentoo/proc</i> |
94 |
|
|
(Chroot into the new environment)# <i>chroot /mnt/gentoo /bin/bash</i> |
95 |
|
|
(Load the necessary variables) # <i>env-update; source /etc/profile</i> |
96 |
|
|
(Network-only, non-GRP: update Portage) |
97 |
cam |
1.22 |
# <i>emerge --sync</i> |
98 |
swift |
1.1 |
</pre> |
99 |
|
|
|
100 |
|
|
<p> |
101 |
swift |
1.32 |
Now we go onto setting our profile and installing Gentoo. A profile is a |
102 |
|
|
building block for any Gentoo system. Not only does it specify default values |
103 |
|
|
for CHOST, CFLAGS and other important variables, it also locks the system to a |
104 |
|
|
certain range of package versions. This is all maintained by the Gentoo |
105 |
|
|
developers. |
106 |
swift |
1.1 |
</p> |
107 |
|
|
|
108 |
|
|
<pre caption = "Installing Gentoo"> |
109 |
swift |
1.32 |
(Verify current profile) # <i>ls -l /etc/make.profile</i> |
110 |
|
|
(Change ONLY IF REQUIRED or if you want a 2.4 kernel) |
111 |
|
|
# <i>ln -snf /usr/portage/profiles/default-linux/x86/2005.0/2.4 /etc/make.profile</i> |
112 |
swift |
1.21 |
(Change USE, CFLAGS and CXXFLAGS. Stage1 can also change CHOST) |
113 |
|
|
# <i>nano -w /etc/make.conf</i> |
114 |
|
|
(Stage1 only: bootstrap system) # <i>cd /usr/portage; scripts/bootstrap.sh</i> |
115 |
swift |
1.32 |
(Stage1, Stage2 only: install base system. Use --emptytree if you modified USE flags. Else --newuse will do. |
116 |
|
|
One of these options is a must. ) |
117 |
|
|
# <i>emerge --emptytree system</i> <comment>OR</comment> <i>emerge --newuse system</i> |
118 |
swift |
1.1 |
</pre> |
119 |
|
|
|
120 |
|
|
<p> |
121 |
|
|
Next we set up the necessary information: |
122 |
|
|
</p> |
123 |
|
|
|
124 |
|
|
<pre caption = "Setting up Configuration Files"> |
125 |
swift |
1.21 |
(Set timezone information) # <i>ln -sf /usr/share/zoneinfo/<comment><path to time zone file></comment> /etc/localtime</i> |
126 |
|
|
(Edit fstab file) # <i>nano -w /etc/fstab</i> |
127 |
swift |
1.1 |
</pre> |
128 |
|
|
|
129 |
|
|
<p> |
130 |
|
|
Use the following as a <e>template</e> (don't copy verbatim) for |
131 |
|
|
<path>/etc/fstab</path>: |
132 |
|
|
</p> |
133 |
|
|
|
134 |
|
|
<pre caption="/etc/fstab"> |
135 |
swift |
1.21 |
# <fs> <mountpoint> <type> <opts> <dump/pass> |
136 |
swift |
1.26 |
/dev/hdax /boot ext2 defaults,noatime 1 2 |
137 |
swift |
1.21 |
/dev/hdax none swap sw 0 0 |
138 |
|
|
/dev/hdax / reiserfs noatime 0 1 |
139 |
|
|
/dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0 |
140 |
|
|
none /proc proc defaults 0 0 |
141 |
vapier |
1.24 |
none /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
142 |
swift |
1.1 |
</pre> |
143 |
|
|
|
144 |
|
|
<p> |
145 |
|
|
Continue by installing the Linux kernel: |
146 |
|
|
</p> |
147 |
|
|
|
148 |
|
|
<pre caption="Installing the Kernel"> |
149 |
swift |
1.21 |
(Install the kernel sources) # <i>emerge <comment><kernel-package-here></comment></i> |
150 |
|
|
(Configure your kernel using genkernel...) |
151 |
swift |
1.35 |
# <i>emerge genkernel; genkernel --udev --menuconfig all</i> |
152 |
swift |
1.21 |
(<comment>or</comment> (1) manually build your kernel) |
153 |
|
|
# <i>cd /usr/src/linux; make menuconfig;</i> |
154 |
swift |
1.32 |
( (2) Include VM fs, /proc fs) |
155 |
swift |
1.23 |
( (3) Compile your kernel) |
156 |
swift |
1.32 |
(for a 2.6 kernel) # <i>make && make modules_install</i> |
157 |
swift |
1.23 |
(for a 2.4 kernel) # <i>make dep && make clean bzImage modules modules_install</i> |
158 |
swift |
1.21 |
( (4) Copy over the kernel) # <i>cp arch/i386/boot/bzImage /boot; cp System.map /boot</i> |
159 |
swift |
1.1 |
</pre> |
160 |
|
|
|
161 |
|
|
<p> |
162 |
|
|
Now install other tools you might want: |
163 |
|
|
</p> |
164 |
|
|
|
165 |
|
|
<pre caption = "Install important system tools"> |
166 |
swift |
1.21 |
(Install system logger; choice: sysklogd, metalog, msyslog, syslog-ng) |
167 |
|
|
# <i>emerge syslog-ng </i> |
168 |
|
|
(Have the systemlogger automatically started at boot) |
169 |
|
|
# <i>rc-update add syslog-ng default</i> |
170 |
|
|
(Install cron daemon; choice: vixie-cron, dcron, fcron) |
171 |
|
|
# <i>emerge vixie-cron</i> |
172 |
|
|
(Have the cron daemon automatically started at boot) |
173 |
|
|
# <i>rc-update add vixie-cron default</i> |
174 |
swift |
1.34 |
(genkernel users only: install *plug) # <i>emerge coldplug hotplug</i> |
175 |
swift |
1.33 |
(genkernel users only: have coldplug automatically started at boot) |
176 |
|
|
# <i>rc-update add coldplug boot</i> |
177 |
swift |
1.21 |
(Non-ext2,ext3 users only; choice: reiserfsprogs, xfsprogs, jfsutils) |
178 |
|
|
# <i>emerge reiserfsprogs</i> |
179 |
swift |
1.25 |
(Optional: install DHCP client) # <i>emerge dhcpcd</i> |
180 |
swift |
1.21 |
(Domain name init script) # <i>rc-update add domainname default</i> |
181 |
swift |
1.1 |
</pre> |
182 |
|
|
|
183 |
|
|
<p> |
184 |
|
|
If you need specialised kernel ebuilds, now is a good time to install them: |
185 |
|
|
</p> |
186 |
|
|
|
187 |
|
|
<pre caption = "Install Specialised Kernel Ebuilds"> |
188 |
swift |
1.9 |
# <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>) |
189 |
swift |
1.26 |
# <i>VIDEO_CARDS="yourcard" emerge x11-drm</i> (for ATI Radeon up to 9200, Rage128, |
190 |
swift |
1.21 |
Matrox, Voodoo and other cards) |
191 |
swift |
1.1 |
</pre> |
192 |
|
|
|
193 |
|
|
<p> |
194 |
|
|
Finalise the settings for your Gentoo system: |
195 |
|
|
</p> |
196 |
|
|
|
197 |
|
|
<pre caption = "Finalise the Configuration Settings"> |
198 |
swift |
1.21 |
(Set root password) # <i>passwd</i> |
199 |
|
|
(Create a user) # <i>useradd your_user -m -G users,wheel,audio -s /bin/bash</i> |
200 |
|
|
(Set password for that user) # <i>passwd your_user</i> |
201 |
|
|
(Set the system hostname) # <i>echo mymachine > /etc/hostname</i> |
202 |
|
|
(Set the system domainname) # <i>echo mydomain.com > /etc/dnsdomainname</i> |
203 |
|
|
(Set the hostsfile, ex:"127.0.0.1 localhost mymachine") |
204 |
|
|
# <i>nano -w /etc/hosts</i> |
205 |
|
|
(Configure basic system settings; follow comments) |
206 |
|
|
# <i>nano -w /etc/rc.conf</i> |
207 |
swift |
1.1 |
</pre> |
208 |
|
|
|
209 |
|
|
<pre caption = "Set up Networking"> |
210 |
swift |
1.21 |
(Setup networking; dhcp-users should set iface_eth0="dhcp") |
211 |
|
|
# <i>nano -w /etc/conf.d/net</i> |
212 |
|
|
(List modules to be loaded at startup) |
213 |
|
|
# <i>nano -w /etc/modules.autoload.d/kernel-<comment><version></comment></i> |
214 |
|
|
(Non-PCMCIA only: start networking automatically at boot) |
215 |
|
|
# <i>rc-update add net.eth0 default</i> |
216 |
swift |
1.1 |
(Only if you have multiple network interfaces:) |
217 |
swift |
1.21 |
(1) Create initscripts for each interface) |
218 |
|
|
# <i>ln -s /etc/init.d/net.eth0 /etc/init.d/net.ethx</i> |
219 |
|
|
(2) Automatically start at boot if no PCMCIA) |
220 |
|
|
# <i>rc-update add net.ethx default</i> |
221 |
|
|
(PCMCIA only: verify /etc/conf.d/pcmcia and load PCMCIA at boot) |
222 |
swift |
1.28 |
# <i>rc-update add pcmcia default</i> |
223 |
swift |
1.1 |
</pre> |
224 |
|
|
|
225 |
|
|
<p> |
226 |
swift |
1.9 |
Now install a bootloader. |
227 |
swift |
1.1 |
</p> |
228 |
|
|
|
229 |
swift |
1.9 |
<pre caption="Install and configure GRUB"> |
230 |
|
|
# <i>emerge grub</i> |
231 |
|
|
# <i>grub</i> |
232 |
|
|
grub> <i>root (hd0,0)</i> |
233 |
|
|
grub> <i>setup (hd0)</i> |
234 |
|
|
grub> <i>quit</i> |
235 |
|
|
# <i>nano -w /boot/grub/grub.conf</i> |
236 |
|
|
default 0 |
237 |
|
|
timeout 15 |
238 |
|
|
splashimage=(hd0,0)/grub/splash.xpm.gz |
239 |
|
|
|
240 |
|
|
title=Gentoo Linux |
241 |
|
|
root (hd0,0) |
242 |
|
|
<comment># genkernel users:</comment> |
243 |
swift |
1.35 |
kernel /kernel-<comment><kernel version></comment> root=/dev/ram0 init=/linuxrc real_root=/dev/hda3 ramdisk=8192 udev |
244 |
swift |
1.9 |
initrd /initrd-<comment><kernel version></comment> |
245 |
|
|
<comment># non-genkernel users:</comment> |
246 |
swift |
1.35 |
kernel /kernel-<comment><kernel version></comment> root=/dev/hda3 udev |
247 |
swift |
1.9 |
</pre> |
248 |
|
|
|
249 |
|
|
<pre caption="Install and configure LILO"> |
250 |
|
|
# <i>emerge lilo</i> |
251 |
|
|
# <i>nano -w /etc/lilo.conf</i> |
252 |
|
|
boot=/dev/hda |
253 |
|
|
prompt |
254 |
swift |
1.11 |
timeout=50 |
255 |
swift |
1.9 |
default=gentoo |
256 |
|
|
|
257 |
|
|
image=/boot/kernel-<comment><kernel version></comment> |
258 |
|
|
label=gentoo |
259 |
|
|
read-only |
260 |
|
|
<comment># genkernel users:</comment> |
261 |
swift |
1.35 |
append="init=/linuxrc real_root=/dev/hda3 ramdisk=8192 udev" |
262 |
swift |
1.9 |
root=/dev/ram0 |
263 |
|
|
initrd=/boot/initrd-<comment><kernel version></comment> |
264 |
|
|
<comment># non-genkernel users:</comment> |
265 |
swift |
1.35 |
append="udev" |
266 |
swift |
1.9 |
root=/dev/hda3 |
267 |
|
|
|
268 |
|
|
# <i>/sbin/lilo</i> |
269 |
swift |
1.1 |
</pre> |
270 |
|
|
|
271 |
|
|
<p> |
272 |
|
|
Now unmount all partitions and reboot into your new system: |
273 |
|
|
</p> |
274 |
|
|
|
275 |
|
|
<pre caption="Finishing off and installing GUI"> |
276 |
fox2mike |
1.36 |
(Exiting the chroot) # <i>exit</i> |
277 |
|
|
# <i>cd /</i> |
278 |
swift |
1.21 |
(Unmounting partitions) # <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i> |
279 |
|
|
(Reboot; Remove the universal CD from the tray) |
280 |
|
|
# <i>reboot</i> |
281 |
swift |
1.1 |
(After booting:) |
282 |
swift |
1.21 |
(ADSL-users only) # <i>adsl-setup</i> |
283 |
swift |
1.9 |
(GRP-users only) |
284 |
neysx |
1.31 |
(1) Mount Package CD # <i>mount /dev/cdrom /mnt/cdrom</i> |
285 |
|
|
(2) Copy over packages # <i>mkdir /usr/portage/packages</i> |
286 |
swift |
1.21 |
# <i>cp -a /mnt/cdrom/* /usr/portage/packages/</i> |
287 |
neysx |
1.31 |
(3) Install extra software # <i>USE="bindist" emerge -k xorg-x11 gnome kde mozilla openoffice-bin</i> |
288 |
|
|
(4) Configure your Xserver # <i>/usr/X11R6/bin/xorgconfig</i> |
289 |
swift |
1.1 |
</pre> |
290 |
|
|
|
291 |
|
|
<p> |
292 |
neysx |
1.31 |
You can get more information from the <uri link="/doc/en/index.xml">Gentoo |
293 |
aaby |
1.7 |
Documentation</uri>. |
294 |
|
|
</p> |
295 |
neysx |
1.31 |
|
296 |
aaby |
1.7 |
</body> |
297 |
|
|
</section> |
298 |
|
|
</chapter> |
299 |
swift |
1.1 |
</guide> |