/[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.5 - (show annotations) (download) (as text)
Sat Nov 15 00:35:19 2003 UTC (10 years, 8 months ago) by neysx
Branch: MAIN
Changes since 1.4: +1 -0 lines
File MIME type: application/xml
Added $Header$ cvs tag -- NO CONTENT CHANGE

1 <?xml version='1.0' encoding="UTF-8"?>
2 <!-- $Header$ -->
3 <guide link="/doc/en/quickinstall.xml">
4 <title>Gentoo Linux Install Reference</title>
5 <author title="Author">Steven Wagner</author>
6 <author title="Editor">
7 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
8 </author>
9
10 <abstract>
11 The Quick install reference covers all details of the install process in a
12 non-verbose manner. Users should already have prior experience with
13 installing gentoo linux if they want to follow this guide.
14 </abstract>
15
16 <license/>
17
18 <version>1.1</version>
19 <date>November 1, 2003</date>
20
21 <chapter>
22 <title>Quick Install Reference</title>
23 <body>
24
25 <p>
26 The installation ISOs are on the <uri link=
27 "http://www.gentoo.org/main/en/mirrors.xml">Gentoo Mirrors</uri>. Detailed
28 descriptions of the different CDs are available in the <uri
29 link="http://store.gentoo.org">Gentoo Store</uri>. CD 1 contains
30 everything you need to install Gentoo Linux quickly and without a
31 connection to the Internet. CD2 is optional and contains pre-compiled packages
32 such as KDE, GNOME, OpenOffice, Mozilla, Evolution and more.
33 </p>
34
35 <p>
36 Boot from the first Gentoo CD. Press &lt;F1&gt; and/or &lt;F2&gt; to
37 see what boot options are available. Press &lt;ENTER&gt; at the bootscreen to
38 continue with the default kernel. You'll eventually receive a prompt.
39 </p>
40
41 <pre caption="Beginning settings">
42 # <i>date</i> (Make sure your time and date is correct. If wrong, set it with <i>date MMDDhhmmCCYY</i> )
43 # <i>modprobe module_name</i> (Optional - Load any necessary modules)
44 # <i>net-setup eth0</i> (Configure the network)
45 # <i>fdisk /dev/hda</i> (Partition your drive)
46 </pre>
47
48 <p>
49 The recommended setup is a 64 meg boot volume with ext3, a swap partition
50 twice the size of your available RAM, and the rest for your root partition
51 using ReiserFS.
52 </p>
53
54 <p>
55 Initialise your partitions using <c>mke2fs</c> (Ext2), <c>mke2fs
56 -j</c> (Ext3), <c>mkreiserfs</c> (ReiserFS), <c>mkfs.xfs</c> (XFS),
57 <c>mkfs.jfs</c> (JFS) and <c>mkswap</c> (swap partition). For instance:
58 <c>mke2fs -j /dev/hda3</c>.
59 </p>
60
61 <p>
62 Continue by mounting the partitions and extracting the appropriate stage
63 file.
64 </p>
65
66 <pre caption="Preparing the Installation">
67 (Activate the swap partition) # <i>swapon /dev/hdax</i>
68 (Mount the root partition) # <i>mount /dev/hdax /mnt/gentoo</i>
69 (Create the boot mountpoint) # <i>mkdir /mnt/gentoo/boot</i>
70 (Mount the boot partition) # <i>mount /dev/hdax /mnt/gentoo/boot</i>
71 (Go to the mountpoint) # <i>cd /mnt/gentoo</i>
72 (Extract a stage tarball...) # <i>tar -xvjpf /mnt/cdrom/stages/stage?-*.tar.bz2</i>
73 (<comment>or</comment> download the latest tarball...) # <i>links http://gentoo.oregonstate.edu/releases/x86/1.4/</i>
74 ( ... and extract) # <i>tar -xvjpf stage*</i>
75 (GRP-only: unpack a portage tree) # <i>tar -xvjf /mnt/cdrom/snapshots/portage-*.tar.bz2 -C /mnt/gentoo/usr</i>
76 (GRP-only: copy over distfiles) # <i>cp -R /mnt/cdrom/distfiles /mnt/gentoo/usr/portage/distfiles</i>
77 (GRP-only: copy over packages) # <i>cp -a /mnt/cdrom/packages /mnt/gentoo/usr/portage/packages</i>
78 (Select a mirror) # <i>mirrorselect -i -o &gt;&gt; /mnt/gentoo/etc/make.conf</i>
79 (Copy over nameserver information) # <i>cp /etc/resolv.conf /mnt/gentoo/etc/resolv.conf</i>
80 (Mount the proc filesystem) # <i>mount -t proc proc /mnt/gentoo/proc</i>
81 (Chroot into the new environment) # <i>chroot /mnt/gentoo /bin/bash</i>
82 (Load the necessary variables) # <i>env-update; source /etc/profile</i>
83 (Network-only, non-GRP: update Portage) # <i>emerge sync</i>
84 </pre>
85
86 <p>
87 Now we install Gentoo:
88 </p>
89
90 <pre caption = "Installing Gentoo">
91 (Change USE, CFLAGS and CXXFLAGS. Stage1 can also change CHOST) # <i>nano -w /etc/make.conf</i>
92 (Stage1 only: bootstrap system) # <i>cd /usr/portage; scripts/bootstrap.sh</i>
93 (Stage1, Stage2 only: install base system) # <i>emerge system</i>
94 </pre>
95
96 <p>
97 Next we set up the necessary information:
98 </p>
99
100 <pre caption = "Setting up Configuration Files">
101 (Set timezone information) # <i>ln -sf /usr/share/zoneinfo/path/to/timezonefile /etc/localtime</i>
102 (Edit fstab file) # <i>nano -w /etc/fstab</i>
103 </pre>
104
105 <p>
106 Use the following as a <e>template</e> (don't copy verbatim) for
107 <path>/etc/fstab</path>:
108 </p>
109
110 <pre caption="/etc/fstab">
111 # &lt;fs&gt; &lt;mountpoint&gt; &lt;type&gt; &lt;opts&gt; &lt;dump/pass&gt;
112 /dev/hdax /boot ext3 noauto,noatime 1 2
113 /dev/hdax / reiserfs noatime 0 1
114 /dev/hdax none swap sw 0 0
115 /dev/cdroms/cdrom0 /mnt/cdrom iso9660 noauto,ro,user 0 0
116 none /proc proc defaults 0 0
117 none /dev/shm tmpfs defaults 0 0
118 /dev/hdax /mnt/dosc ntfs ro,noatime,umask=0222 0 0
119 </pre>
120
121 <p>
122 Continue by installing the Linux kernel:
123 </p>
124
125 <pre caption="Installing the Kernel">
126 (Install the kernel sources) # <i>emerge -k sys-kernel/gentoo-sources</i>
127 (Configure your kernel using genkernel...) # <i>emerge -k genkernel; genkernel</i>
128 (<comment>or</comment> (1) manually build your kernel) # <i>cd /usr/src/linux; make menuconfig;</i>
129 ( (2) Include VM fs, /proc fs, /dev fs, /dev fs auto mount at boot)
130 ( (3) Compile your kernel) # <i>make dep &amp;&amp; make clean bzImage modules modules_install</i>
131 ( (4) Copy over the kernel) # <i>cp arch/i386/boot/bzImage /boot; cp System.map /boot</i>
132 </pre>
133
134 <p>
135 Now install other tools you might want:
136 </p>
137
138 <pre caption = "Install important system tools">
139 (Install system logger; choice: sysklogd, metalog, msyslog, syslog-ng) # <i>emerge -k app-admin/syslog-ng </i>
140 (Have the systemlogger automatically started at boot) # <i>rc-update add syslog-ng default</i>
141 (Install cron daemon; choice: vcron, dcron, fcron) # <i>emerge -k sys-apps/vcron</i>
142 (Have the cron daemon automatically started at boot) # <i>rc-update add vcron default</i>
143 (genkernel users only: install hotplug) # <i>emerge -k hotplug</i>
144 (genkernel users only: have hotplug automatically started at boot) # <i>rc-update add hotplug default</i>
145 (Non-ext2,ext3 users only; choice: reiserfsprogs, xfsprogs, jfsutils) # <i>emerge -k reiserfsprogs</i>
146 </pre>
147
148 <p>
149 If you need specialised kernel ebuilds, now is a good time to install them:
150 </p>
151
152 <pre caption = "Install Specialised Kernel Ebuilds">
153 # <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>)
154 # <i>VIDEO_CARDS="yourcard" emerge xfree-drm</i> (for ATI Radeon up to 9200, Rage128, Matrox, Voodoo and other cards)
155 </pre>
156
157 <p>
158 Finalise the settings for your Gentoo system:
159 </p>
160
161 <pre caption = "Finalise the Configuration Settings">
162 (Set root password) # <i>passwd</i>
163 (Create a user) # <i>useradd your_user -m -G users,wheel,audio -s /bin/bash</i>
164 (Set password for that user) # <i>passwd your_user</i>
165 (Set the system hostname) # <i>echo mymachine &gt; /etc/hostname</i>
166 (Set the system domainname) # <i>echo mydomain.com &gt; /etc/dnsdomainname</i>
167 (Set the hostsfile, at least set "127.0.0.1 mymachine") # <i>nano -w /etc/hosts</i>
168 </pre>
169
170 <pre caption = "Set up Networking">
171 (Setup networking; dhcp-users should set iface_eth0="dhcp") # <i>nano -w /etc/conf.d/net</i>
172 (List modules to be loaded at startup) # <i>nano -w /etc/modules.autoload.d/kernel-2.4</i>
173 (Configure basic system settings; follow comments) # <i>nano -w /etc/rc.conf</i>
174 (Non-PCMCIA only: start networking automatically at boot) # <i>rc-update add net.eth0 default</i>
175 (Only if you have multiple network interfaces:)
176 (1) Create initscripts for each interface) # <i>ln -s /etc/init.d/net.eth0 /etc/init.d/net.ethx</i>
177 (2) Automatically start at boot if no PCMCIA) # <i>rc-update add net.ethx default</i>
178 (PCMCIA only: verify /etc/conf.d/pcmcia and load PCMCIA at boot) # <i>rc-update add pcmcia boot</i>
179 </pre>
180
181 <p>
182 Now install a bootloader. Left is for grub, right for lilo:
183 </p>
184
185 <pre caption = "Install and Configure a bootloader">
186 # <i>emerge -k grub</i> | # <i>emerge -k lilo</i>
187 # <i>grub</i> | # <i>nano -w /etc/lilo.conf</i>
188 grub&gt; <i>root (hd0,0)</i> (Boot partition) | boot=/dev/hda
189 grub&gt; <i>setup (hd0)</i> (Install on MBR) | prompt
190 grub&gt; <i>quit</i> | timeout=50
191 # <i>nano -w /boot/grub/grub.conf</i> | default=gentoo
192 default 0 |
193 timeout 15 | <comment># Genkernel only:</comment>
194 splashimage=(hd0,0)/grub/splash.xpm.gz | image=/boot/kernel-<comment>&lt;kernel version&gt;</comment>
195 | root=/dev/hda3
196 title=Gentoo Linux | label=gentoo
197 root (hd0,0) |
198 <comment># Genkernel only:</comment> | <comment># Non-genkernel only:</comment>
199 kernel (hd0,0)/kernel-<comment>&lt;kernel version&gt;</comment> root=/dev/hda3 | image=/boot/bzImage
200 initrd (hd0,0)/initrd-<comment>&lt;kernel version&gt;</comment> | root=/dev/hda3
201 <comment># Non-genkernel only:</comment> | label=gentoo
202 kernel (hd0,0)/bzImage |
203 | <comment># For dualbooting:</comment>
204 <comment># For dualbooting:</comment> | other=/dev/hda<comment>X</comment>
205 title=Windows XP | label=windows
206 root (hd0,5) |
207 chainloader (hd0,5)+1 | # <i>/sbin/lilo</i>
208 </pre>
209
210 <p>
211 Now unmount all partitions and reboot into your new system:
212 </p>
213
214 <pre caption="Finishing off and installing GUI">
215 (Updating configuration files) # <i>etc-update</i>
216 (Exiting the chroot) # <i>exit; cd /</i>
217 (Unmounting partitions) # <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i>
218 (Reboot; Remove the install CD from the tray) # <i>reboot</i>
219 (After booting:)
220 (ADSL-users only) # <i>adsl-setup</i>
221 (GRP-users only, optional CD2 usage)
222 ( (1) Mount CD2) # <i>mount /dev/cdrom /mnt/cdrom</i>
223 ( (2) Copy over packages) # <i>cp -a /mnt/cdrom/packages/* /usr/portage/packages/</i>
224 ( (3) Install extra software) # <i>emerge -k xfree gnome kde mozilla openoffice-bin</i>
225 ( (4) Configure your Xserver) # <i>/usr/X11R6/bin/xf86config</i>
226 </pre>
227
228 <p>
229 You can get more information from the <uri link="http://www.gentoo.org/doc/en/index.xml">Gentoo Documentation</uri>.
230 </p>
231 </body></chapter>
232
233 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20