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

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

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

Revision 1.76 Revision 1.77
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-stage.xml,v 1.76 2004/12/21 09:38:19 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.77 2005/01/04 18:11:21 swift Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>1.71</version> 11<version>1.72</version>
12<date>2004-12-21</date> 12<date>2005-01-04</date>
13 13
14<section> 14<section>
15<title>Installing a Stage Tarball</title> 15<title>Installing a Stage Tarball</title>
16<subsection> 16<subsection>
17<title>Setting the Date/Time Right</title> 17<title>Setting the Date/Time Right</title>
84 84
85<p> 85<p>
86Depending on your installation medium, you have a couple of tools available to 86Depending on your installation medium, you have a couple of tools available to
87download a stage. If you have <c>links2</c> available, then you can immediately 87download a stage. If you have <c>links2</c> available, then you can immediately
88surf to <uri link="/main/en/mirrors.xml">the Gentoo mirrorlist</uri> and 88surf to <uri link="/main/en/mirrors.xml">the Gentoo mirrorlist</uri> and
89choose a mirror close to you. If you don't have <c>links2</c> available you 89choose a mirror close to you.
90should have <c>lynx</c> at your disposal. In this case, substitute all 90</p>
91occurrences of <c>links2</c> in the rest of the instructions with <c>lynx</c>. 91
92<p>
93If you don't have <c>links2</c> available you should have <c>lynx</c> at your
94disposal. If you need to go through a proxy, export the <c>http_proxy</c> and
95<c>ftp_proxy</c> variables:
96</p>
97
98<pre caption="Setting proxy information for lynx">
99# <i>export http_proxy="http://proxy.server.com:port"</i>
100# <i>export ftp_proxy="http://proxy.server.com:port"</i>
101</pre>
102
103<p>
104We will now assume that you have <c>links2</c> at your disposal.
92</p> 105</p>
93 106
94<p> 107<p>
95Pick the <path>releases/</path> directory, followed by your architecture (for 108Pick the <path>releases/</path> directory, followed by your architecture (for
96instance <path>x86/</path>) and the Gentoo version (<path>2004.3/</path>) 109instance <path>x86/</path>) and the Gentoo version (<path>2004.3/</path>)
100press <c>D</c> to download. When you're finished, press <c>Q</c> to quit the 113press <c>D</c> to download. When you're finished, press <c>Q</c> to quit the
101browser. 114browser.
102</p> 115</p>
103 116
104<pre caption="Surfing to the mirror listing with links2"> 117<pre caption="Surfing to the mirror listing with links2">
105<comment>(Without proxy)</comment> # <i>links2 http://www.gentoo.org/main/en/mirrors.xml</i> 118# <i>links2 http://www.gentoo.org/main/en/mirrors.xml</i>
119
120<comment>(If you need proxy support with links2:)</comment>
106<comment>(With proxy)</comment> # <i>links2 -http-proxy proxy.server.com:8080 http://www.gentoo.org/main/en/mirrors.xml</i> 121# <i>links2 -http-proxy proxy.server.com:8080 http://www.gentoo.org/main/en/mirrors.xml</i>
107</pre> 122</pre>
108 123
109<p> 124<p>
110If you want to check the integrity of the downloaded stage tarball, use 125If you want to check the integrity of the downloaded stage tarball, use
111<c>md5sum</c> and compare the output with the MD5 checksum provided on the 126<c>md5sum</c> and compare the output with the MD5 checksum provided on the
211<p> 226<p>
212You now have to install a Portage snapshot, a collection of files that inform 227You now have to install a Portage snapshot, a collection of files that inform
213Portage what software titles you can install, which profiles are available, etc. 228Portage what software titles you can install, which profiles are available, etc.
214</p> 229</p>
215 230
216<p>
217If you booted off a Universal LiveCD, you already have a Portage snapshot
218at your disposal. If not, you will need to download a Portage snapshot from one
219of our mirrors.
220</p>
221
222<p>
223Continue with the appropriate part:
224</p>
225
226<ul>
227 <li>
228 <uri link="#installing_from_LiveCD">Unpack the LiveCD-provided
229 Snapshot</uri>
230 </li>
231 <li>
232 <uri link="#installing_from_Internet">Unpack a Downloaded Snapshot</uri>
233 </li>
234</ul>
235
236</body>
237</subsection>
238<subsection id="installing_from_LiveCD">
239<title>Unpack the Snapshot from the LiveCD</title>
240<body>
241
242<p>
243To install the snapshot, take a look inside <path>/mnt/cdrom/snapshots/</path>
244to see what snapshot is available:
245</p>
246
247<pre caption="Checking the /mnt/cdrom/snapshots content">
248# <i>ls /mnt/cdrom/snapshots</i>
249</pre>
250
251<p>
252Now extract the snapshot using the following construct. Again, make sure you
253use the correct options with <c>tar</c>. Also, the <c>-C</c> is with a capital
254<c>C</c>, not <c>c</c>. In the next example we use
255<path>portage-20041022.tar.bz2</path> as the snapshot filename. Be sure to
256substitute with the name of the snapshot that is on your LiveCD.
257</p>
258
259<pre caption="Extracting a Portage snapshot">
260# <i>tar -xvjf /mnt/cdrom/snapshots/portage-20041022.tar.bz2 -C /mnt/gentoo/usr</i>
261</pre>
262
263<p>
264Continue with <uri link="#networklessornot">Networkless Installation or
265Not?</uri>.
266</p>
267
268</body> 231</body>
269</subsection> 232</subsection>
270<subsection id="installing_from_Internet"> 233<subsection id="installing_from_Internet">
271<title>Unpack a Downloaded Snapshot</title> 234<title>Download and Install a Portage Snapshot</title>
272<body> 235<body>
273 236
274<p> 237<p>
275Go to the mountpoint where you mounted your filesystem (most likely 238Go to the mountpoint where you mounted your filesystem (most likely
276<path>/mnt/gentoo</path>): 239<path>/mnt/gentoo</path>):
293</pre> 256</pre>
294 257
295<p> 258<p>
296Now exit your browser by pressing <c>Q</c>. You will now have a Portage snapshot 259Now exit your browser by pressing <c>Q</c>. You will now have a Portage snapshot
297stored in <path>/mnt/gentoo</path>. In the next step, we extract the Portage 260stored in <path>/mnt/gentoo</path>. In the next step, we extract the Portage
298snapshot onto your filesystem: 261snapshot onto your filesystem. Make sure that you use the exact command; the
262last option is a capital <c>C</c>, not <c>c</c>.
299</p> 263</p>
300 264
301<pre caption="Extracting the Portage snapshot"> 265<pre caption="Extracting the Portage snapshot">
302# <i>tar -xvjf /mnt/gentoo/portage-20041202.tar.bz2 -C /mnt/gentoo/usr</i> 266# <i>tar -xvjf /mnt/gentoo/portage-20041202.tar.bz2 -C /mnt/gentoo/usr</i>
303</pre>
304
305</body>
306</subsection>
307<subsection id="networklessornot">
308<title>Networkless Installation or Not?</title>
309<body>
310
311<p>
312If you are performing a networkless installation, you also need to copy over
313all source code from the Universal LiveCD. If not, you should skip this step
314and continue with <uri link="#compile_options">Configuring the Compile
315Options</uri>.
316</p>
317
318<pre caption="Copy over source code">
319# <i>mkdir /mnt/gentoo/usr/portage/distfiles</i>
320# <i>cp /mnt/cdrom/distfiles/* /mnt/gentoo/usr/portage/distfiles/</i>
321</pre> 267</pre>
322 268
323</body> 269</body>
324</subsection> 270</subsection>
325</section> 271</section>
357As you probably noticed, the <path>make.conf.example</path> file is 303As you probably noticed, the <path>make.conf.example</path> file is
358structured in a generic way: commented lines start with "#", other lines define 304structured in a generic way: commented lines start with "#", other lines define
359variables using the <c>VARIABLE="content"</c> syntax. The <path>make.conf</path> 305variables using the <c>VARIABLE="content"</c> syntax. The <path>make.conf</path>
360file uses the same syntax. Several of those variables are discussed next. 306file uses the same syntax. Several of those variables are discussed next.
361</p> 307</p>
362
363<warn>
364Do not make any modifications to the USE variable if you are performing a stage3
365with GRP installation. You can alter the USE variable after having installed the
366packages you want. Gremlins are known to attack your system if you ignore this
367warning!
368</warn>
369 308
370</body> 309</body>
371</subsection> 310</subsection>
372<subsection> 311<subsection>
373<title>CHOST</title> 312<title>CHOST</title>

Legend:
Removed from v.1.76  
changed lines
  Added in v.1.77

  ViewVC Help
Powered by ViewVC 1.1.20