Release notes/11.3.1

NOTE: The contents of this page are not set in stone, and are subject to change! This page is a draft in active flux ... Please leave suggestions on the talk page.

Purpose

This is an update OLPC software release that fixes important bugs and improves support of the ARM platform for the upcoming XO-1.75 laptop. XO-1 and XO-1.5 are fully supported as usual.

New features

Sugar-0.94

TO DO

Activities

TO DO

XO-1.75 support

TO DO

Bug fixes

TO DO

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.

NOTE / TODO: This currently shows 11.3.0 builds. Will be updated once the release is out.

XO-1.75

How to install unsigned build 25 of release 11.3.1 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 os25.zd4, see How to Download,
  • Save the file to the top directory of the drive,
• Prepare the laptop:
  • Make a copy of any data you wish to keep,
  • Obtain a Developer key and disable security,
  • 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:
  • Obtain the Ok prompt,
  • Type the command: (If you are using an SD card, substitute sd:\ for u:\ below.)

fs-update u:\os25.zd4

Installation progress will be displayed. Green coulour will fill grey blocks. It will take about ten minutes. Once finished, the Ok prompt will return. You may remove the USB or SD drive. The laptop must be rebooted using the power button, not with the boot command. The USB or SD drive can be used on other laptops.

XO-1.5

How to install unsigned build NN of release 11.3.1 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 osNN.zd4, see How to Download,
  • Save the file to the top directory of the drive,

• Prepare the laptop:
  • Make a copy of any data you wish to keep,
  • Obtain a Developer key and disable security,
  • 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:
  • Obtain the Ok prompt,
  • Type the command: (If you are using an SD card, substitute sd:\ for u:\ below.)

fs-update u:\osNN.zd4

Installation progress will be displayed. Green colour will fill grey blocks. It will take about ten minutes. Once finished, the Ok prompt will return. You may remove the USB or SD drive. The laptop must be rebooted using the power button, not with the boot command.

The USB or SD drive can be used on other laptops.

Please report any Boot failed messages.

The above instructions assume that you are installing onto a 4 GB internal microSD card. For the 2 GB version, use the osNN.zd2 file, and for the 8 GB version, use the osNN.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 unsigned build NN of release 11.3.1 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 osNN.uim and osNN.onu, see How to Download,
  • Save the file to the top directory of the drive,
  • Download osNN.crc,
  • Save the file to the top directory of a USB or SD drive,
  • Check that the drive contains at least the two files osNN.img and osNN.crc

• Prepare the laptop:
  • Make a copy of any data you wish to keep,
  • Obtain a Developer key and disable security,
  • 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:
  • Obtain the Ok prompt,
  • Type the command: (If you are using an SD card, substitute sd:\ for u:\ below.)

update-nand u:\osNN.onu

Installation progress will be displayed. Green colour will fill yellow blocks. It will take about five minutes. Once finished, the Ok prompt will return. You may remove the USB or SD drive. The laptop may be rebooted.

The USB or SD drive can be used on other laptops.

Please report any Boot failed messages.

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,
  • for XO-1.75
    • os883.usb,
    • os883.toc,
  • for XO-1.5
    • os883.usb,
    • os883.toc,
  • for XO-1
    • os883.usb,
    • 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 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

TODO - update 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

TODO - update

• 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

TODO - update

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

TODO - update

• 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

TODO - update

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

TODO - 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

TODO - update

• 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

TODO - update

• The microphone recording level is believed to be too low in comparison to XO-1 (<trac>10903</trac>).

XO-1

TODO - update

• 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.