Attachment #79431 for bug #122289

Lines 206-212 Link Here

(-)handbook-alpha.xml (-1 / +1 lines)
206	<chapter>	206	<chapter>
207	<title>Installing Necessary System Tools</title>	207	<title>Installing Necessary System Tools</title>
208	<abstract>	208	<abstract>
209	As mentioned before, Gentoo is about choices. In this chapter we help you	209	As mentioned before, Gentoo is about customizations. In this chapter we help you
210	choose and install some important tools.	210	choose and install some important tools.
211	</abstract>	211	</abstract>
212	<include href="hb-install-tools.xml"/>	212	<include href="hb-install-tools.xml"/>

Lines 206-212 Link Here

(-)handbook-amd64.xml (-1 / +1 lines)
206	<chapter>	206	<chapter>
207	<title>Installing Necessary System Tools</title>	207	<title>Installing Necessary System Tools</title>
208	<abstract>	208	<abstract>
209	As mentioned before, Gentoo is about choices. In this chapter we help you	209	As mentioned before, Gentoo is about customizations. In this chapter we help you
210	choose and install some important tools.	210	choose and install some important tools.
211	</abstract>	211	</abstract>
212	<include href="hb-install-tools.xml"/>	212	<include href="hb-install-tools.xml"/>

Lines 206-212 Link Here

(-)handbook-hppa.xml (-1 / +1 lines)
206	<chapter>	206	<chapter>
207	<title>Installing Necessary System Tools</title>	207	<title>Installing Necessary System Tools</title>
208	<abstract>	208	<abstract>
209	As mentioned before, Gentoo is about choices. In this chapter we help you	209	As mentioned before, Gentoo is about customizations. In this chapter we help you
210	choose and install some important tools.	210	choose and install some important tools.
211	</abstract>	211	</abstract>
212	<include href="hb-install-tools.xml"/>	212	<include href="hb-install-tools.xml"/>

Lines 209-215 Link Here

(-)handbook-ppc.xml (-1 / +1 lines)
209	<chapter>	209	<chapter>
210	<title>Installing Necessary System Tools</title>	210	<title>Installing Necessary System Tools</title>
211	<abstract>	211	<abstract>
212	As mentioned before, Gentoo is about choices. In this chapter we help you	212	As mentioned before, Gentoo is about customizations. In this chapter we help you
213	choose and install some important tools.	213	choose and install some important tools.
214	</abstract>	214	</abstract>
215	<include href="hb-install-tools.xml"/>	215	<include href="hb-install-tools.xml"/>

Lines 206-212 Link Here

(-)handbook-ppc64.xml (-1 / +1 lines)
206	<chapter>	206	<chapter>
207	<title>Installing Necessary System Tools</title>	207	<title>Installing Necessary System Tools</title>
208	<abstract>	208	<abstract>
209	As mentioned before, Gentoo is about choices. In this chapter we help you	209	As mentioned before, Gentoo is about customizations. In this chapter we help you
210	choose and install some important tools.	210	choose and install some important tools.
211	</abstract>	211	</abstract>
212	<include href="hb-install-tools.xml"/>	212	<include href="hb-install-tools.xml"/>

Lines 206-212 Link Here

(-)handbook-sparc.xml (-1 / +1 lines)
206	<chapter>	206	<chapter>
207	<title>Installing Necessary System Tools</title>	207	<title>Installing Necessary System Tools</title>
208	<abstract>	208	<abstract>
209	As mentioned before, Gentoo is about choices. In this chapter we help you	209	As mentioned before, Gentoo is about customizations. In this chapter we help you
210	choose and install some important tools.	210	choose and install some important tools.
211	</abstract>	211	</abstract>
212	<include href="hb-install-tools.xml"/>	212	<include href="hb-install-tools.xml"/>

Lines 157-163 Link Here

(-)handbook-x86.xml (-2 / +2 lines)
157	If you need networking, this is the place where the network (and Internet	157	If you need networking, this is the place where the network (and Internet
158	connection) is configured.	158	connection) is configured.
159	</abstract>	159	</abstract>
160	<include href="hb-install-network.xml"/>	160	<include href="hb-install-x86-network.xml"/>
161	</chapter>	161	</chapter>
162		162
163	<chapter>	163	<chapter>
Lines 209-215 Link Here
209	<chapter>	209	<chapter>
210	<title>Installing Necessary System Tools</title>	210	<title>Installing Necessary System Tools</title>
211	<abstract>	211	<abstract>
212	As mentioned before, Gentoo is about choices. In this chapter we help you	212	As mentioned before, Gentoo is about customizations. In this chapter we help you
213	choose and install some important tools.	213	choose and install some important tools.
214	</abstract>	214	</abstract>
215	<include href="hb-install-tools.xml"/>	215	<include href="hb-install-tools.xml"/>





<p>
First of all, <e>welcome</e> to Gentoo. You are about to enter the world
of customization and performance. Gentoo is all about customizing. When
installing Gentoo, this is made clear to you several times -- you can
choose how much you want to compile yourself, how to install Gentoo,
what system logger you want, etc.
</p>

<p>
Gentoo is a fast, modern meta-distribution with a clean and flexible
design. Gentoo is built around free software and doesn't hide from its
users what is beneath the hood. Portage, the package maintenance system
which Gentoo uses, is written in Python, meaning you can easily view and
modify the source code. Gentoo's packaging system uses source code
(although support for precompiled packages is included too) and
configuring Gentoo happens through regular text files. In other words,
openness everywhere.
</p>

<p>
It is very important that you understand that <e>empowerment</e> is what
makes Gentoo run. We try not to force you onto anything you don't like. We
try to give flexibility to empower you to make the choices you wish.
If you feel like a change should be made, please file a <uri
link="http://bugs.gentoo.org">bug report</uri> about it.
</p>

</body>





<sections>

<version>5.1</version>
<date>2006-02-09</date>

<section>
<title>Introduction</title>


<p>
First of all, <e>welcome</e> to Gentoo. You are about to enter the world
of customization and performance. Gentoo is all about customizing. When
installing Gentoo, this is made clear to you several times -- you can
choose how much you want to compile yourself, how to install Gentoo,
what system logger you want, etc.
</p>

<p>
Gentoo is a fast, modern meta-distribution with a clean and flexible
design. Gentoo is built around free software and doesn't hide from its
users what is beneath the hood. Portage, the package maintenance system
which Gentoo uses, is written in Python, meaning you can easily view and
modify the source code. Gentoo's packaging system uses source code
(although support for precompiled packages is included too) and
configuring Gentoo happens through regular text files. In other words,
openness everywhere.
</p>

<p>
It is very important that you understand that <e>empowerment</e> is what
makes Gentoo run. We try not to force you onto anything you don't like. We
try to give flexibility to empower you to make the choices you wish.
If you feel a change should be made, please file a <uri
link="http://bugs.gentoo.org">bug report</uri> about it.
</p>

</body>

If you find a problem in the installation (or in the installation
documentation), please check the errata from our <uri
link="/proj/en/releng/">Gentoo Release Engineering Project</uri>, 
visit our <uri link="http://bugs.gentoo.org">bug tracking
system</uri> and check if the bug is known. If not, please create a bug report 
for it so we can take care of it. Do not be afraid of the developers who are 
assigned to (your) bugs -- they generally don't eat people.
</p>


<ul>
  <li>
    The <b>alpha</b> architecture (alpha)
		pentium2, pentium3, pentium4 and pentium-m)
		Note: The i686 packages are available on the Installer LiveCD.
  </li>
  <li>
    The <b>amd64</b> architecture (amd64)
  </li>
  <li>
    The <b>hppa</b> architecture (hppa1.1, hppa2.0)
  </li>
  <li>
    The <b>ppc</b> architecture (ppc32, ppc64)
  </li>
  <li>
    The <b>sparc</b> architecture (sparc64)
  </li>
  <li>
    The <b>x86</b> architecture (athlon, athlon-xp, athlon-mp, pentium-pro,
		pentium2, pentium3, pentium4 and pentium-m)
		Note: The packages are for i686 and are available on the Installer
		LiveCD.
  </li>
</ul>






<sections>

<version>5.6</version>
<date>2006-02-09</date>

<section>
<title>Hardware Requirements</title>


<p>
Before we start, we first list what hardware requirements you need to
successfully install Gentoo on your box using the Installer LiveCD.
</p>

</body>

<table>
<tr>
  <th>CPU</th>
  <ti>i686 or later</ti>
</tr>
<tr>
  <th>Memory</th>
  <ti>128 MB</ti>
</tr>
<tr>
  <th>Diskspace</th>


<ul>
  <li>
    The Installer LiveCD contains everything you need to install Gentoo. It
	provides a graphical environment, a graphical as well as console
		based installer which automatically carries out the installation for you,
    and of course, the installation instructions for your architecture.
		Packages and of course, the installation instructions for your architecture.
  </li>
  <li>
    The Minimal Installation CD contains only a minimal environment that allows 

  </li>
</ul>

<p>
The Gentoo Linux Installer LiveCD also provides an additional resource that you
can exploit during the installation of your Gentoo system. It contains prebuilt
packages (also known as the GRP set) that allow you to easily and quickly
install additional applications (such as OpenOffice.org, GNOME, ...)
immediately after the Gentoo installation and right before you update your
Portage tree.
</p>

</body>
</subsection>
</section>

<p>
You can also provide kernel options. They represent optional settings you can
(de)activate at will. The following list is the same as the one you receive
when you press F2 through F7 at the bootscreen.
</p>

<pre caption="Options available to pass to your kernel of choice">
Hardware options:

acpi=on         This loads support for ACPI and also causes the acpid daemon to
                be started by the CD on boot.  This is only needed if your
                system requires ACPI to function properly.  This is not required                for Hyperthreading support.
acpi=off        Completely disables ACPI.  This is useful on some older systems,                and is also a requirement for using APM.  This will disable any
                Hyperthreading support of your processor.
console=X       This sets up serial console access for the CD.  The first
                option is the device, usually ttyS0 on x86, followed by any
                connection options, which are comma separated.  The default
                options are 9600,8,n,1.
dmraid=X        This allows for passing options to the device-mapper RAID
                subsystem.  Options should be encapsulated in quotes.
doapm           This loads APM driver support.  This requires you to also use
                acpi=off.
dobladecenter   This adds some extra pauses into the boot process for the slow
                USB CDROM of the IBM BladeCenter.
dopcmcia        This loads support for PCMCIA and Cardbus hardware and also
                causes the pcmcia cardmgr to be started by the CD on boot.
                This is only required when booting from a PCMCIA/Cardbus device.doscsi          This loads support for most SCSI controllers.  This is also a
                requirement for booting most USB devices, as they use the SCSI
                subsystem of the kernel.
hda=stroke      This allows you to partition the whole hard disk even when your
                BIOS is unable to handle large disks.  This option is only used
                on machines with an older BIOS.  Replace hda with the device
                that is requiring this option.
ide=nodma       This forces the disabling of DMA in the kernel and is required
                by some IDE chipsets and also by some CDROM drives.  If your
                system is having trouble reading from your IDE CDROM, try this
                option.  This also disables the default hdparm settings from
                being executed.
noapic          This disables the Advanced Programmable Interrupt Controller
                that is present on newer motherboards.  It has been known to
                cause some problems on older hardware.
nodetect        This disables all of the autodetection done by the CD, including                device autodetection and DHCP probing.  This is useful for doing                debugging of a failing CD or driver.
nodhcp          This disables DHCP probing on detected network cards.  This is
                useful on networks with only static addresses.
nodmraid        Disables support for device-mapper RAID, such as that used for
                on-board IDE/SATA RAID controllers.
nofirewire      This disables the loading of Firewire modules.  This should only                be necessary if your Firewire hardware is causing a problem with                booting the CD.
nogpm           This diables gpm console mouse support.
nohotplug       This disables the loading of the hotplug and coldplug init
                scripts at boot.  This is useful for doing debugging of a
                failing CD or driver.
nokeymap        This disables the keymap selection used to select non-US
                keyboard layouts.
nolapic         This disables the local APIC on Uniprocessor kernels.
nosata          This disables the loading of Serial ATA modules.  This is useful                if your system is having problems with the SATA subsystem.
nosmp           This disables SMP, or Symmetric Multiprocessing, on SMP-enabled
                kernels.  This is useful for debugging SMP-related issues with
                certain drivers and motherboards.
nosound         This disables sound support and volume setting.  This is useful
                for systems where sound support causes problems.
nousb           This disables the autoloading of USB modules.  This is useful
                for debugging USB issues.

Volume/Device Management:

dodevfs         This enables the deprecated device filesystem on 2.6 systems.
                You will also need to use noudev for this to take effect.
                Since devfs is the only option with a 2.4 kernel, this option
                has no effect if booting a 2.4 kernel.
doevms2         This enables support for IBM's pluggable EVMS, or Enterprise
                Volume Management System.  This is not safe to use with lvm2.
dolvm2          This enables support for Linux's Logical Volume Management.
                This is not safe to use with evms2.
noudev          This disables udev support on 2.6 kernels.  This option requires                that dodevfs is used.  Since udev is not an option for 2.4
                kernels, this options has no effect if booting a 2.4 kernel.
unionfs         Enables support for Unionfs on supported CD images.  This will
                create a writable Unionfs overlay in a tmpfs, allowing you to
                change any file on the CD.
unionfs=X       Enables support for Unionfs on supported CD images.  This will
                create a writable Unionfs overlay on the device you specify.
                The device must be formatted with a filesystem recognized and
                writable by the kernel.

Other options:

debug           Enables debugging code.  This might get messy, as it displays
                a lot of data to the screen.
docache         This caches the entire runtime portion of the CD into RAM, which                allows you to umount /mnt/cdrom and mount another CDROM.  This
                option requires that you have at least twice as much available
                RAM as the size of the CD.
doload=X        This causes the initial ramdisk to load any module listed, as
                well as dependencies.  Replace X with the module name.  Multiple                modules can be specified by a comma-separated list.
noload=X        This causes the initial ramdisk to skip the loading of a
                specific module that may be causing a problem.  Syntax matches
                that of doload.
nox             This causes an X-enabled LiveCD to not automatically start X,
                but rather, to drop to the command line instead.
scandelay       This causes the CD to pause for 10 seconds during certain
                portions the boot process to allow for devices that are slow to
                initialize to be ready for use.
scandelay=X     This allows you to specify a given delay, in seconds, to be
                added to certain portions of the boot process to allow for
                devices that are slow to initialize to be ready for use.
                Replace X with the number of seconds to pause.
</pre>

<p>

installing Gentoo on a system with a non-US keyboard, make sure you
immediately press Alt-F1 to switch to verbose mode and follow the prompt. If no
selection is made in 10 seconds the default (US keyboard) will be accepted and
the boot process will continue. Once the boot process completes, Gnome will
start up and you will be automatically logged in to the "Live" Gentoo Linux as
"gentoo" in graphical mode. You will be logged in as "root", the superuser on
the other consoles and should have a root ("#") prompt there. You can switch to
those consoles by pressing Alt-F2, Alt-F3, Alt-F4 Alt-F5, Alt-F6. Get back to
the graphical desktop you started on by pressing Alt-F7. To switch to other
consoles from within X, you must prefix the above with Ctrl. You are able to
run commands as root from any terminal within the graphical environment by using
the <c>sudo</c> application.  You can even become root within a terminal to
perform multiple tasks.
</p>

<pre caption="Using sudo to run applications">
<comment>(Editing the group file)</comment>
# <i>sudo vi /etc/group</i>
<comment>(Becoming root for a session)</comment>
# <i>sudo su -</i>
</pre>

</body>
</subsection>
<subsection id="hardware">

vast majority of cases, it does a very good job. However, in some cases, it 
may not auto-load the kernel modules you need. If the PCI auto-detection 
missed some of your system's hardware, you will have to load the appropriate
kernel modules manually. These tasks require root access.
</p>

<p>


<p>
If you are an advanced user, you might want to tweak the IDE hard disk
performance using <c>hdparm</c>. You will need root access to use <c>hdparm</c>.
With the <c>-tT</c> options you can test the performance of your disk (execute
it several times to get a more precise impression):
</p>

<pre caption="Testing disk performance">

If you plan on giving other people access to your installation
environment or you want to chat using <c>irssi</c> without root privileges (for
security reasons), you need to create the necessary user accounts and change 
the root password. You need root access to change the root password and add new
users.
</p>

<p>

</p>

<pre caption="Changing the root password">
$ <i>sudo su -</i>
# <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>

# <i>su - john</i>
</pre>

<p>
You can also change the password for the "gentoo" user in the graphical
environment. This account is already suitable for use on the Internet.
</p>

<pre caption="Changing the gentoo password">
$ <i>passwd</i>
New password: <comment>(Enter your new password)</comment>
Re-enter password: <comment>(Re-enter your password)</comment>
</pre>


</body>
</subsection>
<subsection>

Gentoo installation (perhaps because those users are going to help you
install Gentoo, or even do it for you), you need to create a user
account for them and perhaps even provide them with your root password 
(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).  Starting the
SSH daemon requires root access.
</p>

<p>

Return to bug 122289

Lines 19-46 Link Here

(-)hb-install-about.xml (-7 / +8 lines)
19		19
20	<p>	20	<p>
21	First of all, <e>welcome</e> to Gentoo. You are about to enter the world	21	First of all, <e>welcome</e> to Gentoo. You are about to enter the world
22	of choices and performance. Gentoo is all about choices. When	22	of customization and performance. Gentoo is all about customizing. When
23	installing Gentoo, this is made clear to you several times -- you can	23	installing Gentoo, this is made clear to you several times -- you can
24	choose how much you want to compile yourself, how to install Gentoo,	24	choose how much you want to compile yourself, how to install Gentoo,
25	what system logger you want, etc.	25	what system logger you want, etc.
26	</p>	26	</p>
27		27
28	<p>	28	<p>
29	Gentoo is a fast, modern metadistribution with a clean and flexible	29	Gentoo is a fast, modern meta-distribution with a clean and flexible
30	design. Gentoo is built around free software and doesn't hide from its	30	design. Gentoo is built around free software and doesn't hide from its
31	users what is beneath the hood. Portage, the package maintenance system	31	users what is beneath the hood. Portage, the package maintenance system
32	which Gentoo uses, is written in Python, meaning you can easily view and	32	which Gentoo uses, is written in Python, meaning you can easily view and
33	modify the source code. Gentoo's packaging system uses source code	33	modify the source code. Gentoo's packaging system uses source code
34	(although support for precompiled packages is included too) and	34	(although support for precompiled packages is included too) and
35	configuring Gentoo happens through regular textfiles. In other words,	35	configuring Gentoo happens through regular text files. In other words,
36	openness everywhere.	36	openness everywhere.
37	</p>	37	</p>
38		38
39	<p>	39	<p>
40	It is very important that you understand that <e>choices</e> are what	40	It is very important that you understand that <e>empowerment</e> is what
41	makes Gentoo run. We try not to force you onto anything you don't like.	41	makes Gentoo run. We try not to force you onto anything you don't like. We
42	If you feel like we do, please <uri	42	try to give flexibility to empower you to make the choices you wish.
43	link="http://bugs.gentoo.org">bugreport</uri> it.	43	If you feel like a change should be made, please file a <uri
		44	link="http://bugs.gentoo.org">bug report</uri> about it.
44	</p>	45	</p>
45		46
46	</body>	47	</body>

Lines 8-15 Link Here

(-)hb-install-x86-about.xml (-17 / +22 lines)
8		8
9	<sections>	9	<sections>
10		10
11	<version>5.0</version>	11	<version>5.1</version>
12	<date>2005-08-08</date>	12	<date>2006-02-09</date>
13		13
14	<section>	14	<section>
15	<title>Introduction</title>	15	<title>Introduction</title>
Lines 19-46 Link Here
19		19
20	<p>	20	<p>
21	First of all, <e>welcome</e> to Gentoo. You are about to enter the world	21	First of all, <e>welcome</e> to Gentoo. You are about to enter the world
22	of choices and performance. Gentoo is all about choices. When	22	of customization and performance. Gentoo is all about customizing. When
23	installing Gentoo, this is made clear to you several times -- you can	23	installing Gentoo, this is made clear to you several times -- you can
24	choose how much you want to compile yourself, how to install Gentoo,	24	choose how much you want to compile yourself, how to install Gentoo,
25	what system logger you want, etc.	25	what system logger you want, etc.
26	</p>	26	</p>
27		27
28	<p>	28	<p>
29	Gentoo is a fast, modern metadistribution with a clean and flexible	29	Gentoo is a fast, modern meta-distribution with a clean and flexible
30	design. Gentoo is built around free software and doesn't hide from its	30	design. Gentoo is built around free software and doesn't hide from its
31	users what is beneath the hood. Portage, the package maintenance system	31	users what is beneath the hood. Portage, the package maintenance system
32	which Gentoo uses, is written in Python, meaning you can easily view and	32	which Gentoo uses, is written in Python, meaning you can easily view and
33	modify the source code. Gentoo's packaging system uses source code	33	modify the source code. Gentoo's packaging system uses source code
34	(although support for precompiled packages is included too) and	34	(although support for precompiled packages is included too) and
35	configuring Gentoo happens through regular textfiles. In other words,	35	configuring Gentoo happens through regular text files. In other words,
36	openness everywhere.	36	openness everywhere.
37	</p>	37	</p>
38		38
39	<p>	39	<p>
40	It is very important that you understand that <e>choices</e> are what	40	It is very important that you understand that <e>empowerment</e> is what
41	makes Gentoo run. We try not to force you onto anything you don't like.	41	makes Gentoo run. We try not to force you onto anything you don't like. We
42	If you feel like we do, please <uri	42	try to give flexibility to empower you to make the choices you wish.
43	link="http://bugs.gentoo.org">bugreport</uri> it.	43	If you feel a change should be made, please file a <uri
		44	link="http://bugs.gentoo.org">bug report</uri> about it.
44	</p>	45	</p>
45		46
46	</body>	47	</body>
Lines 160-167 Link Here
160	If you find a problem in the installation (or in the installation	161	If you find a problem in the installation (or in the installation
161	documentation), please check the errata from our <uri	162	documentation), please check the errata from our <uri
162	link="/proj/en/releng/">Gentoo Release Engineering Project</uri>,	163	link="/proj/en/releng/">Gentoo Release Engineering Project</uri>,
163	visit our <uri link="http://bugs.gentoo.org">bugtracking	164	visit our <uri link="http://bugs.gentoo.org">bug tracking
164	system</uri> and check if the bug is known. If not, please create a bugreport	165	system</uri> and check if the bug is known. If not, please create a bug report
165	for it so we can take care of it. Do not be afraid of the developers who are	166	for it so we can take care of it. Do not be afraid of the developers who are
166	assigned to (your) bugs -- they generally don't eat people.	167	assigned to (your) bugs -- they generally don't eat people.
167	</p>	168	</p>
Lines 261-281 Link Here
261		262
262	<ul>	263	<ul>
263	<li>	264	<li>
264	The <b>i686</b> architecture (athlon, athlon-xp, athlon-mp, pentium-pro,	265	The <b>alpha</b> architecture (alpha)
265	pentium2, pentium3, pentium4 and pentium-m)
266	Note: The i686 packages are available on the Installer LiveCD.
267	</li>	266	</li>
268	<li>	267	<li>
269	The <b>amd64</b> architecture (amd64)	268	The <b>amd64</b> architecture (amd64)
270	</li>	269	</li>
271	<li>	270	<li>
272	The <b>sparc</b> architecture (sparc64)	271	The <b>hppa</b> architecture (hppa1.1, hppa2.0)
		272	</li>
		273	<li>
		274	The <b>ppc</b> architecture (ppc32, ppc64)
273	</li>	275	</li>
274	<li>	276	<li>
275	The <b>ppc</b> architecture (G3, G4, G5)	277	The <b>sparc</b> architecture (sparc64)
276	</li>	278	</li>
277	<li>	279	<li>
278	The <b>alpha</b> architecture	280	The <b>x86</b> architecture (athlon, athlon-xp, athlon-mp, pentium-pro,
		281	pentium2, pentium3, pentium4 and pentium-m)
		282	Note: The packages are for i686 and are available on the Installer
		283	LiveCD.
279	</li>	284	</li>
280	</ul>	285	</ul>
281		286

Lines 8-15 Link Here

(-)hb-install-x86-medium.xml (-48 / +141 lines)
8		8
9	<sections>	9	<sections>
10		10
11	<version>5.5</version>	11	<version>5.6</version>
12	<date>2005-11-29</date>	12	<date>2006-02-09</date>
13		13
14	<section>	14	<section>
15	<title>Hardware Requirements</title>	15	<title>Hardware Requirements</title>
Lines 19-25 Link Here
19		19
20	<p>	20	<p>
21	Before we start, we first list what hardware requirements you need to	21	Before we start, we first list what hardware requirements you need to
22	successfully install Gentoo on your box.	22	successfully install Gentoo on your box using the Installer LiveCD.
23	</p>	23	</p>
24		24
25	</body>	25	</body>
Lines 31-41 Link Here
31	<table>	31	<table>
32	<tr>	32	<tr>
33	<th>CPU</th>	33	<th>CPU</th>
34	<ti>i486 or later</ti>	34	<ti>i686 or later</ti>
35	</tr>	35	</tr>
36	<tr>	36	<tr>
37	<th>Memory</th>	37	<th>Memory</th>
38	<ti>64 MB</ti>	38	<ti>128 MB</ti>
39	</tr>	39	</tr>
40	<tr>	40	<tr>
41	<th>Diskspace</th>	41	<th>Diskspace</th>
Lines 90-100 Link Here
90		90
91	<ul>	91	<ul>
92	<li>	92	<li>
93	The Installer LiveCD contains everything you need to install	93	The Installer LiveCD contains everything you need to install Gentoo. It
94	Gentoo. It provides a graphical environment, a graphical as well as console	94	provides a graphical environment, a graphical as well as console
95	based installer which automatically carries out the installation for you,	95	based installer which automatically carries out the installation for you,
96	source code for the extra applications you need to choose from, GRP	96	and of course, the installation instructions for your architecture.
97	Packages and of course, the installation instructions for your architecture.
98	</li>	97	</li>
99	<li>	98	<li>
100	The Minimal Installation CD contains only a minimal environment that allows	99	The Minimal Installation CD contains only a minimal environment that allows
Lines 104-118 Link Here
104	</li>	103	</li>
105	</ul>	104	</ul>
106		105
107	<p>
108	The Gentoo Linux Installer LiveCD also provides an additional resource that you
109	can exploit during the installation of your Gentoo system. It contains prebuilt
110	packages (also known as the GRP set) that allow you to easily and quickly
111	install additional applications (such as OpenOffice.org, GNOME, ...)
112	immediately after the Gentoo installation and right before you update your
113	Portage tree.
114	</p>
115
116	</body>	106	</body>
117	</subsection>	107	</subsection>
118	</section>	108	</section>
Lines 246-275 Link Here
246	<p>	236	<p>
247	You can also provide kernel options. They represent optional settings you can	237	You can also provide kernel options. They represent optional settings you can
248	(de)activate at will. The following list is the same as the one you receive	238	(de)activate at will. The following list is the same as the one you receive
249	when you press F2 at the bootscreen.	239	when you press F2 through F7 at the bootscreen.
250	</p>	240	</p>
251		241
252	<pre caption="Options available to pass to your kernel of choice">	242	<pre caption="Options available to pass to your kernel of choice">
253	- agpgart loads agpgart (use if you have graphic problems,lockups)	243	Hardware options:
254	- acpi=on loads support for ACPI firmware	244
255	- ide=nodma force disabling of DMA for malfunctioning IDE devices	245	acpi=on This loads support for ACPI and also causes the acpid daemon to
256	- doscsi scan for scsi devices (breaks some ethernet cards)	246	be started by the CD on boot. This is only needed if your
257	- dopcmcia starts pcmcia service for PCMCIA cdroms	247	system requires ACPI to function properly. This is not required for Hyperthreading support.
258	- nofirewire disables firewire modules in initrd (for firewire cdroms,etc)	248	acpi=off Completely disables ACPI. This is useful on some older systems, and is also a requirement for using APM. This will disable any
259	- nokeymap disables keymap selection for non-us keyboard layouts	249	Hyperthreading support of your processor.
260	- docache cache the entire runtime portion of cd in RAM, allows you	250	console=X This sets up serial console access for the CD. The first
261	to umount /mnt/cdrom to mount another cdrom.	251	option is the device, usually ttyS0 on x86, followed by any
262	- nodetect causes hwsetup/kudzu and hotplug not to run	252	connection options, which are comma separated. The default
263	- nousb disables usb module load from initrd, disables hotplug	253	options are 9600,8,n,1.
264	- nodhcp dhcp does not automatically start if nic detected	254	dmraid=X This allows for passing options to the device-mapper RAID
265	- nohotplug disables loading hotplug service	255	subsystem. Options should be encapsulated in quotes.
266	- noapic disable apic (try if having hardware problems nics,scsi,etc)	256	doapm This loads APM driver support. This requires you to also use
267	- noevms2 disable loading of EVMS2 modules	257	acpi=off.
268	- nolvm2 disable loading of LVM2 modules	258	dobladecenter This adds some extra pauses into the boot process for the slow
269	- hdx=stroke allows you to partition the whole harddrive even when your BIOS	259	USB CDROM of the IBM BladeCenter.
270	can't handle large harddrives	260	dopcmcia This loads support for PCMCIA and Cardbus hardware and also
271	- noload=module1[,module2[,...]]	261	causes the pcmcia cardmgr to be started by the CD on boot.
272	disable loading of specific kernel modules	262	This is only required when booting from a PCMCIA/Cardbus device.doscsi This loads support for most SCSI controllers. This is also a
		263	requirement for booting most USB devices, as they use the SCSI
		264	subsystem of the kernel.
		265	hda=stroke This allows you to partition the whole hard disk even when your
		266	BIOS is unable to handle large disks. This option is only used
		267	on machines with an older BIOS. Replace hda with the device
		268	that is requiring this option.
		269	ide=nodma This forces the disabling of DMA in the kernel and is required
		270	by some IDE chipsets and also by some CDROM drives. If your
		271	system is having trouble reading from your IDE CDROM, try this
		272	option. This also disables the default hdparm settings from
		273	being executed.
		274	noapic This disables the Advanced Programmable Interrupt Controller
		275	that is present on newer motherboards. It has been known to
		276	cause some problems on older hardware.
		277	nodetect This disables all of the autodetection done by the CD, including device autodetection and DHCP probing. This is useful for doing debugging of a failing CD or driver.
		278	nodhcp This disables DHCP probing on detected network cards. This is
		279	useful on networks with only static addresses.
		280	nodmraid Disables support for device-mapper RAID, such as that used for
		281	on-board IDE/SATA RAID controllers.
		282	nofirewire This disables the loading of Firewire modules. This should only be necessary if your Firewire hardware is causing a problem with booting the CD.
		283	nogpm This diables gpm console mouse support.
		284	nohotplug This disables the loading of the hotplug and coldplug init
		285	scripts at boot. This is useful for doing debugging of a
		286	failing CD or driver.
		287	nokeymap This disables the keymap selection used to select non-US
		288	keyboard layouts.
		289	nolapic This disables the local APIC on Uniprocessor kernels.
		290	nosata This disables the loading of Serial ATA modules. This is useful if your system is having problems with the SATA subsystem.
		291	nosmp This disables SMP, or Symmetric Multiprocessing, on SMP-enabled
		292	kernels. This is useful for debugging SMP-related issues with
		293	certain drivers and motherboards.
		294	nosound This disables sound support and volume setting. This is useful
		295	for systems where sound support causes problems.
		296	nousb This disables the autoloading of USB modules. This is useful
		297	for debugging USB issues.
		298
		299	Volume/Device Management:
		300
		301	dodevfs This enables the deprecated device filesystem on 2.6 systems.
		302	You will also need to use noudev for this to take effect.
		303	Since devfs is the only option with a 2.4 kernel, this option
		304	has no effect if booting a 2.4 kernel.
		305	doevms2 This enables support for IBM's pluggable EVMS, or Enterprise
		306	Volume Management System. This is not safe to use with lvm2.
		307	dolvm2 This enables support for Linux's Logical Volume Management.
		308	This is not safe to use with evms2.
		309	noudev This disables udev support on 2.6 kernels. This option requires that dodevfs is used. Since udev is not an option for 2.4
		310	kernels, this options has no effect if booting a 2.4 kernel.
		311	unionfs Enables support for Unionfs on supported CD images. This will
		312	create a writable Unionfs overlay in a tmpfs, allowing you to
		313	change any file on the CD.
		314	unionfs=X Enables support for Unionfs on supported CD images. This will
		315	create a writable Unionfs overlay on the device you specify.
		316	The device must be formatted with a filesystem recognized and
		317	writable by the kernel.
		318
		319	Other options:
		320
		321	debug Enables debugging code. This might get messy, as it displays
		322	a lot of data to the screen.
		323	docache This caches the entire runtime portion of the CD into RAM, which allows you to umount /mnt/cdrom and mount another CDROM. This
		324	option requires that you have at least twice as much available
		325	RAM as the size of the CD.
		326	doload=X This causes the initial ramdisk to load any module listed, as
327	well as dependencies. Replace X with the module name. Multiple modules can be specified by a comma-separated list.
328	noload=X This causes the initial ramdisk to skip the loading of a
329	specific module that may be causing a problem. Syntax matches
330	that of doload.
331	nox This causes an X-enabled LiveCD to not automatically start X,
332	but rather, to drop to the command line instead.
333	scandelay This causes the CD to pause for 10 seconds during certain
334	portions the boot process to allow for devices that are slow to
335	initialize to be ready for use.
336	scandelay=X This allows you to specify a given delay, in seconds, to be
337	added to certain portions of the boot process to allow for
338	devices that are slow to initialize to be ready for use.
339	Replace X with the number of seconds to pause.
273	</pre>	340	</pre>
274		341
275	<p>	342	<p>
Lines 288-301 Link Here
288	installing Gentoo on a system with a non-US keyboard, make sure you	355	installing Gentoo on a system with a non-US keyboard, make sure you
289	immediately press Alt-F1 to switch to verbose mode and follow the prompt. If no	356	immediately press Alt-F1 to switch to verbose mode and follow the prompt. If no
290	selection is made in 10 seconds the default (US keyboard) will be accepted and	357	selection is made in 10 seconds the default (US keyboard) will be accepted and
291	the boot process will continue. Once the boot process completes, Gnome will start	358	the boot process will continue. Once the boot process completes, Gnome will
292	up and you will be automatically logged in to the "Live" Gentoo Linux as	359	start up and you will be automatically logged in to the "Live" Gentoo Linux as
293	"gentoo" in graphical mode. You will be logged in as "root", the superuser on	360	"gentoo" in graphical mode. You will be logged in as "root", the superuser on
294	the other consoles and should have a root ("#") prompt there. You can switch to	361	the other consoles and should have a root ("#") prompt there. You can switch to
295	those consoles by pressing Alt-F2, Alt-F3, Alt-F4 Alt-F5, Alt-F6. Get back to	362	those consoles by pressing Alt-F2, Alt-F3, Alt-F4 Alt-F5, Alt-F6. Get back to
296	the graphical desktop you started on by pressing Alt-F7.	363	the graphical desktop you started on by pressing Alt-F7. To switch to other
		364	consoles from within X, you must prefix the above with Ctrl. You are able to
		365	run commands as root from any terminal within the graphical environment by using
		366	the <c>sudo</c> application. You can even become root within a terminal to
		367	perform multiple tasks.
297	</p>	368	</p>
298		369
		370	<pre caption="Using sudo to run applications">
		371	<comment>(Editing the group file)</comment>
		372	# <i>sudo vi /etc/group</i>
		373	<comment>(Becoming root for a session)</comment>
		374	# <i>sudo su -</i>
		375	</pre>
		376
299	</body>	377	</body>
300	</subsection>	378	</subsection>
301	<subsection id="hardware">	379	<subsection id="hardware">
Lines 308-314 Link Here
308	vast majority of cases, it does a very good job. However, in some cases, it	386	vast majority of cases, it does a very good job. However, in some cases, it
309	may not auto-load the kernel modules you need. If the PCI auto-detection	387	may not auto-load the kernel modules you need. If the PCI auto-detection
310	missed some of your system's hardware, you will have to load the appropriate	388	missed some of your system's hardware, you will have to load the appropriate
311	kernel modules manually.	389	kernel modules manually. These tasks require root access.
312	</p>	390	</p>
313		391
314	<p>	392	<p>
Lines 336-344 Link Here
336		414
337	<p>	415	<p>
338	If you are an advanced user, you might want to tweak the IDE hard disk	416	If you are an advanced user, you might want to tweak the IDE hard disk
339	performance using <c>hdparm</c>. With the <c>-tT</c> options you can	417	performance using <c>hdparm</c>. You will need root access to use <c>hdparm</c>.
340	test the performance of your disk (execute it several times to get a	418	With the <c>-tT</c> options you can test the performance of your disk (execute
341	more precise impression):	419	it several times to get a more precise impression):
342	</p>	420	</p>
343		421
344	<pre caption="Testing disk performance">	422	<pre caption="Testing disk performance">
Lines 366-372 Link Here
366	If you plan on giving other people access to your installation	444	If you plan on giving other people access to your installation
367	environment or you want to chat using <c>irssi</c> without root privileges (for	445	environment or you want to chat using <c>irssi</c> without root privileges (for
368	security reasons), you need to create the necessary user accounts and change	446	security reasons), you need to create the necessary user accounts and change
369	the root password.	447	the root password. You need root access to change the root password and add new
		448	users.
370	</p>	449	</p>
371		450
372	<p>	451	<p>
Lines 374-379 Link Here
374	</p>	453	</p>
375		454
376	<pre caption="Changing the root password">	455	<pre caption="Changing the root password">
		456	$ <i>sudo su -</i>
377	# <i>passwd</i>	457	# <i>passwd</i>
378	New password: <comment>(Enter your new password)</comment>	458	New password: <comment>(Enter your new password)</comment>
379	Re-enter password: <comment>(Re-enter your password)</comment>	459	Re-enter password: <comment>(Re-enter your password)</comment>
Lines 401-406 Link Here
401	# <i>su - john</i>	481	# <i>su - john</i>
402	</pre>	482	</pre>
403		483
		484	<p>
		485	You can also change the password for the "gentoo" user in the graphical
		486	environment. This account is already suitable for use on the Internet.
		487	</p>
		488
		489	<pre caption="Changing the gentoo password">
		490	$ <i>passwd</i>
		491	New password: <comment>(Enter your new password)</comment>
		492	Re-enter password: <comment>(Re-enter your password)</comment>
		493	</pre>
		494
		495
404	</body>	496	</body>
405	</subsection>	497	</subsection>
406	<subsection>	498	<subsection>
Lines 450-456 Link Here
450	Gentoo installation (perhaps because those users are going to help you	542	Gentoo installation (perhaps because those users are going to help you
451	install Gentoo, or even do it for you), you need to create a user	543	install Gentoo, or even do it for you), you need to create a user
452	account for them and perhaps even provide them with your root password	544	account for them and perhaps even provide them with your root password
453	(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).	545	(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user). Starting the
		546	SSH daemon requires root access.
454	</p>	547	</p>
455		548
456	<p>	549	<p>