OS images: Difference between revisions

From OLPC
Jump to navigation Jump to search
(→‎What's in an OS image: Mention bert's awesome diffs)
No edit summary
 
(21 intermediate revisions by 10 users not shown)
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 8: Line 6:
| livecd = inline
| livecd = inline
| firmware = inline
| firmware = inline
| extra = 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 XO 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 [[Release notes]] for each release have instructions for installing or upgrading to a release on your XO. The [[Updating the XO]] page references other ways that software images can be installed.

* 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]].

== Download directories for 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/

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 are available from:
: http://download.laptop.org/xo-1/os/candidate/

=== Development builds ===

Casual downloaders and those upgrading to a new build '''beware''':
* check the [http://dev.laptop.org/tinderbox/ Tinderbox] to see whether there are known problems before selecting a build
* 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

==== Development streams ====
OLPC development proceeds in several [[Property:Build_stream|streams]]. There are updates to existing major releases, experimental features, and the general "latest version", called [[joyride]]. Each stream has development builds.

"8.2.1" images include relatively stable builds leading up to the next 8.2.''x'' build. (As of January 2009, build 799 is the latest candidate for a possible [[8.2.1]] release in this build stream).
: http://pilgrim.laptop.org/~pilgrim/olpc/streams/8.2.1/

You can download unstable development images from:
: http://xs-dev.laptop.org/~cscott/olpc/streams (look in "latest" in each stream's directory)
[[joyride]] is the primary development stream (as of January 2009 leading towards a release [[9.1.0]]), "staging" is the integration stream for a possible [[8.2.1]] release, and other streams such as "faster" may be available for testing experimental features.

=== 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]]

Latest revision as of 21:51, 5 August 2013

  english | 日本語 HowTo [ID# 290705]  +/-  



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 XO releases from the box on the right. For other releases, see Releases.
  • The Release notes for each release have instructions for installing or upgrading to a release on your XO. The Updating the XO page references other ways that software images can be installed.
  • 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.