Release notes/11.3.0: Difference between revisions
DanielDrake (talk | contribs) No edit summary |
No edit summary |
||
(48 intermediate revisions by 14 users not shown) | |||
Line 1: | Line 1: | ||
{{outdated}} |
|||
EXTREMELY EARLY DRAFT |
|||
== Purpose == |
== Purpose == |
||
This new OLPC software release adds |
This new OLPC software release adds several new features and significant bug fixes. XO-1 and XO-1.5 are fully supported as usual. |
||
Additionally, this release adds support for the new [[XO-1.75]] laptop. For this laptop (in prototype stages at time of release, not yet available as a final model), this release acts as a verification of release processes and infrastructure, but does not represent the quality of software that will be shipped to deployments. Please see the [[#XO-1.75_3|XO-1.75 known issues section]] for further information on the areas that need work. OLPC plans to publish an incremental software release addressing these limitations before the XO-1.75 enters mass production. |
|||
Sugar collaboration has improved since the [[Release notes/11.2.0|11.2.0]] release, however [[#Sugar_collaboration|some issues]] are still present. OLPC will continue working on these issues for future releases. |
|||
== New features == |
== New features == |
||
Line 12: | Line 15: | ||
One notable change is that the <em>Keep</em> button has been removed from activities. Many users mistook this with <em>Save</em>, but actually Sugar saves all your work for you - you do not have to tell it do so. The now-removed Keep button's functionality could be better described as <em>duplicate</em>; those who used it with the intention of saving would actually end up with two copies of their work. |
One notable change is that the <em>Keep</em> button has been removed from activities. Many users mistook this with <em>Save</em>, but actually Sugar saves all your work for you - you do not have to tell it do so. The now-removed Keep button's functionality could be better described as <em>duplicate</em>; those who used it with the intention of saving would actually end up with two copies of their work. |
||
Another noticeable improvement is that the full-screen launching animation for activities has been optimised and is now much less resource hungry than before. In 11.2.0 on XO-1 you may have seen that this launching animation failed to appear or pulse at all; it now comes up without fail and pulses very smoothly, despite the underlying system being very busy loading the activity in question. |
|||
More information is available in the [http://wiki.sugarlabs.org/go/0.94/Notes Sugar 0.94 release notes]. |
More information is available in the [http://wiki.sugarlabs.org/go/0.94/Notes Sugar 0.94 release notes]. |
||
==== |
==== Activities ==== |
||
* Many activities were [http://wiki.sugarlabs.org/go/Design_Team/Toolbar_Catalog reviewed] by the Design Team to make the user interface more consistent. |
|||
The [http://wiki.sugarlabs.org/go/Activities/Portfolio Portfolio activity] has been added to the default set of activities shipped by OLPC. This activity automatically creates a slide show from Journal entries that have been 'starred'. |
|||
* The [http://wiki.sugarlabs.org/go/Activities/Portfolio Portfolio activity] has been added to the default set of activities shipped by OLPC. This activity automatically creates a slide show from Journal entries that have been 'starred'. |
|||
* Browse now supports tabs. |
|||
* Get Books was improved to provide easier access to book catalogues and classic books. |
|||
* Distance can now be used with different units, and new units of measure can be defined by the user. |
|||
=== XO-1.75 support === |
=== XO-1.75 support === |
||
Line 23: | Line 32: | ||
A great deal of engineering effort has gone into the production of the hardware and software of OLPC's new [[XO-1.75|XO-1.75 laptop]]. This new laptop model may look and feel the same as previous XOs, but represents a radical change internally: an [http://en.wikipedia.org/wiki/ARM_architecture ARM processor] is now used (similar to those found in common mobile phones and tablets). The processor is now included on the same chip as the rest of the core system functionality, taking the definition of [http://en.wikipedia.org/wiki/System-on-a-chip System-on-Chip] to a new level. |
A great deal of engineering effort has gone into the production of the hardware and software of OLPC's new [[XO-1.75|XO-1.75 laptop]]. This new laptop model may look and feel the same as previous XOs, but represents a radical change internally: an [http://en.wikipedia.org/wiki/ARM_architecture ARM processor] is now used (similar to those found in common mobile phones and tablets). The processor is now included on the same chip as the rest of the core system functionality, taking the definition of [http://en.wikipedia.org/wiki/System-on-a-chip System-on-Chip] to a new level. |
||
The XO-1.75 also adds accelerometer hardware, presenting many new opportunities for user interaction with the laptop. For example, see Bert Freudenberg's example of how [http://croquetweak.blogspot.com/2011/08/squeak-etoys-on-arm-based-xo-175.html tilting of the laptop can be used to control a ball's motion] in Etoys. |
The XO-1.75 also adds [[accelerometer]] hardware, presenting many new opportunities for user interaction with the laptop. For example, see Bert Freudenberg's example of how [http://croquetweak.blogspot.com/2011/08/squeak-etoys-on-arm-based-xo-175.html tilting of the laptop can be used to control a ball's motion] in Etoys. Other activities that take advantage of the accelerometer include [http://activities.sugarlabs.org/en-US/sugar/addon/4027 Turtle Blocks] and [http://activities.sugarlabs.org/en-US/sugar/addon/4488 Fraction Bounce], a game for exploring fractions. |
||
The XO-1.75 also adds [[Light_Sensor|light sensor]] hardware. |
|||
Many thanks to all OLPC, Sugar and Fedora community members who have helped with development and testing of this new laptop and its software. |
|||
=== Bug fixes === |
|||
A number of bugs were fixed during this development cycle. The more significant ones include: |
|||
* The neighborhood view correctly shows the name of the activity being shared (e.g. "Today's homework discussion") rather than only the name of the activity program (e.g. "Chat") (<trac>10676</trac>). |
|||
* The Ctrl+C and Ctrl+V Copy/Paste keyboard shortcuts were broken in Paint, TurtleArt and Terminal in 11.2.0. This has now been partially fixed (<trac>10930</trac>) but is still faulty in Turtle Art. |
|||
* The laptop will now inhibit its auto-suspend functionality while scanning for networks or establishing a connection to a network; this was causing connections to fail (<trac>10366</trac>). |
|||
* Pressing both mouse buttons at the same time now results in a "middle click" once again (<trac>5835</trac>). |
|||
* Developer tools such as <tt>screen</tt> and <tt>minicom</tt> no longer have problems starting after a reboot (<trac>11078</trac>). |
|||
* In 11.2.0, the the XO-1.5 keyboard was sometimes unresponsive upon boot into Open Firmware (only affecting developers who use the [[Ok]] prompt). This problem has now been solved (<trac>11021</trac>). |
|||
* XO-1 stateless mounts now take effect once again (<trac>11120</trac>). This fixes the efficient <em>pristine</em> olpc-update mode, and avoids an issue where SSH host keys are regenerated upon upgrade to the previous release (11.2.0). |
|||
* The mouse cursor on the Sugar "Name:" screen on 11.2.0 showed an incorrect mouse cursor (<trac>10712</trac>); this has been fixed. |
|||
* In previous releases, keyboard autorepeat (e.g. the holding of the 'a' which would produce 'aaaaaa' in this mode) was disabled, as it was deemed to be inappropriate for our userbase of first-time computer users. In 11.2.0, autorepeat was unintentionally enabled. It is now disabled again for 11.3.0 (<trac>11175</trac>). |
|||
* Collaboration: there have been several bug fixes to collaboration not only regression fixes: |
|||
** Do not cache the buddy palette in friends tray ([http://bugs.sugarlabs.org/ticket/3108 SL #3108]) |
|||
** FileTransfer: handle cancellation cleanly (<trac>11065</trac>) |
|||
** Invitations: remove item from tray after using the join/decline palette options ([http://bugs.sugarlabs.org/ticket/3089 SL #3089]) |
|||
** Joining shared activity: set title for activity palette in frame ([http://bugs.sugarlabs.org/ticket/3109 SL #3109]) |
|||
== Installation == |
|||
Installation is distinct from update. If you have user data on the laptop that you wish to preserve, you may want to follow the Update instructions, below. |
|||
=== XO-1.75 === |
|||
Note: Open Firmware Q4D05 is the last firmware version that supports 11.3.0 on XO-1.75, unless the olpc.fth file is modified to add ''false to use-fdt?'' before starting the kernel. |
|||
{{Software_Install2|path=http://download.laptop.org/xo-1.75/os/official/883|release=11.3.0|build=883|model=XO-1.75|signed=yes}} |
|||
=== XO-1.5 === |
|||
{{Software_Install2|path=http://download.laptop.org/xo-1.5/os/official/883|release=11.3.0|build=883|model=XO-1.5|signed=yes}} |
|||
=== XO-1 === |
|||
{{Software_Install2|path=http://download.laptop.org/xo-1/os/official/883|release=11.3.0|build=883|model=XO-1|signed=yes}} |
|||
== 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.) |
|||
=== 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 (in the Home view, erase them), |
|||
* [[Collections#Removing a collection|remove any large collections]] (library content) you no longer need, and; |
|||
* use [[Software update]] to ensure the Terminal activity is the latest available version. |
|||
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.75 ==== |
|||
sudo olpc-update official_xo1.75-883 |
|||
==== XO-1.5 ==== |
|||
sudo olpc-update official_xo1.5-883 |
|||
==== XO-1 ==== |
|||
sudo olpc-update 883 |
|||
See [[Olpc-update#Simple_online_update|Simple Online Update]] for more detail about the method. |
|||
=== Simple Offline Update === |
|||
*download a .usb and .toc file, see [[Download#How_to_Download|How to Download]], |
|||
**for XO-1.75 |
|||
***[http://download.laptop.org/xo-1.75/os/official/883/os883.usb os883.usb], |
|||
***[http://download.laptop.org/xo-1.75/os/official/883/os883.toc os883.toc], |
|||
**for XO-1.5 |
|||
***[http://download.laptop.org/xo-1.5/os/official/883/os883.usb os883.usb], |
|||
***[http://download.laptop.org/xo-1.5/os/official/883/os883.toc os883.toc], |
|||
**for XO-1 |
|||
***[http://download.laptop.org/xo-1/os/official/883/os883.usb os883.usb], |
|||
***[http://download.laptop.org/xo-1/os/official/883/os883.toc os883.toc], |
|||
*put them on a [[USB drive]], |
|||
*boot the laptop normally, |
|||
*plug the USB drive into the laptop, |
|||
*start the [[Terminal Activity]], and type: |
|||
sudo olpc-update --usb |
|||
See [[Olpc-update#Simple_offline_update|Simple Offline Update]] for more detail about the method. |
|||
=== After the Update === |
|||
* Sugar will attempt to update its Activities -- you should be online for the Activity Updater to complete. |
|||
== Known problems == |
|||
This section lists significant known issues that we hope to solve in future releases. |
|||
If deployments have solid plans and schedules to deploy 11.2.0 but feel blocked by some of these issues in particular, they are encouraged to get in contact with OLPC far in advance of the installation date. OLPC may be able to produce a limited scope point-release fixing highlighted issues. |
|||
=== Sugar === |
|||
* When pressing the volume hotkeys (F11/F12), the volume levels are changed accordingly, but the icon in the Sugar frame does not show the change - <trac>9913</trac>. |
|||
* The option to disable wireless networking in the Sugar Settings dialog no longer results in removal of power from the wifi hardware (<trac>10913</trac>) and does not disable XO-1 mesh functionality. |
|||
* Copying an item from an external device to the journal may result in the copied item incorrectly appearing at the bottom of the list of Journal items (instead of at the top), the item appear at the correct position after 5 seconds (<trac>10905</trac>). |
|||
* Browse no longer reports that it is running on an XO, which may affect the behaviour of certain sites which attempt to display an XO-optimized version (<trac>10921</trac>). The title of the webpage is not always displayed correctly (<trac>10751</trac>). Scrolling with the arrow keys and game keys does not work as expected (<trac>10514</trac>) and the activity will display pages with the wrong scaling settings if started when the screen is in a rotated mode (<trac>10566</trac>). |
|||
* Etoys sound recording may freeze or record low-quality audio (<trac>9724</trac>, <trac>9527</trac>). When collaborating, items may fail to be transferred (<trac>10744</trac>), and chat messages may fail to display the sender icon (<trac>10745</trac>). |
|||
* Record does not correctly pause itself when it is left running but is no longer the active activity. Multiple instances of Record will not always work correctly when run simultaneously (<trac>10659</trac>). |
|||
* The Moon activity fails to launch if the system date is wildly incorrect ([http://bugs.sugarlabs.org/ticket/3223 SL#3223]). |
|||
* When upgrading activities using the Software Update functionality, activity icons may be duplicated in the home screen until reboot (<trac>11373</trac>). |
|||
=== Sugar collaboration === |
|||
The following issues are all believed to be regressions over OLPC OS 10.1.3. |
|||
* When the initiator of a shared activity leaves the activity, the icon of the shared activity will disappear from the neighborhood view of other participants (<trac>10674</trac>). |
|||
* When collaborating over a jabber server, names of other users may be displayed as their account hashes (e.g. c72019147aed6de8731769a126c2931a8a9ecfeb) rather than their name (<trac>10750</trac>). |
|||
* If a user changes his name, the new name is not reliably communicated to his peers (<trac>10749</trac>). |
|||
* The friends tray in the Sugar frame is incorrect for the initiator of a shared activity; it will not show other users who have joined (<trac>10801</trac>) |
|||
* When collaborating over a jabber server, information regarding who has joined and left an activity is not displayed reliably (<trac>11075</trac>) |
|||
* If a user is invited to an activity but does not have that activity installed, a confusing grey circle is displayed where the invitation would normally be (<trac>10821</trac>). |
|||
* Upon accepting a private invitation via the frame, if the frame is left open during activity launch then the invitation will not disappear as it should (<trac>11073</trac>). |
|||
* The <tt>olpc-xos</tt> diagnostic tool for developers no longer shows the users connected to the jabber server (<trac>10677</trac>). |
|||
* When inviting another learner to an activity the frame does only show ourself, this is true for both members of the session <trac>11074</trac> |
|||
=== Input === |
|||
* F5 and F6 are bound to Search and Frame on all laptops, when these mappings should ideally only apply to XO High-School laptops where these icons are printed on the keys (<trac>10534</trac>) |
|||
* Some mousepads support tap to click. This has been intentionally disabled but the disabling is unreliable on AVC/Sentelic touchpads (<trac>11365</trac>). |
|||
=== Power management === |
|||
Automatic power management is enabled on XO-1.5 by default, and can be optionally enabled on XO-1 via the Sugar Settings dialog. When enabled, the following bugs are present: |
|||
* On XO-1, wireless network connectivity may disappear while the system is sleeping (<trac>10232</trac>) |
|||
* On XO-1, touchpad may seem slow to respond as the system wakes (<trac>10233</trac>) |
|||
* XO-1.5 may fail to be woken up by network traffic directed at it (<trac>9960</trac>) |
|||
* XO-1.5 wireless may fail and be automatically reset during system resume. This will cause a momentary interruption of connectivity, and could result in the XO-1.5 connecting to a different network after the reset. |
|||
* The laptop may only sleep for short periods of time due to being woken up by unrelated/uninteresting multicast network traffic. |
|||
* The mouse will occasionally be excessively jumpy for a few seconds after system wakeup, before it gets automatically recalibrated (<trac>10967</trac>). |
|||
* If put into a state where the system is suspended and cannot be woken up with the power button, typing on the keyboard while in suspended state may result in a misbehaving keyboard when the system resumes (<trac>11223</trac>). |
|||
=== OS update === |
|||
* After updating the system using [[olpc-update]], the following boot takes a bit longer than usual while some disk space is recovered. If Ctrl+Alt+F1 is pressed during this operation, the system will halt with an error message (<trac>11371</trac>). Power cycling the system will cause the process to continue from where it left off and boot successfully. |
|||
=== XO-1.75 === |
|||
* Sound does not work correctly in many activities (<trac>11296</trac>). |
|||
* There is no suspend/resume support yet. |
|||
* There is slight mouse cursor visual corruption in Sugar, and the mouse cursor in GNOME appears odd, but is otherwise functional. |
|||
* Screen rotation works, but video performance is noticably degraded in the rotated modes, and some activities misbehave after the screen has been rotated (<trac>11344</trac>). |
|||
* The mouse is sometimes unusable on boot (<trac>11363</trac>). |
|||
* Boot occasionally hangs at an early point in the startup animation (<trac>11357</trac>). |
|||
=== XO-1.5 === |
|||
* The microphone recording level is believed to be too low in comparison to XO-1 (<trac>10903</trac>). |
|||
=== XO-1 === |
|||
* The system may hang (in some cases intermittently, in some cases every time) when a USBVGA adapter is attached during boot (<trac>10568</trac>). |
|||
Many thanks to all Sugar and Fedora community members who have helped with development and testing of this new laptop and its software. |
|||
* Unfortunately, the base filesystem has grown in this release to the point where it is not possible to upgrade from a freshly-installed 10.1.3 OS to 11.2.0. This is due to temporary disk space requirements during the upgrade process. The [[#Preparation|update preparation]] steps are therefore essential, so that enough disk space is available. |
|||
[[Category:Release notes]] |
|||
known issues: |
|||
#11306 |
Latest revision as of 06:03, 30 November 2020
Purpose
This new OLPC software release adds several new features and significant bug fixes. XO-1 and XO-1.5 are fully supported as usual.
Additionally, this release adds support for the new XO-1.75 laptop. For this laptop (in prototype stages at time of release, not yet available as a final model), this release acts as a verification of release processes and infrastructure, but does not represent the quality of software that will be shipped to deployments. Please see the XO-1.75 known issues section for further information on the areas that need work. OLPC plans to publish an incremental software release addressing these limitations before the XO-1.75 enters mass production.
Sugar collaboration has improved since the 11.2.0 release, however some issues are still present. OLPC will continue working on these issues for future releases.
New features
Sugar-0.94
Sugar-0.94 is included in the release. This updated version includes various improvements such as more powerful View Source functionality, and easier file exchange between the Journal and the regular filesystem.
One notable change is that the Keep button has been removed from activities. Many users mistook this with Save, but actually Sugar saves all your work for you - you do not have to tell it do so. The now-removed Keep button's functionality could be better described as duplicate; those who used it with the intention of saving would actually end up with two copies of their work.
Another noticeable improvement is that the full-screen launching animation for activities has been optimised and is now much less resource hungry than before. In 11.2.0 on XO-1 you may have seen that this launching animation failed to appear or pulse at all; it now comes up without fail and pulses very smoothly, despite the underlying system being very busy loading the activity in question.
More information is available in the Sugar 0.94 release notes.
Activities
- Many activities were reviewed by the Design Team to make the user interface more consistent.
- The Portfolio activity has been added to the default set of activities shipped by OLPC. This activity automatically creates a slide show from Journal entries that have been 'starred'.
- Browse now supports tabs.
- Get Books was improved to provide easier access to book catalogues and classic books.
- Distance can now be used with different units, and new units of measure can be defined by the user.
XO-1.75 support
A great deal of engineering effort has gone into the production of the hardware and software of OLPC's new XO-1.75 laptop. This new laptop model may look and feel the same as previous XOs, but represents a radical change internally: an ARM processor is now used (similar to those found in common mobile phones and tablets). The processor is now included on the same chip as the rest of the core system functionality, taking the definition of System-on-Chip to a new level.
The XO-1.75 also adds accelerometer hardware, presenting many new opportunities for user interaction with the laptop. For example, see Bert Freudenberg's example of how tilting of the laptop can be used to control a ball's motion in Etoys. Other activities that take advantage of the accelerometer include Turtle Blocks and Fraction Bounce, a game for exploring fractions.
The XO-1.75 also adds light sensor hardware.
Many thanks to all OLPC, Sugar and Fedora community members who have helped with development and testing of this new laptop and its software.
Bug fixes
A number of bugs were fixed during this development cycle. The more significant ones include:
- The neighborhood view correctly shows the name of the activity being shared (e.g. "Today's homework discussion") rather than only the name of the activity program (e.g. "Chat") (<trac>10676</trac>).
- The Ctrl+C and Ctrl+V Copy/Paste keyboard shortcuts were broken in Paint, TurtleArt and Terminal in 11.2.0. This has now been partially fixed (<trac>10930</trac>) but is still faulty in Turtle Art.
- The laptop will now inhibit its auto-suspend functionality while scanning for networks or establishing a connection to a network; this was causing connections to fail (<trac>10366</trac>).
- Pressing both mouse buttons at the same time now results in a "middle click" once again (<trac>5835</trac>).
- Developer tools such as screen and minicom no longer have problems starting after a reboot (<trac>11078</trac>).
- In 11.2.0, the the XO-1.5 keyboard was sometimes unresponsive upon boot into Open Firmware (only affecting developers who use the Ok prompt). This problem has now been solved (<trac>11021</trac>).
- XO-1 stateless mounts now take effect once again (<trac>11120</trac>). This fixes the efficient pristine olpc-update mode, and avoids an issue where SSH host keys are regenerated upon upgrade to the previous release (11.2.0).
- The mouse cursor on the Sugar "Name:" screen on 11.2.0 showed an incorrect mouse cursor (<trac>10712</trac>); this has been fixed.
- In previous releases, keyboard autorepeat (e.g. the holding of the 'a' which would produce 'aaaaaa' in this mode) was disabled, as it was deemed to be inappropriate for our userbase of first-time computer users. In 11.2.0, autorepeat was unintentionally enabled. It is now disabled again for 11.3.0 (<trac>11175</trac>).
- Collaboration: there have been several bug fixes to collaboration not only regression fixes:
Installation
Installation is distinct from update. If you have user data on the laptop that you wish to preserve, you may want to follow the Update instructions, below.
XO-1.75
Note: Open Firmware Q4D05 is the last firmware version that supports 11.3.0 on XO-1.75, unless the olpc.fth file is modified to add false to use-fdt? before starting the kernel.
How to install signed build 883 of release 11.3.0 on XO-1.75.
The build is installed to the internal microSD device. You will need a USB drive or Secure Digital card 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 or SD drive:
- Download os883.zd4, see How to Download,
- Save the file to the top directory of the drive,
- Download os883.zd4.zsp.fs.zip,
- Save the file to the top directory of the same drive,
- Rename the file to fs.zip, (removing the os883.zd4.zsp part of the name),
- Check that the drive contains at least the two files fs.zip and os883.zd4.
- 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 above the power button,
- 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 five minutes. Once finished, the laptop will reboot automatically. You may remove the USB or SD drive during or after the reboot.
The USB or SD drive can be used on other laptops.
If you see a message Boot failed then either:
- the USB or SD drive has not been properly prepared, or;
- the firmware is out of date and should be updated (see Firmware).
The above instructions assume that you are installing onto a 4 GB internal eMMC. For the 8 GB version, use the os883.zd8 and os883.zd8.zsp.fs.zip files.
If you have many laptops of different sizes, check out How to avoid downloading multiple sizes of a build, which applies equally to XO-1.75.
XO-1.5
How to install signed build 883 of release 11.3.0 on XO-1.5.
The build is installed to the internal microSD device. You will need a USB drive or Secure Digital card 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 or SD drive:
- Download os883.zd4, see How to Download,
- Save the file to the top directory of the drive,
- Download os883.zd4.zsp.fs.zip,
- Save the file to the top directory of the same drive,
- Rename the file to fs.zip, (removing the os883.zd4.zsp part of the name),
- Check that the drive contains at least the two files fs.zip and os883.zd4.
- 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 above the power button,
- 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. You may remove the USB or SD drive during or after the reboot.
The USB or SD drive can be used on other laptops.
If you see a message Boot failed then either:
- the USB or SD drive has not been properly prepared, or;
- the firmware is out of date and should be updated (see Firmware).
The above instructions assume that you are installing onto a 4 GB internal microSD card. For the 2 GB version, use the os883.zd2 file, and for the 8 GB version, use the os883.zd8 file. The downloads are roughly the same size.
If you have laptops of different sizes, check out How to avoid downloading multiple sizes of a build for a set of XO-1.5 where the microSD or SD card size varies.
XO-1
How to install signed build 883 of release 11.3.0 on XO-1.
The build is installed to the internal NAND flash device. You will need a USB drive or Secure Digital card 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 or SD drive:
- Download os883.img, see How to Download,
- Save the file to the top directory of the drive,
- Download os883.img.fs.zip,
- Save the file to the top directory of the same drive,
- Rename the file to fs.zip, (removing the os883.img part of the name),
- Check that the drive contains at least the two files fs.zip and os883.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 above the power button,
- 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. You may remove the USB or SD drive during or after the reboot.
The USB or SD drive can be used on other laptops.
If you see a message Boot failed then either:
- the USB or SD drive has not been properly prepared, or;
- the firmware is out of date and should be updated (see Firmware).
There are no other build sizes for XO-1.
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.)
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 (in the Home view, erase them),
- remove any large collections (library content) you no longer need, and;
- use Software update to ensure the Terminal activity is the latest available version.
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.75
sudo olpc-update official_xo1.75-883
XO-1.5
sudo olpc-update official_xo1.5-883
XO-1
sudo olpc-update 883
See Simple Online Update for more detail about the method.
Simple Offline Update
- download a .usb and .toc file, see How to Download,
- put them on a USB drive,
- boot the laptop normally,
- plug the USB drive into the laptop,
- start the Terminal Activity, and type:
sudo olpc-update --usb
See Simple Offline Update for more detail about the method.
After the Update
- Sugar will attempt to update its Activities -- you should be online for the Activity Updater to complete.
Known problems
This section lists significant known issues that we hope to solve in future releases.
If deployments have solid plans and schedules to deploy 11.2.0 but feel blocked by some of these issues in particular, they are encouraged to get in contact with OLPC far in advance of the installation date. OLPC may be able to produce a limited scope point-release fixing highlighted issues.
Sugar
- When pressing the volume hotkeys (F11/F12), the volume levels are changed accordingly, but the icon in the Sugar frame does not show the change - <trac>9913</trac>.
- The option to disable wireless networking in the Sugar Settings dialog no longer results in removal of power from the wifi hardware (<trac>10913</trac>) and does not disable XO-1 mesh functionality.
- Copying an item from an external device to the journal may result in the copied item incorrectly appearing at the bottom of the list of Journal items (instead of at the top), the item appear at the correct position after 5 seconds (<trac>10905</trac>).
- Browse no longer reports that it is running on an XO, which may affect the behaviour of certain sites which attempt to display an XO-optimized version (<trac>10921</trac>). The title of the webpage is not always displayed correctly (<trac>10751</trac>). Scrolling with the arrow keys and game keys does not work as expected (<trac>10514</trac>) and the activity will display pages with the wrong scaling settings if started when the screen is in a rotated mode (<trac>10566</trac>).
- Etoys sound recording may freeze or record low-quality audio (<trac>9724</trac>, <trac>9527</trac>). When collaborating, items may fail to be transferred (<trac>10744</trac>), and chat messages may fail to display the sender icon (<trac>10745</trac>).
- Record does not correctly pause itself when it is left running but is no longer the active activity. Multiple instances of Record will not always work correctly when run simultaneously (<trac>10659</trac>).
- The Moon activity fails to launch if the system date is wildly incorrect (SL#3223).
- When upgrading activities using the Software Update functionality, activity icons may be duplicated in the home screen until reboot (<trac>11373</trac>).
Sugar collaboration
The following issues are all believed to be regressions over OLPC OS 10.1.3.
- When the initiator of a shared activity leaves the activity, the icon of the shared activity will disappear from the neighborhood view of other participants (<trac>10674</trac>).
- When collaborating over a jabber server, names of other users may be displayed as their account hashes (e.g. c72019147aed6de8731769a126c2931a8a9ecfeb) rather than their name (<trac>10750</trac>).
- If a user changes his name, the new name is not reliably communicated to his peers (<trac>10749</trac>).
- The friends tray in the Sugar frame is incorrect for the initiator of a shared activity; it will not show other users who have joined (<trac>10801</trac>)
- When collaborating over a jabber server, information regarding who has joined and left an activity is not displayed reliably (<trac>11075</trac>)
- If a user is invited to an activity but does not have that activity installed, a confusing grey circle is displayed where the invitation would normally be (<trac>10821</trac>).
- Upon accepting a private invitation via the frame, if the frame is left open during activity launch then the invitation will not disappear as it should (<trac>11073</trac>).
- The olpc-xos diagnostic tool for developers no longer shows the users connected to the jabber server (<trac>10677</trac>).
- When inviting another learner to an activity the frame does only show ourself, this is true for both members of the session <trac>11074</trac>
Input
- F5 and F6 are bound to Search and Frame on all laptops, when these mappings should ideally only apply to XO High-School laptops where these icons are printed on the keys (<trac>10534</trac>)
- Some mousepads support tap to click. This has been intentionally disabled but the disabling is unreliable on AVC/Sentelic touchpads (<trac>11365</trac>).
Power management
Automatic power management is enabled on XO-1.5 by default, and can be optionally enabled on XO-1 via the Sugar Settings dialog. When enabled, the following bugs are present:
- On XO-1, wireless network connectivity may disappear while the system is sleeping (<trac>10232</trac>)
- On XO-1, touchpad may seem slow to respond as the system wakes (<trac>10233</trac>)
- XO-1.5 may fail to be woken up by network traffic directed at it (<trac>9960</trac>)
- XO-1.5 wireless may fail and be automatically reset during system resume. This will cause a momentary interruption of connectivity, and could result in the XO-1.5 connecting to a different network after the reset.
- The laptop may only sleep for short periods of time due to being woken up by unrelated/uninteresting multicast network traffic.
- The mouse will occasionally be excessively jumpy for a few seconds after system wakeup, before it gets automatically recalibrated (<trac>10967</trac>).
- If put into a state where the system is suspended and cannot be woken up with the power button, typing on the keyboard while in suspended state may result in a misbehaving keyboard when the system resumes (<trac>11223</trac>).
OS update
- After updating the system using olpc-update, the following boot takes a bit longer than usual while some disk space is recovered. If Ctrl+Alt+F1 is pressed during this operation, the system will halt with an error message (<trac>11371</trac>). Power cycling the system will cause the process to continue from where it left off and boot successfully.
XO-1.75
- Sound does not work correctly in many activities (<trac>11296</trac>).
- There is no suspend/resume support yet.
- There is slight mouse cursor visual corruption in Sugar, and the mouse cursor in GNOME appears odd, but is otherwise functional.
- Screen rotation works, but video performance is noticably degraded in the rotated modes, and some activities misbehave after the screen has been rotated (<trac>11344</trac>).
- The mouse is sometimes unusable on boot (<trac>11363</trac>).
- Boot occasionally hangs at an early point in the startup animation (<trac>11357</trac>).
XO-1.5
- The microphone recording level is believed to be too low in comparison to XO-1 (<trac>10903</trac>).
XO-1
- The system may hang (in some cases intermittently, in some cases every time) when a USBVGA adapter is attached during boot (<trac>10568</trac>).
- Unfortunately, the base filesystem has grown in this release to the point where it is not possible to upgrade from a freshly-installed 10.1.3 OS to 11.2.0. This is due to temporary disk space requirements during the upgrade process. The update preparation steps are therefore essential, so that enough disk space is available.