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.70 2012/06/29 15:57:32 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>14</version>
<date>2012-11-12</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 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>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 SHA-2 checksum and compare it with the SHA-2 checksum we provide (such as
<path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the SHA-2
checksum with the <c>sha512sum</c> tool under Linux/Unix or <uri
link="http://www.krylack.com/file-checksum-tool/">File Checksum Tool</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 whose
key ids can be found on the <uri link="/proj/en/releng/index.xml">release
engineering project site</uri>.
</p>

<pre caption="Obtaining the public key">
<comment>(... Substitute the key ids with those mentioned on the release engineering site ...)</comment>
$ <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>
</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>ppc32</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>ppc32</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>ppc32 video=ofonly</i>
</pre>

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