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

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

Parent Directory | Revision Log | View Patch Patch

Revision 1.29		Revision 1.68
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-ppc-medium.xml,v 1.29 2004/11/02 10:55:17 swift Exp $ -->	7	<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.68 2011/11/27 18:17:23 swift Exp $ -->
8		8
9	<sections>	9	<sections>
		10
		11	<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	<version>13</version>
		17	<date>2011-11-27</date>
		18
10	<section>	19	<section>
11	<title>Hardware Requirements</title>	20	<title>Hardware Requirements</title>
12	<subsection>	21	<subsection>
13	<title>Introduction</title>	22	<title>Introduction</title>
14	<body>	23	<body>
15		24
16	<p>	25	<p>
17	Before we start, we first list what hardware requirements you need to	26	Before we start, we first list what hardware requirements you need to
18	successfully install Gentoo on your box. This of course depends on your	27	successfully install Gentoo on your box.
19	architecture.
20	</p>	28	</p>
21		29
22	</body>	30	</body>
23	</subsection>
24	<subsection>	31	</subsection>
25	<title>The PPC Architecture</title>	32	<subsection>
		33	<title>Hardware Requirements</title>
26	<body>	34	<body>
27		35
28	<p>	36	<table>
29	Check the following requirements before you	37	<tr>
30	continue with the Gentoo installation:	38	<th>Apple NewWorld Machines</th>
		39	<ti>
		40	Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
		41	PowerBook, Xserver, PowerMac
		42	</ti>
		43	</tr>
		44	<tr>
		45	<th>Apple OldWorld machines</th>
		46	<ti>
		47	Apple Machines with an Open Firmware revision less than 3, such as the Beige
		48	G3s, PCI PowerMacs and PCI PowerBooks. PCI-based Apple Clones should also
		49	be supported.
		50	</ti>
		51	</tr>
		52	<tr>
		53	<th>Genesi</th>
		54	<ti>
		55	Pegasos I/II, Open Desktop Workstation, Efika
		56	</ti>
		57	</tr>
		58	<tr>
		59	<th>IBM</th>
		60	<ti>
		61	RS/6000, iSeries, pSeries
		62	</ti>
		63	</tr>
		64	<tr>
		65	<th>Memory</th>
		66	<ti>At least 64 MB</ti>
		67	</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
31	</p>	78	<p>
32
33	<ul>
34	<li>
35	You need at least 2 GB of free disk space
36	</li>
37	<li>
38	If you do not use prebuilt packages, you need at least 300 MB of memory (RAM +
39	swap), if you do use prebuilt packages you need at least 64 MB of memory to boot the system.
40	</li>
41	<li>
42	For the <e>PowerPC architecture</e>, you can install Gentoo/PPC on NewWorld machines
43	having a Power or PowerPC microprocessor, including but not limited to G3, G4
44	or G5 powered Apple computers such as the iMac, the eMac, the iBook, the PowerBook,
45	Xserve, PowerMac, and bPlan's Pegasos II. We also provide limited
46	support for OldWorld systems, IBM (RS/6000, iSeries, pSeries, ...) and Amiga
47	systems. Be sure to read up on the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo	79	Be sure to read the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri>
48	PPC FAQ</uri> before you begin.	80	for help with some common installation related issues or if you're unsure as to
49	</li>	81	just what's in that PowerPC machine you've got sitting on your desk right now.
50	</ul>	82	</p>
51		83
52	</body>	84	</body>
53	</subsection>	85	</subsection>
54	</section>	86	</section>
		87
		88	<!-- START -->
55	<section>	89	<section>
56	<title>Make your Choice</title>	90	<title>The Gentoo Installation CDs</title>
57	<subsection>	91	<subsection>
58	<title>Introduction</title>	92	<title>Introduction</title>
59	<body>	93	<body>
60		94
61	<p>	95	<p>
62	Still interested in trying out Gentoo? Well, then it is now time to
63	choose the installation medium you want to use. Yes, you have the
64	choice, no, they are not all equal, and yes, the result is always the same: a
65	Gentoo base system.
66	</p>
67
68	<p>
69	The installation media we will describe are:
70	</p>
71
72	<ul>
73	<li>Gentoo's Minimal LiveCD</li>
74	<li>Gentoo's Universal LiveCD</li>
75	</ul>
76
77	<p>
78	Every single media has its advantages and disadvantages. We will list
79	the pros and cons of every medium so you have all the information to
80	make a justified decision. But before we continue, let's explain our
81	three-stage installation.
82	</p>
83
84	</body>
85	</subsection>
86	<subsection>
87	<title>The Three Stages</title>
88	<body>
89
90	<p>
91	Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
92	The one you choose depends on how much of the system you want to compile
93	yourself. The <e>stage1</e> tarball is used when you want to bootstrap and
94	build the entire system from scratch. The <e>stage2</e> tarball is used for
95	building the entire system from a bootstrapped "semi-compiled" state.
96	The <e>stage3</e> tarball already contains a basic Gentoo Linux system that has
97	been built for you. As we will explain later, you can also install
98	Gentoo without compiling anything (except your kernel and some optional
99	packages). If you want this, you have to use a <e>stage3</e> tarball.
100	</p>
101
102	<p>
103	Now what stage do you have to choose?
104	</p>
105
106	<p>
107	Starting from a <e>stage1</e> allows you to have total control over the
108	optimization settings and optional build-time functionality that is
109	initially enabled on your system. This makes <e>stage1</e> installs good for
110	power users who know what they are doing. It is also a great
111	installation method for those who would like to know more about the
112	inner workings of Gentoo Linux.
113	</p>
114
115	<p>
116	A <e>stage1</e> installation can only be performed when you have a working
117	Internet connection.
118	</p>
119
120	<table>
121	<tr>
122	<th>Stage1</th>
123	<th>Pros and Cons</th>
124	</tr>
125	<tr>
126	<th>+</th>
127	<ti>
128	Allows you to have total control over the optimization settings and optional
129	build-time functionality that is initially enabled on your system
130	</ti>
131	</tr>
132	<tr>
133	<th>+</th>
134	<ti>Suitable for powerusers that know what they are doing</ti>
135	</tr>
136	<tr>
137	<th>+</th>
138	<ti>Allows you to learn more about the inner workings of Gentoo</ti>
139	</tr>
140	<tr>
141	<th>-</th>
142	<ti>Takes a long time to finish the installation</ti>
143	</tr>
144	<tr>
145	<th>-</th>
146	<ti>
147	If you don't intend to tweak the settings, it is probably a waste of time
148	</ti>
149	</tr>
150	<tr>
151	<th>-</th>
152	<ti>
153	Not suitable for networkless installations
154	</ti>
155	</tr>
156	</table>
157
158	<p>
159	<e>Stage2</e> installs allow you to skip the bootstrap process and doing this
160	is fine if you are happy with the optimization settings that we chose
161	for your particular <e>stage2</e> tarball.
162	</p>
163
164	<p>
165	A <e>stage2</e> installation can only be performed when you have a working
166	Internet connection.
167	</p>
168
169	<table>
170	<tr>
171	<th>Stage2</th>
172	<th>Pros and Cons</th>
173	</tr>
174	<tr>
175	<th>+</th>
176	<ti>You don't need to bootstrap</ti>
177	</tr>
178	<tr>
179	<th>+</th>
180	<ti>Faster than starting with stage1</ti>
181	</tr>
182	<tr>
183	<th>+</th>
184	<ti>You can still tweak your settings</ti>
185	</tr>
186	<tr>
187	<th>-</th>
188	<ti>You cannot tweak as much as with a stage1</ti>
189	</tr>
190	<tr>
191	<th>-</th>
192	<ti>It's not the fastest way to install Gentoo</ti>
193	</tr>
194	<tr>
195	<th>-</th>
196	<ti>You have to accept the optimizations we chose for the bootstrap</ti>
197	</tr>
198	<tr>
199	<th>-</th>
200	<ti>
201	Not suitable for networkless installations
202	</ti>
203	</tr>
204	</table>
205
206	<p>
207	Choosing to go with a <e>stage3</e> allows for the fastest install of Gentoo
208	Linux, but also means that your base system will have the optimization
209	settings that we chose for you (which to be honest, are good settings
210	and were carefully chosen to enhance performance while maintaining
211	stability). <e>stage3</e> is also required if you want to install Gentoo using
212	prebuilt packages or without a network connection.
213	</p>
214
215	<table>
216	<tr>
217	<th>Stage3</th>
218	<th>Pros and Cons</th>
219	</tr>
220	<tr>
221	<th>+</th>
222	<ti>Fastest way to get a Gentoo base system</ti>
223	</tr>
224	<tr>
225	<th>+</th>
226	<ti>Suitable for networkless installations</ti>
227	</tr>
228	<tr>
229	<th>-</th>
230	<ti>You cannot tweak the base system - it's built already</ti>
231	</tr>
232	<tr>
233	<th>-</th>
234	<ti>You cannot brag about having used stage1 or stage2</ti>
235	</tr>
236	</table>
237
238	<p>
239	Write down (or remember) what stage you want to use. You need this later when
240	you decide what LiveCD (or other installation medium) you want to use. You might
241	be interested to know that, if you decide to use different optimization settings
242	after having installed Gentoo, you will be able to recompile your entire system
243	with the new optimization settings.
244	</p>
245
246	<p>
247	Now take a look at the available installation media.
248	</p>
249
250	</body>
251	</subsection>
252	<subsection>
253	<title>Gentoo LiveCDs</title>
254	<body>
255
256	<note>
257	The Gentoo/PPC 2004.2 release is not official, so you will not find them on the
258	mirrors. All of our self-organised mirrors are currently down. The only chance
259	you can get the LiveCDs is via <uri
260	link="http://torrents.gentoo.org/torrents/">BitTorrent</uri>.
261	</note>
262
263	<note>
264	It is known that the Pegasos II will not boot the 2004.2 LiveCD. Please use the
265	2004.1 LiveCD.
266	</note>
267
268	<p>
269	The <e>Gentoo LiveCDs</e> are bootable CDs which contain a	96	The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
270	self-sustained Gentoo environment. They allow you to boot Linux from the CD.	97	self-sustained Gentoo environment. They allow you to boot Linux from the CD.
271	During the boot process your hardware is detected and the appropriate drivers	98	During the boot process your hardware is detected and the appropriate drivers
272	are loaded. They are maintained by Gentoo developers.	99	are loaded. They are maintained by Gentoo developers.
273	</p>	100	</p>
274		101
275	<p>	102	<p>
276	All LiveCDs allow you to boot, set up networking, initialize your	103	All Installation CDs allow you to boot, set up networking, initialize your
277	partitions and start installing Gentoo from the Internet. However, some	104	partitions and start installing Gentoo from the Internet.
278	LiveCDs also contain all necessary source code so you are able to install
279	Gentoo without a working network configuration.
280	</p>
281
282	<p>	105	</p>
283	Now what do these LiveCDs contain?	106
		107	<!--
		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	<!--
284	</p>	116	<p>
		117	The Installation CDs that we currently provide are:
		118	</p>
285		119
		120	<ul>
		121	<li>
		122	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	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	</li>
		132	</ul>
		133
		134	<p>
		135	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	</p>
		142
		143	<p>
		144	The use of the Package CD is covered later in this document.
		145	</p>
		146	-->
286	</body>	147	</body>
287	</subsection>
288	<subsection>	148	</subsection>
		149	<subsection>
289	<title>Gentoo's Minimal LiveCD</title>	150	<title>Gentoo Minimal Installation CD</title>
290	<body>	151	<body>
291		152
292	<p>
293	This is a small, no-nonsense, bootable CD which sole purpose is to boot the
294	system, prepare the networking and continue with the Gentoo installation. It
295	does not contain any stages (or, in some cases, a single stage1 file),
296	source code or precompiled packages. For example the ppc variant of this
297	LiveCD can be found in the <path>livecd</path> subdirectory and is called
298	<c>install-ppc-minimal-2004.2.iso</c>.
299	</p>	153	<p>
300		154	The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
		155	takes up only <keyval id="min-cd-size"/> MB of diskspace. You can use this
		156	Installation CD to install Gentoo, but <e>only</e> with a working Internet
		157	connection.
		158	</p>
		159	<!--
301	<table>	160	<table>
302	<tr>	161	<tr>
303	<th>Minimal LiveCD</th>	162	<th>Minimal Installation CD</th>
304	<th>Pros and Cons</th>	163	<th>Pros and Cons</th>
305	</tr>	164	</tr>
306	<tr>	165	<tr>
307	<th>+</th>	166	<th>+</th>
308	<ti>Smallest download</ti>	167	<ti>Smallest download</ti>
309	</tr>	168	</tr>
310	<tr>	169	<tr>
311	<th>+</th>
312	<ti>Suitable for a complete architecture</ti>
313	</tr>
314	<tr>
315	<th>+</th>
316	<ti>
317	You can do a stage1, stage2 or stage3 by getting the stage tarball off the
318	net
319	</ti>
320	</tr>
321	<tr>
322	<th>-</th>	170	<th>-</th>
323	<ti>	171	<ti>
324	Contains no stages, no Portage snapshot, no GRP packages and therefore not	172	Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and
325	suitable for networkless installation	173	is therefore not suitable for networkless installation
326	</ti>	174	</ti>
327	</tr>	175	</tr>
328	</table>	176	</table>
329		177	-->
330	</body>	178	</body>
331	</subsection>
332	<subsection>	179	</subsection>
333	<title>Gentoo's Universal LiveCD</title>	180	<subsection>
		181	<title>The Stage3 Tarball</title>
334	<body>	182	<body>
335		183
336	<p>
337	Gentoo's Universal LiveCD is a bootable CD suitable to install Gentoo without
338	networking. It contains a stage1 and several stage3 tarballs (optimized for the
339	individual subarchitectures). For example the ppc variant of this CD is called
340	<c>install-ppc-universal-2004.2.iso</c> and can be found in the
341	<path>livecd</path> subdirectory.
342	</p>	184	<p>
343		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>
344	<p>	193	</p>
345	If you take a closer look on our mirrors, you will see	194
346	that we provide <e>Gentoo Package CDs</e>. This CD (which isn't
347	bootable) only contains precompiled packages and can be used to install software
348	after a succesfull Gentoo Installation. To install Gentoo, you only
349	need the Universal LiveCD, but if you want OpenOffice.org, Mozilla, KDE, GNOME
350	etc. without having to compile every single one of them, you need the Packages
351	CD too. For example the G4 (a subarchitecture of ppc) Packages CD is
352	called <c>packages-g4-2004.2.iso</c> and can be found in the appropriate
353	subdirectory (<path>g4/</path>).
354	</p>	195	<p>
355		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.
356	<p>	200	</p>
357	You only need the Packages CD if you want to perform a stage3 with GRP
358	installation.
359	</p>
360
361	<table>
362	<tr>
363	<th>Universal LiveCD with Packages CD</th>
364	<th>Pros and Cons</th>
365	</tr>
366	<tr>
367	<th>+</th>
368	<ti>Packages CD is optimized to your architecture and subarchitecture</ti>
369	</tr>
370	<tr>
371	<th>+</th>
372	<ti>
373	Packages CD provides precompiled packages for fast Gentoo installations
374	</ti>
375	</tr>
376	<tr>
377	<th>+</th>
378	<ti>
379	Contains everything you need. You can even install without a network
380	connection.
381	</ti>
382	</tr>
383	<tr>
384	<th>-</th>
385	<ti>Huge download</ti>
386	</tr>
387	</table>
388		201
389	</body>	202	</body>
390	</subsection>	203	</subsection>
391	</section>	204	</section>
		205
		206
		207	<!-- STOP -->
392	<section>	208	<section>
393	<title>Download, Burn and Boot a Gentoo LiveCD</title>	209	<title>Download, Burn and Boot a Gentoo Installation CD</title>
394	<subsection>	210	<subsection>
395	<title>Downloading and Burning the LiveCDs</title>	211	<title>Downloading and Burning the Installation CDs</title>
396	<body>	212	<body>
397		213
398	<p>
399	You have chosen to use a Gentoo LiveCD (if not, then you are reading the
400	wrong section). We'll first start by downloading and burning the chosen
401	LiveCD. We previously discussed the several available LiveCDs, but where can you
402	find them?
403	</p>	214	<p>
404		215	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?
405	<p>	218	</p>
406	Visit one of our <uri	219
407	link="/main/en/mirrors.xml">mirrors</uri> and go to
408	<path>releases/ppc/2004.2/livecd</path>, which is
409	the path where the LiveCD(s) of your choice are located. Inside that
410	directory you'll find so-called ISO-files. Those are full CD images
411	which you can write on a CD-R.
412	</p>	220	<p>
413		221	You can download any of the Installation CDs from one of our <uri
		222	link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
		223	the <path><keyval id="release-dir"/>current-iso/</path> directory.
414	<p>	224	</p>
		225
		226	<p>
		227	Inside that directory you'll find ISO files. Those are full CD images which you
		228	can write on a CD-R.
		229	</p>
		230
		231	<p>
415	In case you wonder if your downloaded file is corrupted or not, you can	232	In case you wonder if your downloaded file is corrupted or not, you can check
416	check its MD5 checksum and compare it with the MD5 checksum we provide (such as	233	its MD5 checksum and compare it with the MD5 checksum we provide (such as
417	<path>install-ppc-minimal-2004.2.iso.md5</path>). You can check the MD5 checksum	234	<path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the MD5
418	with the <c>md5sum</c> tool under Linux/Unix or <uri	235	checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
419	link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.	236	link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
420	</p>	237	</p>
421		238
422	<p>	239	<p>
423	As long as Mac OS X does not support <c>md5sum</c> you have to use the md5	240	Another way to check the validity of the downloaded file is to use GnuPG to
424	capability of <c>openssl</c>. Therefore type in Terminal.app:	241	verify the cryptographic signature that we provide (the file ending with
425	</p>	242	<path>.asc</path>). Download the signature file and obtain the public keys:
426
427	<pre caption="md5sum with the help of openssl">
428	$ <i>openssl md5 /path/to/iso</i>
429	<comment>This could take some time depending of the size of the ISO and your CPU</comment>
430	</pre>
431
432	<p>	243	</p>
433	Now compare this output with the appropriate file found on the server where you	244
434	downloaded the ISO (the file will end with .md5). If it is the same, the ISO	245	<pre caption="Obtaining the public key">
435	image downloaded correctly. Be sure you have not mounted it (e.g. with Disk	246	$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 96D8BF6D 2D182910 17072058</i>
436	Copy) yet!	247	</pre>
		248
437	</p>	249	<p>
438		250	Now verify the signature:
439	<p>	251	</p>
440	More information are available in our <uri	252
441	link="/doc/en/gentoo-ppc-faq.xml">PPC FAQ.</uri>	253	<pre caption="Verify the files">
		254	<comment>(Verify the cryptographic signature)</comment>
		255	$ <i>gpg --verify <downloaded iso.DIGESTS.asc></i>
		256	<comment>(Verify the checksum)</comment>
		257	$ <i>sha1sum -c <downloaded iso.DIGESTS.asc></i>
442	</p>	258	</pre>
443		259
444	<p>	260	<p>
445	To burn the downloaded ISO(s), you have to select raw-burning. How you	261	To burn the downloaded ISO(s), you have to select raw-burning. How you
446	do this is highly program-dependent. We will discuss <c>cdrecord</c>,	262	do this is highly program-dependent. We will discuss <c>cdrecord</c> and
447	<c>k3b</c> and the MacOS burning possibilities here; more information can	263	<c>K3B</c> here; more information can be found in our <uri
448	be found in our <uri link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri> and	264	link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
449	the <uri link="/doc/en/gentoo-ppc-faq.xml">PPC FAQ</uri>.
450	</p>	265	</p>
451		266
452	<ul>	267	<ul>
453	<li>	268	<li>
454	With cdrecord, you simply type <c>cdrecord dev=/dev/hdc</c> (replace	269	With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso
455	<path>/dev/hdc</path> with your CD-RW drive's device path) followed	270	file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
456	by the path to the ISO file :)	271	path).
457	</li>	272	</li>
458	<li>	273	<li>
459	With k3b, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then	274	With K3B, select <c>Tools</c> > <c>Burn CD Image</c>. Then you can locate
460	you can locate your ISO file within the 'Image to Burn' area. Finally click	275	your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
461	<c>Start</c>.
462	</li>
463	<li>
464	With Mac OS X Panther, launch <c>Disk Utility</c> from
465	<path>Applications/Utilities</path>, select <c>Open</c> from the
466	<c>Images</c> menu, select the mounted disk image in the main window and
467	select <c>Burn</c> in the <c>Images</c> menu.
468	</li>
469	<li>
470	With Mac OS X Jaguar, launch <c>Disk Copy</c> from
471	<path>Applications/Utilities</path>, select <c>Burn Image</c> from the
472	<c>File</c> menu, select the ISO and click the <c>Burn</c> button.
473	</li>	276	</li>
474	</ul>	277	</ul>
475		278
476	</body>	279	</body>
477	</subsection>	280	</subsection>
478	</section>
479	<section>	281	<subsection>
480	<title>Booting the PPC LiveCD(s)</title>	282	<title>Default: Booting the Installation CD with Yaboot</title>
481	<subsection>
482	<title>Default: Apple/IBM</title>
483	<body>	283	<body>
484		284
485	<p>
486	On NewWorld machines place the LiveCD in the CD-ROM and reboot the system. When
487	the system-start-bell sounds, simply hold down the 'C' until the CD loads.
488	</p>	285	<p>
489		286	On NewWorld machines place the Installation CD in the CD-ROM and reboot the
		287	system. When the system-start-bell sounds, simply hold down the 'C' until the
		288	CD loads.
490	<p>	289	</p>
491	If you have an OldWorld Mac the bootable portion of the livecd can't be used.	290
492	Instead you need to download <uri
493	link="http://penguinppc.org/projects/bootx/">BootX</uri> and have a working
494	MacOS installed on your system. You need to copy the <c>BootX Extension</c> from
495	the unpacked archive-file into the <c>Extensions Folder</c> and make a new
496	directory called <c>Linux Kernels</c> in the System Folder. In the next step you
497	need to copy the <c>G3</c> kernel and the <c>initrd.img.gz</c> from the LiveCD
498	into the <c>Linux Kernels</c> directory. Then reboot the system and wait for
499	BootX to load. After BootX loaded you still have to set up a few items. In the
500	options dialog you need to check <c>Use Specified RAM Disk</c> and select the
501	<c>initrd.img.gz</c> which you put in the <c>Linux Kernels</c> directory. The
502	ramdisk size should be set to at least <c>32000</c>. Furthermore the kernel
503	argument needs to be set to <c>rw init=/linuxrc cdroot</c>. Eventually you are
504	able to boot the LiveCD when you select Linux on Startup.
505	</p>	291	<p>
506
507	<p>
508	After the LiveCD loaded, you will be greeted by a friendly welcome message and a	292	After the Installation CD loaded, you will be greeted by a friendly welcome
509	<e>boot:</e> prompt at the bottom of the screen.	293	message and a <e>boot:</e> prompt at the bottom of the screen.
510	</p>
511
512	<p>	294	</p>
513	At this prompt you are able to select a kernel for the subarchitecture you use.	295
514	We provide <c>G3</c>, <c>G4</c> and <c>G5</c>. All kernels are built with	296	<p>
		297	We provide one generic kernel, <e>ppc32</e>. This kernel is built with support
515	support for multiple CPUs, but they will boot on single processor machines as	298	for multiple CPUs, but it will boot on single processor machines as well.
516	well.
517	</p>
518
519	<p>	299	</p>
		300
		301	<p>
520	You are also able to tweak some kernel options at this prompt. The following	302	You can tweak some kernel options at this prompt. The following table lists
521	table lists the available boot options you can add:	303	some of the available boot options you can add:
522	</p>	304	</p>
523		305
524	<table>	306	<table>
525	<tr>	307	<tr>
526	<th>Boot Option</th>	308	<th>Boot Option</th>
…		…
528	</tr>	310	</tr>
529	<tr>	311	<tr>
530	<ti><c>video</c></ti>	312	<ti><c>video</c></ti>
531	<ti>	313	<ti>
532	This option takes one of the following vendor-specific tags:	314	This option takes one of the following vendor-specific tags:
533	<c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or	315	<c>nvidiafb</c>, <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>,
534	<c>ofonly</c>. You can follow this tag with the resolution and refreshrate	316	<c>aty128</c> or <c>ofonly</c>. You can follow this tag with the resolution
535	you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are	317	refresh rate and color depth you want to use. For instance,
536	uncertain what to choose, <c>ofonly</c> will most certainly work.	318	<c>video=radeonfb:1280x1024@75-32</c> will select the ATI Radeon frame buffer
		319	at a resolution of 1280x1024 with a refresh rate of 75Hz and a color depth of
		320	32 bits. If you are uncertain what to choose, and the default doesn't work,
		321	<c>video=ofonly</c> will most certainly work.
537	</ti>	322	</ti>
538	</tr>	323	</tr>
539	<tr>	324	<tr>
540	<ti><c>nol3</c></ti>	325	<ti><c>nol3</c></ti>
541	<ti>	326	<ti>
542	Disables level 3 cache on some PowerBooks (needed for at least the 17")	327	Disables level 3 cache on some PowerBooks (needed for at least the 17")
543	</ti>	328	</ti>
544	</tr>	329	</tr>
545	<tr>	330	<tr>
546	<ti><c>debug</c></ti>	331	<ti><c>dofirewire</c></ti>
547	<ti>
548	Enables verbose booting, spawns an initrd shell that can be used to debug
549	the LiveCD
550	</ti>	332	<ti>
551	</tr>	333	Enables support for IEEE1394 (FireWire) devices, like external harddisks.
552	<tr>
553	<ti><c>sleep=X</c></ti>
554	<ti>	334	</ti>
555	Wait X seconds before continuing; this can be needed by some very old SCSI	335	</tr>
556	CD-ROMs which don't speed up the CD quick enough	336	<tr>
		337	<ti><c>dopcmcia</c></ti>
557	</ti>	338	<ti>
558	</tr>	339	If you want to use PCMCIA devices during your installation (like PCMCIA
559	<tr>	340	network cards) you have to enable this option.
560	<ti><c>bootfrom=X</c></ti>
561	<ti>	341	</ti>
562	Boot from a different device	342	</tr>
		343	<tr>
		344	<ti><c>dosshd</c></ti>
		345	<ti>Starts <c>sshd</c>. Useful for unattended installs.</ti>
		346	</tr>
		347	<tr>
		348	<ti><c>passwd=foo</c></ti>
		349	<ti>
		350	Sets whatever is after the = as the root password. Use with <c>dosshd</c>
		351	for remote installs.
563	</ti>	352	</ti>
564	</tr>	353	</tr>
565	</table>	354	</table>
566		355
567	<p>	356	<p>
568	At this prompt, hit enter, and a complete Gentoo Linux environment will be	357	To use the above options, at the <e>boot:</e> prompt, type <e>ppc32</e> followed
569	loaded from the CD. Continue with <uri link="#booted">And When You're	358	by the desired option. In the example below, we'll force the kernel to use the
570	Booted...</uri>.	359	Open Firmware framebuffer instead of the device specific driver.
		360	</p>
		361
		362	<pre caption="Force the use of the Open Firmware framebuffer">
		363	boot: <i>ppc32 video=ofonly</i>
		364	</pre>
		365
571	</p>	366	<p>
		367	If you don't need to add any options, just type ppc32 at this prompt, and a
		368	complete Gentoo Linux environment will be loaded from the CD. Continue with
		369	<uri link="#booted">And When You're Booted...</uri>.
		370	</p>
572		371
573	</body>	372	</body>
574	</subsection>
575	<subsection>	373	</subsection>
576	<title>Alternative: Pegasos</title>	374	<subsection>
		375	<title>Alternative: Booting the Installation CD on a Pegasos</title>
577	<body>	376	<body>
578		377
579	<p>	378	<p>
580	On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type	379	On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
581	<c>boot cd /boot/pegasos root=/dev/ram0 init=/linuxrc looptype=gcloop	380	<c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
582	cdroot</c>. If you need any special boot options you can append them to the	381	between several preconfigured video configs. If you need any special boot
583	command-line. For instance <c>boot cd /boot/pegasos root=/dev/ram0	382	options you can append them to the command-line just like with Yaboot above.
584	init=/linuxrc looptype=gcloop cdroot video=radeonfb:1280x1024@75 mem=256M</c>.	383	For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
		384	The default kernel options (in case something goes wrong and you need it) are
		385	preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
		386	looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>.
585	</p>	387	</p>
586		388
587	</body>	389	</body>
		390	</subsection>
		391
588	</subsection>	392	<subsection>
		393	<title>Alternative: Booting the Installation CD with BootX</title>
		394	<body>
		395
		396	<p>
		397	If you have an OldWorld Mac the bootable portion of the livecd can't be used.
		398	The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux
		399	environment with a tool called BootX.
		400	</p>
		401
		402	<p>
		403	First, download <uri link="http://penguinppc.org/bootloaders/bootx/">BootX</uri>
		404	and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
		405	archive into <c>Extensions Folder</c> and the BootX App Control Panel into
		406	<c>Control Panels</c>, both of which are located in your MacOS System Folder.
		407	Next, create a folder called "Linux Kernels" in your System folder and copy the
		408	<c>ppc32</c> kernel from the CD to this folder. Finally, copy <c>ppc32.igz</c>
		409	from the Installation CD <path>boot</path> folder into the MacOS
		410	<c>System Folder</c>.
		411	</p>
		412
		413	<p>
		414	To prepare BootX, start the BootX App Control Panel. First select the Options
		415	dialog and check <c>Use Specified RAM Disk</c> and select <c>ppc32.igz</c> from
		416	your System Folder. Continue back to the initial screen and ensure that the
		417	ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
		418	shown below:
		419	</p>
		420
		421	<pre caption="BootX kernel arguments">
		422	cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0
		423	</pre>
		424
		425	<note>
		426	The kernel parameters in the yaboot section above are also applicable here. You
		427	can append any of those options to the kernel arguments above.
		428	</note>
		429
		430	<p>
		431	Check once more to make sure the settings are correct and then save the
		432	configuration. This saves typing just in case it doesn't boot or something is
		433	missing. Press the Linux button at the top of the window. If everything goes
		434	correctly, it should boot into the Installation CD. Continue with
		435	<uri link="#booted">And When You're Booted...</uri>
		436	</p>
		437
		438	</body>
		439	</subsection>
		440
589	<subsection id="booted">	441	<subsection id="booted">
590	<title>And When You're Booted...</title>	442	<title>And When You're Booted...</title>
591	<body>	443	<body>
592		444
593	<p>	445	<p>
594	You will be greeted by a root ("#") prompt on the current console. You can also	446	You will be greeted by a root ("#") prompt on the current console. You can also
595	switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get	447	switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
596	back to the one you started on by pressing Alt-fn-F1.	448	back to the one you started on by pressing Alt-F1. Due to the keyboard layout,
		449	you may need to press Alt-fn-Fx on Apple machines.
597	</p>	450	</p>
598		451
599	<p>	452	<p>
600	If you are installing Gentoo on a system with a non-US keyboard, use	453	If you are installing Gentoo on a system with a non-US keyboard, use
601	<c>loadkeys</c> to load the keymap for your keyboard. To list the available	454	<c>loadkeys</c> to load the keymap for your keyboard. To list the available
602	keymaps, execute <c>ls /usr/share/keymaps/i386</c>. Do not use the keymaps in	455	keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
603	<path>ppc</path> or <path>mac</path> as they are for ADB-based OldWorld
604	machines.
605	</p>	456	</p>
606		457
607	<pre caption="Listing available keymaps">	458	<pre caption="Listing available keymaps">
608	<comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided	459	<comment>(PPC uses x86 keymaps on most systems.)</comment>
609	on the LiveCD are ADB keymaps and unusable with the LiveCD kernel)</comment>
610	# <i>ls /usr/share/keymaps/i386</i>	460	# <i>ls /usr/share/keymaps/i386</i>
611	</pre>	461	</pre>
612		462
613	<p>	463	<p>
614	Now load the keymap of your choice:	464	Now load the keymap of your choice:
…		…
622	Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.	472	Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
623	</p>	473	</p>
624		474
625	</body>	475	</body>
626	</subsection>	476	</subsection>
627	<subsection id="hardware">
628	<title>Extra Hardware Configuration</title>
629	<body>
630		477
631	<p>
632	When the LiveCD boots, it tries to detect all your hardware devices and
633	loads the appropriate kernel modules to support your hardware. In the
634	vast majority of cases, it does a very good job. However, in some cases, it may
635	not auto-load the kernel modules you need. If the PCI auto-detection missed some
636	of your system's hardware, you will have to load the appropriate kernel modules
637	manually.
638	</p>
639
640	<p>
641	In the next example we try to load the <c>8139too</c> module (support for
642	certain kinds of network interfaces):
643	</p>
644
645	<pre caption="Loading kernel modules">
646	# <i>modprobe 8139too</i>
647	</pre>
648
649	</body>
650	</subsection>	478	<subsection>
		479	<include href="hb-install-bootconfig.xml"/>
651	<subsection>	480	</subsection>
652	<title>Optional: Tweaking Hard Disk Performance</title>
653	<body>
654		481
655	<p>
656	If you are an advanced user, you might want to tweak the IDE hard disk
657	performance using <c>hdparm</c>. With the <c>-tT</c> options you can
658	test the performance of your disk (execute it several times to get a
659	more precise impression):
660	</p>
661
662	<pre caption="Testing disk performance">
663	# <i>hdparm -tT /dev/hda</i>
664	</pre>
665
666	<p>
667	To tweak, you can use any of the following examples (or experiment
668	yourself) which use <path>/dev/hda</path> as disk (substitute with your
669	disk):
670	</p>
671
672	<pre caption="Tweaking hard disk performance">
673	<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
674	<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
675	</pre>
676
677	</body>
678	</subsection>
679	<subsection id="useraccounts">
680	<title>Optional: User Accounts</title>
681	<body>
682
683	<p>
684	If you plan on giving other people access to your installation
685	environment or you want to chat using <c>irssi</c> without root privileges (for
686	security reasons), you need to create the necessary user accounts and change
687	the root password.
688	</p>
689
690	<p>
691	To change the root password, use the <c>passwd</c> utility:
692	</p>
693
694	<pre caption="Changing the root password">
695	# <i>passwd</i>
696	New password: <comment>(Enter your new password)</comment>
697	Re-enter password: <comment>(Re-enter your password)</comment>
698	</pre>
699
700	<p>
701	To create a user account, we first enter their credentials, followed by
702	its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
703	In the next example, we create a user called "john".
704	</p>
705
706	<pre caption="Creating a user account">
707	# <i>useradd john</i>
708	# <i>passwd john</i>
709	New password: <comment>(Enter john's password)</comment>
710	Re-enter password: <comment>(Re-enter john's password)</comment>
711	</pre>
712
713	<p>
714	You can change your user id from root to the newly created user by using
715	<c>su</c>:
716	</p>
717
718	<pre caption="Changing user id">
719	# <i>su - john</i>
720	</pre>
721
722	</body>
723	</subsection>
724	<subsection>
725	<title>Optional: Viewing Documentation while Installing</title>
726	<body>
727
728	<p>
729	If you want to view the Gentoo Handbook (either from-CD or online) during the
730	installation, make sure you have created a user account (see <uri
731	link="#useraccouts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
732	go to a new terminal and log in.
733	</p>
734
735	<p>
736	If you want to view the documentation on the CD you can immediately run
737	<c>links2</c> to read it:
738	</p>
739
740	<pre caption="Viewing the on-CD documentation">
741	# <i>links2 /mnt/cdrom/docs/html/index.html</i>
742	</pre>
743
744	<p>
745	However, it is preferred that you use the online Gentoo Handbook as it will be
746	more recent than the one provided on the CD. You can view it using <c>links2</c>
747	as well, but only after having completed the <e>Configuring your Network</e>
748	chapter (otherwise you won't be able to go on the Internet to view the
749	document):
750	</p>
751
752	<pre caption="Viewing the Online Documentation">
753	# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml</i>
754	</pre>
755
756	<p>
757	You can go back to your original terminal by pressing <c>Alt-F1</c>.
758	</p>
759
760	</body>
761	</subsection>
762	<subsection>
763	<title>Optional: Starting the SSH Daemon</title>
764	<body>
765
766	<p>
767	If you want to allow other users to access your computer during the
768	Gentoo installation (perhaps because those users are going to help you
769	install Gentoo, or even do it for you), you need to create a user
770	account for them and perhaps even provide them with your root password
771	(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
772	</p>
773
774	<p>
775	To fire up the SSH daemon, execute the following command:
776	</p>
777
778	<pre caption="Starting the SSH daemon">
779	# <i>/etc/init.d/sshd start</i>
780	</pre>
781
782	<p>
783	To be able to use sshd, you first need to set up your networking. Continue with
784	the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>.
785	</p>
786
787	</body>
788	</subsection>
789	</section>	482	</section>
790	</sections>	483	</sections>

 Legend:



Removed from v.1.29
 


changed lines


 
Added in v.1.68
 Legend:



Removed from v.1.29
 


changed lines


 
Added in v.1.68
-Removed from v.1.29
+Added in v.1.68

	ViewVC Help
Powered by ViewVC 1.1.20