en/handbook/hb-install-ppc-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-ppc-medium.xml,v 1.62 2009/08/05 15:25:23 nightmorph Exp $ -->

<sections>

<version>10.0</version>
<date>2010-07-20</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>Apple NewWorld Machines</th>
  <ti>
    Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
    PowerBook, Xserver, PowerMac
  </ti>
</tr>
<tr>
  <th>Apple OldWorld machines</th>
  <ti>
    Apple Machines with an Open Firmware revision less than 3, such as the Beige
    G3s, PCI PowerMacs and PCI PowerBooks. PCI-based Apple Clones should also
    be supported.
  </ti>
</tr>
<tr>
  <th>Genesi</th>
  <ti>
    Pegasos I/II, Open Desktop Workstation, Efika
  </ti>
</tr>
<tr>
  <th>IBM</th>
  <ti>
    RS/6000, iSeries, pSeries
  </ti>
</tr>
<tr>
  <th>Memory</th>
  <ti>At least 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>
Be sure to read the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri>
for help with some common installation related issues or if you're unsure as to
just what's in that PowerPC machine you've got sitting on your desk right now.
</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>

<!--
<impo>
If you wish to install Gentoo without a working Internet connection, or would
like to use one of the provided installers, please use the installation
instructions described in the <uri link="2008.0/">Gentoo 2008.0
Handbooks</uri>.
</impo>
-->
<!--
<p>
The 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 Universal Installation CD contains everything you need to install 
    Gentoo. It provides stage3 files for common architectures, source code 
    for the extra applications you need to choose from and, of course, the 
    installation instructions for your architecture.
  </li>
</ul>

<p>
Gentoo also provides a Package CD. This is not an Installation CD but an
additional resource that you can exploit during the installation of your Gentoo
system. It contains prebuilt packages (also known as the GRP set) that allow
you to easily and quickly install additional applications (such as
OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
right before you update your Portage tree.
</p>

<p>
The use of the Package CD is covered later in this document. 
</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 only <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>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>
</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 key:
</p>

<pre caption="Obtaining the public key">
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 2D182910</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>
</ul>

</body>
</subsection>
<subsection>
<title>Default: Booting the Installation CD with Yaboot</title>
<body>

<p>
On NewWorld machines place the Installation CD in the CD-ROM and reboot the 
system. When the system-start-bell sounds, simply hold down the 'C' until the
CD loads.
</p>

<p>
After the Installation CD loaded, you will be greeted by a friendly welcome 
message and a <e>boot:</e> prompt at the bottom of the screen.
</p>

<p>
We provide one generic kernel, <e>apple</e>. This kernel is built with support
for multiple CPUs, but it will boot on single processor machines as well.
</p>

<p>
You can tweak some kernel options at this prompt. The following table lists 
some of 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>nvidiafb</c>, <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, 
    <c>aty128</c> or <c>ofonly</c>. You can follow this tag with the resolution 
    refresh rate and color depth you want to use. For instance,
    <c>video=radeonfb:1280x1024@75-32</c> will select the ATI Radeon frame buffer
    at a resolution of 1280x1024 with a refresh rate of 75Hz and a color depth of
    32 bits. If you are uncertain what to choose, and the default doesn't work,
    <c>video=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&quot;)
  </ti>
</tr>
<tr>
  <ti><c>dofirewire</c></ti>
  <ti>
    Enables support for IEEE1394 (FireWire) devices, like external harddisks.
  </ti>
</tr>
<tr>
  <ti><c>dopcmcia</c></ti>
  <ti>
    If you want to use PCMCIA devices during your installation (like PCMCIA
    network cards) you have to enable this option.
  </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>
To use the above options, at the <e>boot:</e> prompt, type <e>apple</e> followed
by the desired option.  In the example below, we'll force the kernel to use the
Open Firmware framebuffer instead of the device specific driver.
</p>

<pre caption="Force the use of the Open Firmware framebuffer">
boot: <i>apple video=ofonly</i>
</pre>

<p>
If you don't need to add any options, just hit enter at this prompt, 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>Alternative: Booting the Installation CD on a Pegasos</title>
<body>

<p>
On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
<c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
between several preconfigured video configs. If you need any special boot
options you can append them to the command-line just like with Yaboot above. 
For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
The default kernel options (in case something goes wrong and you need it) are 
preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc 
looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>.
</p>

</body>
</subsection>

<subsection>
<title>Alternative: Booting the Installation CD with BootX</title>
<body>

<p>
If you have an OldWorld Mac the bootable portion of the livecd can't be used.
The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux
environment with a tool called BootX.  
</p>

<p>
First, download <uri link="http://penguinppc.org/bootloaders/bootx/">BootX</uri>
and unpack the archive.  Copy the the <c>BootX Extension</c> from the unpacked
archive into <c>Extensions Folder</c> and the BootX App Control Panel into
<c>Control Panels</c>, both of which are located in your MacOS System Folder.
Next, create a folder called "Linux Kernels" in your System folder and copy the
<c>apple</c> kernel from the CD to this folder.  Finally, copy <c>apple.igz</c> 
from the Installation CD <path>boot</path> folder into the MacOS 
<c>System Folder</c>.
</p>

<p>
To prepare BootX, start the BootX App Control Panel.  First select the Options
dialog and check <c>Use Specified RAM Disk</c> and select <c>apple.igz</c> from
your System Folder.  Continue back to the initial screen and ensure that the
ramdisk size is at least <c>32000</c>.  Finally, set the kernel arguments as
shown below:
</p>

<pre caption="BootX kernel arguments">
cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0 
</pre>

<note>
The kernel parameters in the yaboot section above are also applicable here. You
can append any of those options to the kernel arguments above.
</note>

<p>
Check once more to make sure the settings are correct and then save the 
configuration.  This saves typing just in case it doesn't boot or something is
missing.  Press the Linux button at the top of the window.  If everything goes
correctly, it should boot into the Installation CD. Continue with 
<uri link="#booted">And When You're Booted...</uri>
</p>

</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-F2, Alt-F3 and Alt-F4. Get 
back to the one you started on by pressing Alt-F1.  Due to the keyboard layout,
you may need to press Alt-fn-Fx on Apple machines.
</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	<?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	<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6
7	<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.62 2009/08/05 15:25:23 nightmorph Exp $ -->
8
9	<sections>
10
11	<version>10.0</version>
12	<date>2010-07-20</date>
13
14	<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	successfully install Gentoo on your box.
23	</p>
24
25	</body>
26	</subsection>
27	<subsection>
28	<title>Hardware Requirements</title>
29	<body>
30
31	<table>
32	<tr>
33	<th>Apple NewWorld Machines</th>
34	<ti>
35	Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
36	PowerBook, Xserver, PowerMac
37	</ti>
38	</tr>
39	<tr>
40	<th>Apple OldWorld machines</th>
41	<ti>
42	Apple Machines with an Open Firmware revision less than 3, such as the Beige
43	G3s, PCI PowerMacs and PCI PowerBooks. PCI-based Apple Clones should also
44	be supported.
45	</ti>
46	</tr>
47	<tr>
48	<th>Genesi</th>
49	<ti>
50	Pegasos I/II, Open Desktop Workstation, Efika
51	</ti>
52	</tr>
53	<tr>
54	<th>IBM</th>
55	<ti>
56	RS/6000, iSeries, pSeries
57	</ti>
58	</tr>
59	<tr>
60	<th>Memory</th>
61	<ti>At least 64 MB</ti>
62	</tr>
63	<tr>
64	<th>Diskspace</th>
65	<ti>1.5 GB (excluding swap space)</ti>
66	</tr>
67	<tr>
68	<th>Swap space</th>
69	<ti>At least 256 MB</ti>
70	</tr>
71	</table>
72
73	<p>
74	Be sure to read the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri>
75	for help with some common installation related issues or if you're unsure as to
76	just what's in that PowerPC machine you've got sitting on your desk right now.
77	</p>
78
79	</body>
80	</subsection>
81	</section>
82
83	<!-- START -->
84	<section>
85	<title>The Gentoo Installation CDs</title>
86	<subsection>
87	<title>Introduction</title>
88	<body>
89
90	<p>
91	The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
92	self-sustained Gentoo environment. They allow you to boot Linux from the CD.
93	During the boot process your hardware is detected and the appropriate drivers
94	are loaded. They are maintained by Gentoo developers.
95	</p>
96
97	<p>
98	All Installation CDs allow you to boot, set up networking, initialize your
99	partitions and start installing Gentoo from the Internet.
100	</p>
101
102	<!--
103	<impo>
104	If you wish to install Gentoo without a working Internet connection, or would
105	like to use one of the provided installers, please use the installation
106	instructions described in the <uri link="2008.0/">Gentoo 2008.0
107	Handbooks</uri>.
108	</impo>
109	-->
110	<!--
111	<p>
112	The Installation CDs that we currently provide are:
113	</p>
114
115	<ul>
116	<li>
117	The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
118	CD which sole purpose is to boot the system, prepare the networking and
119	continue with the Gentoo installation.
120	</li>
121	<li>
122	The Universal Installation CD contains everything you need to install
123	Gentoo. It provides stage3 files for common architectures, source code
124	for the extra applications you need to choose from and, of course, the
125	installation instructions for your architecture.
126	</li>
127	</ul>
128
129	<p>
130	Gentoo also provides a Package CD. This is not an Installation CD but an
131	additional resource that you can exploit during the installation of your Gentoo
132	system. It contains prebuilt packages (also known as the GRP set) that allow
133	you to easily and quickly install additional applications (such as
134	OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
135	right before you update your Portage tree.
136	</p>
137
138	<p>
139	The use of the Package CD is covered later in this document.
140	</p>
141	-->
142	</body>
143	</subsection>
144	<subsection>
145	<title>Gentoo Minimal Installation CD</title>
146	<body>
147
148	<p>
149	The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
150	takes up only <keyval id="min-cd-size"/> MB of diskspace. You can use this
151	Installation CD to install Gentoo, but <e>only</e> with a working Internet
152	connection.
153	</p>
154	<!--
155	<table>
156	<tr>
157	<th>Minimal Installation CD</th>
158	<th>Pros and Cons</th>
159	</tr>
160	<tr>
161	<th>+</th>
162	<ti>Smallest download</ti>
163	</tr>
164	<tr>
165	<th>-</th>
166	<ti>
167	Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and
168	is therefore not suitable for networkless installation
169	</ti>
170	</tr>
171	</table>
172	-->
173	</body>
174	</subsection>
175	<subsection>
176	<title>The Stage3 Tarball</title>
177	<body>
178
179	<p>
180	A stage3 tarball is an archive containing a minimal Gentoo environment,
181	suitable to continue the Gentoo installation using the instructions in this
182	manual. Previously, the Gentoo Handbook described the installation using one of
183	three stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
184	official installation method uses the stage3 tarball. If you are interested in
185	performing a Gentoo installation using a stage1 or stage2 tarball, please read
186	the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
187	Using a Stage1 or Stage2 Tarball?</uri>
188	</p>
189
190	<p>
191	Stage3 tarballs can be downloaded from <path><keyval
192	id="release-dir"/>current-stage3/</path> on any of the <uri
193	link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
194	on the LiveCD.
195	</p>
196
197	</body>
198	</subsection>
199	</section>
200
201
202	<!-- STOP -->
203	<section>
204	<title>Download, Burn and Boot a Gentoo Installation CD</title>
205	<subsection>
206	<title>Downloading and Burning the Installation CDs</title>
207	<body>
208
209	<p>
210	You have chosen to use a Gentoo Installation CD. We'll first start by
211	downloading and burning the chosen Installation CD. We previously discussed
212	the several available Installation CDs, but where can you find them?
213	</p>
214
215	<p>
216	You can download any of the Installation CDs from one of our <uri
217	link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
218	the <path><keyval id="release-dir"/>current-iso/</path> directory.
219	</p>
220
221	<p>
222	Inside that directory you'll find ISO files. Those are full CD images which you
223	can write on a CD-R.
224	</p>
225
226	<p>
227	In case you wonder if your downloaded file is corrupted or not, you can check
228	its MD5 checksum and compare it with the MD5 checksum we provide (such as
229	<path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the MD5
230	checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
231	link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
232	</p>
233
234	<p>
235	Another way to check the validity of the downloaded file is to use GnuPG to
236	verify the cryptographic signature that we provide (the file ending with
237	<path>.asc</path>). Download the signature file and obtain the public key:
238	</p>
239
240	<pre caption="Obtaining the public key">
241	$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 2D182910</i>
242	</pre>
243
244	<p>
245	Now verify the signature:
246	</p>
247
248	<pre caption="Verify the files">
249	<comment>(Verify the cryptographic signature)</comment>
250	$ <i>gpg --verify <downloaded iso.DIGESTS.asc></i>
251	<comment>(Verify the checksum)</comment>
252	$ <i>sha1sum -c <downloaded iso.DIGESTS.asc></i>
253	</pre>
254
255	<p>
256	To burn the downloaded ISO(s), you have to select raw-burning. How you
257	do this is highly program-dependent. We will discuss <c>cdrecord</c> and
258	<c>K3B</c> here; more information can be found in our <uri
259	link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
260	</p>
261
262	<ul>
263	<li>
264	With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
265	file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
266	path).
267	</li>
268	<li>
269	With K3B, select <c>Tools</c> > <c>Burn CD Image</c>. Then you can locate
270	your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
271	</li>
272	</ul>
273
274	</body>
275	</subsection>
276	<subsection>
277	<title>Default: Booting the Installation CD with Yaboot</title>
278	<body>
279
280	<p>
281	On NewWorld machines place the Installation CD in the CD-ROM and reboot the
282	system. When the system-start-bell sounds, simply hold down the 'C' until the
283	CD loads.
284	</p>
285
286	<p>
287	After the Installation CD loaded, you will be greeted by a friendly welcome
288	message and a <e>boot:</e> prompt at the bottom of the screen.
289	</p>
290
291	<p>
292	We provide one generic kernel, <e>apple</e>. This kernel is built with support
293	for multiple CPUs, but it will boot on single processor machines as well.
294	</p>
295
296	<p>
297	You can tweak some kernel options at this prompt. The following table lists
298	some of the available boot options you can add:
299	</p>
300
301	<table>
302	<tr>
303	<th>Boot Option</th>
304	<th>Description</th>
305	</tr>
306	<tr>
307	<ti><c>video</c></ti>
308	<ti>
309	This option takes one of the following vendor-specific tags:
310	<c>nvidiafb</c>, <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>,
311	<c>aty128</c> or <c>ofonly</c>. You can follow this tag with the resolution
312	refresh rate and color depth you want to use. For instance,
313	<c>video=radeonfb:1280x1024@75-32</c> will select the ATI Radeon frame buffer
314	at a resolution of 1280x1024 with a refresh rate of 75Hz and a color depth of
315	32 bits. If you are uncertain what to choose, and the default doesn't work,
316	<c>video=ofonly</c> will most certainly work.
317	</ti>
318	</tr>
319	<tr>
320	<ti><c>nol3</c></ti>
321	<ti>
322	Disables level 3 cache on some PowerBooks (needed for at least the 17")
323	</ti>
324	</tr>
325	<tr>
326	<ti><c>dofirewire</c></ti>
327	<ti>
328	Enables support for IEEE1394 (FireWire) devices, like external harddisks.
329	</ti>
330	</tr>
331	<tr>
332	<ti><c>dopcmcia</c></ti>
333	<ti>
334	If you want to use PCMCIA devices during your installation (like PCMCIA
335	network cards) you have to enable this option.
336	</ti>
337	</tr>
338	<tr>
339	<ti><c>dosshd</c></ti>
340	<ti>Starts <c>sshd</c>. Useful for unattended installs.</ti>
341	</tr>
342	<tr>
343	<ti><c>passwd=foo</c></ti>
344	<ti>
345	Sets whatever is after the = as the root password. Use with <c>dosshd</c>
346	for remote installs.
347	</ti>
348	</tr>
349	</table>
350
351	<p>
352	To use the above options, at the <e>boot:</e> prompt, type <e>apple</e> followed
353	by the desired option. In the example below, we'll force the kernel to use the
354	Open Firmware framebuffer instead of the device specific driver.
355	</p>
356
357	<pre caption="Force the use of the Open Firmware framebuffer">
358	boot: <i>apple video=ofonly</i>
359	</pre>
360
361	<p>
362	If you don't need to add any options, just hit enter at this prompt, and a
363	complete Gentoo Linux environment will be loaded from the CD. Continue with
364	<uri link="#booted">And When You're Booted...</uri>.
365	</p>
366
367	</body>
368	</subsection>
369	<subsection>
370	<title>Alternative: Booting the Installation CD on a Pegasos</title>
371	<body>
372
373	<p>
374	On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
375	<c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
376	between several preconfigured video configs. If you need any special boot
377	options you can append them to the command-line just like with Yaboot above.
378	For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
379	The default kernel options (in case something goes wrong and you need it) are
380	preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
381	looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>.
382	</p>
383
384	</body>
385	</subsection>
386
387	<subsection>
388	<title>Alternative: Booting the Installation CD with BootX</title>
389	<body>
390
391	<p>
392	If you have an OldWorld Mac the bootable portion of the livecd can't be used.
393	The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux
394	environment with a tool called BootX.
395	</p>
396
397	<p>
398	First, download <uri link="http://penguinppc.org/bootloaders/bootx/">BootX</uri>
399	and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
400	archive into <c>Extensions Folder</c> and the BootX App Control Panel into
401	<c>Control Panels</c>, both of which are located in your MacOS System Folder.
402	Next, create a folder called "Linux Kernels" in your System folder and copy the
403	<c>apple</c> kernel from the CD to this folder. Finally, copy <c>apple.igz</c>
404	from the Installation CD <path>boot</path> folder into the MacOS
405	<c>System Folder</c>.
406	</p>
407
408	<p>
409	To prepare BootX, start the BootX App Control Panel. First select the Options
410	dialog and check <c>Use Specified RAM Disk</c> and select <c>apple.igz</c> from
411	your System Folder. Continue back to the initial screen and ensure that the
412	ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
413	shown below:
414	</p>
415
416	<pre caption="BootX kernel arguments">
417	cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0
418	</pre>
419
420	<note>
421	The kernel parameters in the yaboot section above are also applicable here. You
422	can append any of those options to the kernel arguments above.
423	</note>
424
425	<p>
426	Check once more to make sure the settings are correct and then save the
427	configuration. This saves typing just in case it doesn't boot or something is
428	missing. Press the Linux button at the top of the window. If everything goes
429	correctly, it should boot into the Installation CD. Continue with
430	<uri link="#booted">And When You're Booted...</uri>
431	</p>
432
433	</body>
434	</subsection>
435
436	<subsection id="booted">
437	<title>And When You're Booted...</title>
438	<body>
439
440	<p>
441	You will be greeted by a root ("#") prompt on the current console. You can also
442	switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
443	back to the one you started on by pressing Alt-F1. Due to the keyboard layout,
444	you may need to press Alt-fn-Fx on Apple machines.
445	</p>
446
447	<p>
448	If you are installing Gentoo on a system with a non-US keyboard, use
449	<c>loadkeys</c> to load the keymap for your keyboard. To list the available
450	keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
451	</p>
452
453	<pre caption="Listing available keymaps">
454	<comment>(PPC uses x86 keymaps on most systems.)</comment>
455	# <i>ls /usr/share/keymaps/i386</i>
456	</pre>
457
458	<p>
459	Now load the keymap of your choice:
460	</p>
461
462	<pre caption="Loading a keymap">
463	# <i>loadkeys be-latin1</i>
464	</pre>
465
466	<p>
467	Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
468	</p>
469
470	</body>
471	</subsection>
472
473	<subsection>
474	<include href="hb-install-bootconfig.xml"/>
475	</subsection>
476
477	</section>
478	</sections>