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

1 <?xml version='1.0' encoding='UTF-8'?>
2 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3
4 <!-- The content of this document is licensed under the CC-BY-SA license -->
5 <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
6
7 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v 1.34 2005/09/05 15:22:02 neysx Exp $ -->
8
9 <sections>
10
11 <version>2.5</version>
12 <date>2005-10-09</date>
13
14 <section>
15 <title>Hardware Requirements</title>
16 <subsection>
17 <title>Introduction</title>
18 <body>
19
20 <p>
21 Before we start, we first list what hardware requirements you need to
22 successfully install Gentoo on your box.
23 </p>
24
25 </body>
26 </subsection>
27 <subsection>
28 <title>Hardware Requirements</title>
29 <body>
30
31 <table>
32 <tr>
33 <th>Sparc System</th>
34 <ti>
35 Please check the <uri
36 link="http://www.ultralinux.org/faq.html#s_2">UltraLinux FAQ</uri>
37 </ti>
38 </tr>
39 <tr>
40 <th>CPU</th>
41 <ti>
42 We currently only support sparc64 CPUs
43 </ti>
44 </tr>
45 <tr>
46 <th>Memory</th>
47 <ti>64 MB</ti>
48 </tr>
49 <tr>
50 <th>Diskspace</th>
51 <ti>1.5 GB (excluding swap space)</ti>
52 </tr>
53 <tr>
54 <th>Swap space</th>
55 <ti>At least 256 MB</ti>
56 </tr>
57 </table>
58
59 </body>
60 </subsection>
61 </section>
62 <!-- Copy/Paste from hb-install-x86-medium.xml -->
63 <!-- Warning: The part originally contains "x86" -->
64 <!-- START -->
65 <section>
66 <title>The Gentoo Installation Approaches</title>
67 <subsection>
68 <title>Introduction</title>
69 <body>
70
71 <p>
72 Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
73 A stage file is a tarball (compressed archive) that contains a minimal
74 environment.
75 </p>
76
77 <ul>
78 <li>
79 A stage1 file contains nothing more than a compiler, Portage (Gentoo's
80 software management system) and a couple of packages on which the compiler
81 or Portage depends.
82 </li>
83 <li>
84 A stage2 file contains a so-called bootstrapped system, a minimal
85 environment from which one can start building all other necessary
86 applications that make a Gentoo environment complete.
87 </li>
88 <li>
89 A stage3 file contains a prebuilt minimal system which is almost fully
90 deployable. It only lacks a few applications where you, the Gentoo user,
91 needs to choose which one you want to install.
92 </li>
93 </ul>
94
95 <p>
96 To help you decide what stage file you want to use, we have written down the
97 major advantages and disadvantages of each stage file.
98 </p>
99
100 </body>
101 </subsection>
102 <subsection>
103 <title>A Stage1 Approach</title>
104 <body>
105
106 <p>
107 A <e>stage1</e> is used when you want to bootstrap and build the entire system
108 from scratch.
109 </p>
110
111 <p>
112 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 </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 Allows you to have total control over the installation routine, bootstrap
133 sequence, etc.
134 </ti>
135 </tr>
136 <tr>
137 <th>+</th>
138 <ti>Suitable for powerusers and developers who know what they are doing</ti>
139 </tr>
140 <tr>
141 <th>-</th>
142 <ti>
143 Takes a long time to finish the installation (it is the lengthiest approach)
144 </ti>
145 </tr>
146 <tr>
147 <th>-</th>
148 <ti>
149 If you don't intend to tweak the settings, it is a waste of time
150 </ti>
151 </tr>
152 <tr>
153 <th>-</th>
154 <ti>
155 Requires a working Internet connection during the installation
156 </ti>
157 </tr>
158 </table>
159
160 </body>
161 </subsection>
162 <subsection>
163 <title>A Stage2 Approach</title>
164 <body>
165
166 <p>
167 A <e>stage2</e> is used for building the entire system from a bootstrapped
168 "semi-compiled" state.
169 </p>
170
171 <p>
172 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 </p>
184
185 <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 <ti>It's still not the fastest way to install Gentoo</ti>
205 </tr>
206 <tr>
207 <th>-</th>
208 <ti>
209 Requires a working Internet connection during the installation
210 </ti>
211 </tr>
212 </table>
213
214 </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 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 </p>
226
227 <p>
228 Choosing to go with a stage3 allows for the fastest install of Gentoo
229 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 stability). Stage3 is also required if you want to install Gentoo using
233 prebuilt packages or without a network connection.
234 </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 <th>+</th>
247 <ti>
248 You can still tweak your system
249 </ti>
250 </tr>
251 </table>
252
253 <p>
254 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 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 </p>
260
261 </body>
262 </subsection>
263 </section>
264
265 <section>
266 <title>The Gentoo Installation CDs</title>
267 <subsection>
268 <title>Introduction</title>
269 <body>
270
271 <p>
272 The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
273 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 All Installation CDs allow you to boot, set up networking, initialize your
280 partitions and start installing Gentoo from the Internet. We currently provide
281 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 </p>
285
286 <p>
287 If you wish to install Gentoo without a working Internet connection, please use
288 the installation instructions described in the <uri
289 link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>.
290 </p>
291
292 <p>
293 The two Installation CDs that we currently provide are:
294 </p>
295
296 <ul>
297 <li>
298 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 </li>
302 <li>
303 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 </li>
308 </ul>
309
310 <p>
311 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 </p>
322
323 </body>
324 </subsection>
325 <subsection>
326 <title>Gentoo's Minimal Installation CD</title>
327 <body>
328
329 <p>
330 The Minimal Installation CD is called <c>install-sparc64-minimal-2005.1.iso</c>
331 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 </p>
334
335 <table>
336 <tr>
337 <th>Minimal Installation CD</th>
338 <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 Contains no stages, no Portage snapshot, no prebuilt packages and is
355 therefore not suitable for networkless installation
356 </ti>
357 </tr>
358 </table>
359
360 </body>
361 </subsection>
362 <subsection>
363 <title>Gentoo's Universal Installation CD</title>
364 <body>
365
366 <p>
367 The Universal Installation CD is called
368 <c>install-sparc-universal-2005.1.iso</c> and consumes the entire surface of a
369 650 MB CD. You can use this Installation CD to install
370 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 </p>
374
375 <table>
376 <tr>
377 <th>Universal Installation CD</th>
378 <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 <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 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 OpenOffice.org, KDE, GNOME, ...) immediately after the networkless Gentoo
405 installation.
406 </p>
407
408 <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 </body>
414 </subsection>
415 </section>
416 <!-- STOP -->
417 <section>
418 <title>Download, Burn and Boot a Gentoo Installation CD</title>
419 <subsection>
420 <title>Downloading and Burning the Installation CDs</title>
421 <body>
422
423 <p>
424 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 </p>
428
429 <p>
430 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 <path>releases/sparc/2005.1/sparc64/installcd</path> directory.
434 </p>
435
436 <p>
437 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 </p>
440
441 <p>
442 In case you wonder if your downloaded file is corrupted or not, you can check its
443 MD5 checksum and compare it with the MD5 checksum we provide (such as
444 <path>install-sparc64-minimal-2005.1.iso.md5</path>). You can check the MD5
445 checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
446 link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
447 </p>
448
449 <p>
450 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 $ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i>
457 </pre>
458
459 <p>
460 Now verify the signature:
461 </p>
462
463 <pre caption="Verify the cryptographic signature">
464 $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
465 </pre>
466
467 <p>
468 To burn the downloaded ISO(s), you have to select raw-burning. How you
469 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 </p>
473
474 <ul>
475 <li>
476 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 path).
479 </li>
480 <li>
481 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 <c>Start</c>.
484 </li>
485 </ul>
486
487 </body>
488 </subsection>
489 <subsection>
490 <title>Booting the Installation CD</title>
491 <body>
492
493 <p>
494 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 </p>
498
499 <pre caption="Booting the Installation CD">
500 ok <i>boot cdrom</i>
501 </pre>
502
503 <p>
504 You will be greeted by the SILO boot manager (on the Installation CD). Type in
505 <c>gentoo-2.4</c> and press enter to continue booting the
506 system:
507 </p>
508
509 <pre caption="Continue booting from the Installation CD">
510 boot: <i>gentoo-2.4</i>
511 </pre>
512
513 <p>
514 Once the Installation CD is booted, you will be automatically logged on to the
515 system.
516 </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 started on by pressing Alt-F1. You will also find a root prompt on the serial
522 console (<path>ttyS0</path>).
523 </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 <subsection id="useraccounts">
552 <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 To create a user account, we first enter their credentials, followed by
574 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 # <i>useradd -m -G users john</i>
580 # <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 # <i>su - john</i>
592 </pre>
593
594 </body>
595 </subsection>
596 <subsection>
597 <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 link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
604 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 # <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
614 </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 <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 To be able to use sshd, you first need to set up your networking. Continue with
656 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