/[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.33 - (hide annotations) (download) (as text)
Sat Apr 16 20:13:10 2005 UTC (9 years, 5 months ago) by swift
Branch: MAIN
Changes since 1.32: +6 -6 lines
File MIME type: application/xml
#89028 - Add in coldplug/hotplug merging and coldplug adding to the default runlevel

1 swift 1.1 <?xml version='1.0' encoding="UTF-8"?>
2 swift 1.33 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.32 2005/03/29 13:31:15 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 swift 1.33 <version>1.27</version>
22     <date>2005-04-16</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 &lt;F1&gt; and/or &lt;F2&gt; to
41 swift 1.1 see what boot options are available. Press &lt;ENTER&gt; 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&lt;your stage&gt;.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&lt;your stage&gt;.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     &gt;&gt; /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>&lt;path to time zone file&gt;</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 # &lt;fs&gt; &lt;mountpoint&gt; &lt;type&gt; &lt;opts&gt; &lt;dump/pass&gt;
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>&lt;kernel-package-here&gt;</comment></i>
150     (Configure your kernel using genkernel...)
151     # <i>emerge genkernel; genkernel --menuconfig all</i>
152     (<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 &amp;&amp; make modules_install</i>
157 swift 1.23 (for a 2.4 kernel) # <i>make dep &amp;&amp; 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.33 (genkernel users only: install *plug) # <i>emerge coldplug hotplug</i>
175     (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 &gt; /etc/hostname</i>
202     (Set the system domainname) # <i>echo mydomain.com &gt; /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>&lt;version&gt;</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&gt; <i>root (hd0,0)</i>
233     grub&gt; <i>setup (hd0)</i>
234     grub&gt; <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.27 kernel /kernel-<comment>&lt;kernel version&gt;</comment> root=/dev/ram0 init=/linuxrc real_root=/dev/hda3 ramdisk=8192
244 swift 1.9 initrd /initrd-<comment>&lt;kernel version&gt;</comment>
245     <comment># non-genkernel users:</comment>
246     kernel /kernel-<comment>&lt;kernel version&gt;</comment> root=/dev/hda3
247     </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>&lt;kernel version&gt;</comment>
258     label=gentoo
259     read-only
260     <comment># genkernel users:</comment>
261 swift 1.27 append="init=/linuxrc real_root=/dev/hda3 ramdisk=8192"
262 swift 1.9 root=/dev/ram0
263     initrd=/boot/initrd-<comment>&lt;kernel version&gt;</comment>
264     <comment># non-genkernel users:</comment>
265     root=/dev/hda3
266    
267     # <i>/sbin/lilo</i>
268 swift 1.1 </pre>
269    
270     <p>
271     Now unmount all partitions and reboot into your new system:
272     </p>
273    
274     <pre caption="Finishing off and installing GUI">
275 swift 1.21 (Exiting the chroot) # <i>exit; cd /</i>
276     (Unmounting partitions) # <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i>
277     (Reboot; Remove the universal CD from the tray)
278     # <i>reboot</i>
279 swift 1.1 (After booting:)
280 swift 1.21 (ADSL-users only) # <i>adsl-setup</i>
281 swift 1.9 (GRP-users only)
282 neysx 1.31 (1) Mount Package CD # <i>mount /dev/cdrom /mnt/cdrom</i>
283     (2) Copy over packages # <i>mkdir /usr/portage/packages</i>
284 swift 1.21 # <i>cp -a /mnt/cdrom/* /usr/portage/packages/</i>
285 neysx 1.31 (3) Install extra software # <i>USE="bindist" emerge -k xorg-x11 gnome kde mozilla openoffice-bin</i>
286     (4) Configure your Xserver # <i>/usr/X11R6/bin/xorgconfig</i>
287 swift 1.1 </pre>
288    
289     <p>
290 neysx 1.31 You can get more information from the <uri link="/doc/en/index.xml">Gentoo
291 aaby 1.7 Documentation</uri>.
292     </p>
293 neysx 1.31
294 aaby 1.7 </body>
295     </section>
296     </chapter>
297 swift 1.1 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20