ln -s /proc /mnt/gentoo/proc confirmed with the quick install guide. my dad was hung at that step, but I've seen this step done before so I knew something was missing. I believe that there were other omissions, the quick install guide brought us right through the install Reproducible: Always Steps to Reproduce: 1. 2. 3. major because noboday can install gentoo without this step
once your inside the chroot the symlink wont resolve dont know what guide you're talking about, but both the quick install and the handbook say to `mount -t proc none /mnt/gentoo/proc`
It's not in chapter 5 or 6 http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=6 [ << ] [ < ] [ Home ] [ Print ] [ > ] [ >> ] 6. Installing the Gentoo Base System Content: Chrooting Differences between Stage1, Stage2 and Stage3 Progressing from Stage1 to Stage2 Progressing from Stage2 to Stage3 6.a. Chrooting Optional: Selecting Mirrors If you have booted from a Gentoo LiveCD, you are able to use mirrorselect to update /etc/make.conf so fast mirrors are used for both Portage and source code (of course in case you have a working network connection): Code Listing 1: Selecting fast mirrors # mirrorselect -a -s4 -o >> /mnt/gentoo/etc/make.conf If for some reason mirrorselect fails, don't panic. This step is completely optional, the default values suffice. Copy DNS Info One thing still remains to be done before we enter the new environment and that is copying over the DNS information in /etc/resolv.conf. You need to do this to ensure that networking still works even after entering the new environment. /etc/resolv.conf contains the nameservers for your network. Code Listing 2: Copy over DNS information (The "-L" option is needed to make sure we don't copy a symbolic link) # cp -L /etc/resolv.conf /mnt/gentoo/etc/resolv.conf Entering the new Environment Now that all partitions are initialized and the base environment installed, it is time to enter our new installation environment by chrooting into it. This means that we change from the current installation environment (LiveCD or other installation medium) to your installation system (namely the initialized partitions). This chrooting is done in three steps. First we will change the root from / (on the installation medium) to /mnt/gentoo (on your partitions) using chroot. Then we will create a new environment using env-update, which essentially creates environment variables. Finally, we load those variables into memory using source. Code Listing 3: Chrooting into the new environment # chroot /mnt/gentoo /bin/bash # env-update Regenerating /etc/ld.so.cache... # source /etc/profile
Nope, it's in chapter 4: http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=1&chap=4 """ We also need to mount the proc filesystem (a virtual interface with the kernel) on /proc. We first create the /mnt/gentoo/proc mountpoint and then mount the filesystem: Code Listing 16: Creating the /mnt/gentoo/proc mountpoint # mkdir /mnt/gentoo/proc # mount -t proc none /mnt/gentoo/proc Now continue with Installing the Gentoo Installation Files """
ok, well, if there is a problem, this goes with the chrooting, belongs with the chrooting. This was a major head banger, and it used to be with the chrooting section in the old install guide. This is important! I changed the title and the severaty because you convinced me that it is in the handbook, but it's not where it belongs.
I disagree. This is a mounting step and thus belongs in the mounting section which is part of the 4th chapter. Note that the order of the command (wether run in chapter 4 or just before the chrooting in chapter 6) doesn't change anything wrt functionality. The quickinstall does the mount step before the chroot, but that's just a minor issue and it's part of the same command sequence.
Ok.. I'm not reopening it this go around, but I have a strong sence that at least a reference to that command is required in section 6.. because the problem of skipping that step in section 4 doesn't crop up untill section 6. The end user needs it in section 6. and I'm sure that a few people have stopped trying to install gentoo because going to the forum and irc channels are just way too much hastle. My dad was going to give up at this step, I looked for a missed command, and DIDN'T FIND ONE... I didn't go back that far... because steps should only be presented when they are needed... and remembered my chrooting, and how proc was involved, then I looked up the quick install guide, and NEVER WENT BACK TO the handbook install guide. This is a blocker to entry for many potential gentoo users.
I don't mean to be too annoying... This is important, and it's relatively easy to fix. i'm resorting to reopening the bug.. hopefully somebody will see the importance of it. just something like: did you rembember to mount /proc to /mnt/gentoo/proc ? (see section 4.e) will save a lot of people a lot of frustration.
Most (if not all) steps in the installation instructions are important. If you forget to unpack your stage tarball you can't continue. If you forget to chroot you can't continue. If you forget to run grub you can't boot. The installation instructions are already quite verbose. This is good, but we shouldn't go duplicate information throughout the document. If we go point to each important step, the installation instructions would increase by 100% (okay, that's a bit exaggerated, but still). I'll leave it REOPENED for the time being so we don't have to discuss this everytime by INVALID/REOPENED/INVALID/REOPENED, but I really don't think that adding a reminder is a positive result here.
Well, if you forget to mount the created partitions under /mnt/gentoo, the chroot command will also fail. That doesn't mean that those instructions should be moved to the chroot stuff as well, does it? There are many ways how to divide the installation instructions. There are fixed sequences (such as "don't mount before partitioning") which shouldn't be touched. Other instructions are open for suggestions on how to place them in the documentation. I'm personally convinced that all mounting should be grouped together. Your vision is more like "we should postpone commands until they are really necessary" (correct me if I'm wrong). Both visions are conflicting and I don't think your vision can be accurately executed in an installation instruction sequence that has this many options and choices for the users.
Marking as INVALID again. For reasoning see above.
Sorry, I hang out on IRC and try to help newbies. They have problems with this issue. Heck, I had problems with this, but I had used a previous version of the manual before, and knew I was missing something, and sought the quick reference. In any great documentation, there is going to be a bit of duplication, or self reference, or rephrasing of things in a different way. When we speak, we have patterns of expression, that allow the listener to fill in the parts of what we say, with what we normally say. This is a form of error control. Shakespeare repeated many themes in his plays, to help the audience if they missed something. The documentation is for newbies, and need the repetition, to help them learn AND it is for people who are looking for how to solve something. Scrolling through a 30 page document is not a big help. minor Duplication of key content, especially with cross referencing, (or an included sub page) will help the user find the information quickly, based on the problem that the user is attempting to solve. I MUST, on my conscious, REOPEN this feature request, as I feel that the concepts held within are vital to the success of this project. -Aaron Peterson I am available on IRC as MrDarkUser or PetrifiedSap 509 332 7697 is my telephone number, my roommate is out at the moment, so call me any time. (I live in GMT -7, PST, Washington State, USA) and I'm normally awake between noon and 3 am.... just call, We'll ignore you if we're sleeping ICQ 2302806
Okay, I've moved the mounting of /proc to right before the chrooting. If I'm now haunted by others, I'll just pass along your phone number :)
