/[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.28 - (hide annotations) (download) (as text)
Mon Feb 14 15:51:45 2005 UTC (9 years, 5 months ago) by swift
Branch: MAIN
Changes since 1.27: +2 -2 lines
File MIME type: application/xml
#81843 - Fix typo whish - wish

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     <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
6    
7 swift 1.28 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v 1.27 2005/02/13 22:29:48 so Exp $ -->
8 swift 1.1
9     <sections>
10 swift 1.21
11 swift 1.26 <version>1.22</version>
12     <date>2005-01-04</date>
13 swift 1.21
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.26 successfully install Gentoo on your box.
23 swift 1.1 </p>
24    
25     </body>
26     </subsection>
27     <subsection>
28 swift 1.26 <title>Hardware Requirements</title>
29 swift 1.1 <body>
30    
31 swift 1.26 <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 swift 1.1
59     </body>
60     </subsection>
61     </section>
62 swift 1.26 <!-- Copy/Paste from hb-install-x86-medium.xml -->
63     <!-- Warning: The part originally contains "x86" -->
64     <!-- START -->
65 swift 1.1 <section>
66 swift 1.26 <title>The Gentoo Installation Approaches</title>
67 swift 1.1 <subsection>
68     <title>Introduction</title>
69     <body>
70    
71     <p>
72 swift 1.26 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 swift 1.1 </p>
76    
77     <ul>
78 swift 1.26 <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 swift 1.1 </ul>
94    
95     <p>
96 swift 1.26 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 swift 1.1 </p>
99    
100     </body>
101     </subsection>
102     <subsection>
103 swift 1.26 <title>A Stage1 Approach</title>
104 swift 1.1 <body>
105    
106     <p>
107 swift 1.26 A <e>stage1</e> is used when you want to bootstrap and build the entire system
108     from scratch.
109 swift 1.1 </p>
110    
111     <p>
112 swift 1.26 Starting from a stage1 allows you to have total control over the
113 swift 1.1 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 swift 1.26 If you don't intend to tweak the settings, it is a waste of time
148 swift 1.8 </ti>
149     </tr>
150 swift 1.1 </table>
151    
152 swift 1.26 </body>
153     </subsection>
154     <subsection>
155     <title>A Stage2 Approach</title>
156     <body>
157    
158 swift 1.1 <p>
159 swift 1.26 A <e>stage2</e> is used for building the entire system from a bootstrapped
160     "semi-compiled" state.
161 swift 1.1 </p>
162    
163 swift 1.8 <p>
164 swift 1.26 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 swift 1.8 </p>
168    
169 swift 1.1 <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 swift 1.26 <ti>It's still not the fastest way to install Gentoo</ti>
193 swift 1.1 </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 swift 1.26 </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 swift 1.1 <p>
213 swift 1.26 Choosing to go with a stage3 allows for the fastest install of Gentoo
214 swift 1.1 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 swift 1.26 stability). Stage3 is also required if you want to install Gentoo using
218 swift 1.7 prebuilt packages or without a network connection.
219 swift 1.1 </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 swift 1.26 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 swift 1.1 </p>
241    
242     </body>
243     </subsection>
244 swift 1.26 </section>
245     <section>
246     <title>The Gentoo LiveCDs</title>
247 swift 1.1 <subsection>
248 swift 1.26 <title>Introduction</title>
249 swift 1.1 <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 swift 1.18 All LiveCDs allow you to boot, set up networking, initialize your
260 swift 1.26 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 swift 1.1 </p>
265    
266     <p>
267 swift 1.28 If you wish to install Gentoo without a working Internet connection, please use
268 swift 1.26 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 swift 1.1 </p>
293    
294     </body>
295     </subsection>
296     <subsection>
297     <title>Gentoo's Minimal LiveCD</title>
298     <body>
299    
300     <p>
301 swift 1.26 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 swift 1.1 </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 swift 1.26 Contains no stages, no Portage snapshot, no prebuilt packages and is
326     therefore not suitable for networkless installation
327 swift 1.1 </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 swift 1.26 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 swift 1.9 </p>
344    
345 swift 1.1 <table>
346     <tr>
347 swift 1.26 <th>Universal LiveCD</th>
348 swift 1.1 <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 swift 1.26 <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 swift 1.1 </section>
381 swift 1.26 <!-- STOP -->
382 swift 1.1 <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 swift 1.26 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 swift 1.1 </p>
399    
400     <p>
401 swift 1.26 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 swift 1.1 </p>
404    
405     <p>
406 so 1.27 In case you wonder if your downloaded file is corrupted or not, you can check its
407 swift 1.26 MD5 checksum and compare it with the MD5 checksum we provide (such as
408 swift 1.22 <path>install-sparc64-minimal-2004.3.iso.md5</path>). You can check the MD5
409 swift 1.1 checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
410 neysx 1.13 link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
411 swift 1.1 </p>
412    
413     <p>
414 swift 1.10 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 swift 1.14 $ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i>
421 swift 1.10 </pre>
422    
423     <p>
424     Now verify the signature:
425     </p>
426    
427     <pre caption="Verify the cryptographic signature">
428 swift 1.14 $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
429 swift 1.10 </pre>
430    
431     <p>
432 swift 1.1 To burn the downloaded ISO(s), you have to select raw-burning. How you
433 swift 1.11 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 swift 1.1 </p>
437    
438     <ul>
439     <li>
440 swift 1.26 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 swift 1.1 </li>
444 swift 1.2 <li>
445 bennyc 1.5 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 swift 1.2 <c>Start</c>.
448     </li>
449 swift 1.1 </ul>
450    
451     </body>
452     </subsection>
453     <subsection>
454 swift 1.26 <title>Booting the LiveCD</title>
455 swift 1.1 <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 swift 1.6 <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 swift 1.1 </p>
473    
474     <pre caption="Continue booting from the LiveCD">
475 swift 1.6 boot: <i>gentoo-2.4</i>
476 swift 1.1 </pre>
477    
478     <p>
479 swift 1.25 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 swift 1.1 </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 swift 1.15 <subsection id="useraccounts">
550 swift 1.1 <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 swift 1.4 To create a user account, we first enter their credentials, followed by
572 swift 1.1 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 swift 1.19 # <i>useradd -m -G users john</i>
578 swift 1.1 # <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 swift 1.16 # <i>su - john</i>
590 swift 1.1 </pre>
591    
592     </body>
593     </subsection>
594     <subsection>
595 swift 1.15 <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 neysx 1.20 link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
602 swift 1.15 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 swift 1.1 <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 swift 1.18 To be able to use sshd, you first need to set up your networking. Continue with
654 swift 1.1 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