/[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.35 - (hide annotations) (download) (as text)
Sun Oct 9 16:33:54 2005 UTC (9 years, 2 months ago) by swift
Branch: MAIN
Changes since 1.34: +46 -33 lines
File MIME type: application/xml
#105809 - Stage* description updates

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

  ViewVC Help
Powered by ViewVC 1.1.20