/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml

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

Revision 1.9 Revision 1.29
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml,v 1.9 2007/07/27 18:38:09 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ia64-kernel.xml,v 1.29 2013/03/16 18:58:17 swift Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>8.2</version> 11<version>19</version>
12<date>2007-07-27</date> 12<date>2013-03-16</date>
13 13
14<section>
15<title>Timezone</title>
16<body>
17
18<p>
19You first need to select your timezone so that your system knows where it is
20located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then copy
21it to <path>/etc/localtime</path>. Please avoid the
22<path>/usr/share/zoneinfo/Etc/GMT*</path> timezones as their names do not
23indicate the expected zones. For instance, <path>GMT-8</path> is in fact
24GMT+8.
25</p>
26
27<pre caption="Setting the timezone information">
28# <i>ls /usr/share/zoneinfo</i>
29<comment>(Suppose you want to use GMT)</comment>
30# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
31</pre>
32
33</body>
34</section>
35<section> 14<section>
36<title>Installing the Sources</title> 15<title>Installing the Sources</title>
37<subsection> 16<subsection>
38<title>Choosing a Kernel</title> 17<title>Choosing a Kernel</title>
39<body> 18<body>
45available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel 24available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
46Guide</uri>. 25Guide</uri>.
47</p> 26</p>
48 27
49<p> 28<p>
50For IA64 systems, we will use <c>gentoo-sources</c> (contains additional patches 29For <keyval id="arch"/> systems, we will use <c>gentoo-sources</c> (contains
51for performance and stability). 30additional patches for extra features).
52</p> 31</p>
53 32
54<p> 33<p>
55Now install it using <c>emerge</c>. 34Now install it using <c>emerge</c>.
56</p> 35</p>
133<subsection> 112<subsection>
134<title>Activating Required Options</title> 113<title>Activating Required Options</title>
135<body> 114<body>
136 115
137<p> 116<p>
138First of all, activate the use of development and experimental code/drivers.
139You need this, otherwise some very important code/drivers won't show up:
140</p>
141
142<pre caption="Selecting experimental code/drivers, General setup">
143Code maturity level options ---&gt;
144 [*] Prompt for development and/or incomplete code/drivers
145General setup ---&gt;
146 [*] Support for hot-pluggable devices
147</pre>
148
149<p>
150Make sure that every driver that is vital to the booting of your system (such as 117Make sure that every driver that is vital to the booting of your system (such as
151SCSI controller, ...) is compiled <e>in</e> the kernel and not as a module, 118SCSI controller, ...) is compiled <e>in</e> the kernel and not as a module,
152otherwise your system will not be able to boot completely. 119otherwise your system will not be able to boot completely.
153</p> 120</p>
154 121
187 &lt;*&gt; JFS filesystem support 154 &lt;*&gt; JFS filesystem support
188 &lt;*&gt; Second extended fs support 155 &lt;*&gt; Second extended fs support
189 &lt;*&gt; XFS filesystem support 156 &lt;*&gt; XFS filesystem support
190 157
191<comment>(Be sure to enable VFAT support for the EFI partition)</comment> 158<comment>(Be sure to enable VFAT support for the EFI partition)</comment>
192DOS/FAT/NT Filesystems ---> 159 DOS/FAT/NT Filesystems ---&gt;
193 &lt;*&gt; VFAT (Windows-95) fs support 160 &lt;*&gt; VFAT (Windows-95) fs support
194</pre>
195 161
196<p> 162<comment>(Enable GPT partition label support if you used that previously</comment>
197Do not forget to enable DMA for your drives: 163-*- Enable the block layer --->
198</p> 164 ...
199 165 Partition Types --->
200<pre caption="Activating DMA"> 166 [*] Advanced partition selection
201Device Drivers ---&gt; 167 ...
202 ATA/ATAPI/MFM/RLL support ---&gt; 168 [*] EFI GUID Partition support
203 [*] Generic PCI bus-master DMA support
204</pre> 169</pre>
205 170
206<p> 171<p>
207If you are using PPPoE to connect to the Internet or you are using a dial-up 172If you are using PPPoE to connect to the Internet or you are using a dial-up
208modem, you will need the following options in the kernel: 173modem, you will need the following options in the kernel:
209</p> 174</p>
210 175
211<pre caption="Selecting PPPoE necessary drivers"> 176<pre caption="Selecting PPPoE necessary drivers">
212Device Drivers ---&gt; 177Device Drivers ---&gt;
213 Networking Support ---&gt; 178 Network device support ---&gt;
214 &lt;*&gt; PPP (point-to-point protocol) support 179 &lt;*&gt; PPP (point-to-point protocol) support
215 &lt;*&gt; PPP support for async serial ports 180 &lt;*&gt; PPP support for async serial ports
216 &lt;*&gt; PPP support for sync tty ports 181 &lt;*&gt; PPP support for sync tty ports
217</pre> 182</pre>
218 183
242those as well: 207those as well:
243</p> 208</p>
244 209
245<pre caption="Activating USB Support for Input Devices"> 210<pre caption="Activating USB Support for Input Devices">
246Device Drivers ---&gt; 211Device Drivers ---&gt;
247 USB Support ---&gt; 212 [*] HID Devices ---&gt;
248 &lt;*&gt; USB Human Interface Device (full HID) support 213 &lt;*&gt; USB Human Interface Device (full HID) support
249</pre> 214</pre>
250 215
251<p> 216<p>
252When you've finished configuring the kernel, continue with <uri 217When you've finished configuring the kernel, continue with <uri
267<pre caption="Compiling the kernel"> 232<pre caption="Compiling the kernel">
268# <i>make &amp;&amp; make modules_install</i> 233# <i>make &amp;&amp; make modules_install</i>
269</pre> 234</pre>
270 235
271<p> 236<p>
272When the kernel has finished compiling, copy the kernel image to 237When the kernel has finished compiling, copy the kernel image to <path>/</path>.
273<path>/boot</path>. Use whatever name you feel is appropriate for your kernel 238Use whatever name you feel is appropriate for your kernel choice and remember it
274choice and remember it as you will need it later on when you configure your 239as you will need it later on when you configure your bootloader. Remember to
275bootloader. Remember to replace <c><keyval id="kernel-name"/></c> with the 240replace <c>vmlinuz</c> with the name and version of your kernel.
276name and version of your kernel.
277</p> 241</p>
278 242
279<pre caption="Installing the kernel"> 243<pre caption="Installing the kernel">
280# <i>cp vmlinux.gz /boot/<keyval id="kernel-name"/></i> 244# <i>cp vmlinux.gz /boot/vmlinuz</i>
245</pre>
246
247</body>
248</subsection>
249<subsection id="initramfs">
250<title>(Optional) Building an Initramfs</title>
251<body>
252
253<p>
254If you use a specific partition layout where important file system locations
255(like <path>/usr</path> or <path>/var</path>) are on separate partitions, then
256you will need to setup an initramfs so that this partition can be mounted before
257it is needed.
258</p>
259
260<p>
261Without an initramfs, you risk that the system will not boot up properly as the
262tools that are responsible for mounting the file systems need information that
263resides on those file systems. An initramfs will pull in the necessary files
264into an archive which is used right after the kernel boots, but before the
265control is handed over to the <c>init</c> tool. Scripts on the initramfs will
266then make sure that the partitions are properly mounted before the system
267continues booting.
268</p>
269
270<p>
271To install an initramfs, install <c>genkernel</c> first, then have it
272generate an initramfs for you.
273</p>
274
275<pre caption="Building an initramfs">
276# <i>emerge genkernel</i>
277# <i>genkernel --bootdir=/. --no-mountboot --install initramfs</i>
278</pre>
279
280<p>
281If you need specific support in the initramfs, such as lvm or raid, add in the
282appropriate options to genkernel. See <c>genkernel --help</c> for more
283information, or the next example which enables support for LVM and software raid
284(mdadm):
285</p>
286
287<pre caption="Building an initramfs with support for LVM and software raid">
288# <i>genkernel --bootdir=/. --no-mountboot --lvm --mdadm --install initramfs</i>
289</pre>
290
291<p>
292The initramfs will be stored in <path>/</path>. You can find the file by simply
293listing the files starting with <path>initramfs</path>:
294</p>
295
296<pre caption="Checking the initramfs file name">
297# <i>ls /initramfs*</i>
281</pre> 298</pre>
282 299
283<p> 300<p>
284Now continue with <uri link="#kernel_modules">Kernel Modules</uri>. 301Now continue with <uri link="#kernel_modules">Kernel Modules</uri>.
285</p> 302</p>
314<pre caption="Emerging genkernel"> 331<pre caption="Emerging genkernel">
315# <i>emerge genkernel</i> 332# <i>emerge genkernel</i>
316</pre> 333</pre>
317 334
318<p> 335<p>
319Now, compile your kernel sources by running <c>genkernel --udev all</c>. 336Now, compile your kernel sources by running <c>genkernel</c>. Be aware
320Be aware though, as <c>genkernel</c> compiles a kernel that supports almost all 337though, as <c>genkernel</c> compiles a kernel that supports almost all hardware,
321hardware, this compilation will take quite a while to finish! 338this compilation will take quite a while to finish!
322</p> 339</p>
323 340
324<note> 341<note>
325Users of EVMS2 or LVM2 will probably want to add 342Users of LVM2 will probably want to add <c>--lvm2</c> to the genkernel
326<c>--evms2</c> or <c>--lvm2</c> to the genkernel command-line. 343command-line.
327</note> 344</note>
328 345
329<pre caption="Running genkernel"> 346<pre caption="Running genkernel">
330# <i>genkernel --udev all</i> 347# <i>genkernel --bootdir=/. --no-mountboot all</i>
331</pre> 348</pre>
332 349
333<p> 350<p>
334Once <c>genkernel</c> completes, a kernel, full set of modules and 351Once <c>genkernel</c> completes, a kernel, full set of modules and
335<e>initial root disk</e> (initrd) will be created. We will use the kernel 352<e>initial ram disk</e> (initramfs) will be created. We will use the kernel
336and initrd when configuring a boot loader later in this document. Write 353and initrd when configuring a boot loader later in this document. Write
337down the names of the kernel and initrd as you will need it when writing 354down the names of the kernel and initrd as you will need it when writing
338the bootloader configuration file. The initrd will be started immediately after 355the bootloader configuration file. The initrd will be started immediately after
339booting to perform hardware autodetection (just like on the Installation CD) 356booting to perform hardware autodetection (just like on the Installation CD)
340before your "real" system starts up. 357before your "real" system starts up.
341</p> 358</p>
342 359
343<pre caption="Checking the created kernel image name and initrd"> 360<pre caption="Checking the created kernel image name and initrd">
344# <i>ls /boot/kernel* /boot/initramfs*</i> 361# <i>ls /kernel* /initramfs*</i>
345</pre> 362</pre>
346 363
347</body> 364</body>
348</section> 365</section>
349<section id="kernel_modules"> 366<section id="kernel_modules">
350<title>Kernel Modules</title> 367<title>Kernel Modules</title>
368
351<subsection> 369<subsection>
352<title>Configuring the Modules</title> 370<include href="hb-install-kernelmodules.xml"/>
353<body>
354
355<p>
356You should list the modules you want automatically loaded in
357<path>/etc/modules.autoload.d/kernel-2.6</path>. You can add extra options to
358the modules too if you want.
359</p>
360
361<p>
362To view all available modules, run the following <c>find</c> command. Don't
363forget to substitute <c><keyval id="kernel-version"/></c> with the version of
364the kernel you just compiled:
365</p>
366
367<pre caption="Viewing all available modules">
368# <i>find /lib/modules/<keyval id="kernel-version"/>/ -type f -iname '*.o' -or -iname '*.ko'</i>
369</pre>
370
371<p>
372For instance, to automatically load the <c>3c59x.o</c> module, edit the
373<path>kernel-2.6</path> file and enter the module name in it.
374</p>
375
376<pre caption="Editing /etc/modules.autoload.d/kernel-2.6">
377# <i>nano -w /etc/modules.autoload.d/kernel-2.6</i>
378</pre>
379
380<pre caption="/etc/modules.autoload.d/kernel-2.6">
3813c59x
382</pre>
383
384<p>
385Continue the installation with <uri link="?part=1&amp;chap=8">Configuring
386your System</uri>.
387</p>
388
389</body>
390</subsection> 371</subsection>
372
391</section> 373</section>
392</sections> 374</sections>

Legend:
Removed from v.1.9  
changed lines
  Added in v.1.29

  ViewVC Help
Powered by ViewVC 1.1.20