/[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.10 Revision 1.17
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.10 2005/01/16 15:56:35 swift Exp $ --> 4<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/migration-to-2.6.xml,v 1.17 2005/08/25 00:52:49 vapier 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
18</author> 18</author>
19<author title="Editor"> 19<author title="Editor">
20 <mail link="neysx@gentoo.org">Xavier Neys</mail> 20 <mail link="neysx@gentoo.org">Xavier Neys</mail>
21</author> 21</author>
22<author title="Editor"> 22<author title="Editor">
23 <mail link="bennyc@gentoo.org">Benny Chuang</mail> 23 <mail link="bennyc@gentoo.org">Benny Chuang</mail>
24</author> 24</author>
25 25
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.1</version> 31<version>0.2.7</version>
32<date>2005-01-11</date> 32<date>2005-08-24</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
106applications to communicate with hardware (through the kernel). 83applications to communicate with hardware (through the kernel).
107</p> 84</p>
108 85
109<p> 86<p>
110<e>devfs</e>, whilst a good concept, has some internal problems, and has been 87<e>devfs</e>, whilst a good concept, has some internal problems, and has been
111marked obselete in Linux 2.6. 88marked obsolete in Linux 2.6.
112</p> 89</p>
113 90
114<p> 91<p>
115<e>udev</e> is the new way of managing device nodes. It addresses issues with 92<e>udev</e> is the new way of managing device nodes. It addresses issues with
116previous device managers, and also attempts to solve some other problems. 93previous device managers, and also attempts to solve some other problems.
212 to manual configuration) 189 to manual configuration)
213</li> 190</li>
214</ul> 191</ul>
215 192
216<pre caption="Updating all world packages"> 193<pre caption="Updating all world packages">
217# <i>emerge sync</i> 194# <i>emerge --sync</i>
218# <i>emerge -ua world</i> 195# <i>emerge -ua world</i>
219</pre> 196</pre>
220 197
221</body> 198</body>
222</section> 199</section>
237<p> 214<p>
238You should now remove modutils and install module-init-tools: 215You should now remove modutils and install module-init-tools:
239</p> 216</p>
240 217
241<pre caption="Switching from modutils to module-init-tools"> 218<pre caption="Switching from modutils to module-init-tools">
242# <i>emerge unmerge sys-apps/modutils</i> 219# <i>emerge --unmerge sys-apps/modutils</i>
243# <i>emerge module-init-tools</i> 220# <i>emerge module-init-tools</i>
244</pre> 221</pre>
245 222
246<note> 223<note>
247Don't worry - even though you have just unmerged modutils, module-init-tools 224Don't worry - even though you have just unmerged modutils, module-init-tools
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="/doc/en/gentoo-upgrading.xml">Gentoo Upgrading Document</uri> to
367switch to a 2.6-based profile, and retry installing 2.6 kernel sources.
368</p>
383 369
384</body> 370</body>
385</section> 371</section>
386<section> 372<section>
387<title>Updating the /usr/src/linux symbolic link</title> 373<title>Updating the /usr/src/linux symbolic link</title>
398just installed. Continuing our example: 384just installed. Continuing our example:
399</p> 385</p>
400 386
401<pre caption="Updating the /usr/src/linux softlink"> 387<pre caption="Updating the /usr/src/linux softlink">
402# <i>cd /usr/src</i> 388# <i>cd /usr/src</i>
403# <i>ln -sfn linux-2.6.9-gentoo-r2 linux</i> 389# <i>ln -sfn linux-2.6.10-gentoo-r4 linux</i>
404</pre> 390</pre>
405 391
406</body> 392</body>
407</section> 393</section>
408</chapter> 394</chapter>
604 Option "Protocol" "auto" 590 Option "Protocol" "auto"
605 Option "Device" "/dev/input/mice" 591 Option "Device" "/dev/input/mice"
606EndSection 592EndSection
607</pre> 593</pre>
608 594
595<note>
596If you are using a serial mouse, the new device path will be
597<path>/dev/tts/0</path> instead of <path>/dev/ttyS0</path>.
598</note>
599
609</body> 600</body>
610</section> 601</section>
611<section> 602<section>
612<title>New Serial-ATA (SATA) drivers name the devices differently</title> 603<title>New Serial-ATA (SATA) drivers name the devices differently</title>
613<body> 604<body>
645 636
646<p> 637<p>
647The developer of bootsplash appears to have lost interest in his project, given 638The developer of bootsplash appears to have lost interest in his project, given
648some design problems. However, Gentoo developer <e>Michal Januszewski</e> is 639some design problems. However, Gentoo developer <e>Michal Januszewski</e> is
649developing a successor, <c>gensplash</c>, which in included in the 640developing a successor, <c>gensplash</c>, which in included in the
650gentoo-dev-sources kernel. You can follow Michals 641gentoo-sources-2.6 kernel. You can follow Michal's
651<uri link="http://dev.gentoo.org/~spock/projects/gensplash/archive/gensplash-in-5-easy-steps.txt"> 642<uri link="http://dev.gentoo.org/~spock/projects/gensplash/archive/gensplash-in-5-easy-steps.txt">
652Gensplash in 5 easy steps</uri> document in order to familiarize yourself with 643Gensplash in 5 easy steps</uri> document in order to familiarize yourself with
653how gensplash is operated. 644how gensplash is operated.
654</p> 645</p>
655 646
740 731
741<comment>(the following are required for udev):</comment> 732<comment>(the following are required for udev):</comment>
742General setup ---&gt; 733General setup ---&gt;
743 [*] Support for hot-pluggable devices 734 [*] Support for hot-pluggable devices
744 735
745Device Drivers ---&gt;
746 Block devices ---&gt;
747 &lt;*&gt; RAM disk support
748
749<comment>(the following are required for ALSA):</comment> 736<comment>(the following are required for ALSA):</comment>
750Device Drivers ---&gt; 737Device Drivers ---&gt;
751 Sound ---&gt; 738 Sound ---&gt;
752 &lt;*&gt; Sound card support 739 &lt;*&gt; Sound card support
753 Advanced Linux Sound Architecture ---&gt; 740 Advanced Linux Sound Architecture ---&gt;
815kernel image over. You must then update your bootloader config manually. 802kernel image over. You must then update your bootloader config manually.
816</p> 803</p>
817 804
818<pre caption="Installing the kernel"> 805<pre caption="Installing the kernel">
819# <i>mount /boot</i> 806# <i>mount /boot</i>
820# <i>cp arch/i386/boot/bzImage /boot/bzImage-2.6.9-gentoo-r2</i> 807# <i>cp arch/i386/boot/bzImage /boot/bzImage-2.6.10-gentoo-r4</i>
821# <i>cp System.map /boot/System.map-2.6.9-gentoo-r2</i> 808# <i>cp System.map /boot/System.map-2.6.10-gentoo-r4</i>
822</pre> 809</pre>
823 810
824<p> 811<p>
825Note that the above instructions are examples only, you should follow your 812Note that the above instructions are examples only, you should follow your
826usual procedure of updating kernels by following the instructions in the <uri 813usual procedure of updating kernels by following the instructions in the <uri
885</p> 872</p>
886 873
887<pre caption="Sample GRUB config for genkernel + udev"> 874<pre caption="Sample GRUB config for genkernel + udev">
888title=Gentoo Linux (2.6 kernel) 875title=Gentoo Linux (2.6 kernel)
889root (hd0,0) 876root (hd0,0)
890kernel /kernel-2.6.9-gentoo-r2 <i>udev</i> root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3 877kernel /kernel-2.6.10-gentoo-r4 <i>udev</i> root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3
891initrd /initrd-2.6.9-gentoo-r2 878initrd /initrd-2.6.10-gentoo-r4
892</pre> 879</pre>
893 880
894</body> 881</body>
895</section> 882</section>
896</chapter> 883</chapter>
974Fortunately, upgrading from the LVM1 user tools to the LVM2 versions is very 961Fortunately, upgrading from the LVM1 user tools to the LVM2 versions is very
975simple: 962simple:
976</p> 963</p>
977 964
978<pre caption="Upgrading user-tools from LVM1 to LVM2"> 965<pre caption="Upgrading user-tools from LVM1 to LVM2">
979# <i>emerge unmerge lvm-user</i> 966# <i>emerge --unmerge lvm-user</i>
980# <i>emerge lvm2</i> 967# <i>emerge lvm2</i>
981</pre> 968</pre>
982 969
983<note> 970<note>
984The LVM2 tools are fully backwards-compatible with LVM1. Your disk data will 971The LVM2 tools are fully backwards-compatible with LVM1. Your disk data will
1080By now you are running Linux 2.6 and hopefully have all issues ironed out. You 1067By now you are running Linux 2.6 and hopefully have all issues ironed out. You
1081should now update your Linux kernel header files and re-merge glibc so that 1068should now update your Linux kernel header files and re-merge glibc so that
1082userspace applications can take advantage of new Linux 2.6 features. 1069userspace applications can take advantage of new Linux 2.6 features.
1083</p> 1070</p>
1084 1071
1085<pre caption="Updating to linux26-headers"> 1072<pre caption="Updating to linux-headers">
1086# <i>emerge unmerge linux-headers</i>
1087# <i>emerge linux26-headers</i> 1073# <i>emerge -u linux-headers</i>
1088</pre> 1074</pre>
1089 1075
1090<p> 1076<p>
1091After updating your headers package, you should generally re-merge glibc. 1077After updating your headers package, you should generally re-merge glibc.
1092There is a new feature here that you may be interested in - NPTL. NPTL is a new 1078There is a new feature here that you may be interested in - NPTL. NPTL is a new
1095you may wish to enable it during this migration process! To enable NPTL, edit 1081you may wish to enable it during this migration process! To enable NPTL, edit
1096<path>/etc/make.conf</path>, adding <e>nptl</e> to your USE variable. 1082<path>/etc/make.conf</path>, adding <e>nptl</e> to your USE variable.
1097</p> 1083</p>
1098 1084
1099<warn> 1085<warn>
1100With the current stable glibc ebuilds, you will be unable to boot a 2.4 kernel 1086If you choose to also enable the "nptlonly" flag, be aware that you will no
1101after compiling glibc with USE="nptl". Be warned, be careful! 1087longer be able to boot a 2.4 kernel.
1102</warn> 1088</warn>
1103 1089
1104<p> 1090<p>
1105Now re-merge glibc (you should do this even if you did not choose to enable 1091Now re-merge glibc (you should do this even if you did not choose to enable
1106NPTL). 1092NPTL).
1154<title>Conclusion</title> 1140<title>Conclusion</title>
1155<body> 1141<body>
1156 1142
1157<p> 1143<p>
1158Hopefully you have just completed a smooth migration and you are enjoying the 1144Hopefully you have just completed a smooth migration and you are enjoying the
1159benefits which Linux 2.6 brings over 2.4. As I mentioned at the start, we are 1145benefits which Linux 2.6 brings over 2.4.
1160looking for feedback on this document - even if your migration went perfectly 1146</p>
1161smoothly. Please <mail link="dsd@gentoo.org">mail me</mail> your feedback so 1147
1162that we can get this document in perfect shape for when 2005.0 comes around. 1148<p>
1163Thanks! 1149I would like to say a word of thanks to the many users who effectively
1150'tested' this document while it was in its early stages, and provided feedback
1151about how the migration process went. Sorry that I did not reply to all the
1152emails (there were a lot!), but I did read every one, and refined this
1153document where appropriate. Enjoy your 2.6-enhanced systems :)
1164</p> 1154</p>
1165 1155
1166</body> 1156</body>
1167</section> 1157</section>
1168<section> 1158<section>
1182gentoo-sources installed, you could use the following command to remove them 1172gentoo-sources installed, you could use the following command to remove them
1183while keeping the 2.6 versions intact: 1173while keeping the 2.6 versions intact:
1184</p> 1174</p>
1185 1175
1186<pre caption="Example: Removing Linux 2.4 sources"> 1176<pre caption="Example: Removing Linux 2.4 sources">
1187# <i>emerge unmerge =vanilla-sources-2.4.* =gentoo-sources-2.4.*</i> 1177# <i>emerge --unmerge =vanilla-sources-2.4.* =gentoo-sources-2.4.*</i>
1188</pre> 1178</pre>
1189 1179
1190<p> 1180<p>
1191Portage will not completely clean out your 2.4 kernel source installations, 1181Portage will not completely clean out your 2.4 kernel source installations,
1192because some temporary files are created during compilation. It is safe to 1182because some temporary files are created during compilation. It is safe to
1233The devfs management daemon, <c>devfsd</c>, can also safely be removed, now 1223The devfs management daemon, <c>devfsd</c>, can also safely be removed, now
1234that we are using <c>udev</c> for device management. 1224that we are using <c>udev</c> for device management.
1235</p> 1225</p>
1236 1226
1237<pre caption="Removing alsa-driver, i2c, and devfsd"> 1227<pre caption="Removing alsa-driver, i2c, and devfsd">
1238# <i>emerge unmerge alsa-driver i2c devfsd</i> 1228# <i>emerge --unmerge alsa-driver i2c devfsd</i>
1239</pre> 1229</pre>
1240 1230
1241<p> 1231<p>
1242If you are LVM2 user, you may wish to convert your data into the LVM2 data 1232If you are LVM2 user, you may wish to convert your data into the LVM2 data
1243format in order to benefit from the advantages which LVM2 provides. 1233format in order to benefit from the advantages which LVM2 provides.

Legend:
Removed from v.1.10  
changed lines
  Added in v.1.17

  ViewVC Help
Powered by ViewVC 1.1.20