/[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.31 - (hide annotations) (download) (as text)
Sun Apr 10 11:32:20 2005 UTC (9 years, 4 months ago) by swift
Branch: MAIN
Changes since 1.30: +15 -3 lines
File MIME type: application/xml
Add stage1/2 con that it requires a working Internet connection during the installation

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

  ViewVC Help
Powered by ViewVC 1.1.20