* [gentoo-doc-cvs] cvs commit: gentoo-x86-quickinstall.xml gentoo-x86+raid+lvm2-quickinstall.xml
@ 2006-05-27 13:16 Xavier Neys
0 siblings, 0 replies; 5+ messages in thread
From: Xavier Neys @ 2006-05-27 13:16 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 06/05/27 13:16:23
Modified: gentoo-x86-quickinstall.xml
Added: gentoo-x86+raid+lvm2-quickinstall.xml
Log:
#123290 New x86 quickinstall guide & a bonus one w/ softraid+lvm2
Revision Changes Path
1.52 xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml?rev=1.52&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml?rev=1.52&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml.diff?r1=1.51&r2=1.52&cvsroot=gentoo
Index: gentoo-x86-quickinstall.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v
retrieving revision 1.51
retrieving revision 1.52
diff -u -r1.51 -r1.52
--- gentoo-x86-quickinstall.xml 18 Feb 2006 19:26:05 -0000 1.51
+++ gentoo-x86-quickinstall.xml 27 May 2006 13:16:23 -0000 1.52
@@ -1,28 +1,69 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.51 2006/02/18 19:26:05 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.52 2006/05/27 13:16:23 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<guide link="/doc/en/gentoo-x86-quickinstall.xml">
+<guide link="/doc/en/gentoo-x86-quickinstall.xml" lang="en">
<title>Gentoo Linux x86 Quick Install Guide</title>
<author title="Author">
+ <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
+<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">Steven Wagner</author>
<abstract>
-The Quick install guide covers the Gentoo install process in a
-non-verbose manner. Users should already have prior experience with
-installing Gentoo Linux if they want to follow this guide.
+The Quick install guide covers the Gentoo install process in a non-verbose
+manner. Its purpose is to allow users to perform a stage3 install in no time.
+Users should already have prior experience with installing Gentoo Linux if they
+want to follow this guide.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2.10</version>
-<date>2006-02-18</date>
+<version>3</version>
+<date>2006-05-15</date>
+
+<chapter>
+<title>Introduction</title>
+<section>
+<body>
+
+<p>
+This guide contains all commands you should use to complete a stage3
+installation of Gentoo. You need a connection to the Internet to download the
+stage3 and Portage snapshots.
+</p>
+
+<p>
+Timing output follows all commands that take more than a couple of seconds to
+finish. Commands were timed on an AMD 2000 1.66 Ghz PC with 512 Mb of RAM and
+two SATA disks connected to a hardware controller.
+</p>
+
+<pre caption="Test box specs">
+<comment>(The following specs and the timing information should help you determine
+a rough estimate of the time you need to complete your install)</comment>
+
+# <i>grep bogo /proc/cpuinfo</i>
+bogomip : 3337.81
+
+# <i>hdparm -tT /dev/sda</i>
+/dev/sda:
+ Timing cached reads: 1100 MB in 2.00 seconds = 549.97 MB/sec
+ Timing buffered disk reads: 224 MB in 3.01 seconds = 74.36 MB/sec
+
+# <i>grep MemTotal /proc/meminfo</i>
+MemTotal: 509248 kB
+</pre>
+
+</body>
+</section>
+</chapter>
<chapter>
<title>Quick Install Guide</title>
@@ -32,25 +73,67 @@
<p>
Download a CD from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>.
-You can find the ISOs in
-<path>releases/<architecture>/<release>/installcd</path>. The
-<e>minimal</e> installation CD is only useful for Internet-based installations;
-with the <e>universal</e> installation CD you can perform a networkless
-installation as well.
+You can find the minimal CD ISO in
+<path>releases/x86/<release>/installcd</path> or the LiveCD ISO in
+<path>releases/x86/<release>/livecd</path>. The <e>minimal</e>
+installation CD is only useful for Internet-based installations. You can use
+the <e>LiveCD</e> to perform a networkless installation as documented in the
+<uri link="/doc/en/handbook/2006.0/handbook-x86.xml">2006.0 x86 installation
+handbook</uri>. The minimal CD is recommended.
</p>
<p>
-<uri link="/doc/en/faq.xml#isoburning">Burn</uri> the CD and boot it. Press
-<c>F2</c> at the boot screen to find out what boot options exist. Once booted,
-you need to start the <c>pcmcia</c> init script if you need PCMCIA support.
+<uri link="/doc/en/faq.xml#isoburning">Burn</uri> the CD and boot it.
</p>
+</body>
+</section>
+<section>
+<title>Booting the CD</title>
+<body>
+
<p>
-The installation CDs allow you to start an <c>sshd</c> server, add additional
-users, run <c>irssi</c> (a command-line chat client) and surf the web using
-<c>lynx</c> or <c>links</c>.
+Press
+<c>F2</c> at the boot screen to find out what boot options exist. You can
+either start <c>gentoo</c> or <c>gentoo-nofb</c>, the latter disables the
+framebuffer. If you booted the LiveCD, don't forget to add the <c>nox</c>
+option to prevent the X graphical environment from starting. Several options
+allow to enable or disable some features. If all goes well, your hardware will
+be detected and all modules will be loaded. If the kernel fails to boot
+properly or if your computer hangs during the boot procedure, you may have to
+experience with different configurations. The safest way is probably to use the
+<c>nodetect</c> option and then load required modules explicitely.
+</p>
+
+<pre caption="Boot the minimal CD">
+Gentoo Linux Installation LiveCD http://www.gentoo.org
+Enter to Boot; F1 for kernels F2 for options.
+boot: <i>gentoo-nofb</i>
+ <comment>(or in case of problems)</comment>
+boot: <i>gentoo-nofb nodetect</i>
+</pre>
+
+</body>
+</section>
+<section>
+<title>Optional: loading modules</title>
+<body>
+
+<p>
+If you used the <c>nodetect</c> option, once booted, load the required modules.
+You need to enable networking and have access to your disks. The <c>lspci</c>
+command can help you identify your hardware.
</p>
+<pre caption="Load required modules">
+livecd root # <i>lspci</i>
+<comment>(Use lspci's output to identify required modules)</comment>
+
+<comment>(The following is an example, adapt it to your hardware)</comment>
+livecd root # <i>modprobe 3w-9xxx</i>
+livecd root # <i>modprobe r8169</i>
+</pre>
+
</body>
</section>
<section>
@@ -77,6 +160,80 @@
<c>export http_proxy</c>, <c>ftp_proxy</c> and <c>RSYNC_PROXY</c>.
</p>
+<pre caption="Configure networking the guided way">
+livecd root # <i>net-setup eth0</i>
+</pre>
+
+<p>
+Alternatively, you can start networking manually. The following example assigns
+the IP addess 192.168.1.10 to your PC and defines 192.168.1.1 as your router
+and name server.
+</p>
+
+<pre caption="Configure networking the manual way">
+livecd root # <i>ifconfig eth0 192.168.1.10/24</i>
+livecd root # <i>route add default gw 192.168.1.1</i>
+livecd root # <i>echo nameserver 192.168.1.1 > /etc/resolv.conf</i>
+</pre>
+
+<p>
+The installation CD allows you to start an <c>sshd</c> server, add additional
+users, run <c>irssi</c> (a command-line chat client) and surf the web using
+<c>lynx</c> or <c>links</c>.
+</p>
+
+</body>
+</section>
+<section>
+<title>Optional: connect to your new box over ssh</title>
+<body>
+
+<p>
+The most interesting feature is of course <c>sshd</c>. You can start it and
+then connect from another machine and cut and paste commands from this guide.
+</p>
+
+<pre caption="Start sshd">
+livecd root # <i>time /etc/init.d/sshd start</i>
+ * Generating hostkey ...
+<comment>(sshd generates the key and displays more output)</comment>
+ * starting sshd ... [ok]
+
+real 0m13.688s
+user 0m9.420s
+sys 0m0.090s
+</pre>
+
+<p>
+Now, set the root password on the liveCD so that you can connect to it from
+another PC. Please note that allowing root to connect over ssh is not
+recommended under normal circumstances. If you can't trust your local network,
+use a long and complex password, you should use it only once as it will
+disappear after your first rebot.
+</p>
+
+<pre caption="Set the root password">
+livecd root # <i>passwd</i>
+New UNIX password: <comment>type_a_password</comment>
+Retype new UNIX password: <comment>type_a_password</comment>
+passwd: password updated successfully
+</pre>
+
+<p>
+Now, you can start a terminal on another PC and connect to your new box, follow
+the rest of this guide in another window, and cut and paste commands.
+</p>
+
+<pre caption="Connect to your new box from another PC">
+<comment>(Use the IP addess of your new box)</comment>
+$ <i>ssh root@192.168.1.10</i>
+The authenticity of host '192.168.1.10 (192.168.1.10)' can't be established.
+RSA key fingerprint is 96:e7:2d:12:ac:9c:b0:94:90:9f:40:89:b0:45:26:8f.
+Are you sure you want to continue connecting (yes/no)? <i>yes</i>
+Warning: Permanently added '192.168.1.10' (RSA) to the list of known hosts.
+Password: <comment>type_the_password</comment>
+</pre>
+
</body>
</section>
<section>
@@ -85,8 +242,28 @@
<p>
Use <c>fdisk</c> or <c>cfdisk</c> to create your partition layout. You need at
-least a swap partition (type 82) and one Linux partition (type 83).
-</p>
+least a swap partition (type 82) and one Linux partition (type 83). The
+following scenario creates a <path>/boot</path>, a swap and a main partition
+as used in our handbook. The device name is likely to be either
+<path>/dev/sda</path> for a SATA or SCSI disk, or <path>/dev/hda</path> for an
+IDE disk.
+</p>
+
+<pre caption="Create the partitions">
+livecd ~ # <i>fdisk /dev/sda</i>
+
+<comment>(The rest of this guide uses the following partitioning scheme)</comment>
+livecd ~ # <i>fdisk -l /dev/sda</i>
+
+Disk /dev/sda: 599.9 GB, 599978409984 bytes
+255 heads, 63 sectors/track, 72943 cylinders
+Units = cylinders of 16065 * 512 = 8225280 bytes
+
+ Device Boot Start End Blocks Id System
+/dev/sda1 1 12 96358+ 83 Linux
+/dev/sda2 13 110 787185 82 Linux swap / Solaris
+/dev/sda3 111 72943 585031072+ 83 Linux
+</pre>
<p>
Use <c>mke2fs</c>, <c>mke2fs -j</c>, <c>mkreiserfs</c>, <c>mkfs.xfs</c> and
@@ -94,12 +271,29 @@
swap partition using <c>mkswap</c> and <c>swapon</c>.
</p>
+<pre caption="Create the file systems and activate swap">
+<comment>(ext2 is all you need on the /boot partition)</comment>
+livecd ~ # <i>mke2fs /dev/sda1</i>
+
+<comment>(Let's use ext3 on the main partition)</comment>
+livecd ~ # <i>mke2fs -j -O dir_index /dev/sda3</i>
+
+<comment>(Create and activate swap)</comment>
+livecd ~ # <i>mkswap /dev/sda2 && swapon /dev/sda2</i>
+</pre>
+
<p>
Mount the freshly created file systems on <path>/mnt/gentoo</path>. Create
directories for the other mount points (like <path>/mnt/gentoo/boot</path>) if
-you need them.
+you need them and mount them too.
</p>
+<pre caption="Mount the file systems">
+livecd ~ # <i>mount /dev/sda3 /mnt/gentoo</i>
+livecd ~ # <i>mkdir /mnt/gentoo/boot</i>
+livecd ~ # <i>mount /dev/sda1 /mnt/gentoo/boot</i>
+</pre>
+
</body>
</section>
<section>
@@ -107,157 +301,232 @@
<body>
<p>
-First make sure your date is set correctly using <c>date MMDDhhmmYYYY</c>. Next,
-download a stage from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>
-or use the one available on the installation CD
-(<path>/mnt/cdrom/stages</path>). Go to <path>/mnt/gentoo</path> and unpack the
-stage using <c>tar -xvjpf <stage tarball></c>.
+First make sure your date and time is set correctly using <c>date
+MMDDhhmmYYYY</c>. Use UTC time.
</p>
-<p>
-Install a Portage snapshot if you are performing a networkless installation: go
-to <path>/mnt/gentoo/usr</path> and run
-<c>tar -xvjf /mnt/cdrom/snapshots/<snapshot></c>. Other users
-can download a portage snapshot and install it likewise.
-</p>
+<pre caption="Set the date and UTC time">
+<comment>(Check the clock)</comment>
+livecd ~ # <i>date</i>
+Mon Mar 6 00:14:13 UTC 2006
+
+<comment>(Set the current date and time if required)</comment>
+livecd ~ # <i>date 030600162006</i> <comment>(Format is MMDDhhmmYYYY)</comment>
+Mon Mar 6 00:16:00 UTC 2006
+</pre>
<p>
-For a networkless installation, copy over the source code files from
-<path>/mnt/cdrom/distfiles/</path> to
-<path>/mnt/gentoo/usr/portage/distfiles/</path>.
+Next, download a stage from one of our <uri
+link="/main/en/mirrors.xml">mirrors</uri>. Go to <path>/mnt/gentoo</path> and
+unpack the stage using <c>tar xjpf <stage3 tarball></c>.
</p>
+<pre caption="Download a stage3 archive">
+livecd ~ # <i>cd /mnt/gentoo</i>
+livecd gentoo # <i>links http://www.gentoo.org/main/en/mirrors.xml</i>
+<comment>(Pick a mirror, move to the releases/x86/current/stages directory
+highlight the stage3 of your choice, probably stage3-i686-2006.0.tar.bz2
+and press D to download it)</comment>
+
+<comment>(<b>Or</b> download it directly with wget without choosing a nearby mirror)</comment>
+livecd ~ # <i>cd /mnt/gentoo</i>
+livecd gentoo # <i>wget http://gentoo.osuosl.org/releases/x86/current/stages/stage3-i686-2006.0.tar.bz2</i>
+</pre>
+
+<pre caption="Unpack the stage3 archive">
+livecd gentoo # <i>time tar xjpf stage3*</i>
+
+real 1m13.157s
+user 1m2.920s
+sys 0m7.230s
+</pre>
+
<p>
-Edit <path>/mnt/gentoo/etc/make.conf</path> to suit your needs (USE flags,
-CFLAGS and CXXFLAGS). You can use the <c>nano</c> editor for this.
+Install the latest Portage snapshot. Proceed as for the stage3 archive: choose
+a nearby mirror from our <uri link="/main/en/mirrors.xml">list</uri>, download
+the latest snapshot and unpack it.
</p>
+<pre caption="Download the latest Portage snapshot">
+livecd gentoo # <i>cd /mnt/gentoo/usr</i>
+livecd usr # <i>links http://www.gentoo.org/main/en/mirrors.xml</i>
+<comment>(Pick a mirror, move to the snapshots/ directory,
+highlight <b>portage-latest.tar.bz2</b> and press D to download it)</comment>
+
+<comment>(<b>Or</b> download it directly with wget without choosing a nearby mirror)</comment>
+livecd gentoo # <i>cd /mnt/gentoo/usr</i>
+livecd usr # <i>wget http://gentoo.osuosl.org/snapshots/portage-latest.tar.bz2</i>
+</pre>
+
+<pre caption="Unpack the Portage snapshot">
+livecd usr # <i>time tar xjf portage*</i>
+
+real 0m51.523s
+user 0m28.680s
+sys 0m12.840s
+</pre>
+
</body>
</section>
<section>
-<title>Installing the Gentoo Base System</title>
+<title>Chrooting</title>
<body>
<p>
-Mount the <path>/proc</path> file system first, copy over the
-<path>/etc/resolv.conf</path> file and then chroot into your Gentoo
-environment.
+Mount the <path>/proc</path> file system, copy over the
+<path>/etc/resolv.conf</path> file, then chroot into your Gentoo environment.
</p>
-<pre caption="Preparing and chrooting">
-# <i>mount -t proc none /mnt/gentoo/proc</i>
-# <i>cp /etc/resolv.conf /mnt/gentoo/etc/</i>
-# <i>chroot /mnt/gentoo /bin/bash</i>
-# <i>env-update</i> && <i>source /etc/profile</i>
+<pre caption="Chroot">
+livecd usr # <i>cd /</i>
+livecd / # <i>mount -t proc proc /mnt/gentoo/proc</i>
+livecd / # <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/</i>
+livecd / # <i>chroot /mnt/gentoo /bin/bash</i>
+livecd / # <i>env-update && source /etc/profile</i>
+>>> Regenerating /etc/ld.so.cache...
</pre>
-<p>
-If you are not running a networkless installation, issue <c>emerge --sync</c> to
-update your Portage tree.
-</p>
+</body>
+</section>
+<section>
+<title>Set your timezone</title>
+<body>
<p>
-Next, make sure <path>/etc/make.profile</path> points to the right profile. The
-default one should suffice for most users; sub profiles are available for
-different kernels (like <path>2.4/</path> for 2.4-kernel based profiles). Change
-the profile using <c>ln -sfn</c>.
+Set your time zone information by copying the correct file from
+<path>/usr/share/zoneinfo</path> over the <path>/etc/localtime</path> file.
</p>
-<ul>
- <li>
- Bootstrapping (not available for networkless installations) happens using
- <c>scripts/bootstrap.sh</c> in the <path>/usr/portage</path> directory.
- </li>
- <li>
- System installation (not available for networkless installations) happens
- using <c>emerge -e system</c> (or <c>-N</c> if you haven't
- altered the default CFLAGS/CXXFLAGS).
- </li>
-</ul>
+<pre caption="Copy your timezone file">
+<comment>(Using Brussels as an example)</comment>
+livecd / # <i>cp /usr/share/zoneinfo/Europe/Brussels /etc/localtime</i>
+livecd / # <i>date</i>
+Wed Mar 8 00:46:05 CET 2006
+</pre>
</body>
</section>
<section>
-<title>Kernel Configuration</title>
+<title>Set your host and domain name</title>
<body>
<p>
-Set your time zone information by copying correct file from
-<path>/usr/share/zoneinfo</path> over the <path>/etc/localtime</path> file.
-</p>
-
-<p>
-Install a kernel source (<c>gentoo-sources</c> and <c>vanilla-sources</c> are
-available for networkless installations) and configure it using <c>make
-menuconfig</c> followed by
-<c>make && make modules_install</c> inside
-<path>/usr/src/linux</path>. Copy the <path>arch/i386/boot/bzImage</path> file
-over to <path>/boot</path>. You can also <c>emerge genkernel</c> and use
-<c>genkernel all</c>.
+Set your host name in <path>/etc/conf.d/hostname</path> and
+<path>/etc/hosts</path>. In the following example, we use <c>mybox</c> as host
+name and <c>at.myplace</c> as domain name. You can either edit the config
+files with <c>nano</c> or use the following commands:
</p>
-<p>
-Genkernel users will need to <c>emerge coldplug</c> and
-<c>rc-update add coldplug default</c>.
-</p>
+<pre caption="Set host and domain name">
+livecd / # <i>cd /etc</i>
+livecd etc # <i>echo "127.0.0.1 mybox.at.myplace mybox localhost" > hosts</i>
+livecd etc # <i>sed -i -e 's/HOSTNAME.*/HOSTNAME="mybox"/' conf.d/hostname</i>
+<comment>(Use defined host name and check)</comment>
+livecd etc # <i>hostname mybox</i>
+livecd etc # <i>hostname -f</i>
+mybox.at.myplace
+</pre>
</body>
</section>
<section>
-<title>Configuring the System</title>
+<title>Kernel Configuration</title>
<body>
<p>
-Edit your <path>/etc/fstab</path>; an example follows:
-</p>
+Install a kernel source (usually <c>gentoo-sources</c> or
+<c>vanilla-sources</c>), configure it, compile it and copy the
+<path>arch/i386/boot/bzImage</path> file to <path>/boot</path>.
+</p>
+
+<pre caption="Install a kernel source, compile it and install the kernel">
+livecd / # <i>time emerge gentoo-sources</i>
+
+real 2m51.435s
+user 0m58.220s
+sys 0m29.890s
+livecd / # <i>cd /usr/src/linux</i>
+livecd linux # <i>make menuconfig</i>
+<comment>(Configure your kernel)</comment>
+livecd linux # <i>time make -j2</i>
+
+<comment>(Elapsed time depends highly on the options you selected)</comment>
+real 3m51.962s
+user 3m27.060s
+sys 0m24.310s
-<pre caption="Example fstab">
-/dev/hda1 /boot ext2 defaults,noatime 1 2
-/dev/hda2 none swap sw 0 0
-/dev/hda3 / ext3 noatime 0 1
-none /proc proc defaults 0 0
-none /dev/shm tmpfs nodev,nosuid,noexec 0 0
-/dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0
+livecd linux # <i>make modules_install</i>
+livecd linux # <i>cp arch/i386/boot/bzImage /boot/kernel</i>
</pre>
-<p>
-Edit <path>/etc/conf.d/hostname</path> and <path>/etc/conf.d/domainname</path>,
-run <c>rc-update add domainname default</c> and edit
-<path>/etc/conf.d/net</path> to
-configure your network. Add the <c>net.eth0</c> init script to the default
-run level. If you have multiple NICs, symlink them to the <c>net.eth0</c>
-init script and add them to the default run level as well.
-</p>
+</body>
+</section>
+<section>
+<title>Configure the system</title>
+<body>
<p>
-Edit <path>/etc/hosts</path>; examples are given below:
+Edit your <path>/etc/fstab</path> and replace <c>BOOT</c>, <c>ROOT</c> and
+<c>SWAP</c> with the actual partition names. Don't forget to check that the
+file systems match your installation.
</p>
-<pre caption="Example /etc/hosts">
-<comment>(For static IPs)</comment>
-127.0.0.1 localhost
-192.168.0.5 jenny.homenetwork jenny
-192.168.0.6 benny.homenetwork benny
-192.168.0.7 tux.homenetwork tux
-
-<comment>(For a dynamic IP)</comment>
-127.0.0.1 localhost.homenetwork tux localhost
+<pre caption="Example fstab">
+livecd linux # <i>cd /etc</i>
+livecd etc # <i>nano -w fstab</i>
+/dev/<i>sda1</i> /boot ext2 noauto,noatime 1 2
+/dev/<i>sda3</i> / ext3 noatime 0 1
+/dev/<i>sda2</i> none swap sw 0 0
</pre>
<p>
+Configure your network in <path>/etc/conf.d/net</path>. Add the <c>net.eth0</c>
+init script to the default run level. If you have multiple NICs, symlink them
+to the <c>net.eth0</c> init script and add them to the default run level as
+well. Either edit <path>/etc/conf.d/net</path> with <c>nano</c> or use the
+following commands:
+</p>
+
+<pre caption="Configure networking">
+livecd etc # <i>cd conf.d</i>
+livecd conf.d # <i>echo 'config_eth0=( "192.168.1.10/24" )' >> net</i>
+livecd conf.d # <i>echo 'routes_eth0=( "default via 192.168.1.1" )' >> net</i>
+livecd conf.d # <i>rc-update add net.eth0 default</i>
+<comment>(If you compiled your network card driver as a module,
+add it to /etc/modules.autoload.d/kernel-2.6)</comment>
+livecd conf.d # <i>echo r8169 >> /etc/modules.autoload.d/kernel-2.6</i>
+<comment>(If you want to reconnect via ssh after you have rebooted your new box:)</comment>
+livecd conf.d # <i>rc-update add sshd default</i>
+</pre>
+
+<note>
Emerge <c>pcmcia-cs</c> and add it to the default run level if you need it.
-</p>
+</note>
<p>
Set the root password using <c>passwd</c>.
</p>
+<pre caption="Set the root password">
+livecd conf.d # <i>passwd</i>
+New UNIX password: <comment>type_the_password</comment>
+Retype new UNIX password: <comment>type_the_password_again</comment>
+passwd: password updated successfully
+</pre>
+
<p>
-Set the necessary system configuration in <path>/etc/rc.conf</path>,
+Check the system configuration in <path>/etc/rc.conf</path>,
<path>/etc/conf.d/rc</path>, <path>/etc/conf.d/keymaps</path>,
-<path>/etc/conf.d/clock</path>.
+<path>/etc/conf.d/clock</path> and edit any of those files if required.
</p>
+<pre caption="Optional: edit some config files">
+livecd conf.d # <i>nano -w /etc/rc.conf</i>
+livecd conf.d # <i>nano -w /etc/conf.d/rc</i>
+livecd conf.d # <i>nano -w /etc/conf.d/keymaps</i>
+livecd conf.d # <i>nano -w /etc/conf.d/clock</i>
+</pre>
+
</body>
</section>
<section>
@@ -265,20 +534,41 @@
<body>
<p>
-Users of a 2.4 kernel need to run <c>emerge --unmerge udev</c> and
-<c>emerge devfsd</c>.
+Install a system logger like <c>syslog-ng</c> and a cron daemon like
+<c>vixie-cron</c>, and add them to the default run level.
</p>
-<p>
-Install a system logger like <c>syslog-ng</c> and add it to the default
-run level. Do the same for a cron daemon like <c>vixie-cron</c> (optional).
-</p>
+<note>
+Cron daemons depend on an MTA. <c>mail-mta/ssmtp</c> will be pulled in as a
+dependency. If you want to use a more advanced MTA, you might want to install
+it now. If you are in a hurry, let ssmtp be installed and remove it later when
+you install the MTA of your choice.
+</note>
+
+<pre caption="Install a syslogger and a cron daemon">
+livecd conf.d # <i>time emerge syslog-ng vixie-cron</i>
+
+real 1m52.699s
+user 1m1.630s
+sys 0m35.220s
+livecd conf.d # <i>rc-update add syslog-ng default</i>
+livecd conf.d # <i>rc-update add vixie-cron default</i>
+</pre>
<p>
Install the necessary file system tools (<c>xfsprogs</c>, <c>reiserfsprogs</c>
-or <c>jfsutils</c>) and networking tools (<c>dhcpcd</c> or <c>rp-pppoe</c>).
+or <c>jfsutils</c>) and networking tools (<c>dhcpcd</c> or <c>rp-pppoe</c>) if
+you need any.
</p>
+<pre caption="Install extra tools if required">
+livecd conf.d # <i>emerge xfsprogs</i> <comment>(If you use the XFS file system)</comment>
+livecd conf.d # <i>emerge jfsutils</i> <comment>(If you use the JFS file system)</comment>
+livecd conf.d # <i>emerge reiserfsprogs</i> <comment>(If you use the Reiser file system)</comment>
+livecd conf.d # <i>emerge dhcpcd</i> <comment>(If you need a DHCP client)</comment>
+livecd conf.d # <i>USE="-X" emerge rp-pppoe</i> <comment>(If you need PPPoE ADSL connectivity)</comment>
+</pre>
+
</body>
</section>
<section>
@@ -286,90 +576,344 @@
<body>
<p>
-Emerge <c>grub</c> or <c>lilo</c>. Edit <path>/boot/grub/grub.conf</path> or
-<path>/etc/lilo.conf</path> to your likings. Below you will find an example for
-each.
+Emerge <c>grub</c> or <c>lilo</c>. Configure either
+<path>/boot/grub/grub.conf</path> or <path>/etc/lilo.conf</path> and install
+the bootloader you have emerged.
+</p>
+
+<p>
+<b>1. Using grub</b>
</p>
+<pre caption="Emerge grub and edit its configuration file">
+livecd conf.d # <i>time emerge grub</i>
+
+real 1m8.634s
+user 0m39.460s
+sys 0m15.280s
+livecd conf.d # <i>nano -w /boot/grub/grub.conf</i>
+</pre>
+
<pre caption="Example grub.conf">
default 0
-timeout 30
-splashimage=(hd0,0)/grub/splash.xpm.gz
+timeout 10
-<comment># genkernel users</comment>
-title=Gentoo Linux 2.6.11-r3
+title=Gentoo
root (hd0,0)
-kernel /kernel-genkernel-x86-2.6.11-gentoo-r3 root=/dev/ram0 init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev
-initrd /initramfs-genkernel-x86-2.6.11-gentoo-r3
+kernel /boot/kernel root=/dev/sda3
+</pre>
-<comment># non-genkernel users (no initrd)</comment>
-title=Gentoo Linux 2.6.11 r3
-root (hd0,0)
-kernel /kernel-2.6.11-gentoo-r3 root=/dev/hda3
+<pre caption="Install grub">
+livecd conf.d # <i>grub</i>
+Probing devices to guess BIOS drives. This may take a long time.
+
+grub> <i>root (hd0,0)</i>
+ Filesystem type is ext2fs, partition type 0x83
+
+grub> <i>setup (hd0)</i>
+ Checking if "/boot/grub/stage1" exists... yes
+ Checking if "/boot/grub/stage2" exists... yes
+ Checking if "/boot/grub/e2fs_stage1_5" exists... yes
+ Running "embed /boot/grub/e2fs_stage1_5 (hd0)"... 16 sectors are embedded.
+succeeded
+ Running "install /boot/grub/stage1 (hd0) (hd0)1+16 p (hd0,0)/boot/grub/stage2 /boot/
+grub/menu.lst"... succeeded
+Done.
+
+grub> <i>quit</i>
+</pre>
+
+<p>
+Now, proceed with the <uri link="#reboot">rebooting section</uri>.
+</p>
+
+<p>
+<b>2. Using lilo</b>
+</p>
-<comment># Only in case you want to dual-boot</comment>
-title=Windows XP
-root (hd0,5)
-makeactive
-chainloader +1
+<pre caption="Emerge lilo and edit its configuration file">
+livecd conf.d # <i>time emerge lilo</i>
+
+real 0m47.016s
+user 0m22.770s
+sys 0m5.980s
+livecd conf.d # <i>nano -w /etc/lilo.conf</i>
</pre>
<pre caption="Example lilo.conf">
-boot=/dev/hda
+boot=/dev/sda
prompt
timeout=50
default=gentoo
-<comment># For non-genkernel users</comment>
-image=/boot/kernel-2.6.11-gentoo-r3
- label=gentoo
+image=/boot/kernel
+ label=Gentoo
read-only
- root=/dev/hda3
+ root=/dev/sda3
+</pre>
-<comment># For genkernel users</comment>
-image=/boot/kernel-genkernel-x86-2.6.11-gentoo-r3
- label=gentoo
- read-only
- root=/dev/ram0
- append="init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev"
- initrd=/boot/initramfs-genkernel-x86-2.6.11-gentoo-r3
+<pre caption="Install lilo">
+livecd conf.d # <i>lilo</i>
+Added Gentoo *
+</pre>
+
+</body>
+</section>
+<section id="reboot">
+<title>Reboot</title>
+<body>
-<comment># For dual-booting</comment>
-other=/dev/hda6
- label=windows
+<p>
+Exit the chrooted environment, unmount all file systems and reboot:
+</p>
+
+<pre caption="Reboot">
+livecd conf.d # <i>exit</i>
+livecd / # <i>umount /mnt/gentoo/proc /mnt/gentoo/boot /mnt/gentoo</i>
+livecd / # <i>reboot</i>
+<comment>(Don't forget to remove the CD)</comment>
+</pre>
+
+</body>
+</section>
+<section id="after-reboot">
+<title>Finalizing the Installation</title>
+<body>
+
+<note>
+The <b>total</b> elapsed time between the display of the boot promt on the
+minimal CD and the display of the login promt after the reboot was
+<b>00:42:31</b> on our test box. Yes, less than one hour! Note that this time
+also includes the stage3, Portage snapshot and several packages download time
+and the time spent configuring the kernel.
+</note>
+
+<p>
+Log in as <c>root</c>, then add one or more users for daily use with
+<c>useradd</c>.
+</p>
+
+<pre caption="Connect to your new box from another PC">
+<comment>(Clean up your known_hosts file because your new box
+has generated a new definitive hostkey)</comment>
+$ <i>nano -w ~/.ssh/known_hosts</i>
+<comment>(Look for the IP of your new PC and delete the line,
+then save the file and exit nano)</comment>
+
+<comment>(Use the IP addess of your new box)</comment>
+$ <i>ssh root@192.168.1.10</i>
+The authenticity of host '192.168.1.10 (192.168.1.10)' can't be established.
+RSA key fingerprint is 96:e7:2d:12:ac:9c:b0:94:90:9f:40:89:b0:45:26:8f.
+Are you sure you want to continue connecting (yes/no)? <i>yes</i>
+Warning: Permanently added '192.168.1.10' (RSA) to the list of known hosts.
+Password: <comment>type_the_password</comment>
+</pre>
+
+<pre caption="Add a new user">
+mybox ~ # <i>adduser -g users -G lp,wheel,audio,cdrom,portage,cron -m john</i>
+mybox ~ # <i>passwd john</i>
+New UNIX password: <comment>Set John's password</comment>
+Retype new UNIX password: <comment>Type John's password again</comment>
+passwd: password updated successfully
+</pre>
+
+</body>
+</section>
+<section>
+<title>Last configuration touches</title>
+<body>
+
+<p>
+Start by selecting nearby mirrors either by defining the <c>RSYNC</c> and
+<c>GENTOO_MIRRORS</c> variables in <path>/etc/make.conf</path> or by using
+<c>mirrorselect</c>. You can also define the number of concurrent compilation
+processes at this point.
+</p>
+
+<pre caption="Use mirrorselect and set MAKEOPTS">
+mybox ~ # <i>emerge mirrorselect</i>
+mybox ~ # <i>mirrorselect -i -o >> /etc/make.conf</i>
+mybox ~ # <i>mirrorselect -i -r -o >> /etc/make.conf</i>
+<comment>(Usually, (the number of processors + 1) is a good value)</comment>
+mybox ~ # <i>echo 'MAKEOPTS="-j2"' >> /etc/make.conf</i>
+</pre>
+
+<p>
+Now is a good time to enable or disable some USE flags. Run <c>emerge -vpe</c>
+to list all currently installed packages and their enabled and disabled USE
+flags. Either edit <path>/etc/make.conf</path> or use the following command to
+define the USE variable:
+</p>
+
+<pre caption="View USE flags in use and enable or disable some">
+mybox ~ # <i>emerge -vpe world</i>
+<comment>(Portage displays the packages and their USE flags, as an example, let's
+disable ipv6 and fortran, and enable userlocales and unicode)</comment>
+mybox ~ # <i>echo 'USE="nptl nptlonly -ipv6 -fortran userlocales unicode"' >> /etc/make.conf</i>
</pre>
<p>
-GRUB users need to install GRUB in the MBR using
-<c>grub-install /dev/hda</c> after copying <path>/proc/mounts</path> to
-<path>/etc/mtab</path>. LILO users need to run <c>/sbin/lilo</c>.
+If you enabled the <c>userlocales</c> USE flag for versions of glibc that still
+support it, you should edit <path>/etc/locales.build</path> and define the
+locales you want to build.
</p>
<p>
-Exit the chrooted environment, unmount all file systems and reboot.
+Later versions of glibc ignore the userlocales USE flag and use
+<path>/etc/locale.gen</path> instead. If you are upgrading glibc to such a
+version, you should create <path>/etc/locale.gen</path> <e>and remove</e>
+<path>/etc/locales.build</path>. Check the output of <c>emerge -vpe world</c>
+to know whether glibc supports the userlocales USE flag.
</p>
+<pre caption="Define locales">
+mybox ~ # <i>cd /etc</i>
+<comment>(For versions of glibc with the userlocales USE flag)</comment>
+mybox etc # <i>nano -w locales.build</i>
+
+<comment>(For recent versions of glibc, convert locales.build)</comment>
+mybox etc # <i>grep '^[^#].*' locales.build | sed 's:/: :' >locale.gen</i>
+mybox etc # <i>rm locales.build</i>
+mybox etc # <i>nano -w locale.gen</i>
+</pre>
+
+<p>
+Last but not least, you may want to alter the <c>CFLAGS</c> variable in your
+<path>/etc/make.conf</path> to optimise the code to your specific needs. Please
+note that using a long list of flags is rarely needed and can even lead to a
+broken system. It is recommended to specify the processor type in the
+<c>march</c> option and stick to <c>-O2 -pipe</c>.
+</p>
+
+<p>
+You may also want to switch to <b>~x86</b>. You should only do this if you can
+deal with the odd broken ebuild or package. If you'd rather keep your system
+stable, don't add the <c>ACCEPT_KEYWORDS</c> variable. Adding
+<c>FEATURES="parallel-fetch ccache"</c> is also a good idea.
+</p>
+
+<note>
+At the time of writing, the ~x86 version of <c>portage</c> is significantly
+faster when updating its cache. Even if you stick to the x86 keyword, you might
+want to use the ~x86 version of Portage. Check the <uri
+link="/doc/en/handbook/handbook-x86.xml?part=3&chap=3#doc_chap2">Mixing
+Stable with Testing</uri> chapter if you forgot how to do this.
+</note>
+
+<pre caption="Last edit of make.conf">
+mybox etc # <i>nano -w make.conf</i>
+<comment>(Set -march to your CPU type in CFLAGS)</comment>
+CFLAGS="-O2 -march=<i>athlon-xp</i> -pipe"
+<comment>(Add the following line)</comment>
+FEATURES="parallel-fetch ccache"
+<comment>(Only add the following if you know what you're doing)</comment>
+ACCEPT_KEYWORDS="~x86"
+</pre>
+
+<p>
+You might want to recompile your whole system twice to make full use of your
+latest configuration changes. It would take quite a long time to complete and
+yield minimal speed benefits. It is recommended that you let your system
+optimise itself gradually over time when new versions of packages are
+released.
+</p>
+
+<p>
+Recompiling only the packages that have already been updated since the release
+or that are affected by your new USE flags will take enough time. You might
+also have to remove packages that block your upgrade. Look for "[blocks
+<brite>B</brite> ]" in the output of <c>emerge -vpuD --newuse world</c> and
+use <c>emerge -C</c> to remove them.
+</p>
+
+<pre caption="Update your packages">
+<comment>(Install ccache)</comment>
+mybox etc # <i>emerge ccache</i>
+
+<comment>(Please not that the switch to ~x86 causes many packages to be upgraded)</comment>
+mybox etc # <i>emerge -vpuD --newuse world</i>
+<comment>(Take a good look at the package list and their USE flags,
+remove blocking packages if any, and start the lengthy process)</comment>
+mybox etc # <i>time emerge -vuD --newuse world</i>
+<comment>(79 packages have been (re)compiled)</comment>
+
+real 180m13.276s
+user 121m22.905s
+sys 36m31.472s
+
+<comment>(Remerge libtool to avoid further potential problems)</comment>
+mybox etc # <i>emerge libtool</i>
+
+<comment>(Update config files, make sure you <b>do not</b> let etc-update
+update config files you have edited)</comment>
+mybox etc # <i>etc-update</i>
+
+<comment>(If perl has been updated, you should run the perl-cleaner script)</comment>
+mybox etc # <i>time perl-cleaner all</i>
+real 1m6.495s
+user 0m42.699s
+sys 0m10.641s
+
+<comment>(In case of a major upgrade of python, you should run the python-updater script)</comment>
+mybox etc # <i>python-updater</i>
+</pre>
+
</body>
</section>
<section>
-<title>Finalizing the Installation</title>
+<title>What to do next</title>
<body>
<p>
-Log in as <c>root</c>, then add one or more users for day-to-day use using
-<c>useradd -m -G <groups> <username></c>.
+Depending on what your new Gentoo machine is supposed to do, you will probably
+want to install server applications or a desktop system. Just as an example,
+<c>emerge gnome</c> and <c>emerge kde</c> have been timed on the ~x86 system
+installed as describe above. Both have been installed from the same starting
+point.
</p>
<p>
-If you performed a networkless installation, mount the packages CD at
-<path>/mnt/cdrom</path> and <c>export PKGDIR="/mnt/cdrom"</c> after which
-you can <c>emerge -k <package></c> to install additional
-software like <c>kde</c>.
+You should check our <uri link="/doc/en/">documentation index</uri> to find out
+how to install and configure the applications of your choice.
</p>
-<p>
-Thanks for installing Gentoo!
-</p>
+<impo>
+The following is only an example. It is in no way meant as a recommended setup.
+</impo>
+
+<pre caption="Emerge GNOME">
+mybox etc # <i>emerge -vp gnome</i>
+<comment>(Look at the list of packages and their USE flags,
+then edit make.conf if required.</comment>
+mybox etc # <i>nano -w /etc/make.conf</i>
+<comment>The following USE flags have been defined)</comment>
+USE="nptl nptlonly -ipv6 -fortran unicode svg hal dbus \
+ -kde -qt -arts -eds -esd gnome gstreamer gtk -xmms firefox"
+
+mybox etc # <i>time emerge gnome</i>
+<comment>(326 packages have been emerged)</comment>
+
+real 520m44.532s
+user 339m21.144s
+sys 146m22.337s
+</pre>
+
+<pre caption="Emerge KDE">
+mybox etc # <i>emerge -vp kde-meta</i>
+<comment>(Look at the list of packages and their USE flags,
+then edit make.conf if required.</comment>
+mybox etc # <i>nano -w /etc/make.conf</i>
+<comment>The following USE flags have been defined)</comment>
+USE="nptl nptlonly -ipv6 -fortran unicode svg hal dbus \
+ kde qt -arts -eds -esd -gnome -gstreamer -gtk -xmms -firefox"
+
+mybox etc # <i>time emerge kde-meta</i>
+<comment>(391 packages have been emerged)</comment>
+
+real 1171m25.318s
+user 851m26.393s
+sys 281m45.629s
+</pre>
</body>
</section>
1.1 xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: gentoo-x86+raid+lvm2-quickinstall.xml
===================================================================
<?xml version='1.0' encoding="UTF-8"?>
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml,v 1.1 2006/05/27 13:16:23 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml" lang="en">
<title>Gentoo Linux x86 with Software Raid and LVM2 Quick Install Guide</title>
<author title="Author">
<mail link="neysx@gentoo.org">Xavier Neys</mail>
</author>
<author title="Author">
<mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">Steven Wagner</author>
<abstract>
The Quick install guide covers the Gentoo install process in a non-verbose
manner. Its purpose is to allow users to perform a stage3 install with software
RAID and LVM2 in no time. Users should already have prior experience with
installing Gentoo Linux if they want to follow this guide.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>1</version>
<date>2006-05-03</date>
<chapter>
<title>Introduction</title>
<section>
<body>
<p>
This guide contains all commands you should use to complete a stage3
installation including LVM2 on top of software RAID. This guide is targetted at
experienced users. You need a connection to the Internet to download the stage3
and Portage snapshots.
</p>
<p>
Timing output follows all commands that take more than a couple of seconds to
finish. Commands were timed on an AMD 2000 1.66 Ghz PC with 512 Mb of RAM and
two SATA disks connected to a hardware controller configured as JBOD (i.e. two
separate hard disks are seen by Gentoo). If you have a "hardware" RAID
controller on your motherboard, it is most likely <b>not</b> a hardware
controller.
</p>
<pre caption="Test box specs">
<comment>(The following specs and the timing information should help you determine
a rough estimate of the time you need to complete your install)</comment>
# <i>grep bogo /proc/cpuinfo</i>
bogomip : 3337.81
# <i>hdparm -tT /dev/sda /dev/sdb</i>
/dev/sda:
reads: 1048 MB in 2.00 seconds = 524.00 MB/sec
Timing buffered disk reads: 152 MB in 3.01 seconds = 50.50 MB/sec
/dev/sdb:
Timing cached reads: 1048 MB in 2.00 seconds = 524.00 MB/sec
Timing buffered disk reads: 152 MB in 3.01 seconds = 50.50 MB/sec
# <i>grep MemTotal /proc/meminfo</i>
MemTotal: 509248 kB
</pre>
</body>
</section>
</chapter>
<chapter>
<title>Quick Install Guide</title>
<section>
<title>Installation Media</title>
<body>
<p>
Download a CD from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>.
You can find the minimal CD ISO in
<path>releases/x86/<release>/installcd</path> or the LiveCD ISO in
<path>releases/x86/<release>/livecd</path>. The <e>minimal</e>
installation CD is only useful for Internet-based installations. You can use
the <e>LiveCD</e> to perform a networkless installation as documented in the
<uri link="/doc/en/handbook/2006.0/handbook-x86.xml">2006.0 x86 installation
handbook</uri>. The minimal CD is recommended.
</p>
<p>
<uri link="/doc/en/faq.xml#isoburning">Burn</uri> the CD and boot it.
</p>
</body>
</section>
<section>
<title>Booting the CD</title>
<body>
<p>
Press
<c>F2</c> at the boot screen to find out what boot options exist. You can
either start <c>gentoo</c> or <c>gentoo-nofb</c>, the latter disables the
framebuffer. If you booted the LiveCD, don't forget to add the <c>nox</c>
option to prevent the X graphical environment from starting. Several options
allow to enable or disable some features. If all goes well, your hardware will
be detected and all modules will be loaded. If the kernel fails to boot
properly or if your computer hangs during the boot procedure, you may have to
experience with different configurations. The safest way is probably to use the
<c>nodetect</c> option and then load required modules explicitely.
</p>
<pre caption="Boot the minimal CD">
Gentoo Linux Installation LiveCD http://www.gentoo.org
Enter to Boot; F1 for kernels F2 for options.
boot: <i>gentoo-nofb</i>
<comment>(or in case of problems)</comment>
boot: <i>gentoo-nofb nodetect</i>
</pre>
</body>
</section>
<section>
<title>Optional: loading modules</title>
<body>
<p>
If you used the <c>nodetect</c> option, once booted, load the required modules.
You need to enable networking and have access to your disks. The <c>lspci</c>
command can help you identify your hardware.
</p>
<pre caption="Load required modules">
livecd root # <i>lspci</i>
<comment>(Use lspci's output to identify required modules)</comment>
<comment>(The following is an example, adapt it to your hardware)</comment>
livecd root # <i>modprobe 3w-9xxx</i>
livecd root # <i>modprobe r8169</i>
</pre>
</body>
</section>
<section>
<title>Network Configuration</title>
<body>
<p>
If your network does not work already, you can use <c>net-setup</c> to
configure your network. You might need to load support for your network card
using <c>modprobe</c> prior to the configuration. If you have ADSL, use
<c>adsl-setup</c> and <c>adsl-start</c>. If you are using an ADSL router, it
establishes the connection for you and you don't need to run those scripts. For
PPTP support, first edit <path>/etc/ppp/chap-secrets</path> and
<path>/etc/ppp/options.pptp</path> and then use <c>pptp
<server ip></c>.
</p>
<p>
For wireless access, use <c>iwconfig</c> to set the wireless parameters and then
use either <c>net-setup</c> again or run <c>ifconfig</c>, <c>dhcpcd</c> and/or
<c>route</c> manually.
</p>
<p>
If you are behind a proxy, do not forget to initialize your system using
<c>export http_proxy</c>, <c>ftp_proxy</c> and <c>RSYNC_PROXY</c>.
</p>
<pre caption="Configure networking the guided way">
livecd root # <i>net-setup eth0</i>
</pre>
<p>
Alternatively, you can start networking manually. The following example assigns
the IP addess 192.168.1.10 to your PC and defines 192.168.1.1 as your router
and name server.
</p>
<pre caption="Configure networking the manual way">
livecd root # <i>ifconfig eth0 192.168.1.10/24</i>
livecd root # <i>route add default gw 192.168.1.1</i>
livecd root # <i>echo nameserver 192.168.1.1 > /etc/resolv.conf</i>
</pre>
<p>
The installation CD allows you to start an <c>sshd</c> server, add additional
users, run <c>irssi</c> (a command-line chat client) and surf the web using
<c>lynx</c> or <c>links</c>.
</p>
</body>
</section>
<section>
<title>Optional: connect to your new box over ssh</title>
<body>
<p>
The most interesting feature is of course <c>sshd</c>. You can start it and
then connect from another machine and cut and paste commands from this guide.
</p>
<pre caption="Start sshd">
livecd root # <i>time /etc/init.d/sshd start</i>
* Generating hostkey ...
<comment>(sshd generates the key and displays more output)</comment>
* starting sshd ... [ok]
real 0m13.688s
user 0m9.420s
sys 0m0.090s
</pre>
<p>
Now, set the root password on the liveCD so that you can connect to it from
another PC. Please note that allowing root to connect over ssh is not
recommended under normal circumstances. If you can't trust your local network,
use a long and complex password, you should use it only once as it will
disappear after your first rebot.
</p>
<pre caption="Set the root password">
livecd root # <i>passwd</i>
New UNIX password: <comment>type_a_password</comment>
Retype new UNIX password: <comment>type_a_password</comment>
passwd: password updated successfully
</pre>
<p>
Now, you can start a terminal on another PC and connect to your new box, follow
the rest of this guide in another window, and cut and paste commands.
</p>
<pre caption="Connect to your new box from another PC">
<comment>(Use the IP addess of your new box)</comment>
$ <i>ssh root@192.168.1.10</i>
The authenticity of host '192.168.1.10 (192.168.1.10)' can't be established.
RSA key fingerprint is 96:e7:2d:12:ac:9c:b0:94:90:9f:40:89:b0:45:26:8f.
Are you sure you want to continue connecting (yes/no)? <i>yes</i>
Warning: Permanently added '192.168.1.10' (RSA) to the list of known hosts.
Password: <comment>type_the_password</comment>
</pre>
</body>
</section>
<section>
<title>Preparing the Disks</title>
<body>
<p>
Load the software RAID and LVM2 modules.
</p>
<pre caption="Load RAID and LVM2 modules">
livecd ~ # <i>modprobe raid0</i>
livecd ~ # <i>modprobe raid1</i>
<comment>(raid5, raid6 and raid10 are also available)</comment>
livecd ~ # <i>modprobe dm-mod</i>
</pre>
<p>
Use <c>fdisk</c> or <c>cfdisk</c> to create your partition layout. The device
names are likely to be either <path>/dev/sda</path> and <path>/dev/sdb</path>
for a SATA or SCSI disks, or <path>/dev/hda</path> and <path>/dev/hdb</path>
for IDE disks. The following layout will be used in this guide:
</p>
<table>
<tr>
<ti/>
<th><path>/dev/sda</path></th>
<th><path>/dev/sdb</path></th>
<th>Type</th>
</tr>
<tr>
<th><path>/dev/md1</path></th>
<th><path>/boot</path></th>
<th><path>/boot</path></th>
<ti>Raid-1 (mirroring)</ti>
</tr>
<tr>
<th/>
<th>swap</th>
<th>swap</th>
<ti>Normal partitions</ti>
</tr>
<tr>
<th><path>/dev/md3</path></th>
<th><path>/</path></th>
<th><path>/</path></th>
<ti>Raid-1 (mirroring)</ti>
</tr>
<tr>
<th><path>/dev/md4</path></th>
<th colspan="2">LVM2 volumes</th>
<ti>Raid-0 (striped)</ti>
</tr>
</table>
<note>
The partition you boot from must not be striped. It may not be raid-5 or
raid-0.
</note>
<note>
On the one hand, if you want extra stability, consider using raid-1 (or even
raid-5) for your swap partition(s) so that a drive failure would not corrupt
your swap space and crash applications that are using it. On the other hand, if
you want extra performance, just let the kernel use distinct swap partitions as
it does striping by default.
</note>
<pre caption="Create the partitions">
livecd ~ # <i>fdisk /dev/sda</i>
<comment>(Make sure you use type fd)</comment>
<comment>(The rest of this guide uses the following partitioning scheme)</comment>
livecd ~ # <i>fdisk -l /dev/sda</i>
Disk /dev/sda: 299.9 GB, 299989204992 bytes
255 heads, 63 sectors/track, 36471 cylinders
Units = cylinders of 16065 * 512 = 8225280 bytes
Device Boot Start End Blocks Id System
/dev/sda1 1 11 88326 fd Linux raid autodetect
/dev/sda2 12 61 401625 82 Linux swap / Solaris
/dev/sda3 62 311 2008125 fd Linux raid autodetect
/dev/sda4 312 36471 290455200 fd Linux raid autodetect
<comment>(Partition the second disk exactly as the first)</comment>
livecd ~ # <i>fdisk /dev/sdb</i>
</pre>
<p>
Then create the RAID device nodes and devices:
</p>
<pre caption="Create device nodes and devices">
livecd ~ # <i>mknod /dev/md1 b 9 1</i>
livecd ~ # <i>mknod /dev/md3 b 9 3</i>
livecd ~ # <i>mknod /dev/md4 b 9 4</i>
livecd ~ # <i>mdadm --create /dev/md1 --level=1 --raid-devices=2 /dev/sda1 /dev/sdb1</i>
mdadm: array /dev/md1 started.
livecd ~ # <i>mdadm --create /dev/md3 --level=1 --raid-devices=2 /dev/sda3 /dev/sdb3</i>
mdadm: array /dev/md3 started.
livecd ~ # <i>mdadm --create /dev/md4 --level=0 --raid-devices=2 /dev/sda4 /dev/sdb4</i>
mdadm: array /dev/md4 started.
<comment>(Wait until all units are ready)</comment>
livecd ~ # <i>cat /proc/mdstat</i>
Personalities : [raid0] [raid1]
md4 : active raid0 sdb4[1] sda4[0]
581006592 blocks 64k chunks
md3 : active raid1 sdb3[1] sda3[0]
1959808 blocks [2/2] [UU]
md1 : active raid1 sdb1[1] sda1[0]
88256 blocks [2/2] [UU]
</pre>
<p>
Then create the LVM2 volumes in <path>/dev/md4</path>. The following scheme is
used as an <b>example</b>:
</p>
<table>
<tr>
<th>Directory</th>
<th>Size</th>
<th>File system</th>
</tr>
<tr>
<ti>/usr</ti>
<ti>8 GB</ti>
<ti>ext3</ti>
</tr>
<tr>
<ti>/usr/portage</ti>
<ti>2 GB</ti>
<ti>ext2, small block size, many inodes</ti>
</tr>
<tr>
<ti>/usr/portage/distfiles</ti>
<ti>4 GB</ti>
<ti>ext2, large bock size, less inodes</ti>
</tr>
<tr>
<ti>/home</ti>
<ti>10 GB</ti>
<ti>ext3</ti>
</tr>
<tr>
<ti>/opt</ti>
<ti>4 GB</ti>
<ti>ext3</ti>
</tr>
<tr>
<ti>/var</ti>
<ti>4 GB</ti>
<ti>ext3</ti>
</tr>
<tr>
<ti>/var/tmp</ti>
<ti>6 GB</ti>
<ti>ext2</ti>
</tr>
<tr>
<ti>/tmp</ti>
<ti>2 GB</ti>
<ti>ext2</ti>
</tr>
</table>
<pre caption="Create LVM2 volumes">
livecd ~ # <i>vgscan</i>
Reading all physical volumes. This may take a while...
No volume groups found
livecd ~ # <i>vgchange -a y</i>
No volume groups found
<comment>(Create physical volumes, we have only one in our example)</comment>
livecd ~ # <i>pvcreate /dev/md4</i>
Physical volume "/dev/md4" successfully created
<comment>(Create volume groups, again, we have only one in our example)</comment>
livecd ~ # <i>vgcreate vg /dev/md4</i>
Volume group "vg" successfully created
<comment>(Create logical volumes)</comment>
livecd ~ # <i>lvcreate -L8G -nusr vg</i>
/dev/cdrom: open failed: Read-only file system
Logical volume "usr" created <comment>(Further similar messages not displayed)</comment>
livecd ~ # <i>lvcreate -L2G -nportage vg</i>
livecd ~ # <i>lvcreate -L4G -ndistfiles vg</i>
livecd ~ # <i>lvcreate -L10G -nhome vg</i>
livecd ~ # <i>lvcreate -L4G -nopt vg</i>
livecd ~ # <i>lvcreate -L4G -nvar vg</i>
livecd ~ # <i>lvcreate -L6G -nvartmp vg</i>
livecd ~ # <i>lvcreate -L2G -ntmp vg</i>
<comment>(Display volume groups and logical volumes)</comment>
livecd ~ # <i>vgs</i>
VG #PV #LV #SN Attr VSize VFree
vg 1 8 0 wz--n 554.09G 514.09G
livecd ~ # <i>lvs</i>
LV VG Attr LSize Origin Snap% Move Copy%
distfiles vg -wi-a- 4.00G
home vg -wi-a- 10.00G
opt vg -wi-a- 4.00G
portage vg -wi-a- 2.00G
tmp vg -wi-a- 2.00G
usr vg -wi-a- 8.00G
var vg -wi-a- 4.00G
vartmp vg -wi-a- 6.00G
</pre>
<p>
Use <c>mke2fs</c>, <c>mke2fs -j</c>, <c>mkreiserfs</c>, <c>mkfs.xfs</c> and
<c>mkfs.jfs</c> to create file systems. Initialize swap using <c>mkswap</c> and
<c>swapon</c>.
</p>
<pre caption="Create the file systems and activate swap">
<comment>(ext2 is all you need on the /boot partition)</comment>
livecd ~ # <i>mke2fs /dev/md1</i>
<comment>(Let's use ext3 on the root partition)</comment>
livecd ~ # <i>mke2fs -j -O dir_index /dev/md3</i>
<comment>(Create file systems on logical volumes)</comment>
livecd ~ # <i>mke2fs -b 4096 -T largefile /dev/vg/distfiles</i>
livecd ~ # <i>mke2fs -j -O dir_index /dev/vg/home</i>
livecd ~ # <i>mke2fs -j -O dir_index /dev/vg/opt</i>
livecd ~ # <i>mke2fs -b 1024 -N 200000 /dev/vg/portage</i>
livecd ~ # <i>mke2fs /dev/vg/tmp</i>
livecd ~ # <i>mke2fs -j -O dir_index /dev/vg/usr</i>
livecd ~ # <i>mke2fs -j -O dir_index /dev/vg/var</i>
livecd ~ # <i>mke2fs /dev/vg/vartmp</i>
<comment>(Create and activate swap)</comment>
livecd ~ # <i>mkswap /dev/sda2 && mkswap /dev/sdb2</i>
livecd ~ # <i>swapon -p 1 /dev/sda2 && swapon -p 1 /dev/sdb2</i>
<comment>(Check that all swap partitions use the same priority)</comment>
livecd ~ # <i>swapon -v -s</i>
Filename Type Size Used Priority
/dev/sda2 partition 401616 0 1
/dev/sdb2 partition 401616 0 1
</pre>
<p>
Mount the freshly created file systems on <path>/mnt/gentoo</path>. Create
directories for the other mount points and mount them too.
</p>
<pre caption="Mount the file systems">
livecd ~ # <i>mount /dev/md3 /mnt/gentoo</i>
livecd ~ # <i>cd /mnt/gentoo</i>
livecd gentoo # <i>mkdir boot home usr opt var tmp</i>
livecd gentoo # <i>mount /dev/md1 /mnt/gentoo/boot</i>
livecd gentoo # <i>mount /dev/vg/usr /mnt/gentoo/usr</i>
livecd gentoo # <i>mount /dev/vg/home /mnt/gentoo/home</i>
livecd gentoo # <i>mount /dev/vg/opt /mnt/gentoo/opt</i>
livecd gentoo # <i>mount /dev/vg/tmp /mnt/gentoo/tmp</i>
livecd gentoo # <i>mount /dev/vg/var /mnt/gentoo/var</i>
livecd gentoo # <i>mkdir usr/portage var/tmp</i>
livecd gentoo # <i>mount /dev/vg/vartmp /mnt/gentoo/var/tmp</i>
livecd gentoo # <i>mount /dev/vg/portage /mnt/gentoo/usr/portage</i>
livecd gentoo # <i>mkdir usr/portage/distfiles</i>
livecd gentoo # <i>mount /dev/vg/distfiles /mnt/gentoo/usr/portage/distfiles</i>
<comment>(Set proper perms on tmp directories)</comment>
livecd gentoo # <i>chmod 1777 /mnt/gentoo/tmp /mnt/gentoo/var/tmp</i>
</pre>
</body>
</section>
<section>
<title>Setting Up The Stage</title>
<body>
<p>
First make sure your date and time is set correctly using <c>date
MMDDhhmmYYYY</c>. Use UTC time.
</p>
<pre caption="Set the date and UTC time">
<comment>(Check the clock)</comment>
livecd gentoo # <i>date</i>
Mon Mar 6 00:14:13 UTC 2006
<comment>(Set the current date and time if required)</comment>
livecd gentoo # <i>date 030600162006</i> <comment>(Format is MMDDhhmmYYYY)</comment>
Mon Mar 6 00:16:00 UTC 2006
</pre>
<p>
Next, download a stage from one of our <uri
link="/main/en/mirrors.xml">mirrors</uri>. Go to <path>/mnt/gentoo</path> and
unpack the stage using <c>tar xjpf <stage3 tarball></c>.
</p>
<pre caption="Download a stage3 archive">
livecd gentoo # <i>links http://www.gentoo.org/main/en/mirrors.xml</i>
<comment>(Pick a mirror, move to the releases/x86/current/stages directory
highlight the stage3 of your choice, probably stage3-i686-2006.0.tar.bz2
and press D to download it)</comment>
<comment>(<b>Or</b> download it directly with wget without choosing a nearby mirror)</comment>
livecd gentoo # <i>wget http://gentoo.osuosl.org/releases/x86/current/stages/stage3-i686-2006.0.tar.bz2</i>
</pre>
<pre caption="Unpack the stage3 archive">
livecd gentoo # <i>time tar xjpf stage3*</i>
real 1m14.157s
user 1m2.920s
sys 0m7.530s
</pre>
<p>
Install the latest Portage snapshot. Proceed as for the stage3 archive: choose
a nearby mirror from our <uri link="/main/en/mirrors.xml">list</uri>, download
the latest snapshot and unpack it.
</p>
<pre caption="Download the latest Portage snapshot">
livecd gentoo # <i>cd /mnt/gentoo/usr</i>
livecd usr # <i>links http://www.gentoo.org/main/en/mirrors.xml</i>
<comment>(Pick a mirror, move to the snapshots/ directory,
highlight <b>portage-latest.tar.bz2</b> and press D to download it)</comment>
<comment>(<b>Or</b> download it directly with wget without choosing a nearby mirror)</comment>
livecd gentoo # <i>cd /mnt/gentoo/usr</i>
livecd usr # <i>wget http://gentoo.osuosl.org/snapshots/portage-latest.tar.bz2</i>
</pre>
<pre caption="Unpack the Portage snapshot">
livecd usr # <i>time tar xjf portage-lat*</i>
real 0m40.523s
user 0m28.280s
sys 0m8.240s
</pre>
</body>
</section>
<section>
<title>Chrooting</title>
<body>
<p>
Mount the <path>/proc</path> file system, copy over the
<path>/etc/resolv.conf</path> file, then chroot into your Gentoo environment.
</p>
<pre caption="Chroot">
livecd usr # <i>cd /</i>
livecd / # <i>mount -t proc proc /mnt/gentoo/proc</i>
livecd / # <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/</i>
livecd / # <i>chroot /mnt/gentoo /bin/bash</i>
livecd / # <i>env-update && source /etc/profile</i>
>>> Regenerating /etc/ld.so.cache...
</pre>
</body>
</section>
<section>
<title>Set your timezone</title>
<body>
<p>
Set your time zone information by copying the correct file from
<path>/usr/share/zoneinfo</path> over the <path>/etc/localtime</path> file.
</p>
<pre caption="Copy your timezone file">
<comment>(Using Brussels as an example)</comment>
livecd / # <i>cp /usr/share/zoneinfo/Europe/Brussels /etc/localtime</i>
livecd / # <i>date</i>
Wed Mar 8 00:46:05 CET 2006
</pre>
</body>
</section>
<section>
<title>Set your host name and domain name</title>
<body>
<p>
Set your host name in <path>/etc/conf.d/hostname</path> and
<path>/etc/hosts</path>. In the following example, we use
<c>mybox</c> as host name and <c>at.myplace</c> as domain name. You can either
edit the config files with <c>nano</c> or use the following commands:
</p>
<pre caption="Set host and domain name">
livecd / # <i>cd /etc</i>
livecd etc # <i>echo "127.0.0.1 mybox.at.myplace mybox localhost" > hosts</i>
livecd etc # <i>sed -i -e 's/HOSTNAME.*/HOSTNAME="mybox"/' conf.d/hostname</i>
<comment>(Use defined host name and check)</comment>
livecd etc # <i>hostname mybox</i>
livecd etc # <i>hostname -f</i>
mybox.at.myplace
</pre>
</body>
</section>
<section>
<title>Kernel Configuration</title>
<body>
<p>
Install a kernel source (usually <c>gentoo-sources</c> or
<c>vanilla-sources</c>), configure it, compile it and copy the
<path>arch/i386/boot/bzImage</path> file to <path>/boot</path>.
</p>
<pre caption="Install a kernel source, compile it and install the kernel">
livecd etc # <i>time emerge gentoo-sources</i>
real 3m3.110s
user 1m2.320s
sys 0m34.990s
livecd etc # <i>cd /usr/src/linux</i>
livecd linux # <i>make menuconfig</i>
<comment>(Configure your kernel as usual and
make sure you select the modules you need under raid and lvm)</comment>
Multi-device support (RAID and LVM) --->
[*] Multiple devices driver support (RAID and LVM)
<*> RAID support
< > Linear (append) mode (NEW)
<*> RAID-0 (striping) mode
<*> RAID-1 (mirroring) mode
< > RAID-10 (mirrored striping) mode (EXPERIMENTAL) (NEW)
< > RAID-4/RAID-5 mode (NEW)
< > RAID-6 mode (NEW)
< > Multipath I/O support (NEW)
< > Faulty test module for MD (NEW)
<*> Device mapper support
< > Crypt target support (NEW)
< > Snapshot target (EXPERIMENTAL) (NEW)
< > Mirror target (EXPERIMENTAL) (NEW)
< > Zero target (EXPERIMENTAL) (NEW)
< > Multipath target (EXPERIMENTAL) (NEW)
< > Bad Block Relocation Device Target (EXPERIMENTAL) (NEW)
livecd linux # <i>time make -j2</i>
<comment>(Elapsed time depends highly on the options you selected)</comment>
real 5m5.869s
user 4m32.320s
sys 0m32.930s
livecd linux # <i>make modules_install</i>
livecd linux # <i>cp arch/i386/boot/bzImage /boot/kernel</i>
</pre>
</body>
</section>
<section>
<title>Configure the system</title>
<body>
<p>
Edit your <path>/etc/fstab</path> and replace <c>BOOT</c>, <c>ROOT</c> and
<c>SWAP</c> with the actual partition names and add your logical volumes. Don't
forget to check that the file systems match your installation.
</p>
<pre caption="Example fstab">
livecd linux # <i>cd /etc</i>
livecd etc # <i>nano -w fstab</i>
/dev/<i>md1</i> /boot ext2 noauto,noatime 1 2
/dev/<i>md3</i> / ext3 noatime 0 1
/dev/<i>sda2</i> none swap sw,pri=1 0 0
/dev/<i>sdb2</i> none swap sw,pri=1 0 0
/dev/vg/usr /usr ext3 noatime 1 2
/dev/vg/portage /usr/portage ext2 noatime 1 2
/dev/vg/distfiles /usr/portage/distfiles ext2 noatime 1 2
/dev/vg/home /home ext3 noatime 1 2
/dev/vg/opt /opt ext3 noatime 1 2
/dev/vg/tmp /tmp ext2 noatime 1 2
/dev/vg/var /var ext3 noatime 1 2
/dev/vg/vartmp /var/tmp ext2 noatime 1 2
</pre>
<p>
Configure your network in <path>/etc/conf.d/net</path>. Add the <c>net.eth0</c>
init script to the default run level. If you have multiple NICs, symlink them
to the <c>net.eth0</c> init script and add them to the default run level as
well. Either edit <path>/etc/conf.d/net</path> with <c>nano</c> or use the
following commands:
</p>
<pre caption="Configure networking">
livecd etc # <i>cd conf.d</i>
livecd conf.d # <i>echo 'config_eth0=( "192.168.1.10/24" )' >> net</i>
livecd conf.d # <i>echo 'routes_eth0=( "default via 192.168.1.1" )' >> net</i>
livecd conf.d # <i>rc-update add net.eth0 default</i>
<comment>(If you compiled your network card driver as a module,
add it to /etc/modules.autoload.d/kernel-2.6)</comment>
livecd conf.d # <i>echo r8169 >> /etc/modules.autoload.d/kernel-2.6</i>
<comment>(If you want to reconnect via ssh after you have rebooted your new box)</comment>
livecd conf.d # <i>rc-update add sshd default</i>
</pre>
<note>
Emerge <c>pcmcia-cs</c> and add it to the default run level if you need it.
</note>
<p>
Set the root password using <c>passwd</c>.
</p>
<pre caption="Set the root password">
livecd conf.d # <i>passwd</i>
New UNIX password: <comment>type_the_password</comment>
Retype new UNIX password: <comment>type_the_password_again</comment>
passwd: password updated successfully
</pre>
<p>
Check the system configuration in <path>/etc/rc.conf</path>,
<path>/etc/conf.d/rc</path>, <path>/etc/conf.d/keymaps</path>,
<path>/etc/conf.d/clock</path> and edit any of those files if required.
</p>
<pre caption="Optional: edit some config files">
livecd conf.d # <i>nano -w /etc/rc.conf</i>
livecd conf.d # <i>nano -w /etc/conf.d/rc</i>
livecd conf.d # <i>nano -w /etc/conf.d/keymaps</i>
livecd conf.d # <i>nano -w /etc/conf.d/clock</i>
</pre>
</body>
</section>
<section>
<title>Installing System Tools</title>
<body>
<p>
Install RAID and LVM2 utilities.
</p>
<pre caption="Install RAID & LVM2 tools">
livecd conf.d # <i>emerge mdadm lvm2</i>
</pre>
<p>
Install a system logger like <c>syslog-ng</c> and a cron daemon like
<c>vixie-cron</c>, and add them to the default run level.
</p>
<note>
Cron daemons depend on an MTA. <c>mail-mta/ssmtp</c> will be pulled in as a
dependency. If you want to use a more advanced MTA, you might want to install
it now. If you are in a hurry, let ssmtp be installed and remove it later when
you install the MTA of your choice.
</note>
<pre caption="Install a syslogger and a cron daemon">
livecd conf.d # <i>time emerge syslog-ng vixie-cron</i>
real 1m54.099s
user 1m2.630s
sys 0m34.620s
livecd conf.d # <i>rc-update add syslog-ng default</i>
livecd conf.d # <i>rc-update add vixie-cron default</i>
</pre>
<p>
Install the necessary file system tools (<c>xfsprogs</c>, <c>reiserfsprogs</c>
or <c>jfsutils</c>) and networking tools (<c>dhcpcd</c> or <c>rp-pppoe</c>) if
you need any.
</p>
<pre caption="Install extra tools if required">
livecd conf.d # <i>emerge xfsprogs</i> <comment>(If you use the XFS file system)</comment>
livecd conf.d # <i>emerge jfsutils</i> <comment>(If you use the JFS file system)</comment>
livecd conf.d # <i>emerge reiserfsprogs</i> <comment>(If you use the Reiser file system)</comment>
livecd conf.d # <i>emerge dhcpcd</i> <comment>(If you need a DHCP client)</comment>
livecd conf.d # <i>USE="-X" emerge rp-pppoe</i> <comment>(If you need PPPoE ADSL connectivity)</comment>
</pre>
</body>
</section>
<section>
<title>Configuring the Bootloader</title>
<body>
<p>
Emerge <c>grub</c> and configure it.
</p>
<pre caption="Emerge grub and edit its configuration file">
livecd conf.d # <i>time emerge grub</i>
real 1m4.634s
user 0m39.460s
sys 0m15.280s
livecd conf.d # <i>nano -w /boot/grub/grub.conf</i>
</pre>
<pre caption="Example grub.conf">
default 0
timeout 10
title=Gentoo
root (hd0,0)
kernel /boot/kernel root=/dev/md3
</pre>
<pre caption="Install grub on both disks">
livecd conf.d # <i>grub</i>
Probing devices to guess BIOS drives. This may take a long time.
grub> <i>root (hd0,0)</i>
Filesystem type is ext2fs, partition type 0x83
grub> <i>setup (hd0)</i>
Checking if "/boot/grub/stage1" exists... yes
Checking if "/boot/grub/stage2" exists... yes
Checking if "/boot/grub/e2fs_stage1_5" exists... yes
Running "embed /boot/grub/e2fs_stage1_5 (hd0)"... 16 sectors are embedded.
succeeded
Running "install /boot/grub/stage1 (hd0) (hd0)1+16 p (hd0,0)/boot/grub/stage2 /boot/
grub/menu.lst"... succeeded
Done.
grub> <i>root (hd1,0)</i>
Filesystem type is ext2fs, partition type 0x83
grub> <i>setup (hd1)</i>
grub> <i>quit</i>
</pre>
</body>
</section>
<section>
<title>Reboot</title>
<body>
<p>
Exit the chrooted environment, unmount all file systems and reboot:
</p>
<pre caption="Reboot">
livecd conf.d # <i>exit</i>
livecd / # <i>umount /mnt/gentoo/usr/portage/distfiles /mnt/gentoo/usr/portage /mnt/gentoo/usr</i>
livecd / # <i>umount /mnt/gentoo/var/tmp /mnt/gentoo/tmp /mnt/gentoo/var /mnt/gentoo/opt</i>
livecd / # <i>umount /mnt/gentoo/proc /mnt/gentoo/home /mnt/gentoo/boot /mnt/gentoo</i>
livecd / # <i>reboot</i>
<comment>(Don't forget to remove the CD)</comment>
</pre>
<p>
Please follow the <uri
link="gentoo-x86-quickinstall.xml#after-reboot">Finalizing the
Installation</uri> part of the regular x86 quick setup guide to complete your
installation.
</p>
</body>
</section>
</chapter>
</guide>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-x86-quickinstall.xml gentoo-x86+raid+lvm2-quickinstall.xml
@ 2006-09-25 9:40 Xavier Neys
0 siblings, 0 replies; 5+ messages in thread
From: Xavier Neys @ 2006-09-25 9:40 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 06/09/25 09:40:44
Modified: gentoo-x86-quickinstall.xml
gentoo-x86+raid+lvm2-quickinstall.xml
Log:
Typo, reported by Chris Andrew by mail
Revision Changes Path
1.62 xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml?rev=1.62&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml?rev=1.62&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml?r1=1.61&r2=1.62
Index: gentoo-x86-quickinstall.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v
retrieving revision 1.61
retrieving revision 1.62
diff -u -r1.61 -r1.62
--- gentoo-x86-quickinstall.xml 16 Sep 2006 20:23:50 -0000 1.61
+++ gentoo-x86-quickinstall.xml 25 Sep 2006 09:40:44 -0000 1.62
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.61 2006/09/16 20:23:50 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.62 2006/09/25 09:40:44 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
@@ -101,7 +101,7 @@
allow to enable or disable some features. If all goes well, your hardware will
be detected and all modules will be loaded. If the kernel fails to boot
properly or if your computer hangs during the boot procedure, you may have to
-experience with different configurations. The safest way is probably to use the
+experiment with different configurations. The safest way is probably to use the
<c>nodetect</c> option and then load required modules explicitly.
</p>
1.6 xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml?rev=1.6&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml?rev=1.6&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml?r1=1.5&r2=1.6
Index: gentoo-x86+raid+lvm2-quickinstall.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- gentoo-x86+raid+lvm2-quickinstall.xml 4 Sep 2006 20:42:11 -0000 1.5
+++ gentoo-x86+raid+lvm2-quickinstall.xml 25 Sep 2006 09:40:44 -0000 1.6
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml,v 1.5 2006/09/04 20:42:11 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml,v 1.6 2006/09/25 09:40:44 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
@@ -109,7 +109,7 @@
allow to enable or disable some features. If all goes well, your hardware will
be detected and all modules will be loaded. If the kernel fails to boot
properly or if your computer hangs during the boot procedure, you may have to
-experience with different configurations. The safest way is probably to use the
+experiment with different configurations. The safest way is probably to use the
<c>nodetect</c> option and then load required modules explicitly.
</p>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-x86-quickinstall.xml gentoo-x86+raid+lvm2-quickinstall.xml
@ 2007-02-15 16:18 Xavier Neys
0 siblings, 0 replies; 5+ messages in thread
From: Xavier Neys @ 2007-02-15 16:18 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 07/02/15 16:18:21
Modified: gentoo-x86-quickinstall.xml
gentoo-x86+raid+lvm2-quickinstall.xml
Log:
-O dir_index should not have been removed
Revision Changes Path
1.68 xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml?rev=1.68&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml?rev=1.68&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml?r1=1.67&r2=1.68
Index: gentoo-x86-quickinstall.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v
retrieving revision 1.67
retrieving revision 1.68
diff -u -r1.67 -r1.68
--- gentoo-x86-quickinstall.xml 29 Nov 2006 15:48:57 -0000 1.67
+++ gentoo-x86-quickinstall.xml 15 Feb 2007 16:18:21 -0000 1.68
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.67 2006/11/29 15:48:57 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.68 2007/02/15 16:18:21 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
@@ -25,8 +25,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>10</version>
-<date>2006-11-02</date>
+<version>11</version>
+<date>2007-02-15</date>
<chapter>
<title>Introduction</title>
@@ -276,7 +276,7 @@
livecd ~ # <i>mke2fs /dev/sda1</i>
<comment>(Let's use ext3 on the main partition)</comment>
-livecd ~ # <i>mke2fs -j /dev/sda3</i>
+livecd ~ # <i>mke2fs -j -O dir_index /dev/sda3</i>
<comment>(Create and activate swap)</comment>
livecd ~ # <i>mkswap /dev/sda2 && swapon /dev/sda2</i>
1.10 xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml?rev=1.10&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml?rev=1.10&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml?r1=1.9&r2=1.10
Index: gentoo-x86+raid+lvm2-quickinstall.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- gentoo-x86+raid+lvm2-quickinstall.xml 29 Nov 2006 15:48:57 -0000 1.9
+++ gentoo-x86+raid+lvm2-quickinstall.xml 15 Feb 2007 16:18:21 -0000 1.10
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml,v 1.9 2006/11/29 15:48:57 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml,v 1.10 2007/02/15 16:18:21 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
@@ -25,8 +25,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4</version>
-<date>2006-10-18</date>
+<version>5</version>
+<date>2007-02-15</date>
<chapter>
<title>Introduction</title>
@@ -471,16 +471,16 @@
livecd ~ # <i>mke2fs /dev/md1</i>
<comment>(Let's use ext3 on the root partition)</comment>
-livecd ~ # <i>mke2fs -j /dev/md3</i>
+livecd ~ # <i>mke2fs -j -O dir_index /dev/md3</i>
<comment>(Create file systems on logical volumes)</comment>
livecd ~ # <i>mke2fs -b 4096 -T largefile /dev/vg/distfiles</i>
-livecd ~ # <i>mke2fs -j /dev/vg/home</i>
-livecd ~ # <i>mke2fs -j /dev/vg/opt</i>
+livecd ~ # <i>mke2fs -j -O dir_index /dev/vg/home</i>
+livecd ~ # <i>mke2fs -j -O dir_index /dev/vg/opt</i>
livecd ~ # <i>mke2fs -b 1024 -N 200000 /dev/vg/portage</i>
livecd ~ # <i>mke2fs /dev/vg/tmp</i>
-livecd ~ # <i>mke2fs -j /dev/vg/usr</i>
-livecd ~ # <i>mke2fs -j /dev/vg/var</i>
+livecd ~ # <i>mke2fs -j -O dir_index /dev/vg/usr</i>
+livecd ~ # <i>mke2fs -j -O dir_index /dev/vg/var</i>
livecd ~ # <i>mke2fs /dev/vg/vartmp</i>
<comment>(Create and activate swap)</comment>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-x86-quickinstall.xml gentoo-x86+raid+lvm2-quickinstall.xml
@ 2007-04-11 10:17 Xavier Neys
0 siblings, 0 replies; 5+ messages in thread
From: Xavier Neys @ 2007-04-11 10:17 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 07/04/11 10:17:50
Modified: gentoo-x86-quickinstall.xml
gentoo-x86+raid+lvm2-quickinstall.xml
Log:
Made quick guides consistent, fixed prompts and time zone setting
Revision Changes Path
1.73 xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml?rev=1.73&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml?rev=1.73&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml?r1=1.72&r2=1.73
Index: gentoo-x86-quickinstall.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v
retrieving revision 1.72
retrieving revision 1.73
diff -u -r1.72 -r1.73
--- gentoo-x86-quickinstall.xml 10 Apr 2007 19:37:05 -0000 1.72
+++ gentoo-x86-quickinstall.xml 11 Apr 2007 10:17:50 -0000 1.73
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.72 2007/04/10 19:37:05 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.73 2007/04/11 10:17:50 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
@@ -25,8 +25,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>15</version>
-<date>2007-04-10</date>
+<version>16</version>
+<date>2007-04-11</date>
<chapter>
<title>Introduction</title>
@@ -78,7 +78,7 @@
<path>releases/x86/<release>/livecd</path>. The <e>minimal</e>
installation CD is only useful for Internet-based installations. You can use
the <e>LiveCD</e> to perform a networkless installation as documented in the
-<uri link="/doc/en/handbook/2006.1/handbook-x86.xml">2006.1 x86 installation
+<uri link="/doc/en/handbook/2007.0/handbook-x86.xml">2007.0 x86 installation
handbook</uri>. The minimal CD is recommended.
</p>
@@ -324,13 +324,12 @@
<pre caption="Download a stage3 archive">
livecd ~ # <i>cd /mnt/gentoo</i>
livecd gentoo # <i>links http://www.gentoo.org/main/en/mirrors.xml</i>
-<comment>(Pick a mirror, move to the releases/x86/current/stages directory
-highlight the stage3 of your choice, probably stage3-i686-2006.1.tar.bz2
-and press D to download it)</comment>
+<comment>(Pick a mirror, move to the releases/x86/current/stages directory highlight the
+stage3 of your choice, probably the i686 stage3 and press D to download it)</comment>
<comment>(<b>Or</b> download it directly with wget without choosing a nearby mirror)</comment>
livecd ~ # <i>cd /mnt/gentoo</i>
-livecd gentoo # <i>wget http://gentoo.osuosl.org/releases/x86/current/stages/stage3-i686-2006.1.tar.bz2</i>
+livecd gentoo # <i>wget ftp://gentoo.osuosl.org/pub/gentoo/releases/x86/current/stages/stage3-i686*tar.bz2</i>
</pre>
<pre caption="Unpack the stage3 archive">
@@ -389,19 +388,17 @@
</body>
</section>
<section>
-<title>Set your timezone</title>
+<title>Set your time zone</title>
<body>
<p>
-Set your time zone information by setting the timezone listing from
-<path>/usr/share/zoneinfo</path> in <path>/etc/conf.d/clock</path>.
+Set your time zone information by copying the correct file from
+<path>/usr/share/zoneinfo</path> over the <path>/etc/localtime</path> file.
</p>
<pre caption="Setting your timezone">
-<comment>(Using CET as an example)</comment>
-livecd / # <i>nano -w /etc/conf.d/clock</i>
-TIMEZONE="CET"
-
+<comment>(Using Brussels as an example)</comment>
+livecd / # <i>cp /usr/share/zoneinfo/Europe/Brussels /etc/localtime</i>
livecd / # <i>date</i>
Wed Mar 8 00:46:05 CET 2006
</pre>
@@ -516,16 +513,25 @@
</pre>
<p>
-Check the system configuration in <path>/etc/rc.conf</path>,
-<path>/etc/conf.d/rc</path>, <path>/etc/conf.d/keymaps</path>,
-<path>/etc/conf.d/clock</path> and edit any of those files if required.
+Edit <path>/etc/conf.d/clock</path> to define the time zone you used
+previously.
+</p>
+
+<pre caption="Edit /etc/conf.d/clock">
+livecd conf.d # <i>nano -w /etc/conf.d/clock</i>
+TIMEZONE="Europe/Brussels"
+</pre>
+
+<p>
+Check the system configuration in <path>/etc/rc.conf</path>,
+<path>/etc/conf.d/rc</path>, <path>/etc/conf.d/keymaps</path> and edit any of
+those files if required.
</p>
<pre caption="Optional: edit some config files">
livecd conf.d # <i>nano -w /etc/rc.conf</i>
livecd conf.d # <i>nano -w /etc/conf.d/rc</i>
livecd conf.d # <i>nano -w /etc/conf.d/keymaps</i>
-livecd conf.d # <i>nano -w /etc/conf.d/clock</i>
</pre>
</body>
@@ -759,8 +765,8 @@
</p>
<pre caption="Define locales">
-mybox # <i>cd /etc</i>
-mybox # <i>nano -w locale.gen</i>
+mybox ~ # <i>cd /etc</i>
+mybox etc # <i>nano -w locale.gen</i>
</pre>
<p>
1.12 xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml?rev=1.12&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml?rev=1.12&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml?r1=1.11&r2=1.12
Index: gentoo-x86+raid+lvm2-quickinstall.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- gentoo-x86+raid+lvm2-quickinstall.xml 26 Feb 2007 08:58:04 -0000 1.11
+++ gentoo-x86+raid+lvm2-quickinstall.xml 11 Apr 2007 10:17:50 -0000 1.12
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml,v 1.11 2007/02/26 08:58:04 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml,v 1.12 2007/04/11 10:17:50 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
@@ -25,8 +25,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>6</version>
-<date>2007-02-26</date>
+<version>7</version>
+<date>2007-04-11</date>
<chapter>
<title>Introduction</title>
@@ -86,7 +86,7 @@
<path>releases/x86/<release>/livecd</path>. The <e>minimal</e>
installation CD is only useful for Internet-based installations. You can use
the <e>LiveCD</e> to perform a networkless installation as documented in the
-<uri link="/doc/en/handbook/2006.1/handbook-x86.xml">2006.1 x86 installation
+<uri link="/doc/en/handbook/2007.0/handbook-x86.xml">2007.0 x86 installation
handbook</uri>. The minimal CD is recommended.
</p>
@@ -547,12 +547,11 @@
<pre caption="Download a stage3 archive">
livecd gentoo # <i>links http://www.gentoo.org/main/en/mirrors.xml</i>
-<comment>(Pick a mirror, move to the releases/x86/current/stages directory
-highlight the stage3 of your choice, probably stage3-i686-2006.1.tar.bz2
-and press D to download it)</comment>
+<comment>(Pick a mirror, move to the releases/x86/current/stages directory highlight the
+stage3 of your choice, probably the i686 stage3 and press D to download it)</comment>
<comment>(<b>Or</b> download it directly with wget without choosing a nearby mirror)</comment>
-livecd gentoo # <i>wget http://gentoo.osuosl.org/releases/x86/current/stages/stage3-i686-2006.1.tar.bz2</i>
+livecd gentoo # <i>wget ftp://gentoo.osuosl.org/pub/gentoo/releases/x86/current/stages/stage3-i686*tar.bz2</i>
</pre>
<pre caption="Unpack the stage3 archive">
@@ -611,7 +610,7 @@
</body>
</section>
<section>
-<title>Set your timezone</title>
+<title>Set your time zone</title>
<body>
<p>
@@ -766,16 +765,25 @@
</pre>
<p>
+Edit <path>/etc/conf.d/clock</path> to define the time zone you used
+previously.
+</p>
+
+<pre caption="Edit /etc/conf.d/clock">
+livecd conf.d # <i>nano -w /etc/conf.d/clock</i>
+TIMEZONE="Europe/Brussels"
+</pre>
+
+<p>
Check the system configuration in <path>/etc/rc.conf</path>,
-<path>/etc/conf.d/rc</path>, <path>/etc/conf.d/keymaps</path>,
-<path>/etc/conf.d/clock</path> and edit any of those files if required.
+<path>/etc/conf.d/rc</path>, <path>/etc/conf.d/keymaps</path> and edit any of
+those files if required.
</p>
<pre caption="Optional: edit some config files">
livecd conf.d # <i>nano -w /etc/rc.conf</i>
livecd conf.d # <i>nano -w /etc/conf.d/rc</i>
livecd conf.d # <i>nano -w /etc/conf.d/keymaps</i>
-livecd conf.d # <i>nano -w /etc/conf.d/clock</i>
</pre>
</body>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 5+ messages in thread
* [gentoo-doc-cvs] cvs commit: gentoo-x86-quickinstall.xml gentoo-x86+raid+lvm2-quickinstall.xml
@ 2007-05-08 8:00 Xavier Neys
0 siblings, 0 replies; 5+ messages in thread
From: Xavier Neys @ 2007-05-08 8:00 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 07/05/08 08:00:27
Modified: gentoo-x86-quickinstall.xml
gentoo-x86+raid+lvm2-quickinstall.xml
Log:
Redo previous fixes
Revision Changes Path
1.75 xml/htdocs/doc/en/gentoo-x86-quickinstall.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml?rev=1.75&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml?rev=1.75&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml?r1=1.74&r2=1.75
Index: gentoo-x86-quickinstall.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v
retrieving revision 1.74
retrieving revision 1.75
diff -u -r1.74 -r1.75
--- gentoo-x86-quickinstall.xml 7 May 2007 18:11:40 -0000 1.74
+++ gentoo-x86-quickinstall.xml 8 May 2007 08:00:27 -0000 1.75
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.74 2007/05/07 18:11:40 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.75 2007/05/08 08:00:27 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
@@ -25,8 +25,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>17</version>
-<date>2007-05-07</date>
+<version>18</version>
+<date>2007-05-08</date>
<chapter>
<title>Introduction</title>
@@ -172,7 +172,7 @@
<pre caption="Configure networking the manual way">
livecd root # <i>ifconfig eth0 192.168.1.10/24</i>
-livecd root # <i>route add default via 192.168.1.1</i>
+livecd root # <i>route add default gw 192.168.1.1</i>
livecd root # <i>echo nameserver 192.168.1.1 > /etc/resolv.conf</i>
</pre>
@@ -399,8 +399,7 @@
<pre caption="Setting your timezone">
livecd / # <i>ls /usr/share/zoneinfo</i>
<comment>(Using Brussels as an example)</comment>
-livecd / # <i>nano -w /etc/conf.d/clock</i>
-TIMEZONE="Europe/Brussels"
+livecd / # <i>cp /usr/share/zoneinfo/Europe/Brussels /etc/localtime</i>
livecd / # <i>date</i>
Wed Mar 8 00:46:05 CET 2006
@@ -516,6 +515,16 @@
</pre>
<p>
+Edit <path>/etc/conf.d/clock</path> to define the time zone you used
+previously.
+</p>
+
+<pre caption="Edit /etc/conf.d/clock">
+livecd conf.d # <i>nano -w /etc/conf.d/clock</i>
+TIMEZONE="Europe/Brussels"
+</pre>
+
+<p>
Check the system configuration in <path>/etc/rc.conf</path>,
<path>/etc/conf.d/rc</path>, <path>/etc/conf.d/keymaps</path> and edit any of
those files if required.
@@ -562,11 +571,11 @@
</p>
<pre caption="Install extra tools if required">
-livecd conf.d # <i>emerge xfsprogs</i> <comment>(If you use the XFS file system)</comment>
-livecd conf.d # <i>emerge jfsutils</i> <comment>(If you use the JFS file system)</comment>
-livecd conf.d # <i>emerge reiserfsprogs</i> <comment>(If you use the Reiser file system)</comment>
-livecd conf.d # <i>emerge dhcpcd</i> <comment>(If you need a DHCP client)</comment>
-livecd conf.d # <i>emerge ppp</i> <comment>(If you need PPPoE ADSL connectivity)</comment>
+livecd conf.d # <i>emerge xfsprogs</i> <comment>(If you use the XFS file system)</comment>
+livecd conf.d # <i>emerge jfsutils</i> <comment>(If you use the JFS file system)</comment>
+livecd conf.d # <i>emerge reiserfsprogs</i> <comment>(If you use the Reiser file system)</comment>
+livecd conf.d # <i>emerge dhcpcd</i> <comment>(If you need a DHCP client)</comment>
+livecd conf.d # <i>emerge ppp</i> <comment>(If you need PPPoE ADSL connectivity)</comment>
</pre>
</body>
1.14 xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml?rev=1.14&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml?rev=1.14&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml?r1=1.13&r2=1.14
Index: gentoo-x86+raid+lvm2-quickinstall.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- gentoo-x86+raid+lvm2-quickinstall.xml 7 May 2007 18:11:40 -0000 1.13
+++ gentoo-x86+raid+lvm2-quickinstall.xml 8 May 2007 08:00:27 -0000 1.14
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml,v 1.13 2007/05/07 18:11:40 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86+raid+lvm2-quickinstall.xml,v 1.14 2007/05/08 08:00:27 neysx Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
@@ -25,8 +25,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>8</version>
-<date>2007-05-07</date>
+<version>9</version>
+<date>2007-05-08</date>
<chapter>
<title>Introduction</title>
@@ -182,7 +182,7 @@
<pre caption="Configure networking the manual way">
livecd root # <i>ifconfig eth0 192.168.1.10/24</i>
-livecd root # <i>route add default via 192.168.1.1</i>
+livecd root # <i>route add default gw 192.168.1.1</i>
livecd root # <i>echo nameserver 192.168.1.1 > /etc/resolv.conf</i>
</pre>
@@ -621,8 +621,7 @@
<pre caption="Setting your timezone">
livecd / # <i>ls /usr/share/zoneinfo</i>
<comment>(Using Brussels as an example)</comment>
-livecd / # <i>nano -w /etc/conf.d/clock</i>
-TIMEZONE="Europe/Brussels"
+livecd / # <i>cp /usr/share/zoneinfo/Europe/Brussels /etc/localtime</i>
livecd / # <i>date</i>
Wed Mar 8 00:46:05 CET 2006
@@ -768,6 +767,16 @@
</pre>
<p>
+Edit <path>/etc/conf.d/clock</path> to define the time zone you used
+previously.
+</p>
+
+<pre caption="Edit /etc/conf.d/clock">
+livecd conf.d # <i>nano -w /etc/conf.d/clock</i>
+TIMEZONE="Europe/Brussels"
+</pre>
+
+<p>
Check the system configuration in <path>/etc/rc.conf</path>,
<path>/etc/conf.d/rc</path>, <path>/etc/conf.d/keymaps</path> and edit any of
those files if required.
@@ -822,11 +831,11 @@
</p>
<pre caption="Install extra tools if required">
-livecd conf.d # <i>emerge xfsprogs</i> <comment>(If you use the XFS file system)</comment>
-livecd conf.d # <i>emerge jfsutils</i> <comment>(If you use the JFS file system)</comment>
-livecd conf.d # <i>emerge reiserfsprogs</i> <comment>(If you use the Reiser file system)</comment>
-livecd conf.d # <i>emerge dhcpcd</i> <comment>(If you need a DHCP client)</comment>
-livecd conf.d # <i>emerge ppp</i> <comment>(If you need PPPoE ADSL connectivity)</comment>
+livecd conf.d # <i>emerge xfsprogs</i> <comment>(If you use the XFS file system)</comment>
+livecd conf.d # <i>emerge jfsutils</i> <comment>(If you use the JFS file system)</comment>
+livecd conf.d # <i>emerge reiserfsprogs</i> <comment>(If you use the Reiser file system)</comment>
+livecd conf.d # <i>emerge dhcpcd</i> <comment>(If you need a DHCP client)</comment>
+livecd conf.d # <i>emerge ppp</i> <comment>(If you need PPPoE ADSL connectivity)</comment>
</pre>
</body>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2007-05-08 8:00 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2007-02-15 16:18 [gentoo-doc-cvs] cvs commit: gentoo-x86-quickinstall.xml gentoo-x86+raid+lvm2-quickinstall.xml Xavier Neys
-- strict thread matches above, loose matches on Subject: below --
2007-05-08 8:00 Xavier Neys
2007-04-11 10:17 Xavier Neys
2006-09-25 9:40 Xavier Neys
2006-05-27 13:16 Xavier Neys
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox