/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml
Gentoo

Contents of /xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.26 - (show annotations) (download) (as text)
Mon Nov 21 16:38:19 2005 UTC (9 years, 1 month ago) by neysx
Branch: MAIN
Changes since 1.25: +2 -2 lines
File MIME type: application/xml
#112511 Chapter 2, minor grammatical error

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

  ViewVC Help
Powered by ViewVC 1.1.20