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.36 2007/01/10 07:29:40 nightmorph Exp $ --> |
3 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-upgrading.xml,v 1.37 2007/05/07 18:11:40 nightmorph 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 | <author title="Editor"> |
11 | <author title="Editor"> |
12 | <mail link="wolf31o2@gentoo.org">Chris Gianelloni</mail> |
12 | <mail link="wolf31o2@gentoo.org">Chris Gianelloni</mail> |
13 | </author> |
13 | </author> |
|
|
14 | <author title="Editor"> |
|
|
15 | <mail link="nightmorph@gentoo.org">Joshua Saddler</mail> |
|
|
16 | </author> |
14 | |
17 | |
15 | <abstract> |
18 | <abstract> |
16 | This document explains how new Gentoo releases affect existing installs. |
19 | This document explains how new Gentoo releases affect existing installs. |
17 | </abstract> |
20 | </abstract> |
18 | |
21 | |
19 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
22 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
20 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
23 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
21 | <license/> |
24 | <license/> |
22 | |
25 | |
23 | <version>2.7</version> |
26 | <version>2.8</version> |
24 | <date>2007-01-09</date> |
27 | <date>2007-05-05</date> |
25 | |
28 | |
26 | <chapter> |
29 | <chapter> |
27 | <title>Gentoo and Upgrades</title> |
30 | <title>Gentoo and Upgrades</title> |
28 | <section> |
31 | <section> |
29 | <title>Philosophy</title> |
32 | <title>Philosophy</title> |
… | |
… | |
100 | |
103 | |
101 | <p> |
104 | <p> |
102 | The profile in use is determined by the symbolic link |
105 | The profile in use is determined by the symbolic link |
103 | <path>/etc/make.profile</path>, which points to a subdirectory of |
106 | <path>/etc/make.profile</path>, which points to a subdirectory of |
104 | <path>/usr/portage/profiles</path> which holds the profile files. For |
107 | <path>/usr/portage/profiles</path> which holds the profile files. For |
105 | instance, the default x86 2006.1 profile can be found |
108 | instance, the default x86 2007.0 profile can be found |
106 | at <path>/usr/portage/profiles/default-linux/x86/2006.1</path>. |
109 | at <path>/usr/portage/profiles/default-linux/x86/2007.0</path>. |
107 | The files in the parent directories are part of the profile as well (and |
110 | The files in the parent directories are part of the profile as well (and |
108 | are therefore shared by different subprofiles). This is why we call these |
111 | are therefore shared by different subprofiles). This is why we call these |
109 | <e>cascaded profiles</e>. |
112 | <e>cascaded profiles</e>. |
110 | </p> |
113 | </p> |
111 | |
114 | |
… | |
… | |
153 | <section> |
156 | <section> |
154 | <title>Releases with profile changes</title> |
157 | <title>Releases with profile changes</title> |
155 | <body> |
158 | <body> |
156 | |
159 | |
157 | <p> |
160 | <p> |
158 | If a release (such as 2006.1 for x86) introduces a new profile, you have the |
161 | If a release (such as 2007.0 for x86) introduces a new profile, you have the |
159 | choice to migrate to the new profile. |
162 | choice to migrate to the new profile. |
160 | </p> |
163 | </p> |
161 | |
164 | |
162 | <p> |
165 | <p> |
163 | Naturally, you are not forced to do so, and you can continue to use the old |
166 | Naturally, you are not forced to do so, and you can continue to use the old |
… | |
… | |
193 | <section> |
196 | <section> |
194 | <title>Supported profiles</title> |
197 | <title>Supported profiles</title> |
195 | <body> |
198 | <body> |
196 | |
199 | |
197 | <p> |
200 | <p> |
198 | The following profiles are officially supported by Gentoo developers: |
201 | You can view the list of profiles on your architecture officially supported by |
|
|
202 | Gentoo developers when you <c>emerge eselect</c> and then run the following |
|
|
203 | command: |
|
|
204 | </p> |
|
|
205 | |
|
|
206 | <pre caption="Viewing supported profiles"> |
|
|
207 | # <i>eselect profile list</i> |
199 | </p> |
208 | </pre> |
200 | |
|
|
201 | <table> |
|
|
202 | <tr> |
|
|
203 | <th>Architecture</th> |
|
|
204 | <th>Most recent profiles</th> |
|
|
205 | <th>Other supported profiles</th> |
|
|
206 | </tr> |
|
|
207 | <tr> |
|
|
208 | <th>alpha</th> |
|
|
209 | <ti>default-linux/alpha/2006.1</ti> |
|
|
210 | <ti> |
|
|
211 | default-linux/alpha/2006.0, default-linux/alpha/2006.1/desktop, |
|
|
212 | default-linux/alpha/2006.1/server, default-linux/alpha/no-nptl, |
|
|
213 | default-linux/alpha/no-nptl/2.4 |
|
|
214 | </ti> |
|
|
215 | </tr> |
|
|
216 | <tr> |
|
|
217 | <th>arm</th> |
|
|
218 | <ti>default-linux/arm/2004.3</ti> |
|
|
219 | <ti></ti> |
|
|
220 | </tr> |
|
|
221 | <tr> |
|
|
222 | <th>amd64</th> |
|
|
223 | <ti>default-linux/amd64/2006.1</ti> |
|
|
224 | <ti> |
|
|
225 | default-linux/amd64/2006.0, default-linux/amd64/2006.0/no-multilib, |
|
|
226 | default-linux/amd64/2006.1/desktop, default-linux/amd64/2006.1/server, |
|
|
227 | default-linux/amd64/2006.1/no-multilib |
|
|
228 | </ti> |
|
|
229 | </tr> |
|
|
230 | <tr> |
|
|
231 | <th>hppa</th> |
|
|
232 | <ti>default-linux/hppa/2006.1</ti> |
|
|
233 | <ti>default-linux/hppa/2005.0</ti> |
|
|
234 | </tr> |
|
|
235 | <tr> |
|
|
236 | <th>ia64</th> |
|
|
237 | <ti>default-linux/ia64/2006.0</ti> |
|
|
238 | <ti>default-linux/ia64/2005.0</ti> |
|
|
239 | </tr> |
|
|
240 | <tr> |
|
|
241 | <th>ppc</th> |
|
|
242 | <ti>default-linux/ppc/ppc32/2006.1, default-linux/ppc/ppc64/2006.1</ti> |
|
|
243 | <ti> |
|
|
244 | default-linux/ppc/ppc32/2006.0, default-linux/ppc/ppc64,2006.0, |
|
|
245 | default-linux/ppc/ppc32/2006.0/G3, |
|
|
246 | default-linux/ppc/ppc32/2006.0/G3/Pegasos, |
|
|
247 | default-linux/ppc/ppc32/2006.0/G4, |
|
|
248 | default-linux/ppc/ppc32/2006.0/G4/Pegasos, |
|
|
249 | default-linux/ppc/ppc32/2006,1/G3, |
|
|
250 | default-linux/ppc/ppc32/2006.1/G3/Pegasos, |
|
|
251 | default-linux/ppc/ppc32/2006.1/G4, |
|
|
252 | default-linux/ppc/ppc32/2006.1/G4/Pegasos, |
|
|
253 | default-linux/ppc/ppc64/2006.0/32bit-userland, |
|
|
254 | default-linux/ppc/ppc64/2006.0/32bit-userland/970, |
|
|
255 | default-linux/ppc/ppc64/2006.0/32bit-userland/power3, |
|
|
256 | default-linux/ppc/ppc64/2006.0/32bit-userland/power4, |
|
|
257 | default-linux/ppc/ppc64/2006.0/32bit-userland/power5, |
|
|
258 | default-linux/ppc/ppc64/2006.0/64bit-userland/970, |
|
|
259 | default-linux/ppc/ppc64/2006.0/64bit-userland/power3, |
|
|
260 | default-linux/ppc/ppc64/2006.0/64bit-userland/power4, |
|
|
261 | default-linux/ppc/ppc64/2006.0/64bit-userland/power5, |
|
|
262 | default-linux/ppc/ppc64/2006.1/32bit-userland, |
|
|
263 | default-linux/ppc/ppc64/2006.1/32bit-userland/970, |
|
|
264 | default-linux/ppc/ppc64/2006.1/32bit-userland/power3, |
|
|
265 | default-linux/ppc/ppc64/2006.1/32bit-userland/power4, |
|
|
266 | default-linux/ppc/ppc64/2006.1/32bit-userland/power5, |
|
|
267 | default-linux/ppc/ppc64/2006.1/64bit-userland/970, |
|
|
268 | default-linux/ppc/ppc64/2006.1/64bit-userland/power3, |
|
|
269 | default-linux/ppc/ppc64/2006.1/64bit-userland/power4, |
|
|
270 | default-linux/ppc/ppc64/2006.1/64bit-userland/power5 |
|
|
271 | </ti> |
|
|
272 | </tr> |
|
|
273 | <tr> |
|
|
274 | <th>mips</th> |
|
|
275 | <ti>default-linux/mips/2006.1</ti> |
|
|
276 | <ti> |
|
|
277 | default-linux/mips/2006.1/cobalt/o32, |
|
|
278 | default-linux/mips/2006.1/generic-be/o32, |
|
|
279 | default-linux/mips/2006.1/ip27/o32, default-linux/mips/2006.1/ip28/o32, |
|
|
280 | default-linux/mips/2006.1/ip30/o32 |
|
|
281 | </ti> |
|
|
282 | </tr> |
|
|
283 | <tr> |
|
|
284 | <th>s390</th> |
|
|
285 | <ti>2006.0</ti> |
|
|
286 | <ti>2004.3</ti> |
|
|
287 | </tr> |
|
|
288 | <tr> |
|
|
289 | <th>sh</th> |
|
|
290 | <ti>default-linux/sh/2006.1</ti> |
|
|
291 | <ti></ti> |
|
|
292 | </tr> |
|
|
293 | <tr> |
|
|
294 | <th>sparc</th> |
|
|
295 | <ti> |
|
|
296 | default-linux/sparc/sparc64/2006.1, default-linux/sparc/sparc64/2006.1/2.4 |
|
|
297 | </ti> |
|
|
298 | <ti> |
|
|
299 | default-linux/sparc/sparc64/2006.0, default-linux/sparc/sparc64/2006.0/2.4 |
|
|
300 | </ti> |
|
|
301 | </tr> |
|
|
302 | <tr> |
|
|
303 | <th>x86</th> |
|
|
304 | <ti> |
|
|
305 | default-linux/x86/2006.1, default-linux/x86/no-nptl, |
|
|
306 | default-linux/x86/no-nptl/2.4 |
|
|
307 | </ti> |
|
|
308 | <ti> |
|
|
309 | default-linux/x86/2006.1/desktop, default-linux/x86/2006.1/server, |
|
|
310 | default-linux/x86/2006.0 |
|
|
311 | </ti> |
|
|
312 | </tr> |
|
|
313 | </table> |
|
|
314 | |
209 | |
315 | </body> |
210 | </body> |
316 | </section> |
211 | </section> |
317 | </chapter> |
212 | </chapter> |
318 | |
213 | |
319 | <chapter id="instructions"> |
214 | <chapter id="instructions"> |
320 | <title>Profile updating instructions</title> |
215 | <title>Profile updating instructions</title> |
|
|
216 | <section id="general"> |
|
|
217 | <title>General instructions</title> |
|
|
218 | <body> |
|
|
219 | |
|
|
220 | <impo> |
|
|
221 | Make sure your Portage is updated before performing any profile changes. |
|
|
222 | </impo> |
|
|
223 | |
|
|
224 | <p> |
|
|
225 | First, run <c>emerge eselect</c>. The <c>eselect</c> utility will let you view |
|
|
226 | and select profiles easily, without needing to create or remove symlinks by |
|
|
227 | hand. |
|
|
228 | </p> |
|
|
229 | |
|
|
230 | <pre caption="Profile selection with eselect"> |
|
|
231 | <comment>(View available profiles)</comment> |
|
|
232 | # <i>eselect profile list</i> |
|
|
233 | |
|
|
234 | <comment>(Select the number of your desired profile from the list)</comment> |
|
|
235 | # <i>eselect profile set <number></i> |
|
|
236 | </pre> |
|
|
237 | |
|
|
238 | <p> |
|
|
239 | If you'd still prefer to change profiles manually, then simply do the following: |
|
|
240 | </p> |
|
|
241 | |
|
|
242 | <pre caption="Changing profiles manually"> |
|
|
243 | # <i>rm /etc/make.profile</i> |
|
|
244 | # <i>ln -s ../usr/portage/profiles/</i><selected profile><i> /etc/make.profile</i> |
|
|
245 | </pre> |
|
|
246 | |
|
|
247 | <note> |
|
|
248 | There are <b>desktop</b> and <b>server</b> subprofiles for most architectures. |
|
|
249 | Examine these profiles carefully, as they may serve your needs better than the |
|
|
250 | extremely minimal default profiles. |
|
|
251 | </note> |
|
|
252 | |
|
|
253 | </body> |
321 | <section> |
254 | </section> |
|
|
255 | <section> |
322 | <title>Updating to 2006.1</title> |
256 | <title>Updating to 2007.0 or 2006.1</title> |
323 | <body> |
257 | <body> |
324 | |
258 | |
325 | <p> |
259 | <p> |
326 | If you intend to upgrade to this profile, you should be aware that it expects |
260 | If you intend to upgrade to these profiles, you should be aware that they expect |
327 | the system to be set to a Unicode locale by default; specifically that |
261 | the system to be set to a Unicode locale by default; specifically that |
328 | UNICODE="yes" is set in <path>/etc/rc.conf</path>. For this to work, you must |
262 | UNICODE="yes" is set in <path>/etc/rc.conf</path>. For this to work, you must |
329 | have created a Unicode locale for your system to use. Please read our <uri |
263 | have created a Unicode locale for your system to use. Please read our <uri |
330 | link="/doc/en/utf-8.xml">UTF-8 guide</uri> to learn how to create the proper |
264 | link="/doc/en/utf-8.xml">UTF-8 guide</uri> to learn how to create the proper |
331 | locale. |
265 | locale. |
… | |
… | |
349 | # <i>nano -w /etc/make.conf</i> |
283 | # <i>nano -w /etc/make.conf</i> |
350 | USE="-unicode" |
284 | USE="-unicode" |
351 | # <i>emerge -a baselayout</i> |
285 | # <i>emerge -a baselayout</i> |
352 | </pre> |
286 | </pre> |
353 | |
287 | |
354 | <p> |
288 | <note> |
355 | To switch to the 2006.1 profile, point the <path>/etc/make.profile</path> |
289 | If you are updating to a 2007.0 profile on the Sparc architecture, then you will |
356 | symlink to the new location. Make sure your Portage is updated before you |
290 | need to follow the <uri link="/doc/en/gcc-upgrading.xml">GCC Upgrading |
357 | change your profile. |
291 | Guide</uri>, as <c>gcc-4</c> is the default compiler. |
|
|
292 | </note> |
|
|
293 | |
358 | </p> |
294 | <p> |
359 | |
295 | Finally, follow the <uri link="#general">general instructions</uri> for updating |
360 | <pre caption="Changing to a 2006.1 profile"> |
296 | your profile. |
361 | # <i>rm /etc/make.profile</i> |
|
|
362 | # <i>ln -s ../usr/portage/profiles/</i><selected profile><i> /etc/make.profile</i> |
|
|
363 | </pre> |
|
|
364 | |
|
|
365 | <p> |
|
|
366 | Please note that the <b>alpha</b>/2006.1, <b>amd64</b>/2006.1 and |
|
|
367 | <b>x86</b>/2006.1 profiles are very minimal. They all have a <c>desktop</c> |
|
|
368 | sub-profile that is likely what you want on a desktop machine. |
|
|
369 | </p> |
297 | </p> |
370 | |
298 | |
371 | </body> |
299 | </body> |
372 | </section> |
300 | </section> |
373 | <section> |
301 | <section> |