Gentoo Archives: gentoo-doc-cvs

From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: altinstall.xml
Date: Mon, 14 Jun 2010 20:22:22
nightmorph    10/06/14 20:22:18

  Modified:             altinstall.xml
  rewrite the altinstall guide to be more generic about non-Gentoo LiveCDs, also made it clearer that they are unsupported if something goes wrong with them. also included a tip from bug 323973 when extracting the stage tarball.

Revision  Changes    Path
1.77                 xml/htdocs/doc/en/altinstall.xml

file :
diff :

Index: altinstall.xml
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/altinstall.xml,v
retrieving revision 1.76
retrieving revision 1.77
diff -u -r1.76 -r1.77
--- altinstall.xml	10 Sep 2008 23:04:29 -0000	1.76
+++ altinstall.xml	14 Jun 2010 20:22:17 -0000	1.77
@@ -1,8 +1,8 @@
 <?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/altinstall.xml,v 1.76 2008/09/10 23:04:29 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/altinstall.xml,v 1.77 2010/06/14 20:22:17 nightmorph Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<guide link="/doc/en/altinstall.xml">
 <title>The Gentoo Linux alternative installation method HOWTO</title>
@@ -59,8 +59,8 @@
 <!-- See -->
 <title>About this document</title>
@@ -162,43 +162,53 @@
-<title>Knoppix Installation</title>
+<title>Installation from non-Gentoo LiveCDs</title>
-Knoppix is only available for x86 users.
+The Gentoo developers cannot support you if something goes wrong with a
+non-Gentoo LiveCD, as there's no way to fix, troubleshoot, or document every
+quirk of every LiveCD out there. Only Gentoo LiveCDs are officially supported.
+If you run into problems with alternative installation media, please visit the
+<uri link="">Gentoo Forums</uri> for community help.
-<!-- this works with knoppix 3.6+ and gentoo 2004.3, 2005.0-->
+It is possible to boot some other LiveCD besides the Gentoo-provided CDs. This
+will give you a functional environment to use while you're compiling and
+installing Gentoo. The instructions provided here should work in principle with
+just about any other LiveCD.
-Booting from the <uri link="">Knoppix</uri> LiveCD is a
-way to have a fully functional system while you're compiling Gentoo. Tux Racer
-will help you pass the time while you wait, and you can use OpenOffice for
+There are too many LiveCDs out there to <uri
+link="">list</uri>, but you might try <uri
+link="">Knoppix</uri>. It provides a full graphical
+desktop, with office applications, web browsers, and games to keep you busy.
+Knoppix is only available for x86 users, so depending on your needs you may need
+to find a different LiveCD.
-Be aware that if you save anything in Knoppix's home directory while waiting
+Be aware that if you save anything in your LiveCD's home directory while waiting
 for your Gentoo system to install, it will not be available when you reboot
 into Gentoo. Be sure to save important files on the hard disk or on some other
-Boot from the Knoppix CD. If you have Knoppix 3.6-3.8.2, you will need to
-specify <c>knoppix26</c> as a boot option to load a 2.6 kernel. If you miss
-this step, when you <c>chroot</c>, you will recieve an error saying that your
-kernel is too old. If, however, you have Knoppix 3.9+, this step is
-unnecessary, since the 2.6 kernel is default.
+<title>Installation instructions</title>
-By default Knoppix boots into a KDE desktop. Open a <c>konsole</c> and <c>su
--</c> so you can change your password. This lets you set the root password for
-Knoppix. You can now configure <c>sshd</c> for remote login, at your
+Boot from your LiveCD. Open a terminal and run <c>su -</c> so you can change your
+password. This lets you set the root password for the CD. You can now configure
+<c>sshd</c> for remote login, if you need to install Gentoo remotely. Next,
+you'll need to create the <path>/mnt/gentoo</path> mountpoint.
 <pre caption="Creating the /mnt/gentoo mountpoint">
@@ -217,10 +227,21 @@
-Also, know that some of Portage's FEATURES will not work in knoppix. Especially
+When you're ready to unpack the stage tarball in <uri
+link="/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=5">part 5</uri>, you
+will need to use a different <c>tar</c> command to ensure that proper group IDs
+are enforced on the unpacked stage:
+<pre caption="Unpacking the stage tarball">
+# <i>tar --numeric-owner -xvjpf stage3-*.tar.bz2</i>
+Finally, know that some Portage FEATURES may not work in your LiveCD. Especially
 watch out for <c>userpriv</c> and <c>usersandbox</c>. If you find yourself
 getting errors, it might be wise to disable some or all of the optional