1 |
swift |
1.1 |
<?xml version='1.0' encoding='UTF-8'?> |
2 |
|
|
<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
3 |
|
|
|
4 |
|
|
<!-- The content of this document is licensed under the CC-BY-SA license --> |
5 |
neysx |
1.47 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
6 |
swift |
1.1 |
|
7 |
nightmorph |
1.55 |
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc-medium.xml,v 1.41 2007/04/02 02:26:57 nightmorph Exp $ --> |
8 |
swift |
1.1 |
|
9 |
|
|
<sections> |
10 |
swift |
1.32 |
|
11 |
nightmorph |
1.55 |
<version>8.0</version> |
12 |
|
|
<date>2007-05-07</date> |
13 |
swift |
1.32 |
|
14 |
swift |
1.1 |
<section> |
15 |
|
|
<title>Hardware Requirements</title> |
16 |
|
|
<subsection> |
17 |
|
|
<title>Introduction</title> |
18 |
|
|
<body> |
19 |
|
|
|
20 |
|
|
<p> |
21 |
|
|
Before we start, we first list what hardware requirements you need to |
22 |
swift |
1.35 |
successfully install Gentoo on your box. |
23 |
swift |
1.1 |
</p> |
24 |
|
|
|
25 |
|
|
</body> |
26 |
|
|
</subsection> |
27 |
|
|
<subsection> |
28 |
swift |
1.35 |
<title>Hardware Requirements</title> |
29 |
swift |
1.1 |
<body> |
30 |
|
|
|
31 |
swift |
1.35 |
<table> |
32 |
|
|
<tr> |
33 |
swift |
1.45 |
<th>Apple NewWorld Machines</th> |
34 |
swift |
1.35 |
<ti> |
35 |
|
|
Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook |
36 |
swift |
1.45 |
PowerBook, Xserver, PowerMac |
37 |
swift |
1.35 |
</ti> |
38 |
|
|
</tr> |
39 |
|
|
<tr> |
40 |
swift |
1.45 |
<th>Apple OldWorld machines</th> |
41 |
swift |
1.35 |
<ti> |
42 |
swift |
1.45 |
Apple Machines with an OpenFirmware revision less than 3, such as the Beige |
43 |
|
|
G3s, PCI PowerMacs and PCI PowerBooks. PCI based Apple Clones should also |
44 |
|
|
be supported. |
45 |
|
|
</ti> |
46 |
|
|
</tr> |
47 |
|
|
<tr> |
48 |
nightmorph |
1.55 |
<th>Genesi</th> |
49 |
swift |
1.45 |
<ti> |
50 |
nightmorph |
1.55 |
Pegasos I/II, Open Desktop Workstation, Efika |
51 |
swift |
1.45 |
</ti> |
52 |
|
|
</tr> |
53 |
|
|
<tr> |
54 |
|
|
<th>IBM</th> |
55 |
|
|
<ti> |
56 |
|
|
RS/6000, iSeries, pSeries |
57 |
swift |
1.35 |
</ti> |
58 |
|
|
</tr> |
59 |
|
|
<tr> |
60 |
|
|
<th>Memory</th> |
61 |
swift |
1.39 |
<ti>At least 64 MB</ti> |
62 |
swift |
1.35 |
</tr> |
63 |
|
|
<tr> |
64 |
|
|
<th>Diskspace</th> |
65 |
|
|
<ti>1.5 GB (excluding swap space)</ti> |
66 |
|
|
</tr> |
67 |
|
|
<tr> |
68 |
|
|
<th>Swap space</th> |
69 |
|
|
<ti>At least 256 MB</ti> |
70 |
|
|
</tr> |
71 |
|
|
</table> |
72 |
|
|
|
73 |
swift |
1.1 |
<p> |
74 |
fox2mike |
1.52 |
Be sure to read the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri> |
75 |
|
|
for help with some common installation related issues or if you're unsure as to |
76 |
|
|
just what's in that PowerPC machine you've got sitting on your desk right now. |
77 |
swift |
1.1 |
</p> |
78 |
|
|
|
79 |
|
|
</body> |
80 |
|
|
</subsection> |
81 |
|
|
</section> |
82 |
nightmorph |
1.54 |
<!-- Copy/paste of hb-install-x86-medium.xml, with s/x86/ppc/ --> |
83 |
swift |
1.35 |
<!-- START --> |
84 |
swift |
1.1 |
<section> |
85 |
nightmorph |
1.54 |
<title>The Gentoo Universal Installation CD</title> |
86 |
swift |
1.1 |
<subsection> |
87 |
swift |
1.35 |
<title>Introduction</title> |
88 |
swift |
1.1 |
<body> |
89 |
|
|
|
90 |
|
|
<p> |
91 |
nightmorph |
1.54 |
Gentoo Linux can be installed using a <e>stage3</e> tarball file. |
92 |
|
|
Such a tarball is an archive that contains a minimal environment from |
93 |
|
|
which you can succesfully install Gentoo Linux onto your system. |
94 |
swift |
1.1 |
</p> |
95 |
|
|
|
96 |
|
|
<p> |
97 |
nightmorph |
1.54 |
Installations using a stage1 or stage2 tarball file are not documented in the |
98 |
|
|
Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo |
99 |
|
|
FAQ</uri> on these matters. |
100 |
swift |
1.35 |
</p> |
101 |
|
|
|
102 |
nightmorph |
1.54 |
</body> |
103 |
|
|
</subsection> |
104 |
|
|
<subsection> |
105 |
|
|
<title>Gentoo Universal Installation CD</title> |
106 |
|
|
<body> |
107 |
|
|
|
108 |
swift |
1.35 |
<p> |
109 |
nightmorph |
1.54 |
An Installation CD is a bootable medium which contains a self-sustained Gentoo |
110 |
|
|
environment. It allows you to boot Linux from the CD. During the boot process |
111 |
|
|
your hardware is detected and the appropriate drivers are loaded. The Gentoo |
112 |
|
|
Installation CDs are maintained by Gentoo developers. |
113 |
swift |
1.1 |
</p> |
114 |
|
|
|
115 |
|
|
<p> |
116 |
nightmorph |
1.54 |
There currently are two Installation CDs available: |
117 |
swift |
1.35 |
</p> |
118 |
|
|
|
119 |
|
|
<ul> |
120 |
|
|
<li> |
121 |
nightmorph |
1.54 |
The Universal Installation CD contains everything you need to install |
122 |
|
|
Gentoo. It provides stage3 files for common architectures, source code |
123 |
|
|
for the extra applications you need to choose from and, of course, the |
124 |
|
|
installation instructions for your architecture. |
125 |
swift |
1.35 |
</li> |
126 |
|
|
<li> |
127 |
nightmorph |
1.54 |
The Minimal Installation CD contains only a minimal environment that allows |
128 |
|
|
you to boot up and configure your network so you can connect to the |
129 |
|
|
Internet. It does not contain any additional files and cannot be used |
130 |
|
|
during the current installation approach. |
131 |
swift |
1.35 |
</li> |
132 |
|
|
</ul> |
133 |
|
|
|
134 |
|
|
<p> |
135 |
nightmorph |
1.54 |
Gentoo also provides a Package CD. This is not an Installation CD but an |
136 |
|
|
additional resource that you can exploit during the installation of your Gentoo |
137 |
|
|
system. It contains prebuilt packages (also known as the GRP set) that allow |
138 |
|
|
you to easily and quickly install additional applications (such as |
139 |
|
|
OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and |
140 |
|
|
right before you update your Portage tree. |
141 |
swift |
1.35 |
</p> |
142 |
|
|
|
143 |
swift |
1.48 |
<p> |
144 |
nightmorph |
1.54 |
The use of the Package CD is covered later in this document. |
145 |
swift |
1.48 |
</p> |
146 |
|
|
|
147 |
swift |
1.35 |
</body> |
148 |
|
|
</subsection> |
149 |
swift |
1.1 |
</section> |
150 |
swift |
1.35 |
<!-- STOP --> |
151 |
swift |
1.1 |
<section> |
152 |
nightmorph |
1.54 |
<title>Download, Burn and Boot the Gentoo Universal Installation CD</title> |
153 |
swift |
1.1 |
<subsection> |
154 |
nightmorph |
1.54 |
<title>Downloading and Burning the Installation CD</title> |
155 |
swift |
1.1 |
<body> |
156 |
|
|
|
157 |
|
|
<p> |
158 |
nightmorph |
1.55 |
You can download the Universal Installation CD (and, if you want to, the |
159 |
|
|
Packages CD as well) from one of our <uri |
160 |
|
|
link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in |
161 |
|
|
the <path><keyval id="release-dir"/>installcd</path> directory; the Package CDs |
162 |
|
|
are located in the <path><keyval id="release-dir"/>packagecd</path> directory. |
163 |
swift |
1.35 |
</p> |
164 |
|
|
|
165 |
|
|
<p> |
166 |
nightmorph |
1.54 |
Inside those directories you'll find ISO-files. Those are full CD images which |
167 |
|
|
you can write on a CD-R. |
168 |
swift |
1.1 |
</p> |
169 |
|
|
|
170 |
|
|
<p> |
171 |
nightmorph |
1.54 |
After downloading the file, you can verify its integrity to see if it is |
172 |
|
|
corrupted or not: |
173 |
swift |
1.1 |
</p> |
174 |
|
|
|
175 |
nightmorph |
1.54 |
<ul> |
176 |
|
|
<li> |
177 |
|
|
You can check its MD5 checksum and compare it with the MD5 checksum we |
178 |
|
|
provide (for instance with the <c>md5sum</c> tool under Linux/Unix or |
179 |
|
|
<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows). |
180 |
|
|
Verifying MD5 checksums with Mac OS X is described in the <uri |
181 |
|
|
link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>. |
182 |
|
|
</li> |
183 |
|
|
<li> |
184 |
|
|
You can verify the cryptographic signature that we provide. You need to |
185 |
|
|
obtain the public key we use (0x17072058) before you proceed though. |
186 |
|
|
</li> |
187 |
|
|
</ul> |
188 |
swift |
1.1 |
|
189 |
|
|
<p> |
190 |
nightmorph |
1.54 |
To fetch our public key using the GnuPG application, run the following command: |
191 |
swift |
1.12 |
</p> |
192 |
|
|
|
193 |
swift |
1.35 |
<pre caption="Obtaining the public key"> |
194 |
nightmorph |
1.54 |
$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 0x17072058</i> |
195 |
swift |
1.12 |
</pre> |
196 |
|
|
|
197 |
|
|
<p> |
198 |
swift |
1.35 |
Now verify the signature: |
199 |
swift |
1.12 |
</p> |
200 |
|
|
|
201 |
swift |
1.35 |
<pre caption="Verify the cryptographic signature"> |
202 |
|
|
$ <i>gpg --verify <signature file> <downloaded iso></i> |
203 |
|
|
</pre> |
204 |
swift |
1.12 |
|
205 |
|
|
<p> |
206 |
swift |
1.1 |
To burn the downloaded ISO(s), you have to select raw-burning. How you |
207 |
swift |
1.35 |
do this is highly program-dependent. We will discuss <c>cdrecord</c> and |
208 |
|
|
<c>K3B</c> here; more information can be found in our <uri |
209 |
|
|
link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>. |
210 |
swift |
1.1 |
</p> |
211 |
|
|
|
212 |
|
|
<ul> |
213 |
|
|
<li> |
214 |
nightmorph |
1.54 |
With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso |
215 |
|
|
file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device |
216 |
|
|
path). |
217 |
swift |
1.1 |
</li> |
218 |
|
|
<li> |
219 |
swift |
1.35 |
With K3B, select <c>Tools</c> > <c>CD</c> > <c>Burn Image</c>. Then |
220 |
bennyc |
1.6 |
you can locate your ISO file within the 'Image to Burn' area. Finally click |
221 |
swift |
1.3 |
<c>Start</c>. |
222 |
|
|
</li> |
223 |
swift |
1.1 |
</ul> |
224 |
|
|
|
225 |
|
|
</body> |
226 |
|
|
</subsection> |
227 |
|
|
<subsection> |
228 |
josejx |
1.41 |
<title>Default: Booting the Installation CD with Yaboot</title> |
229 |
swift |
1.1 |
<body> |
230 |
|
|
|
231 |
|
|
<p> |
232 |
swift |
1.39 |
On NewWorld machines place the Installation CD in the CD-ROM and reboot the |
233 |
nightmorph |
1.54 |
system. When the system-start-bell sounds, simply hold down the 'C' until the |
234 |
swift |
1.39 |
CD loads. |
235 |
dertobi123 |
1.17 |
</p> |
236 |
|
|
|
237 |
|
|
<p> |
238 |
swift |
1.39 |
After the Installation CD loaded, you will be greeted by a friendly welcome |
239 |
|
|
message and a <e>boot:</e> prompt at the bottom of the screen. |
240 |
swift |
1.1 |
</p> |
241 |
|
|
|
242 |
|
|
<p> |
243 |
nightmorph |
1.54 |
We provide one generic kernel, <e>apple</e>. This kernel is built with support |
244 |
fox2mike |
1.52 |
for multiple CPUs, but it will boot on single processor machines as well. |
245 |
swift |
1.1 |
</p> |
246 |
|
|
|
247 |
|
|
<p> |
248 |
fox2mike |
1.52 |
You can tweak some kernel options at this prompt. The following table lists |
249 |
|
|
some of the available boot options you can add: |
250 |
swift |
1.1 |
</p> |
251 |
|
|
|
252 |
|
|
<table> |
253 |
|
|
<tr> |
254 |
|
|
<th>Boot Option</th> |
255 |
|
|
<th>Description</th> |
256 |
|
|
</tr> |
257 |
|
|
<tr> |
258 |
|
|
<ti><c>video</c></ti> |
259 |
|
|
<ti> |
260 |
|
|
This option takes one of the following vendor-specific tags: |
261 |
fox2mike |
1.52 |
<c>nvidiafb</c>, <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, |
262 |
|
|
<c>aty128</c> or <c>ofonly</c>. You can follow this tag with the resolution |
263 |
|
|
refresh rate and color depth you want to use. For instance, |
264 |
|
|
<c>video=radeonfb:1280x1024@75-32</c> will select the ATI Radeon frame buffer |
265 |
|
|
at a resolution of 1280x1024 with a refresh rate of 75Hz and a color depth of |
266 |
|
|
32 bits. If you are uncertain what to choose, and the default doesn't work, |
267 |
|
|
<c>video=ofonly</c> will most certainly work. |
268 |
swift |
1.1 |
</ti> |
269 |
|
|
</tr> |
270 |
|
|
<tr> |
271 |
pylon |
1.2 |
<ti><c>nol3</c></ti> |
272 |
swift |
1.1 |
<ti> |
273 |
dertobi123 |
1.17 |
Disables level 3 cache on some PowerBooks (needed for at least the 17") |
274 |
swift |
1.1 |
</ti> |
275 |
|
|
</tr> |
276 |
|
|
<tr> |
277 |
swift |
1.39 |
<ti><c>dofirewire</c></ti> |
278 |
swift |
1.1 |
<ti> |
279 |
swift |
1.39 |
Enables support for IEEE1394 (FireWire) devices, like external harddisks. |
280 |
swift |
1.1 |
</ti> |
281 |
|
|
</tr> |
282 |
swift |
1.7 |
<tr> |
283 |
swift |
1.39 |
<ti><c>dopcmcia</c></ti> |
284 |
swift |
1.7 |
<ti> |
285 |
nightmorph |
1.54 |
If you want to use PCMCIA devices during your installation (like PCMCIA |
286 |
|
|
network cards) you have to enable this option. |
287 |
swift |
1.7 |
</ti> |
288 |
|
|
</tr> |
289 |
swift |
1.1 |
</table> |
290 |
|
|
|
291 |
|
|
<p> |
292 |
nightmorph |
1.54 |
To use the above options, at the <e>boot:</e> prompt, type <e>apple</e> followed |
293 |
josejx |
1.53 |
by the desired option. In the example below, we'll force the kernel to use the |
294 |
|
|
OpenFirmware framebuffer instead of the device specific driver. |
295 |
|
|
</p> |
296 |
|
|
|
297 |
|
|
<pre caption="Force the use of the OpenFirmware framebuffer"> |
298 |
nightmorph |
1.54 |
boot: <i>apple video=ofonly</i> |
299 |
josejx |
1.53 |
</pre> |
300 |
|
|
|
301 |
|
|
<p> |
302 |
|
|
If you don't need to add any options, just hit enter at this prompt, and a |
303 |
|
|
complete Gentoo Linux environment will be loaded from the CD. Continue with |
304 |
|
|
<uri link="#booted">And When You're Booted...</uri>. |
305 |
swift |
1.1 |
</p> |
306 |
|
|
|
307 |
swift |
1.7 |
</body> |
308 |
|
|
</subsection> |
309 |
|
|
<subsection> |
310 |
swift |
1.39 |
<title>Alternative: Booting the Installation CD on a Pegasos</title> |
311 |
swift |
1.7 |
<body> |
312 |
|
|
|
313 |
swift |
1.1 |
<p> |
314 |
swift |
1.7 |
On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type |
315 |
swift |
1.39 |
<c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose |
316 |
|
|
between several preconfigured video configs. If you need any special boot |
317 |
fox2mike |
1.52 |
options you can append them to the command-line just like with Yaboot above. |
318 |
|
|
For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>. |
319 |
|
|
The default kernel options (in case something goes wrong and you need it) are |
320 |
|
|
preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc |
321 |
nightmorph |
1.54 |
looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>. |
322 |
swift |
1.1 |
</p> |
323 |
|
|
|
324 |
swift |
1.7 |
</body> |
325 |
|
|
</subsection> |
326 |
josejx |
1.41 |
|
327 |
|
|
<subsection> |
328 |
|
|
<title>Alternative: Booting the Installation CD with BootX</title> |
329 |
|
|
<body> |
330 |
|
|
|
331 |
|
|
<p> |
332 |
|
|
If you have an OldWorld Mac the bootable portion of the livecd can't be used. |
333 |
josejx |
1.53 |
The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux |
334 |
|
|
environment with a tool called BootX. |
335 |
josejx |
1.41 |
</p> |
336 |
swift |
1.45 |
|
337 |
josejx |
1.41 |
<p> |
338 |
|
|
First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri> |
339 |
|
|
and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked |
340 |
|
|
archive into <c>Extensions Folder</c> and the BootX App Control Panel into |
341 |
|
|
<c>Control Panels</c>, both of which are located in your MacOS System Folder. |
342 |
josejx |
1.42 |
Next, create a folder called "Linux Kernels" in your System folder and copy the |
343 |
nightmorph |
1.54 |
<c>apple</c> kernel from the CD to this folder. Finally, copy <c>apple.igz</c> |
344 |
josejx |
1.42 |
from the Installation CD <path>boot</path> folder into the MacOS |
345 |
|
|
<c>System Folder</c>. |
346 |
josejx |
1.41 |
</p> |
347 |
swift |
1.45 |
|
348 |
josejx |
1.41 |
<p> |
349 |
|
|
To prepare BootX, start the BootX App Control Panel. First select the Options |
350 |
nightmorph |
1.54 |
dialog and check <c>Use Specified RAM Disk</c> and select <c>apple.igz</c> from |
351 |
josejx |
1.41 |
your System Folder. Continue back to the initial screen and ensure that the |
352 |
|
|
ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as |
353 |
|
|
shown below: |
354 |
|
|
</p> |
355 |
|
|
|
356 |
|
|
<pre caption="BootX kernel arguments"> |
357 |
nightmorph |
1.54 |
cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0 |
358 |
josejx |
1.41 |
</pre> |
359 |
swift |
1.45 |
|
360 |
josejx |
1.41 |
<note> |
361 |
fox2mike |
1.52 |
The kernel parameters in the yaboot section above are also applicable here. You |
362 |
|
|
can append any of those options to the kernel arguments above. |
363 |
josejx |
1.41 |
</note> |
364 |
swift |
1.45 |
|
365 |
josejx |
1.41 |
<p> |
366 |
|
|
Check once more to make sure the settings are correct and then save the |
367 |
|
|
configuration. This saves typing just in case it doesn't boot or something is |
368 |
fox2mike |
1.52 |
missing. Press the Linux button at the top of the window. If everything goes |
369 |
|
|
correctly, it should boot into the Installation CD. Continue with |
370 |
|
|
<uri link="#booted">And When You're Booted...</uri> |
371 |
josejx |
1.41 |
</p> |
372 |
swift |
1.45 |
|
373 |
josejx |
1.41 |
</body> |
374 |
|
|
</subsection> |
375 |
|
|
|
376 |
swift |
1.7 |
<subsection id="booted"> |
377 |
|
|
<title>And When You're Booted...</title> |
378 |
|
|
<body> |
379 |
swift |
1.1 |
|
380 |
|
|
<p> |
381 |
swift |
1.7 |
You will be greeted by a root ("#") prompt on the current console. You can also |
382 |
swift |
1.39 |
switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get |
383 |
fox2mike |
1.52 |
back to the one you started on by pressing Alt-F1. Due to the keyboard layout, |
384 |
|
|
you may need to press Alt-fn-Fx on Apple machines. |
385 |
swift |
1.1 |
</p> |
386 |
|
|
|
387 |
|
|
<p> |
388 |
|
|
If you are installing Gentoo on a system with a non-US keyboard, use |
389 |
|
|
<c>loadkeys</c> to load the keymap for your keyboard. To list the available |
390 |
nightmorph |
1.54 |
keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the |
391 |
swift |
1.39 |
Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they |
392 |
|
|
are for ADB-based OldWorld machines. |
393 |
swift |
1.1 |
</p> |
394 |
|
|
|
395 |
|
|
<pre caption="Listing available keymaps"> |
396 |
|
|
<comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided |
397 |
swift |
1.39 |
on the Installation CD are ADB keymaps and unusable with the Installation CD |
398 |
|
|
kernel)</comment> |
399 |
swift |
1.1 |
# <i>ls /usr/share/keymaps/i386</i> |
400 |
|
|
</pre> |
401 |
|
|
|
402 |
|
|
<p> |
403 |
|
|
Now load the keymap of your choice: |
404 |
|
|
</p> |
405 |
|
|
|
406 |
|
|
<pre caption="Loading a keymap"> |
407 |
swift |
1.7 |
# <i>loadkeys be-latin1</i> |
408 |
swift |
1.1 |
</pre> |
409 |
|
|
|
410 |
|
|
<p> |
411 |
|
|
Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>. |
412 |
|
|
</p> |
413 |
|
|
|
414 |
|
|
</body> |
415 |
|
|
</subsection> |
416 |
|
|
<subsection id="hardware"> |
417 |
|
|
<title>Extra Hardware Configuration</title> |
418 |
|
|
<body> |
419 |
|
|
|
420 |
|
|
<p> |
421 |
swift |
1.39 |
When the Installation CD boots, it tries to detect all your hardware devices and |
422 |
swift |
1.1 |
loads the appropriate kernel modules to support your hardware. In the |
423 |
dertobi123 |
1.17 |
vast majority of cases, it does a very good job. However, in some cases, it may |
424 |
|
|
not auto-load the kernel modules you need. If the PCI auto-detection missed some |
425 |
|
|
of your system's hardware, you will have to load the appropriate kernel modules |
426 |
|
|
manually. |
427 |
swift |
1.1 |
</p> |
428 |
nightmorph |
1.54 |
|
429 |
fox2mike |
1.52 |
<p> |
430 |
|
|
In the next example we try to load the <c>airport</c> module. This module |
431 |
|
|
supports only the old Airport cards (802.11b). Airport Extreme (802.11g) is not |
432 |
|
|
supported on the InstallCD due to restrictions on firmware distribution. |
433 |
|
|
</p> |
434 |
nightmorph |
1.54 |
|
435 |
fox2mike |
1.52 |
<pre caption="Loading the airport module"> |
436 |
|
|
# <i>modprobe airport</i> |
437 |
|
|
</pre> |
438 |
nightmorph |
1.54 |
|
439 |
swift |
1.1 |
<p> |
440 |
fox2mike |
1.52 |
On older iMacs, sometimes the network card is not detected properly. These use |
441 |
|
|
the BMAC driver: |
442 |
swift |
1.1 |
</p> |
443 |
|
|
|
444 |
fox2mike |
1.52 |
<pre caption="Loading the bmac module"> |
445 |
|
|
# <i>modprobe bmac</i> |
446 |
swift |
1.1 |
</pre> |
447 |
|
|
|
448 |
|
|
</body> |
449 |
|
|
</subsection> |
450 |
|
|
<subsection> |
451 |
|
|
<title>Optional: Tweaking Hard Disk Performance</title> |
452 |
|
|
<body> |
453 |
|
|
|
454 |
|
|
<p> |
455 |
|
|
If you are an advanced user, you might want to tweak the IDE hard disk |
456 |
|
|
performance using <c>hdparm</c>. With the <c>-tT</c> options you can |
457 |
|
|
test the performance of your disk (execute it several times to get a |
458 |
|
|
more precise impression): |
459 |
|
|
</p> |
460 |
|
|
|
461 |
|
|
<pre caption="Testing disk performance"> |
462 |
|
|
# <i>hdparm -tT /dev/hda</i> |
463 |
|
|
</pre> |
464 |
|
|
|
465 |
|
|
<p> |
466 |
|
|
To tweak, you can use any of the following examples (or experiment |
467 |
|
|
yourself) which use <path>/dev/hda</path> as disk (substitute with your |
468 |
|
|
disk): |
469 |
|
|
</p> |
470 |
|
|
|
471 |
|
|
<pre caption="Tweaking hard disk performance"> |
472 |
nightmorph |
1.55 |
<comment>Activate DMA:</comment> |
473 |
|
|
# <i>hdparm -d 1 /dev/hda</i> |
474 |
|
|
<comment>Activate DMA + Safe Performance-enhancing Options:</comment> |
475 |
|
|
# <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i> |
476 |
swift |
1.1 |
</pre> |
477 |
|
|
|
478 |
|
|
</body> |
479 |
|
|
</subsection> |
480 |
swift |
1.20 |
<subsection id="useraccounts"> |
481 |
swift |
1.1 |
<title>Optional: User Accounts</title> |
482 |
|
|
<body> |
483 |
|
|
|
484 |
|
|
<p> |
485 |
|
|
If you plan on giving other people access to your installation |
486 |
|
|
environment or you want to chat using <c>irssi</c> without root privileges (for |
487 |
|
|
security reasons), you need to create the necessary user accounts and change |
488 |
|
|
the root password. |
489 |
|
|
</p> |
490 |
|
|
|
491 |
|
|
<p> |
492 |
|
|
To change the root password, use the <c>passwd</c> utility: |
493 |
|
|
</p> |
494 |
|
|
|
495 |
|
|
<pre caption="Changing the root password"> |
496 |
|
|
# <i>passwd</i> |
497 |
|
|
New password: <comment>(Enter your new password)</comment> |
498 |
|
|
Re-enter password: <comment>(Re-enter your password)</comment> |
499 |
|
|
</pre> |
500 |
|
|
|
501 |
|
|
<p> |
502 |
swift |
1.5 |
To create a user account, we first enter their credentials, followed by |
503 |
swift |
1.1 |
its password. We use <c>useradd</c> and <c>passwd</c> for these tasks. |
504 |
|
|
In the next example, we create a user called "john". |
505 |
|
|
</p> |
506 |
|
|
|
507 |
|
|
<pre caption="Creating a user account"> |
508 |
swift |
1.30 |
# <i>useradd -m -G users john</i> |
509 |
swift |
1.1 |
# <i>passwd john</i> |
510 |
|
|
New password: <comment>(Enter john's password)</comment> |
511 |
|
|
Re-enter password: <comment>(Re-enter john's password)</comment> |
512 |
|
|
</pre> |
513 |
|
|
|
514 |
|
|
<p> |
515 |
|
|
You can change your user id from root to the newly created user by using |
516 |
|
|
<c>su</c>: |
517 |
|
|
</p> |
518 |
|
|
|
519 |
|
|
<pre caption="Changing user id"> |
520 |
swift |
1.26 |
# <i>su - john</i> |
521 |
swift |
1.1 |
</pre> |
522 |
|
|
|
523 |
|
|
</body> |
524 |
|
|
</subsection> |
525 |
|
|
<subsection> |
526 |
swift |
1.20 |
<title>Optional: Viewing Documentation while Installing</title> |
527 |
|
|
<body> |
528 |
|
|
|
529 |
|
|
<p> |
530 |
|
|
If you want to view the Gentoo Handbook (either from-CD or online) during the |
531 |
|
|
installation, make sure you have created a user account (see <uri |
532 |
neysx |
1.31 |
link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to |
533 |
swift |
1.20 |
go to a new terminal and log in. |
534 |
|
|
</p> |
535 |
|
|
|
536 |
|
|
<p> |
537 |
|
|
If you want to view the documentation on the CD you can immediately run |
538 |
nightmorph |
1.54 |
<c>links</c> or even <c>links -g</c> for a graphical framebuffer browser to |
539 |
|
|
read it: |
540 |
swift |
1.20 |
</p> |
541 |
|
|
|
542 |
|
|
<pre caption="Viewing the on-CD documentation"> |
543 |
nightmorph |
1.54 |
# <i>links /mnt/cdrom/docs/html/index.html</i> |
544 |
swift |
1.20 |
</pre> |
545 |
|
|
|
546 |
|
|
<p> |
547 |
|
|
However, it is preferred that you use the online Gentoo Handbook as it will be |
548 |
fox2mike |
1.52 |
more recent than the one provided on the CD. You can view it using <c>links</c> |
549 |
swift |
1.20 |
as well, but only after having completed the <e>Configuring your Network</e> |
550 |
|
|
chapter (otherwise you won't be able to go on the Internet to view the |
551 |
|
|
document): |
552 |
|
|
</p> |
553 |
|
|
|
554 |
|
|
<pre caption="Viewing the Online Documentation"> |
555 |
nightmorph |
1.55 |
# <i>links http://www.gentoo.org/doc/en/handbook/<keyval id="online-book"/></i> |
556 |
swift |
1.20 |
</pre> |
557 |
|
|
|
558 |
|
|
<p> |
559 |
|
|
You can go back to your original terminal by pressing <c>Alt-F1</c>. |
560 |
|
|
</p> |
561 |
|
|
|
562 |
|
|
</body> |
563 |
|
|
</subsection> |
564 |
|
|
<subsection> |
565 |
swift |
1.1 |
<title>Optional: Starting the SSH Daemon</title> |
566 |
|
|
<body> |
567 |
|
|
|
568 |
|
|
<p> |
569 |
|
|
If you want to allow other users to access your computer during the |
570 |
|
|
Gentoo installation (perhaps because those users are going to help you |
571 |
|
|
install Gentoo, or even do it for you), you need to create a user |
572 |
|
|
account for them and perhaps even provide them with your root password |
573 |
|
|
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user). |
574 |
|
|
</p> |
575 |
|
|
|
576 |
|
|
<p> |
577 |
|
|
To fire up the SSH daemon, execute the following command: |
578 |
|
|
</p> |
579 |
|
|
|
580 |
|
|
<pre caption="Starting the SSH daemon"> |
581 |
|
|
# <i>/etc/init.d/sshd start</i> |
582 |
|
|
</pre> |
583 |
|
|
|
584 |
|
|
<p> |
585 |
swift |
1.28 |
To be able to use sshd, you first need to set up your networking. Continue with |
586 |
swift |
1.1 |
the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>. |
587 |
|
|
</p> |
588 |
|
|
|
589 |
|
|
</body> |
590 |
|
|
</subsection> |
591 |
|
|
</section> |
592 |
|
|
</sections> |