/[gentoo]/xml/htdocs/doc/en/altinstall.xml
Gentoo

Diff of /xml/htdocs/doc/en/altinstall.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.75 Revision 1.79
1<?xml version='1.0' encoding="UTF-8"?> 1<?xml version='1.0' encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/altinstall.xml,v 1.75 2008/05/23 20:29:44 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/altinstall.xml,v 1.79 2010/09/26 21:59:41 jkt Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide link="/doc/en/altinstall.xml"> 5<guide>
6 6
7<title>The Gentoo Linux alternative installation method HOWTO</title> 7<title>The Gentoo Linux alternative installation method HOWTO</title>
8 8
9<author title="Contributor"> 9<author title="Contributor">
10 <mail link="gerrynjr@gentoo.org">Gerald Normandin Jr.</mail> 10 <mail link="gerrynjr@gentoo.org">Gerald Normandin Jr.</mail>
42<author title="Editor"> 42<author title="Editor">
43 <mail link="bennyc@gentoo.org">Benny Chuang</mail> 43 <mail link="bennyc@gentoo.org">Benny Chuang</mail>
44</author> 44</author>
45<author title="Editor"> 45<author title="Editor">
46 <mail link="smithj@gentoo.org">Jonathan Smith</mail> 46 <mail link="smithj@gentoo.org">Jonathan Smith</mail>
47</author>
48<author title="Editor">
49 <mail link="nightmorph"/>
47</author> 50</author>
48 51
49<abstract> 52<abstract>
50This HOWTO is meant to be a repository of alternative Gentoo installation 53This HOWTO is meant to be a repository of alternative Gentoo installation
51methods, for those with special installation needs such as lack of a cdrom 54methods, for those with special installation needs such as lack of a cdrom
54 57
55<!-- The content of this document is licensed under the CC-BY-SA license --> 58<!-- The content of this document is licensed under the CC-BY-SA license -->
56<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 59<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
57<license/> 60<license/>
58 61
59<version>0.73</version> 62<version>4</version>
60<date>2008-01-09</date> 63<date>2010-09-26</date>
61 64
62<chapter> 65<chapter>
63<title>About this document</title> 66<title>About this document</title>
64<section> 67<section>
65<body> 68<body>
157</body> 160</body>
158</section> 161</section>
159</chapter> 162</chapter>
160 163
161<chapter> 164<chapter>
162<title>Knoppix Installation</title> 165<title>Installation from non-Gentoo LiveCDs</title>
163<section> 166<section>
167<title>Introduction</title>
164<body> 168<body>
165 169
166<note> 170<impo>
167Knoppix is only available for x86 users. 171The Gentoo developers cannot support you if something goes wrong with a
168</note> 172non-Gentoo LiveCD, as there's no way to fix, troubleshoot, or document every
173quirk of every LiveCD out there. Only Gentoo LiveCDs are officially supported.
174If you run into problems with alternative installation media, please visit the
175<uri link="http://forums.gentoo.org">Gentoo Forums</uri> for community help.
176</impo>
169 177
170<!-- this works with knoppix 3.6+ and gentoo 2004.3, 2005.0--> 178<p>
171 179It is possible to boot some other LiveCD besides the Gentoo-provided CDs. This
180will give you a functional environment to use while you're compiling and
181installing Gentoo. The instructions provided here should work in principle with
182just about any other LiveCD.
172<p> 183</p>
173Booting from the <uri link="http://www.knoppix.org/">Knoppix</uri> LiveCD is a 184
174way to have a fully functional system while you're compiling Gentoo. Tux Racer 185<p>
175will help you pass the time while you wait, and you can use OpenOffice for 186There are too many LiveCDs out there to <uri
176work. 187link="http://distrowatch.com/search.php">list</uri>, but you might try <uri
188link="http://www.knoppix.org/">Knoppix</uri>. It provides a full graphical
189desktop, with office applications, web browsers, and games to keep you busy.
190Knoppix is only available for x86 users, so depending on your needs you may need
191to find a different LiveCD.
177</p> 192</p>
178 193
179<warn> 194<warn>
180Be aware that if you save anything in Knoppix's home directory while waiting 195Be aware that if you save anything in your LiveCD's home directory while waiting
181for your Gentoo system to install, it will not be available when you reboot 196for your Gentoo system to install, it will not be available when you reboot
182into Gentoo. Be sure to save important files on the hard disk or on some other 197into Gentoo. Be sure to save important files on the hard disk or on some other
183computer! 198computer!
184</warn> 199</warn>
185 200
186<p> 201</body>
187Boot from the Knoppix CD. If you have Knoppix 3.6-3.8.2, you will need to 202</section>
188specify <c>knoppix26</c> as a boot option to load a 2.6 kernel. If you miss 203<section>
189this step, when you <c>chroot</c>, you will recieve an error saying that your 204<title>Installation instructions</title>
190kernel is too old. If, however, you have Knoppix 3.9+, this step is 205<body>
191unnecessary, since the 2.6 kernel is default. 206
192</p> 207<p>
193 208Boot from your LiveCD. Open a terminal and run <c>su -</c> so you can change your
194<p> 209password. This lets you set the root password for the CD. You can now configure
195By default Knoppix boots into a KDE desktop. Open a <c>konsole</c> and <c>su 210<c>sshd</c> for remote login, if you need to install Gentoo remotely. Next,
196-</c> so you can change your password. This lets you set the root password for 211you'll need to create the <path>/mnt/gentoo</path> mountpoint.
197Knoppix. You can now configure <c>sshd</c> for remote login, at your
198preference.
199</p> 212</p>
200 213
201<pre caption="Creating the /mnt/gentoo mountpoint"> 214<pre caption="Creating the /mnt/gentoo mountpoint">
202# <i>mkdir /mnt/gentoo</i> 215# <i>mkdir /mnt/gentoo</i>
203</pre> 216</pre>
212<pre caption="Bind-mounting the proc pseudo filesystem"> 225<pre caption="Bind-mounting the proc pseudo filesystem">
213# <i>mount -o bind /proc /mnt/gentoo/proc</i> 226# <i>mount -o bind /proc /mnt/gentoo/proc</i>
214</pre> 227</pre>
215 228
216<p> 229<p>
230When you're ready to unpack the stage tarball in <uri
231link="/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=5_sect4">part 5</uri>, you
232will need to use a different <c>tar</c> command to ensure that proper group IDs
233are enforced on the unpacked stage:
234</p>
235
236<pre caption="Unpacking the stage tarball">
237# <i>tar --numeric-owner -xvjpf stage3-*.tar.bz2</i>
238</pre>
239
240<p>
241Once you're ready to chroot into your unpacked stage in <uri
242link="/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=6#doc_chap1">part
2436</uri>, you will need to use a different chroot command sequence. This ensures
244that your environment variables are properly setup.
245</p>
246
247<pre caption="Chrooting into the new environment">
248# <i>chroot / /bin/env -i TERM="${TERM}" /bin/bash</i>
249# <i>env-update</i>
250# <i>source /etc/profile</i>
251# <i>export PS1="(chroot) $PS1"</i>
252</pre>
253
254<p>
217Also, know that some of Portage's FEATURES will not work in knoppix. Especially 255Finally, know that some Portage FEATURES may not work in your LiveCD. Especially
218watch out for <c>userpriv</c> and <c>usersandbox</c>. If you find yourself 256watch out for <c>userpriv</c> and <c>usersandbox</c>. If you find yourself
219getting errors, it might be wise to disable some or all of the optional 257getting errors, it might be wise to disable some or all of the optional
220features. 258FEATURES.
221</p> 259</p>
222 260
223<!-- 261<!--
224 Commenting out due to #78716. If it needs to be restated again, note 262 Commenting out due to #78716. If it needs to be restated again, note
225 that some will require to bind-mount it, others don't, and that you have 263 that some will require to bind-mount it, others don't, and that you have
278# <i>mkdir /diskless/eta/boot</i> 316# <i>mkdir /diskless/eta/boot</i>
279</pre> 317</pre>
280 318
281<p> 319<p>
282DHCP and TFTP setup: The client will get boot informations using DHCP and 320DHCP and TFTP setup: The client will get boot informations using DHCP and
283download all the required files using TFTP. Just emerge DHCP and configure it 321download all the required files using TFTP.
284for your basic needs. Then, add the following on 322</p>
323
324<p>
325For dhcpd, just run <c>emerge dhcp</c> (or any other DHCP server of your
326choice). Make sure that the correct interface is selected in
327<path>/etc/conf.d/dhcpd</path>, and configure it for your basic needs. Then, add
285<path>/etc/dhcp/dhcpd.conf</path>. 328the following on <path>/etc/dhcp/dhcpd.conf</path>.
286</p> 329</p>
287 330
288<note> 331<note>
289This provide a static IP address for the client and the path of a PXE boot 332This provides a static IP address for the client and the path of a PXE boot
290image, here <path>pxegrub</path>. You have to replace the MAC address of the 333image, here <path>pxegrub</path>. You have to replace the MAC address of the
291Ethernet card of the client and the directory where you will put the client 334ethernet card of the client and the directory where you will put the client
292files with the one you use. 335files with the one you use.
293</note> 336</note>
294
295<p>
296For DHCPd, run <c>emerge dhcp</c> (or any other DHCP server of your choice).
297Make sure that the correct interface is selected in
298<path>/etc/conf.d/dhcpd</path>.
299</p>
300 337
301<pre caption="dhcpd.conf"> 338<pre caption="dhcpd.conf">
302option option-150 code 150 = text ; 339option option-150 code 150 = text ;
303ddns-update-style none ; 340ddns-update-style none ;
304host eta { 341host eta {

Legend:
Removed from v.1.75  
changed lines
  Added in v.1.79

  ViewVC Help
Powered by ViewVC 1.1.20