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.30 2006/03/16 21:40:32 neysx Exp $ -->

<sections>

<version>2.12</version>
<date>2006-04-18</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>
<!-- Copy/paste from hb-install-x86-medium.xml, with s/x86/ppc64/ -->
<!-- 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 equaly 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="2006.0/index.xml">Gentoo 2006.0 Handbooks</uri>. This is currently not
supported for the PPC64 architecture though.
</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-2006.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-2006.0-32ul.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, just in case you want to bring
Gentoo to another PC than the one you are currently installing Gentoo on :)
</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>
</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>releases/ppc/2006.0/ppc64/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-2006.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>CD</c> &gt; <c>Burn 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> 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>
</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 OpenFirmware and do it from there:
</p>

<ol>
  <li>
    Boot into OpenFirmware: 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 OpenFirmware isn't set up
correctly.  Please use the multi-boot option described above.
</note>

<pre caption="Output if OpenFirmware 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 id="hardware">
<title>Extra Hardware Configuration</title>
<body>

<p>
When the Installation CD boots, it tries to detect all your hardware devices and
loads the appropriate kernel modules to support your hardware. In the
vast majority of cases, it does a very good job. However, in some cases it may 
not auto-load the kernel 
modules you need. If the PCI auto-detection missed some of your system's 
hardware, you will have to load the appropriate kernel modules manually. 
</p>

<p>
In the next example we try to load the <c>8139too</c> module (support for 
certain kinds of network interfaces):
</p>

<pre caption="Loading kernel modules">
# <i>modprobe 8139too</i>
</pre>

</body>
</subsection>
<subsection>
<title>Optional: Tweaking Hard Disk Performance</title>
<body>

<p>
If you are an advanced user, you might want to tweak the IDE hard disk
performance using <c>hdparm</c>. With the <c>-tT</c> options you can
test the performance of your disk (execute it several times to get a
more precise impression):
</p>

<pre caption="Testing disk performance">
# <i>hdparm -tT /dev/hda</i>
</pre>

<p>
To tweak, you can use any of the following examples (or experiment
yourself) which use <path>/dev/hda</path> as disk (substitute with your
disk):
</p>

<pre caption="Tweaking hard disk performance">
<comment>Activate DMA:</comment>                                       # <i>hdparm -d 1 /dev/hda</i>
<comment>Activate DMA + Safe Performance-enhancing Options:</comment>  # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
</pre>

</body>
</subsection>
<subsection id="useraccounts">
<title>Optional: User Accounts</title>
<body>

<p>
If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change 
the root password.
</p>

<p>
To change the root password, use the <c>passwd</c> utility:
</p>

<pre caption="Changing the root password">
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>

<p>
To create a user account, we first enter their credentials, followed by
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
In the next example, we create a user called &quot;john&quot;.
</p>

<pre caption="Creating a user account">
# <i>useradd -m -G users john</i>
# <i>passwd john</i>
New password: <comment>(Enter john's password)</comment>
Re-enter password: <comment>(Re-enter john's password)</comment>
</pre>

<p>
You can change your user id from root to the newly created user by using
<c>su</c>:
</p>

<pre caption="Changing user id">
# <i>su - john</i>
</pre>

</body>
</subsection>
<subsection>
<title>Optional: Viewing Documentation while Installing</title>
<body>

<p>
If you want to view the Gentoo Handbook during the installation, make sure you
have created a user account (see <uri link="#useraccounts">Optional: User
Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in.
</p>

<p>
If you want to view the documentation on the CD you can immediately run
<c>links</c> to read it:
</p>

<pre caption="Viewing the on-CD documentation">
# <i>links /mnt/cdrom/docs/handbook/html/index.html</i>
</pre>

<p>
However, it is preferred that you use the online Gentoo Handbook as it will be
more recent than the one provided on the CD.
</p>

<pre caption="Viewing the Online Documentation">
# <i>links http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i>
</pre>

<p>
You can go back to your original terminal by pressing <c>Alt-F1</c>.
</p>

</body>
</subsection>
<subsection>
<title>Optional: Starting the SSH Daemon</title>
<body>

<p>
If you want to allow other users to access your computer during the
Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password 
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
</p>

<p>
To fire up the SSH daemon, execute the following command:
</p>

<pre caption="Starting the SSH daemon">
# <i>/etc/init.d/sshd start</i>
</pre>

<p>
To be able to use sshd, you first need to set up your networking. Continue with
the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
</p>

</body>
</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	fox2mike	1.31	<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.30 2006/03/16 21:40:32 neysx Exp $ -->
8	swift	1.1
9			<sections>
10	swift	1.10
11	neysx	1.30	<version>2.12</version>
12	fox2mike	1.31	<date>2006-04-18</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	swift	1.14	<!-- Copy/paste from hb-install-x86-medium.xml, with s/x86/ppc64/ -->
65			<!-- 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	swift	1.17	two Installation CDs which are equaly suitable to install Gentoo from, as long
83			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	fox2mike	1.29	link="2006.0/index.xml">Gentoo 2006.0 Handbooks</uri>. This is currently not
91	swift	1.14	supported for the PPC64 architecture though.
92	swift	1.1	</p>
93
94			<p>
95	neysx	1.27	The two Installation CDs that we currently provide are:
96			</p>
97
98			<ul>
99			<li>
100			The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
101			CD which sole purpose is to boot the system, prepare the networking and
102			continue with the Gentoo installation.
103			</li>
104			<li>
105			The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
106			abilities as the Minimal Installation CD. Additionally, it contains
107			several stage3 tarballs (optimized for the individual subarchitectures).
108			</li>
109			</ul>
110
111			<p>
112			To help you decide which Installation CD you need, we have written down the
113			major advantages and disadvantages of each Installation CD.
114	swift	1.1	</p>
115
116			</body>
117			</subsection>
118			<subsection>
119	swift	1.17	<title>Gentoo's Minimal Installation CD</title>
120	swift	1.1	<body>
121
122			<p>
123	swift	1.17	The Minimal Installation CD is called
124	fox2mike	1.29	<c>install-ppc64-minimal-2006.0.iso</c> and takes up only 124 MB of
125	swift	1.17	diskspace. You can use this Installation CD to install Gentoo, but always with a
126	swift	1.14	working Internet connection only.
127	swift	1.1	</p>
128
129			<table>
130			<tr>
131	swift	1.17	<th>Minimal Installation CD</th>
132	swift	1.1	<th>Pros and Cons</th>
133			</tr>
134			<tr>
135			<th>+</th>
136			<ti>Smallest download</ti>
137			</tr>
138			<tr>
139			<th>-</th>
140			<ti>
141	swift	1.25	Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
142	swift	1.14	therefore not suitable for networkless installation
143	swift	1.1	</ti>
144			</tr>
145			</table>
146
147			</body>
148			</subsection>
149	swift	1.25	<subsection>
150	neysx	1.27	<title>Gentoo's Universal Installation CD</title>
151			<body>
152
153			<p>
154			The Universal Installation CD is called
155	fox2mike	1.29	<c>install-ppc64-universal-2006.0-32ul.iso</c> and uses 460 MB. You can use
156			this Installation CD to install Gentoo, and you can even use it to install
157			Gentoo without a working internet connection, just in case you want to bring
158			Gentoo to another PC than the one you are currently installing Gentoo on :)
159	neysx	1.27	</p>
160
161			<table>
162			<tr>
163			<th>Universal Installation CD</th>
164			<th>Pros and Cons</th>
165			</tr>
166			<tr>
167			<th>+</th>
168			<ti>
169			Contains everything you need. You can even install without a network
170			connection.
171			</ti>
172			</tr>
173			<tr>
174			<th>-</th>
175			<ti>Huge download</ti>
176			</tr>
177			</table>
178
179			</body>
180			</subsection>
181			<subsection>
182	swift	1.25	<title>The Stage3 Tarball</title>
183			<body>
184
185			<p>
186			A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
187			to continue the Gentoo installation using the instructions in this manual.
188			Previously, the Gentoo Handbook described the installation using one of three
189			stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
190			official installation method uses the stage3 tarball. If you are interested in
191			performing a Gentoo installation using a stage1 or stage2 tarball, please read
192			the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
193			Using a Stage1 or Stage2 Tarball?</uri>
194			</p>
195
196			</body>
197			</subsection>
198	swift	1.1	</section>
199	swift	1.14	<!-- STOP -->
200	swift	1.1	<section>
201	swift	1.17	<title>Download, Burn and Boot a Gentoo Installation CD</title>
202	swift	1.1	<subsection>
203	swift	1.17	<title>Downloading and Burning the Installation CDs</title>
204	swift	1.1	<body>
205
206			<p>
207	swift	1.17	You have chosen to use a Gentoo Installation CD. We'll first start by
208			downloading and burning the chosen Installation CD. We previously discussed the
209			several available Installation CDs, but where can you find them?
210	swift	1.14	</p>
211
212			<p>
213	neysx	1.27	You can download any of the Installation CDs (and, if you want to, a Packages
214	swift	1.17	CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
215	neysx	1.27	Installation CDs are located in the
216	fox2mike	1.29	<path>releases/ppc/2006.0/ppc64/installcd</path> directory.
217	swift	1.1	</p>
218
219			<p>
220	neysx	1.26	Inside that directory you'll find ISO-files. Those are full CD images
221	swift	1.1	which you can write on a CD-R.
222			</p>
223
224			<p>
225	swift	1.14	In case you wonder if your downloaded file is corrupted or not, you can
226			check its MD5 checksum and compare it with the MD5 checksum we provide (such as
227	fox2mike	1.29	<path>install-ppc64-minimal-2006.0.iso.DIGESTS</path>). You can check the MD5
228	swift	1.1	checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
229			link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
230			</p>
231
232			<p>
233	swift	1.14	Another way to check the validity of the downloaded file is to use GnuPG to
234			verify the cryptographic signature that we provide (the file ending with
235			<path>.asc</path>). Download the signature file and obtain the public key:
236	swift	1.1	</p>
237
238	swift	1.14	<pre caption="Obtaining the public key">
239	jkt	1.28	$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
240	swift	1.1	</pre>
241
242			<p>
243	swift	1.14	Now verify the signature:
244	swift	1.1	</p>
245
246	swift	1.14	<pre caption="Verify the cryptographic signature">
247			$ <i>gpg --verify <signature file> <downloaded iso></i>
248			</pre>
249	swift	1.1
250			<p>
251			To burn the downloaded ISO(s), you have to select raw-burning. How you
252	swift	1.14	do this is highly program-dependent. We will discuss <c>cdrecord</c> and
253			<c>K3B</c> here; more information can be found in our <uri
254			link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
255	swift	1.1	</p>
256
257			<ul>
258			<li>
259	swift	1.14	With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
260			file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's
261	swift	1.16	device path).
262	swift	1.1	</li>
263			<li>
264	swift	1.14	With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then
265	swift	1.1	you can locate your ISO file within the 'Image to Burn' area. Finally click
266			<c>Start</c>.
267			</li>
268	swift	1.7	<li>
269			With Mac OS X Panther, launch <c>Disk Utility</c> from
270			<path>Applications/Utilities</path>, select <c>Open</c> from the
271			<c>Images</c> menu, select the mounted disk image in the main window and
272			select <c>Burn</c> in the <c>Images</c> menu.
273			</li>
274			<li>
275			With Mac OS X Jaguar, launch <c>Disk Copy</c> from
276			<path>Applications/Utilities</path>, select <c>Burn Image</c> from the
277			<c>File</c> menu, select the ISO and click the <c>Burn</c> button.
278			</li>
279	swift	1.1	</ul>
280
281			</body>
282			</subsection>
283			<subsection>
284	swift	1.17	<title>Default: Booting the Installation CD on an Apple/IBM</title>
285	swift	1.1	<body>
286
287			<p>
288	swift	1.17	Place the Installation CD in the CD-ROM and reboot the system. Hold down the
289			'C' key at bootup. You will be greeted by a friendly welcome message and a
290			<e>boot:</e> prompt at the bottom of the screen.
291	swift	1.1	</p>
292
293			<p>
294			You are also able to tweak some kernel options at this prompt. The following
295			table lists the available boot options you can add:
296			</p>
297
298			<table>
299			<tr>
300			<th>Boot Option</th>
301			<th>Description</th>
302			</tr>
303			<tr>
304			<ti><c>video</c></ti>
305			<ti>
306			This option takes one of the following vendor-specific tags:
307			<c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or
308			<c>ofonly</c>. You can follow this tag with the resolution and refreshrate
309			you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are
310			uncertain what to choose, <c>ofonly</c> will most certainly work.
311			</ti>
312			</tr>
313			<tr>
314			<ti><c>nol3</c></ti>
315			<ti>
316			Disables level 3 cache on some powerbooks (needed for at least the 17'')
317			</ti>
318			</tr>
319			<tr>
320			<ti><c>debug</c></ti>
321			<ti>
322			Enables verbose booting, spawns an initrd shell that can be used to debug
323	swift	1.17	the Installation CD
324	swift	1.1	</ti>
325			</tr>
326			<tr>
327			<ti><c>sleep=X</c></ti>
328			<ti>
329			Wait X seconds before continuing; this can be needed by some very old SCSI
330			CD-ROMs which don't speed up the CD quick enough
331			</ti>
332			</tr>
333			<tr>
334			<ti><c>bootfrom=X</c></ti>
335			<ti>
336			Boot from a different device
337			</ti>
338			</tr>
339			</table>
340
341			<p>
342			At this prompt, hit enter, and a complete Gentoo Linux environment will be
343			loaded from the CD. Continue with <uri link="#booted">And When You're
344			Booted...</uri>.
345			</p>
346
347			</body>
348			</subsection>
349			<subsection>
350			<title>IBM pSeries</title>
351			<body>
352
353			<p>
354	neysx	1.30	The CD should autoboot on your pSeries box, but sometimes it does not. In that
355			case, you have to set up your cdrom as a bootable device in the multi-boot
356			menu. If you start your machine with a monitor and a keyboard attached, you can
357			reach the multi-boot menu pressing the F1 key on startup. But if you start your
358			machine using the serial console, then you have to press <c>1</c>. Press the
359			key when you see the beginning of the following line on the serial console:
360	swift	1.1	</p>
361
362	neysx	1.30	<pre caption="Hit the '1' key when this line appears">
363			memory keyboard network scsi speaker
364			</pre>
365
366	swift	1.1	<p>
367	neysx	1.30	The other option is to jump into OpenFirmware and do it from there:
368	swift	1.1	</p>
369	neysx	1.30
370			<ol>
371			<li>
372			Boot into OpenFirmware: same procedure as getting into multi-boot
373			(described a few lines above), but use F8 and 8 instead of F1 and 1.
374			</li>
375			<li>Run the command 0> boot cdrom:1,yaboot</li>
376			<li>Stand back and enjoy!</li>
377			</ol>
378
379			<note>
380			If you get something like the following output, then OpenFirmware isn't set up
381			correctly. Please use the multi-boot option described above.
382			</note>
383
384	fox2mike	1.31	<pre caption="Output if OpenFirmware is not set up correctly">
385	neysx	1.30	0 > boot cdrom:1,yaboot
386			ok
387			0 >
388			</pre>
389	swift	1.1
390			</body>
391			</subsection>
392			<subsection id="booted">
393			<title>And When You're Booted...</title>
394			<body>
395
396			<p>
397			You will be greeted by a root ("#") prompt on the current console. You can also
398			switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get
399			back to the one you started on by pressing Alt-fn-F1.
400			</p>
401
402			<p>
403			If you are installing Gentoo on a system with a non-US keyboard, use
404			<c>loadkeys</c> to load the keymap for your keyboard. To list the available
405			keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
406			</p>
407
408			<pre caption="Listing available keymaps">
409			<comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
410	swift	1.17	on the Installation CD are ADB keymaps and unusable with the
411			Installation CD kernel)</comment>
412	swift	1.1	# <i>ls /usr/share/keymaps/i386</i>
413			</pre>
414
415			<p>
416			Now load the keymap of your choice:
417			</p>
418
419			<pre caption="Loading a keymap">
420			# <i>loadkeys be-latin1</i>
421			</pre>
422
423			<p>
424			Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
425			</p>
426
427			</body>
428			</subsection>
429			<subsection id="hardware">
430			<title>Extra Hardware Configuration</title>
431			<body>
432
433			<p>
434	swift	1.17	When the Installation CD boots, it tries to detect all your hardware devices and
435	swift	1.1	loads the appropriate kernel modules to support your hardware. In the
436	swift	1.17	vast majority of cases, it does a very good job. However, in some cases it may
437			not auto-load the kernel
438	swift	1.1	modules you need. If the PCI auto-detection missed some of your system's
439			hardware, you will have to load the appropriate kernel modules manually.
440			</p>
441
442			<p>
443			In the next example we try to load the <c>8139too</c> module (support for
444			certain kinds of network interfaces):
445			</p>
446
447			<pre caption="Loading kernel modules">
448			# <i>modprobe 8139too</i>
449			</pre>
450
451			</body>
452			</subsection>
453			<subsection>
454			<title>Optional: Tweaking Hard Disk Performance</title>
455			<body>
456
457			<p>
458			If you are an advanced user, you might want to tweak the IDE hard disk
459			performance using <c>hdparm</c>. With the <c>-tT</c> options you can
460			test the performance of your disk (execute it several times to get a
461			more precise impression):
462			</p>
463
464			<pre caption="Testing disk performance">
465			# <i>hdparm -tT /dev/hda</i>
466			</pre>
467
468			<p>
469			To tweak, you can use any of the following examples (or experiment
470			yourself) which use <path>/dev/hda</path> as disk (substitute with your
471			disk):
472			</p>
473
474			<pre caption="Tweaking hard disk performance">
475			<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
476			<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
477			</pre>
478
479			</body>
480			</subsection>
481	swift	1.2	<subsection id="useraccounts">
482	swift	1.1	<title>Optional: User Accounts</title>
483			<body>
484
485			<p>
486			If you plan on giving other people access to your installation
487			environment or you want to chat using <c>irssi</c> without root privileges (for
488			security reasons), you need to create the necessary user accounts and change
489			the root password.
490			</p>
491
492			<p>
493			To change the root password, use the <c>passwd</c> utility:
494			</p>
495
496			<pre caption="Changing the root password">
497			# <i>passwd</i>
498			New password: <comment>(Enter your new password)</comment>
499			Re-enter password: <comment>(Re-enter your password)</comment>
500			</pre>
501
502			<p>
503			To create a user account, we first enter their credentials, followed by
504			its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
505			In the next example, we create a user called "john".
506			</p>
507
508			<pre caption="Creating a user account">
509	swift	1.8	# <i>useradd -m -G users john</i>
510	swift	1.1	# <i>passwd john</i>
511			New password: <comment>(Enter john's password)</comment>
512			Re-enter password: <comment>(Re-enter john's password)</comment>
513			</pre>
514
515			<p>
516			You can change your user id from root to the newly created user by using
517			<c>su</c>:
518			</p>
519
520			<pre caption="Changing user id">
521	swift	1.4	# <i>su - john</i>
522	swift	1.1	</pre>
523
524			</body>
525			</subsection>
526			<subsection>
527	swift	1.2	<title>Optional: Viewing Documentation while Installing</title>
528			<body>
529
530			<p>
531	neysx	1.20	If you want to view the Gentoo Handbook during the installation, make sure you
532			have created a user account (see <uri link="#useraccounts">Optional: User
533			Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in.
534	swift	1.2	</p>
535
536			<p>
537			If you want to view the documentation on the CD you can immediately run
538	fox2mike	1.29	<c>links</c> to read it:
539	swift	1.2	</p>
540
541			<pre caption="Viewing the on-CD documentation">
542	fox2mike	1.29	# <i>links /mnt/cdrom/docs/handbook/html/index.html</i>
543	swift	1.2	</pre>
544
545			<p>
546			However, it is preferred that you use the online Gentoo Handbook as it will be
547	neysx	1.20	more recent than the one provided on the CD.
548	swift	1.2	</p>
549
550			<pre caption="Viewing the Online Documentation">
551	fox2mike	1.29	# <i>links http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i>
552	swift	1.2	</pre>
553
554			<p>
555			You can go back to your original terminal by pressing <c>Alt-F1</c>.
556			</p>
557
558			</body>
559			</subsection>
560			<subsection>
561	swift	1.1	<title>Optional: Starting the SSH Daemon</title>
562			<body>
563
564			<p>
565			If you want to allow other users to access your computer during the
566			Gentoo installation (perhaps because those users are going to help you
567			install Gentoo, or even do it for you), you need to create a user
568			account for them and perhaps even provide them with your root password
569			(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
570			</p>
571
572			<p>
573			To fire up the SSH daemon, execute the following command:
574			</p>
575
576			<pre caption="Starting the SSH daemon">
577			# <i>/etc/init.d/sshd start</i>
578			</pre>
579
580			<p>
581	swift	1.6	To be able to use sshd, you first need to set up your networking. Continue with
582	swift	1.1	the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
583			</p>
584
585			</body>
586			</subsection>
587			</section>
588			</sections>