/[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.31 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.31 2005/04/10 11:32:20 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.1</version> 11<version>9.2</version>
12<date>2005-04-10</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>
112Starting from a stage1 allows you to have total control over the
113optimization settings and optional build-time functionality that is
114initially enabled on your system. This makes <e>stage1</e> installs good for
115power users who know what they are doing. It is also a great
116installation method for those who would like to know more about the
117inner 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>
165A <e>stage2</e> is used for building the entire system from a bootstrapped
166"semi-compiled" state.
167</p>
168
169<p>
170Stage2 installs allow you to skip the bootstrap process; doing this
171is fine if you are happy with the optimization settings that we chose
172for 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>
219A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
220built for you. You will only need to build a few packages of which we can't
221decide for you which one to choose.
222</p>
223
224<p>
225Choosing to go with a stage3 allows for the fastest install of Gentoo
226Linux, but also means that your base system will have the optimization
227settings that we chose for you (which to be honest, are good settings
228and were carefully chosen to enhance performance while maintaining
229stability). Stage3 is also required if you want to install Gentoo using
230prebuilt 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>
249You might be interested to know that, if you decide to use different
250optimization settings after having installed Gentoo, you will be able to
251recompile your entire system with the new optimization settings.
252</p>
253
254</body>
255</subsection>
256</section>
257<section> 65<section>
258<title>The Gentoo Installation CDs</title> 66<title>The Gentoo Installation CDs</title>
259<subsection> 67<subsection>
260<title>Introduction</title> 68<title>Introduction</title>
261<body> 69<body>
268</p> 76</p>
269 77
270<p> 78<p>
271All Installation CDs allow you to boot, set up networking, initialize your 79All Installation CDs allow you to boot, set up networking, initialize your
272partitions and start installing Gentoo from the Internet. We currently provide 80partitions and start installing Gentoo from the Internet. We currently provide
273two 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
274as 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
275version of the available packages. 83version of the available packages.
276</p> 84</p>
277 85
278<p> 86<p>
279If 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
280the installation instructions described in the <uri 88the installation instructions described in the <uri
281link="2005.0/index.xml">Gentoo 2005.0 Handbooks</uri>. 89link="2008.0/index.xml">Gentoo 2008.0 Handbooks</uri>.
282</p> 90</p>
283 91
284<p> 92<p>
285The two Installation CDs that we currently provide are: 93The two Installation CDs that we currently provide are:
286</p> 94</p>
291 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
292 continue with the Gentoo installation. 100 continue with the Gentoo installation.
293 </li> 101 </li>
294 <li> 102 <li>
295 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
296 abilities as the Minimal Installation CD. Additionally, it contains a 104 abilities as the Minimal Installation CD. Additionally, it contains
297 stage1 and several stage3 tarballs (optimized for the individual 105 several stage3 tarballs (optimized for the individual subarchitectures).
298 subarchitectures).
299 </li> 106 </li>
300</ul> 107</ul>
301 108
302<p> 109<p>
303We currently only provide Installation CDs for the sparc64 architecture. Users
304of sparc32 can use the experimental netboot images to install Gentoo from.
305More information about netbooting can be found in our <uri
306link="/doc/en/gentoo-sparc-netboot-howto.xml">Gentoo/SPARC Netboot
307HOWTO</uri>.
308</p>
309
310<p>
311To 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
312major advantages and disadvantages of each Installation CD. 111major advantages and disadvantages of each Installation CD.
313</p> 112</p>
314 113
315</body> 114</body>
317<subsection> 116<subsection>
318<title>Gentoo's Minimal Installation CD</title> 117<title>Gentoo's Minimal Installation CD</title>
319<body> 118<body>
320 119
321<p> 120<p>
322The Minimal Installation CD is called <c>install-sparc64-minimal-2005.0.iso</c> 121The Minimal Installation CD is called <c>install-sparc64-minimal-2008.0.iso</c>
323and 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
324install Gentoo, but always with a working Internet connection only. 123install Gentoo, but always with a working Internet connection only.
325</p> 124</p>
326 125
327<table> 126<table>
328<tr> 127<tr>
332<tr> 131<tr>
333 <th>+</th> 132 <th>+</th>
334 <ti>Smallest download</ti> 133 <ti>Smallest download</ti>
335</tr> 134</tr>
336<tr> 135<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> 136 <th>-</th>
345 <ti> 137 <ti>
346 Contains no stages, no Portage snapshot, no prebuilt packages and is 138 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
347 therefore not suitable for networkless installation 139 therefore not suitable for networkless installation
348 </ti> 140 </ti>
349</tr> 141</tr>
350</table> 142</table>
351 143
354<subsection> 146<subsection>
355<title>Gentoo's Universal Installation CD</title> 147<title>Gentoo's Universal Installation CD</title>
356<body> 148<body>
357 149
358<p> 150<p>
359The Universal Installation CD is called 151The Universal Installation CD is called
360<c>install-sparc-universal-2005.0.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
361650 MB CD. You can use this Installation CD to install 153Installation CD to install Gentoo, and you can even use it to install Gentoo
362Gentoo, and you can even use it to install Gentoo without a working internet 154without a working internet connection.
363connection, just in case you want to bring Gentoo to another PC than the one you
364are currently installing Gentoo on :)
365</p> 155</p>
366 156
367<table> 157<table>
368<tr> 158<tr>
369 <th>Universal Installation CD</th> 159 <th>Universal Installation CD</th>
387<subsection> 177<subsection>
388<title>Other CDs</title> 178<title>Other CDs</title>
389<body> 179<body>
390 180
391<p> 181<p>
392You 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
393no Installation CD but an additional resource that can be exploited during a 183Installation CD but an additional resource that can be exploited during a
394networkless installation. It contains prebuilt packages (the so-called GRP set) 184networkless installation. It contains prebuilt packages (also known as the GRP
395that allows you to easily and quickly install additional applications (such as 185set) that allow you to easily and quickly install additional applications
396OpenOffice.org, KDE, GNOME, ...) immediately after the networkless Gentoo 186(such as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless
397installation. 187Gentoo installation.
188</p>
189
190<p>
191If you intend to use the Packages CD to quickly install additional software,
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>
398</p> 210</p>
399 211
400</body> 212</body>
401</subsection> 213</subsection>
402</section> 214</section>
412downloading and burning the chosen Installation CD. We previously discussed 224downloading and burning the chosen Installation CD. We previously discussed
413the several available Installation CDs, but where can you find them? 225the several available Installation CDs, but where can you find them?
414</p> 226</p>
415 227
416<p> 228<p>
417You 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
418CD 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
419Installation CDs are located in the 231Installation CDs are located in the <path><keyval
420<path>releases/sparc/2005.0/installcd/sparc64</path> directory. 232id="release-dir"/>installcd</path> directory.
421</p>
422
423<p> 233</p>
234
235<p>
424Inside 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
425which you can write on a CD-R. 237can write on a CD-R.
426</p> 238</p>
427 239
428<p> 240<p>
429In 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
430MD5 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
431<path>install-sparc64-minimal-2005.0.iso.md5</path>). You can check the MD5 243<path>install-sparc64-minimal-2008.0.iso.DIGESTS</path>). You can check the MD5
432checksum with the <c>md5sum</c> tool under Linux/Unix or <uri 244checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
433link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. 245link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
434</p> 246</p>
435 247
436<p> 248<p>
438verify the cryptographic signature that we provide (the file ending with 250verify the cryptographic signature that we provide (the file ending with
439<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:
440</p> 252</p>
441 253
442<pre caption="Obtaining the public key"> 254<pre caption="Obtaining the public key">
443$ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i> 255$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
444</pre> 256</pre>
445 257
446<p> 258<p>
447Now verify the signature: 259Now verify the signature:
448</p> 260</p>
463 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
464 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
465 path). 277 path).
466 </li> 278 </li>
467 <li> 279 <li>
468 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
469 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>.
470 <c>Start</c>.
471 </li> 282 </li>
472</ul> 283</ul>
473 284
474</body> 285</body>
475</subsection> 286</subsection>
486<pre caption="Booting the Installation CD"> 297<pre caption="Booting the Installation CD">
487ok <i>boot cdrom</i> 298ok <i>boot cdrom</i>
488</pre> 299</pre>
489 300
490<p> 301<p>
491You 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
492<c>gentoo-2.4</c> (single-CPU kernel) or <c>gentoo-2.4-smp</c> 303hit Enter for more help if you want. Type in <c>gentoo</c> and press enter to
493(multi-CPU kernel) and press enter to continue booting the system. In the 304continue booting the system:
494following example we'll boot the <c>gentoo-2.4</c> kernel.
495</p> 305</p>
496 306
497<pre caption="Continue booting from the Installation CD"> 307<pre caption="Continue booting from the Installation CD">
498boot: <i>gentoo-2.4</i> 308boot: <i>gentoo</i>
499</pre> 309</pre>
500 310
501<p> 311<p>
502Once 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
503system. 313system.
504</p> 314</p>
505 315
506<p> 316<p>
507You 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
508to 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>).
509started on by pressing Alt-F1. You will also find a root prompt on the serial
510console (<path>ttyS0</path>).
511</p> 319</p>
512 320
513<p> 321<p>
514Continue with <uri link="#hardware">Extra Hardware Configuration</uri>. 322Continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
515</p> 323</p>
516 324
517</body> 325</body>
518</subsection> 326</subsection>
519<subsection id="hardware">
520<title>Extra Hardware Configuration</title>
521<body>
522 327
523<p>
524If not all hardware is supported out-of-the-box, you will need to load the
525appropriate kernel modules.
526</p>
527
528<p>
529In the next example we try to load the <c>8139too</c> module (support for
530certain 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> 328<subsection>
539<subsection id="useraccounts"> 329<include href="hb-install-bootconfig.xml"/>
540<title>Optional: User Accounts</title>
541<body>
542
543<p>
544If you plan on giving other people access to your installation
545environment or you want to chat using <c>irssi</c> without root privileges (for
546security reasons), you need to create the necessary user accounts and change
547the root password.
548</p>
549
550<p>
551To change the root password, use the <c>passwd</c> utility:
552</p>
553
554<pre caption="Changing the root password">
555# <i>passwd</i>
556New password: <comment>(Enter your new password)</comment>
557Re-enter password: <comment>(Re-enter your password)</comment>
558</pre>
559
560<p>
561To create a user account, we first enter their credentials, followed by
562its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
563In 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>
569New password: <comment>(Enter john's password)</comment>
570Re-enter password: <comment>(Re-enter john's password)</comment>
571</pre>
572
573<p>
574You 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> 330</subsection>
585<title>Optional: Viewing Documentation while Installing</title>
586<body>
587 331
588<p>
589If you want to view the Gentoo Handbook (either from-CD or online) during the
590installation, make sure you have created a user account (see <uri
591link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
592go to a new terminal and log in.
593</p>
594
595<p>
596If 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>
605However, it is preferred that you use the online Gentoo Handbook as it will be
606more recent than the one provided on the CD. You can view it using <c>links2</c>
607as well, but only after having completed the <e>Configuring your Network</e>
608chapter (otherwise you won't be able to go on the Internet to view the
609document):
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>
617You 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>
627If you want to allow other users to access your computer during the
628Gentoo installation (perhaps because those users are going to help you
629install Gentoo, or even do it for you), you need to create a user
630account 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>
635To 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>
643To be able to use sshd, you first need to set up your networking. Continue with
644the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
645</p>
646
647</body>
648</subsection>
649</section> 332</section>
650</sections> 333</sections>

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

  ViewVC Help
Powered by ViewVC 1.1.20