OS images: Difference between revisions
Jump to navigation
Jump to search
(→Old development streams: document "olpc3", mention mysterious "meshtest") |
DanielDrake (talk | contribs) No edit summary |
||
| Line 1: | Line 1: | ||
{{Translations}} |
{{Translations}} |
||
{{OLPC}} |
|||
'''To emulate the OLPC environment on your Windows, Mac, or Linux machine''', see [[Emulating the XO]]. |
|||
{{ Latest Releases |
{{ Latest Releases |
||
| rc = inline |
| rc = inline |
||
| Line 10: | Line 8: | ||
| server = inline }} |
| server = inline }} |
||
OLPC produces '''OS images''' (also known as '''software builds''') which can be installed on XO laptops, customized and rebuilt by deployments, etc. These images include all of the system and user software, allowing your XO to boot straight into OLPC's software environment. |
|||
== Definition == |
|||
* To install a specific build on your laptop, follow the links to one of the releases from the box on the right. For other releases, see [[Releases]]. |
|||
OLPC and Red Hat continually develop the [[Fedora]]-derived OLPC [[Linux]] operating system. Each day, we freeze the most up-to-date version of that OS, "build" an '''OS image''', and make it available for download in various formats. |
|||
* The [[Updating the XO]] page references various ways that software images can be installed (but this is usually explained directly on the release or release notes page). |
|||
* If you want to identify which build/release is running on your XO, see [[What release am I running?]]. |
|||
== Upgrades == |
|||
* If you are interested in testing upcoming releases, the [[Friends in testing]] page explains where you can start. |
|||
* If you know what you're doing, you might be able to find the files that you're looking for on http://download.laptop.org |
|||
XO users should follow [[Upgrading the XO]] to upgrade to later system software. |
|||
* To build your own image, see [[Building custom images]]. |
|||
== XO 1.5 hardware images == |
|||
The [[XO 1.5]] laptop hardware requires ''different'' images and firmware, |
|||
most builds described here are for the [[XO-1]] and ''will not work'' on an XO 1.5. |
|||
See [[F11 for 1.5]]. |
|||
== Download directories for XO-1 images == |
|||
There have been several major [[releases]] and many minor releases of the operating system for OLPC, and maintenance and development continues. |
|||
Thus there are many builds available! The latest build might not always be stable since developers are experimenting with new features. Each build is labeled with a unique version number. When reporting problems on mailing lists, please [[How to check the OS and firmware versions|provide the build number you are using]]. |
|||
=== Stable builds === |
|||
Stable, signed builds for the XO-1 are available from: |
|||
: http://download.laptop.org/xo-1/os/official/ |
|||
Similarly, stable builds for the [[XO 1.5]] hardware are available from: |
|||
: http://download.laptop.org/xo-1.5/os/official/ |
|||
Stable builds are cryptographically signed so that any XO can be upgraded to them — you do not need a [[developer key]]. |
|||
A build is marked "stable" when the developers are happy with it. At minimum, it should boot successfully on XO laptops and have [[release notes]]; it normally goes through the [[Software ECO process]]. |
|||
==== Latest stable build ==== |
|||
The latest stable build is the highest-numbered build at http://download.laptop.org/xo-1/os/official; the green "infobox" on this page and others also gives the latest stable. |
|||
=== Release candidate === |
|||
When developers have some confidence in a particular build, they may invite wider testing of it; |
|||
see [[Friends in testing]]. |
|||
Some release candidates are signed and thus can be installed on any XO; others are unsigned and require that you get a [[developer key]]. |
|||
Signed release candidate builds may be available from: |
|||
: http://download.laptop.org/xo-1/os/candidate/ |
|||
=== XO-1 Development builds === |
|||
Note that after 2009, builds are versions of the Fedora Linux distribution that run on the XO with the Sugar desktop. |
|||
See [[Future releases]] and [[F11 for XO-1]]. |
|||
Casual downloaders and those upgrading to a new build '''beware''': |
|||
* read the [[Test group release notes]] to look for testing results on a build |
|||
* you must get a [[Developer key]] before you can install a development build on your XO |
|||
==== Old development streams ==== |
|||
OLPC development proceeded in several [[Property:Build_stream|streams]]. There were updates to existing major releases, experimental features, and the general "latest version", called [[joyride]]. Each stream had development builds. |
|||
"8.2.1" images include relatively stable builds leading up to the next 8.2.''x'' build; as of December 2009 [[Release notes/8.2.1|8.2.1]] is the latest release. |
|||
: http://pilgrim.laptop.org/~pilgrim/olpc/streams/8.2.1/ |
|||
You could download unstable development images from: |
|||
: http://xs-dev.laptop.org/~cscott/olpc/streams (look in "latest" in each stream's directory) |
|||
* "staging" was the integration stream for the [[8.2.1]] release |
|||
* "faster" was for testing experimental features. |
|||
* "[[joyride]]" was an automated development stream. |
|||
* "olpc3" was the stream where the XO software base was ported from Fedora 7 to Fedora 9 in 2008, see [[OLPC-3]] |
|||
* "meshtest" was for ... ?? |
|||
A [http://dev.laptop.org/tinderbox/ Tinderbox] tested some builds. |
|||
=== Historical builds === |
|||
Finally, historical builds are available from: |
|||
: http://olpc.download.redhat.com/olpc/streams/development |
|||
== Image variants == |
|||
Images are available in five variants |
|||
* Normal images in the <tt>ext3/</tt> and <tt>jffs2/</tt> sub-directories |
|||
** Intended for production use |
|||
** Does not contain tools or software suitable for developers of the OLPC operating system |
|||
** The <tt>ext3/</tt> images are intended for USB drives (both hard drives and flash drives) |
|||
** The <tt>jffs2/</tt> images are intended for the on-board NAND flash. |
|||
* Developer images in the <tt>devel_ext3/</tt> and <tt>devel_jffs2/</tt> sub-directories |
|||
** Contains tools useful for developers of the OLPC operating system, including: <tt>yum, rpm, vim-minimal, openssh-server, xterm, which, file, tree, wget, xorg-x11-twm, gdb</tt> packages |
|||
** The <tt>devel_ext3/</tt> images are intended for USB drives (both hard drives and flash drives) |
|||
** The <tt>devel_jffs2/</tt> images are intended for the on-board NAND flash |
|||
** '''WARNING''': Do not attempt to update the kernel on <tt>devel_*</tt> builds - the <tt>initrd</tt> will be wrong. We're working on fixing this through including an <tt>olpc-mkinitrd</tt> package. |
|||
* Live CD images in the <tt>livecd/</tt> sub-directory |
|||
** Contains an iso of a normal image which can be burned onto a cd and run by booting off the cd drive |
|||
Each variant may have available several sub-variants: |
|||
* <tt>tree</tt>: a tarball of the OS directory tree, without a filesystem |
|||
* <tt>img</tt>: a filesystem image (of one of the types described above): you can follow the [[Clean-install procedure]] to re-flash your XO with this. |
|||
* <tt>.toc</tt> and <tt>.usb</tt>: the OS image in a special format that [[olpc-update]] can use to perform an update from USB drive |
|||
These may be compressed in the <tt>bz2</tt> format, requiring the free bunzip2 utility to uncompress. |
|||
== What's in an OS image == |
|||
The download directory for a build's often includes a <tt>build.log</tt> that shows the software packages and steps that created it. It is the output of the [[Build system|build process]]. |
|||
You can uncompress the <tt>tree</tt> version of a build on a running computer to examine the files in the build. |
|||
=== Differences between streams === |
|||
http://dev.laptop.org/~bert has several <tt>''streamA''-''streamB''.html</tt> files that track the different packages in different streams. |
|||
For example, [http://dev.laptop.org/~bert/8.2.1-staging.html 8.2.1-staging.html] compares the latest [[8.2.1]] candidate build with the latest staging build. |
|||
== Languages in which the images are available == |
|||
* English |
|||
* The [[Localization|home Language]] for each participating country |
|||
== Using images == |
|||
=== Installing images to on-board NAND flash on OLPC hardware === |
|||
The '''[[Clean-install procedure]]''' describes how to put an image and supporting files on a USB disk or flash drive so that your XO's [[firmware]] will re-flash its NAND memory and thus update to the new image. |
|||
=== Updating OLPC hardware from USB === |
|||
Newer build directories also provide <tt>os''NNN''.toc</tt> and <tt>os''NNN''.usb</tt> files. |
|||
These are reference files for the [[olpc-update]] command-line tool, so that you can update a running XO to the new build from a USB flash drive. |
|||
=== Booting images from a USB drive === |
|||
For development we offer images that run the OLPC operating system off a USB storage device. These images are located in the <tt>devel_ext3/</tt> sub-directory, and should be used if you're unsure of which image to choose. |
|||
The '''[[OS images for USB disks]]''' page describes how to write these images to a USB disk or flash drive, so that you can test the images on real OLPC hardware, or attempt to boot from them on your own PC. |
|||
=== Images on an emulator === |
|||
The '''[[Emulating the XO]]''' page details how you can run an image of the OLPC operating system on a normal computer that doesn't have the OLPC hardware. |
|||
=== Passwords === |
|||
Some recent builds do not permit root login. There are quite a few tickets. You can login as ''olpc'', no password, and <tt>sudo -i</tt> instead. [[User:MitchellNCharity|MitchellNCharity]] 14:40, 6 January 2008 (EST) |
|||
The images have no password set at build time. This means you can log in as root using no password. Always remember to change the password as the first thing when start using an image. |
|||
As the <tt>image-rpm</tt> variant ships with an SSH server you thus need to set the password to be able to login from a remote host. This is a feature of <tt>sshd</tt>. |
|||
''Password handling is subject to change before official release.'' |
|||
=== Wireless === |
|||
See the [[Wireless]] page for detailed instructions. |
|||
== Test group release notes for images == |
|||
The [[Test Group Release Notes]] page lists the "official" changelog and known problems for each build. Check that page to see if there are any known problems with the build you're installing. |
|||
== User feedback on images == |
|||
If you have an XO, see [[Friends in testing]]. |
|||
Using the [[User Feedback on Images]] page, you can see how the images worked on various systems, using various different hardware and emulator set-ups. You can also add your own reviews. |
|||
== Build names and branches == |
|||
XO users should see [[Release notes]] and [[What release am I running?]]; |
|||
developers can also refer to [[Builds]] and [[Future releases]]. |
|||
== Building your own custom images == |
|||
See [[Building custom images]] |
|||
[[Category:Hardware]] |
[[Category:Hardware]] |
||
Revision as of 18:06, 15 February 2011
OLPC produces OS images (also known as software builds) which can be installed on XO laptops, customized and rebuilt by deployments, etc. These images include all of the system and user software, allowing your XO to boot straight into OLPC's software environment.
- To install a specific build on your laptop, follow the links to one of the releases from the box on the right. For other releases, see Releases.
- The Updating the XO page references various ways that software images can be installed (but this is usually explained directly on the release or release notes page).
- If you want to identify which build/release is running on your XO, see What release am I running?.
- If you are interested in testing upcoming releases, the Friends in testing page explains where you can start.
- If you know what you're doing, you might be able to find the files that you're looking for on http://download.laptop.org
- To build your own image, see Building custom images.