| 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.18 2005/01/25 11:48:14 neysx Exp $ --> |
3 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-upgrading.xml,v 1.30 2006/05/27 13:51:57 neysx 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"> |
| … | |
… | |
| 12 | <abstract> |
12 | <abstract> |
| 13 | This document explains how new Gentoo releases affect existing installs. |
13 | This 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.5 --> |
| 18 | <license/> |
18 | <license/> |
| 19 | |
19 | |
| 20 | <version>2.8</version> |
20 | <version>2.3</version> |
| 21 | <date>2005-01-22</date> |
21 | <date>2006-05-27</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> |
| … | |
… | |
| 37 | <p> |
37 | <p> |
| 38 | You know (being a Gentoo user after all) that this process is extremely |
38 | You know (being a Gentoo user after all) that this process is extremely |
| 39 | frustrating for power users that want to live on the bleeding edge. Even power |
39 | frustrating for power users that want to live on the bleeding edge. Even power |
| 40 | users from other distributions probably share the same feelings, given the |
40 | users from other distributions probably share the same feelings, given the |
| 41 | popularity and spread of tools like apt or apt-rpm which make it |
41 | popularity and spread of tools like apt or apt-rpm which make it |
| 42 | possible to have quick and frequent updates. However, no distibution is more |
42 | possible to have quick and frequent updates. However, no distribution is more |
| 43 | suited than Gentoo to satisfy these kind of demanding users. From the beginning, |
43 | suited than Gentoo to satisfy these kind of demanding users. From the |
| 44 | Gentoo was designed around the concept of fast, incremental updates. |
44 | beginning, Gentoo was designed around the concept of fast, incremental |
|
|
45 | updates. |
| 45 | </p> |
46 | </p> |
| 46 | |
47 | |
| 47 | <p> |
48 | <p> |
| 48 | Ideally, you install once and never bother with releases: just follow the |
49 | Ideally, you install once and never bother with releases: just follow the |
| 49 | instructions in <uri |
50 | instructions in <uri |
| … | |
… | |
| 66 | There are various reasons: |
67 | There are various reasons: |
| 67 | </p> |
68 | </p> |
| 68 | |
69 | |
| 69 | <ul> |
70 | <ul> |
| 70 | <li> |
71 | <li> |
| 71 | A new release means new LiveCDs with bugfixes and more features. |
72 | A new release means new Installation CDs with bugfixes and more features. |
| 72 | </li> |
73 | </li> |
| 73 | <li> |
74 | <li> |
| 74 | A new release provides an updated set of GRP packages, so that users that |
75 | A new release provides an updated set of GRP packages, so that users that |
| 75 | choose "the fast way" to install (stage3 + precompiled packages) end up |
76 | choose "the fast way" to install (stage3 + precompiled packages) end up |
| 76 | with a system that is not outdated. |
77 | with a system that is not outdated. |
| … | |
… | |
| 95 | </p> |
96 | </p> |
| 96 | |
97 | |
| 97 | <p> |
98 | <p> |
| 98 | The profile in use is determined by the symbolic link |
99 | The profile in use is determined by the symbolic link |
| 99 | <path>/etc/make.profile</path>, which points to a subdirectory of |
100 | <path>/etc/make.profile</path>, which points to a subdirectory of |
| 100 | <path>/usr/portage/profiles</path> which holds the profile files. For instance, |
101 | <path>/usr/portage/profiles</path> which holds the profile files. For |
| 101 | the x86 2004.2 profile can be found at <path>/usr/portage/profiles/default-x86-2004.2</path> |
102 | instance, the default x86 2006.0 profile can be found |
| 102 | (old-style location) or at <path>/usr/portage/profiles/default-linux/x86/2004.2</path> (new-style |
103 | at <path>/usr/portage/profiles/default-linux/x86/2006.0</path>. |
| 103 | location - only for use with Portage 2.0.51 and later). With respect to new-style profile directories, note that the files in |
104 | The files in the parent directories are part of the profile as well (and |
| 104 | parent directories are part of the profile (and are therefore shared |
105 | are therefore shared by different subprofiles). This is why we call these |
| 105 | by different subprofiles). |
106 | <e>cascaded profiles</e>. |
| 106 | </p> |
107 | </p> |
| 107 | |
108 | |
| 108 | <p> |
109 | <p> |
| 109 | Profiles obsoleted by new ones are kept in <path>/usr/portage/profiles</path> |
110 | Profiles obsoleted by new ones are kept in <path>/usr/portage/profiles</path> |
| 110 | along with the current ones, but they are marked as deprecated. When that happens a |
111 | along with the current ones, but they are marked as deprecated. When that |
| 111 | file named <path>deprecated</path> is put in the profile directory. The content |
112 | happens a file named <path>deprecated</path> is put in the profile directory. |
| 112 | of this file is the name of the profile that should be "upgraded to"; portage uses |
113 | The content of this file is the name of the profile that should be "upgraded |
| 113 | this information to automatically warn you when you should update to a new profile. |
114 | to"; portage uses this information to automatically warn you when you should |
| 114 | </p> |
115 | update to a new profile. |
| 115 | |
|
|
| 116 | <p> |
116 | </p> |
|
|
117 | |
|
|
118 | <p> |
| 117 | There are various reasons that a new profile may be created: the release of new |
119 | There are various reasons that a new profile may be created: the release of |
| 118 | versions of core packages (such as <c>baselayout</c>, <c>gcc</c>, or <c>glibc</c>) |
120 | new versions of core packages (such as <c>baselayout</c>, <c>gcc</c>, or |
| 119 | that are incompatible with previous versions, a change in the default USE flags or |
121 | <c>glibc</c>) that are incompatible with previous versions, a change in |
| 120 | in the virtual mappings, or maybe a change in system-wide settings (such as defining |
122 | the default USE flags or in the virtual mappings, or maybe a change in |
| 121 | udev to be the default manager for <path>/dev</path> instead of devfs). |
123 | system-wide settings. |
| 122 | </p> |
124 | </p> |
| 123 | |
125 | |
| 124 | </body> |
126 | </body> |
| 125 | </section> |
127 | </section> |
| 126 | </chapter> |
128 | </chapter> |
| … | |
… | |
| 130 | <section> |
132 | <section> |
| 131 | <title>Releases without profile changes</title> |
133 | <title>Releases without profile changes</title> |
| 132 | <body> |
134 | <body> |
| 133 | |
135 | |
| 134 | <p> |
136 | <p> |
| 135 | If a new Gentoo release is announced that does not include a new profile (such |
137 | If a new Gentoo release is announced that does not include a new profile |
| 136 | as the 2004.1 release for x86), then you can safely pretend that it never |
138 | then you can safely pretend that it never happened :). |
| 137 | happened :). |
|
|
| 138 | </p> |
139 | </p> |
| 139 | |
140 | |
| 140 | <p> |
141 | <p> |
| 141 | If you update your installed packages |
142 | If you update your installed packages |
| 142 | <uri link="/doc/en/handbook/handbook-x86.xml?part=2&chap=1">as explained in |
143 | <uri link="/doc/en/handbook/handbook-x86.xml?part=2&chap=1">as explained in |
| … | |
… | |
| 149 | <section> |
150 | <section> |
| 150 | <title>Releases with profile changes</title> |
151 | <title>Releases with profile changes</title> |
| 151 | <body> |
152 | <body> |
| 152 | |
153 | |
| 153 | <p> |
154 | <p> |
| 154 | If a release introduces a new profile, you have the choice to migrate to the |
155 | If a release (such as 2006.0 for x86) introduces a new profile, you have the |
| 155 | new profile. |
156 | choice to migrate to the new profile. |
| 156 | </p> |
|
|
| 157 | |
|
|
| 158 | <p> |
157 | </p> |
|
|
158 | |
|
|
159 | <p> |
| 159 | Naturally, you are not forced to do so, and you can continue to use the old profile |
160 | Naturally, you are not forced to do so, and you can continue to use the old |
| 160 | and just update your packages |
161 | profile and just update your packages |
| 161 | <uri link="/doc/en/handbook/handbook-x86.xml?part=2&chap=1">as explained in |
162 | <uri link="/doc/en/handbook/handbook-x86.xml?part=2&chap=1">as explained |
| 162 | the Gentoo Handbook</uri>. |
163 | in the Gentoo Handbook</uri>. |
| 163 | </p> |
|
|
| 164 | |
|
|
| 165 | <p> |
164 | </p> |
|
|
165 | |
|
|
166 | <p> |
| 166 | However, Gentoo strongly recommends updating your profile if it becomes deprecated. |
167 | However, Gentoo strongly recommends updating your profile if it becomes |
| 167 | When this happens, it means that Gentoo developers no longer plan on supporting it. |
168 | deprecated. When this happens, it means that Gentoo developers no longer |
| 168 | Using the table below, you can quickly check to see what profiles are currently supported. |
169 | plan on supporting it. Using the table below, you can quickly check to |
|
|
170 | see what profiles are currently supported. |
| 169 | </p> |
171 | </p> |
| 170 | |
172 | |
| 171 | <p> |
173 | <p> |
| 172 | If you decide to migrate to the new profile, then you will have to manually |
174 | If you decide to migrate to the new profile, then you will have to manually |
| 173 | perform the update. The way you update may vary significantly from release to release; it |
175 | perform the update. The way you update may vary significantly from release |
| 174 | depends on how deep the modifications introduced in the new profile are. |
176 | to release; it depends on how deep the modifications introduced in the new |
|
|
177 | profile are. |
| 175 | </p> |
178 | </p> |
| 176 | |
179 | |
| 177 | <p> |
180 | <p> |
| 178 | In the simplest case you only have to change the <path>/etc/make.profile</path> |
181 | In the simplest case you only have to change the <path>/etc/make.profile</path> |
| 179 | symlink, in the worst case you may have to recompile your system from scratch |
182 | symlink, in the worst case you may have to recompile your system from scratch |
| 180 | while doing a neat voodoo dance. Migration is usually covered in the release |
183 | while doing a neat voodoo dance. Migration is usually covered in the release |
| 181 | notes (e.g. <uri |
184 | notes. You can also find <uri link="#instructions">instructions</uri> at the |
| 182 | link="/proj/en/releng/release/2004.3/x86-release-notes.xml">the x86 2004.3 |
185 | end of this guide. |
| 183 | release notes</uri>). You can also find <uri |
|
|
| 184 | link="#instructions">instructions</uri> at the end of this guide. |
|
|
| 185 | </p> |
186 | </p> |
| 186 | |
187 | |
| 187 | </body> |
188 | </body> |
| 188 | </section> |
189 | </section> |
| 189 | <section> |
190 | <section> |
| … | |
… | |
| 195 | </p> |
196 | </p> |
| 196 | |
197 | |
| 197 | <table> |
198 | <table> |
| 198 | <tr> |
199 | <tr> |
| 199 | <th>Architecture</th> |
200 | <th>Architecture</th> |
| 200 | <th>Most recent profile</th> |
201 | <th>Most recent profiles</th> |
| 201 | <th>Other supported profiles</th> |
202 | <th>Other supported profiles</th> |
| 202 | </tr> |
203 | </tr> |
| 203 | <tr> |
204 | <tr> |
| 204 | <th>alpha</th> |
205 | <th>alpha</th> |
| 205 | <ti>2004.3</ti> |
206 | <ti>2006.0</ti> |
| 206 | <ti></ti> |
207 | <ti>2005.0, 2005.0/2.4, no-nptl, no-nptl/2.4</ti> |
| 207 | </tr> |
208 | </tr> |
| 208 | <tr> |
209 | <tr> |
| 209 | <th>arm</th> |
210 | <th>arm</th> |
| 210 | <ti>2004.3</ti> |
211 | <ti>2004.3</ti> |
| 211 | <ti></ti> |
212 | <ti></ti> |
| 212 | </tr> |
213 | </tr> |
| 213 | <tr> |
214 | <tr> |
| 214 | <th>amd64</th> |
215 | <th>amd64</th> |
|
|
216 | <ti>2006.0</ti> |
|
|
217 | <ti>2005.1, 2005.1/no-multilib, 2005.0, 2005.0/no-multilib</ti> |
|
|
218 | </tr> |
|
|
219 | <tr> |
|
|
220 | <th>hppa</th> |
|
|
221 | <ti>2005.0</ti> |
|
|
222 | <ti>2004.3, 2004.2</ti> |
|
|
223 | </tr> |
|
|
224 | <tr> |
|
|
225 | <th>ia64</th> |
|
|
226 | <ti>2006.0</ti> |
|
|
227 | <ti>2005.0, 2004.3</ti> |
|
|
228 | </tr> |
|
|
229 | <tr> |
|
|
230 | <th>ppc</th> |
|
|
231 | <ti>2006.0</ti> |
|
|
232 | <ti>2005.1, 2005.0, 2004.3, 2004.0</ti> |
|
|
233 | </tr> |
|
|
234 | <tr> |
|
|
235 | <th>mips</th> |
|
|
236 | <ti>2006.0</ti> |
|
|
237 | <ti>2005.0, 2004.2</ti> |
|
|
238 | </tr> |
|
|
239 | <tr> |
|
|
240 | <th>s390</th> |
|
|
241 | <ti>2006.0</ti> |
| 215 | <ti>2004.3</ti> |
242 | <ti>2004.3</ti> |
| 216 | <ti>2004.2, 2004.0</ti> |
|
|
| 217 | </tr> |
|
|
| 218 | <tr> |
|
|
| 219 | <th>hppa</th> |
|
|
| 220 | <ti>2004.3</ti> |
|
|
| 221 | <ti>2004.2</ti> |
|
|
| 222 | </tr> |
|
|
| 223 | <tr> |
|
|
| 224 | <th>ia64</th> |
|
|
| 225 | <ti>2004.3</ti> |
|
|
| 226 | <ti></ti> |
|
|
| 227 | </tr> |
|
|
| 228 | <tr> |
|
|
| 229 | <th>ppc</th> |
|
|
| 230 | <ti>2004.3</ti> |
|
|
| 231 | <ti>2004.0</ti> |
|
|
| 232 | </tr> |
|
|
| 233 | <tr> |
|
|
| 234 | <th>mips</th> |
|
|
| 235 | <ti>2004.2</ti> |
|
|
| 236 | <ti></ti> |
|
|
| 237 | </tr> |
|
|
| 238 | <tr> |
|
|
| 239 | <th>s390</th> |
|
|
| 240 | <ti>2004.3</ti> |
|
|
| 241 | <ti></ti> |
|
|
| 242 | </tr> |
243 | </tr> |
| 243 | <tr> |
244 | <tr> |
| 244 | <th>sparc</th> |
245 | <th>sparc</th> |
| 245 | <ti>2004.3</ti> |
246 | <ti>2006.0, 2006.0/2.4</ti> |
| 246 | <ti>2004.0</ti> |
247 | <ti>2005.1, 2005.0</ti> |
| 247 | </tr> |
248 | </tr> |
| 248 | <tr> |
249 | <tr> |
| 249 | <th>x86</th> |
250 | <th>x86</th> |
| 250 | <ti>2004.3</ti> |
251 | <ti>2006.0, no-nptl/2.4</ti> |
| 251 | <ti>2004.2, 2004.0</ti> |
252 | <ti>2005.1, 2005.0</ti> |
| 252 | </tr> |
253 | </tr> |
| 253 | </table> |
254 | </table> |
| 254 | |
255 | |
| 255 | </body> |
256 | </body> |
| 256 | </section> |
257 | </section> |
| 257 | </chapter> |
258 | </chapter> |
| 258 | |
259 | |
| 259 | <chapter id="instructions"> |
260 | <chapter id="instructions"> |
| 260 | <title>Profile updating instructions</title> |
261 | <title>Profile updating instructions</title> |
|
|
262 | <section> |
|
|
263 | <title>Updating to 2006.0</title> |
|
|
264 | <body> |
|
|
265 | |
|
|
266 | <p> |
|
|
267 | To switch to the 2006.0 profile, point the <path>/etc/make.profile</path> |
|
|
268 | symlink to the new location. Make sure your Portage is updated before you |
|
|
269 | change your profile. |
|
|
270 | </p> |
|
|
271 | |
|
|
272 | <pre caption="Changing to a 2006.0 profile"> |
|
|
273 | # <i>rm /etc/make.profile</i> |
|
|
274 | # <i>ln -s ../usr/portage/profiles/</i><selected profile><i> /etc/make.profile</i> |
|
|
275 | </pre> |
|
|
276 | |
|
|
277 | <p> |
|
|
278 | <b>alpha</b> - Users that use a 2.4 kernel or don't want to use NPTL should use |
|
|
279 | the default-linux/alpha/no-nptl profile. More information is available in <uri |
|
|
280 | link="/proj/en/releng/release/2006.0/alpha-release-notes.xml">the alpha release |
|
|
281 | notes</uri>. |
|
|
282 | </p> |
|
|
283 | |
|
|
284 | <p> |
|
|
285 | <b>ppc</b> - The merge of the ppc32 and ppc64 profiles went forward. The ppc32 |
|
|
286 | profile has been changed in a way that offers a minimalistic generic profile |
|
|
287 | for all purposes, located in default-linux/ppc/ppc32. The release-dependent |
|
|
288 | profile is optimized for desktop-usage and located in |
|
|
289 | default-linux/ppc/ppc32/2006.0. There are some subprofiles available for G3 and |
|
|
290 | G4 processors, and G3/Pegasos and G4/Pegasos for the Pegasos Open Desktop |
|
|
291 | Workstation. Make sure you choose the correct subprofile for your system when |
|
|
292 | migrating to a 2006.0 profile. |
|
|
293 | </p> |
|
|
294 | |
|
|
295 | <p> |
|
|
296 | <b>sparc</b> - Upgrading to the <b>2.4</b>-kernel based 2006.0/2.4 profile |
|
|
297 | requires manual user intervention (unmerging java stuff) and an <c>emerge -e |
|
|
298 | world</c> because of the <uri link="/doc/en/gcc-upgrading.xml">gcc |
|
|
299 | upgrade</uri>.<br/> |
|
|
300 | Upgrading to the <b>2.6</b>-kernel based 2006.0 profile which is not considered |
|
|
301 | stable also requires an entry in <path>/etc/portage/package.unmask</path> to |
|
|
302 | umask a 2.6 version of <c>gentoo-sources</c> and a full rebuild. |
|
|
303 | </p> |
|
|
304 | |
|
|
305 | <p> |
|
|
306 | <b>All other archs</b> - There are no fundamental changes in this profile. No |
|
|
307 | specific action needs to be performed. |
|
|
308 | </p> |
|
|
309 | |
|
|
310 | </body> |
|
|
311 | </section> |
|
|
312 | <section> |
|
|
313 | <title>Updating to 2005.1</title> |
|
|
314 | <body> |
|
|
315 | |
|
|
316 | <p> |
|
|
317 | To switch to the 2005.1 profile, point the <path>/etc/make.profile</path> |
|
|
318 | symlink to the new location. Make sure your Portage is updated before you |
|
|
319 | change your profile. |
|
|
320 | </p> |
|
|
321 | |
|
|
322 | <pre caption="Changing to a 2005.1 profile"> |
|
|
323 | # <i>rm /etc/make.profile</i> |
|
|
324 | # <i>ln -s ../usr/portage/profiles/</i><selected profile><i> /etc/make.profile</i> |
|
|
325 | </pre> |
|
|
326 | |
|
|
327 | <p> |
|
|
328 | <b>All archs</b> - There are no fundamental changes in this profile. No |
|
|
329 | specific action needs to be performed. |
|
|
330 | </p> |
|
|
331 | |
|
|
332 | <p> |
|
|
333 | <b>ppc</b> - With the 2005.1 release, the ppc and ppc64 profiles were merged |
|
|
334 | and a number of subprofiles for specific subarchitectures were created. Make |
|
|
335 | sure you choose the correct subprofile for your system when migrating to a |
|
|
336 | 2005.1 profile. |
|
|
337 | </p> |
|
|
338 | |
|
|
339 | </body> |
|
|
340 | </section> |
|
|
341 | <section> |
|
|
342 | <title>Updating to 2005.0</title> |
|
|
343 | <body> |
|
|
344 | |
|
|
345 | <p> |
|
|
346 | With the introduction of 2005.0, several architectures have decided to define |
|
|
347 | additional profiles. Make sure you read the description of said profiles before |
|
|
348 | you decide to migrate to one of them. Most architectures now also default to the |
|
|
349 | 2.6 kernel tree where 2.4 was chosen previously. |
|
|
350 | </p> |
|
|
351 | |
|
|
352 | <p> |
|
|
353 | Some architectures require a bit more actions to be completed in order to |
|
|
354 | convert from one profile to another. If that is the case, the step-by-step |
|
|
355 | guides are linked from the table. |
|
|
356 | </p> |
|
|
357 | |
|
|
358 | <table> |
|
|
359 | <tr> |
|
|
360 | <th>Profile</th> |
|
|
361 | <th>Description</th> |
|
|
362 | <th>Specific Upgrade Guide</th> |
|
|
363 | </tr> |
|
|
364 | <tr> |
|
|
365 | <ti>default-linux/alpha/2005.0</ti> |
|
|
366 | <ti>Default Alpha 2005.0 profile for 2.6 kernels</ti> |
|
|
367 | <ti></ti> |
|
|
368 | </tr> |
|
|
369 | <tr> |
|
|
370 | <ti>default-linux/alpha/2005.0/2.4</ti> |
|
|
371 | <ti>Alpha 2005.0 profile for 2.4 kernels</ti> |
|
|
372 | <ti></ti> |
|
|
373 | </tr> |
|
|
374 | <tr> |
|
|
375 | <ti>default-linux/amd64/2005.0</ti> |
|
|
376 | <ti>Default AMD64 2005.0 profile for 2.6 kernels</ti> |
|
|
377 | <ti></ti> |
|
|
378 | </tr> |
|
|
379 | <tr> |
|
|
380 | <ti>default-linux/amd64/2005.0/no-multilib</ti> |
|
|
381 | <ti>AMD64 2005.0 profile for multilib-disabled system installations</ti> |
|
|
382 | <ti></ti> |
|
|
383 | </tr> |
|
|
384 | <tr> |
|
|
385 | <ti>default-linux/arm/2005.0</ti> |
|
|
386 | <ti>Default ARM 2005.0 profile for 2.6 kernels</ti> |
|
|
387 | <ti></ti> |
|
|
388 | </tr> |
|
|
389 | <tr> |
|
|
390 | <ti>default-linux/hppa/2005.0</ti> |
|
|
391 | <ti>Default HPPA 2005.0 profile for 2.6 kernels</ti> |
|
|
392 | <ti></ti> |
|
|
393 | </tr> |
|
|
394 | <tr> |
|
|
395 | <ti>default-linux/hppa/2005.0/2.4</ti> |
|
|
396 | <ti>HPPA 2005.0 profile for 2.4 kernels</ti> |
|
|
397 | <ti></ti> |
|
|
398 | </tr> |
|
|
399 | <tr> |
|
|
400 | <ti>default-linux/mips/2005.0</ti> |
|
|
401 | <ti>Default MIPS 2005.0 profile</ti> |
|
|
402 | <ti></ti> |
|
|
403 | </tr> |
|
|
404 | <tr> |
|
|
405 | <ti>default-linux/mips/cobalt/2005.0</ti> |
|
|
406 | <ti>Cobalt specific MIPS 2005.0 profile</ti> |
|
|
407 | <ti></ti> |
|
|
408 | </tr> |
|
|
409 | <tr> |
|
|
410 | <ti>default-linux/mips/mips64/n32/2005.0</ti> |
|
|
411 | <ti>2005.0 profile for n32-supporting MIPS platforms</ti> |
|
|
412 | <ti></ti> |
|
|
413 | </tr> |
|
|
414 | <tr> |
|
|
415 | <ti>default-linux/mips/mips64/ip28/2005.0</ti> |
|
|
416 | <ti>Indigo2 Impact specific 64-bit 2005.0 profile</ti> |
|
|
417 | <ti></ti> |
|
|
418 | </tr> |
|
|
419 | <tr> |
|
|
420 | <ti>default-linux/mips/mips64/2005.0</ti> |
|
|
421 | <ti>64-bit MIPS 2005.0 profile</ti> |
|
|
422 | <ti></ti> |
|
|
423 | </tr> |
|
|
424 | <tr> |
|
|
425 | <ti>default-linux/ppc/2005.0</ti> |
|
|
426 | <ti>Default PPC 2005.0 profile for 2.6 kernels</ti> |
|
|
427 | <ti></ti> |
|
|
428 | </tr> |
|
|
429 | <tr> |
|
|
430 | <ti>default-linux/ppc64/2005.0</ti> |
|
|
431 | <ti>Default PPC64 2005.0 profile for 2.6 kernels</ti> |
|
|
432 | <ti></ti> |
|
|
433 | </tr> |
|
|
434 | <tr> |
|
|
435 | <ti>default-linux/s390/2005.0</ti> |
|
|
436 | <ti>Default S390 2005.0 profile</ti> |
|
|
437 | <ti></ti> |
|
|
438 | </tr> |
|
|
439 | <tr> |
|
|
440 | <ti>default-linux/sparc/sparc32/2005.0</ti> |
|
|
441 | <ti>Default Sparc 32-bit 2005.0 profile</ti> |
|
|
442 | <ti></ti> |
|
|
443 | </tr> |
|
|
444 | <!-- http://dev.gentoo.org/~dsd/kernel-2.6.htm |
|
|
445 | No subprofiles for sparc |
|
|
446 | <tr> |
|
|
447 | <ti>default-linux/sparc/sparc32/2005.0/2.6</ti> |
|
|
448 | <ti>Sparc 32-bit 2005.0 profile for 2.6 kernels</ti> |
|
|
449 | <ti></ti> |
|
|
450 | </tr> |
|
|
451 | --> |
|
|
452 | <tr> |
|
|
453 | <ti>default-linux/sparc/sparc64/2005.0</ti> |
|
|
454 | <ti>Default Sparc 64-bit 2005.0 profile</ti> |
|
|
455 | <ti></ti> |
|
|
456 | </tr> |
|
|
457 | <!-- http://dev.gentoo.org/~dsd/kernel-2.6.htm |
|
|
458 | No subprofiles for sparc |
|
|
459 | <tr> |
|
|
460 | <ti>default-linux/sparc/sparc64/2005.0/2.6</ti> |
|
|
461 | <ti>Sparc 64-bit 2005.0 profile for 2.6 kernels</ti> |
|
|
462 | <ti></ti> |
|
|
463 | </tr> |
|
|
464 | --> |
|
|
465 | <tr> |
|
|
466 | <ti>default-linux/x86/2005.0</ti> |
|
|
467 | <ti>Default x86 2005.0 profile for 2.6 kernels</ti> |
|
|
468 | <ti></ti> |
|
|
469 | </tr> |
|
|
470 | <tr> |
|
|
471 | <ti>default-linux/x86/2005.0/2.4</ti> |
|
|
472 | <ti>x86 2005.0 profile for 2.4 kernels</ti> |
|
|
473 | <ti></ti> |
|
|
474 | </tr> |
|
|
475 | </table> |
|
|
476 | |
|
|
477 | <p> |
|
|
478 | To switch to the selected profile, point the <path>/etc/make.profile</path> |
|
|
479 | symlink to the new location. Make sure your Portage is updated before you change |
|
|
480 | your profile! |
|
|
481 | </p> |
|
|
482 | |
|
|
483 | <pre caption="Changing to a 2005.0 profile"> |
|
|
484 | # <i>rm /etc/make.profile</i> |
|
|
485 | # <i>ln -s ../usr/portage/profiles/</i><selected profile><i> /etc/make.profile</i> |
|
|
486 | </pre> |
|
|
487 | |
|
|
488 | <p> |
|
|
489 | If you are running a Linux 2.4-based system but want to migrate to a 2.6-based |
|
|
490 | kernel, make sure you read our <uri link="/doc/en/migration-to-2.6.xml">Gentoo |
|
|
491 | Linux 2.6 Migration Guide</uri>. |
|
|
492 | </p> |
|
|
493 | |
|
|
494 | </body> |
|
|
495 | </section> |
| 261 | <section> |
496 | <section> |
| 262 | <title>Updating to 2004.3</title> |
497 | <title>Updating to 2004.3</title> |
| 263 | <body> |
498 | <body> |
| 264 | |
499 | |
| 265 | <p> |
500 | <p> |
| … | |
… | |
| 297 | <path>/var/lib/portage/world</path> after the profile switch, or manually |
532 | <path>/var/lib/portage/world</path> after the profile switch, or manually |
| 298 | emerge them. |
533 | emerge them. |
| 299 | </p> |
534 | </p> |
| 300 | |
535 | |
| 301 | <p> |
536 | <p> |
| 302 | <b>ppc</b> - <c>sys-fs/udev</c> is now the default instead of <c>sys-fs/devfs</c> |
537 | <b>ppc</b> - <c>sys-fs/udev</c> is now the default instead of |
| 303 | for newly installed machines. This has no effect on already installed machines, |
538 | <c>sys-fs/devfs</c> for newly installed machines. This has no |
| 304 | though. |
539 | effect on already installed machines, though. |
|
|
540 | </p> |
|
|
541 | |
|
|
542 | </body> |
|
|
543 | </section> |
|
|
544 | <section> |
|
|
545 | <title>Updating Portage to Support Cascading Profiles</title> |
|
|
546 | <body> |
|
|
547 | |
| 305 | </p> |
548 | <p> |
|
|
549 | Although this section does not seem to integrate well in this upgrading guide, |
|
|
550 | it is quite important. Any profile listed above this section requires a Portage |
|
|
551 | version that supports cascading profiles. However, some obsoleted profiles don't |
|
|
552 | allow the user to upgrade Portage or the user is using a profile that isn't |
|
|
553 | available anymore - any attempt to upgrade Portage will result in a failure. |
|
|
554 | </p> |
|
|
555 | |
|
|
556 | <p> |
|
|
557 | To work around this problem, users can set a temporary symbolic link to the |
|
|
558 | <e>obsolete</e> profile, allowing them to upgrade their Portage after which |
|
|
559 | they can continue with the upgrade procedure set forth in this guide. Please |
|
|
560 | substitute <c><arch></c> with your respective architecture: |
|
|
561 | </p> |
|
|
562 | |
|
|
563 | <pre caption="Updating Portage through the obsolete profile"> |
|
|
564 | # <i>rm /etc/make.profile</i> |
|
|
565 | # <i>cd /etc</i> |
|
|
566 | # <i>ln -sf ../usr/portage/profiles/obsolete/<arch> make.profile</i> |
|
|
567 | # <i>emerge -n '>=sys-apps/portage-2.0.51'</i> |
|
|
568 | </pre> |
| 306 | |
569 | |
| 307 | </body> |
570 | </body> |
| 308 | </section> |
571 | </section> |
| 309 | <section> |
572 | <section> |
| 310 | <title>Updating to 2004.2</title> |
573 | <title>Updating to 2004.2</title> |
| 311 | <body> |
574 | <body> |
| 312 | |
575 | |
| 313 | <p> |
576 | <p> |
| 314 | To switch to the 2004.2 profile, point the <path>/etc/make.profile</path> symlink |
577 | To switch to the 2004.2 profile, point the <path>/etc/make.profile</path> |
| 315 | to the new location: |
578 | symlink to the new location: |
| 316 | </p> |
579 | </p> |
| 317 | |
580 | |
| 318 | <warn> |
581 | <warn> |
| 319 | Don't forget to upgrade Portage <e>before</e> you change your profile!!! |
582 | Don't forget to upgrade Portage <e>before</e> you change your profile!!! |
| 320 | </warn> |
583 | </warn> |
| … | |
… | |
| 344 | <section> |
607 | <section> |
| 345 | <title>Updating to 2004.0</title> |
608 | <title>Updating to 2004.0</title> |
| 346 | <body> |
609 | <body> |
| 347 | |
610 | |
| 348 | <p> |
611 | <p> |
| 349 | To switch to the 2004.0 profile, point the <path>/etc/make.profile</path> symlink |
612 | To switch to the 2004.0 profile, point the <path>/etc/make.profile</path> |
| 350 | to the new location: |
613 | symlink to the new location: |
| 351 | </p> |
614 | </p> |
| 352 | |
615 | |
| 353 | <pre caption="Updating the /etc/make.profile symlink"> |
616 | <pre caption="Updating the /etc/make.profile symlink"> |
| 354 | <comment>substitute <arch> with your arch</comment> |
617 | <comment>substitute <arch> with your arch</comment> |
| 355 | # <i>rm /etc/make.profile</i> |
618 | # <i>rm /etc/make.profile</i> |