Release notes/8.1.0: Difference between revisions

From OLPC
Jump to navigation Jump to search
(→‎Improvements from official-656: there is no "official" prefix for builds.)
No edit summary
 
(76 intermediate revisions by 30 users not shown)
Line 1: Line 1:
{{outdated}}
{{OLPC}}
{{OLPC}}
{{Latest Releases | rc = inline | firmware = inline | extra = inline }}
{{Release Notes}}
{{Release Notes}}
{{TOCright}}
{{TOCright}}
{{Users}}
{{Users}}
<center>''for other discussion, see [[Update.1]]''</center>
<span style="font-weight: bold; font-color: red; font-size: 24pt; line-height: 120%;">SD cards [http://dev.laptop.org/ticket/6532 may be corrupted] by builds 703-709. Do not use SD cards with the XO with builds in this range.</span>
== What's new in the official-703 (8.1.0) release? ==


# Fix bugs
# Laptops now suspend when closed & resume when opened, for better battery life
# Each activity runs isolated from the others, for better security
# Sugar activities are now released separately, or in "Activity Packs", rather than as part of the operating system release.


Please also refer to the [http://dev.laptop.org/milestone/Update.1 milestone] and the [http://dev.laptop.org/roadmap official roadmap] for schedule dates and features for each release.


''2008-06-06'': Given successful completion of the [[OLPC_SW-ECO_4_Checklist|Release Checklist]], we have released build official-703 as our Update.1 (8.1.0) release build.
<span style="font-weight: bold; font-size: 36pt">DRAFT</span>


= Breaking Changes from official-656 =
<span style="font-weight: bold; font-color: red; font-size: 24pt; line-height: 120%;">Activities must be [[#Finding Activities|installed separately]].</span>


Motivation: OLPC cannot presently afford to maintain more than one stable build. Therefore, we have decided to provide a "blank slate" which must be [[Customization key|customized]] with activities and content bundles at installation time.


It's worth mentioning "missing activities" here because it's a term that people might search for.


= What's the recommended way to upgrade? =
Pending successful completion of the [[OLPC_SW-ECO_4_Checklist|Release Checklist]], we will release build candidate-703 as official-703.
# Download the [[G1G1 Activity Pack]] (from [http://wiki.laptop.org/images/6/62/G1G1_Activity_Pack_1.zip here]) and [[unzip]] it in the base (root) directory of a USB flash drive. You should see two directories (boot and bundles, and a file called customization-2) in the base directory. Commands such as "extract here" in ubuntu / windows will sometimes create a directory with the same name as the zip file, placing the unzipped files within it. If this happens, you will have to move the files to the base directory in order for your XO to see them on boot. (Note that the "boot" directory will contain two zip files, actos.zip and runos.zip. This is normal; these files do not need to be unzipped).<!--I hope this is correct. Dave Wallace said it was, and the update worked, so I think it is.--dpbsmith--->
# Plug the XO into an electrical outlet and connect it to the internet.
# Run [[olpc-update]] to the new build. (In a [[Terminal Activity|terminal]], enter <tt>[[su -l]]</tt> (lowercase L, not 1) and then <tt>olpc-update 703</tt> ) This may take half an hour or more, depending on your internet connection.
# Insert the USB flash drive and reboot the XO. It will display text on a black screen as the activities are installed, after which it will power off.
# Remove the USB flash drive. Connect the XO to AC power, so that it will be able to proceed if it determines that a firmware update is needed.<!--I hope this is correct. In my case, I didn't have it connected to power, and when powered on it complained about not being connected to power and then shut down. I'm making the assumption that there's no harm in being connected to AC power and that therefore this is safe advice. --dpbsmith---> Then power on your XO as per usual.


If you are upgrading from build 69''X'', the build is already separated from the activities in those builds.
== Breaking Changes from official-656 ==
So you can run <tt>olpc-update 703</tt> and your activities will not be affected.


(I couldn't get the USB flash method to work - some mention about holding down the gamepad X if locked firmware? Wrong filesystem on USB? - but Bert's Script method immediately below worked wonderfully. I think that is the better way, anyways!)


= Finding Activities =
<span style="font-weight: bold; font-color: red; font-size: 24pt; line-height: 120%;">Activities must be [[#Finding Activities|installed separately]].</span>
OLPC hosts many [[Activities]]. These activities can be installed in en masse onto build 703 with either:


* A [[Customization key|customization key]] and an [[Activity pack|activity pack]] or
Motivation: OLPC cannot presently afford to maintain more than one stable build. Therefore, we have decided to provide a "blank slate" which must be [[Customization key|customized]] with activities and content bundles at installation time. (Some people have asked OLPC to provide a single step upgrade/customization path but no resources have been allocated to this task).
* With [[Bert's script]]


Some commonly installed activity packs include the:


* [[G1G1 activity pack]] ([[Media:G1G1 Activity Pack 1.zip|download]])
=== Finding Activities ===

OLPC hosts many [[Activities]] and several [[:Category:Activity_Pack|activity packs]] including:

* [[G1G1 Activity Pack]] or [[G1G1 activity pack]].
* [[Peru activity pack]]
* [[Peru activity pack]]
* [[Nepal:_Testing%2C_QA%2C_and_Configuration#Nepal_Activity_Pack|Nepal activity pack]]
* Here is a [[Nepal_Customization_702|list of the customizations]] [[OLE Nepal]] has made as of March 27th for build 702.
* [[:Category:Activity Pack|...more activity packs]]


(The Nepal activity pack contains some [[Nepal_Customization_702|additional customizations]] made by [[OLE Nepal]] for their pilot).
To use an activity pack:


'''TO INSTALL AN ACTIVITY PACK:'''
# Download it.
{{:Installing an activity pack}}
# Unzip it onto the root of a USB key.
# Insert the USB key into your XO and reboot. (Hold the X game key while booting if your machine's firmware is unlocked.)


= Improvements from build 656 =
Linux will boot and unpack each of the bundles into place.
See [[OLPC_SW-ECO_4]] for a more precise list of the changes, indexed by ticket, that lead from candidate-699 to [http://download.laptop.org/xo-1/os/official/703/jffs2/ official-703]. To summarize, we added:


* Open Firmware version Q2D14 which will delay firmware updates until power is available (easing mass laptop updates).
* Another future option for installing 'activity pack' bundles, from console use [[xo-get]].





=== What's the recommended way to upgrade? ===

The recommended method is to run [[Olpc-update]] to the new build, and then to reboot with a [[G1G1 Activity Pack]] key inserted.

If you are upgrading from 69x (the build is already separated from the activities), you can use 'olpc-update candidate-703' and your activities will not be affected.

== Improvements from build 656 ==

See [[OLPC_SW-ECO_4]] for a more precise list of the changes, indexed by ticket, that lead from candidate-699 to [http://download.laptop.org/xo-1/os/candidate/703/jffs2/ candidate-703]. To summarize, we added:

* OFW version Q2D14 which will delay firmware updates until power is available.
* Newer library indexing software which fixes a recently introduced typo.
* Better Spanish localization of the library and of the X and console keymaps.
* Better Spanish localization of the library and of the X and console keymaps.
* The ability to customize installed activities, boot screens, and activity order via USB key.
* A new telepathy-salut which should lead to more reliable long-running Chat sessions and that may avoid the "Christmas tree" effect ([http://dev.laptop.org/ticket/5501]).
* [[Rainbow]] prevents faulty activities from damaging many parts of the system configuration.
* A new libabiword that fixes a Write sharing crasher.
* [[OHM power management]] software can be manually enabled to provide better battery life in solo-use situations.
* The XO announces its build identifier under the "About this XO" palette entry available from the central XO Icon on the Home View.
* Miscellaneous stability improvements including a new libabiword that fixes a Write sharing crasher.


== Notable Current Bugs ==
= Notable Current Bugs =
* {{Ticket|6532}} SD Card Corruption: partition table gets corrupted on ext3-formatted SD cards on suspend/resume
* {{Ticket|7158}} Upgrade from 656 to 703 leaves su unusable when you fallback to 656. This bug will only affect you if you upgrade to 8.1.0 and then "revert" to 656 by holding down the "O" game key on boot up. If you "clean install" 8.1.0 or revert to 656 by a "clean install" of that, you will not encounter this bug.
* The contents of a USB key didn't show in the journal. So couldn't install activity bundles from the USB through the journal.


* #6777 Library bundles cannot use non-ascii characters in their file names


== Customization Issues ==
* #6729 Read doesn't save the PDFs it opens (when sharing)
* Customization key won't install if the activities or library directories had already been created as root


* #6532 SD Card Corruption: partition table gets corrupted on ext3-formatted SD cards on suspend/resume


== Localization Issues ==
* The contents of a USB key didn't show in the journal. So couldn't install activity bundles from the USB through the journal.
* {{Ticket|6777}} Library bundles cannot use non-ascii characters in their file names
* {{Ticket|6973}} Haiti keyboard doesn't match keyboard mappings.
* {{Ticket|6945}} 'Switch [language] group' key non-functional on Amharic keyboards




=== Customization Issues ===
== Activity Issues ==
* {{Ticket|6773}} TamTamJam: Recorded microphone slots don't playback. ?need to test
* Couldn't add feeds to news reader because clicking "+"/dropdown on the feeds tab didn't do anything. ?need to test
* Read will not share a pdf document.
* {{Ticket|6729}} Read doesn't save the PDFs it opens (when sharing)
* {{Ticket|4539}} Sharing in Etoys only works if the laptops are in the same network (on same mesh channel, or connected to same access point). ?need to test


[[OLPC_Update.1_Software_Release_Notes_Activity_Testing_Results|(Almost) full activity testing results for Update.1 RC-2]], all results are from build 702
* Customization key wont install if the activities or library directories had already been created as root.




=== Activity Issues ===
== Touchpad Issues ==
* The Nepal pilot reported "jumpy touchpad" problems in dusty conditions. In response, we have [http://lists.laptop.org/pipermail/devel/2008-May/013580.html surveyed known touchpad issues] and have examined potential software work-arounds: [http://www.olpcnews.com/forum/index.php?topic=1996.msg19390], [http://lists.laptop.org/pipermail/devel/2008-May/013897.html].


= Network Related Issues =
* #6773 TamTamJam: Recorded microphone slots don't playback
*[[USB ethernet adaptors]] will not work at all at first. {{Ticket|6917}} The workaround is to upgrade the olpc-utils package manually to [http://koji.fedoraproject.org/packages/olpc-utils/0.71/1.olpc2/i386/olpc-utils-0.71-1.olpc2.i386.rpm 0.71] or higher, or to enter this command in the [[Terminal]] after becoming [[root]]: <tt>echo 'SUBSYSTEM=="net", KERNEL=="msh*", OPTIONS="last_rule"' > /etc/udev/rules.d/10-olpc-netif.rules</tt>
* Couldnt add feeds to news reader because clicking "+"/dropdown on the feeds tab didn't do anything.


[[OLPC_Update.1_Software_Release_Notes_Activity_Testing_Results|(Almost) full activity testing results for Update.1 RC-2]], all results are from build 702


=== Network Issues ===
== Access Points ==
* When a number of laptops try to connect to the school server (either over a WiFi AP or a mesh) at one time, random "failure to associate" will occur and the laptops will join a simple mesh instead {{Ticket|4153}} ({{Ticket|5963}} is dup). This is indicated by the network indicator in the home view (it will say "Connected to a simple mesh" instead of "Connected to a school mesh portal" or "Connected to <school_essid>" when hovered over. Simply click on the school Wifi AP or one of the mesh circles in the laptop's neighborhood view to restart the association process.
* Sometimes when a number of laptops try to connect to the school server at one time, random laptops may be unable to connect to schoolserver presence service (ejabber) {{Ticket|5908}}. This is indicated by a greatly reduced number of XO icons in the neighborhood view (compared to a laptop which is connected to the presence service). Simply click on the school Wifi AP or one of the mesh circles in the laptop's neighborhood view to restart the association process (in extreme cases, restart Sugar (CTL + ALT + ERASE) or reboot the laptop).
* Association with WEP/WPA encryption works. However this must be tested for a wider range of access points.
* Sometimes obsolete APs show in the neighborhood view, or an AP is shown more than once. {{Ticket|6909}}


* WEP and WPA initially worked fine and were tested several times; however, after some time, no XOs could connect to the WPA access point. The icon also disappeared in one of the XOs.


== School Server/ Jabber Server ==
* To register to a school server and connect to the school jabber server you must
*# Ensure that you are connected to the appropriate Network by hovering over the Network circle in the Home View.
*# Hover over the XO icon in the main view and select <code>Register</code>.
*# Hover again over the XO icon and verify that the <code>Register</code> entry has disappeared.
*# Restart sugar by pressing <code>Ctrl+Alt+Erase</code>.
*# Confirm you have connected to the jabber server by typing <code>olpc-netstatus</code> from the terminal.
* When registering with a school server, you MUST associate with the correct network before clicking <code>Register</code> for the first time. Otherwise, you wont be able to register until you restart Sugar (<code>Ctrl+Alt+Erase</code>) {{Ticket|6857}}.
* You should restart sugar (<code>Ctrl+Alt+Erase</code>) to resolve the following bugs
** You can't register with the school server. {{Ticket|6857}}
** You can't connect to the default jabber server alhtough you have registered.{{Ticket|6881}}
** You connected to the jabber server, and gabble is running, but no XOs, or few XOs are seen in the neighborhood view. {{Ticket|6883}},{{Ticket|6884}}
** You are running both gabble and salut. {{Ticket|6881}},{{Ticket|6886}}


=== Collaboration Issues ===


== Simple Mesh / Salut ==
* When XOs leave the mesh, the neighborhood view will notice with a delay between 10-30min.{{Ticket|6282}},{{Ticket|5501}}
* However, when XOs enter the mesh or start an activity it is shown instantly.
* You can refresh the data of the neighborhood view by reconnecting to the mesh.
* [[Suspend_and_resume|Suspend/Resume]] will not work with salut.


== UI ==
Activity sharing is quite fragile in candidate-703. See [[Collaboration Network Testbed]] for more detailed results.
* Sometimes in the neighborhood view, when connected to an Access Point a mesh circle continues to blink. This will also show up as two network circles in the Home view. This shows false information, but also causes no harm, so it may be ignored. {{Ticket|5459}}
* When an XO joins a shared activity its icon should disappear and reappear next to the activity. It happens that the XO icon will just disappear. Its collaboration will work properly, and if it leaves the activity it will show again as normal. You can see the correct number of XOs clustered around the activity by restarting sugar(<code>Ctrl+Alt+Erase</code>). However the bug will continue from this point on when new XOs join the same or other activities. {{Ticket|5904}}


[[Category:Release notes]]
In particular, Read sharing is not a reliable mechanism for transporting PDFs between laptops. Other less bandwidth-intensive activities such as Write, Distance, Chat, and Memorize were somewhat can be shared with somewhat more reliability.

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
for other discussion, see Update.1

SD cards may be corrupted by builds 703-709. Do not use SD cards with the XO with builds in this range.

What's new in the official-703 (8.1.0) release?

  1. Fix bugs
  2. Laptops now suspend when closed & resume when opened, for better battery life
  3. Each activity runs isolated from the others, for better security
  4. Sugar activities are now released separately, or in "Activity Packs", rather than as part of the operating system release.

Please also refer to the milestone and the official roadmap for schedule dates and features for each release.

2008-06-06: Given successful completion of the Release Checklist, we have released build official-703 as our Update.1 (8.1.0) release build.

Breaking Changes from official-656

Activities must be installed separately.

Motivation: OLPC cannot presently afford to maintain more than one stable build. Therefore, we have decided to provide a "blank slate" which must be customized with activities and content bundles at installation time.

It's worth mentioning "missing activities" here because it's a term that people might search for.

What's the recommended way to upgrade?

  1. Download the G1G1 Activity Pack (from here) and unzip it in the base (root) directory of a USB flash drive. You should see two directories (boot and bundles, and a file called customization-2) in the base directory. Commands such as "extract here" in ubuntu / windows will sometimes create a directory with the same name as the zip file, placing the unzipped files within it. If this happens, you will have to move the files to the base directory in order for your XO to see them on boot. (Note that the "boot" directory will contain two zip files, actos.zip and runos.zip. This is normal; these files do not need to be unzipped).
  2. Plug the XO into an electrical outlet and connect it to the internet.
  3. Run olpc-update to the new build. (In a terminal, enter su -l (lowercase L, not 1) and then olpc-update 703 ) This may take half an hour or more, depending on your internet connection.
  4. Insert the USB flash drive and reboot the XO. It will display text on a black screen as the activities are installed, after which it will power off.
  5. Remove the USB flash drive. Connect the XO to AC power, so that it will be able to proceed if it determines that a firmware update is needed. Then power on your XO as per usual.

If you are upgrading from build 69X, the build is already separated from the activities in those builds. So you can run olpc-update 703 and your activities will not be affected.

(I couldn't get the USB flash method to work - some mention about holding down the gamepad X if locked firmware? Wrong filesystem on USB? - but Bert's Script method immediately below worked wonderfully. I think that is the better way, anyways!)

Finding Activities

OLPC hosts many Activities. These activities can be installed in en masse onto build 703 with either:

Some commonly installed activity packs include the:

(The Nepal activity pack contains some additional customizations made by OLE Nepal for their pilot).

TO INSTALL AN ACTIVITY PACK:

  1. Download its zip file.
  2. Unzip it onto the root of a blank USB flash drive.
  3. Open the file. If there is only one folder, open it and remove the three files that are in it so they stand individually. If the three files are enclosed within another file, the XO will not find them.
  4. Insert the USB flash drive into your XO and reboot.
  5. If your machine is not a secure XO (its firmware is unlocked), you must hold the X game key while booting .
  6. When the installation is complete, the XO will shut itself off. Remove the USB key before powering it on.

Notes

  • The USB flash drive should be formatted with a VFAT file system (FAT16 with long filename support); this is the common format for most USB sticks with capacity up to 2 GB.
    • It is important that the USB flash drive have a partition table, and that the VFAT file system be in the first partition. Linux allows you to put a file system directly on the drive itself without a partition table (i.e. "mkfs.vfat /dev/sdi", rather than fdisk and "mkfs.vfat /dev/sdi1"), but then on boot, the XO will panic with an error from mount ("non-zero status code 255").
  • Do not use the SD card slot, you will end up with the same code 255 described above. You can use a SD card with a USB adapter.
  • You can perform steps 1 and 2 on another computer, or if you are familiar with the Linux command line, on the XO in a terminal using wget and unzip.
  • After step 2, the root of the USB flash drive should contain
 /customization-2
 /boot
 /bundles
  • After rebooting your machine you must go to the List View in order to select the activities you want to appear in the Ring View

Improvements from build 656

See OLPC_SW-ECO_4 for a more precise list of the changes, indexed by ticket, that lead from candidate-699 to official-703. To summarize, we added:

  • Open Firmware version Q2D14 which will delay firmware updates until power is available (easing mass laptop updates).
  • Better Spanish localization of the library and of the X and console keymaps.
  • The ability to customize installed activities, boot screens, and activity order via USB key.
  • Rainbow prevents faulty activities from damaging many parts of the system configuration.
  • OHM power management software can be manually enabled to provide better battery life in solo-use situations.
  • The XO announces its build identifier under the "About this XO" palette entry available from the central XO Icon on the Home View.
  • Miscellaneous stability improvements including a new libabiword that fixes a Write sharing crasher.

Notable Current Bugs

  • #6532 SD Card Corruption: partition table gets corrupted on ext3-formatted SD cards on suspend/resume
  • #7158 Upgrade from 656 to 703 leaves su unusable when you fallback to 656. This bug will only affect you if you upgrade to 8.1.0 and then "revert" to 656 by holding down the "O" game key on boot up. If you "clean install" 8.1.0 or revert to 656 by a "clean install" of that, you will not encounter this bug.
  • The contents of a USB key didn't show in the journal. So couldn't install activity bundles from the USB through the journal.


Customization Issues

  • Customization key won't install if the activities or library directories had already been created as root


Localization Issues

  • #6777 Library bundles cannot use non-ascii characters in their file names
  • #6973 Haiti keyboard doesn't match keyboard mappings.
  • #6945 'Switch [language] group' key non-functional on Amharic keyboards


Activity Issues

  • #6773 TamTamJam: Recorded microphone slots don't playback. ?need to test
  • Couldn't add feeds to news reader because clicking "+"/dropdown on the feeds tab didn't do anything. ?need to test
  • Read will not share a pdf document.
  • #6729 Read doesn't save the PDFs it opens (when sharing)
  • #4539 Sharing in Etoys only works if the laptops are in the same network (on same mesh channel, or connected to same access point). ?need to test

(Almost) full activity testing results for Update.1 RC-2, all results are from build 702


Touchpad Issues

  • The Nepal pilot reported "jumpy touchpad" problems in dusty conditions. In response, we have surveyed known touchpad issues and have examined potential software work-arounds: [1], [2].

Network Related Issues

  • USB ethernet adaptors will not work at all at first. #6917 The workaround is to upgrade the olpc-utils package manually to 0.71 or higher, or to enter this command in the Terminal after becoming root: echo 'SUBSYSTEM=="net", KERNEL=="msh*", OPTIONS="last_rule"' > /etc/udev/rules.d/10-olpc-netif.rules


Access Points

  • When a number of laptops try to connect to the school server (either over a WiFi AP or a mesh) at one time, random "failure to associate" will occur and the laptops will join a simple mesh instead #4153 (#5963 is dup). This is indicated by the network indicator in the home view (it will say "Connected to a simple mesh" instead of "Connected to a school mesh portal" or "Connected to <school_essid>" when hovered over. Simply click on the school Wifi AP or one of the mesh circles in the laptop's neighborhood view to restart the association process.
  • Sometimes when a number of laptops try to connect to the school server at one time, random laptops may be unable to connect to schoolserver presence service (ejabber) #5908. This is indicated by a greatly reduced number of XO icons in the neighborhood view (compared to a laptop which is connected to the presence service). Simply click on the school Wifi AP or one of the mesh circles in the laptop's neighborhood view to restart the association process (in extreme cases, restart Sugar (CTL + ALT + ERASE) or reboot the laptop).
  • Association with WEP/WPA encryption works. However this must be tested for a wider range of access points.
  • Sometimes obsolete APs show in the neighborhood view, or an AP is shown more than once. #6909


School Server/ Jabber Server

  • To register to a school server and connect to the school jabber server you must
    1. Ensure that you are connected to the appropriate Network by hovering over the Network circle in the Home View.
    2. Hover over the XO icon in the main view and select Register.
    3. Hover again over the XO icon and verify that the Register entry has disappeared.
    4. Restart sugar by pressing Ctrl+Alt+Erase.
    5. Confirm you have connected to the jabber server by typing olpc-netstatus from the terminal.
  • When registering with a school server, you MUST associate with the correct network before clicking Register for the first time. Otherwise, you wont be able to register until you restart Sugar (Ctrl+Alt+Erase) #6857.
  • You should restart sugar (Ctrl+Alt+Erase) to resolve the following bugs
    • You can't register with the school server. #6857
    • You can't connect to the default jabber server alhtough you have registered.#6881
    • You connected to the jabber server, and gabble is running, but no XOs, or few XOs are seen in the neighborhood view. #6883,#6884
    • You are running both gabble and salut. #6881,#6886


Simple Mesh / Salut

  • When XOs leave the mesh, the neighborhood view will notice with a delay between 10-30min.#6282,#5501
  • However, when XOs enter the mesh or start an activity it is shown instantly.
  • You can refresh the data of the neighborhood view by reconnecting to the mesh.
  • Suspend/Resume will not work with salut.

UI

  • Sometimes in the neighborhood view, when connected to an Access Point a mesh circle continues to blink. This will also show up as two network circles in the Home view. This shows false information, but also causes no harm, so it may be ignored. #5459
  • When an XO joins a shared activity its icon should disappear and reappear next to the activity. It happens that the XO icon will just disappear. Its collaboration will work properly, and if it leaves the activity it will show again as normal. You can see the correct number of XOs clustered around the activity by restarting sugar(Ctrl+Alt+Erase). However the bug will continue from this point on when new XOs join the same or other activities. #5904