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.38 2008/05/02 08:04:23 nightmorph Exp $ -->

<sections>

<version>9.2</version>
<date>2009-01-25</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://www.linuxppc64.org/hardware.shtml</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. We currently provide
two Installation CDs which are equally suitable to install Gentoo from, as long 
as you're planning on performing an Internet-based installation using the 
latest version of the available packages.
</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's Minimal Installation CD</title>
<body>

<p>
The Minimal Installation CD is called 
<c>install-ppc64-minimal-2008.0.iso</c> and takes up only 124 MB of 
diskspace. You can use this Installation CD to install Gentoo, but always with a
working Internet connection only.
</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>

</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>mozilla-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 run
applications that require more than 4GB 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>

<p>
The Gentoo/PPC64 team provides stages and Package CDs for both 32-bit and 64-bit
userlands, so no matter which one you choose, you'll be able to successfully
install Gentoo and get a full system up and running with minimal fuss.
</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 (and, if you want to, a Packages CD
as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
Installation CDs are located in the <path><keyval
id="release-dir"/>installcd</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>install-ppc64-minimal-2008.0.iso.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 key:
</p>

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

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

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