Attachment 18408 Details for Bug 29649 – Here is the html output of the previously attached GuideXML file.

Here is the html output of the previously attached GuideXML file.

install.html (text/html), 21.43 KB, created by Steven Wagner on 2003-09-27 20:20:48 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Steven Wagner

Created: 2003-09-27 20:20:48 UTC

Size: 21.43 KB

patch

obsolete

><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
><html>
><head>
><meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
><link title="new" rel="stylesheet" href="/css/main.css" type="text/css">
><link REL="shortcut icon" HREF="http://www.gentoo.org/favicon.ico" TYPE="image/x-icon">
><title>Gentoo Linux 
>  Documentation
>-- 
>  Gentoo Linux Install Reference</title>
></head>
><body style="margin-left:0px;margin-top:0px;" bgcolor="#ffffff"><table width="100%" border="0" cellspacing="0" cellpadding="0">
><tr><td valign="top" height="125" bgcolor="#45347b"><table cellspacing="0" cellpadding="0" border="0" width="193">
><tr><td class="logobg" valign="top" align="center" height="88"><a href="/"><img border="0" src="/images/gtop-s.jpg" alt="Gentoo Logo"></a></td></tr>
><tr><td class="logobg" valign="top" align="center" height="36"><a href="/"><img border="0" src="/images/gbot-s.gif" alt="Gentoo Logo Side"></a></td></tr>
></table></td></tr>
><tr><td valign="top" align="right" colspan="1" bgcolor="#ffffff"><table border="0" cellspacing="0" cellpadding="0" width="100%"><tr>
><td width="99%" class="content" valign="top" align="left">
><br><p class="dochead">Gentoo Linux Install Reference</p>
><form name="contents" action="http://www.gentoo.org">
><b>Contents</b>:
>    <select name="url" size="1" OnChange="location.href=form.url.options[form.url.selectedIndex].value" style="font-family:Arial,Helvetica, sans-serif; font-size:10"><option value="#doc_chap1">1. Introduction</option>
><option value="#doc_chap2">2. Beginning settings</option>
><option value="#doc_chap3">3. File system, and basic system files</option>
><option value="#doc_chap4">4. Kernel and customizing system</option>
><option value="#doc_chap5">5. Finishing off and installing GUI</option>
><option value="#doc_chap6">6. End Notes</option></select>
></form>
><p class="chaphead">
><span class="chapnum"><a name="doc_chap1">1. </a></span>Introduction</p>
>The 2-CD installation set is available on our mirrors. To
>see what 2-CD set is right for you, read the detailed descriptions
>of each product in the store.
>CD1 is a full bootable Gentoo Linux environment that can be used to
>install the full Gentoo Linux on your machine. CD 1 contains
>everything you need to install Gentoo Linux quickly and without a
>connection to the Internet. Several pre-compiled packages are also
>included on CD 1, such as the XFree86 X server. CD2 is optional and
>isn't bootable. It has pre-compiled packages such as KDE,
>GNOME, OpenOffice, Mozilla, Evolution and more.
><p class="chaphead">
><span class="chapnum"><a name="doc_chap2">2. </a></span>Beginning settings</p>
><a name="doc_chap2_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
>            Code listing 2.1</p></td></tr>
><tr><td bgcolor="#ddddff"><pre>
>(Start by booting your Live CD1. You should see a fancy boot screen with the Gentoo Linux logo on it.)
>(Hit &lt;ENTER&gt;.  You would include dopcmcia or doataraid here.  Hit F2-F3 if you have a RAID or PCMCIA laptop setup.)
>(You will now see an even fancier boot screen.)
>(Next you will see the root ("#") prompt on the console.)
>(Here we go.)
>
># date  (To check if you date is correct.)
># date 022709042003   (If date is wrong, set it with  date MMDDhhmmCCYY )
>
>(Optional, now is the time to load any network or scsi drivers using modprobe.)
># modprobe aic7xxx    (replace aic7xxx with your module)
>
>(Check for network connectivity)
># ping -c 3 www.yahoo.com 
>
>(If it didn't work you can use this utility, or visit the <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap4">Optional Networking</a> section of the full install guide.)
># net-setup eth0
>or
># dhcpcd eth0
>
>(Disk Paritioning) (Here was assume you know the basics about drive paritioning.  
>If not, see the full install <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap6">Disk Partitioning</a> guide.)
>
><table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#bbffbb"><p class="note">
><b>Note: </b>
>(Use fdisk, cfdisk, parted or partimage to partition your drive now.  I recommend a 64 meg boot volume with ext3,
> a swap partition twice the size of your available RAM (2 Gig limit), and the rest for your root partition using ReiserFS.)
></p></td></tr></table></pre></td></tr>
></table>
>
><table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#ffffbb"><p class="note">
><b>Important: </b>You should not save or make any changes to a disk's partition table if any of its partitions
>contain filesystems that are in use or contain important data. Doing so will generally cause data on the disk to be lost.
></p></td></tr></table>
>
><p class="chaphead">
><span class="chapnum"><a name="doc_chap3">3. </a></span>File system, and basic system files</p>
><a name="doc_chap3_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
>            Code listing 3.1</p></td></tr>
><tr><td bgcolor="#ddddff"><pre>
>(Now initialize your partitions) (NOTE: Substitute in your proper parition numbers)
># mkswap /dev/hdax      (for making swap filesystems)
># mke2fs /dev/hdax      (for making ext2 filesystems)
># mke2fs -j /dev/hdax   (for making ext3 filesystems)
># mkreiserfs /dev/hdax  (for making reiserfs filesystems)
># mkfs.xfs /dev/hdax    (for making xfs filesystems)
># mkfs.jfs /dev/hdax    (for making jfs filesystems)
>
>(Mount the partitions)
># swapon /dev/hdax              (substitute your swap partition here)
># mount /dev/hdax /mnt/gentoo   (substitute your root partition here)
># mkdir /mnt/gentoo/boot
># mount /dev/hdax /mnt/gentoo/boot   (substitute your boot partition here)(mount with -o notail if reiserfs here)
>
>(Unpack the files) 
># ls /mnt/cdrom/stages/   (to see what is available on your CD)
># cd /mnt/gentoo
># tar -xvjpf /mnt/cdrom/stages/stage3-*.tar.bz2   (Change to the stage # you are using.)
>(OR you can download the latest tarball online, but its not really necessary)
># cd /mnt/gentoo    
># lynx http://gentoo.oregonstate.edu/releases/x86/1.4/
>
>(Copy the rest of the packages off of CD1 that we will use later)
># tar -xvjf /mnt/cdrom/snapshots/portage-yyyymmdd.tar.bz2 -C /mnt/gentoo/usr   (Replace yyyymmdd with the actual filename.)
># cp -R /mnt/cdrom/distfiles /mnt/gentoo/usr/portage/distfiles
># cp -a /mnt/cdrom/packages /mnt/gentoo/usr/portage/packages
>
>(Optional, run mirrorselect if you want to change the defaults)
># mirrorselect -a -s4 -o &gt;&gt; /mnt/gentoo/etc/make.conf   (To select a mirror automatically)
># mirrorselect -i -o &gt;&gt; /mnt/gentoo/etc/make.conf       (To select a mirror interactively)
>
>(Entering the chroot environment)
># mount -t proc proc /mnt/gentoo/proc
># cp /etc/resolv.conf /mnt/gentoo/etc/resolv.conf
># chroot /mnt/gentoo /bin/bash
># env-update
># source /etc/profile
>
>(Updating using sync) (Optional, can be skipped. Checks for updates on the files we already copied.)
># emerge sync 
>
>(Stage 1 install only) (We highly recommend Stage 1 and 2 installs use the <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap10">Full Instructions</a> on the full install guide.)
># nano -w /etc/make.conf
># cd /usr/portage
># scripts/bootstrap.sh   (Bootstrapping, takes long time.)
>
>(Now Stage 2 only, stage 1 continued)
># emerge system    (This takes a long time, which is why some prefer starting at stage3)
>
>(Now Stage 3 starts here)
>(Optional, to bring your config files inline with the latest updates before we start changing stuff)
># cp /etc/make.conf /etc/make.conf.backup  (Backup your make.conf first)
># CONFIG_PROTECT="-*" emerge -u system     (This says its okay to overwrite files)
># cp /etc/make.conf.backup /etc/make.conf  (Restore the make.conf)
>
>(Time zone configuration)
>(Look for your time zone in /usr/share/zoneinfo and then use that for the following command.)
># ln -sf /usr/share/zoneinfo/path/to/timezonefile /etc/localtime
>
>(Setup your /etc/fstab)
>#nano -w /etc/fstab
>
></pre></td></tr>
></table>
>
><a name="doc_chap3_pre2"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
>            Code listing 3.2: /etc/fstab</p></td></tr>
><tr><td bgcolor="#ddddff"><pre>
># example /etc/fstab: static file system information.
># noatime turns off atimes for increased performance (atimes normally aren't
># needed; notail increases performance of ReiserFS (at the expense of storage
># efficiency).  It's safe to drop the noatime options if you want and to
># switch between notail and tail freely.
>
># &lt;fs&gt;                  &lt;mountpoint&gt;    &lt;type&gt;          &lt;opts&gt;                  &lt;dump/pass&gt;
>
># NOTE: Be sure to set the block devices and the filesystem types correctly.
># NOTE: If your BOOT partition is ReiserFS, add the notail option to opts.
>/dev/hdax               /boot           ext3            noauto,noatime          1 2
>/dev/hdax               /               reiserfs        noatime                 0 1
>/dev/hdax               none            swap            sw                      0 0
>/dev/cdroms/cdrom0      /mnt/cdrom      iso9660         noauto,ro,user          0 0
>
># NOTE: The next line is critical for boot!
>none                    /proc           proc            defaults                0 0
># glibc 2.2 and above expects tmpfs to be mounted at /dev/shm for
>none                    /dev/shm        tmpfs           defaults                0 0
>
>#Example windows configs
>/dev/hdax               /mnt/dosc       ntfs            ro,noatime,umask=0222    0 0
>/dev/hdax               /mnt/dosd       vfat            noatime          0 0
>
></pre></td></tr>
></table>
>
><p class="chaphead">
><span class="chapnum"><a name="doc_chap4">4. </a></span>Kernel and customizing system</p>
><a name="doc_chap4_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
>            Code listing 4.1</p></td></tr>
><tr><td bgcolor="#ddddff"><pre>
>(Configuring your kernel using genkernel)
>(NOTE: Gentoo provides several kernel ebuilds; a list can be found <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml">here</a>. We advise using gentoo-sources.)
># emerge -k sys-kernel/gentoo-sources
># emerge -k genkernel
># genkernel   (--config to change kernel options)
>( Write down the names of the kernel and initrd that are given to you after its done.  You will need it later.)
>
>(OR manual kernel configuration)
>(since a manual kernel build has many more details, please see the <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap16">Kernel Section</a> of the full install guide.)
># cd /usr/src/linux
># make menuconfig
>( A few things required for Gentoo are - Virtual memory file system support, /proc file system support,
>  /dev file system support * /dev file system Automatically mount at boot. )
># make dep &amp;&amp; make clean bzImage modules modules_install
># cp /usr/src/linux/arch/i386/boot/bzImage /boot
>
>(Finishing system install)
># emerge -k app-admin/sysklogd   (This is your System Logger. You can also use syslog-ng, metalog, or msyslog.  See <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap16">Full</a> instructions.)
># rc-update add sysklogd default   (rc-update configures what daemons load at boot)
># emerge -k sys-apps/vcron       (This is your CRON Daemon.  You can also use dcron or fcron if you like. See <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap16">Full</a> instructions.)
># rc-update add vcron default   
># emerge -k hotplug              (This detects any hardware that initrd does not detect)
># rc-update add hotplug default
>
>(Optional, install any file system tools you will need)
># emerge -k reiserfsprogs  (or xfsprogs, jfsutils, lvm-user)
>
>(Optional, install modules for any additional hardware)
># emerge -k nvidia-kernel   (or nforce-net, nforce-audio, 
>(intel cards are e100, e1000
>
># emerge -k pcmcia-cs  (This is for laptop users who need PCMCIA.)
># emerge -K rp-pppoe            (For PPPoE, but you still have to do adsl-setup after you boot your system the first time.)
># emerge e100                   (Intel e100 Fast Ethernet Adapters)
># emerge e1000                  (Intel e1000 Gigabit Ethernet Adapters)
># emerge emu10k1                (Creative Sound Blaster Live!/Audigy support)
># emerge ati-drivers            (Accelerated ATI Radeon 8500+/FireGL graphics for XFree86)
># VIDEO_CARDS="yourcard" emerge xfree-drm   (Accelerated graphics for ATI Radeon up to 9200, Rage128, Matrox, Voodoo and other cards)
>
>(Add the names of any modules you need to load after boot to /etc/modules.autoload.d/kernel-2.4 file)
># nano -w /etc/modules.autoload.d/kernel-2.4  (Only needed if you had to modprobe earlier.)
>
>(User Management)
># passwd   (Set the root password.)
># useradd your_user -m -G users,wheel,audio -s /bin/bash   (Now create your own user.)
># passwd your_user   (&amp; set the password.)
>
># echo mymachine &gt; /etc/hostname           (substitute your hostname)
># echo mydomain.com &gt; /etc/dnsdomainname   (substitute your domainname, or skip)
># nano -w /etc/hosts                       (Add your actual hostname to /etc/hosts so GNOME doesn't complain)
># nano -w /etc/conf.d/net                  (Don't skip this DHCP usersppen at boot.)
># rc-update add net.eth0 default   (This starts your network at boot)(not pcmcia though)
>
>(Optional, use this code if you have more then one network adapter)
># ln -s /etc/init.d/net.eth0 /etc/init.d/net.ethx
># rc-update add net.ethx default  
>
>(Optional for laptops, have a quick look into /etc/init.d/pcmcia to verify that things seem all right.)
># rc-update add pcmcia boot   (This takes care of any PCMCIA cards and network starting for PCMCIA network cards.)
>
>(Basic configuration)
># nano -w /etc/rc.conf  (Follow the directions in this file to configure basic settings.)
>
>(Install your GRUB bootloader) (Use the <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap23">Boot Loader</a> section of the full install guide if you would like LILO.)
><table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#bbffbb"><p class="note">
><b>Note: </b>GRUB counts hard drives from zero rather than "a" and partitions start at zero rather than one.
>Only hard drives are counted, not atapi-ide devices. So the syntax is first integer indicates the drive number,
>while the second integer indicates the partition number. Once again, please note that the partition numbers
>are counted from zero, not from one. Your Linux partition /dev/hda1 is called (hd0,0) under GRUB.
>Grub also has TAB completion)
></p></td></tr></table>
># emerge -k grub
># grub
>
>(Install the GRUB boot record on to your hard drive's MBR (master boot record))
>grub&gt; root (hd0,0)   (Tells GRUB the location of your boot boot partition.  /dev/hda1 is used here)
>grub&gt; setup (hd0)    (Install grub onto your MBR)
>grub&gt; quit
>
>(for ATA RAID setups, you also need this commmand)
>grub&gt; setup --stage2=/boot/grub/stage2 (hd0)
>
>(Create the grub.conf file)
># nano -w /boot/grub/grub.conf
>
></pre></td></tr>
></table>
>
><a name="doc_chap4_pre2"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
>            Code listing 4.2: grub.conf</p></td></tr>
><tr><td bgcolor="#ddddff"><pre>
># example grub.conf
># (Here is where you use the output from genkernel that you wrote down earlier.
>#  Sustitute it where is says KV.  Also, (hd0,0) should point to your boot partition
>#  which is /dev/hda1 in our example and /dev/hda3 should point to your root filesystem.
>#  (hd0,5) contains the NT bootloader for windows users.
>#  NOTE: The path to the kernel image is relative to the boot partition.
>
>default 0
>timeout 30
>fallback 1
>splashimage=(hd0,0)/grub/splash.xpm.gz
>
>title=My example Gentoo Linux (genkernel)
>root (hd0,0)
>kernel (hd0,0)/kernel-KV root=/dev/hda3
>initrd (hd0,0)/initrd-KV
>
># Below needed only for people who dual-boot
>title=Windows XP
>root (hd0,5) 
>chainloader (hd0,5)+1
>
># Below is an example for RAID setups
>title=Gentoo Linux on RAID
>root (hd0,0)
>kernel (hd0,0)/boot/bzImage root=/dev/ataraid/dXpY
>
></pre></td></tr>
></table>
>
><p class="chaphead">
><span class="chapnum"><a name="doc_chap5">5. </a></span>Finishing off and installing GUI</p>
><a name="doc_chap5_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
><tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
>            Code listing 5.1</p></td></tr>
><tr><td bgcolor="#ddddff"><pre>
># etc-update
># exit
># cd /
># umount /mnt/gentoo/boot
># umount /mnt/gentoo/proc
># umount /mnt/gentoo
># reboot   (Don't forget to remove the bootable CD)
>
>(Wait for system to come back up)
>(Optional, Load binary packages from CD2)
># mount /dev/cdrom /mnt/cdrom
># cp -a /mnt/cdrom/packages/* /usr/portage/packages/
>
># emerge -k xfree   (XFree was copied off of CD1 earlier if you were wondering)
># emerge -k gnome   (or kde) 
># /usr/X11R6/bin/xf86config  
>(It is now recommend that you go onto the <a href="http://www.gentoo.org/doc/en/desktop.xml">Desktop Configuration guide</a> for additional info.)
></pre></td></tr>
></table>
>
><p class="chaphead">
><span class="chapnum"><a name="doc_chap6">6. </a></span>End Notes</p>
><p>Now go onto the <a href="http://www.gentoo.org/doc/en/desktop.xml">Desktop configuration
>guide</a> that will help you to continue configuring your new
>Gentoo Linux system.
>Check out the <a href="http://www.gentoo.org/doc/en/portage-user.xml">Portage user
>guide</a> to help familiarize you with Portage basics.
>For more information on starting programs and daemons at startup,
>see the <a href="file:///doc/en/rc-scripts.xml">rc-script
>guide</a>.
>If you have any other questions involving installation or anything
>for that matter, please check the Gentoo Linux <a href="http://www.gentoo.org/doc/en/faq.xml">FAQ</a>.
>You can find the rest of the Gentoo Documentation <a href="http://www.gentoo.org/main/en/docs.xml">here</a>.
></p>
><br><pre>
>  The contents of this document are licensed under the <a href="http://creativecommons.org/licenses/by-sa/1.0">Creative Commons - Attribution / Share Alike</a> license.
></pre>
><br>
></td>
><td width="1%" bgcolor="#dddaec" valign="top"><table border="0" cellspacing="5" cellpadding="0">
><tr><td><img src="/images/line.gif" alt="line"></td></tr>
><tr><td align="center" class="alttext">
>                  Updated 27 Sep 2003</td></tr>
><tr><td><img src="/images/line.gif" alt="line"></td></tr>
><tr><td class="alttext">Steven Wagner<br><i>Chief Architect</i><br><br>
></td></tr>
><tr><td><img src="/images/line.gif" alt="line"></td></tr>
><tr><td class="alttext">
><b>Summary:</b>Â 
>This is the abstract.  It is abstract.
></td></tr>
><tr><td><img src="/images/line.gif" alt="line"></td></tr>
><tr><td align="center">
><p class="alttext">
><b>Donate</b> to support our development efforts.
>                  </p>
><form action="https://www.paypal.com/cgi-bin/webscr" method="post">
><input type="hidden" name="cmd" value="_xclick"><input type="hidden" name="business" value="drobbins@gentoo.org"><input type="hidden" name="item_name" value="Gentoo Linux Support"><input type="hidden" name="item_number" value="1000"><input type="hidden" name="image_url" value="/images/paypal.png"><input type="hidden" name="no_shipping" value="1"><input type="hidden" name="return" value="http://www.gentoo.org"><input type="hidden" name="cancel_return" value="http://www.gentoo.org"><input type="image" src="http://images.paypal.com/images/x-click-but21.gif" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
></form>
></td></tr>
><tr><td><img src="/images/line.gif" alt="line"></td></tr>
><tr><td align="center"><a href="http://store.gentoo.org"><img src="/images/store.png" alt="The Gentoo Linux Store" border="0"></a></td></tr>
><tr><td><img src="/images/line.gif" alt="line"></td></tr>
><tr><td align="center">
><p class="alttext">
>                    Win4Lin from <b>NeTraverse</b> lets you run Windows applications under Gentoo Linux at native speeds.
>                  </p>
><a href="http://www.netraverse.com/gentoo.htm" target="_top"><img src="/images/netraverse-gentoo.gif" width="125" height="102" alt="Win4Lin at NeTraverse" border="0"></a><p class="alttext">
><a href="http://www.netraverse.com/gentoo.htm">Purchase Win4Lin "Gentoo Edition"</a> and you'll also get a special Gentoo discount. Every sale also helps support Gentoo Linux development :)
>                  </p>
></td></tr>
><tr><td><img src="/images/line.gif" alt="line"></td></tr>
><tr><td align="center">
><a href="http://www.qksrv.net/click-477620-5032687" target="_top"><img src="http://www.qksrv.net/image-477620-5032687" width="125" height="125" alt="DDR Memory at Crucial.com" border="0"></a><p class="alttext">
>                    Purchase RAM from <b>Crucial.com</b> and a percentage of your sale will go towards further Gentoo Linux development.
>                  </p>
></td></tr>
><tr><td><img src="/images/line.gif" alt="line"></td></tr>
><tr><td align="center">
><a href="http://www.tek.net" target="_top"><img src="/images/tek-gentoo.gif" width="125" height="125" alt="Tek Alchemy" border="0"></a><p class="alttext">
>                    Tek Alchemy offers dedicated servers and other hosting solutions running Gentoo Linux.
>                  </p>
></td></tr>
><tr><td><img src="/images/line.gif" alt="line"></td></tr>
></table></td>
></tr></table></td></tr>
><tr><td colspan="2" align="right" class="infohead" width="100%" bgcolor="#7a5ada">
>      Copyright 2001-2003 Gentoo Technologies, Inc.  Questions, Comments, Corrections?  Email <a class="highlight" href="mailto:www@gentoo.org">www@gentoo.org</a>.
>    </td></tr>
></table></body>
></html>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link title="new" rel="stylesheet" href="/css/main.css" type="text/css">
<link REL="shortcut icon" HREF="http://www.gentoo.org/favicon.ico" TYPE="image/x-icon">
<title>Gentoo Linux 
  Documentation
-- 
  Gentoo Linux Install Reference</title>
</head>
<body style="margin-left:0px;margin-top:0px;" bgcolor="#ffffff"><table width="100%" border="0" cellspacing="0" cellpadding="0">
<tr><td valign="top" height="125" bgcolor="#45347b"><table cellspacing="0" cellpadding="0" border="0" width="193">
<tr><td class="logobg" valign="top" align="center" height="88"><a href="/"><img border="0" src="/images/gtop-s.jpg" alt="Gentoo Logo"></a></td></tr>
<tr><td class="logobg" valign="top" align="center" height="36"><a href="/"><img border="0" src="/images/gbot-s.gif" alt="Gentoo Logo Side"></a></td></tr>
</table></td></tr>
<tr><td valign="top" align="right" colspan="1" bgcolor="#ffffff"><table border="0" cellspacing="0" cellpadding="0" width="100%"><tr>
<td width="99%" class="content" valign="top" align="left">
<br><p class="dochead">Gentoo Linux Install Reference</p>
<form name="contents" action="http://www.gentoo.org">
<b>Contents</b>:
    <select name="url" size="1" OnChange="location.href=form.url.options[form.url.selectedIndex].value" style="font-family:Arial,Helvetica, sans-serif; font-size:10"><option value="#doc_chap1">1. Introduction</option>
<option value="#doc_chap2">2. Beginning settings</option>
<option value="#doc_chap3">3. File system, and basic system files</option>
<option value="#doc_chap4">4. Kernel and customizing system</option>
<option value="#doc_chap5">5. Finishing off and installing GUI</option>
<option value="#doc_chap6">6. End Notes</option></select>
</form>
<p class="chaphead">
<span class="chapnum"><a name="doc_chap1">1. </a></span>Introduction</p>
The 2-CD installation set is available on our mirrors. To
see what 2-CD set is right for you, read the detailed descriptions
of each product in the store.
CD1 is a full bootable Gentoo Linux environment that can be used to
install the full Gentoo Linux on your machine. CD 1 contains
everything you need to install Gentoo Linux quickly and without a
connection to the Internet. Several pre-compiled packages are also
included on CD 1, such as the XFree86 X server. CD2 is optional and
isn't bootable. It has pre-compiled packages such as KDE,
GNOME, OpenOffice, Mozilla, Evolution and more.
<p class="chaphead">
<span class="chapnum"><a name="doc_chap2">2. </a></span>Beginning settings</p>
<a name="doc_chap2_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
            Code listing 2.1</p></td></tr>
<tr><td bgcolor="#ddddff"><pre>
(Start by booting your Live CD1. You should see a fancy boot screen with the Gentoo Linux logo on it.)
(Hit &lt;ENTER&gt;.  You would include dopcmcia or doataraid here.  Hit F2-F3 if you have a RAID or PCMCIA laptop setup.)
(You will now see an even fancier boot screen.)
(Next you will see the root ("#") prompt on the console.)
(Here we go.)

# date  (To check if you date is correct.)
# date 022709042003   (If date is wrong, set it with  date MMDDhhmmCCYY )

(Optional, now is the time to load any network or scsi drivers using modprobe.)
# modprobe aic7xxx    (replace aic7xxx with your module)

(Check for network connectivity)
# ping -c 3 www.yahoo.com 

(If it didn't work you can use this utility, or visit the <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap4">Optional Networking</a> section of the full install guide.)
# net-setup eth0
or
# dhcpcd eth0

(Disk Paritioning) (Here was assume you know the basics about drive paritioning.  
If not, see the full install <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap6">Disk Partitioning</a> guide.)

<table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#bbffbb"><p class="note">
<b>Note: </b>
(Use fdisk, cfdisk, parted or partimage to partition your drive now.  I recommend a 64 meg boot volume with ext3,
 a swap partition twice the size of your available RAM (2 Gig limit), and the rest for your root partition using ReiserFS.)
</p></td></tr></table></pre></td></tr>
</table>

<table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#ffffbb"><p class="note">
<b>Important: </b>You should not save or make any changes to a disk's partition table if any of its partitions
contain filesystems that are in use or contain important data. Doing so will generally cause data on the disk to be lost.
</p></td></tr></table>

<p class="chaphead">
<span class="chapnum"><a name="doc_chap3">3. </a></span>File system, and basic system files</p>
<a name="doc_chap3_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
            Code listing 3.1</p></td></tr>
<tr><td bgcolor="#ddddff"><pre>
(Now initialize your partitions) (NOTE: Substitute in your proper parition numbers)
# mkswap /dev/hdax      (for making swap filesystems)
# mke2fs /dev/hdax      (for making ext2 filesystems)
# mke2fs -j /dev/hdax   (for making ext3 filesystems)
# mkreiserfs /dev/hdax  (for making reiserfs filesystems)
# mkfs.xfs /dev/hdax    (for making xfs filesystems)
# mkfs.jfs /dev/hdax    (for making jfs filesystems)

(Mount the partitions)
# swapon /dev/hdax              (substitute your swap partition here)
# mount /dev/hdax /mnt/gentoo   (substitute your root partition here)
# mkdir /mnt/gentoo/boot
# mount /dev/hdax /mnt/gentoo/boot   (substitute your boot partition here)(mount with -o notail if reiserfs here)

(Unpack the files) 
# ls /mnt/cdrom/stages/   (to see what is available on your CD)
# cd /mnt/gentoo
# tar -xvjpf /mnt/cdrom/stages/stage3-*.tar.bz2   (Change to the stage # you are using.)
(OR you can download the latest tarball online, but its not really necessary)
# cd /mnt/gentoo    
# lynx http://gentoo.oregonstate.edu/releases/x86/1.4/

(Copy the rest of the packages off of CD1 that we will use later)
# tar -xvjf /mnt/cdrom/snapshots/portage-yyyymmdd.tar.bz2 -C /mnt/gentoo/usr   (Replace yyyymmdd with the actual filename.)
# cp -R /mnt/cdrom/distfiles /mnt/gentoo/usr/portage/distfiles
# cp -a /mnt/cdrom/packages /mnt/gentoo/usr/portage/packages

(Optional, run mirrorselect if you want to change the defaults)
# mirrorselect -a -s4 -o &gt;&gt; /mnt/gentoo/etc/make.conf   (To select a mirror automatically)
# mirrorselect -i -o &gt;&gt; /mnt/gentoo/etc/make.conf       (To select a mirror interactively)

(Entering the chroot environment)
# mount -t proc proc /mnt/gentoo/proc
# cp /etc/resolv.conf /mnt/gentoo/etc/resolv.conf
# chroot /mnt/gentoo /bin/bash
# env-update
# source /etc/profile

(Updating using sync) (Optional, can be skipped. Checks for updates on the files we already copied.)
# emerge sync 

(Stage 1 install only) (We highly recommend Stage 1 and 2 installs use the <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap10">Full Instructions</a> on the full install guide.)
# nano -w /etc/make.conf
# cd /usr/portage
# scripts/bootstrap.sh   (Bootstrapping, takes long time.)

(Now Stage 2 only, stage 1 continued)
# emerge system    (This takes a long time, which is why some prefer starting at stage3)

(Now Stage 3 starts here)
(Optional, to bring your config files inline with the latest updates before we start changing stuff)
# cp /etc/make.conf /etc/make.conf.backup  (Backup your make.conf first)
# CONFIG_PROTECT="-*" emerge -u system     (This says its okay to overwrite files)
# cp /etc/make.conf.backup /etc/make.conf  (Restore the make.conf)

(Time zone configuration)
(Look for your time zone in /usr/share/zoneinfo and then use that for the following command.)
# ln -sf /usr/share/zoneinfo/path/to/timezonefile /etc/localtime

(Setup your /etc/fstab)
#nano -w /etc/fstab

</pre></td></tr>
</table>

<a name="doc_chap3_pre2"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
            Code listing 3.2: /etc/fstab</p></td></tr>
<tr><td bgcolor="#ddddff"><pre>
# example /etc/fstab: static file system information.
# noatime turns off atimes for increased performance (atimes normally aren't
# needed; notail increases performance of ReiserFS (at the expense of storage
# efficiency).  It's safe to drop the noatime options if you want and to
# switch between notail and tail freely.

# &lt;fs&gt;                  &lt;mountpoint&gt;    &lt;type&gt;          &lt;opts&gt;                  &lt;dump/pass&gt;

# NOTE: Be sure to set the block devices and the filesystem types correctly.
# NOTE: If your BOOT partition is ReiserFS, add the notail option to opts.
/dev/hdax               /boot           ext3            noauto,noatime          1 2
/dev/hdax               /               reiserfs        noatime                 0 1
/dev/hdax               none            swap            sw                      0 0
/dev/cdroms/cdrom0      /mnt/cdrom      iso9660         noauto,ro,user          0 0

# NOTE: The next line is critical for boot!
none                    /proc           proc            defaults                0 0
# glibc 2.2 and above expects tmpfs to be mounted at /dev/shm for
none                    /dev/shm        tmpfs           defaults                0 0

#Example windows configs
/dev/hdax               /mnt/dosc       ntfs            ro,noatime,umask=0222    0 0
/dev/hdax               /mnt/dosd       vfat            noatime          0 0

</pre></td></tr>
</table>

<p class="chaphead">
<span class="chapnum"><a name="doc_chap4">4. </a></span>Kernel and customizing system</p>
<a name="doc_chap4_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
            Code listing 4.1</p></td></tr>
<tr><td bgcolor="#ddddff"><pre>
(Configuring your kernel using genkernel)
(NOTE: Gentoo provides several kernel ebuilds; a list can be found <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml">here</a>. We advise using gentoo-sources.)
# emerge -k sys-kernel/gentoo-sources
# emerge -k genkernel
# genkernel   (--config to change kernel options)
( Write down the names of the kernel and initrd that are given to you after its done.  You will need it later.)

(OR manual kernel configuration)
(since a manual kernel build has many more details, please see the <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap16">Kernel Section</a> of the full install guide.)
# cd /usr/src/linux
# make menuconfig
( A few things required for Gentoo are - Virtual memory file system support, /proc file system support,
  /dev file system support * /dev file system Automatically mount at boot. )
# make dep &amp;&amp; make clean bzImage modules modules_install
# cp /usr/src/linux/arch/i386/boot/bzImage /boot

(Finishing system install)
# emerge -k app-admin/sysklogd   (This is your System Logger. You can also use syslog-ng, metalog, or msyslog.  See <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap16">Full</a> instructions.)
# rc-update add sysklogd default   (rc-update configures what daemons load at boot)
# emerge -k sys-apps/vcron       (This is your CRON Daemon.  You can also use dcron or fcron if you like. See <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap16">Full</a> instructions.)
# rc-update add vcron default   
# emerge -k hotplug              (This detects any hardware that initrd does not detect)
# rc-update add hotplug default

(Optional, install any file system tools you will need)
# emerge -k reiserfsprogs  (or xfsprogs, jfsutils, lvm-user)

(Optional, install modules for any additional hardware)
# emerge -k nvidia-kernel   (or nforce-net, nforce-audio, 
(intel cards are e100, e1000

# emerge -k pcmcia-cs  (This is for laptop users who need PCMCIA.)
# emerge -K rp-pppoe            (For PPPoE, but you still have to do adsl-setup after you boot your system the first time.)
# emerge e100                   (Intel e100 Fast Ethernet Adapters)
# emerge e1000                  (Intel e1000 Gigabit Ethernet Adapters)
# emerge emu10k1                (Creative Sound Blaster Live!/Audigy support)
# emerge ati-drivers            (Accelerated ATI Radeon 8500+/FireGL graphics for XFree86)
# VIDEO_CARDS="yourcard" emerge xfree-drm   (Accelerated graphics for ATI Radeon up to 9200, Rage128, Matrox, Voodoo and other cards)

(Add the names of any modules you need to load after boot to /etc/modules.autoload.d/kernel-2.4 file)
# nano -w /etc/modules.autoload.d/kernel-2.4  (Only needed if you had to modprobe earlier.)

(User Management)
# passwd   (Set the root password.)
# useradd your_user -m -G users,wheel,audio -s /bin/bash   (Now create your own user.)
# passwd your_user   (&amp; set the password.)

# echo mymachine &gt; /etc/hostname           (substitute your hostname)
# echo mydomain.com &gt; /etc/dnsdomainname   (substitute your domainname, or skip)
# nano -w /etc/hosts                       (Add your actual hostname to /etc/hosts so GNOME doesn't complain)
# nano -w /etc/conf.d/net                  (Don't skip this DHCP usersppen at boot.)
# rc-update add net.eth0 default   (This starts your network at boot)(not pcmcia though)

(Optional, use this code if you have more then one network adapter)
# ln -s /etc/init.d/net.eth0 /etc/init.d/net.ethx
# rc-update add net.ethx default  

(Optional for laptops, have a quick look into /etc/init.d/pcmcia to verify that things seem all right.)
# rc-update add pcmcia boot   (This takes care of any PCMCIA cards and network starting for PCMCIA network cards.)

(Basic configuration)
# nano -w /etc/rc.conf  (Follow the directions in this file to configure basic settings.)

(Install your GRUB bootloader) (Use the <a href="http://www.gentoo.org/doc/en/gentoo-x86-install.xml#doc_chap23">Boot Loader</a> section of the full install guide if you would like LILO.)
<table class="ncontent" width="100%" border="0" cellspacing="0" cellpadding="0"><tr><td bgcolor="#bbffbb"><p class="note">
<b>Note: </b>GRUB counts hard drives from zero rather than "a" and partitions start at zero rather than one.
Only hard drives are counted, not atapi-ide devices. So the syntax is first integer indicates the drive number,
while the second integer indicates the partition number. Once again, please note that the partition numbers
are counted from zero, not from one. Your Linux partition /dev/hda1 is called (hd0,0) under GRUB.
Grub also has TAB completion)
</p></td></tr></table>
# emerge -k grub
# grub

(Install the GRUB boot record on to your hard drive's MBR (master boot record))
grub&gt; root (hd0,0)   (Tells GRUB the location of your boot boot partition.  /dev/hda1 is used here)
grub&gt; setup (hd0)    (Install grub onto your MBR)
grub&gt; quit

(for ATA RAID setups, you also need this commmand)
grub&gt; setup --stage2=/boot/grub/stage2 (hd0)

(Create the grub.conf file)
# nano -w /boot/grub/grub.conf

</pre></td></tr>
</table>

<a name="doc_chap4_pre2"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
            Code listing 4.2: grub.conf</p></td></tr>
<tr><td bgcolor="#ddddff"><pre>
# example grub.conf
# (Here is where you use the output from genkernel that you wrote down earlier.
#  Sustitute it where is says KV.  Also, (hd0,0) should point to your boot partition
#  which is /dev/hda1 in our example and /dev/hda3 should point to your root filesystem.
#  (hd0,5) contains the NT bootloader for windows users.
#  NOTE: The path to the kernel image is relative to the boot partition.

default 0
timeout 30
fallback 1
splashimage=(hd0,0)/grub/splash.xpm.gz

title=My example Gentoo Linux (genkernel)
root (hd0,0)
kernel (hd0,0)/kernel-KV root=/dev/hda3
initrd (hd0,0)/initrd-KV

# Below needed only for people who dual-boot
title=Windows XP
root (hd0,5) 
chainloader (hd0,5)+1

# Below is an example for RAID setups
title=Gentoo Linux on RAID
root (hd0,0)
kernel (hd0,0)/boot/bzImage root=/dev/ataraid/dXpY

</pre></td></tr>
</table>

<p class="chaphead">
<span class="chapnum"><a name="doc_chap5">5. </a></span>Finishing off and installing GUI</p>
<a name="doc_chap5_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td class="infohead" bgcolor="#7a5ada"><p class="caption">
            Code listing 5.1</p></td></tr>
<tr><td bgcolor="#ddddff"><pre>
# etc-update
# exit
# cd /
# umount /mnt/gentoo/boot
# umount /mnt/gentoo/proc
# umount /mnt/gentoo
# reboot   (Don't forget to remove the bootable CD)

(Wait for system to come back up)
(Optional, Load binary packages from CD2)
# mount /dev/cdrom /mnt/cdrom
# cp -a /mnt/cdrom/packages/* /usr/portage/packages/

# emerge -k xfree   (XFree was copied off of CD1 earlier if you were wondering)
# emerge -k gnome   (or kde) 
# /usr/X11R6/bin/xf86config  
(It is now recommend that you go onto the <a href="http://www.gentoo.org/doc/en/desktop.xml">Desktop Configuration guide</a> for additional info.)
</pre></td></tr>
</table>

<p class="chaphead">
<span class="chapnum"><a name="doc_chap6">6. </a></span>End Notes</p>
<p>Now go onto the <a href="http://www.gentoo.org/doc/en/desktop.xml">Desktop configuration
guide</a> that will help you to continue configuring your new
Gentoo Linux system.
Check out the <a href="http://www.gentoo.org/doc/en/portage-user.xml">Portage user
guide</a> to help familiarize you with Portage basics.
For more information on starting programs and daemons at startup,
see the <a href="file:///doc/en/rc-scripts.xml">rc-script
guide</a>.
If you have any other questions involving installation or anything
for that matter, please check the Gentoo Linux <a href="http://www.gentoo.org/doc/en/faq.xml">FAQ</a>.
You can find the rest of the Gentoo Documentation <a href="http://www.gentoo.org/main/en/docs.xml">here</a>.
</p>
<br><pre>
  The contents of this document are licensed under the <a href="http://creativecommons.org/licenses/by-sa/1.0">Creative Commons - Attribution / Share Alike</a> license.
</pre>
<br>
</td>
<td width="1%" bgcolor="#dddaec" valign="top"><table border="0" cellspacing="5" cellpadding="0">
<tr><td><img src="/images/line.gif" alt="line"></td></tr>
<tr><td align="center" class="alttext">
                  Updated 27 Sep 2003</td></tr>
<tr><td><img src="/images/line.gif" alt="line"></td></tr>
<tr><td class="alttext">Steven Wagner<br><i>Chief Architect</i><br><br>
</td></tr>
<tr><td><img src="/images/line.gif" alt="line"></td></tr>
<tr><td class="alttext">
<b>Summary:</b>Â 
This is the abstract.  It is abstract.
</td></tr>
<tr><td><img src="/images/line.gif" alt="line"></td></tr>
<tr><td align="center">
<p class="alttext">
<b>Donate</b> to support our development efforts.
                  </p>
<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_xclick"><input type="hidden" name="business" value="drobbins@gentoo.org"><input type="hidden" name="item_name" value="Gentoo Linux Support"><input type="hidden" name="item_number" value="1000"><input type="hidden" name="image_url" value="/images/paypal.png"><input type="hidden" name="no_shipping" value="1"><input type="hidden" name="return" value="http://www.gentoo.org"><input type="hidden" name="cancel_return" value="http://www.gentoo.org"><input type="image" src="http://images.paypal.com/images/x-click-but21.gif" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
</form>
</td></tr>
<tr><td><img src="/images/line.gif" alt="line"></td></tr>
<tr><td align="center"><a href="http://store.gentoo.org"><img src="/images/store.png" alt="The Gentoo Linux Store" border="0"></a></td></tr>
<tr><td><img src="/images/line.gif" alt="line"></td></tr>
<tr><td align="center">
<p class="alttext">
                    Win4Lin from <b>NeTraverse</b> lets you run Windows applications under Gentoo Linux at native speeds.
                  </p>
<a href="http://www.netraverse.com/gentoo.htm" target="_top"><img src="/images/netraverse-gentoo.gif" width="125" height="102" alt="Win4Lin at NeTraverse" border="0"></a><p class="alttext">
<a href="http://www.netraverse.com/gentoo.htm">Purchase Win4Lin "Gentoo Edition"</a> and you'll also get a special Gentoo discount. Every sale also helps support Gentoo Linux development :)
                  </p>
</td></tr>
<tr><td><img src="/images/line.gif" alt="line"></td></tr>
<tr><td align="center">
<a href="http://www.qksrv.net/click-477620-5032687" target="_top"><img src="http://www.qksrv.net/image-477620-5032687" width="125" height="125" alt="DDR Memory at Crucial.com" border="0"></a><p class="alttext">
                    Purchase RAM from <b>Crucial.com</b> and a percentage of your sale will go towards further Gentoo Linux development.
                  </p>
</td></tr>
<tr><td><img src="/images/line.gif" alt="line"></td></tr>
<tr><td align="center">
<a href="http://www.tek.net" target="_top"><img src="/images/tek-gentoo.gif" width="125" height="125" alt="Tek Alchemy" border="0"></a><p class="alttext">
                    Tek Alchemy offers dedicated servers and other hosting solutions running Gentoo Linux.
                  </p>
</td></tr>
<tr><td><img src="/images/line.gif" alt="line"></td></tr>
</table></td>
</tr></table></td></tr>
<tr><td colspan="2" align="right" class="infohead" width="100%" bgcolor="#7a5ada">
      Copyright 2001-2003 Gentoo Technologies, Inc.  Questions, Comments, Corrections?  Email <a class="highlight" href="mailto:www@gentoo.org">www@gentoo.org</a>.
    </td></tr>
</table></body>
</html>

Actions: View

Attachments on bug 29649: 18350 | 18407 | 18408 | 18657 | 18658 | 18748 | 19001