/[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.30 - (hide annotations) (download) (as text)
Mon Mar 28 11:30:53 2005 UTC (9 years, 5 months ago) by swift
Branch: MAIN
Changes since 1.29: +62 -84 lines
File MIME type: application/xml
Updating docos to 2005.0

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.30 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v 1.29 2005/02/14 15:55:13 swift Exp $ -->
8 swift 1.1
9     <sections>
10 swift 1.21
11 swift 1.30 <version>2.00</version>
12     <date>2005-03-28</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 swift 1.30 <title>The Gentoo Installation CDs</title>
247 swift 1.1 <subsection>
248 swift 1.26 <title>Introduction</title>
249 swift 1.1 <body>
250    
251     <p>
252 swift 1.30 The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
253 swift 1.1 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.30 All Installation CDs 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 swift 1.30 two Installation CDs which are equaly suitable to install Gentoo from, as long
262     as you're planning on performing an Internet-based installation using the latest
263     version 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 swift 1.30 link="2005.0/index.xml">Gentoo 2005.0 Handbooks</uri>.
270 swift 1.26 </p>
271    
272     <p>
273 swift 1.30 The two Installation CDs that we currently provide are:
274 swift 1.26 </p>
275    
276     <ul>
277     <li>
278 swift 1.30 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable CD
279     which sole purpose is to boot the system, prepare the networking and
280     continue with the Gentoo installation.
281 swift 1.26 </li>
282     <li>
283 swift 1.30 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
284     abilities as the Minimal Installation CD. Additionally, it contains a
285     stage1 and several stage3 tarballs (optimized for the individual
286     subarchitectures).
287 swift 1.26 </li>
288     </ul>
289    
290     <p>
291 swift 1.30 We currently only provide Installation CDs for the sparc64 architecture. Users
292     of sparc32 can use the experimental netboot images to install Gentoo from.
293     More information about netbooting can be found in our <uri
294     link="/doc/en/gentoo-sparc-netboot-howto.xml">Gentoo/SPARC Netboot
295     HOWTO</uri>.
296     </p>
297    
298     <p>
299     To help you decide which Installation CD you need, we have written down the
300     major advantages and disadvantages of each Installation CD.
301 swift 1.1 </p>
302    
303     </body>
304     </subsection>
305     <subsection>
306 swift 1.30 <title>Gentoo's Minimal Installation CD</title>
307 swift 1.1 <body>
308    
309     <p>
310 swift 1.30 The Minimal Installation CD is called <c>install-sparc64-minimal-2005.0.iso</c>
311     and takes up only 130 MB of diskspace. You can use this Installation CD to
312     install Gentoo, but always with a working Internet connection only.
313 swift 1.1 </p>
314    
315     <table>
316     <tr>
317 swift 1.30 <th>Minimal Installation CD</th>
318 swift 1.1 <th>Pros and Cons</th>
319     </tr>
320     <tr>
321     <th>+</th>
322     <ti>Smallest download</ti>
323     </tr>
324     <tr>
325     <th>+</th>
326     <ti>
327     You can do a stage1, stage2 or stage3 by getting the stage tarball off the
328     net
329     </ti>
330     </tr>
331     <tr>
332     <th>-</th>
333     <ti>
334 swift 1.26 Contains no stages, no Portage snapshot, no prebuilt packages and is
335     therefore not suitable for networkless installation
336 swift 1.1 </ti>
337     </tr>
338     </table>
339    
340     </body>
341     </subsection>
342     <subsection>
343 swift 1.30 <title>Gentoo's Universal Installation CD</title>
344 swift 1.1 <body>
345    
346     <p>
347 swift 1.30 The Universal Installation CD is called
348     <c>install-sparc-universal-2005.0.iso</c> and consumes the entire surface of a
349     650 MB CD. You can use this Installation CD to install
350 swift 1.26 Gentoo, and you can even use it to install Gentoo without a working internet
351     connection, just in case you want to bring Gentoo to another PC than the one you
352     are currently installing Gentoo on :)
353 swift 1.9 </p>
354    
355 swift 1.1 <table>
356     <tr>
357 swift 1.30 <th>Universal Installation CD</th>
358 swift 1.1 <th>Pros and Cons</th>
359     </tr>
360     <tr>
361     <th>+</th>
362     <ti>
363     Contains everything you need. You can even install without a network
364     connection.
365     </ti>
366     </tr>
367     <tr>
368     <th>-</th>
369     <ti>Huge download</ti>
370     </tr>
371     </table>
372    
373     </body>
374     </subsection>
375 swift 1.26 <subsection>
376     <title>Other CDs</title>
377     <body>
378    
379     <p>
380     You might find a so-called <e>Package CD</e> on one of our mirrors. This CD is
381 swift 1.30 no Installation CD but an additional resource that can be exploited during a
382     networkless installation. It contains prebuilt packages (the so-called GRP set)
383     that allows you to easily and quickly install additional applications (such as
384 swift 1.26 OpenOffice.org, KDE, GNOME, ...) immediately after the networkless Gentoo
385     installation.
386     </p>
387    
388     </body>
389     </subsection>
390 swift 1.1 </section>
391 swift 1.26 <!-- STOP -->
392 swift 1.1 <section>
393 swift 1.30 <title>Download, Burn and Boot a Gentoo Installation CD</title>
394 swift 1.1 <subsection>
395 swift 1.30 <title>Downloading and Burning the Installation CDs</title>
396 swift 1.1 <body>
397    
398     <p>
399 swift 1.30 You have chosen to use a Gentoo Installation CD. We'll first start by
400     downloading and burning the chosen Installation CD. We previously discussed
401     the several available Installation CDs, but where can you find them?
402 swift 1.26 </p>
403    
404     <p>
405 swift 1.30 You can download any of the Installation CDs (and, if you want to, a Packages
406     CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
407     Installation CDs are located in the
408     <path>releases/sparc/2005.0/installcd/sparc64</path> directory.
409 swift 1.1 </p>
410    
411     <p>
412 swift 1.26 Inside that directory you'll find so-called ISO-files. Those are full CD images
413     which you can write on a CD-R.
414 swift 1.1 </p>
415    
416     <p>
417 so 1.27 In case you wonder if your downloaded file is corrupted or not, you can check its
418 swift 1.26 MD5 checksum and compare it with the MD5 checksum we provide (such as
419 swift 1.30 <path>install-sparc64-minimal-2005.0.iso.md5</path>). You can check the MD5
420 swift 1.1 checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
421 neysx 1.13 link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
422 swift 1.1 </p>
423    
424     <p>
425 swift 1.10 Another way to check the validity of the downloaded file is to use GnuPG to
426     verify the cryptographic signature that we provide (the file ending with
427     <path>.asc</path>). Download the signature file and obtain the public key:
428     </p>
429    
430     <pre caption="Obtaining the public key">
431 swift 1.14 $ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i>
432 swift 1.10 </pre>
433    
434     <p>
435     Now verify the signature:
436     </p>
437    
438     <pre caption="Verify the cryptographic signature">
439 swift 1.14 $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
440 swift 1.10 </pre>
441    
442     <p>
443 swift 1.1 To burn the downloaded ISO(s), you have to select raw-burning. How you
444 swift 1.11 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
445     <c>K3B</c> here; more information can be found in our <uri
446     link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
447 swift 1.1 </p>
448    
449     <ul>
450     <li>
451 swift 1.26 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
452     file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
453 swift 1.29 path).
454 swift 1.1 </li>
455 swift 1.2 <li>
456 bennyc 1.5 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
457     you can locate your ISO file within the 'Image to Burn' area. Finally click
458 swift 1.2 <c>Start</c>.
459     </li>
460 swift 1.1 </ul>
461    
462     </body>
463     </subsection>
464     <subsection>
465 swift 1.30 <title>Booting the Installation CD</title>
466 swift 1.1 <body>
467    
468     <p>
469 swift 1.30 Insert the Gentoo Installation CD in the CD-ROM and boot your system. During
470     startup, press Stop-A to enter OpenBootPROM (OBP). Once you are in the OBP,
471     boot from the CD-ROM:
472 swift 1.1 </p>
473    
474 swift 1.30 <pre caption="Booting the Installation CD">
475 swift 1.1 ok <i>boot cdrom</i>
476     </pre>
477    
478     <p>
479 swift 1.30 You will be greeted by the SILO boot manager (on the Installation CD). Type in
480 swift 1.6 <c>gentoo-2.4</c> (single-CPU kernel) or <c>gentoo-2.4-smp</c>
481     (multi-CPU kernel) and press enter to continue booting the system. In the
482     following example we'll boot the <c>gentoo-2.4</c> kernel.
483 swift 1.1 </p>
484    
485 swift 1.30 <pre caption="Continue booting from the Installation CD">
486 swift 1.6 boot: <i>gentoo-2.4</i>
487 swift 1.1 </pre>
488    
489     <p>
490 swift 1.30 Once the Installation CD is booted, you will be automatically logged on to the
491     system.
492 swift 1.1 </p>
493    
494     <p>
495     You should have a root ("#") prompt on the current console and can also switch
496     to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one you
497 swift 1.30 started on by pressing Alt-F1. You will also find a root prompt on the serial
498     console (<path>ttyS0</path>).
499 swift 1.1 </p>
500    
501     <p>
502     Continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
503     </p>
504    
505     </body>
506     </subsection>
507     <subsection id="hardware">
508     <title>Extra Hardware Configuration</title>
509     <body>
510    
511     <p>
512     If not all hardware is supported out-of-the-box, you will need to load the
513     appropriate kernel modules.
514     </p>
515    
516     <p>
517     In the next example we try to load the <c>8139too</c> module (support for
518     certain kinds of network interfaces):
519     </p>
520    
521     <pre caption="Loading kernel modules">
522     # <i>modprobe 8139too</i>
523     </pre>
524    
525     </body>
526     </subsection>
527 swift 1.15 <subsection id="useraccounts">
528 swift 1.1 <title>Optional: User Accounts</title>
529     <body>
530    
531     <p>
532     If you plan on giving other people access to your installation
533     environment or you want to chat using <c>irssi</c> without root privileges (for
534     security reasons), you need to create the necessary user accounts and change
535     the root password.
536     </p>
537    
538     <p>
539     To change the root password, use the <c>passwd</c> utility:
540     </p>
541    
542     <pre caption="Changing the root password">
543     # <i>passwd</i>
544     New password: <comment>(Enter your new password)</comment>
545     Re-enter password: <comment>(Re-enter your password)</comment>
546     </pre>
547    
548     <p>
549 swift 1.4 To create a user account, we first enter their credentials, followed by
550 swift 1.1 its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
551     In the next example, we create a user called &quot;john&quot;.
552     </p>
553    
554     <pre caption="Creating a user account">
555 swift 1.19 # <i>useradd -m -G users john</i>
556 swift 1.1 # <i>passwd john</i>
557     New password: <comment>(Enter john's password)</comment>
558     Re-enter password: <comment>(Re-enter john's password)</comment>
559     </pre>
560    
561     <p>
562     You can change your user id from root to the newly created user by using
563     <c>su</c>:
564     </p>
565    
566     <pre caption="Changing user id">
567 swift 1.16 # <i>su - john</i>
568 swift 1.1 </pre>
569    
570     </body>
571     </subsection>
572     <subsection>
573 swift 1.15 <title>Optional: Viewing Documentation while Installing</title>
574     <body>
575    
576     <p>
577     If you want to view the Gentoo Handbook (either from-CD or online) during the
578     installation, make sure you have created a user account (see <uri
579 neysx 1.20 link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
580 swift 1.15 go to a new terminal and log in.
581     </p>
582    
583     <p>
584     If you want to view the documentation on the CD you can immediately run
585     <c>links2</c> to read it:
586     </p>
587    
588     <pre caption="Viewing the on-CD documentation">
589     # <i>links2 /mnt/cdrom/docs/html/index.html</i>
590     </pre>
591    
592     <p>
593     However, it is preferred that you use the online Gentoo Handbook as it will be
594     more recent than the one provided on the CD. You can view it using <c>links2</c>
595     as well, but only after having completed the <e>Configuring your Network</e>
596     chapter (otherwise you won't be able to go on the Internet to view the
597     document):
598     </p>
599    
600     <pre caption="Viewing the Online Documentation">
601     # <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml</i>
602     </pre>
603    
604     <p>
605     You can go back to your original terminal by pressing <c>Alt-F1</c>.
606     </p>
607    
608     </body>
609     </subsection>
610     <subsection>
611 swift 1.1 <title>Optional: Starting the SSH Daemon</title>
612     <body>
613    
614     <p>
615     If you want to allow other users to access your computer during the
616     Gentoo installation (perhaps because those users are going to help you
617     install Gentoo, or even do it for you), you need to create a user
618     account for them and perhaps even provide them with your root password
619     (<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
620     </p>
621    
622     <p>
623     To fire up the SSH daemon, execute the following command:
624     </p>
625    
626     <pre caption="Starting the SSH daemon">
627     # <i>/etc/init.d/sshd start</i>
628     </pre>
629    
630     <p>
631 swift 1.18 To be able to use sshd, you first need to set up your networking. Continue with
632 swift 1.1 the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
633     </p>
634    
635     </body>
636     </subsection>
637     </section>
638     </sections>

  ViewVC Help
Powered by ViewVC 1.1.20