/[gentoo]/xml/htdocs/doc/en/migration-to-2.6.xml
Gentoo

Diff of /xml/htdocs/doc/en/migration-to-2.6.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.12 Revision 1.13
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 3
4<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/migration-to-2.6.xml,v 1.12 2005/02/07 19:23:22 swift Exp $ --> 4<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/migration-to-2.6.xml,v 1.13 2005/04/02 08:44:44 swift Exp $ -->
5 5
6<guide link="/doc/en/migration-to-2.6.xml"> 6<guide link="/doc/en/migration-to-2.6.xml">
7 7
8<title>The complete Gentoo Linux 2.6 migration guide</title> 8<title>The complete Gentoo Linux 2.6 migration guide</title>
9 9
26<abstract> 26<abstract>
27This document will aid you in the process of migrating from Linux 2.4 to Linux 27This document will aid you in the process of migrating from Linux 2.4 to Linux
282.6, devfs to udev, OSS to ALSA, and LVM to LVM2. 282.6, devfs to udev, OSS to ALSA, and LVM to LVM2.
29</abstract> 29</abstract>
30 30
31<version>0.2.3</version> 31<version>0.2.4</version>
32<date>2005-02-07</date> 32<date>2005-04-02</date>
33 33
34<chapter> 34<chapter>
35<title>Introduction</title> 35<title>Introduction</title>
36
37<section>
38<title>Status of this document</title>
39<body>
40
41<p>
42The migration processes described in this document are not minor changes. This
43document is in early stages and may be missing some details but hopefully the
44main things have been covered. If you do try a migration, please <uri
45link="http://bugs.gentoo.org">report</uri> any problem you might encounter so
46that we can refine this guide.
47</p>
48
49<p>
50We are planning on making Linux 2.6 the default kernel for when 2005.0 is
51released (for some arch's). At the same time, we will encourage all existing
52users of those arch's to upgrade to Linux 2.6, as many will still be running
532.4. Your feedback on this document is much appreciated, so that when this
54time comes, the document can be in good shape for the mass-migration.
55</p>
56
57</body>
58</section>
59 36
60<section> 37<section>
61<title>Whats new in Linux 2.6?</title> 38<title>Whats new in Linux 2.6?</title>
62<body> 39<body>
63 40
359<body> 336<body>
360 337
361<p> 338<p>
362The first thing you need to do is install sources of a 2.6 kernel of your 339The first thing you need to do is install sources of a 2.6 kernel of your
363choice. The two Gentoo-supported 2.6 kernels are currently 340choice. The two Gentoo-supported 2.6 kernels are currently
364<e>gentoo-dev-sources</e> (for desktops) and <e>hardened-dev-sources</e> (for 341<e>gentoo-sources</e> (for desktops) and <e>hardened-dev-sources</e> (for
365servers). There are others available, see the <uri 342servers). There are others available, see the <uri
366link="/doc/en/gentoo-kernel.xml">Gentoo Linux Kernel Guide</uri> for more 343link="/doc/en/gentoo-kernel.xml">Gentoo Linux Kernel Guide</uri> for more
367choices. 344choices.
368</p> 345</p>
369 346
370<p> 347<p>
371In this guide, we'll use <c>gentoo-dev-sources</c> as an example. Install your 348In this guide, we'll use <c>gentoo-sources</c> as an example. Install your
372chosen set of kernel sources using the <c>emerge</c> utility: 349chosen set of kernel sources using the <c>emerge</c> utility:
373</p> 350</p>
374 351
375<pre caption="Installing gentoo-dev-sources"> 352<pre caption="Installing gentoo-sources">
376# <i>emerge -a gentoo-dev-sources</i> 353# <i>emerge -a gentoo-sources</i>
377These are the packages that I would merge, in order: 354These are the packages that I would merge, in order:
378Calculating dependencies ...done! 355Calculating dependencies ...done!
379[ebuild N ] sys-kernel/gentoo-dev-sources-2.6.9-r2 356[ebuild NS ] sys-kernel/gentoo-sources-2.6.10-r4
380 357
381Do you want me to merge these packages? [Yes/No] <i>y</i> 358Do you want me to merge these packages? [Yes/No] <i>y</i>
382</pre> 359</pre>
360
361<p>
362When performing the above <c>emerge</c> command, if you find that it wants to
363install a 2.4 version of gentoo-sources (e.g. <c>gentoo-sources-2.4.26</c>),
364then it means that the profile you are using is not designed for Linux 2.6
365users. Please follow the
366<uri link="http://www.gentoo.org/proj/en/releng/release/2005.0/releng/profile-update.xml">
3672005.0 profile update document</uri> to switch to a 2.6-based profile, and
368retry installing 2.6 kernel sources.
369</p>
383 370
384</body> 371</body>
385</section> 372</section>
386<section> 373<section>
387<title>Updating the /usr/src/linux symbolic link</title> 374<title>Updating the /usr/src/linux symbolic link</title>
398just installed. Continuing our example: 385just installed. Continuing our example:
399</p> 386</p>
400 387
401<pre caption="Updating the /usr/src/linux softlink"> 388<pre caption="Updating the /usr/src/linux softlink">
402# <i>cd /usr/src</i> 389# <i>cd /usr/src</i>
403# <i>ln -sfn linux-2.6.9-gentoo-r2 linux</i> 390# <i>ln -sfn linux-2.6.10-gentoo-r4 linux</i>
404</pre> 391</pre>
405 392
406</body> 393</body>
407</section> 394</section>
408</chapter> 395</chapter>
650 637
651<p> 638<p>
652The developer of bootsplash appears to have lost interest in his project, given 639The developer of bootsplash appears to have lost interest in his project, given
653some design problems. However, Gentoo developer <e>Michal Januszewski</e> is 640some design problems. However, Gentoo developer <e>Michal Januszewski</e> is
654developing a successor, <c>gensplash</c>, which in included in the 641developing a successor, <c>gensplash</c>, which in included in the
655gentoo-dev-sources kernel. You can follow Michals 642gentoo-sources-2.6 kernel. You can follow Michal's
656<uri link="http://dev.gentoo.org/~spock/projects/gensplash/archive/gensplash-in-5-easy-steps.txt"> 643<uri link="http://dev.gentoo.org/~spock/projects/gensplash/archive/gensplash-in-5-easy-steps.txt">
657Gensplash in 5 easy steps</uri> document in order to familiarize yourself with 644Gensplash in 5 easy steps</uri> document in order to familiarize yourself with
658how gensplash is operated. 645how gensplash is operated.
659</p> 646</p>
660 647
820kernel image over. You must then update your bootloader config manually. 807kernel image over. You must then update your bootloader config manually.
821</p> 808</p>
822 809
823<pre caption="Installing the kernel"> 810<pre caption="Installing the kernel">
824# <i>mount /boot</i> 811# <i>mount /boot</i>
825# <i>cp arch/i386/boot/bzImage /boot/bzImage-2.6.9-gentoo-r2</i> 812# <i>cp arch/i386/boot/bzImage /boot/bzImage-2.6.10-gentoo-r4</i>
826# <i>cp System.map /boot/System.map-2.6.9-gentoo-r2</i> 813# <i>cp System.map /boot/System.map-2.6.10-gentoo-r4</i>
827</pre> 814</pre>
828 815
829<p> 816<p>
830Note that the above instructions are examples only, you should follow your 817Note that the above instructions are examples only, you should follow your
831usual procedure of updating kernels by following the instructions in the <uri 818usual procedure of updating kernels by following the instructions in the <uri
890</p> 877</p>
891 878
892<pre caption="Sample GRUB config for genkernel + udev"> 879<pre caption="Sample GRUB config for genkernel + udev">
893title=Gentoo Linux (2.6 kernel) 880title=Gentoo Linux (2.6 kernel)
894root (hd0,0) 881root (hd0,0)
895kernel /kernel-2.6.9-gentoo-r2 <i>udev</i> root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3 882kernel /kernel-2.6.10-gentoo-r4 <i>udev</i> root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3
896initrd /initrd-2.6.9-gentoo-r2 883initrd /initrd-2.6.10-gentoo-r4
897</pre> 884</pre>
898 885
899</body> 886</body>
900</section> 887</section>
901</chapter> 888</chapter>
1159<title>Conclusion</title> 1146<title>Conclusion</title>
1160<body> 1147<body>
1161 1148
1162<p> 1149<p>
1163Hopefully you have just completed a smooth migration and you are enjoying the 1150Hopefully you have just completed a smooth migration and you are enjoying the
1164benefits which Linux 2.6 brings over 2.4. As I mentioned at the start, we are 1151benefits which Linux 2.6 brings over 2.4.
1165looking for feedback on this document - even if your migration went perfectly 1152</p>
1166smoothly. Please <mail link="dsd@gentoo.org">mail me</mail> your feedback so 1153
1167that we can get this document in perfect shape for when 2005.0 comes around. 1154<p>
1168Thanks! 1155I would like to say a word of thanks to the many users who effectively
1156'tested' this document while it was in its early stages, and provided feedback
1157about how the migration process went. Sorry that I did not reply to all the
1158emails (there were a lot!), but I did read every one, and refined this
1159document where appropriate. Enjoy your 2.6-enhanced systems :)
1169</p> 1160</p>
1170 1161
1171</body> 1162</body>
1172</section> 1163</section>
1173<section> 1164<section>

Legend:
Removed from v.1.12  
changed lines
  Added in v.1.13

  ViewVC Help
Powered by ViewVC 1.1.20