Release notes/10.1.3: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
 
(91 intermediate revisions by 15 users not shown)
Line 1: Line 1:
{{outdated}}
[[category:10.1]]
[[category:10.1]]
{{OLPC}}
{{OLPC}}
Line 4: Line 5:
{{TOCright}}
{{TOCright}}
{{Users}}
{{Users}}
{{Draft}}


== Purpose ==
== Purpose ==


An update to software release [[Release_notes/10.1.2|10.1.2]] that fixes important bugs and includes activity improvements. The release is available for XO-1.5 and XO-1 laptops. It contains the latest Sugar 0.84 and the GNOME desktop.
This is an update to software release [[Release_notes/10.1.2|10.1.2]] that fixes important [[Release_notes/10.1.3#Bugs_fixed|bugs]] and includes some [[#New_features|new improvements]]. The release is available for XO-1.5 and XO-1 laptops. It is based on [http://fedoraproject.org/ Fedora] 11 and contains the latest Sugar 0.84 and the [http://www.gnome.org/ GNOME] desktop.
* [[#Installation|Installation instructions]]

== New features ==
===Collaboration "under a tree" on XO-1.5===
We have significantly improved collaboration when XO-1.5 is used with no Access Points available ("under a tree"). The Neighborhood View now shows three default Ad-hoc networks (for channels 1, 6, and 11) in user-friendly icons, and XOs will auto-connect without user intervention. This behavior is similar to the "mesh" behavior on XO-1.

[[Image:Sugar_Adhoc_networks.png|border|300px]]

===Sharing/Backup Journal entries using a mass storage device===
You may now share Journal entries with another learner using a [[USB drive]] or SD card. The user experience is: Martin wants to give a picture he has been drawing to Simon. He plugs in his USB drive and copies the Journal entry on the drive. Simon plugs in Martin's drive in his laptop. The entry will be shown with Martin's XO color on the drive. Simon copies Martin's entry into his Journal.

You can use this feature to backup Journal entries to a USB drive or SD card.

===Connect your XO to external projectors and monitors===

We have added support for USB2VGA adapters. You can now connect an XO to a projector over a USB2VGA adapter and project what is on your XO screen onto a screen or for many people to see.

[[File:Dsc01040.jpg|border|300px]]

More info in the [[Adding_USB_SVGA|USB2VGA feature page.]]

===Screen Rotation on XO-1.5===

On XO-1.5 it is now possible to rotate the screen using the 'rotate' button. This allows learners to use the XO in ebook mode.

[[File:Rotate button.png|border|75px]]

===Protected Activities Support===
In this build certain activities are protected from being deleted by accident. In the activity list in the home view the erase option is disabled for those. Protected activities are: Browse, Terminal, Log, Write, ImageViewer and Record.

[[File:Protected_Activities.png|border|300px]]

===Better interaction between GNOME and Sugar===

Switching between Sugar and GNOME user interfaces is smoother. Changes of settings in GNOME now do not affect Sugar, and vice-versa.

The ~/Activities directory is now hidden from the user in GNOME, to prevent accidental deletions that could harm Sugar (<trac>10531</trac>). The networking settings are now synchronized so enabling/disabling networking is unified (<trac>10532</trac>).

Users can now change GNOME panels (<trac>10539</trac>) and fonts (<trac>10545</trac>) without risk of breaking GNOME -- invalid settings are reset on restart.

The dialog to set a GNOME keyring password when connecting to a secure wireless network has been disabled.

===Browse===
A home button has been added into the Browse toolbar. The button returns to the home page, where important links are.

[[Image:Go-home.png|300px|border]]

A busy cursor has been added for when a page is loading. This was present in 8.2.1 but missing from 10.1.2.

[[Image:Busy cursor.jpg]]

Previews for downloaded images have been added, so that the Journal will show appropriate thumbnails of downloaded images.

[[Image:Preview browse image downloaded.png|border|300px]]

===Paint===
The Paint activity has been improved a lot:

* The cursor has been enhanced and realigned,
* Text tool has been improved
* New filters: invert colors and mirror effects
* Tool size and shape are shown
* Improvements to copy and paste

[[Image:Paint-screen.png‎|border|border|300px]]

===Read===
Scrolling has been improved. The up and down directional keypad to the left of the XO display will now scroll, which is especially useful if the laptop is in ebook mode.

[[File:Dpad.png|border|75px]]

Using the fn key with the up and down arrow keys will now scroll by page.

===Write===

You can now paste images into Write. The images can be copied from Browse, Paint or Write.

You can now put images into tables.

You can now export to PDF.

[[File:Write_export_pdf.png|border|300px]]

The style list has been reordered to place paragraph text styles before heading styles.

===Wikipedia===
Page loading has been sped up and several smaller fixes made.

===Scratch===
A new camera plugin adds importing from camera on XO-1.

[[File:Scratch_camera_XO-1.png|border|300px]]

===Activity Updates===
We included the latest versions of Calculate, Colors, Distance, Etoys, Help, InfoSlicer, Jukebox, Labyrinth, Memorize, Physics, Pippy, Turtle Art and Typing Turtle.

===System Lid Behavior===
When the lid is closed on the XO, the laptop will suspend its operations and turn off the screen. Historically re-opening the lid has turned on the screen and woken up the laptop for normal use. In order to avoid a problem where stacked XO units may accidentally turn each other back on, this wake-up behavior has been disabled. To wake up the laptop from suspend press the power button once.


== Installation ==
== Installation ==



=== XO-1.5 ===
=== XO-1.5 ===


{{Software_Install|path=http://build.laptop.org/10.1.3/xo-1.5/os360|release=10.1.3|build=os360-4g|model=XO-1.5|signed=no}}
{{Software_Install|path=http://download.laptop.org/xo-1.5/os/official/os860/4GB|release=10.1.3|build=os860-4g|model=XO-1.5|signed=yes}}


=== XO-1 ===
=== XO-1 ===


{{Software_Install|path=http://build.laptop.org/10.1.3/xo-1/os360|release=10.1.3|build=os360|model=XO-1|signed=no}}
{{Software_Install|path=http://download.laptop.org/xo-1/os/official/os860|release=10.1.3|build=os860|model=XO-1|signed=yes}}

'''Note''': if you are installing after using XO-1 builds os650, os653 or os656 have your XO plugged into external power during the install process in order to update the firmware. Otherwise, XO-1's updated from these builds will hang during the 10.1.3 boot process. After installation completes, you may also need to briefly remove the battery as well as the external power source in order to ensure that your keyboard works properly (<trac>10598</trac>).


== Update ==
== Update ==
Line 28: Line 129:
=== Compatibility ===
=== Compatibility ===
A few previous versions do not support this method.
A few previous versions do not support this method.
Here are the known working update combinations:
Here are the '''known working''' update combinations:
*release 8.2.1 (build os802.img and gg-802-1.img) to release 10.1.3 on XO-1,
*release 8.2.1 (build os802.img and gg-802-1.img) to release 10.1.3 on XO-1,
*release 10.1.0 to release 10.1.3 on XO-1.5,
*release 10.1.0 to release 10.1.3 on XO-1.5,
Line 34: Line 135:
*release 10.1.2 to release 10.1.3 on XO-1.5.
*release 10.1.2 to release 10.1.3 on XO-1.5.


=== Known Problems ===
=== Known Update problems ===
After an operating system update there are a few known problems:
After an operating system update there are a few known problems:
*all known wireless access points are forgotten, and you must choose an access point again,
* if you update from a version before 10.1.x all known wireless access points are forgotten, and you must choose an access point again,
* [[File:Activity-scratch.svg]] the Scratch activity will not be updated to the version included with 10.1.3 by running the activity updater in the Control Panel when upgrading from a previous OS version (<trac>10601</trac>). A workaround is to erase the Scratch activity (in the activity list) and run the activity updater in the Control Panel again. This problem does not happen if you install 10.1.3 directly without upgrading from a previous operating system release.
*the "Journal is full" message is likely to appear if not enough space has been made prior to update, and you may need to remove journal entries, activities, or the [[Olpc-update#Purging_a_previous_OS|previous operating system version]] to bring the system back to normal operation.
*the "Journal is full" message is likely to appear if not enough space has been made prior to update; you can remove journal entries, activities, and the [[Olpc-update#Purging_a_previous_OS|previous operating system version]] to bring the system back to normal operation.


=== Preparation ===
=== Preparation ===
To prepare for an operating system update:
To prepare for an operating system update:
*remove as much saved content as you no longer need,
* remove as much saved content as you no longer need,
*remove any large activities you no longer need, and;
* remove any large activities you no longer need, and;
*use [[Software update]] to ensure the Terminal activity is the latest available version.
* use [[Software update]] to ensure the Terminal activity is the latest available version.
* if you are updating from 8.2.1, remove the activity groups file, start the [[Terminal Activity]] and type:
rm /home/olpc/Activities/.groups


Follow the instructions in one of the subsections below, according to which method and laptop model you are using.
Follow the instructions in one of the subsections below, according to which method and laptop model you are using.
Line 54: Line 158:
==== XO-1.5 ====
==== XO-1.5 ====


sudo olpc-update 10.1.3_xo1.5-360
sudo olpc-update 10.1.3_xo1.5-860


==== XO-1 ====
==== XO-1 ====


sudo olpc-update 10.1.3_xo1-360
sudo olpc-update 10.1.3_xo1-860


See [[Olpc-update#Simple_online_update|Simple Online Update]] for more detail about the method.
See [[Olpc-update#Simple_online_update|Simple Online Update]] for more detail about the method.
Line 66: Line 170:
*download a .usb and .toc file,
*download a .usb and .toc file,
**for XO-1.5
**for XO-1.5
***[http://build.laptop.org/10.1.3/xo-1.5/os360/os360.usb os360.usb],
***[http://build.laptop.org/10.1.3/xo-1.5/os860/os860.usb os860.usb],
***[http://build.laptop.org/10.1.3/xo-1.5/os360/os360.toc os360.toc],
***[http://build.laptop.org/10.1.3/xo-1.5/os860/os860.toc os860.toc],
**for XO-1
**for XO-1
***[http://build.laptop.org/10.1.3/xo-1/os360/os360.usb os360.usb],
***[http://build.laptop.org/10.1.3/xo-1/os860/os860.usb os860.usb],
***[http://build.laptop.org/10.1.3/xo-1/os360/os360.toc os360.toc],
***[http://build.laptop.org/10.1.3/xo-1/os860/os860.toc os860.toc],
*put them on a [[USB drive]],
*put them on a [[USB drive]],
*boot the laptop normally,
*boot the laptop normally,
Line 80: Line 184:
See [[Olpc-update#Simple_offline_update|Simple Offline Update]] for more detail about the method.
See [[Olpc-update#Simple_offline_update|Simple Offline Update]] for more detail about the method.


== New features ==
=== After the Update ===
===Collaborate without infrastructure on the XO-1.5===
To mimic the mesh behavior on devices where mesh hardware is not available and make the "under a tree"-scenario possible the Sugar Ad-hoc networks have been added. The feature adds three default Ad-hoc networks, for channel 1, 6, and 11. They are represented with designated icons in the Neighborhood view.


* It is likely that the system will have limited disk space available. The "Journal is full" message may appear -- you can remove the [[Olpc-update#Purging_a_previous_OS|previous operating system version]].
[[File:Sugar_Adhoc_networks.png]]
* Sugar will attempt to update its Activities -- you should be online for the Activity Updater to complete.


== Known Problems ==
===Sharing/Backup Journal entries using a mass storage device===
With build 10.1.3 we added back the possibility to share Journal entries with another learner using a mass storage device (e.g. USB-Stick). The user experience can be described as the following: Martin wants to give a picture he has been drawing to Simon. He plugs in his USB-stick and copies the Journal entry on the stick. The entry will be shown with Martin's XO color on the stick. Simon insert the stick and copies Martin's entry into his Journal.


=== Sugar ===
You can use this feature as well to backup Journal entries on a mass storage device.


===Project Sugar from your XO onto a wall===
==== Record activity video recording may pause ====
We have been adding support for USB2VGA adapters in 10.1.3. This gives you the possibility to connect an XO with a projector over a USB2VGA adapter and project what is on your XO screen onto a wall.


When recording a video of a very complex natural scene, such as moving vegetation, the recording may pause. If this happens, reducing camera movement may allow the laptop to catch up. The pause is visible on playback.
<gallery>
Image:Dsc01040.jpg|
</gallery>


On XO-1.5, switch to ''Low'' quality and try again. XO-1 only has ''Low'' quality.
===Polishing the interaction between GNOME and Sugar===
A focus during the 10.1.3 development process was to make switching between Sugar and GNOME smooth and that settings a user does under GNOME have no side effect on Sugar and the other way around.


On XO-1.5, the class of SD card ordered by the deployment will have some bearing on the video recording performance. Lower class cards such as Class 2 are more likely to experience pauses during recording. Higher class cards such as Class 6 are less likely to experience pauses.
The ~/Activities directory is now hidden for the user in GNOME. This prevents Sugar from becoming unusable because the director has been erased <trac>10531</trac>. The networking state between Sugar and GNOME is synced now, disabling/enabling networking in the Sugar Control Panel or the nm-applet in GNOME does not have a negative side effect in the other user interface anymore <trac>10532</trac>. Furthermore the GNOME panels <trac>10539</trac> and the GNOME fonts <trac>10545</trac> are restored on next login if the user has made heavy changes to them.


In the previous release 8.2.1, the pause was spread throughout the recording, lowering the effective frame rate. In this release the frame rate is kept as fast as possible until the pause is unavoidable.
Besides that the request to set a GNOME keyring password when connecting to a secure wireless network has been disabled. This will make the 'connect to the internet' experience under GNOME much more smoother.


==== Some Language Support Removed ====
===Browse===
Based on requests from the field we were able to improve the Browse activity in the following ways: A Home button has been added into the Browser toolbar. The button gives you the possibility to always go back to the starting page.


Your language preference may not be available in the Sugar -> My Settings -> Language control panel icon.
[[File:Go-home.png]]


Compared to the 8.2.1 release for XO-1, the 10.1.x series removes several languages that are not required by the current mass deployments of XO-1.5, in order to conserve disk space on the smallest configuration that can be ordered -- see <trac>9982</trac>.
In the 8.2.x builds the cursor in the Browser did change while a page was loading. This important indicator has been missing in the 10.1.x builds and has now been restored.


These languages can be added back by deployments that require them, by [[OS_Builder|regenerating the build]] -- our support team will be glad to help.
[[File:Busy cursor.jpg]]


==== Under the tree is not automatic when mixing laptop models ====
Another important change is that images that are downloaded with Browse create a preview in the Journal.


In the absence of a wireless access point, a group of mixed XO-1 and XO-1.5 laptops will not automatically begin to collaborate over wireless. A workaround is to join an ad-hoc network on an XO-1.5 unit, and then join it from the other laptops.
[[File:Preview browse image downloaded.png]]


==== Restoring wireless connection takes too long ====
===Paint===
The cursors have been cleaned up, the text tool has been improved, new effects have been added (invert colors, mirror), we show the pencil/brush size and shape, copy and paste is now working and many smaller UI fixes have been going into this release.


It can take between 30 and 35 seconds before wireless access points are detected or the wireless connection is restored after:
===Read===
*opening the lid, or resuming from suspend, <trac>9854</trac>
In the new Read version scrolling in PDFs has been improved. The dpad up/down keys and the arrow up down keys will allow you to scroll. Using fn+arrow keys (Page up/Page down) will move forward/backward by bigger chunks.
*manually turning the radio back on, <trac>10272</trac>


==== Sugar frame speaker icon does not reflect volume hot key usage ====
===Write===
The copy and paste functionality for images from Browse and Paint into Write has been improved. Furthermore, images can be placed in tables now, and an option has been added to export your writing to a PDF.


When pressing the volume hot keys (f11/f12) the volume levels are changed accordingly. The icon in the Sugar frame does not show the change - <trac>9913</trac>.
[[File:Write_export_pdf.png]]


==== Content update not available ====
===Wikipedia===
The page loading has been speed up and several smaller fixes have been going in the English and Spanish version of this offline Wikipedia activity.


The activity updater cannot update content bundles. It will download the new bundle, but silently fail to install it, and continue offering the same update for installation (<trac>11064</trac>).
===Scratch===
The new camera plugin 0.8 makes the importing from the camera on an XO-1 possible.


=== GNOME ===
[[File:Scratch_camera_XO-1.png]]


==== Repeating file browser window ====


A new file browser window may appear as the system wakes if a USB or SD card is inserted, <trac>10306</trac>.
===Activity Updates===
We include the last versions of Physics, TurtleArt, Calculate, Pippy and Etoys.


== Known Problems ==
=== Fedora ===


==== CUPS Documentation ====
* Sugar frame speaker icon does not reflect volume hot key usage <trac>9913</trac>


If CUPS is to be installed, the documentation used by the web browser won't be available. To fix this, remove the _excludedocs macro from /etc/rpm/macros.imgcreate before installing CUPS. <trac>10283</trac>.
See [[Release_notes/10.1.2#Known_Problems_2 prior release known problems]].

=== XO-1.5 ===

==== XO-1.5 Record activity preview black on lid close and open ====

With the Record activity on screen displaying a preview of the camera image, closing the laptop lid for long enough to cause a suspend, and then opening it, results in the preview going black (<trac>10068</trac>).

If this happens, the preview can be restored by pressing Alt/Tab, or switching between Sugar views using the keyboard keys or the frame icons.

The black preview does not affect the taking of photographs, or recording of video. If a video recording is being made, there will be a segment of time missing in the playback.

=== XO-1 ===

==== XO-1 Automatic power management issues ====

With My Settings -> Power -> Automatic power management turned on:
*wireless network connectivity may fail, <trac>10232</trac>, or take some time to resume, <trac>9854</trac>, <trac>10272</trac>,
*touchpad may seem slow to respond as the system wakes, <trac>10233</trac>,
*in GNOME a new file browser window may appear as the system wakes if a USB or SD card is inserted, <trac>10306</trac>.


== Bugs fixed ==
== Bugs fixed ==
Line 293: Line 406:
* use compressed sources file (EtoysV4.stc) To take up less space on machines with a non-compressing file system (i.e., about anything except XO-1, but in particular the XO-1.5) this version uses a compressed sources file (before: 18 MB, now: 4.5 MB).
* use compressed sources file (EtoysV4.stc) To take up less space on machines with a non-compressing file system (i.e., about anything except XO-1, but in particular the XO-1.5) this version uses a compressed sources file (before: 18 MB, now: 4.5 MB).


===Sratch===
===Scratch===
* new camera plugin 0.8, fixes import from camera on XO-1 <trac>10413</trac>
* new camera plugin 0.8, fixes import from camera on XO-1 <trac>10413</trac>


Line 329: Line 442:


===Jukebox===
===Jukebox===
* Update of the translations
* New translations updated in this release

Latest revision as of 07:35, 6 August 2013

The contents of this page are considered outdated and some of the information may be stale. Please use information here with caution, or update it.
  This page is monitored by the OLPC team.
  For the general public

Purpose

This is an update to software release 10.1.2 that fixes important bugs and includes some new improvements. The release is available for XO-1.5 and XO-1 laptops. It is based on Fedora 11 and contains the latest Sugar 0.84 and the GNOME desktop.

New features

Collaboration "under a tree" on XO-1.5

We have significantly improved collaboration when XO-1.5 is used with no Access Points available ("under a tree"). The Neighborhood View now shows three default Ad-hoc networks (for channels 1, 6, and 11) in user-friendly icons, and XOs will auto-connect without user intervention. This behavior is similar to the "mesh" behavior on XO-1.

Sugar Adhoc networks.png

Sharing/Backup Journal entries using a mass storage device

You may now share Journal entries with another learner using a USB drive or SD card. The user experience is: Martin wants to give a picture he has been drawing to Simon. He plugs in his USB drive and copies the Journal entry on the drive. Simon plugs in Martin's drive in his laptop. The entry will be shown with Martin's XO color on the drive. Simon copies Martin's entry into his Journal.

You can use this feature to backup Journal entries to a USB drive or SD card.

Connect your XO to external projectors and monitors

We have added support for USB2VGA adapters. You can now connect an XO to a projector over a USB2VGA adapter and project what is on your XO screen onto a screen or for many people to see.

Dsc01040.jpg

More info in the USB2VGA feature page.

Screen Rotation on XO-1.5

On XO-1.5 it is now possible to rotate the screen using the 'rotate' button. This allows learners to use the XO in ebook mode.

Rotate button.png

Protected Activities Support

In this build certain activities are protected from being deleted by accident. In the activity list in the home view the erase option is disabled for those. Protected activities are: Browse, Terminal, Log, Write, ImageViewer and Record.

Protected Activities.png

Better interaction between GNOME and Sugar

Switching between Sugar and GNOME user interfaces is smoother. Changes of settings in GNOME now do not affect Sugar, and vice-versa.

The ~/Activities directory is now hidden from the user in GNOME, to prevent accidental deletions that could harm Sugar (<trac>10531</trac>). The networking settings are now synchronized so enabling/disabling networking is unified (<trac>10532</trac>).

Users can now change GNOME panels (<trac>10539</trac>) and fonts (<trac>10545</trac>) without risk of breaking GNOME -- invalid settings are reset on restart.

The dialog to set a GNOME keyring password when connecting to a secure wireless network has been disabled.

Browse

A home button has been added into the Browse toolbar. The button returns to the home page, where important links are.

Go-home.png

A busy cursor has been added for when a page is loading. This was present in 8.2.1 but missing from 10.1.2.

Busy cursor.jpg

Previews for downloaded images have been added, so that the Journal will show appropriate thumbnails of downloaded images.

Preview browse image downloaded.png

Paint

The Paint activity has been improved a lot:

  • The cursor has been enhanced and realigned,
  • Text tool has been improved
  • New filters: invert colors and mirror effects
  • Tool size and shape are shown
  • Improvements to copy and paste

Paint-screen.png

Read

Scrolling has been improved. The up and down directional keypad to the left of the XO display will now scroll, which is especially useful if the laptop is in ebook mode.

Dpad.png

Using the fn key with the up and down arrow keys will now scroll by page.

Write

You can now paste images into Write. The images can be copied from Browse, Paint or Write.

You can now put images into tables.

You can now export to PDF.

Write export pdf.png

The style list has been reordered to place paragraph text styles before heading styles.

Wikipedia

Page loading has been sped up and several smaller fixes made.

Scratch

A new camera plugin adds importing from camera on XO-1.

Scratch camera XO-1.png

Activity Updates

We included the latest versions of Calculate, Colors, Distance, Etoys, Help, InfoSlicer, Jukebox, Labyrinth, Memorize, Physics, Pippy, Turtle Art and Typing Turtle.

System Lid Behavior

When the lid is closed on the XO, the laptop will suspend its operations and turn off the screen. Historically re-opening the lid has turned on the screen and woken up the laptop for normal use. In order to avoid a problem where stacked XO units may accidentally turn each other back on, this wake-up behavior has been disabled. To wake up the laptop from suspend press the power button once.

Installation

XO-1.5

How to install signed build os860-4g of release 10.1.3 on XO-1.5.

The build is installed to the internal microSD device. You will need a USB drive of at least 1 GB capacity, but only for the duration of the installation.

ALL USER DATA WILL BE ERASED FROM THE LAPTOP!

  • Prepare the USB drive:
    • Download os860-4g.zd,
    • Save the file to the top directory of the USB drive,
    • Download os860-4g.zsp.fs.zip,
    • Save the file to the top directory of the same USB drive,
    • Rename the file to fs.zip, (removing the os860-4g.zsp part of the name),
    • Check the USB drive contains at least the two files fs.zip and os860-4g.zd.
  • Prepare the laptop:
    • Make a copy of any data you wish to keep,
    • Check the battery is inserted and locked,
    • Check that the power cord is in place and the battery indicator is green,
    • Turn off the laptop, unless it is already off,
    • Insert the USB drive into any USB port on the laptop,
  • Start installing:
    • Hold down all four game keys (see this in pictures),
    • Turn on the laptop,
    • Wait for the message Release the game keys to continue,
    • Release the game keys.

Installation progress will be displayed. Green colour will fill grey blocks. It will take about ten minutes. Once finished, the laptop will reboot automatically. Remove the USB drive during or after the reboot. The USB drive can be used on other laptops.

If you see a message Boot failed then either:

  • the USB drive has not been properly prepared, or;
  • the firmware is out of date and should be updated (see Firmware).

XO-1

How to install signed build os860 of release 10.1.3 on XO-1.

The build is installed to the internal NAND flash device. You will need a USB drive of at least 1 GB capacity, but only for the duration of the installation.

ALL USER DATA WILL BE ERASED FROM THE LAPTOP!

  • Prepare the USB drive:
    • Download os860.img,
    • Save the file to the top directory of the USB drive,
    • Download os860.img.fs.zip,
    • Save the file to the top directory of the same USB drive,
    • Rename the file to fs.zip, (removing the os860.img part of the name),
    • Check the USB drive contains at least the two files fs.zip and os860.img.
  • Prepare the laptop:
    • Make a copy of any data you wish to keep,
    • Check the battery is inserted and locked,
    • Check that the power cord is in place and the battery indicator is green,
    • Turn off the laptop, unless it is already off,
    • Insert the USB drive into any USB port on the laptop,
  • Start installing:
    • Hold down all four game keys (see this in pictures),
    • Turn on the laptop,
    • Wait for the message Release the game keys to continue,
    • Release the game keys.

Installation progress will be displayed. Green colour will fill yellow blocks. It will take about five minutes. Once finished, the laptop will reboot automatically. Remove the USB drive during or after the reboot. The USB drive can be used on other laptops.

If you see a message Boot failed then either:

  • the USB drive has not been properly prepared, or;
  • the firmware is out of date and should be updated (see Firmware).

Note: if you are installing after using XO-1 builds os650, os653 or os656 have your XO plugged into external power during the install process in order to update the firmware. Otherwise, XO-1's updated from these builds will hang during the 10.1.3 boot process. After installation completes, you may also need to briefly remove the battery as well as the external power source in order to ensure that your keyboard works properly (<trac>10598</trac>).

Update

You may wish to update from a previous version of the operating system. This method preserves most user data, the Sugar Journal and installed Sugar Activities, but does not preserve certain operating system customizations such as additional packages.

(Update is distinct from install. If you have followed the install procedures above, then you need not follow this section.)

Compatibility

A few previous versions do not support this method. Here are the known working update combinations:

  • release 8.2.1 (build os802.img and gg-802-1.img) to release 10.1.3 on XO-1,
  • release 10.1.0 to release 10.1.3 on XO-1.5,
  • release 10.1.1 to release 10.1.3 on XO-1.5,
  • release 10.1.2 to release 10.1.3 on XO-1.5.

Known Update problems

After an operating system update there are a few known problems:

  • if you update from a version before 10.1.x all known wireless access points are forgotten, and you must choose an access point again,
  • Activity-scratch.svg the Scratch activity will not be updated to the version included with 10.1.3 by running the activity updater in the Control Panel when upgrading from a previous OS version (<trac>10601</trac>). A workaround is to erase the Scratch activity (in the activity list) and run the activity updater in the Control Panel again. This problem does not happen if you install 10.1.3 directly without upgrading from a previous operating system release.
  • the "Journal is full" message is likely to appear if not enough space has been made prior to update; you can remove journal entries, activities, and the previous operating system version to bring the system back to normal operation.

Preparation

To prepare for an operating system update:

  • remove as much saved content as you no longer need,
  • remove any large activities you no longer need, and;
  • use Software update to ensure the Terminal activity is the latest available version.
  • if you are updating from 8.2.1, remove the activity groups file, start the Terminal Activity and type:
 rm /home/olpc/Activities/.groups

Follow the instructions in one of the subsections below, according to which method and laptop model you are using.

Simple Online Update

  • establish an internet connection from the laptop (if you plan to do online update),
  • start the laptop normally,
  • start the Terminal Activity, and depending on the laptop model type:

XO-1.5

sudo olpc-update 10.1.3_xo1.5-860

XO-1

sudo olpc-update 10.1.3_xo1-860

See Simple Online Update for more detail about the method.

Simple Offline Update

sudo olpc-update --usb

See Simple Offline Update for more detail about the method.

After the Update

  • It is likely that the system will have limited disk space available. The "Journal is full" message may appear -- you can remove the previous operating system version.
  • Sugar will attempt to update its Activities -- you should be online for the Activity Updater to complete.

Known Problems

Sugar

Record activity video recording may pause

When recording a video of a very complex natural scene, such as moving vegetation, the recording may pause. If this happens, reducing camera movement may allow the laptop to catch up. The pause is visible on playback.

On XO-1.5, switch to Low quality and try again. XO-1 only has Low quality.

On XO-1.5, the class of SD card ordered by the deployment will have some bearing on the video recording performance. Lower class cards such as Class 2 are more likely to experience pauses during recording. Higher class cards such as Class 6 are less likely to experience pauses.

In the previous release 8.2.1, the pause was spread throughout the recording, lowering the effective frame rate. In this release the frame rate is kept as fast as possible until the pause is unavoidable.

Some Language Support Removed

Your language preference may not be available in the Sugar -> My Settings -> Language control panel icon.

Compared to the 8.2.1 release for XO-1, the 10.1.x series removes several languages that are not required by the current mass deployments of XO-1.5, in order to conserve disk space on the smallest configuration that can be ordered -- see <trac>9982</trac>.

These languages can be added back by deployments that require them, by regenerating the build -- our support team will be glad to help.

Under the tree is not automatic when mixing laptop models

In the absence of a wireless access point, a group of mixed XO-1 and XO-1.5 laptops will not automatically begin to collaborate over wireless. A workaround is to join an ad-hoc network on an XO-1.5 unit, and then join it from the other laptops.

Restoring wireless connection takes too long

It can take between 30 and 35 seconds before wireless access points are detected or the wireless connection is restored after:

  • opening the lid, or resuming from suspend, <trac>9854</trac>
  • manually turning the radio back on, <trac>10272</trac>

Sugar frame speaker icon does not reflect volume hot key usage

When pressing the volume hot keys (f11/f12) the volume levels are changed accordingly. The icon in the Sugar frame does not show the change - <trac>9913</trac>.

Content update not available

The activity updater cannot update content bundles. It will download the new bundle, but silently fail to install it, and continue offering the same update for installation (<trac>11064</trac>).

GNOME

Repeating file browser window

A new file browser window may appear as the system wakes if a USB or SD card is inserted, <trac>10306</trac>.

Fedora

CUPS Documentation

If CUPS is to be installed, the documentation used by the web browser won't be available. To fix this, remove the _excludedocs macro from /etc/rpm/macros.imgcreate before installing CUPS. <trac>10283</trac>.

XO-1.5

XO-1.5 Record activity preview black on lid close and open

With the Record activity on screen displaying a preview of the camera image, closing the laptop lid for long enough to cause a suspend, and then opening it, results in the preview going black (<trac>10068</trac>).

If this happens, the preview can be restored by pressing Alt/Tab, or switching between Sugar views using the keyboard keys or the frame icons.

The black preview does not affect the taking of photographs, or recording of video. If a video recording is being made, there will be a segment of time missing in the playback.

XO-1

XO-1 Automatic power management issues

With My Settings -> Power -> Automatic power management turned on:

  • wireless network connectivity may fail, <trac>10232</trac>, or take some time to resume, <trac>9854</trac>, <trac>10272</trac>,
  • touchpad may seem slow to respond as the system wakes, <trac>10233</trac>,
  • in GNOME a new file browser window may appear as the system wakes if a USB or SD card is inserted, <trac>10306</trac>.

Bugs fixed

sugar

os350

  • Journal: Show alert when error occurs while writing to external devices <trac>10312</trac>
  • AP: separate signal strength from status <trac>10347</trac>
  • Add default Ad-hoc networks <trac>9845</trac>
  • Connect to gabble immediately when possible <trac>10350</trac>
  • Unable to register a laptop after trying on the wrong network <trac>6857</trac>
  • Feedback when deleting files on an external device <trac>10351</trac>
  • Do not break if the string contains no conversion specifier <trac>10372</trac>
  • Save title when closing <trac>10346</trac>

os351

  • Disable start option for entries that can't be opened <trac>8733</trac>
  • Cleanup temporary files on startup <trac>10301</trac>
  • restore sugar-launch by bundle id substring, fixes <trac>9189</trac>
  • New go-home icon, needed by Browse <trac>10364</trac>
  • Remove shared activity from the neighborhood view when no members left <trac>10308</trac>
  • Deal with unicode nick names <trac>889</trac> (moved patch from rpm into repository)

os353

  • Adapt bundleregistry to use the new activity version scheme <trac>10379</trac>
  • Sugar Ad-hoc icons show in search results when connect/disconnect to AP OLPC <trac>10412</trac>
  • Add new activity numbering scheme <trac>10379</trac>

os354

  • Add new activity numbering scheme to the activity updater <trac>10397</trac>

os355

  • bundlebuilder: install mimetypes.xml and associated icon <trac>10427</trac>
  • Apply new version scheme as well to content bundles <trac>10379</trac>

os357

  • Convert Journal entries that have been saved to a storage device in 0.82 <trac>9658</trac>
  • Possibility to share Journal entry using a storage device <trac>9657</trac>
  • Adjust copyright in Control Panel <trac>10273</trac>
  • Journal bundle removal won't remove installed activity <trac>10486</trac>

olpc-kbdshim

os351

  • dpad rotates wrong <trac>10380</trac>

olpc-powerd

os351

  • avoids resume from suspend when lid opens <trac>10402</trac>

os354

  • Better collaboration support when idle suspend is enabled <trac>9535</trac>
  • Do not wake up on lid open on XO-1 <trac>10424</trac>

os357

  • better power logging

olpc-utils

os352

  • add config for screen rotation (part of <trac>9350</trac>)
  • Enable SiSUSB support (part of <trac>10210</trac>)

squeak-vm

  • Remove MySqueak option from GNOME <trac>9785</trac>

kernel

os354

  • Support for uvcvideo <trac>10378</trac>
  • Lid wakeups on XO-1 are now implemented via new /sys/power/wake-on-lid node <trac>10398</trac>, <trac>10399</trac>, <trac>10424</trac>

xorg-x11-drv-openchrome

os351

  • Screen rotation support for XO-1.5 <trac>9350</trac>

xorg-x11-drv-sisusb

os352

  • Make SISUSBVGA devices trivial to use <trac>10210</trac>

Browse

os351

  • Browse has no "busy" indication <trac>10383</trac>

os353

  • Web activity uses gettext on file name <trac>6874</trac>
  • History not right when resuming activity <trac>10437</trac>
  • Add Home Button in Browse <trac>10364</trac>
  • Browse fails to download some files with non-ascii characters <trac>8857</trac>
  • Can not save pictures from the olpc library with Browse to Journal <trac>10365</trac>
  • Palettes in Browse do not always go away <trac>10407</trac>

Distance

os353

  • Changes ringdown values for mor stable meassures (part of <trac>10122</trac>)

Paint

os353

  • Use new colorchooser (still use ColorSelector for <= 0.82) <trac>1015</trac>
  • Fixed aspect ratio mode for Shape tools <trac>3705</trac>
  • New suggestion for arrow drawing in Paint <trac>4170</trac>
  • Changes made to save the last added text item <trac>5917</trac>
  • Paint - Rect. Marquee icon changes erratically <trac>5882</trac>
  • Implemented Mirroring Effect in Paint Activity - SL#2463
  • Added Invert Color Effect to Paint Activity - <trac>2495</trac>
  • Title for 'Rectangualar Marquee' tool changed to 'Select Area' - SL #2266
  • Paint starts with a random color selected SL #2053
  • Paste images from clipboard - SL #813, <trac>9022</trac>
  • paint overwrites file type instead of creating new file - SL #1771
  • Slider bar should change brush and line width - <trac>8865</trac>
  • Tools & Shapes would be a radio button set - <trac>3695</trac> and <trac>3694</trac>
  • Active point of Paint pointers should be at tip of penscil, brush, drip on fill bucket, etc - SL #296
  • The free form polygn tool should be in the shapes toolbar - <trac>3693</trac>
  • turn off activity sharing - SL #1863
  • Make "keep aspect ratio" selection visible in the UI. - SL #931
  • Under tools tab, pencil size funcionality is not working - SL #1902
  • Change in the icon activity to avoid errors in new librsvg
  • Clean up cursors
  • Add binary files to python 2.7

Write

os353

  • Change the default method to insert images <trac>3066</trac> and <trac>7405</trac>. This adds a checkbox to enable the user to select the method
  • Preserve the mime type when reading and saving files. Related to tickets <trac>8972</trac>, <trac>5291</trac>, <trac>1925</trac> and SL #2127.
  • Add option to export to PDF - SL #1458
  • Paste images in write <trac>2507</trac> and <trac>7186</trac>. Now you can copy an image from Paint, Browse or Write and paste in Write.

os354

  • Don't set the activity metadata property when save PDF file because Write can save PDF files but can't open them <trac>10442</trac>
  • The mime types from files rtf and html have text/plain in mime_parents. We need to modify the criteria to open them like rich text <trac>8972</trac>

Read

os353

  • Add scrolling options for PDFs <trac>10396</trac>

Help

os353

  • Fix permissions for HTML pages: use 0644
  • Fix icon for F13 changes in rendering <trac>8513</trac>
  • Use go-home icon <trac>8575</trac>, <trac>10267</trac>
  • Add view toolbar, with zoom in, zoom out and full screen buttons
  • Remove width from content section in css to improve screen usage
  • Merge with latest XO 1.5 branch

Pippy

os353

  • Cannot start "Thanks" example <trac>10384</trac>
  • Add EditToolbar & modify toolbars for <=0.84 compatibility <trac>10395</trac>
  • Fix svg icons for Pippy
  • Remove the 'dobject'/groupthink submodule
  • Switch activity.info from class to exec

Memorize

  • Game not transferred when loading a created game <trac>10302</trac>

Etoys

  • added translation: hi, ta
  • update translations: de, mn, vi
  • use compressed sources file (EtoysV4.stc) To take up less space on machines with a non-compressing file system (i.e., about anything except XO-1, but in particular the XO-1.5) this version uses a compressed sources file (before: 18 MB, now: 4.5 MB).

Scratch

  • new camera plugin 0.8, fixes import from camera on XO-1 <trac>10413</trac>

Physics

  • Fix for cpu idling events when in background special case for Sugar 0.84.
  • Physics now idles when in the background to free up the cpu and save power.
  • Saves thumbnail image of simulation for details view in Journal.
  • Better behaviour when attempting to create minimum sized triangles, boxes, and circles (SL#1249).
  • Fixed new toolbars expanding separator from overflowing the Stop icons off the XO toolbar
  • Fixed the python/gtk/pygame int/float bug affecting F14 based builds (SL#2363).
  • Includes latest translations.
  • Switch activity.info from using the depreciated class, to exec.
  • Source code clean-up.
  • Added support for new toolbar design for Sugar 0.86 (old toolbars still work for Sugar 0.84 and back)
  • Objects can now be moved with the Grab tool while the simulation is paused!
  • Tool code cleanup and refactoring
  • Includes latest translations

Turtle Art

Bug Fixes:

  • Refactoring of audio/video code based on Jukebox (#1613)
  • Catch depreciated format during project load (#2501, #2447)
  • Reorganized some palettes (flow, portfolio) to fit smaller screen sizes
  • Map mouse coordinates to screen coordinates (#2502)
  • Also closed #2490, #2475, #2449, and #1057

Enhancements:

  • Sample Python code stored in individual files
  • New sample Python code (#548): (copy/paste heap to/from clipboard and to/from Journal)
  • Sensor calibration for XO 1.5 hardware (Tony Forster)
  • Text-only support for RTF files (#893)
  • Block at bottom of stack is hidden when stack is 'collapsed' (#2506)
  • Palette hides on repeat click of selector (#2505)
  • Elimination of redundant Hide Palette button (#2505)
  • Spanish translation of new blocks

Jukebox

  • Update of the translations