/[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.9 - (show annotations) (download) (as text)
Sat Mar 6 17:23:24 2004 UTC (10 years, 5 months ago) by swift
Branch: MAIN
Changes since 1.8: +68 -52 lines
File MIME type: application/xml
#43687 - Fixups on gentoo-x86-quickinstall

1 <?xml version='1.0' encoding="UTF-8"?>
2 <!-- $Header: /var/www/www.gentoo.org/raw_cvs/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.8 2004/02/23 10:11:07 swift Exp $ -->
3
4 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5
6 <guide link="/doc/en/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.5</version>
22 <date>March 4th, 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>. CD 1 contains everything you need to install Gentoo Linux
35 quickly and without a connection to the Internet. CD 2 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 first Gentoo 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?-*.tar.bz2</i>
78 (<comment>or</comment> download the latest tarball...) # <i>lynx http://www.gentoo.org/main/en/mirrors.xml</i>
79 ( ... and extract) # <i>tar -xvjpf stage*</i>
80 (Optional: unpack a portage tree) # <i>tar -xvjf /mnt/cdrom/snapshots/portage-*.tar.bz2 -C /mnt/gentoo/usr</i>
81 (Optional: copy over distfiles) # <i>cp -R /mnt/cdrom/distfiles /mnt/gentoo/usr/portage/distfiles</i>
82 (Select a mirror) # <i>mirrorselect -a -s4 -o &gt;&gt; /mnt/gentoo/etc/make.conf</i>
83 (Copy over nameserver information) # <i>cp /etc/resolv.conf /mnt/gentoo/etc/resolv.conf</i>
84 (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>
86 (Load the necessary variables) # <i>env-update; source /etc/profile</i>
87 (Network-only, non-GRP: update Portage) # <i>emerge sync</i>
88 </pre>
89
90 <p>
91 Now we install Gentoo:
92 </p>
93
94 <pre caption = "Installing Gentoo">
95 (Change USE, CFLAGS and CXXFLAGS. Stage1 can also change CHOST) # <i>nano -w /etc/make.conf</i>
96 (Stage1 only: bootstrap system) # <i>cd /usr/portage; scripts/bootstrap.sh</i>
97 (Stage1, Stage2 only: install base system) # <i>emerge system</i>
98 </pre>
99
100 <p>
101 Next we set up the necessary information:
102 </p>
103
104 <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>
106 (Edit fstab file) # <i>nano -w /etc/fstab</i>
107 </pre>
108
109 <p>
110 Use the following as a <e>template</e> (don't copy verbatim) for
111 <path>/etc/fstab</path>:
112 </p>
113
114 <pre caption="/etc/fstab">
115 # &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
117 /dev/hdax none swap sw 0 0
118 /dev/hdax / reiserfs noatime 0 1
119 /dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0
120 none /proc proc defaults 0 0
121 none /dev/shm tmpfs defaults 0 0
122 </pre>
123
124 <p>
125 Continue by installing the Linux kernel:
126 </p>
127
128 <pre caption="Installing the Kernel">
129 (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>
131 (<comment>or</comment> (1) manually build your kernel) # <i>cd /usr/src/linux; make menuconfig;</i>
132 ( (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>
134 ( (4) Copy over the kernel) # <i>cp arch/i386/boot/bzImage /boot; cp System.map /boot</i>
135 </pre>
136
137 <p>
138 Now install other tools you might want:
139 </p>
140
141 <pre caption = "Install important system tools">
142 (Install system logger; choice: sysklogd, metalog, msyslog, syslog-ng) # <i>emerge syslog-ng </i>
143 (Have the systemlogger automatically started at boot) # <i>rc-update add syslog-ng default</i>
144 (Install cron daemon; choice: vixie-cron, dcron, fcron) # <i>emerge vixie-cron</i>
145 (Have the cron daemon automatically started at boot) # <i>rc-update add vixie-cron default</i>
146 (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>
148 (ALSA users only: install alsa-utils) # <i>emerge alsa-utils</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>
151 (Domain name init script) # <i>rc-update add domainname default</i>
152 </pre>
153
154 <p>
155 If you need specialised kernel ebuilds, now is a good time to install them:
156 </p>
157
158 <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>)
160 # <i>VIDEO_CARDS="yourcard" emerge xfree-drm</i> (for ATI Radeon up to 9200, Rage128, Matrox, Voodoo and other cards)
161 </pre>
162
163 <p>
164 Finalise the settings for your Gentoo system:
165 </p>
166
167 <pre caption = "Finalise the Configuration Settings">
168 (Set root password) # <i>passwd</i>
169 (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>
171 (Set the system hostname) # <i>echo mymachine &gt; /etc/hostname</i>
172 (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>
174 (Configure basic system settings; follow comments) # <i>nano -w /etc/rc.conf</i>
175 </pre>
176
177 <pre caption = "Set up Networking">
178 (Setup networking; dhcp-users should set iface_eth0="dhcp") # <i>nano -w /etc/conf.d/net</i>
179 (List modules to be loaded at startup) # <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>
181 (Only if you have multiple network interfaces:)
182 (1) Create initscripts for each interface) # <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>
184 (PCMCIA only: verify /etc/conf.d/pcmcia and load PCMCIA at boot) # <i>rc-update add pcmcia boot</i>
185 </pre>
186
187 <p>
188 Now install a bootloader.
189 </p>
190
191 <pre caption="Install and configure GRUB">
192 # <i>emerge grub</i>
193 # <i>grub</i>
194 grub&gt; <i>root (hd0,0)</i>
195 grub&gt; <i>setup (hd0)</i>
196 grub&gt; <i>quit</i>
197 # <i>nano -w /boot/grub/grub.conf</i>
198 default 0
199 timeout 15
200 splashimage=(hd0,0)/grub/splash.xpm.gz
201
202 title=Gentoo Linux
203 root (hd0,0)
204 <comment># genkernel users:</comment>
205 kernel /kernel-<comment>&lt;kernel version&gt;</comment> root=/dev/ram0 init=/linuxrc real_root=/dev/hda3
206 initrd /initrd-<comment>&lt;kernel version&gt;</comment>
207 <comment># non-genkernel users:</comment>
208 kernel /kernel-<comment>&lt;kernel version&gt;</comment> root=/dev/hda3
209 </pre>
210
211 <pre caption="Install and configure LILO">
212 # <i>emerge lilo</i>
213 # <i>nano -w /etc/lilo.conf</i>
214 boot=/dev/hda
215 prompt
216 delay=50
217 default=gentoo
218
219 image=/boot/kernel-<comment>&lt;kernel version&gt;</comment>
220 label=gentoo
221 read-only
222 <comment># genkernel users:</comment>
223 append="init=/linuxrc real_root=/dev/hda3"
224 root=/dev/ram0
225 initrd=/boot/initrd-<comment>&lt;kernel version&gt;</comment>
226 <comment># non-genkernel users:</comment>
227 root=/dev/hda3
228
229 # <i>/sbin/lilo</i>
230 </pre>
231
232 <p>
233 Now unmount all partitions and reboot into your new system:
234 </p>
235
236 <pre caption="Finishing off and installing GUI">
237 (Exiting the chroot) # <i>exit; cd /</i>
238 (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>
240 (After booting:)
241 (ADSL-users only) # <i>adsl-setup</i>
242 (GRP-users only)
243 ( (1) Mount CD2) # <i>mount /dev/cdrom /mnt/cdrom</i>
244 ( (2) Copy over packages) # <i>cp -a /mnt/cdrom/packages/* /usr/portage/packages/</i>
245 ( (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>
247 </pre>
248
249 <p>
250 You can get more information from the <uri
251 link="http://www.gentoo.org/doc/en/index.xml">Gentoo
252 Documentation</uri>.
253 </p>
254 </body>
255 </section>
256 </chapter>
257 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20