swift 05/07/05 15:32:12 Modified: xml/htdocs/doc/en gentoo-x86-quickinstall.xml Log: Rewrite on quick installation guide, make it less detailed -> less errorprone
Revision Changes Path 1.38 +279 -203 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.38&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.38&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.37&r2=1.38&cvsroot=gentoo Index: gentoo-x86-quickinstall.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v retrieving revision 1.37 retrieving revision 1.38 diff -u -r1.37 -r1.38 --- gentoo-x86-quickinstall.xml 4 Jul 2005 14:05:00 -0000 1.37 +++ gentoo-x86-quickinstall.xml 5 Jul 2005 15:32:12 -0000 1.38 @@ -1,296 +1,372 @@ <?xml version='1.0' encoding="UTF-8"?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.37 2005/07/04 14:05:00 swift Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml,v 1.38 2005/07/05 15:32:12 swift Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide link="/doc/en/gentoo-x86-quickinstall.xml"> <title>Gentoo Linux x86 Quick Install Guide</title> -<author title="Author">Steven Wagner</author> -<author title="Editor"> + +<author title="Author"> <mail link="[EMAIL PROTECTED]">Sven Vermeulen</mail> </author> +<author title="Author">Steven Wagner</author> <abstract> -The Quick install guide covers all details of the install process in a +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. </abstract> <license/> -<version>1.30</version> -<date>2005-07-04</date> +<version>2.0</version> +<date>2005-07-05</date> <chapter> <title>Quick Install Guide</title> <section> +<title>Installation Media</title> <body> <p> -The installation ISOs are on the <uri link="/main/en/mirrors.xml">Gentoo -Mirrors</uri>. Detailed descriptions of the different CDs are -available in the <uri link="http://store.gentoo.org";>Gentoo -Store</uri>. A universal CD contains everything you need to install Gentoo Linux -quickly and without a connection to the Internet. A Package CD is optional and -contains pre-compiled packages such as KDE, GNOME, OpenOffice, -Mozilla, Evolution and more. +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. </p> <p> -Boot from the Universal CD. Press <F1> and/or <F2> to -see what boot options are available. Press <ENTER> at the bootscreen to -continue with the default kernel. You'll eventually receive a prompt. -</p> - -<pre caption="Initial settings"> -# <i>date</i> (Make sure your time and date is correct. If wrong, set it with <i>date MMDDhhmmCCYY</i>) -# <i>modprobe module_name</i> <comment>(Optional - Load any necessary modules)</comment> -# <i>net-setup eth0</i> <comment>(Configure the network)</comment> -# <i>fdisk /dev/hda</i> <comment>(Partition your drive)</comment> -</pre> +<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. +</p> <p> -The recommended setup is a 64 meg boot volume with ext2, a swap partition -twice the size of your available RAM, and the rest for your root partition -using ReiserFS. +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>links2</c>. </p> +</body> +</section> +<section> +<title>Network Configuration</title> +<body> + <p> -Initialise your partitions using <c>mke2fs</c> (Ext2), <c>mke2fs --j</c> (Ext3), <c>mkreiserfs</c> (ReiserFS), <c>mkfs.xfs</c> (XFS), -<c>mkfs.jfs</c> (JFS) and <c>mkswap</c> (swap partition). For instance: -<c>mke2fs -j /dev/hda3</c>. +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>. 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> -Continue by mounting the partitions and extracting the appropriate stage -file. -</p> - -<warn> -For ext3 partitions, you need to specify <c>mount -t ext3</c> explicitly. This -is due to a bug in the e2fsprogs package. -</warn> - -<pre caption="Preparing the Installation"> -(Activate the swap partition) # <i>swapon /dev/hdax</i> -(Mount the root partition) # <i>mount /dev/hdax /mnt/gentoo</i> -(Create the boot mountpoint) # <i>mkdir /mnt/gentoo/boot</i> -(Mount the boot partition) # <i>mount /dev/hdax /mnt/gentoo/boot</i> -(Go to the mountpoint) # <i>cd /mnt/gentoo</i> -(Extract a stage tarball...) # <i>tar -xvjpf /mnt/cdrom/stages/stage<your stage>.tar.bz2</i> -(<comment>or</comment> download the latest tarball...) - # <i>links http://www.gentoo.org/main/en/mirrors.xml</i> -( ... and extract) # <i>tar -xvjpf stage<your stage>.tar.bz2</i> -(Optional: unpack a portage tree)# <i>tar -xvjf /mnt/cdrom/snapshots/portage-*.tar.bz2 \ - -C /mnt/gentoo/usr</i> -(Optional: copy over distfiles) # <i>cd /mnt/gentoo/usr/portage; mkdir distfiles;</i> - # <i>cp /mnt/cdrom/distfiles/* distfiles/</i> -(Select a mirror) # <i>mirrorselect -a -s4 -o | grep 'GENTOO_MIRRORS=' \ - >> /mnt/gentoo/etc/make.conf</i> -(Copy over nameserver information) - # <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/resolv.conf</i> -(Mount the proc filesystem) # <i>mount -t proc none /mnt/gentoo/proc</i> -(Chroot into the new environment)# <i>chroot /mnt/gentoo /bin/bash</i> -(Load the necessary variables) # <i>env-update; source /etc/profile</i> -(Network-only, non-GRP: update Portage) - # <i>emerge --sync</i> -</pre> +For wireless access, use <c>iwconfig</c> to set the wireless parameters and then +use eiter <c>net-setup</c> again or run <c>ifconfig</c>, <c>dhcpcd</c> and/or +<c>route</c> manually. +</p> <p> -Now we go onto setting our profile and installing Gentoo. A profile is a -building block for any Gentoo system. Not only does it specify default values -for CHOST, CFLAGS and other important variables, it also locks the system to a -certain range of package versions. This is all maintained by the Gentoo -developers. -</p> - -<pre caption = "Installing Gentoo"> -(Verify current profile) # <i>ls -l /etc/make.profile</i> -(Change ONLY IF REQUIRED or if you want a 2.4 kernel) - # <i>ln -snf /usr/portage/profiles/default-linux/x86/2005.0/2.4 /etc/make.profile</i> -(Change USE, CFLAGS and CXXFLAGS. Stage1 can also change CHOST) - # <i>nano -w /etc/make.conf</i> -(Stage1 only: bootstrap system) # <i>cd /usr/portage; scripts/bootstrap.sh</i> -(Stage1, Stage2 only: install base system. Use --emptytree if you modified USE flags. Else --newuse will do. - One of these options is a must. ) - # <i>emerge --emptytree system</i> <comment>OR</comment> <i>emerge --newuse system</i> -</pre> +If you are behind a proxy, do not forget to initialise your system using +<c>export http_proxy</c>, <c>ftp_proxy</c> and <c>RSYNC_PROXY</c>. +</p> + +</body> +</section> +<section> +<title>Preparing the Disks</title> +<body> <p> -Next we set up the necessary information: +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> -<pre caption = "Setting up Configuration Files"> -(Set timezone information) # <i>ln -sf /usr/share/zoneinfo/<comment><path to time zone file></comment> /etc/localtime</i> -(Edit fstab file) # <i>nano -w /etc/fstab</i> -</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 on your Linux partitions. Initialise your +swap partition using <c>mkswap</c> and <c>swapon</c>. +</p> <p> -Use the following as a <e>template</e> (don't copy verbatim) for -<path>/etc/fstab</path>: +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. </p> -<pre caption="/etc/fstab"> -- [email protected] mailing list
