How do I Install Gentoo Using a Stage1 or Stage2 Tarball?

Stage1	Pros and Cons
+
+
-
-
-

Stage2	Pros and Cons
+
+
+
-
-

Stage3	Pros and Cons
+
+

The Gentoo Installation CDs @@ -294,8 +95,8 @@

The Gentoo Universal Installation CD, a bootable CD with the same abilities - as the Minimal Installation CD. Additionally, it contains a stage1 and - several stage3 tarballs (optimized for the individual subarchitectures). + as the Minimal Installation CD. Additionally, it contains several stage3 + tarballs (optimized for the individual subarchitectures).

@@ -326,16 +127,9 @@ Smallest download - + - - You can do a stage1, stage2 or stage3 by getting the stage tarball off the - net - - - - - Contains no stages, no Portage snapshot, no prebuilt packages and is + Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is therefore not suitable for networkless installation @@ -392,7 +186,24 @@

If you intend to use the Packages CD to quickly install additional software, -make sure that you use the same subarchitecture as the stage-3 tarball you use. +make sure that you use the same subarchitecture as the stage3 tarball you use. +

+ + + + +The Stage3 Tarball + + +

+A stage3 tarball is an archive containing a minimal Gentoo environment, suitable +to continue the Gentoo installation using the instructions in this manual. +Previously, the Gentoo Handbook described the installation using one of three +stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the +official installation method uses the stage3 tarball. If you are interested in +performing a Gentoo installation using a stage1 or stage2 tarball, please read +the Gentoo FAQ on How do I Install Gentoo +Using a Stage1 or Stage2 Tarball?

Index: handbook/hb-install-amd64-medium.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-amd64-medium.xml,v retrieving revision 1.38 diff -u -t -r1.38 hb-install-amd64-medium.xml --- handbook/hb-install-amd64-medium.xml 31 Oct 2005 13:31:33 -0000 1.38 +++ handbook/hb-install-amd64-medium.xml 5 Nov 2005 23:05:09 -0000 @@ -58,206 +58,6 @@

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- A stage1 file contains nothing more than a compiler, Portage (Gentoo's - software management system) and a couple of packages on which the compiler - or Portage depends. -
- A stage2 file contains a so-called bootstrapped system, a minimal - environment from which one can start building all other necessary - applications that make a Gentoo environment complete. -
- A stage3 file contains a prebuilt minimal system which is almost fully - deployable. It only lacks a few applications where you, the Gentoo user, - needs to choose which one you want to install. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-This approach builds core system packages that are vital to your system and is -used by Gentoo developers to prepare the Gentoo release media. It is a great -installation method for those who would like to learn more about the inner -workings of bootstrapping, toolchains and the like. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

- - - - - - - - - - Allows you to have total control over the installation routine, bootstrap - sequence, etc. - - - - - Suitable for powerusers and developers who know what they are doing - - - - - Takes a long time to finish the installation (it is the lengthiest approach) - - - - - - If you don't intend to tweak the settings, it is a waste of time - - - - - - Requires a working Internet connection during the installation - - -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

-When you perform a stage2 installation approach, you will build all system -packages (core packages, including toolchain) using your specific USE, -CFLAGS and CXXFLAGS settings. Any package build will therefore be -optimized to your preference. -

- -

-However, this installation takes some time and if you do not intend to change -the CFLAGS and CXXFLAGS settings that we have defined as a "good -default", using this approach only makes sense if your USE variable is -sufficiently different from the default USE we provide. -

- - - - - - - - - You don't need to bootstrap - - - - Faster than starting with stage1 - - - - You can still tweak your settings - - - - It's still not the fastest way to install Gentoo - - - - - Requires a working Internet connection during the installation - - -

Stage2	Pros and Cons
+
+
+
-
-

- - - - -A Stage3 Approach - - -

-A stage3 installation contains a basic Gentoo Linux system that has been -built for you. You will only need to build a few packages (such as system -logger, networking tools, ...) before you can boot into a base Gentoo -installation. -

- -

-Choosing to go with a stage3 allows for the fastest install of Gentoo -Linux, but also means that your base system will have the optimization -settings that we chose for you (which to be honest, are good settings -and were carefully chosen to enhance performance while maintaining -stability). Stage3 is also required if you want to install Gentoo using -prebuilt packages or without a network connection. -

- - - - - - - - - Fastest way to get a Gentoo base system - - - - - You can still tweak your system - - -

Stage3	Pros and Cons
+
+

- -

-You might be interested to know that, if you decide to use different -optimization settings after having installed Gentoo, you will be able to -recompile your entire system with the new optimization settings. The same goes -for any USE flag changes: Portage is intelligent enough to know what -packages need to be rebuild. -

- - - -

- -

The Gentoo Installation CDs Introduction @@ -296,9 +96,8 @@

The Gentoo Universal Installation CD, a bootable CD with the same - abilities as the Minimal Installation CD. Additionally, it contains a - stage1 and several stage3 tarballs (optimized for the individual - subarchitectures). + abilities as the Minimal Installation CD. Additionally, it contains + several stage3 tarballs (optimized for the individual subarchitectures).

@@ -330,16 +129,9 @@ Smallest download - + - - You can do a stage1, stage2 or stage3 by getting the stage tarball off the - net - - - - - Contains no stages, no Portage snapshot, no prebuilt packages and is + Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is therefore not suitable for networkless installation @@ -395,7 +187,24 @@

+ + + + +The Stage3 Tarball + + +

Index: handbook/hb-install-hppa-medium.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml,v retrieving revision 1.34 diff -u -t -r1.34 hb-install-hppa-medium.xml --- handbook/hb-install-hppa-medium.xml 25 Oct 2005 17:27:35 -0000 1.34 +++ handbook/hb-install-hppa-medium.xml 5 Nov 2005 23:05:10 -0000 @@ -56,206 +56,6 @@

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- A stage1 file contains nothing more than a compiler, Portage (Gentoo's - software management system) and a couple of packages on which the compiler - or Portage depends. -
- A stage2 file contains a so-called bootstrapped system, a minimal - environment from which one can start building all other necessary - applications that make a Gentoo environment complete. -
- A stage3 file contains a prebuilt minimal system which is almost fully - deployable. It only lacks a few applications where you, the Gentoo user, - needs to choose which one you want to install. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

Stage2	Pros and Cons
+
+
+
-
-

- - - - -A Stage3 Approach - - -

- -

- - - - - - - - - Fastest way to get a Gentoo base system - - - - - You can still tweak your system - - -

Stage3	Pros and Cons
+
+

- -

- - - -

- -

The Gentoo Installation CDs Introduction @@ -294,9 +94,8 @@

@@ -327,16 +126,9 @@ Smallest download - + - - You can do a stage1, stage2 or stage3 by getting the stage tarball off the - net - - - - - Contains no stages, no Portage snapshot, no prebuilt packages and is + Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is therefore not suitable for networkless installation @@ -390,7 +182,24 @@

+ + + + +The Stage3 Tarball + + +

Index: handbook/hb-install-mips-medium.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-medium.xml,v retrieving revision 1.15 diff -u -t -r1.15 hb-install-mips-medium.xml --- handbook/hb-install-mips-medium.xml 9 Oct 2005 16:33:54 -0000 1.15 +++ handbook/hb-install-mips-medium.xml 5 Nov 2005 23:05:12 -0000 @@ -51,208 +51,9 @@

- - -

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- A stage1 file contains nothing more than a compiler, Portage (Gentoo's - software management system) and a couple of packages on which the compiler - or Portage depends. -
- A stage2 file contains a so-called bootstrapped system, a minimal - environment from which one can start building all other necessary - applications that make a Gentoo environment complete. -
- A stage3 file contains a prebuilt minimal system which is almost fully - deployable. It only lacks a few applications where you, the Gentoo user, - needs to choose which one you want to install. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

Stage2	Pros and Cons
+
+
+
-
-

- - - -A Stage3 Approach - - -

- -

- - - - - - - - - Fastest way to get a Gentoo base system - - - - - You can still tweak your system - - -

Stage3	Pros and Cons
+
+

- -

- - - +

+Installation Notes A note about Processor Architectures @@ -394,7 +195,23 @@ + +The Stage3 Tarball + +

+ + +

Index: handbook/hb-install-ppc-medium.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v retrieving revision 1.48 diff -u -t -r1.48 hb-install-ppc-medium.xml --- handbook/hb-install-ppc-medium.xml 9 Oct 2005 16:33:54 -0000 1.48 +++ handbook/hb-install-ppc-medium.xml 5 Nov 2005 23:05:13 -0000 @@ -81,206 +81,6 @@

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- A stage1 file contains nothing more than a compiler, Portage (Gentoo's - software management system) and a couple of packages on which the compiler - or Portage depends. -
- A stage2 file contains a so-called bootstrapped system, a minimal - environment from which one can start building all other necessary - applications that make a Gentoo environment complete. -
- A stage3 file contains a prebuilt minimal system which is almost fully - deployable. It only lacks a few applications where you, the Gentoo user, - needs to choose which one you want to install. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

Stage2	Pros and Cons
+
+
+
-
-

- - - - -A Stage3 Approach - - -

- -

- - - - - - - - - Fastest way to get a Gentoo base system - - - - - You can still tweak your system - - -

Stage3	Pros and Cons
+
+

- -

- - - -

- -

The Gentoo Installation CDs Introduction @@ -319,9 +119,8 @@

@@ -352,16 +151,9 @@ Smallest download - + - - You can do a stage1, stage2 or stage3 by getting the stage tarball off the - net - - - - - Contains no stages, no Portage snapshot, no prebuilt packages and is + Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is therefore not suitable for networkless installation @@ -416,7 +208,24 @@

+ + + + +The Stage3 Tarball + + +

Index: handbook/hb-install-ppc64-medium.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v retrieving revision 1.24 diff -u -t -r1.24 hb-install-ppc64-medium.xml --- handbook/hb-install-ppc64-medium.xml 9 Oct 2005 16:33:54 -0000 1.24 +++ handbook/hb-install-ppc64-medium.xml 5 Nov 2005 23:05:14 -0000 @@ -64,206 +64,6 @@

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- A stage1 file contains nothing more than a compiler, Portage (Gentoo's - software management system) and a couple of packages on which the compiler - or Portage depends. -
- A stage2 file contains a so-called bootstrapped system, a minimal - environment from which one can start building all other necessary - applications that make a Gentoo environment complete. -
- A stage3 file contains a prebuilt minimal system which is almost fully - deployable. It only lacks a few applications where you, the Gentoo user, - needs to choose which one you want to install. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

Stage2	Pros and Cons
+
+
+
-
-

- - - - -A Stage3 Approach - - -

- -

- - - - - - - - - Fastest way to get a Gentoo base system - - - - - You can still tweak your system - - -

Stage3	Pros and Cons
+
+

- -

- - - -

- -

The Gentoo Installation CDs Introduction @@ -321,16 +121,9 @@ Smallest download - + - - You can do a stage1, stage2 or stage3 by getting the stage tarball off the - net - - - - - Contains no stages, no Portage snapshot, no prebuilt packages and is + Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is therefore not suitable for networkless installation @@ -338,6 +131,23 @@ + +The Stage3 Tarball + + +

+ + +

Index: handbook/hb-install-sparc-medium.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-medium.xml,v retrieving revision 1.35 diff -u -t -r1.35 hb-install-sparc-medium.xml --- handbook/hb-install-sparc-medium.xml 9 Oct 2005 16:33:54 -0000 1.35 +++ handbook/hb-install-sparc-medium.xml 5 Nov 2005 23:05:15 -0000 @@ -63,206 +63,6 @@

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- A stage1 file contains nothing more than a compiler, Portage (Gentoo's - software management system) and a couple of packages on which the compiler - or Portage depends. -
- A stage2 file contains a so-called bootstrapped system, a minimal - environment from which one can start building all other necessary - applications that make a Gentoo environment complete. -
- A stage3 file contains a prebuilt minimal system which is almost fully - deployable. It only lacks a few applications where you, the Gentoo user, - needs to choose which one you want to install. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

Stage2	Pros and Cons
+
+
+
-
-

- - - - -A Stage3 Approach - - -

- -

- - - - - - - - - Fastest way to get a Gentoo base system - - - - - You can still tweak your system - - -

Stage3	Pros and Cons
+
+

- -

- - - -

- -

The Gentoo Installation CDs Introduction @@ -301,9 +101,8 @@

@@ -342,16 +141,9 @@ Smallest download - + - - You can do a stage1, stage2 or stage3 by getting the stage tarball off the - net - - - - - Contains no stages, no Portage snapshot, no prebuilt packages and is + Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is therefore not suitable for networkless installation @@ -407,7 +199,24 @@

+ + + + +The Stage3 Tarball + + +

Index: handbook/hb-install-stage.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-stage.xml,v retrieving revision 1.89 diff -u -t -r1.89 hb-install-stage.xml --- handbook/hb-install-stage.xml 13 Aug 2005 21:21:30 -0000 1.89 +++ handbook/hb-install-stage.xml 5 Nov 2005 23:05:16 -0000 @@ -49,8 +49,8 @@

-The next step you need to perform is to install the stage tarball of -your choice onto your system. You have the option of downloading the required +The next step you need to perform is to install the stage3 tarball +onto your system. You have the option of downloading the required tarball from the Internet or, if you are booted from one of the Gentoo Universal Installation CDs, copy it over from the CD itself. If you have a Universal CD and the stage you want to use is on the CD, downloading it from @@ -124,14 +124,19 @@

+Make sure you download a stage3 tarball - installations using a stage1 or stage2 +tarball are not supported anymore. +

+ +

-# md5sum -c stage1-x86-2005.1.tar.bz2.md5
-stage1-x86-2005.1.tar.bz2: OK
+# md5sum -c stage3-x86-2005.1.tar.bz2.md5
+stage3-x86-2005.1.tar.bz2: OK

@@ -146,7 +151,7 @@

-# tar -xvjpf stage?-*.tar.bz2
+# tar -xvjpf stage3-*.tar.bz2

@@ -340,105 +345,11 @@ CHOST - -Although it might be tempting for non-stage1 users, they should not -change the CHOST setting in make.conf. Doing so might render -their system unusable. Again: only change this variable if you use a -stage1 installation. - - -

-The CHOST variable defines what architecture gcc has to -compile programs for. The possibilities are: -

- - - - - - - - - x86 - i386 - i386-pc-linux-gnu - - - x86 - i486 - i486-pc-linux-gnu - - - x86 - i586 - i586-pc-linux-gnu - - - x86 - i686 and above (incl. athlon) - i686-pc-linux-gnu - - - alpha - - alpha-unknown-linux-gnu - - - ppc - - powerpc-unknown-linux-gnu - - - ppc64 - - powerpc64-unknown-linux-gnu - - - sparc - - sparc-unknown-linux-gnu - - - sparc64 - - sparc-unknown-linux-gnu - - - hppa - (generic) - hppa-unknown-linux-gnu - - - hppa - pa7000 - hppa1.1-unknown-linux-gnu - - - hppa - pa8000 and above - hppa2.0-unknown-linux-gnu - - - mips - - mips-unknown-linux-gnu - - - amd64 - - x86_64-pc-linux-gnu - -

Architecture	Subarchitecture	CHOST Setting

- -

-Please, make sure that you use the correct CHOST setting. For instance, -the CHOST setting for sparc64 still is sparc-unknown-linux-gnu and -not sparc64-unknown-linux-gnu! -

-Users interested in bootstrapping their entire system with NPTL support on an -x86 system need to set their CHOST to i586-pc-linux-gnu or higher. +The CHOST variable declares the target build host for your system. This +variable should already be set to the correct value. Do not edit +it as that might break your system. If the CHOST variable does +not look correct to you, you might be using the wrong stage3 tarball.

Index: handbook/hb-install-system.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v retrieving revision 1.84 diff -u -t -r1.84 hb-install-system.xml --- handbook/hb-install-system.xml 16 Aug 2005 22:14:44 -0000 1.84 +++ handbook/hb-install-system.xml 5 Nov 2005 23:05:17 -0000 @@ -124,6 +124,10 @@ +

+ +

+Configuring Portage Updating the Portage tree @@ -341,8 +345,7 @@ after compiling glibc a full set of all available locales will be created. As of now you can activate the userlocales USE flag and specify only the locales you will need in /etc/locales.build. Only do this -if you know what locales to choose. This will not work for the bootstrapping, -but when you recompile glibc afterwards it will. +if you know what locales to choose.

@@ -370,208 +373,11 @@
 de_DE@euro/ISO-8859-15

- - -

-Differences between Stage1, Stage2 and Stage3 - - -

-Now take a seat and think of your previous steps. We asked you to -select a stage1, stage2 or stage3 and warned you -that your choice is important for further installation steps. Well, this -is the first place where your choice defines the subsequent steps. -

- -

- If you chose stage1, then you have to follow both steps in - this chapter (starting with Progressing from Stage1 - to Stage2) -
- If you chose stage2 you only can skip the first step - and immediately start with the second one (Progressing - from Stage2 to Stage3) -
- If you chose stage3 then you can skip both - steps and continue with Configuring the - Kernel -

- - -

-Progressing from Stage1 to Stage2 - -Introduction to Bootstrapping - - -

-So, you want to compile everything from scratch? Okay then :-) -

- -

-In this step, we will bootstrap your Gentoo system. This takes a -long time, but the result is a system that has been optimized from the -ground up for your specific machine and needs. -

- -

-Bootstrapping means building the GNU C Library, GNU Compiler -Collection and several other key system programs. -

- -

-Before starting the bootstrap, you might want to download all necessary -sourcecode first. If you do not want to do this, continue -with Bootstrapping the System. -

- - - - -Optional: Downloading the Sources First - - -

-If you haven't copied over all source code before, then the bootstrap -script will download all necessary files. If you want to -download the source code first and later bootstrap the system (for instance -because you don't want to have your internet connection open during the -compilation) use the -f option of the bootstrap script, which will -fetch (hence the letter f) all source code for you. -

- -

-# cd /usr/portage
-# scripts/bootstrap.sh -f
-

- - - - -Bootstrapping the System - - -

-Okay then, take your keyboard and punch in the next commands to start -the bootstrap. Then go amuse yourself with something else because this step -takes quite some time to finish. -

- -

-# cd /usr/portage
-# scripts/bootstrap.sh
-

- -

-Now continue with the next step, Progressing from Stage2 -to Stage3. -

- - - -

-Progressing from Stage2 to Stage3 - -Introduction - - -

-If you are reading this section, then you have a bootstrapped system -(either because you bootstrapped it previously, or you are using a -stage2). Then it is now time to build all system packages. -

- -

-All system packages? No, not really. In this step, you will build -the system packages of which there are no alternatives to use. -Some system packages have several alternatives (such as system loggers) -and as Gentoo is all about choices, we don't want to force one upon you. -

- - - - -Optional: Viewing what will be done - - -

-If you want to know what packages will be installed, execute emerge ---pretend --emptytree system. This will list all packages that will be -built. As this list is pretty big, you should also use a pager like -less or more to go up and down the list. -

- -

-# emerge --pretend --emptytree system | less
-

- -

-Note that, if you haven't touched the default CFLAGS/CXXFLAGS setting, using -emerge --pretend --newuse system is sufficient: it will rebuild the -applications that are affected by a change in USE flags (compared to the USE -flag we used while building the stage2). If you didn't touch -the USE flag either, why are you running a stage2 installation then? -

- - - - -Optional: Downloading the Sources - - -

-If you want emerge to download the sources before you continue -(for instance because you don't want the internet connection to be left -open while you are building all packages) you can use the --fetchonly -option of emerge which will fetch all sources for you. -

- -

-# emerge --fetchonly --emptytree system
-

- - - - -Building the System - - -

-To start building the system, execute emerge --emptytree system. Then -go do something to keep your mind busy, because this step takes a long time to -complete. -

- -

-# emerge --emptytree system
-

-Again, if you haven't touched the default CFLAGS and CXXFLAGS setting, using ---newuse is sufficient. -

- -

-You can for now safely ignore any warnings about updated configuration files -(and running etc-update). When your Gentoo system is fully installed and -booted, do read our documentation on Configuration File Protection. -

- -

-When the build process has completed, continue with Configuring the Kernel. +Now continue with Configuring the Kernel.

- Index: handbook/hb-install-x86-medium.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86-medium.xml,v retrieving revision 1.40 diff -u -t -r1.40 hb-install-x86-medium.xml --- handbook/hb-install-x86-medium.xml 9 Oct 2005 16:33:54 -0000 1.40 +++ handbook/hb-install-x86-medium.xml 5 Nov 2005 23:05:18 -0000 @@ -53,205 +53,6 @@

-The Gentoo Installation Approaches - -Introduction - - -

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. -

- -

- A stage1 file contains nothing more than a compiler, Portage (Gentoo's - software management system) and a couple of packages on which the compiler - or Portage depends. -
- A stage2 file contains a so-called bootstrapped system, a minimal - environment from which one can start building all other necessary - applications that make a Gentoo environment complete. -
- A stage3 file contains a prebuilt minimal system which is almost fully - deployable. It only lacks a few applications where you, the Gentoo user, - needs to choose which one you want to install. -

- -

-To help you decide what stage file you want to use, we have written down the -major advantages and disadvantages of each stage file. -

- - - - -A Stage1 Approach - - -

-A stage1 is used when you want to bootstrap and build the entire system -from scratch. -

- -

-However, if you do not plan to tweak the bootstrapping instructions in the -bootstrap.sh script written by the Gentoo developers, then a -stage1 approach has no benefits for you. -

Stage1	Pros and Cons
+
+
-
-
-

- - - - -A Stage2 Approach - - -

-A stage2 is used for building the entire system from a bootstrapped -"semi-compiled" state. -

- -

Stage2	Pros and Cons
+
+
+
-
-

- - - - -A Stage3 Approach - - -

- -

- - - - - - - - - Fastest way to get a Gentoo base system - - - - - You can still tweak your system - - -

Stage3	Pros and Cons
+
+

- -

- - - -

The Gentoo Installation CDs Introduction @@ -290,9 +91,8 @@

@@ -323,16 +123,9 @@ Smallest download - + - - You can do a stage1, stage2 or stage3 by getting the stage tarball off the - net - - - - - Contains no stages, no Portage snapshot, no prebuilt packages and is + Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is therefore not suitable for networkless installation @@ -388,7 +181,24 @@

+ + + + +The Stage3 Tarball + + +

Index: handbook/index.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/index.xml,v retrieving revision 1.54 diff -u -t -r1.54 index.xml --- handbook/index.xml 8 Aug 2005 13:48:40 -0000 1.54 +++ handbook/index.xml 5 Nov 2005 23:05:18 -0000 @@ -290,9 +290,7 @@

By not separating the instructions for each possible option, the user can view the results of the other choices easily. This provides a better view on the -installation instructions for the user: even though they chose - for -instance - stage3, they are easily informed about what stage2 or stage1 does. -Not hiding these instructions is a good thing. +installation instructions for the user.

@@ -302,14 +300,9 @@

-You are reading the wrong Gentoo Handbook. -

- -

-The release-specific Gentoo Handbooks (such as the 2005.0 one) are meant for -networkless installations only. Running a stage1 or stage2 installation requires -source code that isn't available on the universal installation CD, so you would -need a working Internet connection to do a stage1 or stage2 installation. +Instructions on using a stage1 or stage2 tarball are now available in the Gentoo FAQ. A stage3 installation is the +only supported installation as of now.

Index: handbook/2005.1/hb-install-alpha-medium.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-medium.xml,v retrieving revision 1.3 diff -u -t -r1.3 hb-install-alpha-medium.xml --- handbook/2005.1/hb-install-alpha-medium.xml 25 Aug 2005 19:53:25 -0000 1.3 +++ handbook/2005.1/hb-install-alpha-medium.xml 5 Nov 2005 23:05:21 -0000 @@ -64,35 +64,15 @@

-Gentoo Linux can be installed using one of three stage tarball files. -A stage file is a tarball (compressed archive) that contains a minimal -environment. +Gentoo Linux can be installed using a stage3 tarball file. +Such a tarball is an archive that contains a minimal environment from +which you can succesfully install Gentoo Linux onto your system.

- A stage1 file contains nothing more than a compiler, Portage (Gentoo's - software management system) and a couple of packages on which the compiler - or Portage depends. -
- A stage2 file contains a so-called bootstrapped system, a minimal - environment from which one can start building all other necessary - applications that make a Gentoo environment complete. -
- A stage3 file contains a prebuilt minimal system which is almost fully - deployable. It only lacks a few applications where you, the Gentoo user, - needs to choose which one you want to install. -

-We will opt for a stage3 installation throughout this document. If you want to -perform a Gentoo installation using the stage1 or stage2 files, please use the -installation instructions in the Gentoo Handbook. They do -require a working Internet connection though. +Installations using a stage1 or stage2 tarball file are not documented in the +Gentoo Handbook - please read the Gentoo +FAQ on these matters.

Index: handbook/2005.1/hb-install-amd64-medium.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-medium.xml,v retrieving revision 1.2 diff -u -t -r1.2 hb-install-amd64-medium.xml --- handbook/2005.1/hb-install-amd64-medium.xml 8 Aug 2005 13:24:46 -0000 1.2 +++ handbook/2005.1/hb-install-amd64-medium.xml 5 Nov 2005 23:05:22 -0000 @@ -64,35 +64,15 @@

-Gentoo Linux can be installed using one of three stage tarball files. A -stage file is a tarball (compressed archive) that contains a minimal -environment. +Gentoo Linux can be installed using a stage3 tarball file. +Such a tarball is an archive that contains a minimal environment from +which you can succesfully install Gentoo Linux onto your system.

- A stage1 file contains nothing more than a compiler, Portage (Gentoo's - software management system) and a couple of packages on which the - compiler or Portage depends. -
- A stage2 file contains a so-called bootstrapped system, a minimal - environment from which one can start building all other necessary - applications that make a Gentoo environment complete. -
- A stage3 file contains a prebuilt minimal system which is almost fully - deployable. It only lacks a few applications where you, the Gentoo user, - needs to choose which one you want to install. -

Index: handbook/2005.1/hb-install-hppa-medium.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-medium.xml,v retrieving revision 1.2 diff -u -t -r1.2 hb-install-hppa-medium.xml --- handbook/2005.1/hb-install-hppa-medium.xml 8 Aug 2005 13:24:46 -0000 1.2 +++ handbook/2005.1/hb-install-hppa-medium.xml 5 Nov 2005 23:05:22 -0000 @@ -62,35 +62,15 @@

- A stage1 file contains nothing more than a compiler, Portage (Gentoo's - software management system) and a couple of packages on which the - compiler or Portage depends. -
- A stage2 file contains a so-called bootstrapped system, a minimal - environment from which one can start building all other necessary - applications that make a Gentoo environment complete. -
- A stage3 file contains a prebuilt minimal system which is almost fully - deployable. It only lacks a few applications where you, the Gentoo user, - needs to choose which one you want to install. -

Index: handbook/2005.1/hb-install-ppc-medium.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-medium.xml,v retrieving revision 1.3 diff -u -t -r1.3 hb-install-ppc-medium.xml --- handbook/2005.1/hb-install-ppc-medium.xml 17 Aug 2005 06:48:04 -0000 1.3 +++ handbook/2005.1/hb-install-ppc-medium.xml 5 Nov 2005 23:05:24 -0000 @@ -87,35 +87,15 @@

- A stage1 file contains nothing more than a compiler, Portage (Gentoo's - software management system) and a couple of packages on which the - compiler or Portage depends. -
- A stage2 file contains a so-called bootstrapped system, a minimal - environment from which one can start building all other necessary - applications that make a Gentoo environment complete. -
- A stage3 file contains a prebuilt minimal system which is almost fully - deployable. It only lacks a few applications where you, the Gentoo user, - needs to choose which one you want to install. -

Index: handbook/2005.1/hb-install-ppc64-medium.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc64-medium.xml,v retrieving revision 1.3 diff -u -t -r1.3 hb-install-ppc64-medium.xml --- handbook/2005.1/hb-install-ppc64-medium.xml 13 Sep 2005 20:39:12 -0000 1.3 +++ handbook/2005.1/hb-install-ppc64-medium.xml 5 Nov 2005 23:05:24 -0000 @@ -70,41 +70,15 @@

-The Gentoo/PPC64 team provides you with additional options at this point. -You have the choice to use a 32bit or a 64bit userland; a full set of stages -is provided for both options. -

- -

- A stage1 file contains nothing more than a compiler, Portage (Gentoo's - software management system) and a couple of packages on which the - compiler or Portage depends. -
- A stage2 file contains a so-called bootstrapped system, a minimal - environment from which one can start building all other necessary - applications that make a Gentoo environment complete. -
- A stage3 file contains a prebuilt minimal system which is almost fully - deployable. It only lacks a few applications where you, the Gentoo user, - needs to choose which one you want to install. -

- -

Index: handbook/2005.1/hb-install-sparc-medium.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-medium.xml,v retrieving revision 1.3 diff -u -t -r1.3 hb-install-sparc-medium.xml --- handbook/2005.1/hb-install-sparc-medium.xml 5 Sep 2005 15:22:02 -0000 1.3 +++ handbook/2005.1/hb-install-sparc-medium.xml 5 Nov 2005 23:05:25 -0000 @@ -77,35 +77,15 @@

- A stage1 file contains nothing more than a compiler, Portage (Gentoo's - software management system) and a couple of packages on which the - compiler or Portage depends. -
- A stage2 file contains a so-called bootstrapped system, a minimal - environment from which one can start building all other necessary - applications that make a Gentoo environment complete. -
- A stage3 file contains a prebuilt minimal system which is almost fully - deployable. It only lacks a few applications where you, the Gentoo user, - needs to choose which one you want to install. -

Index: handbook/2005.1/hb-install-stage.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-stage.xml,v retrieving revision 1.7 diff -u -t -r1.7 hb-install-stage.xml --- handbook/2005.1/hb-install-stage.xml 16 Aug 2005 21:56:01 -0000 1.7 +++ handbook/2005.1/hb-install-stage.xml 5 Nov 2005 23:05:27 -0000 @@ -180,6 +180,11 @@

+Make sure you download a stage3 tarball - installations using a stage1 or stage2 +tarball are not supported anymore. +

+ +

If you want to check the integrity of the downloaded stage tarball, use md5sum and compare the output with the MD5 checksum provided on the mirror. For instance, to check the validity of the x86 stage tarball: @@ -346,16 +351,11 @@ CHOST - -Although it might be tempting for non-stage1 users, they should not -change the CHOST setting in make.conf. Doing so might render -their system unusable. Again: only change this variable if you use a -stage1 installation. - -

-The networkless installation approach only supports stage3 installations. Do not -touch the CHOST variable! +The CHOST variable declares the target build host for your system. This +variable should already be set to the correct value. Do not edit +it as that might break your system. If the CHOST variable does +not look correct to you, you might be using the wrong stage3 tarball.

Index: handbook/2005.1/hb-install-x86-medium.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-medium.xml,v retrieving revision 1.3 diff -u -t -r1.3 hb-install-x86-medium.xml --- handbook/2005.1/hb-install-x86-medium.xml 25 Aug 2005 19:53:25 -0000 1.3 +++ handbook/2005.1/hb-install-x86-medium.xml 5 Nov 2005 23:05:27 -0000 @@ -60,35 +60,15 @@

- A stage1 file contains nothing more than a compiler, Portage (Gentoo's - software management system) and a couple of packages on which the - compiler or Portage depends. -
- A stage2 file contains a so-called bootstrapped system, a minimal - environment from which one can start building all other necessary - applications that make a Gentoo environment complete. -
- A stage3 file contains a prebuilt minimal system which is almost fully - deployable. It only lacks a few applications where you, the Gentoo user, - needs to choose which one you want to install. -