public inbox for gentoo-doc-cvs@lists.gentoo.org
 help / color / mirror / Atom feed
* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2006-01-07 23:29 Lukasz Damentko
  0 siblings, 0 replies; 15+ messages in thread
From: Lukasz Damentko @ 2006-01-07 23:29 UTC (permalink / raw
  To: gentoo-doc-cvs

rane        06/01/07 23:29:20

  Added:       xml/htdocs/doc/en liveusb.xml
  Log:
  #118179, Gentoo LiveUSB installation HOWTO

Revision  Changes    Path
1.1                  xml/htdocs/doc/en/liveusb.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo

Index: liveusb.xml
===================================================================
<?xml version='1.0' encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.1 2006/01/07 23:29:20 rane Exp $ -->

<guide link="/doc/en/liveusb.xml">
<title>Gentoo Linux LiveUSB HOWTO</title>

<author title="Author">
  <mail link="brix@gentoo.org">Henrik Brix Andersen</mail>
</author>

<abstract>
This HOWTO explains how to create a Gentoo Linux LiveUSB or, in other words,
how to emulate a Gentoo Linux Installation CD using an USB flash drive.
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>

<version>1.0</version>
<date>2006-01-04</date>

<chapter>
<title>Introduction</title>
<section>
<title>The LiveUSB</title>
<body>

<p>
This HOWTO explains how to create a <e>Gentoo Linux LiveUSB</e> or, in other
words, how to emulate a Gentoo Linux Installation CD using an USB flash drive.
This is particularly useful for installing Gentoo Linux on a modern laptop with
no CD-ROM drive.
</p>

<p>
Although the instructions found in this document aims at emulating a Gentoo
Linux Installation CD using an USB flash drive, they should work for any
arbitrary block device as long as you adjust the device names accordingly.
</p>

</body>
</section>
<section>
<title>Prerequisites</title>
<body>

<p>
In order to use a Gentoo Linux LiveUSB you need the following:
</p>

<ul>
  <li>Bootable USB flash drive (at least 64MB)</li>
  <li>x86 computer with support for booting from USB</li>
</ul>

<p>
You will also need access to the following for creating the LiveUSB:
</p>

<ul>
  <li>
    A computer running Gentoo Linux (or alternatively another Linux
    distribution)
  </li>
</ul>

</body>
</section>
</chapter>
<chapter>
<title>Preparing the USB flash drive</title>
<section>
<title>Partitioning the drive</title>
<body>

<warn>
These instructions will erase all data from the USB flash drive. Make sure to
backup your data first.
</warn>

<impo>
This HOWTO assumes that the <path>/dev/sda</path> device node corresponds to
your USB flash drive. If you have other SCSI-like devices make sure to use the
correct device node.
</impo>

<p>
Create a FAT32 partition on your USB flash drive and mark it bootable using
<c>fdisk</c>. An example partitioning scheme can be seen below:
</p>

<pre caption="Example partitioning scheme">
# <i>fdisk -l /dev/sda</i>

Disk /dev/sda: 1048 MB, 1048313856 bytes
33 heads, 61 sectors/track, 1017 cylinders
Units = cylinders of 2013 * 512 = 1030656 bytes

   Device Boot      Start         End      Blocks   Id  System
/dev/sda1   *           1        1017     1023580    b  W95 FAT32
</pre>

</body>
</section>
<section>
<title>Creating the filesystem</title>
<body>

<p>
Create a FAT32 filesystem on the USB flash drive using <c>mkdosfs</c>:
</p>

<pre caption="Running mkdosfs">
<comment>(Make sure you have sys-fs/dosfstools installed)</comment>
# <i>emerge -av sys-fs/dosfstools</i>
# <i>mkdosfs -F 32 /dev/sda1</i>
mkdosfs 2.11 (12 Mar 2005)
</pre>

</body>
</section>
<section>
<title>Installing a Master Boot Record</title>
<body>

<p>
Install the precompiled Master Boot Record (MBR) from <c>syslinux</c> on the
USB flash drive:
</p>

<pre caption="Installing a master boot record">
<comment>(Make sure you have sys-boot/syslinux-3.00 or later installed)</comment>
# <i>emerge -av '>=sys-boot/syslinux-3*'</i>
# <i>dd if=/usr/lib/syslinux/mbr.bin of=/dev/sda</i>
0+1 records in
0+1 records out
</pre>

</body>
</section>
</chapter>
<chapter>
<title>Copying the files</title>
<section>
<title>Mounting the Gentoo Linux Installation CD</title>
<body>

<p>
Download the <path>install-x86-minimal-2005.1-r1.iso</path> file from your
local Gentoo Linux <uri link="/main/en/where.xml">mirror</uri> site and mount
the ISO image on <path>/mnt/cdrom/</path> as shown below:
</p>

<pre caption="Mounting the Gentoo Linux Installation CD ISO image">
<comment>(Create the /mnt/cdrom/ mount point if needed)</comment>
# <i>mkdir -p /mnt/cdrom</i>
# <i>mount -o loop,ro -t iso9660 install-x86-minimal-2005.1-r1.iso /mnt/cdrom/</i>
</pre>

</body>
</section>
<section>
<title>Mounting the LiveUSB</title>
<body>

<p>
Mount the newly formatted USB flash drive on <path>/mnt/usb/</path> as shown
below:
</p>

<pre caption="Mounting the USB flash drive">
<comment>(Create the /mnt/usb/ mount point if needed)</comment>
# <i>mkdir -p /mnt/usb</i>
# <i>mount -t vfat /dev/sda1 /mnt/usb/</i>
</pre>

</body>
</section>
<section>
<title>Copying the files</title>
<body>

<p>
Copy the files from the Gentoo Linux Installation CD to the LiveUSB. The files
needs to be reordered a bit as we will be using the <c>syslinux</c> bootloader
instead of <c>isolinux</c>:
</p>

<pre caption="Copying the files">
# <i>cp -r /mnt/cdrom/* /mnt/usb/</i>
# <i>mv /mnt/usb/isolinux/* /mnt/usb/</i>
# <i>mv /mnt/usb/isolinux.cfg /mnt/usb/syslinux.cfg</i>
# <i>rm -rf /mnt/usb/isolinux*</i>

<comment>(The memtest86 kernel needs to be renamed for loading it via syslinux)</comment>
# <i>mv /mnt/usb/memtest86 /mnt/usb/memtest</i>
</pre>

<p>
You can now unmount the ISO image:
</p>

<pre caption="Unmounting the ISO image">
# <i>umount /mnt/cdrom/</i>
</pre>

</body>
</section>
<section>
<title>Adjusting the bootloader configuration</title>
<body>

<p>
Adjust the syslinux configuration file using <c>sed</c> as shown below. The
<c>scandelay=10</c> parameter will introduce a 10 seconds delay before
attempting to mount the filesystem. This is needed to allow the USB flash drive
to settle upon detection.
</p>

<pre caption="Adjusting the boot parameters">
# <i>sed -i \
    -e "s:cdroot:cdroot scandelay=10:" \
    -e "s:kernel memtest86:kernel memtest:" \
    /mnt/usb/syslinux.cfg</i>
</pre>

<note>
Consider adding <c>docache</c> to the boot parameters. This will allow running
<c>umount /mnt/cdrom/</c> after booting so that you can unplug the USB flash
drive.
</note>

</body>
</section>
</chapter>
<chapter>
<title>Installing a bootloader</title>
<section>
<title>Unmounting the drive</title>
<body>

<p>
Make sure you unmount the USB flash drive drive before installing the
bootloader:
</p>

<pre caption="Unmounting the USB flash drive">
# <i>umount /mnt/usb/</i>
</pre>

</body>
</section>
<section>
<title>Installing syslinux</title>
<body>

<p>
Finally install the <c>syslinux</c> bootloader on the USB flash drive:
</p>

<pre caption="Running syslinux">
# <i>syslinux /dev/sda1</i>
</pre>

<impo>
You will need to rerun <c>syslinux /dev/sda1</c> each time you modify the
<path>syslinux.cfg</path> file for the configuration changes to take affect.
</impo>

</body>
</section>
</chapter>
<chapter>
<title>Using the LiveUSB</title>
<section>
<title>Booting</title>
<body>

<p>
Insert the USB flash drive and turn on the computer, making sure the BIOS is
set to boot from USB. If all goes well you should be presented with a standard
syslinux prompt.
</p>

<p>
You should be able to follow the generic installation instructions found in the
<uri link="/doc/en/handbook/">Gentoo Handbook</uri> from here on.
</p>

</body>
</section>
</chapter>
</guide>



-- 
gentoo-doc-cvs@gentoo.org mailing list



^ permalink raw reply	[flat|nested] 15+ messages in thread

* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2006-01-08 21:17 Lukasz Damentko
  0 siblings, 0 replies; 15+ messages in thread
From: Lukasz Damentko @ 2006-01-08 21:17 UTC (permalink / raw
  To: gentoo-doc-cvs

rane        06/01/08 21:17:14

  Modified:    xml/htdocs/doc/en liveusb.xml
  Log:
  removing dupped word, thx to Borges for reporting

Revision  Changes    Path
1.2       +2 -3      xml/htdocs/doc/en/liveusb.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo

Index: liveusb.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- liveusb.xml	7 Jan 2006 23:29:20 -0000	1.1
+++ liveusb.xml	8 Jan 2006 21:17:14 -0000	1.2
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.1 2006/01/07 23:29:20 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.2 2006/01/08 21:17:14 rane Exp $ -->
 
 <guide link="/doc/en/liveusb.xml">
 <title>Gentoo Linux LiveUSB HOWTO</title>
@@ -242,8 +242,7 @@
 <body>
 
 <p>
-Make sure you unmount the USB flash drive drive before installing the
-bootloader:
+Make sure you unmount the USB flash drive before installing the bootloader:
 </p>
 
 <pre caption="Unmounting the USB flash drive">



-- 
gentoo-doc-cvs@gentoo.org mailing list



^ permalink raw reply	[flat|nested] 15+ messages in thread

* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2006-01-08 21:56 Lukasz Damentko
  0 siblings, 0 replies; 15+ messages in thread
From: Lukasz Damentko @ 2006-01-08 21:56 UTC (permalink / raw
  To: gentoo-doc-cvs

rane        06/01/08 21:56:04

  Modified:    xml/htdocs/doc/en liveusb.xml
  Log:
  yet another typo, thx to nightmorph for reporting

Revision  Changes    Path
1.3       +2 -2      xml/htdocs/doc/en/liveusb.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo

Index: liveusb.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- liveusb.xml	8 Jan 2006 21:17:14 -0000	1.2
+++ liveusb.xml	8 Jan 2006 21:56:04 -0000	1.3
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.2 2006/01/08 21:17:14 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.3 2006/01/08 21:56:04 rane Exp $ -->
 
 <guide link="/doc/en/liveusb.xml">
 <title>Gentoo Linux LiveUSB HOWTO</title>
@@ -184,7 +184,7 @@
 
 <p>
 Copy the files from the Gentoo Linux Installation CD to the LiveUSB. The files
-needs to be reordered a bit as we will be using the <c>syslinux</c> bootloader
+need to be reordered a bit as we will be using the <c>syslinux</c> bootloader
 instead of <c>isolinux</c>:
 </p>
 



-- 
gentoo-doc-cvs@gentoo.org mailing list



^ permalink raw reply	[flat|nested] 15+ messages in thread

* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2006-01-24 18:32 Marcelo Goes
  0 siblings, 0 replies; 15+ messages in thread
From: Marcelo Goes @ 2006-01-24 18:32 UTC (permalink / raw
  To: gentoo-doc-cvs

vanquirius    06/01/24 18:32:35

  Modified:    xml/htdocs/doc/en liveusb.xml
  Log:
  s/instructions aims/instructions aim/g, *no content change*

Revision  Changes    Path
1.4       +2 -2      xml/htdocs/doc/en/liveusb.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo

Index: liveusb.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- liveusb.xml	8 Jan 2006 21:56:04 -0000	1.3
+++ liveusb.xml	24 Jan 2006 18:32:35 -0000	1.4
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.3 2006/01/08 21:56:04 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.4 2006/01/24 18:32:35 vanquirius Exp $ -->
 
 <guide link="/doc/en/liveusb.xml">
 <title>Gentoo Linux LiveUSB HOWTO</title>
@@ -35,7 +35,7 @@
 </p>
 
 <p>
-Although the instructions found in this document aims at emulating a Gentoo
+Although the instructions found in this document aim at emulating a Gentoo
 Linux Installation CD using an USB flash drive, they should work for any
 arbitrary block device as long as you adjust the device names accordingly.
 </p>



-- 
gentoo-doc-cvs@gentoo.org mailing list



^ permalink raw reply	[flat|nested] 15+ messages in thread

* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2006-02-12 14:54 Josh Saddler
  0 siblings, 0 replies; 15+ messages in thread
From: Josh Saddler @ 2006-02-12 14:54 UTC (permalink / raw
  To: gentoo-doc-cvs

nightmorph    06/02/12 14:54:15

  Modified:    xml/htdocs/doc/en liveusb.xml
  Log:
  Added brief required RAM note w/brix's approval for bug 118323

Revision  Changes    Path
1.5       +6 -4      xml/htdocs/doc/en/liveusb.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml?rev=1.5&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml?rev=1.5&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml.diff?r1=1.4&r2=1.5&cvsroot=gentoo

Index: liveusb.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- liveusb.xml	24 Jan 2006 18:32:35 -0000	1.4
+++ liveusb.xml	12 Feb 2006 14:54:15 -0000	1.5
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.4 2006/01/24 18:32:35 vanquirius Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.5 2006/02/12 14:54:15 nightmorph Exp $ -->
 
 <guide link="/doc/en/liveusb.xml">
 <title>Gentoo Linux LiveUSB HOWTO</title>
@@ -18,8 +18,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.0</version>
-<date>2006-01-04</date>
+<version>1.1</version>
+<date>2006-02-12</date>
 
 <chapter>
 <title>Introduction</title>
@@ -52,7 +52,9 @@
 
 <ul>
   <li>Bootable USB flash drive (at least 64MB)</li>
-  <li>x86 computer with support for booting from USB</li>
+  <li>
+    x86 computer with support for booting from USB (with at least 64MB RAM)
+  </li>
 </ul>
 
 <p>



-- 
gentoo-doc-cvs@gentoo.org mailing list



^ permalink raw reply	[flat|nested] 15+ messages in thread

* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2006-02-28 13:51 Jan Kundrat
  0 siblings, 0 replies; 15+ messages in thread
From: Jan Kundrat @ 2006-02-28 13:51 UTC (permalink / raw
  To: gentoo-doc-cvs

jkt         06/02/28 13:51:25

  Modified:    xml/htdocs/doc/en liveusb.xml
  Log:
  #124307, LiveUSB HOWTO update for 2006.0

Revision  Changes    Path
1.6       +11 -11    xml/htdocs/doc/en/liveusb.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml?rev=1.6&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml?rev=1.6&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml.diff?r1=1.5&r2=1.6&cvsroot=gentoo

Index: liveusb.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- liveusb.xml	12 Feb 2006 14:54:15 -0000	1.5
+++ liveusb.xml	28 Feb 2006 13:51:25 -0000	1.6
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.5 2006/02/12 14:54:15 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.6 2006/02/28 13:51:25 jkt Exp $ -->
 
 <guide link="/doc/en/liveusb.xml">
 <title>Gentoo Linux LiveUSB HOWTO</title>
@@ -18,8 +18,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.1</version>
-<date>2006-02-12</date>
+<version>1.2</version>
+<date>2006-02-28</date>
 
 <chapter>
 <title>Introduction</title>
@@ -53,7 +53,7 @@
 <ul>
   <li>Bootable USB flash drive (at least 64MB)</li>
   <li>
-    x86 computer with support for booting from USB (with at least 64MB RAM)
+    x86 computer with support for booting from USB
   </li>
 </ul>
 
@@ -150,7 +150,7 @@
 <body>
 
 <p>
-Download the <path>install-x86-minimal-2005.1-r1.iso</path> file from your
+Download the <path>install-x86-minimal-2006.0.iso</path> file from your
 local Gentoo Linux <uri link="/main/en/where.xml">mirror</uri> site and mount
 the ISO image on <path>/mnt/cdrom/</path> as shown below:
 </p>
@@ -158,7 +158,7 @@
 <pre caption="Mounting the Gentoo Linux Installation CD ISO image">
 <comment>(Create the /mnt/cdrom/ mount point if needed)</comment>
 # <i>mkdir -p /mnt/cdrom</i>
-# <i>mount -o loop,ro -t iso9660 install-x86-minimal-2005.1-r1.iso /mnt/cdrom/</i>
+# <i>mount -o loop,ro -t iso9660 install-x86-minimal-2006.0.iso /mnt/cdrom/</i>
 </pre>
 
 </body>
@@ -216,14 +216,14 @@
 
 <p>
 Adjust the syslinux configuration file using <c>sed</c> as shown below. The
-<c>scandelay=10</c> parameter will introduce a 10 seconds delay before
-attempting to mount the filesystem. This is needed to allow the USB flash drive
-to settle upon detection.
+<c>dobladecenter</c> parameter will introduce some extra delays before
+attempting to mount the filesystem. This is needed to allow the USB
+flash drive to settle upon detection.
 </p>
 
 <pre caption="Adjusting the boot parameters">
 # <i>sed -i \
-    -e "s:cdroot:cdroot scandelay=10:" \
+    -e "s:cdroot:cdroot dobladecenter:" \
     -e "s:kernel memtest86:kernel memtest:" \
     /mnt/usb/syslinux.cfg</i>
 </pre>
@@ -231,7 +231,7 @@
 <note>
 Consider adding <c>docache</c> to the boot parameters. This will allow running
 <c>umount /mnt/cdrom/</c> after booting so that you can unplug the USB flash
-drive.
+drive. Do not enable this unless the target computer has at least 128MB RAM.
 </note>
 
 </body>



-- 
gentoo-doc-cvs@gentoo.org mailing list



^ permalink raw reply	[flat|nested] 15+ messages in thread

* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2006-04-25 12:50 Xavier Neys
  0 siblings, 0 replies; 15+ messages in thread
From: Xavier Neys @ 2006-04-25 12:50 UTC (permalink / raw
  To: gentoo-doc-cvs

neysx       06/04/25 12:50:20

  Modified:             liveusb.xml
  Log:
  #130363 Explain possible "Could not find any loop device" err msg

Revision  Changes    Path
1.7                  xml/htdocs/doc/en/liveusb.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml?rev=1.7&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml?rev=1.7&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/liveusb.xml.diff?r1=1.6&r2=1.7&cvsroot=gentoo

Index: liveusb.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- liveusb.xml	28 Feb 2006 13:51:25 -0000	1.6
+++ liveusb.xml	25 Apr 2006 12:50:20 -0000	1.7
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.6 2006/02/28 13:51:25 jkt Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.7 2006/04/25 12:50:20 neysx Exp $ -->
 
 <guide link="/doc/en/liveusb.xml">
 <title>Gentoo Linux LiveUSB HOWTO</title>
@@ -18,8 +18,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.2</version>
-<date>2006-02-28</date>
+<version>1.3</version>
+<date>2006-04-25</date>
 
 <chapter>
 <title>Introduction</title>
@@ -161,6 +161,12 @@
 # <i>mount -o loop,ro -t iso9660 install-x86-minimal-2006.0.iso /mnt/cdrom/</i>
 </pre>
 
+<note>
+If you receive a <e>Could not find any loop device</e> error message when
+mounting the iso, you need to enable the <c>Loopback device support</c> option
+in your kernel configuration.
+</note>
+
 </body>
 </section>
 <section>



-- 
gentoo-doc-cvs@gentoo.org mailing list



^ permalink raw reply	[flat|nested] 15+ messages in thread

* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2006-09-04 20:35 Josh Saddler
  0 siblings, 0 replies; 15+ messages in thread
From: Josh Saddler @ 2006-09-04 20:35 UTC (permalink / raw
  To: gentoo-doc-cvs

nightmorph    06/09/04 20:35:41

  Modified:             liveusb.xml
  Log:
  update liveusb guide for 2006.1 and update brix's email

Revision  Changes    Path
1.8                  xml/htdocs/doc/en/liveusb.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.8&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.8&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?r1=1.7&r2=1.8

Index: liveusb.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- liveusb.xml	25 Apr 2006 12:50:20 -0000	1.7
+++ liveusb.xml	4 Sep 2006 20:35:41 -0000	1.8
@@ -1,12 +1,12 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.7 2006/04/25 12:50:20 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.8 2006/09/04 20:35:41 nightmorph Exp $ -->
 
 <guide link="/doc/en/liveusb.xml">
 <title>Gentoo Linux LiveUSB HOWTO</title>
 
 <author title="Author">
-  <mail link="brix@gentoo.org">Henrik Brix Andersen</mail>
+  <mail link="henrik@brixandersen.dk">Henrik Brix Andersen</mail>
 </author>
 
 <abstract>
@@ -18,8 +18,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.3</version>
-<date>2006-04-25</date>
+<version>1.4</version>
+<date>2006-09-04</date>
 
 <chapter>
 <title>Introduction</title>
@@ -150,7 +150,7 @@
 <body>
 
 <p>
-Download the <path>install-x86-minimal-2006.0.iso</path> file from your
+Download the <path>install-x86-minimal-2006.1.iso</path> file from your
 local Gentoo Linux <uri link="/main/en/where.xml">mirror</uri> site and mount
 the ISO image on <path>/mnt/cdrom/</path> as shown below:
 </p>
@@ -158,7 +158,7 @@
 <pre caption="Mounting the Gentoo Linux Installation CD ISO image">
 <comment>(Create the /mnt/cdrom/ mount point if needed)</comment>
 # <i>mkdir -p /mnt/cdrom</i>
-# <i>mount -o loop,ro -t iso9660 install-x86-minimal-2006.0.iso /mnt/cdrom/</i>
+# <i>mount -o loop,ro -t iso9660 install-x86-minimal-2006.1.iso /mnt/cdrom/</i>
 </pre>
 
 <note>



-- 
gentoo-doc-cvs@gentoo.org mailing list



^ permalink raw reply	[flat|nested] 15+ messages in thread

* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2006-09-09 10:00 Josh Saddler
  0 siblings, 0 replies; 15+ messages in thread
From: Josh Saddler @ 2006-09-09 10:00 UTC (permalink / raw
  To: gentoo-doc-cvs

nightmorph    06/09/09 10:00:13

  Modified:             liveusb.xml
  Log:
  reverting to a 2006.0 stage per email received from brix. looks like the 2006.1 tarballs are fundamentally incompatible with the steps in this guide

Revision  Changes    Path
1.9                  xml/htdocs/doc/en/liveusb.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.9&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.9&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?r1=1.8&r2=1.9

Index: liveusb.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- liveusb.xml	4 Sep 2006 20:35:41 -0000	1.8
+++ liveusb.xml	9 Sep 2006 10:00:13 -0000	1.9
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.8 2006/09/04 20:35:41 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.9 2006/09/09 10:00:13 nightmorph Exp $ -->
 
 <guide link="/doc/en/liveusb.xml">
 <title>Gentoo Linux LiveUSB HOWTO</title>
@@ -18,8 +18,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.4</version>
-<date>2006-09-04</date>
+<version>1.5</version>
+<date>2006-09-09</date>
 
 <chapter>
 <title>Introduction</title>
@@ -150,7 +150,7 @@
 <body>
 
 <p>
-Download the <path>install-x86-minimal-2006.1.iso</path> file from your
+Download the <path>install-x86-minimal-2006.0.iso</path> file from your
 local Gentoo Linux <uri link="/main/en/where.xml">mirror</uri> site and mount
 the ISO image on <path>/mnt/cdrom/</path> as shown below:
 </p>
@@ -158,7 +158,7 @@
 <pre caption="Mounting the Gentoo Linux Installation CD ISO image">
 <comment>(Create the /mnt/cdrom/ mount point if needed)</comment>
 # <i>mkdir -p /mnt/cdrom</i>
-# <i>mount -o loop,ro -t iso9660 install-x86-minimal-2006.1.iso /mnt/cdrom/</i>
+# <i>mount -o loop,ro -t iso9660 install-x86-minimal-2006.0.iso /mnt/cdrom/</i>
 </pre>
 
 <note>



-- 
gentoo-doc-cvs@gentoo.org mailing list



^ permalink raw reply	[flat|nested] 15+ messages in thread

* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2006-09-18 10:51 Josh Saddler
  0 siblings, 0 replies; 15+ messages in thread
From: Josh Saddler @ 2006-09-18 10:51 UTC (permalink / raw
  To: gentoo-doc-cvs

nightmorph    06/09/18 10:51:48

  Modified:             liveusb.xml
  Log:
  more explicit 2006.0 only warning to liveusb guide, as well as updated 2006.1 gli handbook for a changed boot parameter we weren't originally notified about

Revision  Changes    Path
1.10                 xml/htdocs/doc/en/liveusb.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.10&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.10&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?r1=1.9&r2=1.10

Index: liveusb.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- liveusb.xml	9 Sep 2006 10:00:13 -0000	1.9
+++ liveusb.xml	18 Sep 2006 10:51:48 -0000	1.10
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.9 2006/09/09 10:00:13 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.10 2006/09/18 10:51:48 nightmorph Exp $ -->
 
 <guide link="/doc/en/liveusb.xml">
 <title>Gentoo Linux LiveUSB HOWTO</title>
@@ -18,8 +18,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.5</version>
-<date>2006-09-09</date>
+<version>1.6</version>
+<date>2006-09-18</date>
 
 <chapter>
 <title>Introduction</title>
@@ -149,6 +149,11 @@
 <title>Mounting the Gentoo Linux Installation CD</title>
 <body>
 
+<warn>
+This guide is designed only to be used with Gentoo 2006.0. Do not attempt to
+use a 2006.1 CD or newer; you will end up with an unbootable USB disk.
+</warn>
+
 <p>
 Download the <path>install-x86-minimal-2006.0.iso</path> file from your
 local Gentoo Linux <uri link="/main/en/where.xml">mirror</uri> site and mount



-- 
gentoo-doc-cvs@gentoo.org mailing list



^ permalink raw reply	[flat|nested] 15+ messages in thread

* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2006-11-05  4:02 Josh Saddler
  0 siblings, 0 replies; 15+ messages in thread
From: Josh Saddler @ 2006-11-05  4:02 UTC (permalink / raw
  To: gentoo-doc-cvs

nightmorph    06/11/05 04:02:25

  Modified:             liveusb.xml
  Log:
  added 2006.1 fix-in-the-works; should be evaluated. commented fixes and explanation only, **no content change**

Revision  Changes    Path
1.11                 xml/htdocs/doc/en/liveusb.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.11&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.11&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?r1=1.10&r2=1.11

Index: liveusb.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- liveusb.xml	18 Sep 2006 10:51:48 -0000	1.10
+++ liveusb.xml	5 Nov 2006 04:02:25 -0000	1.11
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.10 2006/09/18 10:51:48 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.11 2006/11/05 04:02:25 nightmorph Exp $ -->
 
 <guide link="/doc/en/liveusb.xml">
 <title>Gentoo Linux LiveUSB HOWTO</title>
@@ -245,6 +245,47 @@
 drive. Do not enable this unless the target computer has at least 128MB RAM.
 </note>
 
+<!--
+(2006.1 workaround) posted by nightmorph
+
+Background:
+After some lengthy discussion with Robin Johnson (robbat2) on IRC, it turns out
+that the reason why 2006.1 fails to work with this guide is because inside the
+initramfs, it specifies -t iso9660..but usb flash isn't this filetype, it's
+vfat. 2006.0 was much better and just specified mount -t auto. so the thing is
+to install an ~arch version of genkernel (3.4.4, still ~arch as of 2006-11-04)
+and reconfigure syslinux.config to point at the renamed files.
+
+Obviously, unmasking an ~arch version is never desirable in documentation, so we
+need some more alternatives...since 3.4.4 was only created at the end of
+october; not likely to go stable all that soon.
+
+Procedure:
+After adjusting the parameters, and before the disk is unmounted/bootloader
+installed, the following must be done for ~arch genkernel. Please replace (dash)
+with an actual - , since the damned xmllint throws a "comment not terminated"
+error.
+
+# echo "sys-kernel/genkernel" &gt;&gt; /etc/portage/package.keywords
+# genkernel (dash)(dash)bootdir=/mnt/usb (dash)(dash)install all
+(not sure if syslinux has been installed previously yet)
+# nano -w syslinux.cfg
+(Edit it to point at the new filenames installed by genkernel)
+(might be worth renaming to the ones normally used by syslinux, as
+if the kernel name is too long, "vfat might bite")
+
+(might need to re-run syslinux as specified below to pick up the new names, 
+though maybe this renaming step should be in the section below?)
+# syslinux /dev/sda1
+
+TODO:
+- if/when this document changes, brix requested some time ago that he be renamed
+"Original Author" and be moved to the bottom of the credits list.
+- if/when this fix goes in, robbat2 deserves credit: this is his solution after
+  all, and it works.
+
+-->
+
 </body>
 </section>
 </chapter>



-- 
gentoo-doc-cvs@gentoo.org mailing list



^ permalink raw reply	[flat|nested] 15+ messages in thread

* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2006-12-22  7:33 Josh Saddler
  0 siblings, 0 replies; 15+ messages in thread
From: Josh Saddler @ 2006-12-22  7:33 UTC (permalink / raw
  To: gentoo-doc-cvs

nightmorph    06/12/22 07:33:38

  Modified:             liveusb.xml
  Log:
  Fixed invalid atom in syslinux emerge command, thanks to Christian (phreak) for reporting and patch, bug 158743

Revision  Changes    Path
1.12                 xml/htdocs/doc/en/liveusb.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.12&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.12&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?r1=1.11&r2=1.12

Index: liveusb.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- liveusb.xml	5 Nov 2006 04:02:25 -0000	1.11
+++ liveusb.xml	22 Dec 2006 07:33:38 -0000	1.12
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.11 2006/11/05 04:02:25 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.12 2006/12/22 07:33:38 nightmorph Exp $ -->
 
 <guide link="/doc/en/liveusb.xml">
 <title>Gentoo Linux LiveUSB HOWTO</title>
@@ -18,8 +18,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.6</version>
-<date>2006-09-18</date>
+<version>1.7</version>
+<date>2006-12-21</date>
 
 <chapter>
 <title>Introduction</title>
@@ -134,7 +134,7 @@
 
 <pre caption="Installing a master boot record">
 <comment>(Make sure you have sys-boot/syslinux-3.00 or later installed)</comment>
-# <i>emerge -av '>=sys-boot/syslinux-3*'</i>
+# <i>emerge -av '>sys-boot/syslinux-3'</i>
 # <i>dd if=/usr/lib/syslinux/mbr.bin of=/dev/sda</i>
 0+1 records in
 0+1 records out



-- 
gentoo-doc-cvs@gentoo.org mailing list



^ permalink raw reply	[flat|nested] 15+ messages in thread

* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2007-05-10 15:51 Xavier Neys
  0 siblings, 0 replies; 15+ messages in thread
From: Xavier Neys @ 2007-05-10 15:51 UTC (permalink / raw
  To: gentoo-doc-cvs

neysx       07/05/10 15:51:09

  Modified:             liveusb.xml
  Log:
  #173117 update to 2007.0

Revision  Changes    Path
1.13                 xml/htdocs/doc/en/liveusb.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.13&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.13&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?r1=1.12&r2=1.13

Index: liveusb.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- liveusb.xml	22 Dec 2006 07:33:38 -0000	1.12
+++ liveusb.xml	10 May 2007 15:51:09 -0000	1.13
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.12 2006/12/22 07:33:38 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.13 2007/05/10 15:51:09 neysx Exp $ -->
 
 <guide link="/doc/en/liveusb.xml">
 <title>Gentoo Linux LiveUSB HOWTO</title>
@@ -8,18 +8,21 @@
 <author title="Author">
   <mail link="henrik@brixandersen.dk">Henrik Brix Andersen</mail>
 </author>
+<author title="Editor">
+  <mail link="neysx@gentoo.org">Xavier Neys</mail>
+</author>
 
 <abstract>
 This HOWTO explains how to create a Gentoo Linux LiveUSB or, in other words,
-how to emulate a Gentoo Linux Installation CD using an USB flash drive.
+how to emulate an x86 or AMD64 Gentoo Linux LiveCD using a USB flash drive.
 </abstract>
 
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.7</version>
-<date>2006-12-21</date>
+<version>2</version>
+<date>2007-05-10</date>
 
 <chapter>
 <title>Introduction</title>
@@ -29,15 +32,15 @@
 
 <p>
 This HOWTO explains how to create a <e>Gentoo Linux LiveUSB</e> or, in other
-words, how to emulate a Gentoo Linux Installation CD using an USB flash drive.
-This is particularly useful for installing Gentoo Linux on a modern laptop with
-no CD-ROM drive.
+words, how to emulate an x86 or AMD64 Gentoo Linux LiveCD using a USB flash
+drive. This is particularly useful for installing Gentoo Linux on a modern
+laptop with no CD-ROM drive.
 </p>
 
 <p>
 Although the instructions found in this document aim at emulating a Gentoo
-Linux Installation CD using an USB flash drive, they should work for any
-arbitrary block device as long as you adjust the device names accordingly.
+Linux LiveCD using a USB flash drive, they should work for any arbitrary block
+device as long as you adjust the device names accordingly.
 </p>
 
 </body>
@@ -51,10 +54,8 @@
 </p>
 
 <ul>
-  <li>Bootable USB flash drive (at least 64MB)</li>
-  <li>
-    x86 computer with support for booting from USB
-  </li>
+  <li>Bootable USB flash drive with at least 1GB</li>
+  <li>i686 or x86_64 computer with support for booting from USB</li>
 </ul>
 
 <p>
@@ -68,6 +69,14 @@
   </li>
 </ul>
 
+<note>
+If you want to use the minimal CD on a smaller key or boot a &lt;i686 system,
+you need to follow the procedure described in this document with a
+<b>2006.0</b> minimal CD image because of a <uri
+link="http://bugs.gentoo.org/show_bug.cgi?id=173117">bug</uri> in more recent
+releases.
+</note>
+
 </body>
 </section>
 </chapter>
@@ -83,25 +92,29 @@
 </warn>
 
 <impo>
-This HOWTO assumes that the <path>/dev/sda</path> device node corresponds to
+This HOWTO assumes that the <path>/dev/sdc</path> device node corresponds to
 your USB flash drive. If you have other SCSI-like devices make sure to use the
 correct device node.
 </impo>
 
 <p>
-Create a FAT32 partition on your USB flash drive and mark it bootable using
+Create a FAT16 partition on your USB flash drive and mark it bootable using
 <c>fdisk</c>. An example partitioning scheme can be seen below:
 </p>
 
+<note>
+If your key is 4GB or larger, use partition type <c>b</c> (W95 FAT32).
+</note>
+
 <pre caption="Example partitioning scheme">
-# <i>fdisk -l /dev/sda</i>
+# <i>fdisk -l /dev/sdc</i>
 
-Disk /dev/sda: 1048 MB, 1048313856 bytes
-33 heads, 61 sectors/track, 1017 cylinders
-Units = cylinders of 2013 * 512 = 1030656 bytes
+Disk /dev/sdc: 2063 MB, 2063597056 bytes
+255 heads, 63 sectors/track, 250 cylinders
+Units = cylinders of 16065 * 512 = 8225280 bytes
 
    Device Boot      Start         End      Blocks   Id  System
-/dev/sda1   *           1        1017     1023580    b  W95 FAT32
+/dev/sdc1   *           1         250     2008124+   6  FAT16
 </pre>
 
 </body>
@@ -111,13 +124,17 @@
 <body>
 
 <p>
-Create a FAT32 filesystem on the USB flash drive using <c>mkdosfs</c>:
+Create a FAT16 filesystem on the USB flash drive using <c>mkdosfs</c>:
 </p>
 
+<note>
+If your key is 4GB or larger, use <c>-F 32</c> to create a FAT32 filesystem.
+</note>
+
 <pre caption="Running mkdosfs">
 <comment>(Make sure you have sys-fs/dosfstools installed)</comment>
 # <i>emerge -av sys-fs/dosfstools</i>
-# <i>mkdosfs -F 32 /dev/sda1</i>
+# <i>mkdosfs -F 16 /dev/sdc1</i>
 mkdosfs 2.11 (12 Mar 2005)
 </pre>
 
@@ -135,35 +152,33 @@
 <pre caption="Installing a master boot record">
 <comment>(Make sure you have sys-boot/syslinux-3.00 or later installed)</comment>
 # <i>emerge -av '>sys-boot/syslinux-3'</i>
-# <i>dd if=/usr/lib/syslinux/mbr.bin of=/dev/sda</i>
+# <i>dd if=/usr/lib/syslinux/mbr.bin of=/dev/sdc</i>
 0+1 records in
 0+1 records out
+304 bytes (304 B) copied, 0.0162317 s, 18.7 kB/s
 </pre>
 
 </body>
 </section>
 </chapter>
+
 <chapter>
-<title>Copying the files</title>
+<title>Copying the files to your key</title>
 <section>
 <title>Mounting the Gentoo Linux Installation CD</title>
 <body>
 
-<warn>
-This guide is designed only to be used with Gentoo 2006.0. Do not attempt to
-use a 2006.1 CD or newer; you will end up with an unbootable USB disk.
-</warn>
-
 <p>
-Download the <path>install-x86-minimal-2006.0.iso</path> file from your
-local Gentoo Linux <uri link="/main/en/where.xml">mirror</uri> site and mount
-the ISO image on <path>/mnt/cdrom/</path> as shown below:
+Download either <path>livecd-i686-installer-2007.0.iso</path> or
+<path>livecd-amd64-installer-2007.0.iso</path> from your local Gentoo Linux
+<uri link="/main/en/where.xml">mirror</uri> site and mount the ISO image on
+<path>/mnt/cdrom</path> as shown below:
 </p>
 
 <pre caption="Mounting the Gentoo Linux Installation CD ISO image">
-<comment>(Create the /mnt/cdrom/ mount point if needed)</comment>
+<comment>(Create the /mnt/cdrom mount point if needed)</comment>
 # <i>mkdir -p /mnt/cdrom</i>
-# <i>mount -o loop,ro -t iso9660 install-x86-minimal-2006.0.iso /mnt/cdrom/</i>
+# <i>mount -o loop,ro -t iso9660 livecd-i686-installer-2007.0.iso /mnt/cdrom</i>
 </pre>
 
 <note>
@@ -179,14 +194,14 @@
 <body>
 
 <p>
-Mount the newly formatted USB flash drive on <path>/mnt/usb/</path> as shown
+Mount the newly formatted USB flash drive on <path>/mnt/usb</path> as shown
 below:
 </p>
 
 <pre caption="Mounting the USB flash drive">
-<comment>(Create the /mnt/usb/ mount point if needed)</comment>
+<comment>(Create the /mnt/usb mount point if needed)</comment>
 # <i>mkdir -p /mnt/usb</i>
-# <i>mount -t vfat /dev/sda1 /mnt/usb/</i>
+# <i>mount -t vfat /dev/sdc1 /mnt/usb</i>
 </pre>
 
 </body>
@@ -202,8 +217,8 @@
 </p>
 
 <pre caption="Copying the files">
-# <i>cp -r /mnt/cdrom/* /mnt/usb/</i>
-# <i>mv /mnt/usb/isolinux/* /mnt/usb/</i>
+# <i>cp -r /mnt/cdrom/* /mnt/usb</i>
+# <i>mv /mnt/usb/isolinux/* /mnt/usb</i>
 # <i>mv /mnt/usb/isolinux.cfg /mnt/usb/syslinux.cfg</i>
 # <i>rm -rf /mnt/usb/isolinux*</i>
 
@@ -216,7 +231,7 @@
 </p>
 
 <pre caption="Unmounting the ISO image">
-# <i>umount /mnt/cdrom/</i>
+# <i>umount /mnt/cdrom</i>
 </pre>
 
 </body>
@@ -227,68 +242,22 @@
 
 <p>
 Adjust the syslinux configuration file using <c>sed</c> as shown below. The
-<c>dobladecenter</c> parameter will introduce some extra delays before
-attempting to mount the filesystem. This is needed to allow the USB
-flash drive to settle upon detection.
+<c>slowusb</c> parameter will introduce some extra delays before attempting to
+mount the filesystem. This is needed to allow the USB flash drive to settle
+upon detection.
 </p>
 
 <pre caption="Adjusting the boot parameters">
 # <i>sed -i \
-    -e "s:cdroot:cdroot dobladecenter:" \
+    -e "s:cdroot:cdroot slowusb:" \
     -e "s:kernel memtest86:kernel memtest:" \
     /mnt/usb/syslinux.cfg</i>
 </pre>
 
-<note>
-Consider adding <c>docache</c> to the boot parameters. This will allow running
-<c>umount /mnt/cdrom/</c> after booting so that you can unplug the USB flash
-drive. Do not enable this unless the target computer has at least 128MB RAM.
-</note>
-
-<!--
-(2006.1 workaround) posted by nightmorph
-
-Background:
-After some lengthy discussion with Robin Johnson (robbat2) on IRC, it turns out
-that the reason why 2006.1 fails to work with this guide is because inside the
-initramfs, it specifies -t iso9660..but usb flash isn't this filetype, it's
-vfat. 2006.0 was much better and just specified mount -t auto. so the thing is
-to install an ~arch version of genkernel (3.4.4, still ~arch as of 2006-11-04)
-and reconfigure syslinux.config to point at the renamed files.
-
-Obviously, unmasking an ~arch version is never desirable in documentation, so we
-need some more alternatives...since 3.4.4 was only created at the end of
-october; not likely to go stable all that soon.
-
-Procedure:
-After adjusting the parameters, and before the disk is unmounted/bootloader
-installed, the following must be done for ~arch genkernel. Please replace (dash)
-with an actual - , since the damned xmllint throws a "comment not terminated"
-error.
-
-# echo "sys-kernel/genkernel" &gt;&gt; /etc/portage/package.keywords
-# genkernel (dash)(dash)bootdir=/mnt/usb (dash)(dash)install all
-(not sure if syslinux has been installed previously yet)
-# nano -w syslinux.cfg
-(Edit it to point at the new filenames installed by genkernel)
-(might be worth renaming to the ones normally used by syslinux, as
-if the kernel name is too long, "vfat might bite")
-
-(might need to re-run syslinux as specified below to pick up the new names, 
-though maybe this renaming step should be in the section below?)
-# syslinux /dev/sda1
-
-TODO:
-- if/when this document changes, brix requested some time ago that he be renamed
-"Original Author" and be moved to the bottom of the credits list.
-- if/when this fix goes in, robbat2 deserves credit: this is his solution after
-  all, and it works.
-
--->
-
 </body>
 </section>
 </chapter>
+
 <chapter>
 <title>Installing a bootloader</title>
 <section>
@@ -300,7 +269,7 @@
 </p>
 
 <pre caption="Unmounting the USB flash drive">
-# <i>umount /mnt/usb/</i>
+# <i>umount /mnt/usb</i>
 </pre>
 
 </body>
@@ -314,11 +283,11 @@
 </p>
 
 <pre caption="Running syslinux">
-# <i>syslinux /dev/sda1</i>
+# <i>syslinux /dev/sdc1</i>
 </pre>
 
 <impo>
-You will need to rerun <c>syslinux /dev/sda1</c> each time you modify the
+You will need to rerun <c>syslinux /dev/sdc1</c> each time you modify the
 <path>syslinux.cfg</path> file for the configuration changes to take affect.
 </impo>
 



-- 
gentoo-doc-cvs@gentoo.org mailing list



^ permalink raw reply	[flat|nested] 15+ messages in thread

* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2008-07-28 19:24 Joshua Saddler
  0 siblings, 0 replies; 15+ messages in thread
From: Joshua Saddler @ 2008-07-28 19:24 UTC (permalink / raw
  To: gentoo-doc-cvs

nightmorph    08/07/28 19:24:27

  Modified:             liveusb.xml
  Log:
  changed mbr.bin location, bug 233177

Revision  Changes    Path
1.14                 xml/htdocs/doc/en/liveusb.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.14&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.14&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?r1=1.13&r2=1.14

Index: liveusb.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- liveusb.xml	10 May 2007 15:51:09 -0000	1.13
+++ liveusb.xml	28 Jul 2008 19:24:26 -0000	1.14
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.13 2007/05/10 15:51:09 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.14 2008/07/28 19:24:26 nightmorph Exp $ -->
 
 <guide link="/doc/en/liveusb.xml">
 <title>Gentoo Linux LiveUSB HOWTO</title>
@@ -21,8 +21,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>2</version>
-<date>2007-05-10</date>
+<version>3</version>
+<date>2008-07-28</date>
 
 <chapter>
 <title>Introduction</title>
@@ -152,7 +152,7 @@
 <pre caption="Installing a master boot record">
 <comment>(Make sure you have sys-boot/syslinux-3.00 or later installed)</comment>
 # <i>emerge -av '>sys-boot/syslinux-3'</i>
-# <i>dd if=/usr/lib/syslinux/mbr.bin of=/dev/sdc</i>
+# <i>dd if=/usr/share/syslinux/mbr.bin of=/dev/sdc</i>
 0+1 records in
 0+1 records out
 304 bytes (304 B) copied, 0.0162317 s, 18.7 kB/s






^ permalink raw reply	[flat|nested] 15+ messages in thread

* [gentoo-doc-cvs] cvs commit: liveusb.xml
@ 2008-09-11 21:59 Joshua Saddler
  0 siblings, 0 replies; 15+ messages in thread
From: Joshua Saddler @ 2008-09-11 21:59 UTC (permalink / raw
  To: gentoo-doc-cvs

nightmorph    08/09/11 21:59:10

  Modified:             liveusb.xml
  Log:
  redoing mbr.bin for bug 237227

Revision  Changes    Path
1.15                 xml/htdocs/doc/en/liveusb.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.15&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?rev=1.15&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/liveusb.xml?r1=1.14&r2=1.15

Index: liveusb.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- liveusb.xml	28 Jul 2008 19:24:26 -0000	1.14
+++ liveusb.xml	11 Sep 2008 21:59:10 -0000	1.15
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.14 2008/07/28 19:24:26 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/liveusb.xml,v 1.15 2008/09/11 21:59:10 nightmorph Exp $ -->
 
 <guide link="/doc/en/liveusb.xml">
 <title>Gentoo Linux LiveUSB HOWTO</title>
@@ -21,8 +21,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>3</version>
-<date>2008-07-28</date>
+<version>4</version>
+<date>2008-09-11</date>
 
 <chapter>
 <title>Introduction</title>
@@ -152,7 +152,7 @@
 <pre caption="Installing a master boot record">
 <comment>(Make sure you have sys-boot/syslinux-3.00 or later installed)</comment>
 # <i>emerge -av '>sys-boot/syslinux-3'</i>
-# <i>dd if=/usr/share/syslinux/mbr.bin of=/dev/sdc</i>
+# <i>dd if=/usr/lib/syslinux/mbr.bin of=/dev/sdc</i>
 0+1 records in
 0+1 records out
 304 bytes (304 B) copied, 0.0162317 s, 18.7 kB/s






^ permalink raw reply	[flat|nested] 15+ messages in thread

end of thread, other threads:[~2008-09-11 21:59 UTC | newest]

Thread overview: 15+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2006-09-18 10:51 [gentoo-doc-cvs] cvs commit: liveusb.xml Josh Saddler
  -- strict thread matches above, loose matches on Subject: below --
2008-09-11 21:59 Joshua Saddler
2008-07-28 19:24 Joshua Saddler
2007-05-10 15:51 Xavier Neys
2006-12-22  7:33 Josh Saddler
2006-11-05  4:02 Josh Saddler
2006-09-09 10:00 Josh Saddler
2006-09-04 20:35 Josh Saddler
2006-04-25 12:50 Xavier Neys
2006-02-28 13:51 Jan Kundrat
2006-02-12 14:54 Josh Saddler
2006-01-24 18:32 Marcelo Goes
2006-01-08 21:56 Lukasz Damentko
2006-01-08 21:17 Lukasz Damentko
2006-01-07 23:29 Lukasz Damentko

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox