| 1 |
nightmorph 10/06/14 20:22:18 |
| 2 |
|
| 3 |
Modified: altinstall.xml |
| 4 |
Log: |
| 5 |
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. |
| 6 |
|
| 7 |
Revision Changes Path |
| 8 |
1.77 xml/htdocs/doc/en/altinstall.xml |
| 9 |
|
| 10 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/altinstall.xml?rev=1.77&view=markup |
| 11 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/altinstall.xml?rev=1.77&content-type=text/plain |
| 12 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/altinstall.xml?r1=1.76&r2=1.77 |
| 13 |
|
| 14 |
Index: altinstall.xml |
| 15 |
=================================================================== |
| 16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/altinstall.xml,v |
| 17 |
retrieving revision 1.76 |
| 18 |
retrieving revision 1.77 |
| 19 |
diff -u -r1.76 -r1.77 |
| 20 |
--- altinstall.xml 10 Sep 2008 23:04:29 -0000 1.76 |
| 21 |
+++ altinstall.xml 14 Jun 2010 20:22:17 -0000 1.77 |
| 22 |
@@ -1,8 +1,8 @@ |
| 23 |
<?xml version='1.0' encoding="UTF-8"?> |
| 24 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/altinstall.xml,v 1.76 2008/09/10 23:04:29 nightmorph Exp $ --> |
| 25 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/altinstall.xml,v 1.77 2010/06/14 20:22:17 nightmorph Exp $ --> |
| 26 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 27 |
|
| 28 |
-<guide link="/doc/en/altinstall.xml"> |
| 29 |
+<guide> |
| 30 |
|
| 31 |
<title>The Gentoo Linux alternative installation method HOWTO</title> |
| 32 |
|
| 33 |
@@ -59,8 +59,8 @@ |
| 34 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 35 |
<license/> |
| 36 |
|
| 37 |
-<version>1</version> |
| 38 |
-<date>2008-09-10</date> |
| 39 |
+<version>2</version> |
| 40 |
+<date>2010-06-14</date> |
| 41 |
|
| 42 |
<chapter> |
| 43 |
<title>About this document</title> |
| 44 |
@@ -162,43 +162,53 @@ |
| 45 |
</chapter> |
| 46 |
|
| 47 |
<chapter> |
| 48 |
-<title>Knoppix Installation</title> |
| 49 |
+<title>Installation from non-Gentoo LiveCDs</title> |
| 50 |
<section> |
| 51 |
+<title>Introduction</title> |
| 52 |
<body> |
| 53 |
|
| 54 |
-<note> |
| 55 |
-Knoppix is only available for x86 users. |
| 56 |
-</note> |
| 57 |
+<impo> |
| 58 |
+The Gentoo developers cannot support you if something goes wrong with a |
| 59 |
+non-Gentoo LiveCD, as there's no way to fix, troubleshoot, or document every |
| 60 |
+quirk of every LiveCD out there. Only Gentoo LiveCDs are officially supported. |
| 61 |
+If you run into problems with alternative installation media, please visit the |
| 62 |
+<uri link="http://forums.gentoo.org">Gentoo Forums</uri> for community help. |
| 63 |
+</impo> |
| 64 |
|
| 65 |
-<!-- this works with knoppix 3.6+ and gentoo 2004.3, 2005.0--> |
| 66 |
+<p> |
| 67 |
+It is possible to boot some other LiveCD besides the Gentoo-provided CDs. This |
| 68 |
+will give you a functional environment to use while you're compiling and |
| 69 |
+installing Gentoo. The instructions provided here should work in principle with |
| 70 |
+just about any other LiveCD. |
| 71 |
+</p> |
| 72 |
|
| 73 |
<p> |
| 74 |
-Booting from the <uri link="http://www.knoppix.org/">Knoppix</uri> LiveCD is a |
| 75 |
-way to have a fully functional system while you're compiling Gentoo. Tux Racer |
| 76 |
-will help you pass the time while you wait, and you can use OpenOffice for |
| 77 |
-work. |
| 78 |
+There are too many LiveCDs out there to <uri |
| 79 |
+link="http://distrowatch.com/search.php">list</uri>, but you might try <uri |
| 80 |
+link="http://www.knoppix.org/">Knoppix</uri>. It provides a full graphical |
| 81 |
+desktop, with office applications, web browsers, and games to keep you busy. |
| 82 |
+Knoppix is only available for x86 users, so depending on your needs you may need |
| 83 |
+to find a different LiveCD. |
| 84 |
</p> |
| 85 |
|
| 86 |
<warn> |
| 87 |
-Be aware that if you save anything in Knoppix's home directory while waiting |
| 88 |
+Be aware that if you save anything in your LiveCD's home directory while waiting |
| 89 |
for your Gentoo system to install, it will not be available when you reboot |
| 90 |
into Gentoo. Be sure to save important files on the hard disk or on some other |
| 91 |
computer! |
| 92 |
</warn> |
| 93 |
|
| 94 |
-<p> |
| 95 |
-Boot from the Knoppix CD. If you have Knoppix 3.6-3.8.2, you will need to |
| 96 |
-specify <c>knoppix26</c> as a boot option to load a 2.6 kernel. If you miss |
| 97 |
-this step, when you <c>chroot</c>, you will recieve an error saying that your |
| 98 |
-kernel is too old. If, however, you have Knoppix 3.9+, this step is |
| 99 |
-unnecessary, since the 2.6 kernel is default. |
| 100 |
-</p> |
| 101 |
+</body> |
| 102 |
+</section> |
| 103 |
+<section> |
| 104 |
+<title>Installation instructions</title> |
| 105 |
+<body> |
| 106 |
|
| 107 |
<p> |
| 108 |
-By default Knoppix boots into a KDE desktop. Open a <c>konsole</c> and <c>su |
| 109 |
--</c> so you can change your password. This lets you set the root password for |
| 110 |
-Knoppix. You can now configure <c>sshd</c> for remote login, at your |
| 111 |
-preference. |
| 112 |
+Boot from your LiveCD. Open a terminal and run <c>su -</c> so you can change your |
| 113 |
+password. This lets you set the root password for the CD. You can now configure |
| 114 |
+<c>sshd</c> for remote login, if you need to install Gentoo remotely. Next, |
| 115 |
+you'll need to create the <path>/mnt/gentoo</path> mountpoint. |
| 116 |
</p> |
| 117 |
|
| 118 |
<pre caption="Creating the /mnt/gentoo mountpoint"> |
| 119 |
@@ -217,10 +227,21 @@ |
| 120 |
</pre> |
| 121 |
|
| 122 |
<p> |
| 123 |
-Also, know that some of Portage's FEATURES will not work in knoppix. Especially |
| 124 |
+When you're ready to unpack the stage tarball in <uri |
| 125 |
+link="/doc/en/handbook/handbook-x86.xml?part=1&chap=5">part 5</uri>, you |
| 126 |
+will need to use a different <c>tar</c> command to ensure that proper group IDs |
| 127 |
+are enforced on the unpacked stage: |
| 128 |
+</p> |
| 129 |
+ |
| 130 |
+<pre caption="Unpacking the stage tarball"> |
| 131 |
+# <i>tar --numeric-owner -xvjpf stage3-*.tar.bz2</i> |
| 132 |
+</pre> |
| 133 |
+ |
| 134 |
+<p> |
| 135 |
+Finally, know that some Portage FEATURES may not work in your LiveCD. Especially |
| 136 |
watch out for <c>userpriv</c> and <c>usersandbox</c>. If you find yourself |
| 137 |
getting errors, it might be wise to disable some or all of the optional |
| 138 |
-features. |
| 139 |
+FEATURES. |
| 140 |
</p> |
| 141 |
|
| 142 |
<!-- |
Archives