Rawhide-XO: Difference between revisions

From OLPC
Jump to navigation Jump to search
(→‎See also: more on SoaS, mention occasional XO images.)
(all of the useful content form this page has been moved F11 on XO-11)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
#REDIRECT [[F11 for XO-1]]
{{TOCright}}
This is a page for notes and test results for the http://dev.laptop.org/~cjb/rawhide-xo/ development builds.

== What is it? ==
A "spin" of [[Fedora]] rawhide (the development version of Fedora 11 Linux) incorporating recent [[Linux]] software packages, the [[Sugar]] desktop UI ''and'' a more conventional Gnome desktop.

As such it is sort of a replacement for the cutting-edge [[joyride]] [[OS images]] that OLPC used to produce. See [[Future releases]] for the change in plans.
As such builds are very raw and often ''may not work at all''.

=== Build contents ===
Each nightly Fedora Rawhide build e-mails a list of its packages and sends it to [https://www.redhat.com/archives/fedora-devel-list/ fedora-devel-list].

Rawhide-XO is an adaptation of the nightly Fedora Rawhide. It uses kickstart files (<tt>.ks</tt> files, see http://dev.laptop.org/git/projects/fedora-xo/tree/) to customize the build for the different images it provides.

== Resources ==
* [http://dev.laptop.org/~cjb/rawhide-xo/ preliminary images]
* [http://dev.laptop.org/git/projects/fedora-xo/ sources]
* [https://www.redhat.com/archives/fedora-olpc-list/ mailing list]
* [irc://irc.freenode.net#fedora-olpc IRC]

== Installation ==
The images page http://dev.laptop.org/~cjb/rawhide-xo/ has installation instructions.

=== USB/SD image installation ===
The <tt>.bootable.gz</tt> image writes a partition table as well as the contents of a 2GiB partition to your USB or SD card.
It does this regardless of the actual size or previous partitioning of the memory card.

* wmb: Blasting on a new partition table without regard to the factory partitioning may degrade the device, as discussed in http://wiki.laptop.org/go/How_to_Damage_a_FLASH_Storage_Device . Flash storage devices pretend to behave like conventional hard disks, but often don't succeed.

Note the card must be 2 Gibibytes, which is substantially bigger than 2,000,000,000 bytes;
many 2GB cards only store 1.91 x 1024 x 1024 bytes.

* wmb: ... which argues for making the base image somewhat smaller ...

==== LiveUSB Creator ====
You can instead use the [http://fedorahosted.org/liveusb-creator/ Fedora LiveUSB Creator] to create a live USB or SD from one of the <tt>.iso</tt> files. This can give you a persistent home directory for files and downloaded activities ''but''
* the next time you run LiveUSB Creator it will wipe out your home directory
* changes to system files won't survive your next boot

=== copy-nand installation ===
This will wipe out the contents of your OLPC's NAND flash. However, you can customize the build and install new packages and your changes will survive reboots. Performance is better than booting from USB/SD, and you can use an SD card for swap.

== Basic user guide ==
On first boot at the login screen, you can choose either Gnome or Sugar from the drop-down list at the bottom. You want to login as "liveuser", or wait for automatic login.

=== Sugar ===
If you start the Gnome desktop (the default), you need to exit to switch to Sugar.
(Sugar commands like <tt>sugar</tt> are available to you in Gnome, but running them under another desktop manager is '''not''' recommended.)

To return to the "first boot" login screen from Gnome, in Terminal, run [[su -l]] then run as [[root]]:
init 3
log in as liveuser, then run as root
init 5
it will stop GNOME and restart gdm


In the Sugar desktop, to set the keyboard to match the XO-1's keyboard, start [[Terminal Activity]] and enter
setxkbmap -model olpc
The AltGr key will now work to insert the special characters on some of the keycaps.

See [[Keyboard shortcuts]] for keys in Sugar (e.g. Alt+Shift+F brings up the Frame)
and http://en.flossmanuals.net/Sugar for general Sugar instructions.

=== Accessing NAND Flash ===
If you boot rawhide-XO off USB or SD, the XO-1's internal 1GB of NAND flash storage is left unmounted. But this storage is available as the <tt>mtd0</tt> device. To make this accessible at the path <tt>/mnt/''my_nand''</tt> you could as [[root]] enter the command
mkdir /mnt/my_nand && mount -t jffs2 mtd0 /mnt/my_nand

== Differences from OLPC images ==
''Many of these are probably shared with "Sugar on a Stick" SoaS-2 images, and should be on a common page.''

* the default user is liveuser, not olpc
* liveuser can't use [[sudo]] to run commands as [[root]] (but can run [[su -l]] to become root).
* many olpc commands missing, such as olpc-netstatus
* different file system
** /efi instead of /ofw
** /home/liveuser instead of /home/olpc

== Known issues ==
* On the XO-1, you must hold down the checkmark <nowiki>'</nowiki>'''√'''<nowiki>'</nowiki> gamepad key at boot, otherwise boot will hang with the XO guy on white.
** wmb: The solution for this is to add "dcon-unfreeze unfreeze" to /boot/olpc.fth, somewhere before the "boot" line, thus turning off "pretty boot". Alternatively, if you want to keep pretty boot, releasing the screen only after all of the text messages have finished, you can add "echo 0 >/sys/devices/platform/dcon/freeze" to a late initscript.
* Keyboard map alert.
* Can't choose Gnome or Sugar after desktop login
* You can't choose an English or American OLPC keyboard in the keyboard chooser on the "first boot" login screen.
* No power management until you install [[Ohm]]
* In Gnome, you get warnings from the battery management applet
* The stock Fedora kernel does not play sound, hence (probably) why totem crashes. [https://www.redhat.com/archives/fedora-olpc-list/2009-March/msg00136.html how to replace with the OLPC kernel]

See [https://bugzilla.redhat.com/showdependencytree.cgi?id=461806&hide_resolved=1 Fedora on XO tracker bug dependency tree].

Also see [[{{TALKPAGENAME}}]] for user reports, and [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Getting_Involved/Testing Sugar Labs testing reports] for the similar SoaS-2 images.

=== Kernel differences ===
The OLPC OS Images contained a customized kernel; its differences with the stock Fedora 11 kernel include:
* open firmware interface (arch/x86/kernel/ofw.[ch])
* geode GPIO driver (used by DCON and suspend/resume)
* dcon driver (drivers/video/olpc_dcon.[ch])
* suspend/resume code (arch/x86/kernel/olpc_pm.*)
* parts of the HGPK touchpad: drivers/input/mouse/olpc.c
* working sound drivers

== Reporting bugs ==
* You should file bugs with the Sugar desktop and activities in the [http://dev.sugarlabs.org/ Sugar Labs bug tracker]. You can check with the sugar-devel list before or after.
* Bugs with the Fedora "rawhide" distribution and its behavior on the XO-1 should be filed in the [https://bugzilla.redhat.com Red Hat Bugzilla]. You can check with the Fedora-OLPC list before or after.
:* product "Fedora", version "Rawhide", pick relevant component.
:* After creating your bug, edit it to add '''461806''' in the "Blocks" field to link it to the [https://bugzilla.redhat.com/show_bug.cgi?id=461806 FedoraOnXO tracker bug].
: ''Note: the product "Fedora OLPC" in Red Hat Bugzilla is discontinued. Any bugs filed against this deceased product should be refiled against Fedora if they are still valid.''

== See also ==
* Sugar Labs' [http://sugarlabs.org/go/Sugar_on_a_Stick Sugar on a Stick] initiative. Its "SoaS-2" build images are similar to Rawhide-XO in that they are development builds based on Fedora 11 ("Rawhide"). Unlike Rawhide-XO, Sugar on a Stick is intended to run on a variety of computers and boot straight into the Sugar UI.
Occasionally Sugar Labs produces XO-specific SoaS images.

[[Category:Linux distributions]]
[[Category:Builds]]

Latest revision as of 15:46, 5 October 2009

Redirect to: