/[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">
9 <mail link="greg_g@gentoo.org">Gregorio Guidi</mail> 9 <mail link="greg_g@gentoo.org">Gregorio Guidi</mail>
10</author> 10</author>
11 11
12<abstract> 12<abstract>
13This document explains how new Gentoo releases affect existing installs. 13This document explains how new Gentoo releases affect existing installs.
14</abstract> 14</abstract>
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>
27<body> 27<body>
28 28
29<p> 29<p>
30Here in Gentoo land, the concept of upgrading is quite different compared to 30Here in Gentoo land, the concept of upgrading is quite different compared to
31the rest of the Linux world. You probably already know that we never got in 31the rest of the Linux world. You probably already know that we never got in
32touch with the "classic" way of upgrading software: waiting for a new release, 32touch with the "classic" way of upgrading software: waiting for a new release,
33downloading it, burning, putting it in the cdrom drive and then following the 33downloading it, burning, putting it in the cdrom drive and then following the
34upgrade instructions. 34upgrade instructions.
35</p> 35</p>
36 36
87packages and settings that deeply modify the behavior of the system, we say 87packages and settings that deeply modify the behavior of the system, we say
88that it provides a new <e>profile</e>. 88that it provides a new <e>profile</e>.
89</p> 89</p>
90 90
91<p> 91<p>
92A <e>profile</e> is a set of configuration files, stored in a subdirectory of 92A <e>profile</e> is a set of configuration files, stored in a subdirectory of
93<path>/usr/portage/profiles</path>, that describe things such as the ebuilds 93<path>/usr/portage/profiles</path>, that describe things such as the ebuilds
94that are considered <e>system</e> packages, the default USE flags, the default 94that are considered <e>system</e> packages, the default USE flags, the default
95mapping for virtual packages, and the architecture on which the system is running. 95mapping for virtual packages, and the architecture on which the system is running.
96</p> 96</p>
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
114happens a file named <path>deprecated</path> is put in the profile directory. 112happens a file named <path>deprecated</path> is put in the profile directory.
115The content of this file is the name of the profile that should be "upgraded 113The content of this file is the name of the profile that should be "upgraded
116to"; portage uses this information to automatically warn you when you should 114to"; portage uses this information to automatically warn you when you should
117update to a new profile. 115update to a new profile.
118</p> 116</p>
119 117
120<p> 118<p>
121There are various reasons that a new profile may be created: the release of 119There are various reasons that a new profile may be created: the release of
122new versions of core packages (such as <c>baselayout</c>, <c>gcc</c>, or 120new versions of core packages (such as <c>baselayout</c>, <c>gcc</c>, or
123<c>glibc</c>) that are incompatible with previous versions, a change in 121<c>glibc</c>) that are incompatible with previous versions, a change in
125system-wide settings (such as defining udev to be the default manager 123system-wide settings (such as defining udev to be the default manager
126for <path>/dev</path> instead of devfs). 124for <path>/dev</path> instead of devfs).
127</p> 125</p>
128 126
129</body> 127</body>
130</section> 128</section>
131</chapter> 129</chapter>
132 130
133<chapter> 131<chapter>
134<title>Keeping up with new releases</title> 132<title>Keeping up with new releases</title>
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
148the Gentoo Handbook</uri>, then your system will be exactly the same as one 145the Gentoo Handbook</uri>, then your system will be exactly the same as one
149that has been installed using the new release. 146that has been installed using the new release.
150</p> 147</p>
151 148
152</body> 149</body>
153</section> 150</section>
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
166<uri link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=1">as explained 163<uri link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=1">as explained
167in the Gentoo Handbook</uri>. 164in the Gentoo Handbook</uri>.
168</p> 165</p>
169 166
170<p> 167<p>
171However, Gentoo strongly recommends updating your profile if it becomes 168However, Gentoo strongly recommends updating your profile if it becomes
172deprecated. When this happens, it means that Gentoo developers no longer 169deprecated. When this happens, it means that Gentoo developers no longer
173plan on supporting it. Using the table below, you can quickly check to 170plan on supporting it. Using the table below, you can quickly check to
174see what profiles are currently supported. 171see what profiles are currently supported.
175</p> 172</p>
176 173
177<p> 174<p>
178If you decide to migrate to the new profile, then you will have to manually 175If you decide to migrate to the new profile, then you will have to manually
179perform the update. The way you update may vary significantly from release 176perform the update. The way you update may vary significantly from release
180to release; it depends on how deep the modifications introduced in the new 177to release; it depends on how deep the modifications introduced in the new
181profile are. 178profile are.
182</p> 179</p>
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>
197<title>Supported profiles</title> 192<title>Supported profiles</title>
198<body> 193<body>
199 194
200<p> 195<p>
201The following profiles are officially supported by Gentoo developers: 196The following profiles are officially supported by Gentoo developers:
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>
273With the introduction of the 2004.3 profiles, users are not going to see huge 429With the introduction of the 2004.3 profiles, users are not going to see huge
274modifications of their systems (see below for details). However, Gentoo 430modifications of their systems (see below for details). However, Gentoo
275developers decided to push out this new profile and to deprecate quite a few of 431developers decided to push out this new profile and to deprecate quite a few of
276the old ones to speed up the adoption of <e>stacked profiles</e>, that is, the 432the old ones to speed up the adoption of <e>stacked profiles</e>, that is, the
277profiles that follow the new layout of the <path>/usr/portage/profiles</path> 433profiles that follow the new layout of the <path>/usr/portage/profiles</path>
278directory, for instance 434directory, for instance
279<path>/usr/portage/profiles/default-linux/x86/2004.3</path> (supported by 435<path>/usr/portage/profiles/default-linux/x86/2004.3</path> (supported by
280Portage 2.0.51 or later). 436Portage 2.0.51 or later).
281</p> 437</p>
282 438

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

  ViewVC Help
Powered by ViewVC 1.1.20