/[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 - (hide annotations) (download) (as text)
Tue Sep 28 15:18:10 2004 UTC (9 years, 11 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 swift 1.1 <?xml version='1.0' encoding="UTF-8"?>
2 swift 1.21 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.20 2004/09/25 13:06:26 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 swift 1.1 <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 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 swift 1.21 <version>1.16</version>
22     <date>September 28, 2004</date>
23 swift 1.1
24     <chapter>
25     <title>Quick Install Reference</title>
26 aaby 1.7 <section>
27 swift 1.1 <body>
28    
29     <p>
30     The installation ISOs are on the <uri link=
31 aaby 1.7 "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 neysx 1.13 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 aaby 1.7 contains pre-compiled packages such as KDE, GNOME, OpenOffice,
37     Mozilla, Evolution and more.
38 swift 1.1 </p>
39    
40     <p>
41 neysx 1.13 Boot from the Universal CD. Press &lt;F1&gt; and/or &lt;F2&gt; to
42 swift 1.1 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 aaby 1.7 The recommended setup is a 64 meg boot volume with ext2, a swap partition
55 swift 1.1 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 swift 1.21 (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 swift 1.1 </pre>
95    
96     <p>
97     Now we install Gentoo:
98     </p>
99    
100     <pre caption = "Installing Gentoo">
101 swift 1.21 (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 swift 1.1 </pre>
107    
108     <p>
109     Next we set up the necessary information:
110     </p>
111    
112     <pre caption = "Setting up Configuration Files">
113 swift 1.21 (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 swift 1.1 </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 swift 1.21 # &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 swift 1.1 </pre>
131    
132     <p>
133     Continue by installing the Linux kernel:
134     </p>
135    
136     <pre caption="Installing the Kernel">
137 swift 1.21 (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 swift 1.1 ( (2) Include VM fs, /proc fs, /dev fs, /dev fs auto mount at boot)
143 swift 1.21 ( (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 swift 1.1 </pre>
146    
147     <p>
148     Now install other tools you might want:
149     </p>
150    
151     <pre caption = "Install important system tools">
152 swift 1.21 (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 swift 1.1 </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 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>)
174 swift 1.21 # <i>VIDEO_CARDS="yourcard" emerge xfree-drm</i> (for ATI Radeon up to 9200, Rage128,
175     Matrox, Voodoo and other cards)
176 swift 1.1 </pre>
177    
178     <p>
179     Finalise the settings for your Gentoo system:
180     </p>
181    
182     <pre caption = "Finalise the Configuration Settings">
183 swift 1.21 (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 swift 1.1 </pre>
193    
194     <pre caption = "Set up Networking">
195 swift 1.21 (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 swift 1.1 (Only if you have multiple network interfaces:)
202 swift 1.21 (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 swift 1.1 </pre>
209    
210     <p>
211 swift 1.9 Now install a bootloader.
212 swift 1.1 </p>
213    
214 swift 1.9 <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 swift 1.11 timeout=50
240 swift 1.9 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 swift 1.1 </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 swift 1.21 (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 swift 1.1 (After booting:)
265 swift 1.21 (ADSL-users only) # <i>adsl-setup</i>
266 swift 1.9 (GRP-users only)
267 swift 1.21 (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 swift 1.1 </pre>
273    
274     <p>
275 aaby 1.7 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 swift 1.1 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20