doc/en/gentoo-x86-quickinstall.xml

<?xml version='1.0' encoding="UTF-8"?>
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.82 2009/01/09 18:12:12 neysx Exp $ -->

<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">

<guide lang="en">
<title>Gentoo Linux x86 Quick Install Guide</title>

<values>
 <key id="raid+lvm">no</key>
 <key id="root">/dev/sda3</key>
</values>

<author title="Author">
  <mail link="neysx"/>
</author>
<author title="Author">
  <mail link="swift"/>
</author>
<author title="Author">Steven Wagner</author>

<abstract>
The Quick install guide covers the Gentoo install process in a non-verbose
manner. Its purpose is to allow users to perform a stage3 install in no time.
Users should already have prior experience with installing Gentoo Linux if they
want to follow this guide.
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>24</version>
<date>2009-03-13</date>

<chapter>
<title>Introduction</title>
<section>
<body>

<p>
This guide contains all commands you should use to complete a stage3
installation of Gentoo. You need a connection to the Internet to download the
stage3 and Portage snapshots.
</p>

<p>
New users should read the <uri link="/doc/en/handbook/index.xml">Handbook</uri>
as it gives a better overview about the installation process.
</p>

<p>
Timing output follows all commands that take more than a couple of seconds to
finish. Commands were timed on an AMD 2000 1.66 Ghz PC with 512 MB of RAM and
two SATA disks connected to a hardware controller.
</p>

<pre caption="Test box specs">
<comment>(The following specs and the timing information should help you determine
a rough estimate of the time you need to complete your install)</comment>

# <i>grep bogo /proc/cpuinfo</i>
bogomips       : 3337.81

# <i>hdparm -tT /dev/sda</i>
/dev/sda:
 Timing cached reads:   1100 MB in  2.00 seconds = 549.97 MB/sec
 Timing buffered disk reads:  224 MB in  3.01 seconds =  74.36 MB/sec

# <i>grep MemTotal /proc/meminfo</i>
MemTotal:       509248 kB
</pre>

</body>
</section>
</chapter>

<chapter>
<title>Quick Install Guide</title>

<section>
 <include href="gentoo-x86-quickinstall-media.xml"/>
</section>

<section>
<title>Preparing the Disks</title>
<body>

<p>
Use <c>fdisk</c> or <c>cfdisk</c> to create your partition layout. You need at
least a swap partition (type 82) and one Linux partition (type 83). The
following scenario creates a <path>/boot</path>, a swap and a main partition as
used in our handbook. Replace <path>sda</path> with your disk. Most systems
ignore the bootable flag, but a few need it. Set this flag on your boot
partition with fdisk's <c>a</c> command.
</p>

<pre caption="Create the partitions">
livecd ~ # <i>fdisk /dev/sda</i>

<comment>(The rest of this guide uses the following partitioning scheme)</comment>
livecd ~ # <i>fdisk -l /dev/sda</i>

Disk /dev/sda: 599.9 GB, 599978409984 bytes
255 heads, 63 sectors/track, 72943 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes

   Device Boot      Start         End      Blocks   Id  System
/dev/sda1   *           1          12       96358+  83  Linux
/dev/sda2              13         110      787185   82  Linux swap / Solaris
/dev/sda3             111       72943   585031072+  83  Linux
</pre>

<p>
Use <c>mke2fs</c>, <c>mke2fs -j</c>, <c>mkreiserfs</c>, <c>mkfs.xfs</c> and
<c>mkfs.jfs</c> to create file systems on your Linux partitions. Initialize your
swap partition using <c>mkswap</c> and <c>swapon</c>.
</p>

<pre caption="Create the file systems and activate swap">
<comment>(ext2 is all you need on the /boot partition)</comment>
livecd ~ # <i>mke2fs /dev/sda1</i>

<comment>(Let's use ext3 on the main partition)</comment>
livecd ~ # <i>mke2fs -j /dev/sda3</i>

<comment>(Create and activate swap)</comment>
livecd ~ # <i>mkswap /dev/sda2 &amp;&amp; swapon /dev/sda2</i>
</pre>

<p>
Mount the freshly created file systems on <path>/mnt/gentoo</path>. Create
directories for the other mount points (like <path>/mnt/gentoo/boot</path>) if
you need them and mount them too.
</p>

<pre caption="Mount the file systems">
livecd ~ # <i>mount /dev/sda3 /mnt/gentoo</i>
livecd ~ # <i>mkdir /mnt/gentoo/boot</i>
livecd ~ # <i>mount /dev/sda1 /mnt/gentoo/boot</i>
livecd ~ # <i>cd /mnt/gentoo</i>
</pre>

</body>
</section>

<section>
 <include href="gentoo-x86-quickinstall-stage.xml"/>
</section>

<section>
<title>Kernel Configuration</title>
<body>

<p>
Install a kernel source (usually <c>gentoo-sources</c>), configure it, compile
it and copy the <path>arch/i386/boot/bzImage</path> file to <path>/boot</path>.
</p>

<pre caption="Install a kernel source, compile it and install the kernel">
livecd etc # <i>time emerge gentoo-sources</i>

real  2m51.435s
user  0m58.220s
sys   0m29.890s
livecd etc # <i>cd /usr/src/linux</i>
livecd linux # <i>make menuconfig</i>
<comment>(Configure your kernel)</comment>
livecd linux # <i>time make -j2</i>

<comment>(Elapsed time depends highly on the options you selected)</comment>
real  3m51.962s
user  3m27.060s
sys   0m24.310s

livecd linux # <i>make modules_install</i>
livecd linux # <i>cp arch/i386/boot/bzImage /boot/kernel</i>
</pre>

</body>
</section>

<section>
 <include href="gentoo-x86-quickinstall-system.xml"/>
</section>

<section id="reboot">
<title>Reboot</title>
<body>

<p>
Exit the chrooted environment, unmount all file systems and reboot:
</p>

<pre caption="Reboot">
livecd conf.d # <i>exit</i>
livecd / # <i>umount /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo/boot /mnt/gentoo</i>
livecd / # <i>reboot</i>
<comment>(Don't forget to remove the CD)</comment>
</pre>

</body>
</section>

<section>
 <include href="gentoo-x86-quickinstall-after-reboot.xml"/>
</section>

</chapter>
</guide>
1	swift	1.1	<?xml version='1.0' encoding="UTF-8"?>
2	neysx	1.83	<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.82 2009/01/09 18:12:12 neysx Exp $ -->
3	swift	1.8
4			<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5
6	neysx	1.80	<guide lang="en">
7	neysx	1.31	<title>Gentoo Linux x86 Quick Install Guide</title>
8	swift	1.38
9	neysx	1.80	<values>
10			<key id="raid+lvm">no</key>
11			<key id="root">/dev/sda3</key>
12			</values>
13
14	swift	1.38	<author title="Author">
15	neysx	1.80	<mail link="neysx"/>
16	neysx	1.52	</author>
17			<author title="Author">
18	neysx	1.80	<mail link="swift"/>
19	swift	1.1	</author>
20	swift	1.38	<author title="Author">Steven Wagner</author>
21	swift	1.1
22			<abstract>
23	neysx	1.52	The Quick install guide covers the Gentoo install process in a non-verbose
24			manner. Its purpose is to allow users to perform a stage3 install in no time.
25			Users should already have prior experience with installing Gentoo Linux if they
26			want to follow this guide.
27	swift	1.2	</abstract>
28
29	swift	1.44	<!-- The content of this document is licensed under the CC-BY-SA license -->
30			<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
31	swift	1.1	<license/>
32	swift	1.2
33	neysx	1.83	<version>24</version>
34			<date>2009-03-13</date>
35	neysx	1.52
36			<chapter>
37			<title>Introduction</title>
38			<section>
39			<body>
40
41			<p>
42			This guide contains all commands you should use to complete a stage3
43			installation of Gentoo. You need a connection to the Internet to download the
44			stage3 and Portage snapshots.
45			</p>
46
47			<p>
48	jkt	1.79	New users should read the <uri link="/doc/en/handbook/index.xml">Handbook</uri>
49	neysx	1.80	as it gives a better overview about the installation process.
50	jkt	1.79	</p>
51
52			<p>
53	neysx	1.52	Timing output follows all commands that take more than a couple of seconds to
54	nightmorph	1.63	finish. Commands were timed on an AMD 2000 1.66 Ghz PC with 512 MB of RAM and
55	neysx	1.52	two SATA disks connected to a hardware controller.
56			</p>
57
58			<pre caption="Test box specs">
59			<comment>(The following specs and the timing information should help you determine
60			a rough estimate of the time you need to complete your install)</comment>
61
62			# <i>grep bogo /proc/cpuinfo</i>
63	rane	1.55	bogomips : 3337.81
64	neysx	1.52
65			# <i>hdparm -tT /dev/sda</i>
66			/dev/sda:
67			Timing cached reads: 1100 MB in 2.00 seconds = 549.97 MB/sec
68			Timing buffered disk reads: 224 MB in 3.01 seconds = 74.36 MB/sec
69
70			# <i>grep MemTotal /proc/meminfo</i>
71			MemTotal: 509248 kB
72			</pre>
73
74			</body>
75			</section>
76			</chapter>
77	swift	1.1
78			<chapter>
79	neysx	1.31	<title>Quick Install Guide</title>
80	swift	1.38
81	neysx	1.52	<section>
82	neysx	1.80	<include href="gentoo-x86-quickinstall-media.xml"/>
83	swift	1.38	</section>
84	neysx	1.52
85	swift	1.38	<section>
86			<title>Preparing the Disks</title>
87			<body>
88
89			<p>
90			Use <c>fdisk</c> or <c>cfdisk</c> to create your partition layout. You need at
91	neysx	1.52	least a swap partition (type 82) and one Linux partition (type 83). The
92	neysx	1.82	following scenario creates a <path>/boot</path>, a swap and a main partition as
93			used in our handbook. Replace <path>sda</path> with your disk. Most systems
94			ignore the bootable flag, but a few need it. Set this flag on your boot
95			partition with fdisk's <c>a</c> command.
96	neysx	1.52	</p>
97
98			<pre caption="Create the partitions">
99			livecd ~ # <i>fdisk /dev/sda</i>
100
101			<comment>(The rest of this guide uses the following partitioning scheme)</comment>
102			livecd ~ # <i>fdisk -l /dev/sda</i>
103
104			Disk /dev/sda: 599.9 GB, 599978409984 bytes
105			255 heads, 63 sectors/track, 72943 cylinders
106			Units = cylinders of 16065 * 512 = 8225280 bytes
107
108			Device Boot Start End Blocks Id System
109	neysx	1.82	/dev/sda1 * 1 12 96358+ 83 Linux
110	neysx	1.52	/dev/sda2 13 110 787185 82 Linux swap / Solaris
111			/dev/sda3 111 72943 585031072+ 83 Linux
112			</pre>
113	swift	1.38
114			<p>
115			Use <c>mke2fs</c>, <c>mke2fs -j</c>, <c>mkreiserfs</c>, <c>mkfs.xfs</c> and
116	swift	1.44	<c>mkfs.jfs</c> to create file systems on your Linux partitions. Initialize your
117	swift	1.38	swap partition using <c>mkswap</c> and <c>swapon</c>.
118			</p>
119
120	neysx	1.52	<pre caption="Create the file systems and activate swap">
121			<comment>(ext2 is all you need on the /boot partition)</comment>
122			livecd ~ # <i>mke2fs /dev/sda1</i>
123
124			<comment>(Let's use ext3 on the main partition)</comment>
125	nightmorph	1.74	livecd ~ # <i>mke2fs -j /dev/sda3</i>
126	neysx	1.52
127			<comment>(Create and activate swap)</comment>
128			livecd ~ # <i>mkswap /dev/sda2 && swapon /dev/sda2</i>
129			</pre>
130
131	swift	1.38	<p>
132			Mount the freshly created file systems on <path>/mnt/gentoo</path>. Create
133			directories for the other mount points (like <path>/mnt/gentoo/boot</path>) if
134	neysx	1.52	you need them and mount them too.
135	swift	1.38	</p>
136
137	neysx	1.52	<pre caption="Mount the file systems">
138			livecd ~ # <i>mount /dev/sda3 /mnt/gentoo</i>
139			livecd ~ # <i>mkdir /mnt/gentoo/boot</i>
140			livecd ~ # <i>mount /dev/sda1 /mnt/gentoo/boot</i>
141			livecd ~ # <i>cd /mnt/gentoo</i>
142			</pre>
143
144			</body>
145			</section>
146
147	swift	1.38	<section>
148	neysx	1.80	<include href="gentoo-x86-quickinstall-stage.xml"/>
149	neysx	1.52	</section>
150	swift	1.1
151	swift	1.38	<section>
152			<title>Kernel Configuration</title>
153			<body>
154
155	swift	1.1	<p>
156	nightmorph	1.69	Install a kernel source (usually <c>gentoo-sources</c>), configure it, compile
157			it and copy the <path>arch/i386/boot/bzImage</path> file to <path>/boot</path>.
158	neysx	1.52	</p>
159
160			<pre caption="Install a kernel source, compile it and install the kernel">
161	neysx	1.61	livecd etc # <i>time emerge gentoo-sources</i>
162	neysx	1.52
163			real 2m51.435s
164			user 0m58.220s
165			sys 0m29.890s
166	neysx	1.61	livecd etc # <i>cd /usr/src/linux</i>
167	neysx	1.52	livecd linux # <i>make menuconfig</i>
168			<comment>(Configure your kernel)</comment>
169			livecd linux # <i>time make -j2</i>
170
171			<comment>(Elapsed time depends highly on the options you selected)</comment>
172			real 3m51.962s
173			user 3m27.060s
174			sys 0m24.310s
175	swift	1.38
176	neysx	1.52	livecd linux # <i>make modules_install</i>
177			livecd linux # <i>cp arch/i386/boot/bzImage /boot/kernel</i>
178			</pre>
179	swift	1.1
180	swift	1.38	</body>
181			</section>
182	swift	1.1
183	swift	1.38	<section>
184	neysx	1.80	<include href="gentoo-x86-quickinstall-system.xml"/>
185	swift	1.38	</section>
186	neysx	1.52
187			<section id="reboot">
188			<title>Reboot</title>
189			<body>
190
191			<p>
192			Exit the chrooted environment, unmount all file systems and reboot:
193			</p>
194
195			<pre caption="Reboot">
196			livecd conf.d # <i>exit</i>
197	neysx	1.83	livecd / # <i>umount /mnt/gentoo/dev /mnt/gentoo/proc /mnt/gentoo/boot /mnt/gentoo</i>
198	neysx	1.52	livecd / # <i>reboot</i>
199			<comment>(Don't forget to remove the CD)</comment>
200			</pre>
201
202			</body>
203			</section>
204
205			<section>
206	neysx	1.80	<include href="gentoo-x86-quickinstall-after-reboot.xml"/>
207	swift	1.38	</section>
208	neysx	1.52
209	neysx	1.49	</chapter>
210	swift	1.1	</guide>