/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml

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

Revision 1.10 Revision 1.11
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-x86+amd64-medium.xml,v 1.10 2008/04/01 08:53:46 nightmorph Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml,v 1.11 2008/04/01 17:21:03 neysx Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<abstract> 11<abstract>
12You can install Gentoo in many ways. This chapter explains how to install 12You can install Gentoo in many ways. This chapter explains how to install
13Gentoo using the minimal Installation CD although installation through the 13Gentoo using the minimal Installation CD although installation through the
14Installer LiveCD is possible as well. 14Installer LiveCD is possible as well.
15</abstract> 15</abstract>
16 16
17<version>6.0</version> 17<version>6.1</version>
18<date>2008-04-01</date> 18<date>2008-04-01</date>
19 19
20<section> 20<section>
21<title>Hardware Requirements</title> 21<title>Hardware Requirements</title>
22<subsection> 22<subsection>
23<title>Introduction</title> 23<title>Introduction</title>
24<body> 24<body>
25 25
26<p> 26<p>
27Before we start, we first list what hardware requirements you need to 27Before we start, we first list what hardware requirements you need to
28successfully install Gentoo on your box. 28successfully install Gentoo on your box.
29</p> 29</p>
30 30
31</body> 31</body>
32</subsection> 32</subsection>
33<subsection> 33<subsection>
69 <th>Minimal CD</th> 69 <th>Minimal CD</th>
70 <th>LiveCD</th> 70 <th>LiveCD</th>
71</tr> 71</tr>
72<tr> 72<tr>
73 <th>CPU</th> 73 <th>CPU</th>
74 <ti colspan="2">Any AMD64 CPU or EM64T CPU</ti> 74 <ti colspan="2">
75 Any AMD64 CPU or <uri
76 link="http://en.wikipedia.org/wiki/EMT64#Intel_64">EM64T CPU</uri> (Core 2
77 Duo &amp; Quad processors are EM64T)
78 </ti>
75</tr> 79</tr>
76<tr> 80<tr>
77 <th>Memory</th> 81 <th>Memory</th>
78 <ti>64 MB</ti> 82 <ti>64 MB</ti>
79 <ti>256 MB</ti> 83 <ti>256 MB</ti>
113 117
114<p> 118<p>
115All Installation CDs allow you to boot, set up networking, initialize your 119All Installation CDs allow you to boot, set up networking, initialize your
116partitions and start installing Gentoo from the Internet. We currently provide 120partitions and start installing Gentoo from the Internet. We currently provide
117two Installation CDs which are equally suitable to install Gentoo from, as long 121two Installation CDs which are equally suitable to install Gentoo from, as long
118as you're planning on performing an Internet-based installation using the 122as you're planning on performing an Internet-based installation using the
119latest version of the available packages. 123latest version of the available packages.
120</p> 124</p>
121 125
122<impo> 126<impo>
123If you wish to install Gentoo without a working Internet connection, or would 127If you wish to install Gentoo without a working Internet connection, or would
130The Installation CDs that we currently provide are: 134The Installation CDs that we currently provide are:
131</p> 135</p>
132 136
133<ul> 137<ul>
134 <li> 138 <li>
135 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable 139 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
136 CD which sole purpose is to boot the system, prepare the networking and 140 CD which sole purpose is to boot the system, prepare the networking and
137 continue with the Gentoo installation. 141 continue with the Gentoo installation.
138 </li> 142 </li>
139 <li> 143 <li>
140 The Gentoo <e>Installer LiveCD</e> contains everything you need to install 144 The Gentoo <e>Installer LiveCD</e> contains everything you need to install
141 Gentoo. It provides a graphical environment, a graphical as well as console 145 Gentoo. It provides a graphical environment, a graphical as well as console
245<subsection> 249<subsection>
246<title>Downloading and Burning the Installation CDs</title> 250<title>Downloading and Burning the Installation CDs</title>
247<body> 251<body>
248 252
249<p> 253<p>
250You have chosen to use a Gentoo Installation CD. We'll first start by 254You have chosen to use a Gentoo Installation CD. We'll first start by
251downloading and burning the chosen Installation CD. We previously discussed 255downloading and burning the chosen Installation CD. We previously discussed
252the several available Installation CDs, but where can you find them? 256the several available Installation CDs, but where can you find them?
253</p> 257</p>
254 258
255<p> 259<p>
256You can download any of the Installation CDs from one of our <uri 260You can download any of the Installation CDs from one of our <uri
257link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in 261link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
296link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>. 300link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
297</p> 301</p>
298 302
299<ul> 303<ul>
300 <li> 304 <li>
301 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso 305 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
302 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's 306 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's
303 device path). 307 device path).
304 </li> 308 </li>
305 <li> 309 <li>
306 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate 310 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
307 your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>. 311 your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
314<title>Booting the Installation CD</title> 318<title>Booting the Installation CD</title>
315<body> 319<body>
316 320
317<p> 321<p>
318Once you have burnt your installation CD, it is time to boot it. 322Once you have burnt your installation CD, it is time to boot it.
319Remove all CDs from your CD drives, reboot your system and enter the BIOS. 323Remove all CDs from your CD drives, reboot your system and enter the BIOS.
320This is usually done by hitting DEL, F1 or ESC, depending on your BIOS. Inside 324This is usually done by hitting DEL, F1 or ESC, depending on your BIOS. Inside
321the BIOS, change the boot order so that the CD-ROM is tried before the hard 325the BIOS, change the boot order so that the CD-ROM is tried before the hard
322disk. This is often found under "CMOS Setup". If you don't do this, your system 326disk. This is often found under "CMOS Setup". If you don't do this, your system
323will just reboot from the hard disk, ignoring the CD-ROM. 327will just reboot from the hard disk, ignoring the CD-ROM.
324</p> 328</p>
325 329
326<p> 330<p>
327Now place the installation CD in the CD-ROM drive and reboot. You should see a 331Now place the installation CD in the CD-ROM drive and reboot. You should see a
329the default boot options, or boot the Installation CD with custom boot options 333the default boot options, or boot the Installation CD with custom boot options
330by specifying a kernel followed by boot options and then hitting Enter. 334by specifying a kernel followed by boot options and then hitting Enter.
331</p> 335</p>
332 336
333<p> 337<p>
334Specifying a kernel? Yes, we provide several kernels on our Installation CDs. 338Specifying a kernel? Yes, we provide several kernels on our Installation CDs.
335The default one is <c>gentoo</c>. Other kernels are for specific hardware needs 339The default one is <c>gentoo</c>. Other kernels are for specific hardware needs
336and the <c>-nofb</c> variants which disable framebuffer. 340and the <c>-nofb</c> variants which disable framebuffer.
337</p> 341</p>
338 342
339<p> 343<p>
385</body> 389</body>
386<body> 390<body>
387 391
388<p> 392<p>
389You can also provide kernel options. They represent optional settings you can 393You can also provide kernel options. They represent optional settings you can
390(de)activate at will. The following list is the same as the one you receive 394(de)activate at will. The following options are available when you press F2 at
391when you press F2 at the bootscreen. 395the bootscreen.
396</p>
397
392</p> 398<p>
399<brite>Hardware options:</brite>
400</p>
393 401
394<pre caption="Options available to pass to your kernel of choice"> 402<dl>
395<comment>Hardware options:</comment> 403<dt>acpi=on</dt>
396 404<dd>
397acpi=on This loads support for ACPI and also causes the acpid daemon to 405 This loads support for ACPI and also causes the acpid daemon to be started by
398 be started by the CD on boot. This is only needed if your 406 the CD on boot. This is only needed if your system requires ACPI to function
399 system requires ACPI to function properly. This is not 407 properly. This is not required for Hyperthreading support.
400 required for Hyperthreading support. 408</dd>
401 409<dt>acpi=off</dt>
410<dd>
402acpi=off Completely disables ACPI. This is useful on some older systems 411 Completely disables ACPI. This is useful on some older systems and is also a
403 and is also a requirement for using APM. This will disable any 412 requirement for using APM. This will disable any Hyperthreading support of
404 Hyperthreading support of your processor. 413 your processor.
405 414</dd>
406console=X This sets up serial console access for the CD. The first 415<dt>console=X</dt>
407 option is the device, usually ttyS0 on x86, followed by any 416<dd>
408 connection options, which are comma separated. The default 417 This sets up serial console access for the CD. The first option is the
409 options are 9600,8,n,1. 418 device, usually ttyS0 on x86, followed by any connection options, which are
410 419 comma separated. The default options are 9600,8,n,1.
420</dd>
421<dt>dmraid=X</dt>
422<dd>
411dmraid=X This allows for passing options to the device-mapper RAID 423 This allows for passing options to the device-mapper RAID subsystem. Options
412 subsystem. Options should be encapsulated in quotes. 424 should be encapsulated in quotes.
425</dd>
426<dt>doapm</dt>
427<dd>
413doapm This loads APM driver support. This requires you to also use 428 This loads APM driver support. This requires you to also use acpi=off.
414 acpi=off. 429</dd>
415 430<dt>dopcmcia</dt>
431<dd>
416dopcmcia This loads support for PCMCIA and Cardbus hardware and also 432 This loads support for PCMCIA and Cardbus hardware and also causes the pcmcia
417 causes the pcmcia cardmgr to be started by the CD on boot. 433 cardmgr to be started by the CD on boot. This is only required when booting
418 This is only required when booting from PCMCIA/Cardbus devices. 434 from PCMCIA/Cardbus devices.
419 435</dd>
436<dt>doscsi</dt>
437<dd>
420doscsi This loads support for most SCSI controllers. This is also a 438 This loads support for most SCSI controllers. This is also a requirement for
421 requirement for booting most USB devices, as they use the SCSI 439 booting most USB devices, as they use the SCSI subsystem of the kernel.
422 subsystem of the kernel. 440</dd>
423 441<dt>hda=stroke</dt>
442<dd>
424hda=stroke This allows you to partition the whole hard disk even when your 443 This allows you to partition the whole hard disk even when your BIOS is unable
425 BIOS is unable to handle large disks. This option is only used 444 to handle large disks. This option is only used on machines with an older BIOS.
426 on machines with an older BIOS. Replace hda with the device 445 Replace hda with the device that is requiring this option.
427 that is requiring this option. 446</dd>
428 447<dt>ide=nodma</dt>
448<dd>
429ide=nodma This forces the disabling of DMA in the kernel and is required 449 This forces the disabling of DMA in the kernel and is required by some IDE
430 by some IDE chipsets and also by some CDROM drives. If your 450 chipsets and also by some CDROM drives. If your system is having trouble
431 system is having trouble reading from your IDE CDROM, try this 451 reading from your IDE CDROM, try this option. This also disables the default
432 option. This also disables the default hdparm settings from 452 hdparm settings from being executed.
433 being executed. 453</dd>
434 454<dt>noapic</dt>
455<dd>
435noapic This disables the Advanced Programmable Interrupt Controller 456 This disables the Advanced Programmable Interrupt Controller that is present
436 that is present on newer motherboards. It has been known to 457 on newer motherboards. It has been known to cause some problems on older
437 cause some problems on older hardware. 458 hardware.
438 459</dd>
460<dt>nodetect</dt>
461<dd>
439nodetect This disables all of the autodetection done by the CD, 462 This disables all of the autodetection done by the CD, including device
440 including device autodetection and DHCP probing. This is 463 autodetection and DHCP probing. This is useful for doing debugging of a
441 useful for doing debugging of a failing CD or driver. 464 failing CD or driver.
442 465</dd>
466<dt>nodhcp</dt>
467<dd>
443nodhcp This disables DHCP probing on detected network cards. This is 468 This disables DHCP probing on detected network cards. This is useful on
444 useful on networks with only static addresses. 469 networks with only static addresses.
445 470</dd>
471<dt>nodmraid</dt>
472<dd>
446nodmraid Disables support for device-mapper RAID, such as that used for 473 Disables support for device-mapper RAID, such as that used for on-board
447 on-board IDE/SATA RAID controllers. 474 IDE/SATA RAID controllers.
448 475</dd>
476<dt>nofirewire</dt>
477<dd>
449nofirewire This disables the loading of Firewire modules. This should 478 This disables the loading of Firewire modules. This should only be necessary
450 only be necessary if your Firewire hardware is causing 479 if your Firewire hardware is causing a problem with booting the CD.
451 a problem with booting the CD. 480</dd>
452 481<dt>nogpm</dt>
482<dd>
453nogpm This diables gpm console mouse support. 483 This diables gpm console mouse support.
454 484</dd>
485<dt>nohotplug</dt>
486<dd>
455nohotplug This disables the loading of the hotplug and coldplug init 487 This disables the loading of the hotplug and coldplug init scripts at boot.
456 scripts at boot. This is useful for doing debugging of a 488 This is useful for doing debugging of a failing CD or driver.
457 failing CD or driver. 489</dd>
458 490<dt>nokeymap</dt>
491<dd>
459nokeymap This disables the keymap selection used to select non-US 492 This disables the keymap selection used to select non-US keyboard layouts.
460 keyboard layouts. 493</dd>
461 494<dt>nolapic</dt>
495<dd>
462nolapic This disables the local APIC on Uniprocessor kernels. 496 This disables the local APIC on Uniprocessor kernels.
463 497</dd>
498<dt>nosata</dt>
499<dd>
464nosata This disables the loading of Serial ATA modules. This is used 500 This disables the loading of Serial ATA modules. This is used if your system
465 if your system is having problems with the SATA subsystem. 501 is having problems with the SATA subsystem.
466 502</dd>
503<dt>nosmp</dt>
504<dd>
467nosmp This disables SMP, or Symmetric Multiprocessing, on SMP-enabled 505 This disables SMP, or Symmetric Multiprocessing, on SMP-enabled kernels. This
468 kernels. This is useful for debugging SMP-related issues with 506 is useful for debugging SMP-related issues with certain drivers and
469 certain drivers and motherboards. 507 motherboards.
470 508</dd>
509<dt>nosound</dt>
510<dd>
471nosound This disables sound support and volume setting. This is useful 511 This disables sound support and volume setting. This is useful for systems
472 for systems where sound support causes problems. 512 where sound support causes problems.
473 513</dd>
514<dt>nousb</dt>
515<dd>
474nousb This disables the autoloading of USB modules. This is useful 516 This disables the autoloading of USB modules. This is useful for debugging
475 for debugging USB issues. 517 USB issues.
476 518</dd>
519<dt>slowusb</dt>
520<dd>
477slowusb This adds some extra pauses into the boot process for slow 521 This adds some extra pauses into the boot process for slow USB CDROMs, like
478 USB CDROMs, like in the IBM BladeCenter. 522 in the IBM BladeCenter.
523</dd>
524</dl>
479 525
526<p>
480<comment>Volume/Device Management:</comment> 527<brite>Volume/Device Management:</brite>
528</p>
481 529
530<dl>
531<dt>doevms</dt>
532<dd>
482doevms This enables support for IBM's pluggable EVMS, or Enterprise 533 This enables support for IBM's pluggable EVMS, or Enterprise Volume
483 Volume Management System. This is not safe to use with lvm. 534 Management System. This is not safe to use with lvm.
484 535</dd>
536<dt>dolvm</dt>
537<dd>
485dolvm This enables support for Linux's Logical Volume Management. 538 This enables support for Linux's Logical Volume Management. This is not safe
486 This is not safe to use with evms. 539 to use with evms.
540</dd>
541</dl>
487 542
488<comment>Other options:</comment> 543<p>
544<brite>Other options:</brite>
545</p>
489 546
547<dl>
548<dt>debug</dt>
549<dd>
490debug Enables debugging code. This might get messy, as it displays 550 Enables debugging code. This might get messy, as it displays a lot of data to
491 a lot of data to the screen. 551 the screen.
492 552</dd>
553<dt>docache</dt>
554<dd>
493docache This caches the entire runtime portion of the CD into RAM, 555 This caches the entire runtime portion of the CD into RAM, which allows you
494 which allows you to umount /mnt/cdrom and mount another CDROM. 556 to umount /mnt/cdrom and mount another CDROM. This option requires that you
495 This option requires that you have at least twice as much 557 have
496 available RAM as the size of the CD. 558 at least twice as much available RAM as the size of the CD.
497 559</dd>
560<dt>doload=X</dt>
561<dd>
498doload=X This causes the initial ramdisk to load any module listed, as 562 This causes the initial ramdisk to load any module listed, as well as
499 well as dependencies. Replace X with the module name. 563 dependencies. Replace X with the module name.
500 564<br/>
501 Multiple modules can be specified by a comma-separated list. 565 Multiple modules can be specified by a comma-separated list.
502 566</dd>
567<dt>dosshd</dt>
568<dd>
503dosshd Starts sshd on boot, which is useful for unattended installs. 569 Starts sshd on boot, which is useful for unattended installs.
504 570</dd>
571<dt>passwd=foo</dt>
572<dd>
505passwd=foo Sets whatever follows the equals as the root password, which 573 Sets whatever follows the equals as the root password, which is required for
506 is required for dosshd since we scramble the root password. 574 dosshd since we scramble the root password.
507 575</dd>
576<dt>noload=X</dt>
577<dd>
508noload=X This causes the initial ramdisk to skip the loading of a 578 This causes the initial ramdisk to skip the loading of a specific module that
509 specific module that may be causing a problem. Syntax matches 579 may be causing a problem. Syntax matches that of doload.
510 that of doload. 580</dd>
511 581<dt>nonfs</dt>
582<dd>
512nonfs Disables the starting of portmap/nfsmount on boot. 583 Disables the starting of portmap/nfsmount on boot.
513 584</dd>
585<dt>nox</dt>
586<dd>
514nox This causes an X-enabled LiveCD to not automatically start X, 587 This causes an X-enabled LiveCD to not automatically start X, but rather, to
515 but rather, to drop to the command line instead. 588 drop to the command line instead.
516 589</dd>
590<dt>scandelay</dt>
591<dd>
517scandelay This causes the CD to pause for 10 seconds during certain 592 This causes the CD to pause for 10 seconds during certain portions the boot
593 process to allow for devices that are slow to initialize to be ready for use.
594</dd>
595<dt>scandelay=X</dt>
596<dd>
597 This allows you to specify a given delay, in seconds, to be added to certain
518 portions the boot process to allow for devices that are slow to 598 portions of the boot process to allow for devices that are slow to initialize
519 initialize to be ready for use. 599 to be ready for use. Replace X with the number of seconds to pause.
520 600</dd>
521scandelay=X This allows you to specify a given delay, in seconds, to be 601</dl>
522 added to certain portions of the boot process to allow for
523 devices that are slow to initialize to be ready for use.
524 Replace X with the number of seconds to pause.
525</pre>
526 602
527<note> 603<note>
528The CD will check for "no*" options before "do*" options, so that you can 604The CD will check for "no*" options before "do*" options, so that you can
529override any option in the exact order you specify. 605override any option in the exact order you specify.
530</note> 606</note>
566When the Installation CD boots, it tries to detect all your hardware devices 642When the Installation CD boots, it tries to detect all your hardware devices
567and loads the appropriate kernel modules to support your hardware. In the vast 643and loads the appropriate kernel modules to support your hardware. In the vast
568majority of cases, it does a very good job. However, in some cases it may not 644majority of cases, it does a very good job. However, in some cases it may not
569auto-load the kernel modules you need. If the PCI auto-detection missed some of 645auto-load the kernel modules you need. If the PCI auto-detection missed some of
570your system's hardware, you will have to load the appropriate kernel modules 646your system's hardware, you will have to load the appropriate kernel modules
571manually. 647manually.
572</p>
573
574<p> 648</p>
649
650<p>
575In the next example we try to load the <c>8139too</c> module (support for 651In the next example we try to load the <c>8139too</c> module (support for
576certain kinds of network interfaces): 652certain kinds of network interfaces):
577</p> 653</p>
578 654
579<pre caption="Loading kernel modules"> 655<pre caption="Loading kernel modules">
580# <i>modprobe 8139too</i> 656# <i>modprobe 8139too</i>
618<body> 694<body>
619 695
620<p> 696<p>
621If you plan on giving other people access to your installation 697If you plan on giving other people access to your installation
622environment or you want to chat using <c>irssi</c> without root privileges (for 698environment or you want to chat using <c>irssi</c> without root privileges (for
623security reasons), you need to create the necessary user accounts and change 699security reasons), you need to create the necessary user accounts and change
624the root password. 700the root password.
625</p> 701</p>
626 702
627<p> 703<p>
628To change the root password, use the <c>passwd</c> utility: 704To change the root password, use the <c>passwd</c> utility:
702 778
703<p> 779<p>
704If you want to allow other users to access your computer during the 780If you want to allow other users to access your computer during the
705Gentoo installation (perhaps because those users are going to help you 781Gentoo installation (perhaps because those users are going to help you
706install Gentoo, or even do it for you), you need to create a user 782install Gentoo, or even do it for you), you need to create a user
707account for them and perhaps even provide them with your root password 783account for them and perhaps even provide them with your root password
708(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user). 784(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
709</p> 785</p>
710 786
711<p> 787<p>
712To fire up the SSH daemon, execute the following command: 788To fire up the SSH daemon, execute the following command:

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

  ViewVC Help
Powered by ViewVC 1.1.20