/[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.90 Revision 1.91
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/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.90 2005/11/11 17:27:15 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v 1.91 2005/11/24 17:26:10 neysx Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>2.6</version> 11<version>2.7</version>
12<date>2005-11-11</date> 12<date>2005-11-24</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>
105<p> 105<p>
106We will now assume that you have <c>links2</c> at your disposal. 106We will now assume that you have <c>links2</c> at your disposal.
107</p> 107</p>
108 108
109<p> 109<p>
110Pick the <path>releases/</path> directory, followed by your architecture (for 110Pick the <path>releases/</path> directory, followed by your architecture (for
111instance <path>x86/</path>) and the Gentoo version (<path>2005.1/</path>) 111instance <path>x86/</path>) and the Gentoo version (<path>2005.1/</path> or
112to finish up with the <path>stages/</path> directory. There you should see all 112<path>2005.1-r1/</path> if available) to finish up with the
113available stage files for your architecture (they might be stored within 113<path>stages/</path> directory. There you should see all available stage files
114subdirectories named to the individual sub architectures). Select one and 114for your architecture (they might be stored within subdirectories named to the
115press <c>D</c> to download. When you're finished, press <c>Q</c> to quit the 115individual sub architectures). Select one and press <c>D</c> to download. When
116browser. 116you're finished, press <c>Q</c> to quit the browser.
117</p> 117</p>
118 118
119<pre caption="Surfing to the mirror listing with links2"> 119<pre caption="Surfing to the mirror listing with links2">
120# <i>links2 http://www.gentoo.org/main/en/mirrors.xml</i> 120# <i>links2 http://www.gentoo.org/main/en/mirrors.xml</i>
121 121
122<comment>(If you need proxy support with links2:)</comment> 122<comment>(If you need proxy support with links2:)</comment>
123# <i>links2 -http-proxy proxy.server.com:8080 http://www.gentoo.org/main/en/mirrors.xml</i> 123# <i>links2 -http-proxy proxy.server.com:8080 http://www.gentoo.org/main/en/mirrors.xml</i>
124</pre> 124</pre>
125 125
126<p> 126<p>
127Make sure you download a stage3 tarball - installations using a stage1 or stage2 127Make sure you download a <b>stage3</b> tarball - installations using a stage1
128tarball are not supported anymore. 128or stage2 tarball are not supported anymore.
129</p> 129</p>
130 130
131<p> 131<p>
132If you want to check the integrity of the downloaded stage tarball, use 132If you want to check the integrity of the downloaded stage tarball, use
133<c>md5sum</c> and compare the output with the MD5 checksum provided on the 133<c>md5sum</c> and compare the output with the MD5 checksum provided on the
134mirror. For instance, to check the validity of the x86 stage tarball: 134mirror. For instance, to check the validity of the x86 stage tarball:
135</p> 135</p>
136 136
137<pre caption="Example checking integrity of a stage tarball"> 137<pre caption="Example checking integrity of a stage tarball">
138# <i>md5sum -c stage3-x86-2005.1.tar.bz2.md5</i> 138# <i>md5sum -c stage3-x86-2005.1-r1.tar.bz2.md5</i>
139stage3-x86-2005.1.tar.bz2: OK 139stage3-x86-2005.1-r1.tar.bz2: OK
140</pre> 140</pre>
141 141
142</body> 142</body>
143</subsection> 143</subsection>
144<subsection> 144<subsection>
145<title>Unpacking the Stage Tarball</title> 145<title>Unpacking the Stage Tarball</title>
146<body> 146<body>
147 147
148<p> 148<p>
149Now unpack your downloaded stage onto your system. We use GNU's <c>tar</c> to 149Now unpack your downloaded stage onto your system. We use <c>tar</c> to proceed
150proceed as it is the easiest method: 150as it is the easiest method:
151</p> 151</p>
152 152
153<pre caption="Unpacking the stage"> 153<pre caption="Unpacking the stage">
154# <i>tar -xvjpf stage3-*.tar.bz2</i> 154# <i>tar xvjpf stage3-*.tar.bz2</i>
155</pre> 155</pre>
156 156
157<p> 157<p>
158Make sure that you use the same options (<c>-xvjpf</c>). The <c>x</c> stands for 158Make sure that you use the same options (<c>xvjpf</c>). The <c>x</c> stands for
159<e>Extract</e>, the <c>v</c> for <e>Verbose</e> to see what happens during the 159<e>Extract</e>, the <c>v</c> for <e>Verbose</e> to see what happens during the
160extraction process (okay, yes, this is optional), 160extraction process (optional), the <c>j</c> for <e>Decompress with bzip2</e>,
161the <c>j</c> for <e>Decompress with bzip2</e>, the <c>p</c> for <e>Preserve 161the <c>p</c> for <e>Preserve permissions</e> and the <c>f</c> to denote that we
162permissions</e> and the <c>f</c> to denote that we want to extract a file, not 162want to extract a file, not standard input.
163standard input.
164</p> 163</p>
165
166<!-- 2005.1: stage3 for athlon xp, pentium3 and pentium4 are b0rked -->
167<warn>
168The <path>stage3-athlon-xp-2005.1.tar.bz2</path>,
169<path>stage3-pentium3-2005.1.tar.bz2</path> and
170<path>stage3-pentium4-2005.1.tar.bz2</path> files have a serious permission
171error. After extracting any of these, run <c>chmod 0755 /mnt/gentoo</c> to fix
172the error <e>before</e> continuing with the installation.
173</warn>
174 164
175<note> 165<note>
176Some architectures (e.g. MIPS) Installation CDs and boot images rely upon the 166Some architectures (e.g. MIPS) Installation CDs and boot images rely upon the
177<c>tar</c> built into BusyBox which doesn't currently support the <c>-v</c> 167<c>tar</c> built into BusyBox which doesn't currently support the <c>v</c>
178option. Therefore it may not work. 168option. Use the <c>xjpf</c> options instead.
179</note> 169</note>
180 170
181<p> 171<p>
182Now that the stage is installed, continue with <uri 172Now that the stage is installed, continue with <uri
183link="#installing_portage">Installing Portage</uri>. 173link="#installing_portage">Installing Portage</uri>.
219<pre caption="Changing directory to /mnt/gentoo"> 209<pre caption="Changing directory to /mnt/gentoo">
220# <i>cd /mnt/gentoo</i> 210# <i>cd /mnt/gentoo</i>
221</pre> 211</pre>
222 212
223<p> 213<p>
224We will now extract the stage tarball of your choice. We will do this with the 214We will now extract the stage tarball of your choice. We will do this with
225GNU <c>tar</c> tool. Make sure you use the same options (<c>-xvjpf</c>)! Again, 215<c>tar</c>. Make sure you use the same options (<c>xvjpf</c>) The <c>v</c>
226the <c>v</c> argument is optional and not supported in some <c>tar</c> versions. 216argument is optional and not supported in some <c>tar</c> versions. In the
227In the next example, we extract the stage tarball 217next example, we extract the stage tarball
228<path>stage3-&lt;subarch&gt;-2005.1.tar.bz2</path>. 218<path>stage3-&lt;subarch&gt;-2005.1-r1.tar.bz2</path>. Be sure to substitute
229Be sure to substitute the tarball filename with your stage. 219the tarball filename with your stage.
230</p> 220</p>
231 221
232<pre caption="Extracting the stage tarball"> 222<pre caption="Extracting the stage tarball">
233# <i>tar -xvjpf /mnt/cdrom/stages/stage3-&lt;subarch&gt;-2005.1.tar.bz2</i> 223# <i>tar xvjpf /mnt/cdrom/stages/stage3-&lt;subarch&gt;-2005.1-r1.tar.bz2</i>
234</pre> 224</pre>
235
236<!-- 2005.1: stage3 for athlon xp, pentium3 and pentium4 are b0rked -->
237<warn>
238The <path>stage3-athlon-xp-2005.1.tar.bz2</path>,
239<path>stage3-pentium3-2005.1.tar.bz2</path> and
240<path>stage3-pentium4-2005.1.tar.bz2</path> files have a serious permission
241error. After extracting any of these, run <c>chmod 0755 /mnt/gentoo</c> to fix
242the error <e>before</e> continuing with the installation.
243</warn>
244 225
245<p> 226<p>
246Now that the stage is installed, continue with <uri 227Now that the stage is installed, continue with <uri
247link="#installing_portage">Installing Portage</uri>. 228link="#installing_portage">Installing Portage</uri>.
248</p> 229</p>
294last option is a capital <c>C</c>, not <c>c</c>. 275last option is a capital <c>C</c>, not <c>c</c>.
295</p> 276</p>
296 277
297<pre caption="Extracting the Portage snapshot"> 278<pre caption="Extracting the Portage snapshot">
298<comment>(Substitute &lt;date&gt; with the datestamp of the downloaded snapshot)</comment> 279<comment>(Substitute &lt;date&gt; with the datestamp of the downloaded snapshot)</comment>
299# <i>tar -xvjf /mnt/gentoo/portage-&lt;date&gt;.tar.bz2 -C /mnt/gentoo/usr</i> 280# <i>tar xvjf /mnt/gentoo/portage-&lt;date&gt;.tar.bz2 -C /mnt/gentoo/usr</i>
300</pre> 281</pre>
301 282
302</body> 283</body>
303</subsection> 284</subsection>
304</section> 285</section>

Legend:
Removed from v.1.90  
changed lines
  Added in v.1.91

  ViewVC Help
Powered by ViewVC 1.1.20