/[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.36 Revision 1.37
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>
16This document explains how new Gentoo releases affect existing installs. 19This 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>
102The profile in use is determined by the symbolic link 105The 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
105instance, the default x86 2006.1 profile can be found 108instance, the default x86 2007.0 profile can be found
106at <path>/usr/portage/profiles/default-linux/x86/2006.1</path>. 109at <path>/usr/portage/profiles/default-linux/x86/2007.0</path>.
107The 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
108are therefore shared by different subprofiles). This is why we call these 111are 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>
158If a release (such as 2006.1 for x86) introduces a new profile, you have the 161If a release (such as 2007.0 for x86) introduces a new profile, you have the
159choice to migrate to the new profile. 162choice to migrate to the new profile.
160</p> 163</p>
161 164
162<p> 165<p>
163Naturally, you are not forced to do so, and you can continue to use the old 166Naturally, 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>
198The following profiles are officially supported by Gentoo developers: 201You can view the list of profiles on your architecture officially supported by
202Gentoo developers when you <c>emerge eselect</c> and then run the following
203command:
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>
221Make sure your Portage is updated before performing any profile changes.
222</impo>
223
224<p>
225First, run <c>emerge eselect</c>. The <c>eselect</c> utility will let you view
226and select profiles easily, without needing to create or remove symlinks by
227hand.
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 &lt;number&gt;</i>
236</pre>
237
238<p>
239If 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>&lt;selected profile&gt;<i> /etc/make.profile</i>
245</pre>
246
247<note>
248There are <b>desktop</b> and <b>server</b> subprofiles for most architectures.
249Examine these profiles carefully, as they may serve your needs better than the
250extremely 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>
326If you intend to upgrade to this profile, you should be aware that it expects 260If you intend to upgrade to these profiles, you should be aware that they expect
327the system to be set to a Unicode locale by default; specifically that 261the system to be set to a Unicode locale by default; specifically that
328UNICODE="yes" is set in <path>/etc/rc.conf</path>. For this to work, you must 262UNICODE="yes" is set in <path>/etc/rc.conf</path>. For this to work, you must
329have created a Unicode locale for your system to use. Please read our <uri 263have created a Unicode locale for your system to use. Please read our <uri
330link="/doc/en/utf-8.xml">UTF-8 guide</uri> to learn how to create the proper 264link="/doc/en/utf-8.xml">UTF-8 guide</uri> to learn how to create the proper
331locale. 265locale.
349# <i>nano -w /etc/make.conf</i> 283# <i>nano -w /etc/make.conf</i>
350USE="-unicode" 284USE="-unicode"
351# <i>emerge -a baselayout</i> 285# <i>emerge -a baselayout</i>
352</pre> 286</pre>
353 287
354<p> 288<note>
355To switch to the 2006.1 profile, point the <path>/etc/make.profile</path> 289If you are updating to a 2007.0 profile on the Sparc architecture, then you will
356symlink to the new location. Make sure your Portage is updated before you 290need to follow the <uri link="/doc/en/gcc-upgrading.xml">GCC Upgrading
357change your profile. 291Guide</uri>, as <c>gcc-4</c> is the default compiler.
292</note>
293
358</p> 294<p>
359 295Finally, follow the <uri link="#general">general instructions</uri> for updating
360<pre caption="Changing to a 2006.1 profile"> 296your profile.
361# <i>rm /etc/make.profile</i>
362# <i>ln -s ../usr/portage/profiles/</i>&lt;selected profile&gt;<i> /etc/make.profile</i>
363</pre>
364
365<p>
366Please 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>
368sub-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>

Legend:
Removed from v.1.36  
changed lines
  Added in v.1.37

  ViewVC Help
Powered by ViewVC 1.1.20