| 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.42 2011/09/04 17:53:40 swift Exp $ --> |
3 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-upgrading.xml,v 1.43 2012/07/24 12:12:51 swift Exp $ --> |
| 4 | |
4 | |
| 5 | <guide> |
5 | <guide> |
| 6 | <title>Gentoo Upgrading Guide</title> |
6 | <title>Gentoo Upgrading Guide</title> |
| 7 | |
7 | |
| 8 | <author title="Author"> |
8 | <author title="Author"> |
| … | |
… | |
| 21 | |
21 | |
| 22 | <!-- 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 --> |
| 23 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
23 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 24 | <license/> |
24 | <license/> |
| 25 | |
25 | |
| 26 | <version>2.11</version> |
26 | <version>3</version> |
| 27 | <date>2008-07-06</date> |
27 | <date>2012-07-24</date> |
| 28 | |
28 | |
| 29 | <chapter> |
29 | <chapter> |
| 30 | <title>Gentoo and Upgrades</title> |
30 | <title>Gentoo and Upgrades</title> |
| 31 | <section> |
31 | <section> |
| 32 | <title>Philosophy</title> |
32 | <title>Philosophy</title> |
| … | |
… | |
| 101 | mapping for virtual packages, and the architecture on which the system is running. |
101 | mapping for virtual packages, and the architecture on which the system is running. |
| 102 | </p> |
102 | </p> |
| 103 | |
103 | |
| 104 | <p> |
104 | <p> |
| 105 | The profile in use is determined by the symbolic link |
105 | The profile in use is determined by the symbolic link |
| 106 | <path>/etc/make.profile</path>, which points to a subdirectory of |
106 | <path>/etc/portage/make.profile</path>, which points to a subdirectory of |
| 107 | <path>/usr/portage/profiles</path> which holds the profile files. For |
107 | <path>/usr/portage/profiles</path> which holds the profile files. For |
| 108 | instance, the default x86 2008.0 profile can be found |
108 | instance, the default x86 2008.0 profile can be found |
| 109 | at <path>/usr/portage/profiles/default/linux/x86/2008.0</path>. |
109 | at <path>/usr/portage/profiles/default/linux/x86/2008.0</path>. |
| 110 | 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 |
| 111 | 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 |
| … | |
… | |
| 181 | to release; it depends on how deep the modifications introduced in the new |
181 | to release; it depends on how deep the modifications introduced in the new |
| 182 | profile are. |
182 | profile are. |
| 183 | </p> |
183 | </p> |
| 184 | |
184 | |
| 185 | <p> |
185 | <p> |
| 186 | In the simplest case you only have to change the <path>/etc/make.profile</path> |
186 | In the simplest case you only have to change the <path>/etc/portage/make.profile</path> |
| 187 | symlink, in the worst case you may have to recompile your system from scratch |
187 | symlink, in the worst case you may have to recompile your system from scratch |
| 188 | while doing a neat voodoo dance. Migration is usually covered in the release |
188 | while doing a neat voodoo dance. Migration is usually covered in the release |
| 189 | notes. You can also find <uri link="#instructions">instructions</uri> at the |
189 | notes. You can also find <uri link="#instructions">instructions</uri> at the |
| 190 | end of this guide. |
190 | end of this guide. |
| 191 | </p> |
191 | </p> |
| … | |
… | |
| 237 | <p> |
237 | <p> |
| 238 | If you'd still prefer to change profiles manually, then simply do the following: |
238 | If you'd still prefer to change profiles manually, then simply do the following: |
| 239 | </p> |
239 | </p> |
| 240 | |
240 | |
| 241 | <pre caption="Changing profiles manually"> |
241 | <pre caption="Changing profiles manually"> |
| 242 | # <i>rm /etc/make.profile</i> |
242 | # <i>rm /etc/portage/make.profile</i> |
| 243 | # <i>ln -s ../usr/portage/profiles/</i><selected profile><i> /etc/make.profile</i> |
243 | # <i>ln -s ../usr/portage/profiles/</i><selected profile><i> /etc/portage/make.profile</i> |
| 244 | </pre> |
244 | </pre> |
| 245 | |
245 | |
| 246 | <note> |
246 | <note> |
| 247 | There are <b>desktop</b> and <b>server</b> subprofiles for most architectures. |
247 | There are <b>desktop</b> and <b>server</b> subprofiles for most architectures. |
| 248 | Examine these profiles carefully, as they may serve your needs better than the |
248 | Examine these profiles carefully, as they may serve your needs better than the |
| … | |
… | |
| 273 | Alternatively, if you do not wish to set a locale, you should specify |
273 | Alternatively, if you do not wish to set a locale, you should specify |
| 274 | UNICODE="no" in <path>/etc/rc.conf</path>, and re-emerge <c>baselayout</c> (or |
274 | UNICODE="no" in <path>/etc/rc.conf</path>, and re-emerge <c>baselayout</c> (or |
| 275 | wait until your next <c>baselayout</c> update) with the <c>-unicode</c> USE |
275 | wait until your next <c>baselayout</c> update) with the <c>-unicode</c> USE |
| 276 | flag. You can set <c>-unicode</c> just for <c>baselayout</c>, or you can set it |
276 | flag. You can set <c>-unicode</c> just for <c>baselayout</c>, or you can set it |
| 277 | globally for all packages by adding it to your USE variable in |
277 | globally for all packages by adding it to your USE variable in |
| 278 | <path>/etc/make.conf</path>. |
278 | <path>/etc/portage/make.conf</path>. |
| 279 | </p> |
279 | </p> |
| 280 | |
280 | |
| 281 | <pre caption="Optional: removing Unicode support"> |
281 | <pre caption="Optional: removing Unicode support"> |
| 282 | <comment>(To remove Unicode support just for baselayout)</comment> |
282 | <comment>(To remove Unicode support just for baselayout)</comment> |
| 283 | # <i>echo "sys-apps/baselayout -unicode" >> /etc/portage/package.use</i> |
283 | # <i>echo "sys-apps/baselayout -unicode" >> /etc/portage/package.use</i> |
| 284 | # <i>emerge -a baselayout</i> |
284 | # <i>emerge -a baselayout</i> |
| 285 | |
285 | |
| 286 | <comment>(To remove Unicode support from your whole system)</comment> |
286 | <comment>(To remove Unicode support from your whole system)</comment> |
| 287 | # <i>nano -w /etc/make.conf</i> |
287 | # <i>nano -w /etc/portage/make.conf</i> |
| 288 | USE="-unicode" |
288 | USE="-unicode" |
| 289 | # <i>emerge -a baselayout</i> |
289 | # <i>emerge -a baselayout</i> |
| 290 | </pre> |
290 | </pre> |
| 291 | |
291 | |
| 292 | <note> |
292 | <note> |
| … | |
… | |
| 305 | <section> |
305 | <section> |
| 306 | <title>Updating to 2006.0</title> |
306 | <title>Updating to 2006.0</title> |
| 307 | <body> |
307 | <body> |
| 308 | |
308 | |
| 309 | <p> |
309 | <p> |
| 310 | To switch to the 2006.0 profile, point the <path>/etc/make.profile</path> |
310 | To switch to the 2006.0 profile, point the <path>/etc/portage/make.profile</path> |
| 311 | symlink to the new location. Make sure your Portage is updated before you |
311 | symlink to the new location. Make sure your Portage is updated before you |
| 312 | change your profile. |
312 | change your profile. |
| 313 | </p> |
313 | </p> |
| 314 | |
314 | |
| 315 | <pre caption="Changing to a 2006.0 profile"> |
315 | <pre caption="Changing to a 2006.0 profile"> |
| 316 | # <i>rm /etc/make.profile</i> |
316 | # <i>rm /etc/portage/make.profile</i> |
| 317 | # <i>ln -s ../usr/portage/profiles/</i><selected profile><i> /etc/make.profile</i> |
317 | # <i>ln -s ../usr/portage/profiles/</i><selected profile><i> /etc/portage/make.profile</i> |
| 318 | </pre> |
318 | </pre> |
| 319 | |
319 | |
| 320 | <p> |
320 | <p> |
| 321 | <b>alpha</b> - Users that use a 2.4 kernel or don't want to use NPTL should use |
321 | <b>alpha</b> - Users that use a 2.4 kernel or don't want to use NPTL should use |
| 322 | the default-linux/alpha/no-nptl profile. More information is available in <uri |
322 | the default-linux/alpha/no-nptl profile. More information is available in <uri |
| … | |
… | |
| 355 | <section> |
355 | <section> |
| 356 | <title>Updating to 2005.1</title> |
356 | <title>Updating to 2005.1</title> |
| 357 | <body> |
357 | <body> |
| 358 | |
358 | |
| 359 | <p> |
359 | <p> |
| 360 | To switch to the 2005.1 profile, point the <path>/etc/make.profile</path> |
360 | To switch to the 2005.1 profile, point the <path>/etc/portage/make.profile</path> |
| 361 | symlink to the new location. Make sure your Portage is updated before you |
361 | symlink to the new location. Make sure your Portage is updated before you |
| 362 | change your profile. |
362 | change your profile. |
| 363 | </p> |
363 | </p> |
| 364 | |
364 | |
| 365 | <pre caption="Changing to a 2005.1 profile"> |
365 | <pre caption="Changing to a 2005.1 profile"> |
| 366 | # <i>rm /etc/make.profile</i> |
366 | # <i>rm /etc/portage/make.profile</i> |
| 367 | # <i>ln -s ../usr/portage/profiles/</i><selected profile><i> /etc/make.profile</i> |
367 | # <i>ln -s ../usr/portage/profiles/</i><selected profile><i> /etc/portage/make.profile</i> |
| 368 | </pre> |
368 | </pre> |
| 369 | |
369 | |
| 370 | <p> |
370 | <p> |
| 371 | <b>All archs</b> - There are no fundamental changes in this profile. No |
371 | <b>All archs</b> - There are no fundamental changes in this profile. No |
| 372 | specific action needs to be performed. |
372 | specific action needs to be performed. |
| … | |
… | |
| 516 | <ti></ti> |
516 | <ti></ti> |
| 517 | </tr> |
517 | </tr> |
| 518 | </table> |
518 | </table> |
| 519 | |
519 | |
| 520 | <p> |
520 | <p> |
| 521 | To switch to the selected profile, point the <path>/etc/make.profile</path> |
521 | To switch to the selected profile, point the <path>/etc/portage/make.profile</path> |
| 522 | symlink to the new location. Make sure your Portage is updated before you change |
522 | symlink to the new location. Make sure your Portage is updated before you change |
| 523 | your profile! |
523 | your profile! |
| 524 | </p> |
524 | </p> |
| 525 | |
525 | |
| 526 | <pre caption="Changing to a 2005.0 profile"> |
526 | <pre caption="Changing to a 2005.0 profile"> |
| 527 | # <i>rm /etc/make.profile</i> |
527 | # <i>rm /etc/portage/make.profile</i> |
| 528 | # <i>ln -s ../usr/portage/profiles/</i><selected profile><i> /etc/make.profile</i> |
528 | # <i>ln -s ../usr/portage/profiles/</i><selected profile><i> /etc/portage/make.profile</i> |
| 529 | </pre> |
529 | </pre> |
| 530 | |
530 | |
| 531 | <p> |
531 | <p> |
| 532 | If you are running a Linux 2.4-based system but want to migrate to a 2.6-based |
532 | If you are running a Linux 2.4-based system but want to migrate to a 2.6-based |
| 533 | kernel, make sure you read our <uri link="/doc/en/migration-to-2.6.xml">Gentoo |
533 | kernel, make sure you read our <uri link="/doc/en/migration-to-2.6.xml">Gentoo |
| … | |
… | |
| 550 | <path>/usr/portage/profiles/default-linux/x86/2004.3</path> (supported by |
550 | <path>/usr/portage/profiles/default-linux/x86/2004.3</path> (supported by |
| 551 | Portage 2.0.51 or later). |
551 | Portage 2.0.51 or later). |
| 552 | </p> |
552 | </p> |
| 553 | |
553 | |
| 554 | <p> |
554 | <p> |
| 555 | To switch to the 2004.3 profile, point the <path>/etc/make.profile</path> |
555 | To switch to the 2004.3 profile, point the <path>/etc/portage/make.profile</path> |
| 556 | symlink to the new location: |
556 | symlink to the new location: |
| 557 | </p> |
557 | </p> |
| 558 | |
558 | |
| 559 | <warn> |
559 | <warn> |
| 560 | Don't forget to upgrade Portage <e>before</e> you change your profile!!! |
560 | Don't forget to upgrade Portage <e>before</e> you change your profile!!! |
| 561 | </warn> |
561 | </warn> |
| 562 | |
562 | |
| 563 | <pre caption="Updating the /etc/make.profile symlink"> |
563 | <pre caption="Updating the /etc/portage/make.profile symlink"> |
| 564 | <comment>substitute <arch> with your arch</comment> |
564 | <comment>substitute <arch> with your arch</comment> |
| 565 | # <i>rm /etc/make.profile</i> |
565 | # <i>rm /etc/portage/make.profile</i> |
| 566 | # <i>ln -s ../usr/portage/profiles/default-linux/<arch>/2004.3 /etc/make.profile</i> |
566 | # <i>ln -s ../usr/portage/profiles/default-linux/<arch>/2004.3 /etc/portage/make.profile</i> |
| 567 | </pre> |
567 | </pre> |
| 568 | |
568 | |
| 569 | <p> |
569 | <p> |
| 570 | <b>All archs</b> - As said above, there are no big changes introduced in this |
570 | <b>All archs</b> - As said above, there are no big changes introduced in this |
| 571 | profile. However, it should be noted that <c>sys-apps/slocate</c> and |
571 | profile. However, it should be noted that <c>sys-apps/slocate</c> and |
| … | |
… | |
| 602 | they can continue with the upgrade procedure set forth in this guide. Please |
602 | they can continue with the upgrade procedure set forth in this guide. Please |
| 603 | substitute <c><arch></c> with your respective architecture: |
603 | substitute <c><arch></c> with your respective architecture: |
| 604 | </p> |
604 | </p> |
| 605 | |
605 | |
| 606 | <pre caption="Updating Portage through the obsolete profile"> |
606 | <pre caption="Updating Portage through the obsolete profile"> |
| 607 | # <i>rm /etc/make.profile</i> |
607 | # <i>rm /etc/portage/make.profile</i> |
| 608 | # <i>cd /etc</i> |
608 | # <i>cd /etc/portage</i> |
| 609 | # <i>ln -sf ../usr/portage/profiles/obsolete/<arch> make.profile</i> |
609 | # <i>ln -sf ../usr/portage/profiles/obsolete/<arch> make.profile</i> |
| 610 | # <i>emerge -n '>=sys-apps/portage-2.0.51'</i> |
610 | # <i>emerge -n '>=sys-apps/portage-2.0.51'</i> |
| 611 | </pre> |
611 | </pre> |
| 612 | |
612 | |
| 613 | </body> |
613 | </body> |
| … | |
… | |
| 615 | <section> |
615 | <section> |
| 616 | <title>Updating to 2004.2</title> |
616 | <title>Updating to 2004.2</title> |
| 617 | <body> |
617 | <body> |
| 618 | |
618 | |
| 619 | <p> |
619 | <p> |
| 620 | To switch to the 2004.2 profile, point the <path>/etc/make.profile</path> |
620 | To switch to the 2004.2 profile, point the <path>/etc/portage/make.profile</path> |
| 621 | symlink to the new location: |
621 | symlink to the new location: |
| 622 | </p> |
622 | </p> |
| 623 | |
623 | |
| 624 | <warn> |
624 | <warn> |
| 625 | Don't forget to upgrade Portage <e>before</e> you change your profile!!! |
625 | Don't forget to upgrade Portage <e>before</e> you change your profile!!! |
| 626 | </warn> |
626 | </warn> |
| 627 | |
627 | |
| 628 | <pre caption="Updating the /etc/make.profile symlink"> |
628 | <pre caption="Updating the /etc/portage/make.profile symlink"> |
| 629 | <comment>substitute <arch> with your arch</comment> |
629 | <comment>substitute <arch> with your arch</comment> |
| 630 | # <i>rm /etc/make.profile</i> |
630 | # <i>rm /etc/portage/make.profile</i> |
| 631 | # <i>ln -s ../usr/portage/profiles/default-linux/<arch>/2004.2 /etc/make.profile</i> |
631 | # <i>ln -s ../usr/portage/profiles/default-linux/<arch>/2004.2 /etc/portage/make.profile</i> |
| 632 | </pre> |
632 | </pre> |
| 633 | |
633 | |
| 634 | <p> |
634 | <p> |
| 635 | <b>x86</b> - This profile changes the default X11 implementation from |
635 | <b>x86</b> - This profile changes the default X11 implementation from |
| 636 | <c>x11-base/xfree</c> to <c>x11-base/xorg-x11</c>. This change only touches |
636 | <c>x11-base/xfree</c> to <c>x11-base/xorg-x11</c>. This change only touches |
| … | |
… | |
| 650 | <section> |
650 | <section> |
| 651 | <title>Updating to 2004.0</title> |
651 | <title>Updating to 2004.0</title> |
| 652 | <body> |
652 | <body> |
| 653 | |
653 | |
| 654 | <p> |
654 | <p> |
| 655 | To switch to the 2004.0 profile, point the <path>/etc/make.profile</path> |
655 | To switch to the 2004.0 profile, point the <path>/etc/portage/make.profile</path> |
| 656 | symlink to the new location: |
656 | symlink to the new location: |
| 657 | </p> |
657 | </p> |
| 658 | |
658 | |
| 659 | <pre caption="Updating the /etc/make.profile symlink"> |
659 | <pre caption="Updating the /etc/portage/make.profile symlink"> |
| 660 | <comment>substitute <arch> with your arch</comment> |
660 | <comment>substitute <arch> with your arch</comment> |
| 661 | # <i>rm /etc/make.profile</i> |
661 | # <i>rm /etc/portage/make.profile</i> |
| 662 | # <i>ln -s ../usr/portage/profiles/default-<arch>-2004.0 /etc/make.profile</i> |
662 | # <i>ln -s ../usr/portage/profiles/default-<arch>-2004.0 /etc/portage/make.profile</i> |
| 663 | </pre> |
663 | </pre> |
| 664 | |
664 | |
| 665 | <p> |
665 | <p> |
| 666 | <b>All archs</b> - There are no fundamental changes from previous profiles, no |
666 | <b>All archs</b> - There are no fundamental changes from previous profiles, no |
| 667 | specific action needs to be performed. |
667 | specific action needs to be performed. |
Parent Directory
| 
Revision Log
| 
Patch