/[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.81
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.81 2010/09/27 11:06:12 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>6</version>
60<date>2008-01-09</date> 63<date>2010-09-27</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<comment>(Some LiveCDs use a funny environment setup, hence the -i option for
249cleaning it up to a reasonable state.)</comment>
250# <i>chroot /mnt/gentoo /bin/env -i TERM=$TERM /bin/bash</i>
251# <i>env-update</i>
252# <i>source /etc/profile</i>
253# <i>export PS1="(chroot) $PS1"</i>
254</pre>
255
256<p>
217Also, know that some of Portage's FEATURES will not work in knoppix. Especially 257Finally, 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 258watch 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 259getting errors, it might be wise to disable some or all of the optional
220features. 260FEATURES.
221</p> 261</p>
222 262
223<!-- 263<!--
224 Commenting out due to #78716. If it needs to be restated again, note 264 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 265 that some will require to bind-mount it, others don't, and that you have
278# <i>mkdir /diskless/eta/boot</i> 318# <i>mkdir /diskless/eta/boot</i>
279</pre> 319</pre>
280 320
281<p> 321<p>
282DHCP and TFTP setup: The client will get boot informations using DHCP and 322DHCP 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 323download all the required files using TFTP.
284for your basic needs. Then, add the following on 324</p>
325
326<p>
327For dhcpd, just run <c>emerge dhcp</c> (or any other DHCP server of your
328choice). Make sure that the correct interface is selected in
329<path>/etc/conf.d/dhcpd</path>, and configure it for your basic needs. Then, add
285<path>/etc/dhcp/dhcpd.conf</path>. 330the following on <path>/etc/dhcp/dhcpd.conf</path>.
286</p> 331</p>
287 332
288<note> 333<note>
289This provide a static IP address for the client and the path of a PXE boot 334This 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 335image, 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 336ethernet card of the client and the directory where you will put the client
292files with the one you use. 337files with the one you use.
293</note> 338</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 339
301<pre caption="dhcpd.conf"> 340<pre caption="dhcpd.conf">
302option option-150 code 150 = text ; 341option option-150 code 150 = text ;
303ddns-update-style none ; 342ddns-update-style none ;
304host eta { 343host eta {

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

  ViewVC Help
Powered by ViewVC 1.1.20