View source for User:NeoAmsterdam/Fedora 11 for XO-1: Install Notes

<div style="float: right;">__TOC__</div>
This brief install note combines techniques used for [[User:NeoAmsterdam/Installing build 8.0.2 to a bootable SD card|Installing build 8.0.2 to a bootable SD card]] and [[F11 for XO-1|Fedora 11 for XO-1]].  Please read both documents thoroughly before proceeding.

= Read Me First =
== Full Disclosure ==
* I '''''am not''''' currently running [[F11 for XO-1|Fedora 11 for XO-1]] as it is still too buggy for day-to-day work - even for bleeding-edge aficionados. The major sticking points experienced were:
** Unreliable network<br />Now you have WiFi, now you don't
** Unresponsive UI<br />Sugar moved like molasses
** Hanging system<br />Probably a bug in the power management software


== Warnings ==
* <span style="color: red;">This procedure will erase and overwrite everything stored on the XO and the SD card.  Back up your data!</span>
* <span style="color: red;">Do not execute this procedure on battery power.  Any power interruption could lead render your XO irrecoverable.</span>
* <span style="color: red;">This procedure requires the use of <tt>fdisk</tt> for partitioning.  Do not attempt this procedure if you are a Linux novice.</span>
* <span style="color: red;">Execute this procedure at your own risk.  I will provide clarifications and explanations if requested, but I will not provide tech-support-style help.</span>
* <span style="color: red;"><b>[[F11 for XO-1|Fedora 11 for XO-1]] is (at time of writing) still in development phase, and is not considered ready for full deployment.</b></span>

== Caveats ==
* <span style="color: orange;">The SD card will be formatted as an ext3 filesystem.  This is not an ideal filesystem for SD cards.</span>
* <span style="color: orange;">This document assumes you already have a developer key.</span>
* <span style="color: orange;">This document assumes that <tt>fdisk</tt> automatically recognizes the starting and ending cylinders for the SD card.</span>
* <span style="color: orange;">The XO may not boot automatically from the SD card if devices are plugged in to the USB slots (I have no idea why this may be).</span>
* <span style="color: orange;"><b>Expect bugs - lots of them.</b>  If you're not OK with that, don't proceed.</span>

== Notes ==
* Some instructions on this page are verbose.  Even though it takes longer, it'll allow you to keep tabs on the XO's progress.
* Children should not attempt this procedure - even if you have permission from a parent, guardian, teacher, and/or Linux guru.<br />Sorry, kids, but there are too many things that can go wrong.  Instead, convince your parent, guardian, teacher, and/or Linux guru to let you watch them debug ;-)

== Requirements ==
* An [[XO]]<br />Obviously.
* A [[USB]] drive<br />≥1 GB
* An [[SD]] card<br />≥1 GB; biggest is "best-est"
* A developer's key<br />The instructions for obtaining a developer's key can be found [[Activation and developer keys|here]].
* Internet connectivity<br />You will need to download some files.

== Optional ==
* You will probably want to use a second computer to download two required files and to back up the XO's data.

= The Procedure =
# Remove the SD card from the slot.
# Follow the directions for installing [[F11 for XO-1]], as described in the section entitled [[F11_for_XO-1#Installation_instructions|Installation Instructions]].
# Once restarted, drop into the [[Console#The_Console|the console]].
# Stop [[Sugar]] and the automounting daemon by lowering the runlevel.<br /><b><tt>/sbin/init 3</tt></b>
# Insert the SD card.
# Determine mounted devices<br /><b><tt>mount</tt></b> will list all the mounted devices.<br />If you see <tt>/dev/mmcblk0p1</tt> mentioned, run <b><tt>umount /dev/mmcblk0p1</tt></b>.<br />If the XO responds with the <tt>device is busy</tt> error message, try <b><tt>cd / ; umount /dev/mmcblk0p1</tt></b>.<br />If the device still can't be unmounted, <b>stop what you're doing</b> - you cannot proceed any further.
# <span style="color: red;">Quick-format the SD card<br /><b><tt>dd if=/dev/zero of=/dev/mmcblk0 bs=512 count=8</tt></b></span>
# <span style="color: red;">Paritition the SD card.<br /><b><tt>fdisk /dev/mmcblk0</tt></b><br />You will now be running <tt>fdisk</tt> interactively.  Create a new primary partition that runs the length of the drive, flag it as bootable, make sure it's type <tt>83</tt> (Linux), and write the changes.</span>
# <span style="color: red;">Format the SD card.  Note: The volume label <b>must</b> be <tt>OLPCRoot</tt> (unless you're prepared to tinker with <tt>/ofw/olpc.fth</tt>) <br /><b><tt>mkfs.ext3 -L "OLPCRoot" /dev/mmcblk0p1</tt></b></span>
# Mount the SD card.<br /><b><tt>mkdir /mnt/SD ; mount -t ext3 /dev/mmcblk0p1 /mnt/SD</tt></b>
# Copy the developer key from the USB drive to the SD card.<br /><b><tt>cp -rv /mnt/USB/security /mnt/SD</tt></b>
# Copy the OS from the NAND to the SD card.<br /><b><tt>cp -prv /versions/pristine/11/* /mnt/SD</tt></b>
# Wait.
# Create the olpc user's home directory.<br /><b><tt>mkdir -pv /mnt/SD/home/olpc ; chown -rv olpc:olpc /mnt/SD/home/olpc</tt></b><br />Note: this may not work the first  time around.  Be ready to recreate <tt>/home/{olpc,root}</tt> with their respective permissions and owners.
# Unmount the SD card.<br /><b><tt>unmount /mnt/SD</tt></b>
# Remove the temporary directory.<br /><b><tt>rmdir -v /mnt/SD</tt></b>
# Restart.<br /><b><tt>shutdown -r now</tt></b><br />You should now be booting off of the SD card.

== See Also ==
* [[F11 for XO-1]]
* [[User:NeoAmsterdam/Installing build 8.0.2 to a bootable SD card|Installing build 8.0.2 to a bootable SD card]]
* [[Installing to SD Card]]

[[Category:Hardware]]
[[Category:Builds]]