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

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

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

Revision 1.36 Revision 1.37
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/1.0 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml,v 1.36 2005/10/09 16:33:54 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml,v 1.37 2005/11/11 17:27:15 swift Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>2.8</version> 11<version>2.9</version>
12<date>2005-10-09</date> 12<date>2005-11-11</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>
51</table> 51</table>
52 52
53</body> 53</body>
54</subsection> 54</subsection>
55</section> 55</section>
56
56<!-- Copy/paste from the hb-install-x86-medium.xml file. --> 57<!-- Copy/paste from hb-install-x86-medium.xml -->
57<!-- START --> 58<!-- START -->
58<section>
59<title>The Gentoo Installation Approaches</title>
60<subsection>
61<title>Introduction</title>
62<body>
63
64<p>
65Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
66A stage file is a tarball (compressed archive) that contains a minimal
67environment.
68</p>
69
70<ul>
71 <li>
72 A stage1 file contains nothing more than a compiler, Portage (Gentoo's
73 software management system) and a couple of packages on which the compiler
74 or Portage depends.
75 </li>
76 <li>
77 A stage2 file contains a so-called bootstrapped system, a minimal
78 environment from which one can start building all other necessary
79 applications that make a Gentoo environment complete.
80 </li>
81 <li>
82 A stage3 file contains a prebuilt minimal system which is almost fully
83 deployable. It only lacks a few applications where you, the Gentoo user,
84 needs to choose which one you want to install.
85 </li>
86</ul>
87
88<p>
89To help you decide what stage file you want to use, we have written down the
90major advantages and disadvantages of each stage file.
91</p>
92
93</body>
94</subsection>
95<subsection>
96<title>A Stage1 Approach</title>
97<body>
98
99<p>
100A <e>stage1</e> is used when you want to bootstrap and build the entire system
101from scratch.
102</p>
103
104<p>
105This approach builds core system packages that are vital to your system and is
106used by Gentoo developers to prepare the Gentoo release media. It is a great
107installation method for those who would like to learn more about the inner
108workings of bootstrapping, toolchains and the like.
109</p>
110
111<p>
112However, if you do not plan to tweak the bootstrapping instructions in the
113<path>bootstrap.sh</path> script written by the Gentoo developers, then a
114stage1 approach has no benefits for you.
115</p>
116
117<table>
118<tr>
119 <th>Stage1</th>
120 <th>Pros and Cons</th>
121</tr>
122<tr>
123 <th>+</th>
124 <ti>
125 Allows you to have total control over the installation routine, bootstrap
126 sequence, etc.
127 </ti>
128</tr>
129<tr>
130 <th>+</th>
131 <ti>Suitable for powerusers and developers who know what they are doing</ti>
132</tr>
133<tr>
134 <th>-</th>
135 <ti>
136 Takes a long time to finish the installation (it is the lengthiest approach)
137 </ti>
138</tr>
139<tr>
140 <th>-</th>
141 <ti>
142 If you don't intend to tweak the settings, it is a waste of time
143 </ti>
144</tr>
145<tr>
146 <th>-</th>
147 <ti>
148 Requires a working Internet connection during the installation
149 </ti>
150</tr>
151</table>
152
153</body>
154</subsection>
155<subsection>
156<title>A Stage2 Approach</title>
157<body>
158
159<p>
160A <e>stage2</e> is used for building the entire system from a bootstrapped
161"semi-compiled" state.
162</p>
163
164<p>
165When you perform a stage2 installation approach, you will build all system
166packages (core packages, including toolchain) using your specific <c>USE</c>,
167<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
168optimized to your preference.
169</p>
170
171<p>
172However, this installation takes some time and if you do not intend to change
173the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
174default", using this approach only makes sense if your <c>USE</c> variable is
175sufficiently different from the default <c>USE</c> we provide.
176</p>
177
178<table>
179<tr>
180 <th>Stage2</th>
181 <th>Pros and Cons</th>
182</tr>
183<tr>
184 <th>+</th>
185 <ti>You don't need to bootstrap</ti>
186</tr>
187<tr>
188 <th>+</th>
189 <ti>Faster than starting with stage1</ti>
190</tr>
191<tr>
192 <th>+</th>
193 <ti>You can still tweak your settings</ti>
194</tr>
195<tr>
196 <th>-</th>
197 <ti>It's still not the fastest way to install Gentoo</ti>
198</tr>
199<tr>
200 <th>-</th>
201 <ti>
202 Requires a working Internet connection during the installation
203 </ti>
204</tr>
205</table>
206
207</body>
208</subsection>
209<subsection>
210<title>A Stage3 Approach</title>
211<body>
212
213<p>
214A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
215built for you. You will only need to build a few packages (such as system
216logger, networking tools, ...) before you can boot into a base Gentoo
217installation.
218</p>
219
220<p>
221Choosing to go with a stage3 allows for the fastest install of Gentoo
222Linux, but also means that your base system will have the optimization
223settings that we chose for you (which to be honest, are good settings
224and were carefully chosen to enhance performance while maintaining
225stability). Stage3 is also required if you want to install Gentoo using
226prebuilt packages or without a network connection.
227</p>
228
229<table>
230<tr>
231 <th>Stage3</th>
232 <th>Pros and Cons</th>
233</tr>
234<tr>
235 <th>+</th>
236 <ti>Fastest way to get a Gentoo base system</ti>
237</tr>
238<tr>
239 <th>+</th>
240 <ti>
241 You can still tweak your system
242 </ti>
243</tr>
244</table>
245
246<p>
247You might be interested to know that, if you decide to use different
248optimization settings after having installed Gentoo, you will be able to
249recompile your entire system with the new optimization settings. The same goes
250for any <c>USE</c> flag changes: Portage is intelligent enough to know what
251packages need to be rebuild.
252</p>
253
254</body>
255</subsection>
256</section>
257
258<section> 59<section>
259<title>The Gentoo Installation CDs</title> 60<title>The Gentoo Installation CDs</title>
260<subsection> 61<subsection>
261<title>Introduction</title> 62<title>Introduction</title>
262<body> 63<body>
292 sole purpose is to boot the system, prepare the networking and continue 93 sole purpose is to boot the system, prepare the networking and continue
293 with the Gentoo installation. 94 with the Gentoo installation.
294 </li> 95 </li>
295 <li> 96 <li>
296 The Gentoo Universal Installation CD, a bootable CD with the same abilities 97 The Gentoo Universal Installation CD, a bootable CD with the same abilities
297 as the Minimal Installation CD. Additionally, it contains a stage1 and 98 as the Minimal Installation CD. Additionally, it contains several stage3
298 several stage3 tarballs (optimized for the individual subarchitectures). 99 tarballs (optimized for the individual subarchitectures).
299 </li> 100 </li>
300</ul> 101</ul>
301 102
302<p> 103<p>
303To help you decide which Installation CD you need, we have written down the 104To help you decide which Installation CD you need, we have written down the
324<tr> 125<tr>
325 <th>+</th> 126 <th>+</th>
326 <ti>Smallest download</ti> 127 <ti>Smallest download</ti>
327</tr> 128</tr>
328<tr> 129<tr>
329 <th>+</th>
330 <ti>
331 You can do a stage1, stage2 or stage3 by getting the stage tarball off the
332 net
333 </ti>
334</tr>
335<tr>
336 <th>-</th> 130 <th>-</th>
337 <ti> 131 <ti>
338 Contains no stages, no Portage snapshot, no prebuilt packages and is 132 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
339 therefore not suitable for networkless installation 133 therefore not suitable for networkless installation
340 </ti> 134 </ti>
341</tr> 135</tr>
342</table> 136</table>
343 137
390installation. 184installation.
391</p> 185</p>
392 186
393<p> 187<p>
394If you intend to use the Packages CD to quickly install additional software, 188If you intend to use the Packages CD to quickly install additional software,
395make sure that you use the same subarchitecture as the stage-3 tarball you use. 189make sure that you use the same subarchitecture as the stage3 tarball you use.
190</p>
191
192</body>
193</subsection>
194<subsection>
195<title>The Stage3 Tarball</title>
196<body>
197
198<p>
199A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
200to continue the Gentoo installation using the instructions in this manual.
201Previously, the Gentoo Handbook described the installation using one of three
202stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
203official installation method uses the stage3 tarball. If you are interested in
204performing a Gentoo installation using a stage1 or stage2 tarball, please read
205the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
206Using a Stage1 or Stage2 Tarball?</uri>
396</p> 207</p>
397 208
398</body> 209</body>
399</subsection> 210</subsection>
400</section> 211</section>

Legend:
Removed from v.1.36  
changed lines
  Added in v.1.37

  ViewVC Help
Powered by ViewVC 1.1.20