en/handbook/hb-install-ppc64-medium.xml

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE sections SYSTEM "/dtd/book.dtd">

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

<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.44 2011/11/27 18:17:23 swift Exp $ -->

<sections>

<abstract>
You can install Gentoo in many ways. This chapter explains how to install
Gentoo using the minimal Installation CD.
</abstract>

<version>13</version>
<date>2012-02-26</date>

<section>
<title>Hardware Requirements</title>
<subsection>
<title>Introduction</title>
<body>

<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box. 
</p>

</body>
</subsection>
<subsection>
<title>Hardware Requirements</title>
<body>

<table>
<tr>
  <th>CPU</th>
  <ti>Any PowerPC64 CPU</ti>
</tr>
<tr>
  <th>Systems</th>
  <ti>
    IBM RS/6000s, Power Macintosh G5, IBM pSeries and IBM iSeries
  </ti>
</tr>
<tr>
  <th>Memory</th>
  <ti>64 MB</ti>
</tr>
<tr>
  <th>Diskspace</th>
  <ti>1.5 GB (excluding swap space)</ti>
</tr>
<tr>
  <th>Swap space</th>
  <ti>At least 256 MB</ti>
</tr>
</table>

<p>
For a full list of supported systems, please go to 
<uri>http://penguinppc.org/about/intro.php#hardware</uri>.
</p>

</body>
</subsection>
</section>

<!-- START -->
<section>
<title>The Gentoo Installation CDs</title>
<subsection>
<title>Introduction</title>
<body>

<p>
The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
self-sustained Gentoo environment. They allow you to boot Linux from the CD.
During the boot process your hardware is detected and the appropriate drivers
are loaded. They are maintained by Gentoo developers.
</p>

<p>
All Installation CDs allow you to boot, set up networking, initialize your
partitions and start installing Gentoo from the Internet.
</p>
<!--
<p>
If you wish to install Gentoo without a working Internet connection, please use
the installation instructions described in the <uri
link="2008.0/index.xml">Gentoo 2008.0 Handbooks</uri>.
</p>

<p>
The two Installation CDs that we currently provide are:
</p>

<ul>
  <li>
    The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
    CD which sole purpose is to boot the system, prepare the networking and
    continue with the Gentoo installation.
  </li>
  <li>
    The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
    abilities as the Minimal Installation CD. Additionally, it contains
    several stage3 tarballs (optimized for the individual subarchitectures).
  </li>
</ul>

<p>
To help you decide which Installation CD you need, we have written down the
major advantages and disadvantages of each Installation CD.
</p>
-->
</body>
</subsection>
<subsection>
<title>Gentoo Minimal Installation CD</title>
<body>

<p>
The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
takes up around <keyval id="min-cd-size"/> MB of diskspace. You can use this
Installation CD to install Gentoo, but <e>only</e> with a working Internet
connection.
</p>
<!--
<table>
<tr>
  <th>Minimal Installation CD</th>
  <th>Pros and Cons</th>
</tr>
<tr>
  <th>+</th>
  <ti>Smallest download</ti>
</tr>
<tr>
  <th>-</th>
  <ti>
    Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
    therefore not suitable for networkless installation
  </ti>
</tr>
</table>

</body>
</subsection>
<subsection>
<title>Gentoo's Universal Installation CD</title>
<body>

<p>
The Universal Installation CD is called
<c>install-ppc64-universal-2008.0.iso</c> and uses 460 MB. You can use
this Installation CD to install Gentoo, and you can even use it to install
Gentoo without a working internet connection.
</p>

<table>
<tr>
  <th>Universal Installation CD</th>
  <th>Pros and Cons</th>
</tr>
<tr>
  <th>+</th>
  <ti>
    Contains everything you need. You can even install without a network
    connection.
  </ti>
</tr>
<tr>
  <th>-</th>
  <ti>Huge download</ti>
</tr>
</table>
-->
</body>
</subsection>
<subsection>
<title>The Stage3 Tarball</title>
<body>

<p>
A stage3 tarball is an archive containing a minimal Gentoo environment,
suitable to continue the Gentoo installation using the instructions in this
manual. Previously, the Gentoo Handbook described the installation using one of
three stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
official installation method uses the stage3 tarball. If you are interested in
performing a Gentoo installation using a stage1 or stage2 tarball, please read
the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
Using a Stage1 or Stage2 Tarball?</uri>
</p>

<p>
Stage3 tarballs can be downloaded from <path><keyval
id="release-dir"/>current-stage3/</path> on any of the <uri
link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
on the LiveCD.
</p>

</body>
</subsection>
<subsection>
<title>Choosing a userland</title>
<body>

<p>
On PPC64, the kernel is 64-bit and the <e>userland</e> can be 32-bit or 64-bit.
The userland is basically the applications you are running, such as <c>bash</c>
or <c>firefox</c>. They can be compiled and run in either 64-bit or
32-bit modes. The Gentoo/PPC64 team provides both 32-bit and 64-bit userlands,
so which one should you use?
</p>

<p>
You may have heard that 64-bit applications are better, but in fact, 32-bit
applications take up slightly less memory and often run a little bit faster than
64-bit applications.
</p>

<p>
You really only need 64-bit applications when you need more memory than a 32-bit
userland allows, or if you do a lot of 64-bit number crunching. If you have 4GB
or more of memory or you run scientific applications, you should choose the
64-bit userland. Otherwise, choose the 32-bit userland, as it is recommended by
the Gentoo/PPC64 developers.
</p>

<p>
Additionally, the 32-bit userland has been available in Portage longer than the
64-bit userland has. This means that there are more applications tested in the
32-bit userland that just work "out of the box." Many applications compiled for
the 64-bit userland may be just as stable as the 32-bit version, but they
haven't been tested yet. Though testing isn't difficult to do, it can be
annoying and time consuming if you want to use many untested 64-bit
applications. Also, some programs just won't run in the 64-bit userland until
their code is fixed, such as OpenOffice.
</p>

</body>
</subsection>
</section>
<!-- STOP -->
<section>
<title>Download, Burn and Boot a Gentoo Installation CD</title>
<subsection>
<title>Downloading and Burning the Installation CDs</title>
<body>

<p>
You have chosen to use a Gentoo Installation CD. We'll first start by 
downloading and burning the chosen Installation CD. We previously discussed the 
several available Installation CDs, but where can you find them? 
</p>

<p>
You can download any of the Installation CDs from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
the <path><keyval id="release-dir"/>current-iso/</path> directory.
</p>

<p>
Inside that directory you'll find ISO files. Those are full CD images
which you can write on a CD-R.
</p>

<p>
In case you wonder if your downloaded file is corrupted or not, you can check
its MD5 checksum and compare it with the MD5 checksum we provide (such as
<path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the MD5
checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
</p>

<p>
Another way to check the validity of the downloaded file is to use GnuPG to
verify the cryptographic signature that we provide (the file ending with
<path>.asc</path>). Download the signature file and obtain the public keys:
</p>

<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 96D8BF6D 2D182910 17072058</i>
</pre>

<p>
Now verify the signature:
</p>

<pre caption="Verify the files">
<comment>(Verify the cryptographic signature)</comment>
$ <i>gpg --verify &lt;downloaded iso.DIGESTS.asc&gt;</i>
<comment>(Verify the checksum)</comment>
$ <i>sha1sum -c &lt;downloaded iso.DIGESTS.asc&gt;</i>
</pre>

<p>
To burn the downloaded ISO(s), you have to select raw-burning. How you
do this is highly program-dependent. We will discuss <c>cdrecord</c> and
<c>K3B</c> here; more information can be found in our <uri
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
</p>

<ul>
  <li>
    With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso 
    file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's 
    device path).
  </li>
  <li>
    With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
    your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
  </li>
  <li>
    With Mac OS X Panther, launch <c>Disk Utility</c> from
    <path>Applications/Utilities</path>, select <c>Open</c> from the
    <c>Images</c> menu, select the mounted disk image in the main window and
    select <c>Burn</c> in the <c>Images</c> menu.
  </li>
  <li>
    With Mac OS X Jaguar, launch <c>Disk Copy</c> from
    <path>Applications/Utilities</path>, select <c>Burn Image</c> from the
    <c>File</c> menu, select the ISO and click the <c>Burn</c> button.
  </li>
</ul>

</body>
</subsection>
<subsection>
<title>Default: Booting the Installation CD on an Apple/IBM</title>
<body>

<p>
Place the Installation CD in the CD-ROM and reboot the system. Hold down the 
'C' key at bootup. You will be greeted by a friendly welcome message and a 
<e>boot:</e> prompt at the bottom of the screen.
</p>

<p>
You are also able to tweak some kernel options at this prompt. The following
table lists the available boot options you can add:
</p>

<table>
<tr>
  <th>Boot Option</th>
  <th>Description</th>
</tr>
<tr>
  <ti><c>video</c></ti>
  <ti>
    This option takes one of the following vendor-specific tags:
    <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c>, <c>nvidiafb</c>
    or <c>ofonly</c>. You can follow this tag with the resolution and
    refreshrate you want to use. For instance
    <c>video=radeonfb:1280x1024@75</c>. If you are uncertain what to choose,
    <c>ofonly</c> will most certainly work.
  </ti>
</tr>
<tr>
  <ti><c>nol3</c></ti>
  <ti>
    Disables level 3 cache on some powerbooks (needed for at least the 17")
  </ti>
</tr>
<tr>
  <ti><c>debug</c></ti>
  <ti>
    Enables verbose booting, spawns an initrd shell that can be used to debug
    the Installation CD
  </ti>
</tr>
<tr>
  <ti><c>sleep=X</c></ti>
  <ti>
    Wait X seconds before continuing; this can be needed by some very old SCSI
    CD-ROMs which don't speed up the CD quick enough
  </ti>
</tr>
<tr>
  <ti><c>bootfrom=X</c></ti>
  <ti>
    Boot from a different device
  </ti>
</tr>
<tr>
  <ti><c>dosshd</c></ti>
  <ti>Starts <c>sshd</c>. Useful for unattended installs.</ti>
</tr>
<tr>
  <ti><c>passwd=foo</c></ti>
  <ti>
    Sets whatever is after the = as the root password. Use with <c>dosshd</c>
    for remote installs.
  </ti>
</tr>
</table>

<p>
At this prompt, hit enter, and a complete Gentoo Linux environment will be
loaded from the CD. Continue with <uri link="#booted">And When You're
Booted...</uri>.
</p>

</body>
</subsection>
<subsection>
<title>IBM pSeries</title>
<body>

<p>
The CD should autoboot on your pSeries box, but sometimes it does not.  In that
case, you have to set up your cdrom as a bootable device in the multi-boot
menu. If you start your machine with a monitor and a keyboard attached, you can
reach the multi-boot menu pressing the F1 key on startup. But if you start your
machine using the serial console, then you have to press <c>1</c>. Press the
key when you see the beginning of the following line on the serial console:
</p>

<pre caption="Hit the '1' key when this line appears">
memory      keyboard     network      scsi      speaker
</pre>

<p>
The other option is to jump into Open Firmware and do it from there:
</p>

<ol>
  <li>
    Boot into Open Firmware: same procedure as getting into multi-boot
    (described a few lines above), but use F8 and 8 instead of F1 and 1.
  </li>
  <li>Run the command 0> boot cdrom:1,yaboot</li>
  <li>Stand back and enjoy!</li>
</ol>

<note>
If you get something like the following output, then Open Firmware isn't set up
correctly.  Please use the multi-boot option described above.
</note>

<pre caption="Output if Open Firmware is not set up correctly">
0 > boot cdrom:1,yaboot
 ok
0 >
</pre>

</body>
</subsection>
<subsection id="booted">
<title>And When You're Booted...</title>
<body>

<p>
You will be greeted by a root ("#") prompt on the current console. You can also 
switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get 
back to the one you started on by pressing Alt-fn-F1.
</p>

<p>
If you are installing Gentoo on a system with a non-US keyboard, use
<c>loadkeys</c> to load the keymap for your keyboard. To list the available
keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
</p>

<pre caption="Listing available keymaps">
<comment>(PPC uses x86 keymaps on most systems)</comment>
# <i>ls /usr/share/keymaps/i386</i>
</pre>

<p>
Now load the keymap of your choice:
</p>

<pre caption="Loading a keymap">
# <i>loadkeys be-latin1</i>
</pre>

<p>
Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
</p>

</body>
</subsection>

<subsection>
<include href="hb-install-bootconfig.xml"/>
</subsection>

</section>
</sections>
1	swift	1.1	<?xml version='1.0' encoding='UTF-8'?>
2			<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3
4			<!-- The content of this document is licensed under the CC-BY-SA license -->
5	jkt	1.28	<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6	swift	1.1
7	swift	1.45	<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.44 2011/11/27 18:17:23 swift Exp $ -->
8	swift	1.1
9			<sections>
10	swift	1.10
11	nightmorph	1.42	<abstract>
12			You can install Gentoo in many ways. This chapter explains how to install
13			Gentoo using the minimal Installation CD.
14			</abstract>
15
16	swift	1.45	<version>13</version>
17			<date>2012-02-26</date>
18	swift	1.10
19	swift	1.1	<section>
20			<title>Hardware Requirements</title>
21			<subsection>
22			<title>Introduction</title>
23			<body>
24
25			<p>
26			Before we start, we first list what hardware requirements you need to
27	swift	1.14	successfully install Gentoo on your box.
28	swift	1.1	</p>
29
30			</body>
31			</subsection>
32			<subsection>
33	swift	1.14	<title>Hardware Requirements</title>
34	swift	1.1	<body>
35
36	swift	1.14	<table>
37			<tr>
38			<th>CPU</th>
39			<ti>Any PowerPC64 CPU</ti>
40			</tr>
41			<tr>
42			<th>Systems</th>
43			<ti>
44	rane	1.23	IBM RS/6000s, Power Macintosh G5, IBM pSeries and IBM iSeries
45	swift	1.14	</ti>
46			</tr>
47			<tr>
48			<th>Memory</th>
49			<ti>64 MB</ti>
50			</tr>
51			<tr>
52			<th>Diskspace</th>
53			<ti>1.5 GB (excluding swap space)</ti>
54			</tr>
55			<tr>
56			<th>Swap space</th>
57			<ti>At least 256 MB</ti>
58			</tr>
59			</table>
60
61	swift	1.1	<p>
62	swift	1.14	For a full list of supported systems, please go to
63	nightmorph	1.40	<uri>http://penguinppc.org/about/intro.php#hardware</uri>.
64	swift	1.1	</p>
65
66			</body>
67			</subsection>
68			</section>
69	nightmorph	1.37
70	swift	1.14	<!-- START -->
71	swift	1.1	<section>
72	swift	1.17	<title>The Gentoo Installation CDs</title>
73	swift	1.1	<subsection>
74	swift	1.14	<title>Introduction</title>
75	swift	1.1	<body>
76
77			<p>
78	swift	1.17	The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
79	swift	1.1	self-sustained Gentoo environment. They allow you to boot Linux from the CD.
80			During the boot process your hardware is detected and the appropriate drivers
81			are loaded. They are maintained by Gentoo developers.
82			</p>
83
84			<p>
85	swift	1.17	All Installation CDs allow you to boot, set up networking, initialize your
86	nightmorph	1.42	partitions and start installing Gentoo from the Internet.
87	swift	1.14	</p>
88	nightmorph	1.42	<!--
89	swift	1.14	<p>
90	swift	1.15	If you wish to install Gentoo without a working Internet connection, please use
91	swift	1.14	the installation instructions described in the <uri
92	nightmorph	1.37	link="2008.0/index.xml">Gentoo 2008.0 Handbooks</uri>.
93	swift	1.1	</p>
94
95			<p>
96	neysx	1.27	The two Installation CDs that we currently provide are:
97			</p>
98
99			<ul>
100			<li>
101			The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
102			CD which sole purpose is to boot the system, prepare the networking and
103			continue with the Gentoo installation.
104			</li>
105			<li>
106			The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
107			abilities as the Minimal Installation CD. Additionally, it contains
108			several stage3 tarballs (optimized for the individual subarchitectures).
109			</li>
110			</ul>
111
112			<p>
113			To help you decide which Installation CD you need, we have written down the
114			major advantages and disadvantages of each Installation CD.
115	swift	1.1	</p>
116	nightmorph	1.42	-->
117	swift	1.1	</body>
118			</subsection>
119			<subsection>
120	nightmorph	1.42	<title>Gentoo Minimal Installation CD</title>
121	swift	1.1	<body>
122
123			<p>
124	nightmorph	1.42	The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
125	swift	1.45	takes up around <keyval id="min-cd-size"/> MB of diskspace. You can use this
126	nightmorph	1.42	Installation CD to install Gentoo, but <e>only</e> with a working Internet
127			connection.
128	swift	1.1	</p>
129	nightmorph	1.42	<!--
130	swift	1.1	<table>
131			<tr>
132	swift	1.17	<th>Minimal Installation CD</th>
133	swift	1.1	<th>Pros and Cons</th>
134			</tr>
135			<tr>
136			<th>+</th>
137			<ti>Smallest download</ti>
138			</tr>
139			<tr>
140			<th>-</th>
141			<ti>
142	swift	1.25	Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
143	swift	1.14	therefore not suitable for networkless installation
144	swift	1.1	</ti>
145			</tr>
146			</table>
147
148			</body>
149			</subsection>
150	swift	1.25	<subsection>
151	neysx	1.27	<title>Gentoo's Universal Installation CD</title>
152			<body>
153
154			<p>
155			The Universal Installation CD is called
156	nightmorph	1.37	<c>install-ppc64-universal-2008.0.iso</c> and uses 460 MB. You can use
157	fox2mike	1.29	this Installation CD to install Gentoo, and you can even use it to install
158	nightmorph	1.39	Gentoo without a working internet connection.
159	neysx	1.27	</p>
160
161			<table>
162			<tr>
163			<th>Universal Installation CD</th>
164			<th>Pros and Cons</th>
165			</tr>
166			<tr>
167			<th>+</th>
168			<ti>
169			Contains everything you need. You can even install without a network
170			connection.
171			</ti>
172			</tr>
173			<tr>
174			<th>-</th>
175			<ti>Huge download</ti>
176			</tr>
177			</table>
178	nightmorph	1.42	-->
179	neysx	1.27	</body>
180			</subsection>
181			<subsection>
182	swift	1.25	<title>The Stage3 Tarball</title>
183			<body>
184
185			<p>
186	nightmorph	1.42	A stage3 tarball is an archive containing a minimal Gentoo environment,
187			suitable to continue the Gentoo installation using the instructions in this
188			manual. Previously, the Gentoo Handbook described the installation using one of
189			three stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
190	swift	1.25	official installation method uses the stage3 tarball. If you are interested in
191			performing a Gentoo installation using a stage1 or stage2 tarball, please read
192			the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
193			Using a Stage1 or Stage2 Tarball?</uri>
194			</p>
195
196	nightmorph	1.42	<p>
197			Stage3 tarballs can be downloaded from <path><keyval
198			id="release-dir"/>current-stage3/</path> on any of the <uri
199			link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
200			on the LiveCD.
201			</p>
202
203	swift	1.25	</body>
204			</subsection>
205	nightmorph	1.33	<subsection>
206			<title>Choosing a userland</title>
207			<body>
208
209			<p>
210	nightmorph	1.42	On PPC64, the kernel is 64-bit and the <e>userland</e> can be 32-bit or 64-bit.
211			The userland is basically the applications you are running, such as <c>bash</c>
212			or <c>firefox</c>. They can be compiled and run in either 64-bit or
213			32-bit modes. The Gentoo/PPC64 team provides both 32-bit and 64-bit userlands,
214			so which one should you use?
215	nightmorph	1.33	</p>
216
217			<p>
218			You may have heard that 64-bit applications are better, but in fact, 32-bit
219			applications take up slightly less memory and often run a little bit faster than
220			64-bit applications.
221			</p>
222
223			<p>
224			You really only need 64-bit applications when you need more memory than a 32-bit
225	nightmorph	1.42	userland allows, or if you do a lot of 64-bit number crunching. If you have 4GB
226			or more of memory or you run scientific applications, you should choose the
227			64-bit userland. Otherwise, choose the 32-bit userland, as it is recommended by
228			the Gentoo/PPC64 developers.
229	nightmorph	1.33	</p>
230
231			<p>
232			Additionally, the 32-bit userland has been available in Portage longer than the
233			64-bit userland has. This means that there are more applications tested in the
234			32-bit userland that just work "out of the box." Many applications compiled for
235			the 64-bit userland may be just as stable as the 32-bit version, but they
236			haven't been tested yet. Though testing isn't difficult to do, it can be
237			annoying and time consuming if you want to use many untested 64-bit
238			applications. Also, some programs just won't run in the 64-bit userland until
239			their code is fixed, such as OpenOffice.
240			</p>
241
242			</body>
243			</subsection>
244	swift	1.1	</section>
245	swift	1.14	<!-- STOP -->
246	swift	1.1	<section>
247	swift	1.17	<title>Download, Burn and Boot a Gentoo Installation CD</title>
248	swift	1.1	<subsection>
249	swift	1.17	<title>Downloading and Burning the Installation CDs</title>
250	swift	1.1	<body>
251
252			<p>
253	swift	1.17	You have chosen to use a Gentoo Installation CD. We'll first start by
254			downloading and burning the chosen Installation CD. We previously discussed the
255			several available Installation CDs, but where can you find them?
256	swift	1.14	</p>
257
258			<p>
259	nightmorph	1.42	You can download any of the Installation CDs from one of our <uri
260			link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
261			the <path><keyval id="release-dir"/>current-iso/</path> directory.
262	swift	1.1	</p>
263
264			<p>
265	nightmorph	1.37	Inside that directory you'll find ISO files. Those are full CD images
266	swift	1.1	which you can write on a CD-R.
267			</p>
268
269			<p>
270	nightmorph	1.42	In case you wonder if your downloaded file is corrupted or not, you can check
271			its MD5 checksum and compare it with the MD5 checksum we provide (such as
272			<path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the MD5
273	swift	1.1	checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
274			link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
275			</p>
276
277			<p>
278	swift	1.14	Another way to check the validity of the downloaded file is to use GnuPG to
279			verify the cryptographic signature that we provide (the file ending with
280	swift	1.43	<path>.asc</path>). Download the signature file and obtain the public keys:
281	swift	1.1	</p>
282
283	swift	1.14	<pre caption="Obtaining the public key">
284	swift	1.44	$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 96D8BF6D 2D182910 17072058</i>
285	swift	1.1	</pre>
286
287			<p>
288	swift	1.14	Now verify the signature:
289	swift	1.1	</p>
290
291	nightmorph	1.42	<pre caption="Verify the files">
292			<comment>(Verify the cryptographic signature)</comment>
293			$ <i>gpg --verify <downloaded iso.DIGESTS.asc></i>
294			<comment>(Verify the checksum)</comment>
295			$ <i>sha1sum -c <downloaded iso.DIGESTS.asc></i>
296	swift	1.14	</pre>
297	swift	1.1
298			<p>
299			To burn the downloaded ISO(s), you have to select raw-burning. How you
300	swift	1.14	do this is highly program-dependent. We will discuss <c>cdrecord</c> and
301			<c>K3B</c> here; more information can be found in our <uri
302			link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
303	swift	1.1	</p>
304
305			<ul>
306			<li>
307	swift	1.14	With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
308			file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's
309	swift	1.16	device path).
310	swift	1.1	</li>
311			<li>
312	nightmorph	1.35	With K3B, select <c>Tools</c> > <c>Burn CD Image</c>. Then you can locate
313			your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
314	swift	1.1	</li>
315	swift	1.7	<li>
316			With Mac OS X Panther, launch <c>Disk Utility</c> from
317			<path>Applications/Utilities</path>, select <c>Open</c> from the
318			<c>Images</c> menu, select the mounted disk image in the main window and
319			select <c>Burn</c> in the <c>Images</c> menu.
320			</li>
321			<li>
322			With Mac OS X Jaguar, launch <c>Disk Copy</c> from
323			<path>Applications/Utilities</path>, select <c>Burn Image</c> from the
324			<c>File</c> menu, select the ISO and click the <c>Burn</c> button.
325			</li>
326	swift	1.1	</ul>
327
328			</body>
329			</subsection>
330			<subsection>
331	swift	1.17	<title>Default: Booting the Installation CD on an Apple/IBM</title>
332	swift	1.1	<body>
333
334			<p>
335	swift	1.17	Place the Installation CD in the CD-ROM and reboot the system. Hold down the
336			'C' key at bootup. You will be greeted by a friendly welcome message and a
337			<e>boot:</e> prompt at the bottom of the screen.
338	swift	1.1	</p>
339
340			<p>
341			You are also able to tweak some kernel options at this prompt. The following
342			table lists the available boot options you can add:
343			</p>
344
345			<table>
346			<tr>
347			<th>Boot Option</th>
348			<th>Description</th>
349			</tr>
350			<tr>
351			<ti><c>video</c></ti>
352			<ti>
353			This option takes one of the following vendor-specific tags:
354	nightmorph	1.32	<c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c>, <c>nvidiafb</c>
355			or <c>ofonly</c>. You can follow this tag with the resolution and
356	nightmorph	1.33	refreshrate you want to use. For instance
357			<c>video=radeonfb:1280x1024@75</c>. If you are uncertain what to choose,
358			<c>ofonly</c> will most certainly work.
359	swift	1.1	</ti>
360			</tr>
361			<tr>
362			<ti><c>nol3</c></ti>
363			<ti>
364	nightmorph	1.33	Disables level 3 cache on some powerbooks (needed for at least the 17")
365	swift	1.1	</ti>
366			</tr>
367			<tr>
368			<ti><c>debug</c></ti>
369			<ti>
370			Enables verbose booting, spawns an initrd shell that can be used to debug
371	swift	1.17	the Installation CD
372	swift	1.1	</ti>
373			</tr>
374			<tr>
375			<ti><c>sleep=X</c></ti>
376			<ti>
377			Wait X seconds before continuing; this can be needed by some very old SCSI
378			CD-ROMs which don't speed up the CD quick enough
379			</ti>
380			</tr>
381			<tr>
382			<ti><c>bootfrom=X</c></ti>
383			<ti>
384			Boot from a different device
385			</ti>
386			</tr>
387	nightmorph	1.37	<tr>
388			<ti><c>dosshd</c></ti>
389			<ti>Starts <c>sshd</c>. Useful for unattended installs.</ti>
390			</tr>
391			<tr>
392			<ti><c>passwd=foo</c></ti>
393			<ti>
394			Sets whatever is after the = as the root password. Use with <c>dosshd</c>
395			for remote installs.
396			</ti>
397			</tr>
398	swift	1.1	</table>
399
400			<p>
401			At this prompt, hit enter, and a complete Gentoo Linux environment will be
402			loaded from the CD. Continue with <uri link="#booted">And When You're
403			Booted...</uri>.
404			</p>
405
406			</body>
407			</subsection>
408			<subsection>
409			<title>IBM pSeries</title>
410			<body>
411
412			<p>
413	neysx	1.30	The CD should autoboot on your pSeries box, but sometimes it does not. In that
414			case, you have to set up your cdrom as a bootable device in the multi-boot
415			menu. If you start your machine with a monitor and a keyboard attached, you can
416			reach the multi-boot menu pressing the F1 key on startup. But if you start your
417			machine using the serial console, then you have to press <c>1</c>. Press the
418			key when you see the beginning of the following line on the serial console:
419	swift	1.1	</p>
420
421	neysx	1.30	<pre caption="Hit the '1' key when this line appears">
422			memory keyboard network scsi speaker
423			</pre>
424
425	swift	1.1	<p>
426	nightmorph	1.36	The other option is to jump into Open Firmware and do it from there:
427	swift	1.1	</p>
428	neysx	1.30
429			<ol>
430			<li>
431	nightmorph	1.36	Boot into Open Firmware: same procedure as getting into multi-boot
432	neysx	1.30	(described a few lines above), but use F8 and 8 instead of F1 and 1.
433			</li>
434			<li>Run the command 0> boot cdrom:1,yaboot</li>
435			<li>Stand back and enjoy!</li>
436			</ol>
437
438			<note>
439	nightmorph	1.36	If you get something like the following output, then Open Firmware isn't set up
440	neysx	1.30	correctly. Please use the multi-boot option described above.
441			</note>
442
443	nightmorph	1.36	<pre caption="Output if Open Firmware is not set up correctly">
444	neysx	1.30	0 > boot cdrom:1,yaboot
445			ok
446			0 >
447			</pre>
448	swift	1.1
449			</body>
450			</subsection>
451			<subsection id="booted">
452			<title>And When You're Booted...</title>
453			<body>
454
455			<p>
456			You will be greeted by a root ("#") prompt on the current console. You can also
457			switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get
458			back to the one you started on by pressing Alt-fn-F1.
459			</p>
460
461			<p>
462			If you are installing Gentoo on a system with a non-US keyboard, use
463			<c>loadkeys</c> to load the keymap for your keyboard. To list the available
464			keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
465			</p>
466
467			<pre caption="Listing available keymaps">
468	nightmorph	1.41	<comment>(PPC uses x86 keymaps on most systems)</comment>
469	swift	1.1	# <i>ls /usr/share/keymaps/i386</i>
470			</pre>
471
472			<p>
473			Now load the keymap of your choice:
474			</p>
475
476			<pre caption="Loading a keymap">
477			# <i>loadkeys be-latin1</i>
478			</pre>
479
480			<p>
481			Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
482			</p>
483
484			</body>
485			</subsection>
486
487			<subsection>
488	nightmorph	1.38	<include href="hb-install-bootconfig.xml"/>
489	swift	1.2	</subsection>
490	swift	1.1
491			</section>
492			</sections>