/[gentoo]/xml/htdocs/doc/en/gentoo-upgrading.xml
Gentoo

Diff of /xml/htdocs/doc/en/gentoo-upgrading.xml

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

Revision 1.19 Revision 1.20
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-upgrading.xml,v 1.19 2005/01/25 21:37:58 swift Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-upgrading.xml,v 1.20 2005/03/28 11:41:41 swift Exp $ -->
4 4
5<guide link="/doc/en/gentoo-upgrading.xml"> 5<guide link="/doc/en/gentoo-upgrading.xml">
6<title>Gentoo Upgrading Guide</title> 6<title>Gentoo Upgrading Guide</title>
7 7
8<author title="Author"> 8<author title="Author">
15 15
16<!-- The content of this document is licensed under the CC-BY-SA license --> 16<!-- The content of this document is licensed under the CC-BY-SA license -->
17<!-- See http://creativecommons.org/licenses/by-sa/2.0 --> 17<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
18<license/> 18<license/>
19 19
20<version>2.8</version> 20<version>2.9</version>
21<date>2005-01-22</date> 21<date>2005-03-28</date>
22 22
23<chapter> 23<chapter>
24<title>Gentoo and Upgrades</title> 24<title>Gentoo and Upgrades</title>
25<section> 25<section>
26<title>Philosophy</title> 26<title>Philosophy</title>
97 97
98<p> 98<p>
99The profile in use is determined by the symbolic link 99The profile in use is determined by the symbolic link
100<path>/etc/make.profile</path>, which points to a subdirectory of 100<path>/etc/make.profile</path>, which points to a subdirectory of
101<path>/usr/portage/profiles</path> which holds the profile files. For 101<path>/usr/portage/profiles</path> which holds the profile files. For
102instance, the x86 2004.2 profile can be found at 102instance, the default x86 2005.0 profile can be found
103<path>/usr/portage/profiles/default-x86-2004.2</path> (old-style location) or
104at <path>/usr/portage/profiles/default-linux/x86/2004.2</path> (new-style 103at <path>/usr/portage/profiles/default-linux/x86/2005.0</path>.
105location - only for use with Portage 2.0.51 and later). With respect to 104The files in the parent directories are part of the profile as well (and
106new-style profile directories, note that the files in 105are therefore shared by different subprofiles). This is why we call these
107parent directories are part of the profile (and are therefore shared 106<e>cascaded profiles</e>.
108by different subprofiles).
109</p> 107</p>
110 108
111<p> 109<p>
112Profiles obsoleted by new ones are kept in <path>/usr/portage/profiles</path> 110Profiles obsoleted by new ones are kept in <path>/usr/portage/profiles</path>
113along with the current ones, but they are marked as deprecated. When that 111along with the current ones, but they are marked as deprecated. When that
135<section> 133<section>
136<title>Releases without profile changes</title> 134<title>Releases without profile changes</title>
137<body> 135<body>
138 136
139<p> 137<p>
140If a new Gentoo release is announced that does not include a new profile (such 138If a new Gentoo release is announced that does not include a new profile
141as the 2004.1 release for x86), then you can safely pretend that it never 139then you can safely pretend that it never happened :).
142happened :).
143</p> 140</p>
144 141
145<p> 142<p>
146If you update your installed packages 143If you update your installed packages
147<uri link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=1">as explained in 144<uri link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=1">as explained in
154<section> 151<section>
155<title>Releases with profile changes</title> 152<title>Releases with profile changes</title>
156<body> 153<body>
157 154
158<p> 155<p>
159If a release introduces a new profile, you have the choice to migrate to the 156If a release (such as 2005.0) introduces a new profile, you have the choice
160new profile. 157to migrate to the new profile.
161</p> 158</p>
162 159
163<p> 160<p>
164Naturally, you are not forced to do so, and you can continue to use the old 161Naturally, you are not forced to do so, and you can continue to use the old
165profile and just update your packages 162profile and just update your packages
183 180
184<p> 181<p>
185In the simplest case you only have to change the <path>/etc/make.profile</path> 182In the simplest case you only have to change the <path>/etc/make.profile</path>
186symlink, in the worst case you may have to recompile your system from scratch 183symlink, in the worst case you may have to recompile your system from scratch
187while doing a neat voodoo dance. Migration is usually covered in the release 184while doing a neat voodoo dance. Migration is usually covered in the release
188notes (e.g. <uri 185notes. You can also find <uri link="#instructions">instructions</uri> at the
189link="/proj/en/releng/release/2004.3/x86-release-notes.xml">the x86 2004.3 186end of this guide.
190release notes</uri>). You can also find <uri
191link="#instructions">instructions</uri> at the end of this guide.
192</p> 187</p>
193 188
194</body> 189</body>
195</section> 190</section>
196<section> 191<section>
202</p> 197</p>
203 198
204<table> 199<table>
205<tr> 200<tr>
206 <th>Architecture</th> 201 <th>Architecture</th>
207 <th>Most recent profile</th> 202 <th>Most recent profiles</th>
208 <th>Other supported profiles</th> 203 <th>Other supported profiles</th>
209</tr> 204</tr>
210<tr> 205<tr>
211 <th>alpha</th> 206 <th>alpha</th>
207 <ti>2005.0, 2005.0/2.4</ti>
212 <ti>2004.3</ti> 208 <ti>2004.3</ti>
213 <ti></ti>
214</tr> 209</tr>
215<tr> 210<tr>
216 <th>arm</th> 211 <th>arm</th>
212 <ti>2005.0</ti>
217 <ti>2004.3</ti> 213 <ti>2004.3</ti>
218 <ti></ti>
219</tr> 214</tr>
220<tr> 215<tr>
221 <th>amd64</th> 216 <th>amd64</th>
217 <ti>2005.0, 2005.0/no-multilib</ti>
222 <ti>2004.3</ti> 218 <ti>2004.3</ti>
223 <ti>2004.2, 2004.0</ti>
224</tr> 219</tr>
225<tr> 220<tr>
226 <th>hppa</th> 221 <th>hppa</th>
222 <ti>2005.0, 2005.0/2.4</ti>
223 <ti>2004.3, 2004.2</ti>
224</tr>
225<tr>
226 <th>ia64</th>
227 <ti>2005.0</ti>
228 <ti></ti>
229</tr>
230<tr>
231 <th>ppc</th>
232 <ti>2005.0</ti>
233 <ti>2004.3, 2004.0</ti>
234</tr>
235<tr>
236 <th>mips</th>
237 <ti>2005.0</ti>
238 <ti>2004.2</ti>
239</tr>
240<tr>
241 <th>s390</th>
242 <ti>2005.0</ti>
227 <ti>2004.3</ti> 243 <ti>2004.3</ti>
228 <ti>2004.2</ti>
229</tr>
230<tr>
231 <th>ia64</th>
232 <ti>2004.3</ti>
233 <ti></ti>
234</tr>
235<tr>
236 <th>ppc</th>
237 <ti>2004.3</ti>
238 <ti>2004.0</ti>
239</tr>
240<tr>
241 <th>mips</th>
242 <ti>2004.2</ti>
243 <ti></ti>
244</tr>
245<tr>
246 <th>s390</th>
247 <ti>2004.3</ti>
248 <ti></ti>
249</tr> 244</tr>
250<tr> 245<tr>
251 <th>sparc</th> 246 <th>sparc</th>
252 <ti>2004.3</ti>
253 <ti>2004.0</ti> 247 <ti>2005.0</ti>
248 <ti>2004.3, 2004.0</ti>
254</tr> 249</tr>
255<tr> 250<tr>
256 <th>x86</th> 251 <th>x86</th>
257 <ti>2004.3</ti> 252 <ti>2005.0, 2005.0/2.4</ti>
258 <ti>2004.2, 2004.0</ti> 253 <ti>2004.3, 2004.2, 2004.0</ti>
259</tr> 254</tr>
260</table> 255</table>
261 256
262</body> 257</body>
263</section> 258</section>
264</chapter> 259</chapter>
265 260
266<chapter id="instructions"> 261<chapter id="instructions">
267<title>Profile updating instructions</title> 262<title>Profile updating instructions</title>
263<section>
264<title>Updating to 2005.0</title>
265<body>
266
267<p>
268With the introduction of 2005.0, several architectures have decided to define
269additional profiles. Make sure you read the description of said profiles before
270you decide to migrate to one of them. Most architectures now also default to the
2712.6 kernel tree where 2.4 was chosen previously.
272</p>
273
274<p>
275Some architectures require a bit more actions to be completed in order to
276convert from one profile to another. If that is the case, the step-by-step
277guides are linked from the table.
278</p>
279
280<table>
281<tr>
282 <th>Profile</th>
283 <th>Description</th>
284 <th>Specific Upgrade Guide</th>
285</tr>
286<tr>
287 <ti>default-linux/alpha/2005.0</ti>
288 <ti>Default Alpha 2005.0 profile for 2.6 kernels</ti>
289 <ti></ti>
290</tr>
291<tr>
292 <ti>default-linux/alpha/2005.0/2.4</ti>
293 <ti>Alpha 2005.0 profile for 2.4 kernels</ti>
294 <ti></ti>
295</tr>
296<tr>
297 <ti>default-linux/amd64/2005.0</ti>
298 <ti>Default AMD64 2005.0 profile for 2.6 kernels</ti>
299 <ti>
300 <uri link="/proj/en/base/amd64/2005.0-upgrade-amd64.xml">Upgrading to
301 2005.0</uri>
302 </ti>
303</tr>
304<tr>
305 <ti>default-linux/amd64/2005.0/no-multilib</ti>
306 <ti>AMD64 2005.0 profile for multilib-disabled system installations</ti>
307 <ti>
308 <uri link="/proj/en/base/amd64/2005.0-upgrade-amd64.xml">Upgrading to
309 2005.0</uri>
310 </ti>
311</tr>
312<tr>
313 <ti>default-linux/arm/2005.0</ti>
314 <ti>Default ARM 2005.0 profile for 2.6 kernels</ti>
315 <ti></ti>
316</tr>
317<tr>
318 <ti>default-linux/hppa/2005.0</ti>
319 <ti>Default HPPA 2005.0 profile for 2.6 kernels</ti>
320 <ti></ti>
321</tr>
322<tr>
323 <ti>default-linux/hppa/2005.0/2.4</ti>
324 <ti>HPPA 2005.0 profile for 2.4 kernels</ti>
325 <ti></ti>
326</tr>
327<tr>
328 <ti>default-linux/mips/2005.0</ti>
329 <ti>Default MIPS 2005.0 profile</ti>
330 <ti></ti>
331</tr>
332<tr>
333 <ti>default-linux/mips/cobalt/2005.0</ti>
334 <ti>Cobalt specific MIPS 2005.0 profile</ti>
335 <ti></ti>
336</tr>
337<tr>
338 <ti>default-linux/mips/mips64/n32/2005.0</ti>
339 <ti>2005.0 profile for n32-supporting MIPS platforms</ti>
340 <ti></ti>
341</tr>
342<tr>
343 <ti>default-linux/mips/mips64/ip28/2005.0</ti>
344 <ti>Indigo2 Impact specific 64-bit 2005.0 profile</ti>
345 <ti></ti>
346</tr>
347<tr>
348 <ti>default-linux/mips/mips64/2005.0</ti>
349 <ti>64-bit MIPS 2005.0 profile</ti>
350 <ti></ti>
351</tr>
352<tr>
353 <ti>default-linux/ppc/2005.0</ti>
354 <ti>Default PPC 2005.0 profile for 2.6 kernels</ti>
355 <ti></ti>
356</tr>
357<tr>
358 <ti>default-linux/ppc64/2005.0</ti>
359 <ti>Default PPC64 2005.0 profile for 2.6 kernels</ti>
360 <ti></ti>
361</tr>
362<tr>
363 <ti>default-linux/s390/2005.0</ti>
364 <ti>Default S390 2005.0 profile</ti>
365 <ti></ti>
366</tr>
367<tr>
368 <ti>default-linux/sparc/sparc32/2005.0</ti>
369 <ti>Default Sparc 32-bit 2005.0 profile</ti>
370 <ti></ti>
371</tr>
372<!-- http://dev.gentoo.org/~dsd/kernel-2.6.htm
373 No subprofiles for sparc
374<tr>
375 <ti>default-linux/sparc/sparc32/2005.0/2.6</ti>
376 <ti>Sparc 32-bit 2005.0 profile for 2.6 kernels</ti>
377 <ti></ti>
378</tr>
379-->
380<tr>
381 <ti>default-linux/sparc/sparc64/2005.0</ti>
382 <ti>Default Sparc 64-bit 2005.0 profile</ti>
383 <ti></ti>
384</tr>
385<!-- http://dev.gentoo.org/~dsd/kernel-2.6.htm
386 No subprofiles for sparc
387<tr>
388 <ti>default-linux/sparc/sparc64/2005.0/2.6</ti>
389 <ti>Sparc 64-bit 2005.0 profile for 2.6 kernels</ti>
390 <ti></ti>
391</tr>
392-->
393<tr>
394 <ti>default-linux/x86/2005.0</ti>
395 <ti>Default x86 2005.0 profile for 2.6 kernels</ti>
396 <ti></ti>
397</tr>
398<tr>
399 <ti>default-linux/x86/2005.0/2.4</ti>
400 <ti>x86 2005.0 profile for 2.4 kernels</ti>
401 <ti></ti>
402</tr>
403</table>
404
405<p>
406To switch to the selected profile, point the <path>/etc/make.profile</path>
407symlink to the new location. Make sure your Portage is updated before you change
408your profile!
409</p>
410
411<pre caption="Changing to a 2005.0 profile">
412# <i>rm /etc/make.profile</i>
413# <i>ln -s ../usr/portage/profiles/</i>&lt;selected profile&gt;<i> /etc/make.profile</i>
414</pre>
415
416<p>
417If you are running a Linux 2.4-based system but want to migrate to a 2.6-based
418kernel, make sure you read our <uri link="/doc/en/migration-to-2.6.xml">Gentoo
419Linux 2.6 Migration Guide</uri>.
420</p>
421
422</body>
423</section>
268<section> 424<section>
269<title>Updating to 2004.3</title> 425<title>Updating to 2004.3</title>
270<body> 426<body>
271 427
272<p> 428<p>

Legend:
Removed from v.1.19  
changed lines
  Added in v.1.20

  ViewVC Help
Powered by ViewVC 1.1.20