/[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.32 - (show annotations) (download) (as text)
Mon May 23 10:10:53 2005 UTC (9 years, 7 months ago) by neysx
Branch: MAIN
Changes since 1.31: +4 -4 lines
File MIME type: application/xml
#93503 handbook files location changed on InstallCD

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.31 2005/04/10 11:32:20 swift Exp $ -->
8
9 <sections>
10
11 <version>2.2</version>
12 <date>2005-05-23</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 Starting from a stage1 allows you to have total control over the
113 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 If you don't intend to tweak the settings, it is a waste of time
148 </ti>
149 </tr>
150 <tr>
151 <th>-</th>
152 <ti>
153 Requires a working Internet connection during the installation
154 </ti>
155 </tr>
156 </table>
157
158 </body>
159 </subsection>
160 <subsection>
161 <title>A Stage2 Approach</title>
162 <body>
163
164 <p>
165 A <e>stage2</e> is used for building the entire system from a bootstrapped
166 "semi-compiled" state.
167 </p>
168
169 <p>
170 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 </p>
174
175 <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 <ti>It's still not the fastest way to install Gentoo</ti>
199 </tr>
200 <tr>
201 <th>-</th>
202 <ti>You have to accept the optimizations we chose for the bootstrap</ti>
203 </tr>
204 <tr>
205 <th>-</th>
206 <ti>
207 Requires a working Internet connection during the installation
208 </ti>
209 </tr>
210 </table>
211
212 </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 <p>
225 Choosing to go with a stage3 allows for the fastest install of Gentoo
226 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 stability). Stage3 is also required if you want to install Gentoo using
230 prebuilt packages or without a network connection.
231 </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 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 </p>
253
254 </body>
255 </subsection>
256 </section>
257 <section>
258 <title>The Gentoo Installation CDs</title>
259 <subsection>
260 <title>Introduction</title>
261 <body>
262
263 <p>
264 The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
265 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 All Installation CDs allow you to boot, set up networking, initialize your
272 partitions and start installing Gentoo from the Internet. We currently provide
273 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 </p>
277
278 <p>
279 If you wish to install Gentoo without a working Internet connection, please use
280 the installation instructions described in the <uri
281 link="2005.0/index.xml">Gentoo 2005.0 Handbooks</uri>.
282 </p>
283
284 <p>
285 The two Installation CDs that we currently provide are:
286 </p>
287
288 <ul>
289 <li>
290 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 </li>
294 <li>
295 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 </li>
300 </ul>
301
302 <p>
303 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 </p>
314
315 </body>
316 </subsection>
317 <subsection>
318 <title>Gentoo's Minimal Installation CD</title>
319 <body>
320
321 <p>
322 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 </p>
326
327 <table>
328 <tr>
329 <th>Minimal Installation CD</th>
330 <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 Contains no stages, no Portage snapshot, no prebuilt packages and is
347 therefore not suitable for networkless installation
348 </ti>
349 </tr>
350 </table>
351
352 </body>
353 </subsection>
354 <subsection>
355 <title>Gentoo's Universal Installation CD</title>
356 <body>
357
358 <p>
359 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 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 </p>
366
367 <table>
368 <tr>
369 <th>Universal Installation CD</th>
370 <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 <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 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 OpenOffice.org, KDE, GNOME, ...) immediately after the networkless Gentoo
397 installation.
398 </p>
399
400 </body>
401 </subsection>
402 </section>
403 <!-- STOP -->
404 <section>
405 <title>Download, Burn and Boot a Gentoo Installation CD</title>
406 <subsection>
407 <title>Downloading and Burning the Installation CDs</title>
408 <body>
409
410 <p>
411 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 </p>
415
416 <p>
417 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 </p>
422
423 <p>
424 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 </p>
427
428 <p>
429 In case you wonder if your downloaded file is corrupted or not, you can check its
430 MD5 checksum and compare it with the MD5 checksum we provide (such as
431 <path>install-sparc64-minimal-2005.0.iso.md5</path>). You can check the MD5
432 checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
433 link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
434 </p>
435
436 <p>
437 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 $ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i>
444 </pre>
445
446 <p>
447 Now verify the signature:
448 </p>
449
450 <pre caption="Verify the cryptographic signature">
451 $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
452 </pre>
453
454 <p>
455 To burn the downloaded ISO(s), you have to select raw-burning. How you
456 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 </p>
460
461 <ul>
462 <li>
463 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 path).
466 </li>
467 <li>
468 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 <c>Start</c>.
471 </li>
472 </ul>
473
474 </body>
475 </subsection>
476 <subsection>
477 <title>Booting the Installation CD</title>
478 <body>
479
480 <p>
481 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 </p>
485
486 <pre caption="Booting the Installation CD">
487 ok <i>boot cdrom</i>
488 </pre>
489
490 <p>
491 You will be greeted by the SILO boot manager (on the Installation CD). Type in
492 <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 </p>
496
497 <pre caption="Continue booting from the Installation CD">
498 boot: <i>gentoo-2.4</i>
499 </pre>
500
501 <p>
502 Once the Installation CD is booted, you will be automatically logged on to the
503 system.
504 </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 started on by pressing Alt-F1. You will also find a root prompt on the serial
510 console (<path>ttyS0</path>).
511 </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 <subsection id="useraccounts">
540 <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 To create a user account, we first enter their credentials, followed by
562 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 # <i>useradd -m -G users john</i>
568 # <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 # <i>su - john</i>
580 </pre>
581
582 </body>
583 </subsection>
584 <subsection>
585 <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 link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
592 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/handbook/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 <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 To be able to use sshd, you first need to set up your networking. Continue with
644 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