| … | |
… | |
| 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/2.5 --> |
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.49 2005/11/11 17:27:15 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 | |
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 | |
| 11 | <version>2.7</version> |
16 | <version>13</version> |
| 12 | <date>2005-11-11</date> |
17 | <date>2011-11-27</date> |
| 13 | |
18 | |
| 14 | <section> |
19 | <section> |
| 15 | <title>Hardware Requirements</title> |
20 | <title>Hardware Requirements</title> |
| 16 | <subsection> |
21 | <subsection> |
| 17 | <title>Introduction</title> |
22 | <title>Introduction</title> |
| … | |
… | |
| 37 | </ti> |
42 | </ti> |
| 38 | </tr> |
43 | </tr> |
| 39 | <tr> |
44 | <tr> |
| 40 | <th>Apple OldWorld machines</th> |
45 | <th>Apple OldWorld machines</th> |
| 41 | <ti> |
46 | <ti> |
| 42 | Apple Machines with an OpenFirmware revision less than 3, such as the Beige |
47 | Apple Machines with an Open Firmware revision less than 3, such as the Beige |
| 43 | G3s, PCI PowerMacs and PCI PowerBooks. PCI based Apple Clones should also |
48 | G3s, PCI PowerMacs and PCI PowerBooks. PCI-based Apple Clones should also |
| 44 | be supported. |
49 | be supported. |
| 45 | </ti> |
50 | </ti> |
| 46 | </tr> |
51 | </tr> |
| 47 | <tr> |
52 | <tr> |
| 48 | <th>Genesi's Pegasos</th> |
53 | <th>Genesi</th> |
| 49 | <ti> |
54 | <ti> |
| 50 | Pegasos I/II, Open Desktop Workstation |
55 | Pegasos I/II, Open Desktop Workstation, Efika |
| 51 | </ti> |
56 | </ti> |
| 52 | </tr> |
57 | </tr> |
| 53 | <tr> |
58 | <tr> |
| 54 | <th>IBM</th> |
59 | <th>IBM</th> |
| 55 | <ti> |
60 | <ti> |
| … | |
… | |
| 69 | <ti>At least 256 MB</ti> |
74 | <ti>At least 256 MB</ti> |
| 70 | </tr> |
75 | </tr> |
| 71 | </table> |
76 | </table> |
| 72 | |
77 | |
| 73 | <p> |
78 | <p> |
| 74 | 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> |
| 75 | PPC FAQ</uri> before you begin. |
80 | for help with some common installation related issues or if you're unsure as to |
|
|
81 | just what's in that PowerPC machine you've got sitting on your desk right now. |
| 76 | </p> |
82 | </p> |
| 77 | |
83 | |
| 78 | </body> |
84 | </body> |
| 79 | </subsection> |
85 | </subsection> |
| 80 | </section> |
86 | </section> |
| 81 | <!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/ppc/) --> |
87 | |
| 82 | <!-- START --> |
88 | <!-- START --> |
| 83 | <section> |
89 | <section> |
| 84 | <title>The Gentoo Installation CDs</title> |
90 | <title>The Gentoo Installation CDs</title> |
| 85 | <subsection> |
91 | <subsection> |
| 86 | <title>Introduction</title> |
92 | <title>Introduction</title> |
| … | |
… | |
| 93 | are loaded. They are maintained by Gentoo developers. |
99 | are loaded. They are maintained by Gentoo developers. |
| 94 | </p> |
100 | </p> |
| 95 | |
101 | |
| 96 | <p> |
102 | <p> |
| 97 | All Installation CDs allow you to boot, set up networking, initialize your |
103 | All Installation CDs allow you to boot, set up networking, initialize your |
| 98 | partitions and start installing Gentoo from the Internet. We currently provide |
104 | partitions and start installing Gentoo from the Internet. |
| 99 | two Installation CDs which are equaly suitable to install Gentoo from, as long |
|
|
| 100 | as you're planning on performing an Internet-based installation using the |
|
|
| 101 | latest version of the available packages. |
|
|
| 102 | </p> |
|
|
| 103 | |
|
|
| 104 | <p> |
105 | </p> |
|
|
106 | |
|
|
107 | <!-- |
|
|
108 | <impo> |
| 105 | If you wish to install Gentoo without a working Internet connection, please use |
109 | If you wish to install Gentoo without a working Internet connection, or would |
| 106 | the installation instructions described in the <uri |
110 | like to use one of the provided installers, please use the installation |
| 107 | link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>. |
111 | instructions described in the <uri link="2008.0/">Gentoo 2008.0 |
|
|
112 | Handbooks</uri>. |
|
|
113 | </impo> |
|
|
114 | --> |
|
|
115 | <!-- |
| 108 | </p> |
116 | <p> |
| 109 | |
|
|
| 110 | <p> |
|
|
| 111 | The two Installation CDs that we currently provide are: |
117 | The Installation CDs that we currently provide are: |
| 112 | </p> |
118 | </p> |
| 113 | |
119 | |
| 114 | <ul> |
120 | <ul> |
| 115 | <li> |
121 | <li> |
| 116 | The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable |
122 | The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable |
| 117 | CD which sole purpose is to boot the system, prepare the networking and |
123 | CD which sole purpose is to boot the system, prepare the networking and |
| 118 | continue with the Gentoo installation. |
124 | continue with the Gentoo installation. |
| 119 | </li> |
125 | </li> |
| 120 | <li> |
126 | <li> |
| 121 | The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same |
127 | The Universal Installation CD contains everything you need to install |
| 122 | abilities as the Minimal Installation CD. Additionally, it contains |
128 | Gentoo. It provides stage3 files for common architectures, source code |
| 123 | several stage3 tarballs (optimized for the individual subarchitectures). |
129 | for the extra applications you need to choose from and, of course, the |
|
|
130 | installation instructions for your architecture. |
| 124 | </li> |
131 | </li> |
| 125 | </ul> |
132 | </ul> |
| 126 | |
133 | |
| 127 | <p> |
134 | <p> |
| 128 | To help you decide which Installation CD you need, we have written down the |
135 | Gentoo also provides a Package CD. This is not an Installation CD but an |
| 129 | major advantages and disadvantages of each Installation CD. |
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 | |
| 130 | </p> |
143 | <p> |
| 131 | |
144 | The use of the Package CD is covered later in this document. |
|
|
145 | </p> |
|
|
146 | --> |
| 132 | </body> |
147 | </body> |
| 133 | </subsection> |
|
|
| 134 | <subsection> |
148 | </subsection> |
|
|
149 | <subsection> |
| 135 | <title>Gentoo's Minimal Installation CD</title> |
150 | <title>Gentoo Minimal Installation CD</title> |
| 136 | <body> |
151 | <body> |
| 137 | |
152 | |
| 138 | <p> |
|
|
| 139 | The Minimal Installation CD is called <c>install-ppc-minimal-2005.1.iso</c> and |
|
|
| 140 | takes up only 52 MB of diskspace. You can use this Installation CD to install |
|
|
| 141 | Gentoo, but always with a working Internet connection only. |
|
|
| 142 | </p> |
153 | <p> |
| 143 | |
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 | <!-- |
| 144 | <table> |
160 | <table> |
| 145 | <tr> |
161 | <tr> |
| 146 | <th>Minimal Installation CD</th> |
162 | <th>Minimal Installation CD</th> |
| 147 | <th>Pros and Cons</th> |
163 | <th>Pros and Cons</th> |
| 148 | </tr> |
164 | </tr> |
| … | |
… | |
| 151 | <ti>Smallest download</ti> |
167 | <ti>Smallest download</ti> |
| 152 | </tr> |
168 | </tr> |
| 153 | <tr> |
169 | <tr> |
| 154 | <th>-</th> |
170 | <th>-</th> |
| 155 | <ti> |
171 | <ti> |
| 156 | Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is |
172 | Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and |
| 157 | therefore not suitable for networkless installation |
173 | is therefore not suitable for networkless installation |
| 158 | </ti> |
174 | </ti> |
| 159 | </tr> |
175 | </tr> |
| 160 | </table> |
176 | </table> |
| 161 | |
177 | --> |
| 162 | </body> |
|
|
| 163 | </subsection> |
|
|
| 164 | <subsection> |
|
|
| 165 | <title>Gentoo's Universal Installation CD</title> |
|
|
| 166 | <body> |
|
|
| 167 | |
|
|
| 168 | <p> |
|
|
| 169 | The Universal Installation CD is called <c>install-ppc-universal-2005.1.iso</c> |
|
|
| 170 | and consumes the entire surface of a 650 MB CD. You can use this Installation |
|
|
| 171 | CD to install Gentoo, and you can even use it to install Gentoo without a |
|
|
| 172 | working internet connection, just in case you want to bring Gentoo to another |
|
|
| 173 | PC than the one you are currently installing Gentoo on :) |
|
|
| 174 | </p> |
|
|
| 175 | |
|
|
| 176 | <table> |
|
|
| 177 | <tr> |
|
|
| 178 | <th>Universal Installation CD</th> |
|
|
| 179 | <th>Pros and Cons</th> |
|
|
| 180 | </tr> |
|
|
| 181 | <tr> |
|
|
| 182 | <th>+</th> |
|
|
| 183 | <ti> |
|
|
| 184 | Contains everything you need. You can even install without a network |
|
|
| 185 | connection. |
|
|
| 186 | </ti> |
|
|
| 187 | </tr> |
|
|
| 188 | <tr> |
|
|
| 189 | <th>-</th> |
|
|
| 190 | <ti>Huge download</ti> |
|
|
| 191 | </tr> |
|
|
| 192 | </table> |
|
|
| 193 | |
|
|
| 194 | </body> |
|
|
| 195 | </subsection> |
|
|
| 196 | <subsection> |
|
|
| 197 | <title>Other CDs</title> |
|
|
| 198 | <body> |
|
|
| 199 | |
|
|
| 200 | <p> |
|
|
| 201 | You might find a so-called <e>Package CD</e> on one of our mirrors. This CD is |
|
|
| 202 | no Installation CD but an additional resource that can be exploited during a |
|
|
| 203 | networkless installation. It contains prebuilt packages (the so-called GRP |
|
|
| 204 | set) that allows you to easily and quickly install additional applications |
|
|
| 205 | (such as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless |
|
|
| 206 | Gentoo installation. |
|
|
| 207 | </p> |
|
|
| 208 | |
|
|
| 209 | <p> |
|
|
| 210 | If you intend to use the Packages CD to quickly install additional software, |
|
|
| 211 | make sure that you use the same subarchitecture as the stage3 tarball you use. |
|
|
| 212 | </p> |
|
|
| 213 | |
|
|
| 214 | </body> |
178 | </body> |
| 215 | </subsection> |
179 | </subsection> |
| 216 | <subsection> |
180 | <subsection> |
| 217 | <title>The Stage3 Tarball</title> |
181 | <title>The Stage3 Tarball</title> |
| 218 | <body> |
182 | <body> |
| 219 | |
183 | |
| 220 | <p> |
184 | <p> |
| 221 | A stage3 tarball is an archive containing a minimal Gentoo environment, suitable |
185 | A stage3 tarball is an archive containing a minimal Gentoo environment, |
| 222 | to continue the Gentoo installation using the instructions in this manual. |
186 | suitable to continue the Gentoo installation using the instructions in this |
| 223 | Previously, the Gentoo Handbook described the installation using one of three |
187 | manual. Previously, the Gentoo Handbook described the installation using one of |
| 224 | stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the |
188 | three stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the |
| 225 | official installation method uses the stage3 tarball. If you are interested in |
189 | official installation method uses the stage3 tarball. If you are interested in |
| 226 | performing a Gentoo installation using a stage1 or stage2 tarball, please read |
190 | performing a Gentoo installation using a stage1 or stage2 tarball, please read |
| 227 | the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo |
191 | the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo |
| 228 | Using a Stage1 or Stage2 Tarball?</uri> |
192 | Using a Stage1 or Stage2 Tarball?</uri> |
| 229 | </p> |
193 | </p> |
| 230 | |
194 | |
|
|
195 | <p> |
|
|
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. |
|
|
200 | </p> |
|
|
201 | |
| 231 | </body> |
202 | </body> |
| 232 | </subsection> |
203 | </subsection> |
| 233 | </section> |
204 | </section> |
|
|
205 | |
|
|
206 | |
| 234 | <!-- STOP --> |
207 | <!-- STOP --> |
| 235 | <section> |
208 | <section> |
| 236 | <title>Download, Burn and Boot a Gentoo Installation CD</title> |
209 | <title>Download, Burn and Boot a Gentoo Installation CD</title> |
| 237 | <subsection> |
210 | <subsection> |
| 238 | <title>Downloading and Burning the Installation CDs</title> |
211 | <title>Downloading and Burning the Installation CDs</title> |
| 239 | <body> |
212 | <body> |
| 240 | |
213 | |
| 241 | <p> |
214 | <p> |
| 242 | You have chosen to use a Gentoo Installation CD. We'll first start by |
215 | You have chosen to use a Gentoo Installation CD. We'll first start by |
| 243 | downloading and burning the chosen Installation CD. We previously discussed |
216 | downloading and burning the chosen Installation CD. We previously discussed |
| 244 | the several available Installation CDs, but where can you find them? |
217 | the several available Installation CDs, but where can you find them? |
| 245 | </p> |
|
|
| 246 | |
|
|
| 247 | <p> |
218 | </p> |
| 248 | You can download any of the Installation CDs (and, if you want to, a Packages |
219 | |
| 249 | CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The |
|
|
| 250 | Installation CDs are located in the <path>releases/ppc/2005.1/installcd</path> |
|
|
| 251 | directory. |
|
|
| 252 | </p> |
220 | <p> |
| 253 | |
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. |
| 254 | <p> |
224 | </p> |
|
|
225 | |
|
|
226 | <p> |
| 255 | Inside that directory you'll find so-called ISO-files. Those are full CD images |
227 | Inside that directory you'll find ISO files. Those are full CD images which you |
| 256 | which you can write on a CD-R. |
228 | can write on a CD-R. |
| 257 | </p> |
|
|
| 258 | |
|
|
| 259 | <p> |
229 | </p> |
|
|
230 | |
|
|
231 | <p> |
| 260 | 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 |
| 261 | 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 |
| 262 | <path>install-ppc-minimal-2005.1.iso.md5</path>). You can check the MD5 checksum |
234 | <path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the MD5 |
| 263 | with the <c>md5sum</c> tool under Linux/Unix or |
235 | checksum with the <c>md5sum</c> tool under Linux/Unix or <uri |
| 264 | <uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. If |
236 | link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. |
| 265 | <c>md5sum</c> is not available on Mac OS X, see the |
|
|
| 266 | <uri link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri> for help. |
|
|
| 267 | </p> |
237 | </p> |
| 268 | |
238 | |
| 269 | <p> |
239 | <p> |
| 270 | Another way to check the validity of the downloaded file is to use GnuPG to |
240 | Another way to check the validity of the downloaded file is to use GnuPG to |
| 271 | verify the cryptographic signature that we provide (the file ending with |
241 | verify the cryptographic signature that we provide (the file ending with |
| 272 | <path>.asc</path>). Download the signature file and obtain the public key: |
242 | <path>.asc</path>). Download the signature file and obtain the public keys: |
| 273 | </p> |
243 | </p> |
| 274 | |
244 | |
| 275 | <pre caption="Obtaining the public key"> |
245 | <pre caption="Obtaining the public key"> |
| 276 | $ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i> |
246 | $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 96D8BF6D 2D182910 17072058</i> |
| 277 | </pre> |
247 | </pre> |
| 278 | |
248 | |
| 279 | <p> |
249 | <p> |
| 280 | Now verify the signature: |
250 | Now verify the signature: |
| 281 | </p> |
251 | </p> |
| 282 | |
252 | |
| 283 | <pre caption="Verify the cryptographic signature"> |
253 | <pre caption="Verify the files"> |
| 284 | $ <i>gpg --verify <signature file> <downloaded iso></i> |
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> |
| 285 | </pre> |
258 | </pre> |
| 286 | |
259 | |
| 287 | <p> |
260 | <p> |
| 288 | 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 |
| 289 | do this is highly program-dependent. We will discuss <c>cdrecord</c> and |
262 | do this is highly program-dependent. We will discuss <c>cdrecord</c> and |
| … | |
… | |
| 291 | link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>. |
264 | link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>. |
| 292 | </p> |
265 | </p> |
| 293 | |
266 | |
| 294 | <ul> |
267 | <ul> |
| 295 | <li> |
268 | <li> |
| 296 | With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso |
269 | With cdrecord, you simply type <c>cdrecord dev=/dev/hdc <downloaded iso |
| 297 | file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's |
270 | file></c> (replace <path>/dev/hdc</path> with your CD-RW drive's device |
| 298 | device path). |
271 | path). |
| 299 | </li> |
272 | </li> |
| 300 | <li> |
273 | <li> |
| 301 | 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 |
| 302 | 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>. |
| 303 | <c>Start</c>. |
|
|
| 304 | </li> |
276 | </li> |
| 305 | </ul> |
277 | </ul> |
| 306 | |
278 | |
| 307 | </body> |
279 | </body> |
| 308 | </subsection> |
280 | </subsection> |
| … | |
… | |
| 310 | <title>Default: Booting the Installation CD with Yaboot</title> |
282 | <title>Default: Booting the Installation CD with Yaboot</title> |
| 311 | <body> |
283 | <body> |
| 312 | |
284 | |
| 313 | <p> |
285 | <p> |
| 314 | On NewWorld machines place the Installation CD in the CD-ROM and reboot the |
286 | On NewWorld machines place the Installation CD in the CD-ROM and reboot the |
| 315 | system. When the system-start-bell sounds, simply hold down the 'C' until the |
287 | system. When the system-start-bell sounds, simply hold down the 'C' until the |
| 316 | CD loads. |
288 | CD loads. |
| 317 | </p> |
289 | </p> |
| 318 | |
290 | |
| 319 | <p> |
291 | <p> |
| 320 | After the Installation CD loaded, you will be greeted by a friendly welcome |
292 | After the Installation CD loaded, you will be greeted by a friendly welcome |
| 321 | message and a <e>boot:</e> prompt at the bottom of the screen. |
293 | message and a <e>boot:</e> prompt at the bottom of the screen. |
| 322 | </p> |
294 | </p> |
| 323 | |
295 | |
| 324 | <p> |
296 | <p> |
| 325 | At this prompt you are able to select a kernel for the subarchitecture you use. |
297 | We provide one generic kernel, <e>ppc32</e>. This kernel is built with support |
| 326 | We provide <c>G3</c>, <c>G4</c> and <c>G5</c>. All kernels are built with |
|
|
| 327 | 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. |
| 328 | well. |
|
|
| 329 | </p> |
|
|
| 330 | |
|
|
| 331 | <p> |
299 | </p> |
|
|
300 | |
|
|
301 | <p> |
| 332 | 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 |
| 333 | table lists some of the available boot options you can add: |
303 | some of the available boot options you can add: |
| 334 | </p> |
304 | </p> |
| 335 | |
305 | |
| 336 | <table> |
306 | <table> |
| 337 | <tr> |
307 | <tr> |
| 338 | <th>Boot Option</th> |
308 | <th>Boot Option</th> |
| … | |
… | |
| 340 | </tr> |
310 | </tr> |
| 341 | <tr> |
311 | <tr> |
| 342 | <ti><c>video</c></ti> |
312 | <ti><c>video</c></ti> |
| 343 | <ti> |
313 | <ti> |
| 344 | This option takes one of the following vendor-specific tags: |
314 | This option takes one of the following vendor-specific tags: |
| 345 | <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>, |
| 346 | <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 |
| 347 | 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, |
| 348 | 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. |
| 349 | </ti> |
322 | </ti> |
| 350 | </tr> |
323 | </tr> |
| 351 | <tr> |
324 | <tr> |
| 352 | <ti><c>nol3</c></ti> |
325 | <ti><c>nol3</c></ti> |
| 353 | <ti> |
326 | <ti> |
| … | |
… | |
| 361 | </ti> |
334 | </ti> |
| 362 | </tr> |
335 | </tr> |
| 363 | <tr> |
336 | <tr> |
| 364 | <ti><c>dopcmcia</c></ti> |
337 | <ti><c>dopcmcia</c></ti> |
| 365 | <ti> |
338 | <ti> |
| 366 | If you want to use PCMCIA devices during your installation (like PCMCIA |
339 | If you want to use PCMCIA devices during your installation (like PCMCIA |
| 367 | network cards) you have to enable this option. |
340 | network cards) you have to enable this option. |
|
|
341 | </ti> |
|
|
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. |
| 368 | </ti> |
352 | </ti> |
| 369 | </tr> |
353 | </tr> |
| 370 | </table> |
354 | </table> |
| 371 | |
355 | |
| 372 | <p> |
356 | <p> |
| 373 | 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 |
| 374 | 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 |
| 375 | 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 | |
|
|
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>. |
| 376 | </p> |
370 | </p> |
| 377 | |
371 | |
| 378 | </body> |
372 | </body> |
| 379 | </subsection> |
373 | </subsection> |
| 380 | <subsection> |
374 | <subsection> |
| … | |
… | |
| 383 | |
377 | |
| 384 | <p> |
378 | <p> |
| 385 | 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 |
| 386 | <c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose |
380 | <c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose |
| 387 | between several preconfigured video configs. If you need any special boot |
381 | between several preconfigured video configs. If you need any special boot |
| 388 | options you can append them to the command-line. For instance <c>boot cd |
382 | options you can append them to the command-line just like with Yaboot above. |
| 389 | /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>. The complete list of |
383 | For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>. |
| 390 | kernel appends (in case something goes wrong and you need it) is preconfigured |
384 | The default kernel options (in case something goes wrong and you need it) are |
| 391 | in the kernel with <c>console=ttyS0,115200 console=tty0 init=/linuxrc |
385 | preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc |
| 392 | looptype=squashfs loop=/livecd.squashfs udev nodevfs cdroot root=/dev/ram0</c>. |
386 | looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>. |
| 393 | </p> |
387 | </p> |
| 394 | |
388 | |
| 395 | </body> |
389 | </body> |
| 396 | </subsection> |
390 | </subsection> |
| 397 | |
391 | |
| … | |
… | |
| 399 | <title>Alternative: Booting the Installation CD with BootX</title> |
393 | <title>Alternative: Booting the Installation CD with BootX</title> |
| 400 | <body> |
394 | <body> |
| 401 | |
395 | |
| 402 | <p> |
396 | <p> |
| 403 | If you have an OldWorld Mac the bootable portion of the livecd can't be used. |
397 | If you have an OldWorld Mac the bootable portion of the livecd can't be used. |
| 404 | The most simple solution is to use MacOS to bootstrap into a Linux environment |
398 | The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux |
| 405 | with a tool called BootX. Boot floppies are being prepared for Macs without |
399 | environment with a tool called BootX. |
| 406 | MacOS, but they are not available at this time. |
|
|
| 407 | </p> |
|
|
| 408 | |
|
|
| 409 | <p> |
400 | </p> |
|
|
401 | |
|
|
402 | <p> |
| 410 | First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri> |
403 | First, download <uri link="http://penguinppc.org/bootloaders/bootx/">BootX</uri> |
| 411 | and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked |
404 | and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked |
| 412 | archive into <c>Extensions Folder</c> and the BootX App Control Panel into |
405 | archive into <c>Extensions Folder</c> and the BootX App Control Panel into |
| 413 | <c>Control Panels</c>, both of which are located in your MacOS System Folder. |
406 | <c>Control Panels</c>, both of which are located in your MacOS System Folder. |
| 414 | Next, create a folder called "Linux Kernels" in your System folder and copy the |
407 | Next, create a folder called "Linux Kernels" in your System folder and copy the |
| 415 | <c>G3G4</c> kernel from the CD to this folder. Finally, copy <c>G3G4.igz</c> |
408 | <c>ppc32</c> kernel from the CD to this folder. Finally, copy <c>ppc32.igz</c> |
| 416 | from the Installation CD <path>boot</path> folder into the MacOS |
409 | from the Installation CD <path>boot</path> folder into the MacOS |
| 417 | <c>System Folder</c>. |
410 | <c>System Folder</c>. |
| 418 | </p> |
411 | </p> |
| 419 | |
412 | |
| 420 | <p> |
413 | <p> |
| 421 | To prepare BootX, start the BootX App Control Panel. First select the Options |
414 | To prepare BootX, start the BootX App Control Panel. First select the Options |
| 422 | dialog and check <c>Use Specified RAM Disk</c> and select <c>G3G4.igz</c> from |
415 | dialog and check <c>Use Specified RAM Disk</c> and select <c>ppc32.igz</c> from |
| 423 | your System Folder. Continue back to the initial screen and ensure that the |
416 | your System Folder. Continue back to the initial screen and ensure that the |
| 424 | ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as |
417 | ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as |
| 425 | shown below: |
418 | shown below: |
| 426 | </p> |
419 | </p> |
| 427 | |
420 | |
| 428 | <pre caption="BootX kernel arguments"> |
421 | <pre caption="BootX kernel arguments"> |
| 429 | cdroot root=/dev/ram0 init=linuxrc loop=livecd.squashfs looptype=squashfs console=tty0 nodevfs udev |
422 | cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0 |
| 430 | </pre> |
423 | </pre> |
| 431 | |
424 | |
| 432 | <note> |
425 | <note> |
| 433 | The kernel parameters in the yaboot section above are also applicable here. |
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. |
| 434 | </note> |
428 | </note> |
| 435 | |
429 | |
| 436 | <p> |
430 | <p> |
| 437 | Check once more to make sure the settings are correct and then save the |
431 | Check once more to make sure the settings are correct and then save the |
| 438 | configuration. This saves typing just in case it doesn't boot or something is |
432 | configuration. This saves typing just in case it doesn't boot or something is |
| 439 | missing. Press the Linux button at the top of the window to boot into the |
433 | missing. Press the Linux button at the top of the window. If everything goes |
| 440 | Installation CD and continue with <uri link="#booted">And When |
434 | correctly, it should boot into the Installation CD. Continue with |
| 441 | You're Booted...</uri> |
435 | <uri link="#booted">And When You're Booted...</uri> |
| 442 | </p> |
436 | </p> |
| 443 | |
437 | |
| 444 | </body> |
438 | </body> |
| 445 | </subsection> |
439 | </subsection> |
| 446 | |
440 | |
| … | |
… | |
| 449 | <body> |
443 | <body> |
| 450 | |
444 | |
| 451 | <p> |
445 | <p> |
| 452 | 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 |
| 453 | switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get |
447 | switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get |
| 454 | back to the one you started on by pressing Alt-F1. Probably you have to hit |
448 | back to the one you started on by pressing Alt-F1. Due to the keyboard layout, |
| 455 | Alt-fn-Fx on Apple machines. |
449 | you may need to press Alt-fn-Fx on Apple machines. |
| 456 | </p> |
450 | </p> |
| 457 | |
451 | |
| 458 | <p> |
452 | <p> |
| 459 | 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 |
| 460 | <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 |
| 461 | keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the |
455 | keymaps, execute <c>ls /usr/share/keymaps/i386</c>. |
| 462 | Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they |
|
|
| 463 | are for ADB-based OldWorld machines. |
|
|
| 464 | </p> |
456 | </p> |
| 465 | |
457 | |
| 466 | <pre caption="Listing available keymaps"> |
458 | <pre caption="Listing available keymaps"> |
| 467 | <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided |
459 | <comment>(PPC uses x86 keymaps on most systems.)</comment> |
| 468 | on the Installation CD are ADB keymaps and unusable with the Installation CD |
|
|
| 469 | kernel)</comment> |
|
|
| 470 | # <i>ls /usr/share/keymaps/i386</i> |
460 | # <i>ls /usr/share/keymaps/i386</i> |
| 471 | </pre> |
461 | </pre> |
| 472 | |
462 | |
| 473 | <p> |
463 | <p> |
| 474 | Now load the keymap of your choice: |
464 | Now load the keymap of your choice: |
| … | |
… | |
| 482 | Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>. |
472 | Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>. |
| 483 | </p> |
473 | </p> |
| 484 | |
474 | |
| 485 | </body> |
475 | </body> |
| 486 | </subsection> |
476 | </subsection> |
| 487 | <subsection id="hardware"> |
|
|
| 488 | <title>Extra Hardware Configuration</title> |
|
|
| 489 | <body> |
|
|
| 490 | |
477 | |
| 491 | <p> |
|
|
| 492 | When the Installation CD boots, it tries to detect all your hardware devices and |
|
|
| 493 | loads the appropriate kernel modules to support your hardware. In the |
|
|
| 494 | vast majority of cases, it does a very good job. However, in some cases, it may |
|
|
| 495 | not auto-load the kernel modules you need. If the PCI auto-detection missed some |
|
|
| 496 | of your system's hardware, you will have to load the appropriate kernel modules |
|
|
| 497 | manually. |
|
|
| 498 | </p> |
|
|
| 499 | |
|
|
| 500 | <p> |
|
|
| 501 | In the next example we try to load the <c>airport</c> module. This module |
|
|
| 502 | supports only the old Airport cards (b-net). AirportExtreme is currently not |
|
|
| 503 | supported under Linux: |
|
|
| 504 | </p> |
|
|
| 505 | |
|
|
| 506 | <pre caption="Loading kernel modules"> |
|
|
| 507 | # <i>modprobe airport</i> |
|
|
| 508 | </pre> |
|
|
| 509 | |
|
|
| 510 | </body> |
|
|
| 511 | </subsection> |
478 | <subsection> |
|
|
479 | <include href="hb-install-bootconfig.xml"/> |
| 512 | <subsection> |
480 | </subsection> |
| 513 | <title>Optional: Tweaking Hard Disk Performance</title> |
|
|
| 514 | <body> |
|
|
| 515 | |
481 | |
| 516 | <p> |
|
|
| 517 | If you are an advanced user, you might want to tweak the IDE hard disk |
|
|
| 518 | performance using <c>hdparm</c>. With the <c>-tT</c> options you can |
|
|
| 519 | test the performance of your disk (execute it several times to get a |
|
|
| 520 | more precise impression): |
|
|
| 521 | </p> |
|
|
| 522 | |
|
|
| 523 | <pre caption="Testing disk performance"> |
|
|
| 524 | # <i>hdparm -tT /dev/hda</i> |
|
|
| 525 | </pre> |
|
|
| 526 | |
|
|
| 527 | <p> |
|
|
| 528 | To tweak, you can use any of the following examples (or experiment |
|
|
| 529 | yourself) which use <path>/dev/hda</path> as disk (substitute with your |
|
|
| 530 | disk): |
|
|
| 531 | </p> |
|
|
| 532 | |
|
|
| 533 | <pre caption="Tweaking hard disk performance"> |
|
|
| 534 | <comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i> |
|
|
| 535 | <comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i> |
|
|
| 536 | </pre> |
|
|
| 537 | |
|
|
| 538 | </body> |
|
|
| 539 | </subsection> |
|
|
| 540 | <subsection id="useraccounts"> |
|
|
| 541 | <title>Optional: User Accounts</title> |
|
|
| 542 | <body> |
|
|
| 543 | |
|
|
| 544 | <p> |
|
|
| 545 | If you plan on giving other people access to your installation |
|
|
| 546 | environment or you want to chat using <c>irssi</c> without root privileges (for |
|
|
| 547 | security reasons), you need to create the necessary user accounts and change |
|
|
| 548 | the root password. |
|
|
| 549 | </p> |
|
|
| 550 | |
|
|
| 551 | <p> |
|
|
| 552 | To change the root password, use the <c>passwd</c> utility: |
|
|
| 553 | </p> |
|
|
| 554 | |
|
|
| 555 | <pre caption="Changing the root password"> |
|
|
| 556 | # <i>passwd</i> |
|
|
| 557 | New password: <comment>(Enter your new password)</comment> |
|
|
| 558 | Re-enter password: <comment>(Re-enter your password)</comment> |
|
|
| 559 | </pre> |
|
|
| 560 | |
|
|
| 561 | <p> |
|
|
| 562 | To create a user account, we first enter their credentials, followed by |
|
|
| 563 | its password. We use <c>useradd</c> and <c>passwd</c> for these tasks. |
|
|
| 564 | In the next example, we create a user called "john". |
|
|
| 565 | </p> |
|
|
| 566 | |
|
|
| 567 | <pre caption="Creating a user account"> |
|
|
| 568 | # <i>useradd -m -G users john</i> |
|
|
| 569 | # <i>passwd john</i> |
|
|
| 570 | New password: <comment>(Enter john's password)</comment> |
|
|
| 571 | Re-enter password: <comment>(Re-enter john's password)</comment> |
|
|
| 572 | </pre> |
|
|
| 573 | |
|
|
| 574 | <p> |
|
|
| 575 | You can change your user id from root to the newly created user by using |
|
|
| 576 | <c>su</c>: |
|
|
| 577 | </p> |
|
|
| 578 | |
|
|
| 579 | <pre caption="Changing user id"> |
|
|
| 580 | # <i>su - john</i> |
|
|
| 581 | </pre> |
|
|
| 582 | |
|
|
| 583 | </body> |
|
|
| 584 | </subsection> |
|
|
| 585 | <subsection> |
|
|
| 586 | <title>Optional: Viewing Documentation while Installing</title> |
|
|
| 587 | <body> |
|
|
| 588 | |
|
|
| 589 | <p> |
|
|
| 590 | If you want to view the Gentoo Handbook (either from-CD or online) during the |
|
|
| 591 | installation, make sure you have created a user account (see <uri |
|
|
| 592 | link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to |
|
|
| 593 | go to a new terminal and log in. |
|
|
| 594 | </p> |
|
|
| 595 | |
|
|
| 596 | <p> |
|
|
| 597 | If you want to view the documentation on the CD you can immediately run |
|
|
| 598 | <c>links2</c> to read it: |
|
|
| 599 | </p> |
|
|
| 600 | |
|
|
| 601 | <pre caption="Viewing the on-CD documentation"> |
|
|
| 602 | # <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i> |
|
|
| 603 | </pre> |
|
|
| 604 | |
|
|
| 605 | <p> |
|
|
| 606 | However, it is preferred that you use the online Gentoo Handbook as it will be |
|
|
| 607 | more recent than the one provided on the CD. You can view it using <c>links2</c> |
|
|
| 608 | as well, but only after having completed the <e>Configuring your Network</e> |
|
|
| 609 | chapter (otherwise you won't be able to go on the Internet to view the |
|
|
| 610 | document): |
|
|
| 611 | </p> |
|
|
| 612 | |
|
|
| 613 | <pre caption="Viewing the Online Documentation"> |
|
|
| 614 | # <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml</i> |
|
|
| 615 | </pre> |
|
|
| 616 | |
|
|
| 617 | <p> |
|
|
| 618 | You can go back to your original terminal by pressing <c>Alt-F1</c>. |
|
|
| 619 | </p> |
|
|
| 620 | |
|
|
| 621 | </body> |
|
|
| 622 | </subsection> |
|
|
| 623 | <subsection> |
|
|
| 624 | <title>Optional: Starting the SSH Daemon</title> |
|
|
| 625 | <body> |
|
|
| 626 | |
|
|
| 627 | <p> |
|
|
| 628 | If you want to allow other users to access your computer during the |
|
|
| 629 | Gentoo installation (perhaps because those users are going to help you |
|
|
| 630 | install Gentoo, or even do it for you), you need to create a user |
|
|
| 631 | account for them and perhaps even provide them with your root password |
|
|
| 632 | (<e>only</e> do that <e>if</e> you <b>fully trust</b> that user). |
|
|
| 633 | </p> |
|
|
| 634 | |
|
|
| 635 | <p> |
|
|
| 636 | To fire up the SSH daemon, execute the following command: |
|
|
| 637 | </p> |
|
|
| 638 | |
|
|
| 639 | <pre caption="Starting the SSH daemon"> |
|
|
| 640 | # <i>/etc/init.d/sshd start</i> |
|
|
| 641 | </pre> |
|
|
| 642 | |
|
|
| 643 | <p> |
|
|
| 644 | To be able to use sshd, you first need to set up your networking. Continue with |
|
|
| 645 | the chapter on <uri link="?part=1&chap=3">Configuring your Network</uri>. |
|
|
| 646 | </p> |
|
|
| 647 | |
|
|
| 648 | </body> |
|
|
| 649 | </subsection> |
|
|
| 650 | </section> |
482 | </section> |
| 651 | </sections> |
483 | </sections> |
Parent Directory
| 
Revision Log
| 
Patch