/[gentoo]/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
Gentoo

Contents of /xml/htdocs/doc/en/gentoo-x86-quickinstall.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.21 - (show annotations) (download) (as text)
Tue Sep 28 15:18:10 2004 UTC (9 years, 6 months ago) by swift
Branch: MAIN
Changes since 1.20: +93 -67 lines
File MIME type: application/xml
Since this is an installation document, I've wrapped the lines in the Code
Listings that are too long to print out nicely. Too many people print this
guide. Someone should add Greenpeace's information on top.

1 <?xml version='1.0' encoding="UTF-8"?>
2 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.20 2004/09/25 13:06:26 swift Exp $ -->
3
4 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5
6 <guide link="/doc/en/gentoo-x86-quickinstall.xml">
7 <title>Gentoo Linux Install Reference</title>
8 <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 The Quick install reference covers all details of the install process in a
15 non-verbose manner. Users should already have prior experience with
16 installing Gentoo Linux if they want to follow this guide.
17 </abstract>
18
19 <license/>
20
21 <version>1.16</version>
22 <date>September 28, 2004</date>
23
24 <chapter>
25 <title>Quick Install Reference</title>
26 <section>
27 <body>
28
29 <p>
30 The installation ISOs are on the <uri link=
31 "http://www.gentoo.org/main/en/mirrors.xml">Gentoo
32 Mirrors</uri>. Detailed descriptions of the different CDs are
33 available in the <uri link="http://store.gentoo.org">Gentoo
34 Store</uri>. A universal CD contains everything you need to install Gentoo Linux
35 quickly and without a connection to the Internet. A Package CD is optional and
36 contains pre-compiled packages such as KDE, GNOME, OpenOffice,
37 Mozilla, Evolution and more.
38 </p>
39
40 <p>
41 Boot from the Universal CD. Press &lt;F1&gt; and/or &lt;F2&gt; to
42 see what boot options are available. Press &lt;ENTER&gt; at the bootscreen to
43 continue with the default kernel. You'll eventually receive a prompt.
44 </p>
45
46 <pre caption="Beginning settings">
47 # <i>date</i> (Make sure your time and date is correct. If wrong, set it with <i>date MMDDhhmmCCYY</i> )
48 # <i>modprobe module_name</i> (Optional - Load any necessary modules)
49 # <i>net-setup eth0</i> (Configure the network)
50 # <i>fdisk /dev/hda</i> (Partition your drive)
51 </pre>
52
53 <p>
54 The recommended setup is a 64 meg boot volume with ext2, a swap partition
55 twice the size of your available RAM, and the rest for your root partition
56 using ReiserFS.
57 </p>
58
59 <p>
60 Initialise your partitions using <c>mke2fs</c> (Ext2), <c>mke2fs
61 -j</c> (Ext3), <c>mkreiserfs</c> (ReiserFS), <c>mkfs.xfs</c> (XFS),
62 <c>mkfs.jfs</c> (JFS) and <c>mkswap</c> (swap partition). For instance:
63 <c>mke2fs -j /dev/hda3</c>.
64 </p>
65
66 <p>
67 Continue by mounting the partitions and extracting the appropriate stage
68 file.
69 </p>
70
71 <pre caption="Preparing the Installation">
72 (Activate the swap partition) # <i>swapon /dev/hdax</i>
73 (Mount the root partition) # <i>mount /dev/hdax /mnt/gentoo</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>
76 (Go to the mountpoint) # <i>cd /mnt/gentoo</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...)
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>
81 (Optional: unpack a portage tree)# <i>tar -xvjf /mnt/cdrom/snapshots/portage-*.tar.bz2 \
82 -C /mnt/gentoo/usr</i>
83 (Optional: copy over distfiles) # <i>cd /mnt/gentoo/usr/portage; mkdir distfiles;</i>
84 # <i>cp /mnt/cdrom/distfiles/* distfiles/</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>
89 (Mount the proc filesystem) # <i>mount -t proc none /mnt/gentoo/proc</i>
90 (Chroot into the new environment)# <i>chroot /mnt/gentoo /bin/bash</i>
91 (Load the necessary variables) # <i>env-update; source /etc/profile</i>
92 (Network-only, non-GRP: update Portage)
93 # <i>emerge sync</i>
94 </pre>
95
96 <p>
97 Now we install Gentoo:
98 </p>
99
100 <pre caption = "Installing Gentoo">
101 (Change USE, CFLAGS and CXXFLAGS. Stage1 can also change CHOST)
102 # <i>nano -w /etc/make.conf</i>
103 (Stage1 only: bootstrap system) # <i>cd /usr/portage; scripts/bootstrap.sh</i>
104 (Stage1, Stage2 only: install base system)
105 # <i>emerge system</i>
106 </pre>
107
108 <p>
109 Next we set up the necessary information:
110 </p>
111
112 <pre caption = "Setting up Configuration Files">
113 (Set timezone information) # <i>ln -sf /usr/share/zoneinfo/<comment>&lt;path to time zone file&gt;</comment> /etc/localtime</i>
114 (Edit fstab file) # <i>nano -w /etc/fstab</i>
115 </pre>
116
117 <p>
118 Use the following as a <e>template</e> (don't copy verbatim) for
119 <path>/etc/fstab</path>:
120 </p>
121
122 <pre caption="/etc/fstab">
123 # &lt;fs&gt; &lt;mountpoint&gt; &lt;type&gt; &lt;opts&gt; &lt;dump/pass&gt;
124 /dev/hdax /boot ext2 noauto,noatime 1 2
125 /dev/hdax none swap sw 0 0
126 /dev/hdax / reiserfs noatime 0 1
127 /dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0
128 none /proc proc defaults 0 0
129 none /dev/shm tmpfs defaults 0 0
130 </pre>
131
132 <p>
133 Continue by installing the Linux kernel:
134 </p>
135
136 <pre caption="Installing the Kernel">
137 (Install the kernel sources) # <i>emerge <comment>&lt;kernel-package-here&gt;</comment></i>
138 (Configure your kernel using genkernel...)
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>
142 ( (2) Include VM fs, /proc fs, /dev fs, /dev fs auto mount at boot)
143 ( (3) Compile your kernel) # <i>make dep &amp;&amp; make clean bzImage modules modules_install</i>
144 ( (4) Copy over the kernel) # <i>cp arch/i386/boot/bzImage /boot; cp System.map /boot</i>
145 </pre>
146
147 <p>
148 Now install other tools you might want:
149 </p>
150
151 <pre caption = "Install important system tools">
152 (Install system logger; choice: sysklogd, metalog, msyslog, syslog-ng)
153 # <i>emerge syslog-ng </i>
154 (Have the systemlogger automatically started at boot)
155 # <i>rc-update add syslog-ng default</i>
156 (Install cron daemon; choice: vixie-cron, dcron, fcron)
157 # <i>emerge vixie-cron</i>
158 (Have the cron daemon automatically started at boot)
159 # <i>rc-update add vixie-cron default</i>
160 (genkernel users only: install hotplug) # <i>emerge hotplug</i>
161 (genkernel users only: have hotplug automatically started at boot)
162 # <i>rc-update add hotplug default</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>
166 </pre>
167
168 <p>
169 If you need specialised kernel ebuilds, now is a good time to install them:
170 </p>
171
172 <pre caption = "Install Specialised Kernel Ebuilds">
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>)
174 # <i>VIDEO_CARDS="yourcard" emerge xfree-drm</i> (for ATI Radeon up to 9200, Rage128,
175 Matrox, Voodoo and other cards)
176 </pre>
177
178 <p>
179 Finalise the settings for your Gentoo system:
180 </p>
181
182 <pre caption = "Finalise the Configuration Settings">
183 (Set root password) # <i>passwd</i>
184 (Create a user) # <i>useradd your_user -m -G users,wheel,audio -s /bin/bash</i>
185 (Set password for that user) # <i>passwd your_user</i>
186 (Set the system hostname) # <i>echo mymachine &gt; /etc/hostname</i>
187 (Set the system domainname) # <i>echo mydomain.com &gt; /etc/dnsdomainname</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>
192 </pre>
193
194 <pre caption = "Set up Networking">
195 (Setup networking; dhcp-users should set iface_eth0="dhcp")
196 # <i>nano -w /etc/conf.d/net</i>
197 (List modules to be loaded at startup)
198 # <i>nano -w /etc/modules.autoload.d/kernel-<comment>&lt;version&gt;</comment></i>
199 (Non-PCMCIA only: start networking automatically at boot)
200 # <i>rc-update add net.eth0 default</i>
201 (Only if you have multiple network interfaces:)
202 (1) Create initscripts for each interface)
203 # <i>ln -s /etc/init.d/net.eth0 /etc/init.d/net.ethx</i>
204 (2) Automatically start at boot if no PCMCIA)
205 # <i>rc-update add net.ethx default</i>
206 (PCMCIA only: verify /etc/conf.d/pcmcia and load PCMCIA at boot)
207 # <i>rc-update add pcmcia boot</i>
208 </pre>
209
210 <p>
211 Now install a bootloader.
212 </p>
213
214 <pre caption="Install and configure GRUB">
215 # <i>emerge grub</i>
216 # <i>grub</i>
217 grub&gt; <i>root (hd0,0)</i>
218 grub&gt; <i>setup (hd0)</i>
219 grub&gt; <i>quit</i>
220 # <i>nano -w /boot/grub/grub.conf</i>
221 default 0
222 timeout 15
223 splashimage=(hd0,0)/grub/splash.xpm.gz
224
225 title=Gentoo Linux
226 root (hd0,0)
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>
231 kernel /kernel-<comment>&lt;kernel version&gt;</comment> root=/dev/hda3
232 </pre>
233
234 <pre caption="Install and configure LILO">
235 # <i>emerge lilo</i>
236 # <i>nano -w /etc/lilo.conf</i>
237 boot=/dev/hda
238 prompt
239 timeout=50
240 default=gentoo
241
242 image=/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>
253 </pre>
254
255 <p>
256 Now unmount all partitions and reboot into your new system:
257 </p>
258
259 <pre caption="Finishing off and installing GUI">
260 (Exiting the chroot) # <i>exit; cd /</i>
261 (Unmounting partitions) # <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i>
262 (Reboot; Remove the universal CD from the tray)
263 # <i>reboot</i>
264 (After booting:)
265 (ADSL-users only) # <i>adsl-setup</i>
266 (GRP-users only)
267 (1) Mount Package CD # <i>mount /dev/cdrom /mnt/cdrom</i>
268 (2) Copy over packages # <i>mkdir /usr/portage/packages</i>
269 # <i>cp -a /mnt/cdrom/* /usr/portage/packages/</i>
270 (3) Install extra software# <i>USE="bindist" emerge -k xfree gnome kde mozilla openoffice-bin</i>
271 (4) Configure your Xserver# <i>/usr/X11R6/bin/xf86config</i>
272 </pre>
273
274 <p>
275 You can get more information from the <uri
276 link="http://www.gentoo.org/doc/en/index.xml">Gentoo
277 Documentation</uri>.
278 </p>
279 </body>
280 </section>
281 </chapter>
282 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20