Sugar on a Stick/Mirabelle

From Sugar Labs

Jump to: navigation, search

Project Home   ·   Get Involved   ·   Contacts   ·   Resources   ·   FAQ   ·   Roadmap   ·   To Do   ·   Meetings

a Sugar environment you can carry in your pocket!

Sugar on a Stick - Mirabelle

a Sugar environment you can carry in your pocket

This document will provide instructions for preparing a Sugar on a Stick (SoaS) installation. It should contain a list of known issues and sources of further information, for example how to use a Boot Helper CD for very old PCs.

Testing and documentation assistance is welcome.

Fedora has hosted the build environment for this version of Sugar on a Stick. See this Fedora Sugar on a Stick Spin page for more information.

If you want to proceed directly to downloading, please see this wiki page,

Note: The contents of this section have been transcluded from another page, Sugar on a Stick/Beta:

Sugar on a Stick/Beta

Contents

SoaS Release Testing

Sugar 0.88 release testing is underway on a Sugar on a Stick image with Fedora 13 (Goddard).

Download and test

SoaS installation on USB/SD devices

with Linux

(Don't forget to chmod +x tools_livecd-iso-to-disk.sh after you download the script.)
  • The .iso file may be burnt to a CD-ROM and booted on your PC (or mounted in a virtual machine to boot it).

Note: To install the .iso disc image, execute the shell script as the root user in one command with arguments as follows:

./livecd-iso-to-disk --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd?1

where '?' in the final parameter represents the target bootable device node, such as sdb1 or sdc1, etc.
(You may use '\' line-continuation symbols followed by a newline [enter or return keypress] to break a long line visually on the terminal, but not logically to the script processing software.)
  • (*) be sure of your USB/SD storage device name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example, /dev/sdb1. Use the mount command or the partition manager to confirm it before executing the script.
  • --format --reset-mbr are optional arguments for the shell script, but may be excluded to preserve the existing disc format and data. See olpc:How to Damage a FLASH Storage Device for a discussion of why you might want to try to keep your factory format on a flash storage device.
    Talk:Downloads and LiveOS image have more information on this and other installation options.
  • If you do use the format and reset master boot record arguments, you'll want to specify the target device name and not a partition, that is /dev/sd* with no partition number, instead of /dev/sd*1 as in the example above used to specify an existing partition. As noted above, confirm your target disc device name—in this case, it is VERY DANGEROUS to your other discs if this is entered wrong, as the whole disc will be reformatted and a new master boot record written causing all previously written data on that disc to be lost.

with Microsoft Windows

In Microsoft Windows, one may use the Fedora Live USB Creator from FedoraHosted here, (but one will not have the full optimization of data storage allowed by installing a separate, persistent home directory).

  • Plug a blank target USB flash drive (or SD Card) into your computer (1 GB or greater). (See LiveOS image and Cautions with using Live USB devices regarding flash drive size.)
  • Launch Live USB Creator.
  • Select the Browse button to 'Use existing Live CD' and find the downloaded .iso file image on your system.
  • Adjust the Persistent Storage slider. This enables you to save changes to the system and Sugar Activities onto the device.
  • Select your flash drive as the target and click the Create Live USB button.
  • Wait for the process to finish, then close the Live USB Creator program.
  • Stop your flash drive using the Safely Remove Hardware dialog and eject it.

with Apple Macintosh

See and adapt the instructions at Sugar on a Stick/Mac.

How to add a test result

Copy-paste the template below to another line at the bottom of the #Test results table. 

|-
| <!-- nightly build number -->
| <!-- tester's SL wiki username -->
| <!-- does it boot? -->
| <!--Neighborhood? -->
| <!-- Browse -->
| <!-- Etoys -->
| <!-- Chat -->
| <!-- Terminal -->
| <!-- Turtle Art -->
| <!--IRC -->
| <!-- Log -->
| <!-- Write -->
| <!-- Record -->
| <!-- Physics -->
| <!-- Read -->

Add results for each of the #Smoke tests as follows: 

| <!-- name of test --> style="background: lime" | yes
| <!-- name of test --> style="background: orange" | partially working (comments go here)
| <!-- name of test --> style="background: red" | not working (describe failure)

Test results

Nightly build Tested by Boots? Neighborhood? Browse Etoys Chat Terminal Turtle Art IRC Log Write Record Physics Read
20100429.16.iso Mchua yes with telepathy-gabble update yes yes yes yes yes yes yes yes yes yes yes, but no book files to open
soas-i386-20100501.07 as 2GB USB satellit yes yes with http://people.sugarlabs.org/telepathy/Tgillard/telepathy-gabble-0.9.11-1.fc14.rpm yes yes yes-2 way with xo-1 & Blueberry[1] yes yes yes yes yes-2 way with xo-1 & Blueberry; colors and fonts working[2] yes but no sound yes yes, but no book files to open; will not open terminal journal

Smoke tests

  • Boot: Does it boot? Can you choose a name and colors, and navigate through the Neighborhood/Friends/Home/Journal screens?
  • Neighborhood? Can you get on Jabber and see other Sugar users in your Neighborhood? (This also implies that your wifi or wired Network Connection works.)
  • Activity tests: For each Activity, the following criteria must be met:
    • The Activity starts from Home view.
    • You can perform a basic action in the Activity (for instance, loading a webpage in Browse, or joining a channel with IRC, or typing some words in Write.)
    • The Activity can be stopped via the button in the Frame.
    • The Activity session is saved in the Journal.
    • The Activity can be shared with other Sugar users in your Neighborhood.[3]
Retrieved from "http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Mirabelle"
Personal tools
Sugar
Teams
Projects
Local Labs
Google Translations
Using the Wiki