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

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

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.2 Revision 1.36
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.2 2004/08/08 10:12:39 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.36 2007/07/13 08:40:58 nightmorph Exp $ -->
8 8
9<sections> 9<sections>
10
11<version>8.1</version>
12<date>2007-06-29</date>
13
10<section> 14<section>
11<title>Hardware Requirements</title> 15<title>Hardware Requirements</title>
12<subsection> 16<subsection>
13<title>Introduction</title> 17<title>Introduction</title>
14<body> 18<body>
15 19
16<p> 20<p>
17Before we start, we first list what hardware requirements you need to 21Before we start, we first list what hardware requirements you need to
18successfully install Gentoo on your box. This of course depends on your 22successfully install Gentoo on your box.
19architecture.
20</p> 23</p>
21 24
22</body> 25</body>
23</subsection>
24<subsection> 26</subsection>
25<title>The PPC64 Architecture</title> 27<subsection>
28<title>Hardware Requirements</title>
26<body> 29<body>
27 30
28<p> 31<table>
29Check the following requirements before you continue with the Gentoo 32<tr>
30installation: 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
31</p> 56<p>
32 57For a full list of supported systems, please go to
33<ul>
34<li>
35 You need at least 1 Gb of free disk space
36</li>
37<li>
38 You need at least 300 Mb of memory (RAM + swap)
39</li>
40<li>
41 For the <e>PowerPC64 architecture</e>, you can install Gentoo/PPC64 on
42 machines having a PowerPC64 microprocessor, including IBM RS/6000s,
43 Power Macintosh G5 systems, IBM pSeries (and soon IBM iSeries) boxen.
44 For a full list go to <uri>http://www.linuxppc64.org/hardware.shtml</uri>. 58<uri>http://www.linuxppc64.org/hardware.shtml</uri>.
45</li> 59</p>
46</ul>
47 60
48</body> 61</body>
49</subsection> 62</subsection>
50</section> 63</section>
64<!-- Copy/paste from hb-install-x86-medium.xml, with s/x86/ppc64/ -->
65<!-- START -->
51<section> 66<section>
52<title>Make your Choice</title> 67<title>The Gentoo Installation CDs</title>
53<subsection> 68<subsection>
54<title>Introduction</title> 69<title>Introduction</title>
55<body> 70<body>
56 71
57<p> 72<p>
58Still interested in trying out Gentoo? Well, then it is now time to
59choose the installation medium you want to use. Yes, you have the
60choice, no, they are not all equal, and yes, the result is always the same: a
61Gentoo base system.
62</p>
63
64<p>
65The installation media we will describe are:
66</p>
67
68<ul>
69<li>Gentoo's Minimal LiveCD for Apple's G5</li>
70<li>Gentoo's Minimal LiveCD for IBM pSeries RS/6000</li>
71</ul>
72
73<p>
74As you can see there are no Universal CDs at the moment, but they will
75follow. The consequence of this is that you have to download the stages
76(see next paragraph) separately.
77</p>
78
79</body>
80</subsection>
81<subsection>
82<title>The Three Stages</title>
83<body>
84
85<p>
86Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
87The one you choose depends on how much of the system you want to compile
88yourself. The <e>stage1</e> tarball is used when you want to bootstrap and
89build the entire system from scratch. The <e>stage2</e> tarball is used for
90building the entire system from a bootstrapped &quot;semi-compiled&quot; state.
91The <e>stage3</e> tarball already contains a basic Gentoo Linux system that has
92been built for you. As we will explain later, you can also install
93Gentoo without compiling anything (except your kernel and some optional
94packages). If you want this, you have to use a <e>stage3</e> tarball.
95</p>
96
97<p>
98Now what stage do you have to choose?
99</p>
100
101<p>
102Starting from a <e>stage1</e> allows you to have total control over the
103optimization settings and optional build-time functionality that is
104initially enabled on your system. This makes <e>stage1</e> installs good for
105power users who know what they are doing. It is also a great
106installation method for those who would like to know more about the
107inner workings of Gentoo Linux.
108</p>
109
110<p>
111A <e>stage1</e> installation can only be performed when you have a working
112Internet connection.
113</p>
114
115<table>
116<tr>
117 <th>Stage1</th>
118 <th>Pros and Cons</th>
119</tr>
120<tr>
121 <th>+</th>
122 <ti>
123 Allows you to have total control over the optimization settings and optional
124 build-time functionality that is initially enabled on your system
125 </ti>
126</tr>
127<tr>
128 <th>+</th>
129 <ti>Suitable for powerusers that know what they are doing</ti>
130</tr>
131<tr>
132 <th>+</th>
133 <ti>Allows you to learn more about the inner workings of Gentoo</ti>
134</tr>
135<tr>
136 <th>-</th>
137 <ti>Takes a long time to finish the installation</ti>
138</tr>
139<tr>
140 <th>-</th>
141 <ti>
142 If you don't intend to tweak the settings, it is probably a waste of time
143 </ti>
144</tr>
145<tr>
146 <th>-</th>
147 <ti>
148 Not suitable for networkless installations
149 </ti>
150</tr>
151</table>
152
153<p>
154<e>Stage2</e> installs allow you to skip the bootstrap process and doing this
155is fine if you are happy with the optimization settings that we chose
156for your particular <e>stage2</e> tarball.
157</p>
158
159<p>
160A <e>stage2</e> installation can only be performed when you have a working
161Internet connection.
162</p>
163
164<table>
165<tr>
166 <th>Stage2</th>
167 <th>Pros and Cons</th>
168</tr>
169<tr>
170 <th>+</th>
171 <ti>You don't need to bootstrap</ti>
172</tr>
173<tr>
174 <th>+</th>
175 <ti>Faster than starting with stage1</ti>
176</tr>
177<tr>
178 <th>+</th>
179 <ti>You can still tweak your settings</ti>
180</tr>
181<tr>
182 <th>-</th>
183 <ti>You cannot tweak as much as with a stage1</ti>
184</tr>
185<tr>
186 <th>-</th>
187 <ti>It's not the fastest way to install Gentoo</ti>
188</tr>
189<tr>
190 <th>-</th>
191 <ti>You have to accept the optimizations we chose for the bootstrap</ti>
192</tr>
193<tr>
194 <th>-</th>
195 <ti>
196 Not suitable for networkless installations
197 </ti>
198</tr>
199</table>
200
201<p>
202Choosing to go with a <e>stage3</e> allows for the fastest install of Gentoo
203Linux, but also means that your base system will have the optimization
204settings that we chose for you (which to be honest, are good settings
205and were carefully chosen to enhance performance while maintaining
206stability). <e>stage3</e> is also required if you want to install Gentoo using
207prebuilt packages or without a network connection.
208</p>
209
210<table>
211<tr>
212 <th>Stage3</th>
213 <th>Pros and Cons</th>
214</tr>
215<tr>
216 <th>+</th>
217 <ti>Fastest way to get a Gentoo base system</ti>
218</tr>
219<tr>
220 <th>+</th>
221 <ti>Suitable for networkless installations</ti>
222</tr>
223<tr>
224 <th>-</th>
225 <ti>You cannot tweak the base system - it's built already</ti>
226</tr>
227<tr>
228 <th>-</th>
229 <ti>You cannot brag about having used stage1 or stage2</ti>
230</tr>
231</table>
232
233<p>
234Write down (or remember) what stage you want to use. You need this later when
235you decide what LiveCD (or other installation medium) you want to use. You might
236be interested to know that, if you decide to use different optimization settings
237after having installed Gentoo, you will be able to recompile your entire system
238with the new optimization settings.
239</p>
240
241<p>
242Now take a look at the available installation media.
243</p>
244
245</body>
246</subsection>
247<subsection>
248<title>Gentoo LiveCDs</title>
249<body>
250
251<p>
252The <e>Gentoo LiveCDs</e> are bootable CDs which contain a 73The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
253self-sustained Gentoo environment. They allow you to boot Linux from the CD. 74self-sustained Gentoo environment. They allow you to boot Linux from the CD.
254During the boot process your hardware is detected and the appropriate drivers 75During the boot process your hardware is detected and the appropriate drivers
255are loaded. They are maintained by Gentoo developers. 76are loaded. They are maintained by Gentoo developers.
256</p> 77</p>
257 78
258<p> 79<p>
259All LiveCDs allow you to boot, setup networking, initialize your 80All Installation CDs allow you to boot, set up networking, initialize your
260partitions and start installing Gentoo from the Internet. However, some 81partitions and start installing Gentoo from the Internet. We currently provide
261LiveCDs also contain all necessary source code so you are able to install 82two Installation CDs which are equally suitable to install Gentoo from, as long
262Gentoo without a working network configuration. 83as you're planning on performing an Internet-based installation using the
263</p> 84latest version of the available packages.
264
265<p> 85</p>
266Now what do these LiveCDs contain? 86
267</p> 87<p>
88If you wish to install Gentoo without a working Internet connection, please use
89the installation instructions described in the <uri
90link="2007.0/index.xml">Gentoo 2007.0 Handbooks</uri>.
91</p>
268 92
93<p>
94The two Installation CDs that we currently provide are:
95</p>
96
97<ul>
98 <li>
99 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
100 CD which sole purpose is to boot the system, prepare the networking and
101 continue with the Gentoo installation.
102 </li>
103 <li>
104 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
105 abilities as the Minimal Installation CD. Additionally, it contains
106 several stage3 tarballs (optimized for the individual subarchitectures).
107 </li>
108</ul>
109
110<p>
111To help you decide which Installation CD you need, we have written down the
112major advantages and disadvantages of each Installation CD.
113</p>
114
269</body> 115</body>
270</subsection>
271<subsection> 116</subsection>
117<subsection>
272<title>Gentoo's Minimal LiveCD</title> 118<title>Gentoo's Minimal Installation CD</title>
273<body> 119<body>
274 120
275<p> 121<p>
276This is a small, no-nonsense, bootable CD which sole purpose is to boot the 122The Minimal Installation CD is called
277system, prepare the networking and continue with the Gentoo installation. It 123<c>install-ppc64-minimal-2007.0.iso</c> and takes up only 124 MB of
278does not contain any stages (or, in some cases, a single stage1 file), 124diskspace. You can use this Installation CD to install Gentoo, but always with a
279source code or precompiled packages. For example the ppc variant of this 125working Internet connection only.
280LiveCD can be found in the <path>universal</path> subdirectory and is called
281<c>install-ppc-minimal-2004.1.iso</c>.
282</p> 126</p>
283 127
284<table> 128<table>
285<tr> 129<tr>
286 <th>Minimal LiveCD</th> 130 <th>Minimal Installation CD</th>
287 <th>Pros and Cons</th> 131 <th>Pros and Cons</th>
288</tr> 132</tr>
289<tr> 133<tr>
290 <th>+</th> 134 <th>+</th>
291 <ti>Smallest download</ti> 135 <ti>Smallest download</ti>
292</tr> 136</tr>
293<tr> 137<tr>
294 <th>+</th>
295 <ti>Suitable for a complete architecture</ti>
296</tr>
297<tr>
298 <th>+</th>
299 <ti>
300 You can do a stage1, stage2 or stage3 by getting the stage tarball off the
301 net
302 </ti>
303</tr>
304<tr>
305 <th>-</th> 138 <th>-</th>
306 <ti> 139 <ti>
307 Contains no stages, no portage snapshot, no GRP packages and therefore not 140 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
308 suitable for networkless installation 141 therefore not suitable for networkless installation
309 </ti> 142 </ti>
310</tr> 143</tr>
311</table> 144</table>
312 145
313</body> 146</body>
314</subsection> 147</subsection>
315<!--
316<subsection> 148<subsection>
317<title>Gentoo's Universal LiveCD (not available at the moment for 149<title>Gentoo's Universal Installation CD</title>
318PPC64)</title>
319<body> 150<body>
320 151
321<p>
322Gentoo's Universal LiveCD is a bootable CD suitable to install Gentoo without
323networking. It contains a stage1 and several stage3 tarballs (optimized for the
324individual subarchitectures). For example the ppc variant of this CD is called
325<c>install-ppc-universal-2004.1.iso</c> and can be found in the
326<path>universal</path> subdirectory.
327</p> 152<p>
328 153The Universal Installation CD is called
329<p> 154<c>install-ppc64-universal-2007.0.iso</c> and uses 460 MB. You can use
330If you take a closer look on our mirrors, you will see 155this Installation CD to install Gentoo, and you can even use it to install
331that we provide <e>Gentoo Package CDs</e>. This CD (which isn't 156Gentoo without a working internet connection, just in case you want to bring
332bootable) only contains precompiled packages and can be used to install software 157Gentoo to another PC than the one you are currently installing Gentoo on :)
333after a succesfull Gentoo Installation. To install Gentoo, you only
334need the Universal LiveCD, but if you want OpenOffice.org, Mozilla, KDE, GNOME
335etc. without having to compile every single one of them, you need the Packages
336CD too. For example the G4 (a subarchitecture of ppc) Packages CD is
337called <c>packages-g4-2004.1.iso</c> and can be found in the appropriate
338subdirectory (<path>g4/</path>).
339</p>
340
341<p>
342You only need the Packages CD if you want to perform a stage3 with GRP
343installation.
344</p> 158</p>
345 159
346<table> 160<table>
347<tr> 161<tr>
348 <th>Universal LiveCD with Packages CD</th> 162 <th>Universal Installation CD</th>
349 <th>Pros and Cons</th> 163 <th>Pros and Cons</th>
350</tr>
351<tr>
352 <th>+</th>
353 <ti>Packages CD is optimized to your architecture and subarchitecture</ti>
354</tr>
355<tr>
356 <th>+</th>
357 <ti>
358 Packages CD provides precompiled packages for fast Gentoo installations
359 </ti>
360</tr> 164</tr>
361<tr> 165<tr>
362 <th>+</th> 166 <th>+</th>
363 <ti> 167 <ti>
364 Contains everything you need. You can even install without a network 168 Contains everything you need. You can even install without a network
371</tr> 175</tr>
372</table> 176</table>
373 177
374</body> 178</body>
375</subsection> 179</subsection>
376--> 180<subsection>
181<title>The Stage3 Tarball</title>
182<body>
183
184<p>
185A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
186to continue the Gentoo installation using the instructions in this manual.
187Previously, the Gentoo Handbook described the installation using one of three
188stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
189official installation method uses the stage3 tarball. If you are interested in
190performing a Gentoo installation using a stage1 or stage2 tarball, please read
191the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
192Using a Stage1 or Stage2 Tarball?</uri>
193</p>
194
195</body>
196</subsection>
197<subsection>
198<title>Choosing a userland</title>
199<body>
200
201<p>
202On PPC64, the kernel is 64-bit and the <e>userland</e> can be 32-bit or 64-bit. The
203userland is basically the applications you are running, such as
204<c>bash</c> or <c>mozilla-firefox</c>. They can be compiled and run in either
20564-bit or 32-bit modes. The Gentoo/PPC64 team provides both 32-bit and 64-bit
206userlands, so which one should you use?
207</p>
208
209<p>
210You may have heard that 64-bit applications are better, but in fact, 32-bit
211applications take up slightly less memory and often run a little bit faster than
21264-bit applications.
213</p>
214
215<p>
216You really only need 64-bit applications when you need more memory than a 32-bit
217userland allows, or if you do a lot of 64-bit number crunching. If you run
218applications that require more than 4GB of memory or you run scientific
219applications, you should choose the 64-bit userland. Otherwise, choose the
22032-bit userland, as it is recommended by the Gentoo/PPC64 developers.
221</p>
222
223<p>
224Additionally, the 32-bit userland has been available in Portage longer than the
22564-bit userland has. This means that there are more applications tested in the
22632-bit userland that just work "out of the box." Many applications compiled for
227the 64-bit userland may be just as stable as the 32-bit version, but they
228haven't been tested yet. Though testing isn't difficult to do, it can be
229annoying and time consuming if you want to use many untested 64-bit
230applications. Also, some programs just won't run in the 64-bit userland until
231their code is fixed, such as OpenOffice.
232</p>
233
234<p>
235The Gentoo/PPC64 team provides stages and Package CDs for both 32-bit and 64-bit
236userlands, so no matter which one you choose, you'll be able to successfully
237install Gentoo and get a full system up and running with minimal fuss.
238</p>
239
240</body>
241</subsection>
377</section> 242</section>
243<!-- STOP -->
378<section> 244<section>
379<title>Download, Burn and Boot a Gentoo LiveCD</title> 245<title>Download, Burn and Boot a Gentoo Installation CD</title>
380<subsection> 246<subsection>
381<title>Downloading and Burning the LiveCDs</title> 247<title>Downloading and Burning the Installation CDs</title>
382<body> 248<body>
383 249
384<p>
385You have chosen to use a Gentoo LiveCD (if not, then you are reading the
386wrong section). We'll first start by downloading and burning the chosen
387LiveCD. We previously discussed the several available LiveCDs, but where can you
388find them?
389</p> 250<p>
390 251You have chosen to use a Gentoo Installation CD. We'll first start by
252downloading and burning the chosen Installation CD. We previously discussed the
253several available Installation CDs, but where can you find them?
391<p> 254</p>
392Visit one of our <uri 255
393link="/main/en/mirrors.xml">mirrors</uri> and go to 256<p>
394<path>experimental/ppc64/livecd</path>, which is 257You can download any of the Installation CDs (and, if you want to, a Packages CD
395the path where the LiveCD(s) of your choice are located. Inside that 258as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
259Installation CDs are located in the <path><keyval
260id="release-dir"/>installcd</path> directory.
261</p>
262
263<p>
396directory you'll find so-called ISO-files. Those are full CD images 264Inside that directory you'll find ISO-files. Those are full CD images
397which you can write on a CD-R. 265which you can write on a CD-R.
398</p> 266</p>
399 267
400<p> 268<p>
401In case you wonder if your downloaded file is corrupted or not, you can check 269In case you wonder if your downloaded file is corrupted or not, you can
402its MD5 checksum and compare it with the MD5 checksum we provide (such as 270check its MD5 checksum and compare it with the MD5 checksum we provide (such as
403<path>install-ppc64-minimal-2004.2.iso.md5</path>). You can check the MD5 271<path>install-ppc64-minimal-2007.0.iso.DIGESTS</path>). You can check the MD5
404checksum with the <c>md5sum</c> tool under Linux/Unix or <uri 272checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
405link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. 273link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
406</p> 274</p>
407 275
408<p> 276<p>
409As long as Mac OS X does not support <c>md5sum</c> you have to use the md5 277Another way to check the validity of the downloaded file is to use GnuPG to
410capability of <c>openssl</c>. 278verify the cryptographic signature that we provide (the file ending with
411</p> 279<path>.asc</path>). Download the signature file and obtain the public key:
412
413<pre caption="md5sum with the help of openssl">
414$ <i>openssl md5 /path/to/iso</i>
415<comment>(This could take some time depending on the size of the ISO and your CPU)</comment>
416</pre>
417
418<p> 280</p>
419Now compare this output with the appropriate file found on the server where you 281
420downloaded the ISO (the file will end with .md5). If it is the same, the ISO 282<pre caption="Obtaining the public key">
421image downloaded correctly. Be sure you have not mounted it (e.g. with Disk 283$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
422Copy) yet! 284</pre>
285
423</p> 286<p>
424 287Now verify the signature:
425<p> 288</p>
426More information is available in our <uri 289
427link="/doc/en/gentoo-ppc-faq.xml">Gentoo/PPC FAQ</uri>. 290<pre caption="Verify the cryptographic signature">
291$ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
428</p> 292</pre>
429 293
430<p> 294<p>
431To burn the downloaded ISO(s), you have to select raw-burning. How you 295To burn the downloaded ISO(s), you have to select raw-burning. How you
432do this is highly program-dependent. We will discuss <c>cdrecord</c> and 296do this is highly program-dependent. We will discuss <c>cdrecord</c> and
433<c>k3b</c> here; more information canb be found in our <uri 297<c>K3B</c> here; more information can be found in our <uri
434link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri> and the <uri 298link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
435link="/doc/en/gentoo-ppc-faq.xml">Gentoo/PPC FAQ</uri>.
436</p> 299</p>
437 300
438<ul> 301<ul>
439 <li> 302 <li>
440 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc</c> (replace 303 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
441 <path>/dev/hdc</path> with your CD-RW drive's device path) followed 304 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's
442 by the path to the ISO file :) 305 device path).
443 </li> 306 </li>
444 <li> 307 <li>
445 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then 308 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
446 you can locate your ISO file within the 'Image to Burn' area. Finally click 309 your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
447 <c>Start</c>. 310 </li>
311 <li>
312 With Mac OS X Panther, launch <c>Disk Utility</c> from
313 <path>Applications/Utilities</path>, select <c>Open</c> from the
314 <c>Images</c> menu, select the mounted disk image in the main window and
315 select <c>Burn</c> in the <c>Images</c> menu.
316 </li>
317 <li>
318 With Mac OS X Jaguar, launch <c>Disk Copy</c> from
319 <path>Applications/Utilities</path>, select <c>Burn Image</c> from the
320 <c>File</c> menu, select the ISO and click the <c>Burn</c> button.
448 </li> 321 </li>
449</ul> 322</ul>
450 323
451</body> 324</body>
452</subsection> 325</subsection>
453</section>
454<section> 326<subsection>
455<title>Booting the PPC LiveCD(s)</title> 327<title>Default: Booting the Installation CD on an Apple/IBM</title>
456<subsection>
457<title>Default: Apple/IBM</title>
458<body> 328<body>
459 329
460<p> 330<p>
461Place the LiveCD in the CD-ROM and reboot the system. Hold down the 'C' key at 331Place the Installation CD in the CD-ROM and reboot the system. Hold down the
462bootup (or run an OldWorld bootloader like BootX or quik). You will be greeted 332'C' key at bootup. You will be greeted by a friendly welcome message and a
463by a friendly welcome message and a <e>boot:</e> prompt at the bottom of the 333<e>boot:</e> prompt at the bottom of the screen.
464screen.
465</p> 334</p>
466 335
467<p> 336<p>
468You are also able to tweak some kernel options at this prompt. The following 337You are also able to tweak some kernel options at this prompt. The following
469table lists the available boot options you can add: 338table lists the available boot options you can add:
476</tr> 345</tr>
477<tr> 346<tr>
478 <ti><c>video</c></ti> 347 <ti><c>video</c></ti>
479 <ti> 348 <ti>
480 This option takes one of the following vendor-specific tags: 349 This option takes one of the following vendor-specific tags:
481 <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or 350 <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c>, <c>nvidiafb</c>
482 <c>ofonly</c>. You can follow this tag with the resolution and refreshrate 351 or <c>ofonly</c>. You can follow this tag with the resolution and
483 you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are 352 refreshrate you want to use. For instance
353 <c>video=radeonfb:1280x1024@75</c>. If you are uncertain what to choose,
484 uncertain what to choose, <c>ofonly</c> will most certainly work. 354 <c>ofonly</c> will most certainly work.
485 </ti> 355 </ti>
486</tr> 356</tr>
487<tr> 357<tr>
488 <ti><c>nol3</c></ti> 358 <ti><c>nol3</c></ti>
489 <ti> 359 <ti>
490 Disables level 3 cache on some powerbooks (needed for at least the 17'') 360 Disables level 3 cache on some powerbooks (needed for at least the 17")
491 </ti> 361 </ti>
492</tr> 362</tr>
493<tr> 363<tr>
494 <ti><c>debug</c></ti> 364 <ti><c>debug</c></ti>
495 <ti> 365 <ti>
496 Enables verbose booting, spawns an initrd shell that can be used to debug 366 Enables verbose booting, spawns an initrd shell that can be used to debug
497 the LiveCD 367 the Installation CD
498 </ti> 368 </ti>
499</tr> 369</tr>
500<tr> 370<tr>
501 <ti><c>sleep=X</c></ti> 371 <ti><c>sleep=X</c></ti>
502 <ti> 372 <ti>
523<subsection> 393<subsection>
524<title>IBM pSeries</title> 394<title>IBM pSeries</title>
525<body> 395<body>
526 396
527<p> 397<p>
528For pSeries boxes, sometimes the cds might not autoboot. You might have 398The CD should autoboot on your pSeries box, but sometimes it does not. In that
529to setup your cdrom as a bootable device in the multi-boot menu. (F1 at 399case, you have to set up your cdrom as a bootable device in the multi-boot
530startup) The other option is to jump into OF and do it from there: 400menu. If you start your machine with a monitor and a keyboard attached, you can
531</p> 401reach the multi-boot menu pressing the F1 key on startup. But if you start your
532 402machine using the serial console, then you have to press <c>1</c>. Press the
403key when you see the beginning of the following line on the serial console:
533<p> 404</p>
5341) Boot into OF (this is 8 from the serial cons or F8 from a graphics 405
535cons, start hitting the key when you see the keyboard mouse etc etc 406<pre caption="Hit the '1' key when this line appears">
536messages 407memory keyboard network scsi speaker
408</pre>
409
537</p> 410<p>
411The other option is to jump into Open Firmware and do it from there:
538<p> 412</p>
413
414<ol>
415 <li>
416 Boot into Open Firmware: same procedure as getting into multi-boot
417 (described a few lines above), but use F8 and 8 instead of F1 and 1.
418 </li>
5392) run the command 0> boot cdrom:1,yaboot 419 <li>Run the command 0> boot cdrom:1,yaboot</li>
420 <li>Stand back and enjoy!</li>
421</ol>
422
423<note>
424If you get something like the following output, then Open Firmware isn't set up
425correctly. Please use the multi-boot option described above.
426</note>
427
428<pre caption="Output if Open Firmware is not set up correctly">
4290 > boot cdrom:1,yaboot
430 ok
4310 >
540</p> 432</pre>
541<p>
5423) stand back and enjoy!
543</p>
544 433
545</body> 434</body>
546</subsection> 435</subsection>
547<subsection id="booted"> 436<subsection id="booted">
548<title>And When You're Booted...</title> 437<title>And When You're Booted...</title>
560keymaps, execute <c>ls /usr/share/keymaps/i386</c>. 449keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
561</p> 450</p>
562 451
563<pre caption="Listing available keymaps"> 452<pre caption="Listing available keymaps">
564<comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided 453<comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
565 on the LiveCD are ADB keymaps and unusable with the LiveCD kernel)</comment> 454 on the Installation CD are ADB keymaps and unusable with the
455 Installation CD kernel)</comment>
566# <i>ls /usr/share/keymaps/i386</i> 456# <i>ls /usr/share/keymaps/i386</i>
567</pre> 457</pre>
568 458
569<p> 459<p>
570Now load the keymap of your choice: 460Now load the keymap of your choice:
583<subsection id="hardware"> 473<subsection id="hardware">
584<title>Extra Hardware Configuration</title> 474<title>Extra Hardware Configuration</title>
585<body> 475<body>
586 476
587<p> 477<p>
588When the Live CD boots, it tries to detect all your hardware devices and 478When the Installation CD boots, it tries to detect all your hardware devices and
589loads the appropriate kernel modules to support your hardware. In the 479loads the appropriate kernel modules to support your hardware. In the vast
590vast majority of cases, it does a very good job. However, in some cases (the 480majority of cases, it does a very good job. However, in some cases it may not
591SPARC LiveCDs don't even do autodetection), it may not auto-load the kernel
592modules you need. If the PCI auto-detection missed some of your system's 481auto-load the kernel modules you need. If the PCI auto-detection missed some of
593hardware, you will have to load the appropriate kernel modules manually. 482your system's hardware, you will have to load the appropriate kernel modules
483manually.
594</p> 484</p>
595 485
596<p> 486<p>
597In the next example we try to load the <c>8139too</c> module (support for 487In the next example we try to load the <c>8139too</c> module (support for
598certain kinds of network interfaces): 488certain kinds of network interfaces):
624yourself) which use <path>/dev/hda</path> as disk (substitute with your 514yourself) which use <path>/dev/hda</path> as disk (substitute with your
625disk): 515disk):
626</p> 516</p>
627 517
628<pre caption="Tweaking hard disk performance"> 518<pre caption="Tweaking hard disk performance">
629<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i> 519<comment>Activate DMA:</comment>
630<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i> 520# <i>hdparm -d 1 /dev/hda</i>
521<comment>Activate DMA + Safe Performance-enhancing Options:</comment>
522# <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
631</pre> 523</pre>
632 524
633</body> 525</body>
634</subsection> 526</subsection>
635<subsection id="useraccounts"> 527<subsection id="useraccounts">
658its password. We use <c>useradd</c> and <c>passwd</c> for these tasks. 550its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
659In the next example, we create a user called &quot;john&quot;. 551In the next example, we create a user called &quot;john&quot;.
660</p> 552</p>
661 553
662<pre caption="Creating a user account"> 554<pre caption="Creating a user account">
663# <i>useradd john</i> 555# <i>useradd -m -G users john</i>
664# <i>passwd john</i> 556# <i>passwd john</i>
665New password: <comment>(Enter john's password)</comment> 557New password: <comment>(Enter john's password)</comment>
666Re-enter password: <comment>(Re-enter john's password)</comment> 558Re-enter password: <comment>(Re-enter john's password)</comment>
667</pre> 559</pre>
668 560
670You can change your user id from root to the newly created user by using 562You can change your user id from root to the newly created user by using
671<c>su</c>: 563<c>su</c>:
672</p> 564</p>
673 565
674<pre caption="Changing user id"> 566<pre caption="Changing user id">
675# <i>su john -</i> 567# <i>su - john</i>
676</pre> 568</pre>
677 569
678</body> 570</body>
679</subsection> 571</subsection>
680<subsection> 572<subsection>
681<title>Optional: Viewing Documentation while Installing</title> 573<title>Optional: Viewing Documentation while Installing</title>
682<body> 574<body>
683 575
684<p> 576<p>
685If you want to view the Gentoo Handbook (either from-CD or online) during the 577If you want to view the Gentoo Handbook during the installation, make sure you
686installation, make sure you have created a user account (see <uri 578have created a user account (see <uri link="#useraccounts">Optional: User
687link="#useraccouts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to 579Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in.
688go to a new terminal and log in.
689</p> 580</p>
690 581
691<p> 582<p>
692If you want to view the documentation on the CD you can immediately run 583If you want to view the documentation on the CD you can immediately run
693<c>links2</c> to read it: 584<c>links</c> to read it:
694</p> 585</p>
695 586
696<pre caption="Viewing the on-CD documentation"> 587<pre caption="Viewing the on-CD documentation">
697# <i>links2 /mnt/cdrom/docs/html/index.html</i> 588# <i>links /mnt/cdrom/docs/handbook/html/index.html</i>
698</pre> 589</pre>
699 590
700<p> 591<p>
701However, it is preferred that you use the online Gentoo Handbook as it will be 592However, it is preferred that you use the online Gentoo Handbook as it will be
702more recent than the one provided on the CD. You can view it using <c>links2</c> 593more recent than the one provided on the CD.
703as well, but only after having completed the <e>Configuring your Network</e>
704chapter (otherwise you won't be able to go on the Internet to view the
705document):
706</p> 594</p>
707 595
708<pre caption="Viewing the Online Documentation"> 596<pre caption="Viewing the Online Documentation">
709# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i> 597# <i>links http://www.gentoo.org/doc/en/handbook/<keyval id="online-book"/></i>
710</pre> 598</pre>
711 599
712<p> 600<p>
713You can go back to your original terminal by pressing <c>Alt-F1</c>. 601You can go back to your original terminal by pressing <c>Alt-F1</c>.
714</p> 602</p>
734<pre caption="Starting the SSH daemon"> 622<pre caption="Starting the SSH daemon">
735# <i>/etc/init.d/sshd start</i> 623# <i>/etc/init.d/sshd start</i>
736</pre> 624</pre>
737 625
738<p> 626<p>
739To be able to use sshd, you first need to setup your networking. Continue with 627To be able to use sshd, you first need to set up your networking. Continue with
740the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>. 628the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
741</p> 629</p>
742 630
743</body> 631</body>
744</subsection> 632</subsection>

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.36

  ViewVC Help
Powered by ViewVC 1.1.20