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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.27 - (show annotations) (download) (as text)
Sun Feb 13 22:29:48 2005 UTC (9 years, 4 months ago) by so
Branch: MAIN
Changes since 1.26: +2 -2 lines
File MIME type: application/xml
fix #81861

1 <?xml version='1.0' encoding='UTF-8'?>
2 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3
4 <!-- The content of this document is licensed under the CC-BY-SA license -->
5 <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
6
7 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v 1.26 2005/01/04 18:11:21 swift Exp $ -->
8
9 <sections>
10
11 <version>1.22</version>
12 <date>2005-01-04</date>
13
14 <section>
15 <title>Hardware Requirements</title>
16 <subsection>
17 <title>Introduction</title>
18 <body>
19
20 <p>
21 Before we start, we first list what hardware requirements you need to
22 successfully install Gentoo on your box.
23 </p>
24
25 </body>
26 </subsection>
27 <subsection>
28 <title>Hardware Requirements</title>
29 <body>
30
31 <table>
32 <tr>
33 <th>Sparc System</th>
34 <ti>
35 Please check the <uri
36 link="http://www.ultralinux.org/faq.html#s_2">UltraLinux FAQ</uri>
37 </ti>
38 </tr>
39 <tr>
40 <th>CPU</th>
41 <ti>
42 We currently only support sparc64 CPUs
43 </ti>
44 </tr>
45 <tr>
46 <th>Memory</th>
47 <ti>64 MB</ti>
48 </tr>
49 <tr>
50 <th>Diskspace</th>
51 <ti>1.5 GB (excluding swap space)</ti>
52 </tr>
53 <tr>
54 <th>Swap space</th>
55 <ti>At least 256 MB</ti>
56 </tr>
57 </table>
58
59 </body>
60 </subsection>
61 </section>
62 <!-- Copy/Paste from hb-install-x86-medium.xml -->
63 <!-- Warning: The part originally contains "x86" -->
64 <!-- START -->
65 <section>
66 <title>The Gentoo Installation Approaches</title>
67 <subsection>
68 <title>Introduction</title>
69 <body>
70
71 <p>
72 Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
73 A stage file is a tarball (compressed archive) that contains a minimal
74 environment.
75 </p>
76
77 <ul>
78 <li>
79 A stage1 file contains nothing more than a compiler, Portage (Gentoo's
80 software management system) and a couple of packages on which the compiler
81 or Portage depends.
82 </li>
83 <li>
84 A stage2 file contains a so-called bootstrapped system, a minimal
85 environment from which one can start building all other necessary
86 applications that make a Gentoo environment complete.
87 </li>
88 <li>
89 A stage3 file contains a prebuilt minimal system which is almost fully
90 deployable. It only lacks a few applications where you, the Gentoo user,
91 needs to choose which one you want to install.
92 </li>
93 </ul>
94
95 <p>
96 To help you decide what stage file you want to use, we have written down the
97 major advantages and disadvantages of each stage file.
98 </p>
99
100 </body>
101 </subsection>
102 <subsection>
103 <title>A Stage1 Approach</title>
104 <body>
105
106 <p>
107 A <e>stage1</e> is used when you want to bootstrap and build the entire system
108 from scratch.
109 </p>
110
111 <p>
112 Starting from a stage1 allows you to have total control over the
113 optimization settings and optional build-time functionality that is
114 initially enabled on your system. This makes <e>stage1</e> installs good for
115 power users who know what they are doing. It is also a great
116 installation method for those who would like to know more about the
117 inner workings of Gentoo Linux.
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 a waste of time
148 </ti>
149 </tr>
150 </table>
151
152 </body>
153 </subsection>
154 <subsection>
155 <title>A Stage2 Approach</title>
156 <body>
157
158 <p>
159 A <e>stage2</e> is used for building the entire system from a bootstrapped
160 "semi-compiled" state.
161 </p>
162
163 <p>
164 Stage2 installs allow you to skip the bootstrap process; doing this
165 is fine if you are happy with the optimization settings that we chose
166 for your particular stage2 tarball.
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 still 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 </table>
199
200 </body>
201 </subsection>
202 <subsection>
203 <title>A Stage3 Approach</title>
204 <body>
205
206 <p>
207 A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
208 built for you. You will only need to build a few packages of which we can't
209 decide for you which one to choose.
210 </p>
211
212 <p>
213 Choosing to go with a stage3 allows for the fastest install of Gentoo
214 Linux, but also means that your base system will have the optimization
215 settings that we chose for you (which to be honest, are good settings
216 and were carefully chosen to enhance performance while maintaining
217 stability). Stage3 is also required if you want to install Gentoo using
218 prebuilt packages or without a network connection.
219 </p>
220
221 <table>
222 <tr>
223 <th>Stage3</th>
224 <th>Pros and Cons</th>
225 </tr>
226 <tr>
227 <th>+</th>
228 <ti>Fastest way to get a Gentoo base system</ti>
229 </tr>
230 <tr>
231 <th>-</th>
232 <ti>You cannot tweak the base system - it's built already</ti>
233 </tr>
234 </table>
235
236 <p>
237 You might be interested to know that, if you decide to use different
238 optimization settings after having installed Gentoo, you will be able to
239 recompile your entire system with the new optimization settings.
240 </p>
241
242 </body>
243 </subsection>
244 </section>
245 <section>
246 <title>The Gentoo LiveCDs</title>
247 <subsection>
248 <title>Introduction</title>
249 <body>
250
251 <p>
252 The <e>Gentoo LiveCDs</e> are bootable CDs which contain a
253 self-sustained Gentoo environment. They allow you to boot Linux from the CD.
254 During the boot process your hardware is detected and the appropriate drivers
255 are loaded. They are maintained by Gentoo developers.
256 </p>
257
258 <p>
259 All LiveCDs allow you to boot, set up networking, initialize your
260 partitions and start installing Gentoo from the Internet. We currently provide
261 two LiveCDs which are equaly suitable to install Gentoo from, as long as you're
262 planning on performing an Internet-based installation using the latest version
263 of the available packages.
264 </p>
265
266 <p>
267 If you whish to install Gentoo without a working Internet connection, please use
268 the installation instructions described in the <uri
269 link="2004.3/index.xml">Gentoo 2004.3 Handbooks</uri>.
270 </p>
271
272 <p>
273 The two LiveCDs that we currently provide are:
274 </p>
275
276 <ul>
277 <li>
278 The Gentoo <e>Minimal</e> LiveCD, a small, no-nonsense, bootable CD which
279 sole purpose is to boot the system, prepare the networking and continue with
280 the Gentoo installation.
281 </li>
282 <li>
283 The Gentoo <e>Universal</e> LiveCD, a bootable CD with the same abilities as
284 the Minimal LiveCD. Additionally, it contains a stage1 and several stage3
285 tarballs (optimized for the individual subarchitectures).
286 </li>
287 </ul>
288
289 <p>
290 To help you decide which LiveCD you need, we have written down the major
291 advantages and disadvantages of each LiveCD.
292 </p>
293
294 </body>
295 </subsection>
296 <subsection>
297 <title>Gentoo's Minimal LiveCD</title>
298 <body>
299
300 <p>
301 The Minimal LiveCD is called <c>install-sparc64-minimal-2004.3.iso</c> and
302 takes up only 130 MB of diskspace. You can use this LiveCD to install Gentoo,
303 but always with a working Internet connection only.
304 </p>
305
306 <table>
307 <tr>
308 <th>Minimal LiveCD</th>
309 <th>Pros and Cons</th>
310 </tr>
311 <tr>
312 <th>+</th>
313 <ti>Smallest download</ti>
314 </tr>
315 <tr>
316 <th>+</th>
317 <ti>
318 You can do a stage1, stage2 or stage3 by getting the stage tarball off the
319 net
320 </ti>
321 </tr>
322 <tr>
323 <th>-</th>
324 <ti>
325 Contains no stages, no Portage snapshot, no prebuilt packages and is
326 therefore not suitable for networkless installation
327 </ti>
328 </tr>
329 </table>
330
331 </body>
332 </subsection>
333 <subsection>
334 <title>Gentoo's Universal LiveCD</title>
335 <body>
336
337 <p>
338 The Universal LiveCD is called <c>install-sparc-universal-2004.3.iso</c> and
339 consumes the entire surface of a 650 MB CD. You can use this LiveCD to install
340 Gentoo, and you can even use it to install Gentoo without a working internet
341 connection, just in case you want to bring Gentoo to another PC than the one you
342 are currently installing Gentoo on :)
343 </p>
344
345 <table>
346 <tr>
347 <th>Universal LiveCD</th>
348 <th>Pros and Cons</th>
349 </tr>
350 <tr>
351 <th>+</th>
352 <ti>
353 Contains everything you need. You can even install without a network
354 connection.
355 </ti>
356 </tr>
357 <tr>
358 <th>-</th>
359 <ti>Huge download</ti>
360 </tr>
361 </table>
362
363 </body>
364 </subsection>
365 <subsection>
366 <title>Other CDs</title>
367 <body>
368
369 <p>
370 You might find a so-called <e>Package CD</e> on one of our mirrors. This CD is
371 no LiveCD but an additional resource that can be exploited during a networkless
372 installation. It contains prebuilt packages (the so-called GRP set) that allows
373 you to easily and quickly install additional applications (such as
374 OpenOffice.org, KDE, GNOME, ...) immediately after the networkless Gentoo
375 installation.
376 </p>
377
378 </body>
379 </subsection>
380 </section>
381 <!-- STOP -->
382 <section>
383 <title>Download, Burn and Boot a Gentoo LiveCD</title>
384 <subsection>
385 <title>Downloading and Burning the LiveCDs</title>
386 <body>
387
388 <p>
389 You have chosen to use a Gentoo LiveCD. We'll first start by downloading and
390 burning the chosen LiveCD. We previously discussed the several available
391 LiveCDs, but where can you find them?
392 </p>
393
394 <p>
395 You can download any of the LiveCDs (and, if you want to, a Packages CD as well)
396 from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The LiveCDs
397 are located in the <path>releases/sparc/2004.3/livecd/sparc64</path> directory.
398 </p>
399
400 <p>
401 Inside that directory you'll find so-called ISO-files. Those are full CD images
402 which you can write on a CD-R.
403 </p>
404
405 <p>
406 In case you wonder if your downloaded file is corrupted or not, you can check its
407 MD5 checksum and compare it with the MD5 checksum we provide (such as
408 <path>install-sparc64-minimal-2004.3.iso.md5</path>). You can check the MD5
409 checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
410 link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
411 </p>
412
413 <p>
414 Another way to check the validity of the downloaded file is to use GnuPG to
415 verify the cryptographic signature that we provide (the file ending with
416 <path>.asc</path>). Download the signature file and obtain the public key:
417 </p>
418
419 <pre caption="Obtaining the public key">
420 $ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i>
421 </pre>
422
423 <p>
424 Now verify the signature:
425 </p>
426
427 <pre caption="Verify the cryptographic signature">
428 $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
429 </pre>
430
431 <p>
432 To burn the downloaded ISO(s), you have to select raw-burning. How you
433 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
434 <c>K3B</c> here; more information can be found in our <uri
435 link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
436 </p>
437
438 <ul>
439 <li>
440 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
441 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
442 path) followed by the path to the ISO file :)
443 </li>
444 <li>
445 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
446 you can locate your ISO file within the 'Image to Burn' area. Finally click
447 <c>Start</c>.
448 </li>
449 </ul>
450
451 </body>
452 </subsection>
453 <subsection>
454 <title>Booting the LiveCD</title>
455 <body>
456
457 <p>
458 Insert the Gentoo LiveCD in the CD-ROM and boot your system. During startup,
459 press Stop-A to enter OpenBootPROM (OBP). Once you are in the OBP, boot from the
460 CD-ROM:
461 </p>
462
463 <pre caption="Booting the LiveCD">
464 ok <i>boot cdrom</i>
465 </pre>
466
467 <p>
468 You will be greeted by the SILO boot manager (on the LiveCD). Type in
469 <c>gentoo-2.4</c> (single-CPU kernel) or <c>gentoo-2.4-smp</c>
470 (multi-CPU kernel) and press enter to continue booting the system. In the
471 following example we'll boot the <c>gentoo-2.4</c> kernel.
472 </p>
473
474 <pre caption="Continue booting from the LiveCD">
475 boot: <i>gentoo-2.4</i>
476 </pre>
477
478 <p>
479 Once the LiveCD is booted, you will be greeted by a login prompt <e>if</e> there
480 is no automated login. If that is the case, log on as <c>root</c>. There is no
481 password, so when you are asked for one, press Enter.
482 </p>
483
484 <pre caption="Logging on onto the LiveCD">
485 login: <i>root</i>
486 password: <comment>(Press Enter here)</comment>
487 </pre>
488
489 <p>
490 You should have a root ("#") prompt on the current console and can also switch
491 to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one you
492 started on by pressing Alt-F1.
493 </p>
494
495 <p>
496 Continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
497 </p>
498
499 </body>
500 </subsection>
501 <subsection id="hardware">
502 <title>Extra Hardware Configuration</title>
503 <body>
504
505 <p>
506 If not all hardware is supported out-of-the-box, you will need to load the
507 appropriate kernel modules.
508 </p>
509
510 <p>
511 In the next example we try to load the <c>8139too</c> module (support for
512 certain kinds of network interfaces):
513 </p>
514
515 <pre caption="Loading kernel modules">
516 # <i>modprobe 8139too</i>
517 </pre>
518
519 </body>
520 </subsection>
521 <subsection>
522 <title>Optional: Tweaking Hard Disk Performance</title>
523 <body>
524
525 <p>
526 If you are an advanced user, you might want to tweak the IDE hard disk
527 performance using <c>hdparm</c>. With the <c>-tT</c> options you can
528 test the performance of your disk (execute it several times to get a
529 more precise impression):
530 </p>
531
532 <pre caption="Testing disk performance">
533 # <i>hdparm -tT /dev/hda</i>
534 </pre>
535
536 <p>
537 To tweak, you can use any of the following examples (or experiment
538 yourself) which use <path>/dev/hda</path> as disk (substitute with your
539 disk):
540 </p>
541
542 <pre caption="Tweaking hard disk performance">
543 <comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
544 <comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
545 </pre>
546
547 </body>
548 </subsection>
549 <subsection id="useraccounts">
550 <title>Optional: User Accounts</title>
551 <body>
552
553 <p>
554 If you plan on giving other people access to your installation
555 environment or you want to chat using <c>irssi</c> without root privileges (for
556 security reasons), you need to create the necessary user accounts and change
557 the root password.
558 </p>
559
560 <p>
561 To change the root password, use the <c>passwd</c> utility:
562 </p>
563
564 <pre caption="Changing the root password">
565 # <i>passwd</i>
566 New password: <comment>(Enter your new password)</comment>
567 Re-enter password: <comment>(Re-enter your password)</comment>
568 </pre>
569
570 <p>
571 To create a user account, we first enter their credentials, followed by
572 its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
573 In the next example, we create a user called &quot;john&quot;.
574 </p>
575
576 <pre caption="Creating a user account">
577 # <i>useradd -m -G users john</i>
578 # <i>passwd john</i>
579 New password: <comment>(Enter john's password)</comment>
580 Re-enter password: <comment>(Re-enter john's password)</comment>
581 </pre>
582
583 <p>
584 You can change your user id from root to the newly created user by using
585 <c>su</c>:
586 </p>
587
588 <pre caption="Changing user id">
589 # <i>su - john</i>
590 </pre>
591
592 </body>
593 </subsection>
594 <subsection>
595 <title>Optional: Viewing Documentation while Installing</title>
596 <body>
597
598 <p>
599 If you want to view the Gentoo Handbook (either from-CD or online) during the
600 installation, make sure you have created a user account (see <uri
601 link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
602 go to a new terminal and log in.
603 </p>
604
605 <p>
606 If you want to view the documentation on the CD you can immediately run
607 <c>links2</c> to read it:
608 </p>
609
610 <pre caption="Viewing the on-CD documentation">
611 # <i>links2 /mnt/cdrom/docs/html/index.html</i>
612 </pre>
613
614 <p>
615 However, it is preferred that you use the online Gentoo Handbook as it will be
616 more recent than the one provided on the CD. You can view it using <c>links2</c>
617 as well, but only after having completed the <e>Configuring your Network</e>
618 chapter (otherwise you won't be able to go on the Internet to view the
619 document):
620 </p>
621
622 <pre caption="Viewing the Online Documentation">
623 # <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml</i>
624 </pre>
625
626 <p>
627 You can go back to your original terminal by pressing <c>Alt-F1</c>.
628 </p>
629
630 </body>
631 </subsection>
632 <subsection>
633 <title>Optional: Starting the SSH Daemon</title>
634 <body>
635
636 <p>
637 If you want to allow other users to access your computer during the
638 Gentoo installation (perhaps because those users are going to help you
639 install Gentoo, or even do it for you), you need to create a user
640 account for them and perhaps even provide them with your root password
641 (<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
642 </p>
643
644 <p>
645 To fire up the SSH daemon, execute the following command:
646 </p>
647
648 <pre caption="Starting the SSH daemon">
649 # <i>/etc/init.d/sshd start</i>
650 </pre>
651
652 <p>
653 To be able to use sshd, you first need to set up your networking. Continue with
654 the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
655 </p>
656
657 </body>
658 </subsection>
659 </section>
660 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20