/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.35 Revision 1.48
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v 1.35 2005/10/09 16:33:54 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v 1.48 2009/01/26 07:51:05 nightmorph Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>2.5</version> 11<version>9.2</version>
12<date>2005-10-09</date> 12<date>2009-01-25</date>
13 13
14<section> 14<section>
15<title>Hardware Requirements</title> 15<title>Hardware Requirements</title>
16<subsection> 16<subsection>
17<title>Introduction</title> 17<title>Introduction</title>
30 30
31<table> 31<table>
32<tr> 32<tr>
33 <th>Sparc System</th> 33 <th>Sparc System</th>
34 <ti> 34 <ti>
35 Please check the <uri 35 Please check the <uri link="/proj/en/base/sparc/sunhw.xml">Gentoo
36 Linux/SPARC64 Compatibility list</uri> or the <uri
36 link="http://www.ultralinux.org/faq.html#s_2">UltraLinux FAQ</uri> 37 link="http://www.ultralinux.org/faq.html#s_2">UltraLinux FAQ</uri>
37 </ti> 38 </ti>
38</tr> 39</tr>
39<tr> 40<tr>
40 <th>CPU</th> 41 <th>CPU</th>
57</table> 58</table>
58 59
59</body> 60</body>
60</subsection> 61</subsection>
61</section> 62</section>
62<!-- Copy/Paste from hb-install-x86-medium.xml --> 63
63<!-- Warning: The part originally contains "x86" -->
64<!-- START --> 64<!-- START -->
65<section>
66<title>The Gentoo Installation Approaches</title>
67<subsection>
68<title>Introduction</title>
69<body>
70
71<p>
72Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
73A stage file is a tarball (compressed archive) that contains a minimal
74environment.
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>
96To help you decide what stage file you want to use, we have written down the
97major 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>
107A <e>stage1</e> is used when you want to bootstrap and build the entire system
108from scratch.
109</p>
110
111<p>
112This approach builds core system packages that are vital to your system and is
113used by Gentoo developers to prepare the Gentoo release media. It is a great
114installation method for those who would like to learn more about the inner
115workings of bootstrapping, toolchains and the like.
116</p>
117
118<p>
119However, 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
121stage1 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>
167A <e>stage2</e> is used for building the entire system from a bootstrapped
168"semi-compiled" state.
169</p>
170
171<p>
172When you perform a stage2 installation approach, you will build all system
173packages (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
175optimized to your preference.
176</p>
177
178<p>
179However, this installation takes some time and if you do not intend to change
180the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
181default", using this approach only makes sense if your <c>USE</c> variable is
182sufficiently 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>
221A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
222built for you. You will only need to build a few packages (such as system
223logger, networking tools, ...) before you can boot into a base Gentoo
224installation.
225</p>
226
227<p>
228Choosing to go with a stage3 allows for the fastest install of Gentoo
229Linux, but also means that your base system will have the optimization
230settings that we chose for you (which to be honest, are good settings
231and were carefully chosen to enhance performance while maintaining
232stability). Stage3 is also required if you want to install Gentoo using
233prebuilt 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>
254You might be interested to know that, if you decide to use different
255optimization settings after having installed Gentoo, you will be able to
256recompile your entire system with the new optimization settings. The same goes
257for any <c>USE</c> flag changes: Portage is intelligent enough to know what
258packages need to be rebuild.
259</p>
260
261</body>
262</subsection>
263</section>
264
265<section> 65<section>
266<title>The Gentoo Installation CDs</title> 66<title>The Gentoo Installation CDs</title>
267<subsection> 67<subsection>
268<title>Introduction</title> 68<title>Introduction</title>
269<body> 69<body>
276</p> 76</p>
277 77
278<p> 78<p>
279All Installation CDs allow you to boot, set up networking, initialize your 79All Installation CDs allow you to boot, set up networking, initialize your
280partitions and start installing Gentoo from the Internet. We currently provide 80partitions and start installing Gentoo from the Internet. We currently provide
281two Installation CDs which are equaly suitable to install Gentoo from, as long 81two Installation CDs which are equally suitable to install Gentoo from, as long
282as you're planning on performing an Internet-based installation using the latest 82as you're planning on performing an Internet-based installation using the latest
283version of the available packages. 83version of the available packages.
284</p> 84</p>
285 85
286<p> 86<p>
287If you wish to install Gentoo without a working Internet connection, please use 87If you wish to install Gentoo without a working Internet connection, please use
288the installation instructions described in the <uri 88the installation instructions described in the <uri
289link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>. 89link="2008.0/index.xml">Gentoo 2008.0 Handbooks</uri>.
290</p> 90</p>
291 91
292<p> 92<p>
293The two Installation CDs that we currently provide are: 93The two Installation CDs that we currently provide are:
294</p> 94</p>
299 which sole purpose is to boot the system, prepare the networking and 99 which sole purpose is to boot the system, prepare the networking and
300 continue with the Gentoo installation. 100 continue with the Gentoo installation.
301 </li> 101 </li>
302 <li> 102 <li>
303 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same 103 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
304 abilities as the Minimal Installation CD. Additionally, it contains a 104 abilities as the Minimal Installation CD. Additionally, it contains
305 stage1 and several stage3 tarballs (optimized for the individual 105 several stage3 tarballs (optimized for the individual subarchitectures).
306 subarchitectures).
307 </li> 106 </li>
308</ul> 107</ul>
309 108
310<p> 109<p>
311We currently only provide Installation CDs for the sparc64 architecture. Users
312of sparc32 can use the experimental netboot images to install Gentoo from.
313More information about netbooting can be found in our <uri
314link="/doc/en/gentoo-sparc-netboot-howto.xml">Gentoo/SPARC Netboot
315HOWTO</uri>.
316</p>
317
318<p>
319To help you decide which Installation CD you need, we have written down the 110To help you decide which Installation CD you need, we have written down the
320major advantages and disadvantages of each Installation CD. 111major advantages and disadvantages of each Installation CD.
321</p> 112</p>
322 113
323</body> 114</body>
325<subsection> 116<subsection>
326<title>Gentoo's Minimal Installation CD</title> 117<title>Gentoo's Minimal Installation CD</title>
327<body> 118<body>
328 119
329<p> 120<p>
330The Minimal Installation CD is called <c>install-sparc64-minimal-2005.1.iso</c> 121The Minimal Installation CD is called <c>install-sparc64-minimal-2008.0.iso</c>
331and takes up only 130 MB of diskspace. You can use this Installation CD to 122and takes up only 44 MB of diskspace. You can use this Installation CD to
332install Gentoo, but always with a working Internet connection only. 123install Gentoo, but always with a working Internet connection only.
333</p> 124</p>
334 125
335<table> 126<table>
336<tr> 127<tr>
340<tr> 131<tr>
341 <th>+</th> 132 <th>+</th>
342 <ti>Smallest download</ti> 133 <ti>Smallest download</ti>
343</tr> 134</tr>
344<tr> 135<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> 136 <th>-</th>
353 <ti> 137 <ti>
354 Contains no stages, no Portage snapshot, no prebuilt packages and is 138 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
355 therefore not suitable for networkless installation 139 therefore not suitable for networkless installation
356 </ti> 140 </ti>
357</tr> 141</tr>
358</table> 142</table>
359 143
362<subsection> 146<subsection>
363<title>Gentoo's Universal Installation CD</title> 147<title>Gentoo's Universal Installation CD</title>
364<body> 148<body>
365 149
366<p> 150<p>
367The Universal Installation CD is called 151The Universal Installation CD is called
368<c>install-sparc-universal-2005.1.iso</c> and consumes the entire surface of a 152<c>install-sparc64-universal-2008.0.iso</c> and uses 295 MB. You can use this
369650 MB CD. You can use this Installation CD to install 153Installation CD to install Gentoo, and you can even use it to install Gentoo
370Gentoo, and you can even use it to install Gentoo without a working internet 154without a working internet connection.
371connection, just in case you want to bring Gentoo to another PC than the one you
372are currently installing Gentoo on :)
373</p> 155</p>
374 156
375<table> 157<table>
376<tr> 158<tr>
377 <th>Universal Installation CD</th> 159 <th>Universal Installation CD</th>
395<subsection> 177<subsection>
396<title>Other CDs</title> 178<title>Other CDs</title>
397<body> 179<body>
398 180
399<p> 181<p>
400You might find a so-called <e>Package CD</e> on one of our mirrors. This CD is 182You might find a <e>Package CD</e> on one of our mirrors. This CD is not an
401no Installation CD but an additional resource that can be exploited during a 183Installation CD but an additional resource that can be exploited during a
402networkless installation. It contains prebuilt packages (the so-called GRP set) 184networkless installation. It contains prebuilt packages (also known as the GRP
403that allows you to easily and quickly install additional applications (such as 185set) that allow you to easily and quickly install additional applications
404OpenOffice.org, KDE, GNOME, ...) immediately after the networkless Gentoo 186(such as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless
405installation. 187Gentoo installation.
406</p> 188</p>
407 189
408<p> 190<p>
409If you intend to use the Packages CD to quickly install additional software, 191If you intend to use the Packages CD to quickly install additional software,
410make sure that you use the same subarchitecture as the stage-3 tarball you use. 192make sure that you use the same subarchitecture as the stage3 tarball you use.
193</p>
194
195</body>
196</subsection>
197<subsection>
198<title>The Stage3 Tarball</title>
199<body>
200
201<p>
202A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
203to continue the Gentoo installation using the instructions in this manual.
204Previously, the Gentoo Handbook described the installation using one of three
205stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
206official installation method uses the stage3 tarball. If you are interested in
207performing a Gentoo installation using a stage1 or stage2 tarball, please read
208the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
209Using a Stage1 or Stage2 Tarball?</uri>
411</p> 210</p>
412 211
413</body> 212</body>
414</subsection> 213</subsection>
415</section> 214</section>
425downloading and burning the chosen Installation CD. We previously discussed 224downloading and burning the chosen Installation CD. We previously discussed
426the several available Installation CDs, but where can you find them? 225the several available Installation CDs, but where can you find them?
427</p> 226</p>
428 227
429<p> 228<p>
430You can download any of the Installation CDs (and, if you want to, a Packages 229You can download any of the Installation CDs (and, if you want to, a Packages CD
431CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The 230as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
432Installation CDs are located in the 231Installation CDs are located in the <path><keyval
433<path>releases/sparc/2005.1/sparc64/installcd</path> directory. 232id="release-dir"/>installcd</path> directory.
434</p>
435
436<p> 233</p>
234
235<p>
437Inside that directory you'll find so-called ISO-files. Those are full CD images 236Inside that directory you'll find ISO files. Those are full CD images which you
438which you can write on a CD-R. 237can write on a CD-R.
439</p> 238</p>
440 239
441<p> 240<p>
442In case you wonder if your downloaded file is corrupted or not, you can check its 241In case you wonder if your downloaded file is corrupted or not, you can check its
443MD5 checksum and compare it with the MD5 checksum we provide (such as 242MD5 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 243<path>install-sparc64-minimal-2008.0.iso.DIGESTS</path>). You can check the MD5
445checksum with the <c>md5sum</c> tool under Linux/Unix or <uri 244checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
446link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. 245link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
447</p> 246</p>
448 247
449<p> 248<p>
451verify the cryptographic signature that we provide (the file ending with 250verify the cryptographic signature that we provide (the file ending with
452<path>.asc</path>). Download the signature file and obtain the public key: 251<path>.asc</path>). Download the signature file and obtain the public key:
453</p> 252</p>
454 253
455<pre caption="Obtaining the public key"> 254<pre caption="Obtaining the public key">
456$ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i> 255$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
457</pre> 256</pre>
458 257
459<p> 258<p>
460Now verify the signature: 259Now verify the signature:
461</p> 260</p>
476 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso 275 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 276 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
478 path). 277 path).
479 </li> 278 </li>
480 <li> 279 <li>
481 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then 280 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
482 you can locate your ISO file within the 'Image to Burn' area. Finally click 281 your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
483 <c>Start</c>.
484 </li> 282 </li>
485</ul> 283</ul>
486 284
487</body> 285</body>
488</subsection> 286</subsection>
499<pre caption="Booting the Installation CD"> 297<pre caption="Booting the Installation CD">
500ok <i>boot cdrom</i> 298ok <i>boot cdrom</i>
501</pre> 299</pre>
502 300
503<p> 301<p>
504You will be greeted by the SILO boot manager (on the Installation CD). Type in 302You will be greeted by the SILO boot manager (on the Installation CD). You can
505<c>gentoo-2.4</c> and press enter to continue booting the 303hit Enter for more help if you want. Type in <c>gentoo</c> and press enter to
506system: 304continue booting the system:
507</p> 305</p>
508 306
509<pre caption="Continue booting from the Installation CD"> 307<pre caption="Continue booting from the Installation CD">
510boot: <i>gentoo-2.4</i> 308boot: <i>gentoo</i>
511</pre> 309</pre>
512 310
513<p> 311<p>
514Once the Installation CD is booted, you will be automatically logged on to the 312Once the Installation CD is booted, you will be automatically logged on to the
515system. 313system.
516</p> 314</p>
517 315
518<p> 316<p>
519You should have a root ("#") prompt on the current console and can also switch 317You should have a root ("#") prompt on the current console. You will also find a
520to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one you 318root prompt on the serial console (<path>ttyS0</path>).
521started on by pressing Alt-F1. You will also find a root prompt on the serial
522console (<path>ttyS0</path>).
523</p> 319</p>
524 320
525<p> 321<p>
526Continue with <uri link="#hardware">Extra Hardware Configuration</uri>. 322Continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
527</p> 323</p>
528 324
529</body> 325</body>
530</subsection> 326</subsection>
531<subsection id="hardware">
532<title>Extra Hardware Configuration</title>
533<body>
534 327
535<p>
536If not all hardware is supported out-of-the-box, you will need to load the
537appropriate kernel modules.
538</p>
539
540<p>
541In the next example we try to load the <c>8139too</c> module (support for
542certain 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> 328<subsection>
551<subsection id="useraccounts"> 329<include href="hb-install-bootconfig.xml"/>
552<title>Optional: User Accounts</title>
553<body>
554
555<p>
556If you plan on giving other people access to your installation
557environment or you want to chat using <c>irssi</c> without root privileges (for
558security reasons), you need to create the necessary user accounts and change
559the root password.
560</p>
561
562<p>
563To change the root password, use the <c>passwd</c> utility:
564</p>
565
566<pre caption="Changing the root password">
567# <i>passwd</i>
568New password: <comment>(Enter your new password)</comment>
569Re-enter password: <comment>(Re-enter your password)</comment>
570</pre>
571
572<p>
573To create a user account, we first enter their credentials, followed by
574its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
575In 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>
581New password: <comment>(Enter john's password)</comment>
582Re-enter password: <comment>(Re-enter john's password)</comment>
583</pre>
584
585<p>
586You 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> 330</subsection>
597<title>Optional: Viewing Documentation while Installing</title>
598<body>
599 331
600<p>
601If you want to view the Gentoo Handbook (either from-CD or online) during the
602installation, make sure you have created a user account (see <uri
603link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
604go to a new terminal and log in.
605</p>
606
607<p>
608If 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>
617However, it is preferred that you use the online Gentoo Handbook as it will be
618more recent than the one provided on the CD. You can view it using <c>links2</c>
619as well, but only after having completed the <e>Configuring your Network</e>
620chapter (otherwise you won't be able to go on the Internet to view the
621document):
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>
629You 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>
639If you want to allow other users to access your computer during the
640Gentoo installation (perhaps because those users are going to help you
641install Gentoo, or even do it for you), you need to create a user
642account 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>
647To 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>
655To be able to use sshd, you first need to set up your networking. Continue with
656the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
657</p>
658
659</body>
660</subsection>
661</section> 332</section>
662</sections> 333</sections>

Legend:
Removed from v.1.35  
changed lines
  Added in v.1.48

  ViewVC Help
Powered by ViewVC 1.1.20