/[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.42 Revision 1.43
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>
101mapping for virtual packages, and the architecture on which the system is running. 101mapping for virtual packages, and the architecture on which the system is running.
102</p> 102</p>
103 103
104<p> 104<p>
105The profile in use is determined by the symbolic link 105The 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
108instance, the default x86 2008.0 profile can be found 108instance, the default x86 2008.0 profile can be found
109at <path>/usr/portage/profiles/default/linux/x86/2008.0</path>. 109at <path>/usr/portage/profiles/default/linux/x86/2008.0</path>.
110The files in the parent directories are part of the profile as well (and 110The files in the parent directories are part of the profile as well (and
111are therefore shared by different subprofiles). This is why we call these 111are therefore shared by different subprofiles). This is why we call these
181to release; it depends on how deep the modifications introduced in the new 181to release; it depends on how deep the modifications introduced in the new
182profile are. 182profile are.
183</p> 183</p>
184 184
185<p> 185<p>
186In the simplest case you only have to change the <path>/etc/make.profile</path> 186In the simplest case you only have to change the <path>/etc/portage/make.profile</path>
187symlink, in the worst case you may have to recompile your system from scratch 187symlink, in the worst case you may have to recompile your system from scratch
188while doing a neat voodoo dance. Migration is usually covered in the release 188while doing a neat voodoo dance. Migration is usually covered in the release
189notes. You can also find <uri link="#instructions">instructions</uri> at the 189notes. You can also find <uri link="#instructions">instructions</uri> at the
190end of this guide. 190end of this guide.
191</p> 191</p>
237<p> 237<p>
238If you'd still prefer to change profiles manually, then simply do the following: 238If 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>&lt;selected profile&gt;<i> /etc/make.profile</i> 243# <i>ln -s ../usr/portage/profiles/</i>&lt;selected profile&gt;<i> /etc/portage/make.profile</i>
244</pre> 244</pre>
245 245
246<note> 246<note>
247There are <b>desktop</b> and <b>server</b> subprofiles for most architectures. 247There are <b>desktop</b> and <b>server</b> subprofiles for most architectures.
248Examine these profiles carefully, as they may serve your needs better than the 248Examine these profiles carefully, as they may serve your needs better than the
273Alternatively, if you do not wish to set a locale, you should specify 273Alternatively, if you do not wish to set a locale, you should specify
274UNICODE="no" in <path>/etc/rc.conf</path>, and re-emerge <c>baselayout</c> (or 274UNICODE="no" in <path>/etc/rc.conf</path>, and re-emerge <c>baselayout</c> (or
275wait until your next <c>baselayout</c> update) with the <c>-unicode</c> USE 275wait until your next <c>baselayout</c> update) with the <c>-unicode</c> USE
276flag. You can set <c>-unicode</c> just for <c>baselayout</c>, or you can set it 276flag. You can set <c>-unicode</c> just for <c>baselayout</c>, or you can set it
277globally for all packages by adding it to your USE variable in 277globally 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>
288USE="-unicode" 288USE="-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>
310To switch to the 2006.0 profile, point the <path>/etc/make.profile</path> 310To switch to the 2006.0 profile, point the <path>/etc/portage/make.profile</path>
311symlink to the new location. Make sure your Portage is updated before you 311symlink to the new location. Make sure your Portage is updated before you
312change your profile. 312change 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>&lt;selected profile&gt;<i> /etc/make.profile</i> 317# <i>ln -s ../usr/portage/profiles/</i>&lt;selected profile&gt;<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
322the default-linux/alpha/no-nptl profile. More information is available in <uri 322the 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>
360To switch to the 2005.1 profile, point the <path>/etc/make.profile</path> 360To switch to the 2005.1 profile, point the <path>/etc/portage/make.profile</path>
361symlink to the new location. Make sure your Portage is updated before you 361symlink to the new location. Make sure your Portage is updated before you
362change your profile. 362change 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>&lt;selected profile&gt;<i> /etc/make.profile</i> 367# <i>ln -s ../usr/portage/profiles/</i>&lt;selected profile&gt;<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
372specific action needs to be performed. 372specific 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>
521To switch to the selected profile, point the <path>/etc/make.profile</path> 521To switch to the selected profile, point the <path>/etc/portage/make.profile</path>
522symlink to the new location. Make sure your Portage is updated before you change 522symlink to the new location. Make sure your Portage is updated before you change
523your profile! 523your 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>&lt;selected profile&gt;<i> /etc/make.profile</i> 528# <i>ln -s ../usr/portage/profiles/</i>&lt;selected profile&gt;<i> /etc/portage/make.profile</i>
529</pre> 529</pre>
530 530
531<p> 531<p>
532If you are running a Linux 2.4-based system but want to migrate to a 2.6-based 532If you are running a Linux 2.4-based system but want to migrate to a 2.6-based
533kernel, make sure you read our <uri link="/doc/en/migration-to-2.6.xml">Gentoo 533kernel, 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
551Portage 2.0.51 or later). 551Portage 2.0.51 or later).
552</p> 552</p>
553 553
554<p> 554<p>
555To switch to the 2004.3 profile, point the <path>/etc/make.profile</path> 555To switch to the 2004.3 profile, point the <path>/etc/portage/make.profile</path>
556symlink to the new location: 556symlink to the new location:
557</p> 557</p>
558 558
559<warn> 559<warn>
560Don't forget to upgrade Portage <e>before</e> you change your profile!!! 560Don'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 &lt;arch&gt; with your arch</comment> 564<comment>substitute &lt;arch&gt; 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/&lt;arch&gt;/2004.3 /etc/make.profile</i> 566# <i>ln -s ../usr/portage/profiles/default-linux/&lt;arch&gt;/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
571profile. However, it should be noted that <c>sys-apps/slocate</c> and 571profile. However, it should be noted that <c>sys-apps/slocate</c> and
602they can continue with the upgrade procedure set forth in this guide. Please 602they can continue with the upgrade procedure set forth in this guide. Please
603substitute <c>&lt;arch&gt;</c> with your respective architecture: 603substitute <c>&lt;arch&gt;</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/&lt;arch&gt; make.profile</i> 609# <i>ln -sf ../usr/portage/profiles/obsolete/&lt;arch&gt; 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>
620To switch to the 2004.2 profile, point the <path>/etc/make.profile</path> 620To switch to the 2004.2 profile, point the <path>/etc/portage/make.profile</path>
621symlink to the new location: 621symlink to the new location:
622</p> 622</p>
623 623
624<warn> 624<warn>
625Don't forget to upgrade Portage <e>before</e> you change your profile!!! 625Don'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 &lt;arch&gt; with your arch</comment> 629<comment>substitute &lt;arch&gt; 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/&lt;arch&gt;/2004.2 /etc/make.profile</i> 631# <i>ln -s ../usr/portage/profiles/default-linux/&lt;arch&gt;/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>
655To switch to the 2004.0 profile, point the <path>/etc/make.profile</path> 655To switch to the 2004.0 profile, point the <path>/etc/portage/make.profile</path>
656symlink to the new location: 656symlink 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 &lt;arch&gt; with your arch</comment> 660<comment>substitute &lt;arch&gt; 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-&lt;arch&gt;-2004.0 /etc/make.profile</i> 662# <i>ln -s ../usr/portage/profiles/default-&lt;arch&gt;-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
667specific action needs to be performed. 667specific action needs to be performed.

Legend:
Removed from v.1.42  
changed lines
  Added in v.1.43

  ViewVC Help
Powered by ViewVC 1.1.20