Release notes/8.2.0: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
 
(123 intermediate revisions by 38 users not shown)
Line 1: Line 1:
{{Draft}}
{{outdated}}
{{OLPC}}
{{OLPC}}
{{Release Notes}}
{{Release Notes}}
Line 5: Line 5:
{{TOCright}}
{{TOCright}}


''Our apologies, but if you are using Browse in version 10.1.1 on XO-1.5 you may have been directed to this page by [http://dev.laptop.org/ticket/10243 mistake]. If so, please go to the [[Release_notes/10.1.1|10.1.1 release notes]]. The rest of this page relates to version 8.2.0.''
= Before you update to this release=

== Before you update to this release==
* If you are in a school or other deployment, make sure you contact your technical support team before updating. Some deployments have special configurations which will need special steps taken before update. Your deployment may not yet support this release.
* If you are in a school or other deployment, make sure you contact your technical support team before updating. Some deployments have special configurations which will need special steps taken before update. Your deployment may not yet support this release.


= New features in 8.2.0 =
== New features in 8.2.0 ==


There is a new Help Activity in this release that includes a full manual on the laptop. Look for the icon of a Question Mark.
See also the new XO manuals for details on new and existing features. <br>
http://en.flossmanuals.net/Sugar/ <br>
http://en.flossmanuals.net/XO/ <br>


In addition to fixing bugs, we've added lots of new features to our 8.2 release, including
In addition to fixing bugs, we've added lots of new features to our 8.2 release, including
* [[Release_Notes/8.2.0-detailed-version#GUI and usability improvements|GUI and usability improvements]]
* [[Feature_GUI and usability improvements|GUI and usability improvements]]
* [[Release_Notes/8.2.0-detailed-version#Automatic Software Updates|Automatic software updates]]
* [[Automatic software updates]]
* [[Release_Notes/8.2.0-detailed-version#Backup and restore to school server|Backup and restore]] to school server
* [[Feature_Backup and restore to school server|Backup and restore]] to school server
* [[Release_Notes/8.2.0-detailed-version#Longer battery life|Longer battery life]]
* [[Feature_Longer battery life|Longer battery life]]
* [[Feature_Keyboards and Languages_8.2|New Keyboards and Languages]]
* [[Release_Notes/8.2.0-detailed-version#Languages and keyboards|New Translations]]
* An update to [[#Fedora 9|Fedora 9]] for our base system
= Upgrading from previous releases =


The new XO manual for release 8.2.0 is available [http://www.laptop.org/manual/ here.]
Be sure to read and carefully follow these instructions before you begin the upgrade process, and allocate enough time to do the full process before you begin.


== Upgrading from previous releases ==
'''During pre-release development, you will need a [[developer key]] in order to install an 8.2 [[OS Images|OS image]]. This key should be copied in the /security directory BEFORE the upgrading process.'''


For technical details and other upgrade options see [[olpc-update]] and [[Clean-install procedure]]. If you run into trouble, see [[Upgrade troubleshooting]], [[Support FAQ]] and [[Support]] to email our tech support volunteers.
'''Important Note: Please check with your deployment technical contacts before upgrading. Countries using the XO may have custom configurations which may require special actions to be taken before new releases can be installed.'''


=== If your XO is connected to the internet ===
The process described below is to upgrade the XO while it is connected to Internet, for other ways to upgrade, see the [[Upgrading_the_XO#Overview_of_Upgrading_Options | Upgrading the XO]].


'''Note that this process may make some of your Activities and the Journal items that depend on them not work - make sure you have backed up any files you want to save!'''
Here are the steps to upgrade:
# Determine which version your XO is running.
# Plug the XO into AC Power
# Connect XO to the internet
# Launch the update command
# Update activities


This process can take more than 30 minutes, much longer if you have a slow internet connection.
== Step 1: Determine which version your XO is running ==
Follow these instructions to open a console window which shows you the current build (AKA release) which is running on your XO.

# Press ctrl+alt+F2 (the F2 key is the same as the Group key [[Image:Friends key f2 small.png]]. The Ctrl key has a solid diamond on it (♦); the Alt key has an open diamond on it (♢). See [[Keyboard Shortcuts]] for more details.)
# Read the build number from the first line of text that appears in the console window

Sample transcript:
OLPC build '''656''' (stream ship.2: variant devel_jffs2)
kernel 2.6.22-20070919.2.olpc.0987654321abcdefabcedf on an i586
xo-05-29-BB login:

The OS build number in the above example is '''656'''.

To return to the Sugar graphical display press ctrl+alt+F3 . (The F3 key is the same as the Home key ([[Image:Home key f3 small.png]]).)

== Step 2: Plug the XO into AC Power ==
Upgrading could be a long process. For this reason, ensure first that your XO is connected to reliable AC Power. Be sure to have enough time to do the full process (about 1 hour).

== Step 3: Connect XO to the internet ==
During the upgrade process, your XO will download the new release. So you should ensure that the XO is connected to the internet before launching the upgrade. See [http://laptop.org/laptop/start/connecting.shtml Connecting Guide] or [[Wifi Connectivity]] for instructions. Use Browse activity to test your connection.

== Step 4: Launch the update command ==
Open the '''[[Terminal Activity]]''' [[Image:Activity-terminal.svg|35px]] or a console and type the following (press the Enter key after each line):

If your XO is on build 650, 653, or 656:

su -
olpc-update ''{{:Friends in testing/current image}}''

If your XO is on build 703 or later:

sudo olpc-update ''{{:Friends in testing/current image}}'' <!-- reboot, verbose -->

If the update program successfully connects to the update server, some messages should display similar to this:


# Make sure your XO is plugged in, turned on, and [http://laptop.org/manual/XO_GiveMeTheInternet.html connected to the Internet] (you should be able to load http://laptop.org in the Browse Activity). If your XO is not connected to the internet, you will not be able to use this upgrade method.
# Open the Terminal Activity. [[Image:Activity-terminal.svg]] You can find it by going to the home view (press the 5th symbol from the left, top row), clicking on the little arrow at the bottom right of the screen, and then on the symbol that looks like this one.
# In the Terminal Activity, type <code>su -</code> (lowercase letter 's', lowercase letter 'u', a space, and a hyphen). Press Enter.
# At the <code>"-bash-3.2#"</code> prompt type <code>olpc-update 767</code>. Press Enter.
# You should see text that looks something like this (sometimes, in addition to the text below, you might get a message about irsync_pristine failing, and that "irsync_dirty" is being tried, this is normal):
<pre>
Downloading contents of build ''{{:Friends in testing/current image}}''
Downloading contents of build ''{{:Friends in testing/current image}}''
Updating to version hash ''xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx''
Updating to version hash ''xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx''
Line 79: Line 45:
- Cleaning tree.
- Cleaning tree.
- Fetching contents.
- Fetching contents.
- Performing incremental rsync.
- Performing incremental rsync. [Comment: Wait a long time! Could be over an hour depending on your internet connection speed.]
Verifying update.
Verifying update.
Installing update in /versions/{pristine,run}/''xxxx''
Installing update in /versions/{pristine,run}/''xxxx''
</pre>
6. At the end of the upgrade, you will either see the words "Installing update in...." or "Update Succeeded!" on the screen. If you see the words "I don't think you're connected to the internet." see the notes below. <br>
<br>
7. Wait for the prompt <code>"-bash-3.2#"</code> and type <code>reboot</code> then press Enter to restart your XO. You will probably hear the little XO tune 2 times, then it will say erasing and a countdown will appear. Finally it will reboot again, you will hear the tune for a third time. Now you are ready to go to step 8.<br>
<br>
8. After your XO reboots, the last step is to download the new versions of Activities. When the XO boots you will see a bar toward the top of the screen that says "Software Update" and the options being "Cancel", "Later" and "Check now". Before you choose "Check now" to update the activities, you must reconnect your XO to the internet. You may see the sign-in box appear in home view. If it does, and it lists your router, you can do it from there. If it doesn't appear or offers the wrong connection, go to the Neighborhood view and connect from there. Then go back to Home view and then click "Check now" (it's ok to leave the home view because when you go back the options should still be there). First the XO will check for any updates and then it asks if you'd like to install them. Click "Install selected" to install your newest versions of your activities. <br>


Congratulations, you've upgraded!
This process may take more than thirty minutes. When the process is complete, you need to [[reboot]].


'''Note:'''
'''Important Note: On the first reboot after upgrading, the XO will run slowly for about 1 minute. After that it will run normally.'''
* When upgrading from build 703 or 708 you will not see the Library (links to science, books, etc links on the left side) in the Browse home page. You can re-install the Library as follows:
** Open the Control Panel and go into Software update.
** After it checks for updates, go to <code>"Modify activity groups"</code> and click on the triangle.
** Beside <code>"Group URL"</code> type: <code> http://wiki.laptop.org/go/Activities/G1G1 </code> and click the <code>"Add"</code> button.
** Click <code>"Refresh"</code> and allow the XO to upload the new updates.
** Click on Install selected. Once it completes, reboot.
* If you can browse the Internet (see step 1 above) but the <tt>olpc-update</tt> command returns the error <code>"I don't think you're connected to the internet."</code>, you may need to open TCP port 873 (rsync) on your firewall for the outbound connection.


=== Offline upgrade ===
== Step 5: Update activities ==
[[Image:YamaDone.JPG|thumb|''for new users'' [[USB_upgrade|<br>'''illustrated guide to upgrading using a USB stick<br>''']]]]
You can use another computer that is connected to the internet (a desktop at home, a computer lab, etc.) plus a USB storage device (such as a compatible [[USB_drive#USB_drives_and_firmware|USB flash drive]]) to upgrade your XO.
The way it works is on your non-XO computer you download two files containing the upgrade data, saving them to the USB flash drive; then you insert the USB flash drive into your XO and trigger its upgrade process.
'''Note that this process will COMPLETELY erase ALL files on your XO! Make sure you have backed up any files you want to save!'''


Plug an empty formatted USB flash drive into the computer that is connected to the internet.
On rebooting the first time after updating to release 8.2, the XO will notify you that your activities should be updated.
Then, right-click (Ctrl-click for Mac) on each of the two URLs below and choose "Save Target As" ("Save Link As" for Firefox). Save both files to the USB flash drive. Do not open the files.


* http://download.laptop.org/xo-1/custom/g1g1/gg-767-4/fs.zip (This file contains only instructions for the firmware to update with the following file.)
[[Image:820_firstactivityinstall.png|thumb|G1G1 Activity install]]
* http://download.laptop.org/xo-1/custom/g1g1/gg-767-4/gg-767-4.img (This file contains the Sugar platform with the G1G1 2008 set of Activities.)
[[Image:820 updateproposal.png|thumb|Activities update proposal]]


The first file is about 297 KB, and the second file is quite large (about 450 MB), so they might take a while [15 - 20 min.] to download. When the download is complete, Eject/Remove the USB flash drive, and unplug it. After you have finished this step, there should be two files on the USB flash drive, the <tt>fs.zip file</tt>, and the <tt>.img</tt> file. The MD5 checksum for fs.zip is 1bb452e77b7390e00bdd7fdcc7cbc793 The MD5 checksum for gg-767-4.img is 3f281dda352d32320879728377b32476
If you are connected to the Internet, click "OK" to update your activities. If it is not connected to the Internet, click "Cancel". Connect to the Internet and then open the Software Updater from the Control Panel.


Now, follow the steps below to complete your installation:
When the Software Update starts you will see a progress bar as your XO looks for updated versions of the activities you have installed. When it is done, choose the activities you want update and click "Install selected". You will see another progress bar, as the activities are updated.


# Turn off your XO and connect your USB flash drive to it.
Some activities may not successfully update, due to errors in the activity files or due to transient network errors. In this case, some activities will remain in the "available updates" list after the installation process has completed. If a network error was the cause, you may wish to immediately retry the installation; otherwise, you probably need to wait until the activity author uploads a corrected version of their bundle.
# Make sure your XO is plugged in.
# Hold down all four gamepad keys (on the right side of the screen, above the power button). While still holding the four gamepad keys, push the power button to turn the XO on. Keep holding down the four gamepad keys until the message "Release the game key to continue" appears on the screen.
# Release the gamepad keys. If you see a grid of colored boxes on your screen, congratulations! Your XO is reflashing. It will take about 10 minutes and your XO will automatically reboot when it is done. Your XO may reboot twice, playing the little XO tune.
# After your XO reboots, the last step is to update to the newest versions of Activities. When the XO boots you will see a bar toward the top of the screen that says "Software Update" and the options being "Cancel", "Later" and "Check now". Before you choose "Check now" to update the activities, you must reconnect your XO to the internet. You may see the sign-in box appear in home view. If it does, and it lists your router, you can do it from there. If it doesn't appear or offers the wrong connection, go to the Neighborhood view and connect from there. Then go back to Home view and then click "Check now" (it's ok to leave the home view because when you go back the options should still be there). First the XO will check for any updates and then it asks if you'd like to install them. Click "Install selected" to install the newest versions of your activities. <br>
Congratulations, you've upgraded!
Now, you should be ready to go. Have fun!


(If you chose "Later" on the software update, go to the Sugar Control Panel and select the "Software update" when you are ready to install the updates)
= Resolved Bugs In This Release =

A few important ones include:<br>
== Resolved bugs in this release ==
Many bugs were closed in this release. A few important ones include:<br>
<trac>5156</trac> Browse can view Google calendar.
<trac>5156</trac> Browse can view Google calendar.


<trac>5613</trac> The XO name can now accept any characters. This is important for languages which do not use the ASCII characters.
<trac>5613</trac> The XO name can now accept any characters. This is important for languages which do not use the ASCII characters.


<trac>6014</trac> Activities try to save their data when the XO is shut down while an activity is open. This is better but not complete. Users should close their activities before shutting down the XO.
<trac>5987</trac> Flash (using the open source Gnash implementation) plays better than previous releases.

<trac>6014</trac> Activities try to save their data when the XO is shut down while an activity is open. This is better but not complete. Users should close their activities before before shutting down the XO.

<trac>6036</trac> When leaving and restarting Chat, a line showing time passed since previous Chat's is added. This makes it easier to see which messages are current.

<trac>7382</trac> Browse now does autocomplete.


<trac>7480</trac> You can reset your network history in the Network control panel in case you need to remove old configurations. However, you will need to re-enter all AP passwords after doing this.
<trac>7480</trac> You can reset your network history in the Network control panel in case you need to remove old configurations. However, you will need to re-enter all AP passwords after doing this.


For a list of all closed bugs in this release click [http://dev.laptop.org/report/22 here]. <br>
<trac>8554</trac> Two parenthesis images now appear around an Access Point (AP) icon in the Neighborhood View to indicate which AP the XO is currently using.


== Notable open bugs in this release ==<nowiki><nowiki>Insert non-formatted text here</nowiki></nowiki>
All bugs which have been closed and included in 8.2 are listed here: <br>
http://dev.laptop.org/report/22

= Notable Open Bugs In This Release =


For the best experience and maximum reliability with the XO we recommend the following best practices:
For the best experience and maximum reliability with the XO we recommend the following best practices:


'''For all XOs'''
'''For all XOs'''
* If you open too many activities (generally more than 3) at once you may experience slow response. Use the frame button (upper right); hover over the open activities; and click on close.
* If you open too many activities (generally more than 3) at once you may experience slow response. To close activities, use the frame button (upper right), hover over the open activities, and click on close.
* In general, you do not need to double click on anything in the XO interface. Its designed for a single click. For example, double clicking to launch an activity will cause the XO to launch two instances of the activity which may cause one to fail.
* In general, you do not need to double click on anything in the XO interface. It is designed for a single click. For example, double clicking to launch an activity will cause the XO to launch two instances of the activity which may cause one to fail.
* Drag and drop has limited support in this release. It may in work in some cases but it does not work consistently everywhere.
* Drag and drop has limited support in this release. It may work in some cases but it does not work consistently everywhere.
* Power save mode is still development. In this release it is turned off by default. If you experience problems with it, please turn it back off.
* Power save mode is still in development. In this release it is turned off by default in the control panel. If you use it and experience problems, please turn it off.
* If the XO stops collaborating or stops responding, you can reboot it from the home screen (hover over the XO in the center) or hold down the power button for more than 6 seconds.
* If the XO stops collaborating or stops responding, you can reboot it from the home screen (hover over the XO in the center) or hold down the power button for more than 6 seconds.
* For maximum safety when using USB sticks, you should shut down the XO before removing the USB stick.
* Ensure that you have unmounted a USB stick before removing it. Go to the Journal, hover over the USB stick icon and click on 'unmount'. Another method to remove a USB stick and avoid corruption is to power down the laptop before removing the USB stick..


'''For XOs used in school with many XOs present
'''For XOs used in school with many XOs present
* For users in a school, the collaboration may become unstable after more than a few hours of continuous usage. If there are a lot of XOs collaborating you may not see all the other XOs in the Mesh view. Restarting the XOs and the collaboration may help.
* Reliable collaboration using the Write activity over mesh or access point networks may not exceed two hours. If there are a lot of XOs or a lot of wireless traffic (e.g. many XOs or many access points) then Write may shut down during collaboration. In this case you may be able to reconnect Write to the collaboration in the Neighborhood view.
* When collaborating over a Mesh (i.e. XO to XO collaboration with no access point or school server) you should limit the number of XOs on any channel to 10. There are three Mesh channels available (1,6 and 11) and each should have a maximum of 10 XOs. More XOs in a channel may cause instability in the collaboration.
* Please see the [[Deployment_Support]] pages for information on collaboration and connectivity in schools or areas that are densely populated with XOs.


* Please see the [[Deployment Support]] pages for information on collaboration and connectivity in schools or areas that are densely populated with XOs.

''' Click [[OpenBugs_8.2.0|here]] for a more detailed list of open bugs'''

{{Developers}}

== API Changes ==

Release 8.2.0 incorporates version 0.82.1 of the Sugar UI.


[[API changes]] documents Sugar and system API changes since release 8.1.x.
''' Click [[Release_Notes/8.2.0-detailed-version#Notable Open Bugs In This Release|here]] for a more detailed list of open bugs'''

Latest revision as of 07:36, 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

Our apologies, but if you are using Browse in version 10.1.1 on XO-1.5 you may have been directed to this page by mistake. If so, please go to the 10.1.1 release notes. The rest of this page relates to version 8.2.0.

Before you update to this release

  • If you are in a school or other deployment, make sure you contact your technical support team before updating. Some deployments have special configurations which will need special steps taken before update. Your deployment may not yet support this release.

New features in 8.2.0

There is a new Help Activity in this release that includes a full manual on the laptop. Look for the icon of a Question Mark.

In addition to fixing bugs, we've added lots of new features to our 8.2 release, including

The new XO manual for release 8.2.0 is available here.

Upgrading from previous releases

For technical details and other upgrade options see olpc-update and Clean-install procedure. If you run into trouble, see Upgrade troubleshooting, Support FAQ and Support to email our tech support volunteers.

If your XO is connected to the internet

Note that this process may make some of your Activities and the Journal items that depend on them not work - make sure you have backed up any files you want to save!

This process can take more than 30 minutes, much longer if you have a slow internet connection.

  1. Make sure your XO is plugged in, turned on, and connected to the Internet (you should be able to load http://laptop.org in the Browse Activity). If your XO is not connected to the internet, you will not be able to use this upgrade method.
  2. Open the Terminal Activity. Activity-terminal.svg You can find it by going to the home view (press the 5th symbol from the left, top row), clicking on the little arrow at the bottom right of the screen, and then on the symbol that looks like this one.
  3. In the Terminal Activity, type su - (lowercase letter 's', lowercase letter 'u', a space, and a hyphen). Press Enter.
  4. At the "-bash-3.2#" prompt type olpc-update 767. Press Enter.
  5. You should see text that looks something like this (sometimes, in addition to the text below, you might get a message about irsync_pristine failing, and that "irsync_dirty" is being tried, this is normal):
 Downloading contents of build ''{{:Friends in testing/current image}}''
 Updating to version hash ''xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx''
 Making clean /versions/updates/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 Trying irsync_pristine update from rsync://updates.laptop.org/''build-{{:Friends in testing/current image}}''
 - Cleaning tree.
 - Fetching contents.
 - Performing incremental rsync. [Comment: Wait a long time! Could be over an hour depending on your internet connection speed.]
 Verifying update.
 Installing update in /versions/{pristine,run}/''xxxx''

6. At the end of the upgrade, you will either see the words "Installing update in...." or "Update Succeeded!" on the screen. If you see the words "I don't think you're connected to the internet." see the notes below.

7. Wait for the prompt "-bash-3.2#" and type reboot then press Enter to restart your XO. You will probably hear the little XO tune 2 times, then it will say erasing and a countdown will appear. Finally it will reboot again, you will hear the tune for a third time. Now you are ready to go to step 8.

8. After your XO reboots, the last step is to download the new versions of Activities. When the XO boots you will see a bar toward the top of the screen that says "Software Update" and the options being "Cancel", "Later" and "Check now". Before you choose "Check now" to update the activities, you must reconnect your XO to the internet. You may see the sign-in box appear in home view. If it does, and it lists your router, you can do it from there. If it doesn't appear or offers the wrong connection, go to the Neighborhood view and connect from there. Then go back to Home view and then click "Check now" (it's ok to leave the home view because when you go back the options should still be there). First the XO will check for any updates and then it asks if you'd like to install them. Click "Install selected" to install your newest versions of your activities.

Congratulations, you've upgraded!

Note:

  • When upgrading from build 703 or 708 you will not see the Library (links to science, books, etc links on the left side) in the Browse home page. You can re-install the Library as follows:
    • Open the Control Panel and go into Software update.
    • After it checks for updates, go to "Modify activity groups" and click on the triangle.
    • Beside "Group URL" type: http://wiki.laptop.org/go/Activities/G1G1 and click the "Add" button.
    • Click "Refresh" and allow the XO to upload the new updates.
    • Click on Install selected. Once it completes, reboot.
  • If you can browse the Internet (see step 1 above) but the olpc-update command returns the error "I don't think you're connected to the internet.", you may need to open TCP port 873 (rsync) on your firewall for the outbound connection.

Offline upgrade

You can use another computer that is connected to the internet (a desktop at home, a computer lab, etc.) plus a USB storage device (such as a compatible USB flash drive) to upgrade your XO. The way it works is on your non-XO computer you download two files containing the upgrade data, saving them to the USB flash drive; then you insert the USB flash drive into your XO and trigger its upgrade process. Note that this process will COMPLETELY erase ALL files on your XO! Make sure you have backed up any files you want to save!

Plug an empty formatted USB flash drive into the computer that is connected to the internet. Then, right-click (Ctrl-click for Mac) on each of the two URLs below and choose "Save Target As" ("Save Link As" for Firefox). Save both files to the USB flash drive. Do not open the files.

The first file is about 297 KB, and the second file is quite large (about 450 MB), so they might take a while [15 - 20 min.] to download. When the download is complete, Eject/Remove the USB flash drive, and unplug it. After you have finished this step, there should be two files on the USB flash drive, the fs.zip file, and the .img file. The MD5 checksum for fs.zip is 1bb452e77b7390e00bdd7fdcc7cbc793 The MD5 checksum for gg-767-4.img is 3f281dda352d32320879728377b32476

Now, follow the steps below to complete your installation:

  1. Turn off your XO and connect your USB flash drive to it.
  2. Make sure your XO is plugged in.
  3. Hold down all four gamepad keys (on the right side of the screen, above the power button). While still holding the four gamepad keys, push the power button to turn the XO on. Keep holding down the four gamepad keys until the message "Release the game key to continue" appears on the screen.
  4. Release the gamepad keys. If you see a grid of colored boxes on your screen, congratulations! Your XO is reflashing. It will take about 10 minutes and your XO will automatically reboot when it is done. Your XO may reboot twice, playing the little XO tune.
  5. After your XO reboots, the last step is to update to the newest versions of Activities. When the XO boots you will see a bar toward the top of the screen that says "Software Update" and the options being "Cancel", "Later" and "Check now". Before you choose "Check now" to update the activities, you must reconnect your XO to the internet. You may see the sign-in box appear in home view. If it does, and it lists your router, you can do it from there. If it doesn't appear or offers the wrong connection, go to the Neighborhood view and connect from there. Then go back to Home view and then click "Check now" (it's ok to leave the home view because when you go back the options should still be there). First the XO will check for any updates and then it asks if you'd like to install them. Click "Install selected" to install the newest versions of your activities.

Congratulations, you've upgraded! Now, you should be ready to go. Have fun!

(If you chose "Later" on the software update, go to the Sugar Control Panel and select the "Software update" when you are ready to install the updates)

Resolved bugs in this release

Many bugs were closed in this release. A few important ones include:
<trac>5156</trac> Browse can view Google calendar.

<trac>5613</trac> The XO name can now accept any characters. This is important for languages which do not use the ASCII characters.

<trac>6014</trac> Activities try to save their data when the XO is shut down while an activity is open. This is better but not complete. Users should close their activities before shutting down the XO.

<trac>7480</trac> You can reset your network history in the Network control panel in case you need to remove old configurations. However, you will need to re-enter all AP passwords after doing this.

For a list of all closed bugs in this release click here.

== Notable open bugs in this release ==<nowiki>Insert non-formatted text here</nowiki>

For the best experience and maximum reliability with the XO we recommend the following best practices:

For all XOs

  • If you open too many activities (generally more than 3) at once you may experience slow response. To close activities, use the frame button (upper right), hover over the open activities, and click on close.
  • In general, you do not need to double click on anything in the XO interface. It is designed for a single click. For example, double clicking to launch an activity will cause the XO to launch two instances of the activity which may cause one to fail.
  • Drag and drop has limited support in this release. It may work in some cases but it does not work consistently everywhere.
  • Power save mode is still in development. In this release it is turned off by default in the control panel. If you use it and experience problems, please turn it off.
  • If the XO stops collaborating or stops responding, you can reboot it from the home screen (hover over the XO in the center) or hold down the power button for more than 6 seconds.
  • Ensure that you have unmounted a USB stick before removing it. Go to the Journal, hover over the USB stick icon and click on 'unmount'. Another method to remove a USB stick and avoid corruption is to power down the laptop before removing the USB stick..

For XOs used in school with many XOs present

  • Reliable collaboration using the Write activity over mesh or access point networks may not exceed two hours. If there are a lot of XOs or a lot of wireless traffic (e.g. many XOs or many access points) then Write may shut down during collaboration. In this case you may be able to reconnect Write to the collaboration in the Neighborhood view.
  • When collaborating over a Mesh (i.e. XO to XO collaboration with no access point or school server) you should limit the number of XOs on any channel to 10. There are three Mesh channels available (1,6 and 11) and each should have a maximum of 10 XOs. More XOs in a channel may cause instability in the collaboration.


  • Please see the Deployment Support pages for information on collaboration and connectivity in schools or areas that are densely populated with XOs.

Click here for a more detailed list of open bugs


API Changes

Release 8.2.0 incorporates version 0.82.1 of the Sugar UI.

API changes documents Sugar and system API changes since release 8.1.x.