Sugar Labs - User contributions [en]

Obsolete Service/jabber

2010-05-26T14:37:00Z

Daveb: Updated for new server hosted at solutiongrove

<noinclude>{{TOCright}}</noinclude>

== Jabber (jabber.sugarlabs.org) ==

=== Hardware ===
* Vmware ESX Virtual Machine

=== Location ===
Hosted by [http://www.solutiongrove.com/|Solutiongrove]

=== Admins ===
* [[User:daveb| Dave Bauer]], daveb on #sugar Freenode

=== Software ===
* Modified XS 0.6 (based on Fedora Core 9)

Sugar on a Stick/Activity Criteria

2010-03-29T13:54:02Z

Daveb: I added a suggestion to require working collaboration for activities that support it.

<big><big><big>'''''This is a draft discussion.''' It does not reflect policy (yet) - it is our attempt to define a clear policy for inclusion for the '''4th release''' of SoaS (October 2010, as per the [http://spins.fedoraproject.org Fedora Spin] release cycle).''</big></big></big>

== Introduction ==

This page is for gathering requirements for Activity inclusion on the default [[Sugar on a Stick]] image. These are the criteria we will be using to begin discussion on Activity inclusion in v.4.0, due for release at the end of October 2010.

== Proposed requirements ==

=== Be installable via a package in the Fedora repositories ===

'''Rationale:''' Since SoaS is a [http://spins.fedoraproject.org Fedora Spin], everything that ships on the default image must be a package in Fedora. This is an upstream requirement.

'''Test:''' The version desired for inclusion should be in the [https://admin.fedoraproject.org/pkgdb/ Fedora repository] for the current Fedora version under development (in this case, F14).

'''Instructions:''' See https://fedoraproject.org/wiki/PackageMaintainers for more information on how to make a package (or get a package made) in Fedora. We may want to clean this up or make a Sugar-specific guide to packaging Activities in particular, or gather a team of volunteers who offer to do the packaging for Activity maintainers.

=== Be hosted on ASLO ===

'''Rationale:''' http://activities.sugarlabs.org is the Sugar Labs community's primary online mechanism for updating and installing Activities.

'''Test:''' Go to http://activities.sugarlabs.org and search for the Activity name. You should:
* be able to find the Activity
* be able to see that the Activity is properly categorized in one or more categories
* be able to see that the Activity's metadata (version number, "works with", etc.) is up to date
* be able to read an accurate and up to date summary of the Activity on its ASLO page
* be able to successfully download and install the Activity from ASLO's web interface

'''Instructions:''' I can't find clear step-by-step instructions on how to get one's Activity into ASLO - can anyone else help find (or create) them?

=== Be translated in Pootle ===

'''Rationale:''' In order to support the usage of SoaS (and SoaS remixes) by students from around the world, it is important that Activities be translateable and set up for easy localization. Pootle is the system Sugar Labs uses for localization.

'''Test:''' I am not sure what a good set of minimal "you are translateable" criteria would be. Suggestions?

'''Instructions:''' I can't find clear step-by-step instructions on how to get one's Activity into Pootle - can anyone else help find (or create) them?

=== Have a usage frontpage ===

'''Rationale:''' Users (particularly teachers) should be able to find a quick getting-started guide on usage that will let them evaluate whether they want to use an Activity for their classroom or not. They should be able to get a sense of what they can do with an Activity without having to spend an hour or two (per Activity!) exploring it in-depth - this page will provide what they need to decide whether they ''do'' want to spend an hour or two experimenting to figure out how they specifically want to use it with their class.

'''Test:''' The ASLO page for an Activity should include a link called "instructions for users" (note: this is fairly arbitrary and we may want to standardize on a better title/format) that leads to a tutorial on how to start and run the Activity in question. This can be anything from a page on the Sugar Labs wiki with screenshots all the way up to a [http://en.flossmanuals.net/ flossmanuals book] on just that Activity.

Suggested things for inclusion:

* what the Activity does
* intended audience (what assumptions does the design make? does it assume you can read, add, etc?)
* how to install it (can link to generic Activity instructions)
* how to start it (can link to generic Activity instructions)
* how to uninstall it (can link to generic Activity instructions)
* how to stop it (can link to generic Activity instructions)
* an explanation of the interface (what do the different buttons, etc. do?)
* how to begin exploring it (this can take several forms: a walkthrough of a few basic tasks, some hints on exercises/things-to-try, a link to galleries of existing work and classroom stories of that Activity's usage, etc.)

'''Instructions:''' We need to write instructions and gather more examples for this. Right now the best examples are the [http://en.flossmanuals.net/ flossmanuals books] on various Activities, but to expect every Activity to do a book seems like too much - we need examples of a good minimum bar, which is likely to be a well-made wiki page.

=== Have a development frontpage ===

'''Rationale:''' If an Activity is included on SoaS, it will be used by many people; in order to hold to the Sugar Labs principle of hackability (particularly by children), we need a good resource to get new hackers started.

'''Test:''' The ASLO page for an Activity should include a link called "get started with development" (note: this is fairly arbitrary and we may want to standardize on a better title/format) that leads to a place with instructions on how people can...
* view the source code
* download the source code
* modify the source code
* share their modifications
* view existing tickets/bugs/suggestions for things to work on

You may notice that the first 4 entries on this list map to the [http://www.gnu.org/philosophy/free-sw.html 4 essential software freedoms].

'''Instructions:''' We need instructions/examples of this. Please help!

=== Have a ticket queue ===

'''Rationale:''' Users need a place to report bugs.

'''Test:''' The ASLO page for an Activity should include a link called "report a bug / suggest an enhancement" (note: this is fairly arbitrary and we may want to standardize on a better title/format) that leads to the "new ticket" entry for that Activity's component (which may or may not be hosted on http://bugs.sugarlabs.org, especially in the case of an upstream project such as EToys). Since we may not be standardizing on bug trackers, each Activity ASLO page should also have a link to instructions on how to file a bug, perhaps something similar to [[Talk:Sugar_on_a_Stick/Getting_Involved|this tutorial]]).

'''Instructions:''' The simplest way to do this is to get a Trac component for your Activity. We need instructions on how to do this (although I believe it is as simple as filing a Trac ticket requesting a Trac component). We may want to discuss ways that students and teachers can report bugs without having to create a Trac username (which is, for some, a significant barrier to entry - not that it's difficult to make an account, but that there may be reluctance to create an account, particularly for children).

=== Have and pass a smoke test ===

'''Rationale:''' We need a quick way to make sure the Activity works, so the Activity needs to define what it means for it to "work," and then come up with a straightforward set of instructions that anyone can use to demonstrate and/or verify that it is working.

'''Test:''' This should be fairly simple.
* Do you have a smoke test?
* Did you run it? (Can anyone else run it?)
* Did it pass? (Can you prove it?)
* Is there a place to file results? (Can people find them?)

'''Instructions:''' We need a guide on how to make a good smoke test. Sample Activity tests can be found at http://wiki.laptop.org/go/Test_cases_8.2.0#Activity-specific_test_cases, but they're old and there's no guidance on which are good tests or not.

=== Collaboration Works ===

'''Rationale:''' Collaboration is one of the most interesting aspects of the Sugar platform and it really showcases what makes Sugar different.

'''Test:''' This only applies if the activity supports collaboration. Test to make sure that two SOAS can see the activity that is shared, join the activity, see the correct data during collaboration, and make sure it handles the originator leaving the activity gracefully.

'''Instructions:''' I am not sure what to put here, is this instructions for doing the test or for fixing collaboration bugs?

=== Add your own idea here ===

Be sure to describe:

'''Rationale:''' Where does this requirement come from and why is it important?

'''Test:''' how we can make sure that the requirement is met - what sort of testing needs to be done to verify this?

'''Instructions:''' links to instructions on how Activity authors and maintainers can fulfill the requirement, if possible.

Features/Backup and Restore

2009-07-07T18:11:39Z

Daveb: Added dependencies on ds-backup-client and registration.

<noinclude>{{ GoogleTrans-en | es =show | bg =show | zh-CN =show | zh-TW =show | hr =show | cs =show | da =show | nl =show | fi =show | fr =show | de =show | el =show | hi =show | it =show | ja =show | ko =show | no =show | pl =show | pt =show | ro =show | ru =show | sv =show }}{{TOCright}}</noinclude>





= Feature Name =
''Back Up and Restore''

== Summary ==
Easily back up and restore the Journal of a computer running Sugar (includes SoAS and SoLinux with top priority SoAS). Also, easily back up and restore the full Sugar installation. Beyond the Journal, this includes the activities, any configuration of the OS and the everything needed to restore to its original state.

This feature is a top priority for Gardner Pilot Academy but also requests by essentially every XO deployment.

== Owner ==
* Name: [[User:Gregorio| Greg Smith]]

* Email: gregsmithpm at gmail.com

== Current status ==
* Targeted release: ?
* Last updated: July 7, 2009
* Percentage of completion: ?

== Detailed Description ==
For all the items listed below, implement solution with XS and if possible as a software solution on one or more standard Linux distributions.

''Backup and Restore of the Journal''
* Allow time based backup and restore of the journal. Check for Journal changes on the Sugar computer. Copy any changes to the server on a regular basis. Stagger the copies so that not all Sugar computers backup at the same time. See implementation of this with XO and XS at: http://wiki.laptop.org/go/XS_Blueprints:Datastore_Simple_Backup_and_Restore

* Provide a web based GUI to restore one or all backed up journal entries. The user would boot up any Sugar implementation (user name/password based security is also important) and point their Web browser at a URL on the server. Preferable to automatically take you to the right page (aka the page where your particular Sugar instance is backed up) but would also accept seeing a list of Sugar Journals by user name and picking the right one. Clicking on a single Journal entry or on a link for "full journal" would download those items back in to the journal of the Sugar computer.

* Provide a user initiated backup of the journal. In this case a User would use their web browser to go to a page on the server and click the "backup" link. Then the server would check for changes since the last backup and copy everything from that journal to the server. Same case as above for restore.

* Backup and restor of full sugar instance. Same as above (AKA user initiated and time based server/script) but for the full Sugar instance. This can be only the full instance and does not need to list individual files. For restoring SoAS should support booting up with a USB stick, going to the page, then removing the USB stick and inserting a new one, then clicking restore. This would copy the full Sugar instance to the new USB stick. This would now be a clone of the original USB stick. Also, implement a "clone" feature which allows the same work flow as above but without a server. That is, put a SoAS in a computer, copy it to the computer then restore it to a new USB stick with the full SoAS including configuration.

* Implementing a standard Linux package to do this for Sugar would be fine.

* See also this bug in Sugar: http://dev.sugarlabs.org/ticket/75 and http://dev.sugarlabs.org/ticket/916

== Benefit to Sugar ==
Ensures that kids and teachers don't lose their work. Backup and restore over the WAN is a major growth technology in commercial SW. e.g. see: http://www.carbonite.com/

A Sugar implementation would be a big feature promotable publicly. Could also be used for a sneaker net type collaboration of last resort. i.e. "get my journal entry off this web page" to move something from one Xo to another.

== Scope ==
Will need client side and server software. May need to move a Linux package to SoAS and may need to push new code upstream to support Journal/Datastore implementation.

== How To Test ==
Create some entries in a journal. Then test with:
* SoAS 8.6 or later and a single computer.
* SoAs 8.6 or later with XS running 0.5 or later.
* SoAS 8.6 or later with Linux distribution
* Test backup and restore of a single journal entry
* Test backup and restore of a full SoAS image. Make sure to use the SoAS so that it changes some files and configurations.
* Test time based backup, preferably with several SoAS computers.

In all cases, ensure that the files are backed up on the server and can be restored on the SoAS. Make sure to open the files in the journal and run them. Also, make sure to cold boot any full images and confirm that changes were saved.

== User Experience ==
Requires a new "web site" on the server for back up and restore.
Requires a configuration option on SoAS to set the time and files to be backed up.

== Dependencies ==
''What other packages (RPMs) depend on this package? Are there changes outside the developers' control on which completion of this feature depends? In other words, completion of another feature owned by someone else and might cause you to not be able to finish on time or that you would need to coordinate? Other upstream projects like python?''

* See http://dev.sugarlabs.org/ticket/916 for changes to allow registering SoaS to a XS.
* Also ds-backup-client package is required to backup to an XS along with a patch to allow it to work on SoaS in addition to an XO.

Unknown.

== Contingency Plan ==
Plan B is to find a manual way to execute a script which does an "rcp" or other file transfer to a server. Then allows restore via script as well.

== Documentation ==
See XS example above. Will need more documentation.

== Release Notes ==

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]] 

==[[Features]] Subpages==
{{Special:PrefixIndex/Features/}}
----
''You can add categories to tie features back to real deployments/schools requesting them, for example <nowiki>[[</nowiki>Category:Feature requested by School Xyz]]''
[[Category:FeaturePageIncomplete]]
[[Category:Feature]]

Sugar on a Stick/Strawberry

2009-06-25T00:12:48Z

Daveb: Add explicit link to VM info in OS X section.

<noinclude>{{ GoogleTrans-en2 | es =show | sq =show | bg =show | ca =show | zh-CN =show | zh-TW =show | hr =show | cs =show | da =show | nl =show | et =show | tl =show | fi =show | fr =show | gl =show | de =show | el =show | hi =show | hu =show | id =show | it =show | ja =show | ko =show | lv =show | lt =show | mt =show | no =show | pl =show | pt =show | ro =show | ru =show | sr =show | sk =show | sl =show | sv =show | th =show | tr =show | uk =show | vi =show | ar =show | iw =show | fa =show }}</noinclude>
[[Image:SugarLabs3x.jpg|right]]

== Sugar on a Stick - Strawberry ==

'''Release Notes - last update: 2009/06/24'''

This document provides instructions for preparing a Sugar on a Stick (SoaS) installation. It also contains a list of known issues and sources of further information, for example how to use a Boot Helper CD for very old PCs. For more detailed information, please check the [[Sugar_on_a_Stick|SoaS wiki page]].

The Sugar on a Stick Strawberry release is based on Fedora 11 with the latest updates as of June 22. It also features the latest Sugar learning environment, namely [[DevelopmentTeam/Release/Releases/Sucrose/0.84| version 0.84]], including 40 Activities to enrich the learning experience. Hundreds of Activities are available for download from the [http://activities.sugarlabs.org/ Sugar Activity Library]. This release is a step forward from the [[Sugar_on_a_Stick/Beta| beta release]]; in addition to Fedora updates, it includes supplementary sample content, which is available in the Journal. Apart from the default [[Sugar_on_a_Stick/Roadmap#Fructose_modules_.28F11.29|Fructose]] activities, additional Activities are included in this release. (See the Sugar [[Taxonomy]] for an explanation of these codenames.)
{{TOCright}}

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
|-style="background:#787878; color: white;"
| '''Fructose Activity''' || || '''Honey Activity''' || '''Honey Activity'''
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4024 Browse] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4037 CartoonBuilder] || [http://activties.sugarlabs.org/en-US/sugar/addon/4063 Memorize]
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4076 Calculate] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4050 Colors] || [http://activities.sugarlabs.org/en-US/sugar/addon/4034 Moon]
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4069 Chat] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4044 FlipSticks] || [http://activities.sugarlabs.org/en-US/sugar/addon/4082 Paint]
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4030 Etoys] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4054 FreeCell] || [http://activities.sugarlabs.org/en-US/sugar/addon/4193 Physics]
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4032 Image Viewer] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4042 InfoSlicer] || [http://activities.sugarlabs.org/en-US/sugar/addon/4074 Poll]
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4045 Jukebox] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4029 IRC] || [http://activities.sugarlabs.org/en-US/sugar/addon/4081 Record]
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4056 Log] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4046 JigsawPuzzle] || [http://activities.sugarlabs.org/en-US/sugar/addon/4047 SliderPuzzle]
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4041 Pippy] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4064 JokeMachine] || [http://activities.sugarlabs.org/en-US/sugar/addon/4038 Speak]
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4028 Read] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4078 Labyrinth] || [http://activities.sugarlabs.org/en-US/sugar/addon/4073 StoryBuilder]
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4043 Terminal] || || [http://activities.sugarlabs.org/en-US/sugar/addon/4089 Library] || [http://activities.sugarlabs.org/en-US/sugar/addon/4039 ViewSlides]
|-
| [http://activities.sugarlabs.org/en-US/sugar/addon/4027 Turtle Art] || || ||
|-
| Write || || ||
|}

=== Get it! ===

When downloading, please pick a download server close to your current location! Here is a list with possible locations.

(The download is a CD-ROM disc image .iso file (380 MiB) that could be burned to and booted from a CD drive like a LiveCD—but no work or changes will be saved after shutdown.)

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
|-style="background:#787878; color: white;"
| '''Location''' || '''Link'''
|-
| U.S. ''master'' || http://download.sugarlabs.org/soas/releases/soas-strawberry.iso
|-
| Netherlands ''mirror'' || http://ftp.snt.utwente.nl/pub/software/sugarlabs/soas/releases/soas-strawberry.iso
|-
| Netherlands ''mirror'' || http://ftp.nluug.nl/pub/os/Linux/distr/Sugar/soas/releases/soas-strawberry.iso
|-
|}

==== Windows Users ====

# Download the latest version of Fedora ''LiveUSB Creator'' from http://fedorahosted.org/liveusb-creator/ and extract it;
# Plug a target USB flash drive into your computer (minimum 1-gigabyte);
# Use the ''Format'' dialog to rename your USB ''Volume'' to FEDORA;
# Launch ''LiveUSB Creator'';
# Select ''Sugar on a Stick v1 Strawberry'' in the drop-down menu on the upper-right side of the ''LiveUSB Creator'' window;
# Set the ''Persistent Storage'' slider to at least 160 MB (use more if you have a drive with more space);
# Select your USB flash drive as the target;
# Click the ''Create Live USB'' button and then wait for the process to finish (about 5 minutes);
# Eject the USB flash drive using the ''Safely Remove Hardware'' dialog.
: More information is available [[Sugar on a Stick/Windows|here]].

==== Linux Users ====

# Download the SoaS iso image from http://download.sugarlabs.org/soas/releases/soas-strawberry.iso
# Install these three packages: ''syslinux'', ''isomd5sum'', and ''cryptsetup''
# Download this script: http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk.sh
# Plug your target USB flash drive into your computer;
# Unmount the USB flash drive (e.g., <code>sudo umount /dev/sdb1</code>);
# Execute the script with the following command:
#:<code>sudo ./livecd-iso-to-disk.sh --overlay-size-mb 300 --home-size-mb 160 --delete-home --unencrypted-home soas-strawberry.iso /dev/sdb</code>

:'''Note:''' In this example, your USB device would be sdb! Adjust this before confirming the command, if necessary. Also, you might want to increase the home or overlay size if you have more than 1 GB of space.
: More detailed information is available [[Sugar on a Stick/Linux|here]].
==== Mac Users ====

Mac users will need to have access to a Linux or Windows machine to prepare their USB flash drive.
# Create your SoaS as described above;
# Download the boot helper disk: http://download.sugarlabs.org/soas/releases/soas-boot.iso
# Put both the CD and the USB flash drive into the machine;
# Turn the Mac on and press at the chime the "C" key;
# It should boot from the CD and continue to use the USB flash drive from this point.
:'''Note:''' This is an experimental method to run SoaS on a Mac. Not all hardware configurations might be supported, as it is also noted in the [[#Known Issues]] section below. If you run into issues, you might want to consider using a virtual machine. See [[#XO-1 & VMs]] section below.
: More information is available [[Sugar on a Stick/Mac|here]].
==== XO-1 & VMs ====

The use of SoaS on the OLPC XO-1, as well as in virtual machines, is currently in an experimental state. Instructions for both categories are being developed here for [[Sugar on a Stick/Installation/OLPC|XO-1]], [[VirtualBox]], & [[VMware#Soas-Strawberry.iso_installed_to_VM_Hard_Disk|VMware]]. In the meantime, you might want to refer to the information on the general SoaS [[Sugar_on_a_Stick| wiki page]].

=== Boot it! ===

* Set the option to boot from USB in your machine's BIOS and let it come up
* If your machine doesn't support that, download and burn: http://download.sugarlabs.org/soas/releases/soas-boot.iso
* Make sure to name your USB flash drive FEDORA, as it won't be recognized otherwise
* Put both the CD and the USB flash drive in and let it boot from CD

=== Use it! ===

Once you have successfully launched Sugar on a Stick you should explore the Sugar Learning Platform. There is a [http://en.flossmanuals.net/sugar guide to Sugar] and help pages dedicated to most activities. (Do try running Sugar on more than one machine so you can enjoy its collaboration features.)

== Help Us ==

Please share your feedback with us; it will help us to improve Sugar in subsequent versions of SoaS. You can always send an e-mail to [mailto:feedback@sugarlabs.org feedback@sugarlabs.org] or join the ''<nowiki>It's an Education Project</nowiki>'' mailing list: http://lists.sugarlabs.org/listinfo/iaep. See all our [[Sugar Labs/Contacts|'''communication channels''']] and our [[Sugar Labs/Getting Involved|'''Getting Involved''']] pages.

If you encounter any hardware-related issues besides the ones [[#Known Issues|listed below]], please consider joining our [[Sugar_on_a_Stick/Hardware| hardware effort]]. Please submit the specifications of your hardware so that we work together with 'upstream' to resolve any issues.

Finally, you might also consider submitting bug reports at our [http://dev.sugarlabs.org/ bug tracker] (you would need to create an account).

=== Known Issues ===

Sugar on a Stick Strawberry is based on [http://www.fedoraproject.org/ Fedora 11], the latest release. Consequently, it contains a number of known issues with Fedora images that should be mentioned.
* Recently, problems with ATI graphics hardware, as well as various Mac models have been reported. This was resolved by adding the ''nomodeset'' parameter to the kernel arguments.
* If you encounter image flickering or are not able to get past a black screen, it might be worth pressing the <Escape> key at the blue screen, which appears for a second before the normal boot process starts. You'll be presented a short menu, at which you can directly press tab, then just add the ''nomodeset'' argument in the appearing line, and then boot by pressing the <Enter> key.
For more information, please refer to the [http://fedoraproject.org/wiki/Common_F11_bugs#Hardware-related_issues list of common F11 bugs].

=== Custom Builds ===

Preliminary instructions how to customize and compose an image can be found [[Sugar_on_a_Stick/Customization| here]].

VirtualBox

2009-06-24T22:01:31Z

Daveb:

{{TOCright}}
[[wikipedia:VirtualBox|VirtualBox]] is an x86 virtualization system available as either GPL or commercial software. It runs on either Win32 or Linux host machines, allowing you to run OLPC images within the virtual machine. The following instructions are mostly for VirtualBox OSE (Open Source Edition), which is available in packages in many Linux distributions. You can also download it and its documentation from the [http://www.virtualbox.org/ VirtualBox.org] Web site.

==Sugar on a Stick==
These are instructions for using a copy of Sugar on a Stick, configured to run in a VirtualBox® virtual appliance (a virtual machine disc image ready to run in the VirtualBox host application).

* Download http://www.sugarlabs.org/static/soas/soas-strawberry-vdi.zip (dated: 24 June 2009)
* Unzip the file you just downloaded and remember where you put it - you'll get a .vdi file.
* Follow the instructions below to get and configure the VirtualBox host application.

Please be aware of the fact that this is still beta quality and not at all ready for production use. You might want to create your own VirtualBox disc image from another snapshot or iso disc file. Instructions to do so are located here, [[VirtualBox/Preparing a disk image]].

You can also convert .img image files from [[QEMU | qemu]] formats, such as qcow2, to vmdk format, which VirtualBox can open. The qemu-img command usually detects the source image format automatically.

$ qemu-img convert -O vmdk file.img file.vmdk

* USB (2GB or larger) Boot Stick to run VirtualBox Images:
see:http://wiki.sugarlabs.org/go/VMware#Running_VMPlayer_and_an_Appliance_using_a_Single_8_GB_USB_Boot_Stick
Download VirtualBox OSE program and install instead of VMPlayer
Boot PC from stick and run images on same or 2nd stick.

==Install VirtualBox==
=== OS X ===
# Download VirtualBox for OS X from here, http://www.virtualbox.org/wiki/Downloads
# Install it by opening the DMG.
# Follow the instructions in the window
## Double click VirtualBox.mpkg
## If you see a warning about running a program from the internet click OK to run it.
## click continue until you see the license popup, click Agree.
## Choose location to install, probably something like Macintosh HD then click Continue.
## Click Continue, then Install. Enter password if required.
# Now you can run VirtualBox by opening the Applications folder and double clicking on the icon.

=== Windows ===

: Download from http://www.virtualbox.org/wiki/Downloads.

=== Linux ===
:See http://www.virtualbox.org/wiki/Linux_Downloads
:For Ubuntu, it is available in Synaptic Package Manager, once you add the the URI, distribution & components to your 3rd-party software sources or enter the following in your /etc/apt/sources.list.
deb <nowiki>http://download.virtualbox.org/virtualbox/debian</nowiki> <distribution> non-free

:Install '''dkms''', as well, so upgrades will update the kernel modules.

Ubuntu 8.04 Hardy: Use downloaded file from link above, Synaptic does not load
Virtual Box that works [satellit 05/08/2009]

==Setup a Virtual Machine for Sugar on a Stick==

# In VirtualBox click New
# Click Next
# Enter a name "Sugar"
# Operating System: choose Linux
# Version: choose Fedora
# Click Next
# For memory leave 256 MB
# Click Next
# Virtual Hard Disk click Existing
## A new window pops up
## Click Add button in the toolbar
## Browse to the location where you extracted the .vdi disk image
## Click Open
## Click Select
# Click Next
# Click Finish
# Select Sugar on the left
# Click Start in the toolbar
# After a minute or two you should see the Sugar screen asking for you name
# Enter your name
# Click Next.
# From now on you can start VirtualBox and start the "Sugar" virtual machine

==Mounting Drives==

===Hard Drives===

When booting from a CD image, with a hard drive image attached, you can mount the hard drive by creating an empty directory to mount it on. The form of the command is

$ mount -t ext3 /dev/sda1 /mnt/drive

for the first hard drive. The mount point can be anywhere you have permission to create a directory, although /mnt and ~/mnt are the usual choices.

This gives you a place to save files that cannot be written to CDs.

===USB===

USB access is not available in the Open Source Edition of VirtualBox.

In order to access USB storage devices, the user must have access to the usbfs file system. The permissions for usbfs can be changed by editing the /etc/fstab file.

For example, most Linux distributions have a user group called usb or similar, of which the current user must be a member. To give all users of that group access to usbfs, make sure the following line is present in /etc/fstab:

# 85 is the USB group
none /proc/bus/usb usbfs devgid=85,devmode=664 0 0

Replace 85 with the group ID that matches your system (search /etc/group for "usb" or similar).

After this, you should be able to mount real USB drives in the normal manner.

===Shared Directories===

In order to access a directory on your real hard drive, VirtualBox needs the Guest Additions installed.

Mount the VBoxGuestAdditions.iso file

Change to the directory where your CD-ROM drive is mounted and execute as root:

sh ./VBoxLinuxAdditions-x86.run

In a 64-bit Linux guest, use VBoxLinuxAdditions-amd64.run instead.

After this installation, you can create a share in the VirtualBox GUI, and mount it in somewhat the normal way, but with the vboxsf file system type.

mount -t vboxsf [-o OPTIONS] sharename mountpoint

==Resources==
* http://www.virtualbox.org/
* [[OLPC:VirtualBox]]
* [http://fedorasolved.org/Members/realz/VB_Guest_Addition How To Install Virtualbox Guest Additions in Fedora Guest]

[[Category:HowTo]]

VirtualBox

2009-06-24T22:01:16Z

Daveb:

{{TOCright}}
[[wikipedia:VirtualBox|VirtualBox]] is an x86 virtualization system available as either GPL or commercial software. It runs on either Win32 or Linux host machines, allowing you to run OLPC images within the virtual machine. The following instructions are mostly for VirtualBox OSE (Open Source Edition), which is available in packages in many Linux distributions. You can also download it and its documentation from the [http://www.virtualbox.org/ VirtualBox.org] Web site.

==Sugar on a Stick==
These are instructions for using a copy of Sugar on a Stick, configured to run in a VirtualBox® virtual appliance (a virtual machine disc image ready to run in the VirtualBox host application).

* Download http://www.sugarlabs.org/static/soas/soas-stawberry-vdi.zip (dated: 24 June 2009)
* Unzip the file you just downloaded and remember where you put it - you'll get a .vdi file.
* Follow the instructions below to get and configure the VirtualBox host application.

Please be aware of the fact that this is still beta quality and not at all ready for production use. You might want to create your own VirtualBox disc image from another snapshot or iso disc file. Instructions to do so are located here, [[VirtualBox/Preparing a disk image]].

You can also convert .img image files from [[QEMU | qemu]] formats, such as qcow2, to vmdk format, which VirtualBox can open. The qemu-img command usually detects the source image format automatically.

$ qemu-img convert -O vmdk file.img file.vmdk

* USB (2GB or larger) Boot Stick to run VirtualBox Images:
see:http://wiki.sugarlabs.org/go/VMware#Running_VMPlayer_and_an_Appliance_using_a_Single_8_GB_USB_Boot_Stick
Download VirtualBox OSE program and install instead of VMPlayer
Boot PC from stick and run images on same or 2nd stick.

==Install VirtualBox==
=== OS X ===
# Download VirtualBox for OS X from here, http://www.virtualbox.org/wiki/Downloads
# Install it by opening the DMG.
# Follow the instructions in the window
## Double click VirtualBox.mpkg
## If you see a warning about running a program from the internet click OK to run it.
## click continue until you see the license popup, click Agree.
## Choose location to install, probably something like Macintosh HD then click Continue.
## Click Continue, then Install. Enter password if required.
# Now you can run VirtualBox by opening the Applications folder and double clicking on the icon.

=== Windows ===

: Download from http://www.virtualbox.org/wiki/Downloads.

=== Linux ===
:See http://www.virtualbox.org/wiki/Linux_Downloads
:For Ubuntu, it is available in Synaptic Package Manager, once you add the the URI, distribution & components to your 3rd-party software sources or enter the following in your /etc/apt/sources.list.
deb <nowiki>http://download.virtualbox.org/virtualbox/debian</nowiki> <distribution> non-free

:Install '''dkms''', as well, so upgrades will update the kernel modules.

Ubuntu 8.04 Hardy: Use downloaded file from link above, Synaptic does not load
Virtual Box that works [satellit 05/08/2009]

==Setup a Virtual Machine for Sugar on a Stick==

# In VirtualBox click New
# Click Next
# Enter a name "Sugar"
# Operating System: choose Linux
# Version: choose Fedora
# Click Next
# For memory leave 256 MB
# Click Next
# Virtual Hard Disk click Existing
## A new window pops up
## Click Add button in the toolbar
## Browse to the location where you extracted the .vdi disk image
## Click Open
## Click Select
# Click Next
# Click Finish
# Select Sugar on the left
# Click Start in the toolbar
# After a minute or two you should see the Sugar screen asking for you name
# Enter your name
# Click Next.
# From now on you can start VirtualBox and start the "Sugar" virtual machine

==Mounting Drives==

===Hard Drives===

When booting from a CD image, with a hard drive image attached, you can mount the hard drive by creating an empty directory to mount it on. The form of the command is

$ mount -t ext3 /dev/sda1 /mnt/drive

for the first hard drive. The mount point can be anywhere you have permission to create a directory, although /mnt and ~/mnt are the usual choices.

This gives you a place to save files that cannot be written to CDs.

===USB===

USB access is not available in the Open Source Edition of VirtualBox.

In order to access USB storage devices, the user must have access to the usbfs file system. The permissions for usbfs can be changed by editing the /etc/fstab file.

For example, most Linux distributions have a user group called usb or similar, of which the current user must be a member. To give all users of that group access to usbfs, make sure the following line is present in /etc/fstab:

# 85 is the USB group
none /proc/bus/usb usbfs devgid=85,devmode=664 0 0

Replace 85 with the group ID that matches your system (search /etc/group for "usb" or similar).

After this, you should be able to mount real USB drives in the normal manner.

===Shared Directories===

In order to access a directory on your real hard drive, VirtualBox needs the Guest Additions installed.

Mount the VBoxGuestAdditions.iso file

Change to the directory where your CD-ROM drive is mounted and execute as root:

sh ./VBoxLinuxAdditions-x86.run

In a 64-bit Linux guest, use VBoxLinuxAdditions-amd64.run instead.

After this installation, you can create a share in the VirtualBox GUI, and mount it in somewhat the normal way, but with the vboxsf file system type.

mount -t vboxsf [-o OPTIONS] sharename mountpoint

==Resources==
* http://www.virtualbox.org/
* [[OLPC:VirtualBox]]
* [http://fedorasolved.org/Members/realz/VB_Guest_Addition How To Install Virtualbox Guest Additions in Fedora Guest]

[[Category:HowTo]]

Sugar on a Stick/Hardware

2009-05-27T17:54:28Z

Daveb:

{{TOCright}}
== A SoaS Hardware Effort ==

=== What's this about ===

This attempt has been started shortly after the SoaS beta release on April 22nd and is focussed on tracking hardware compatibility with newer SoaS versions. The overall goal of this effort is to gather information about issues with various hardware configurations using [[Sugar_on_a_Stick|SoaS]]. So if you just came across an issue or want to help us by providing your hardware specs, please follow these instructions.

=== What we're doing ===

We're using the [http://www.smolts.org Smolt] project to keep information about the various systems. Smolt is a hardware profiler and has been introduced with [http://fedoraproject.org/wiki/Releases/Smolt Fedora 7]. Since then, also openSUSE has joined the project. We're working on creating an identifier for SoaS in the Smolt database.

Smolt basically helps you to submit your hardware information to a place, where people like us developers can check them out. Smolt development is hosted [https://fedorahosted.org/smolt/ here] and if you're worried about your privacy, you can have a look at Smolt's [https://fedorahosted.org/smolt/wiki/PrivacyPolicy privacy policy] here. Note that you can remove your hardware information at any time - instructions for this are also listed below!

== Next Steps ==

So. What's next? Here're the instructions:

# First of all, you'll need to download SoaS, which already includes Smolt. Please use the latest snapshot and ''not'' the beta for this! Here's the direct link: {{SoaS-2 path}}
# Boot into SoaS and start the Terminal Activity.
# Now you're ready to submit your hardware specs. For this, just call (as root): ''smoltSendProfile''
# It will ask you again if you're sure and will also give you a link to your profile and an admin password then. Please keep those!

Now that you've received the link to your hardware profile, please add it to the table below, as this will help us a lot to get an overview on which hardware SoaS is used on where issues occur. Note that with your admin password, you'll be also able to rate your experience with SoaS regarding the hardware support on your profile page. You can also provide it if you're filing a bug report on [http://dev.sugarlabs.org dev.sl.o].

What if you want to remove your information?
:Just type in the terminal (again as root): ''smoltDeleteProfile''

* Consider also reporting observations of your testing here, [[Sugar on a Stick/Getting Involved/Testing]].

== Program Members ==

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
|-style="background:#787878; color: white;"
| '''name''' || '''smolt''' || '''notes'''
|-
| Sebastian Dziallas || http://www.smolts.org/client/show/pub_cf5334e9-3337-49cd-a7af-747b77bbdda1 ||
|-
| Tom Gilliard || http://www.smolts.org/client/show/pub_cf76bc48-7208-438b-a17a-6a6e94b8b230 ||
|-
| James Simmons || http://www.smolts.org/client/show/pub_9bd8878e-aefa-4304-ac55-c87738969fdd || used boot diskette, Browse wouldn't start.
|-
| Mathieu Bridon || http://www.smolts.org/client/show/pub_27aeaf15-0c96-45bf-b9db-01fe5772492c ||
|-
| Tom Gilliard || http://www.smolts.org/client/show/pub_ec31848d-9ef1-4d51-a7ce-17b7998113f2 ||no wireless
|-
| Luya Tshimbalanga || http://smolts.org/client/show/pub_922b7f43-db28-4c56-8107-c95516dc2c59 || Freeze when multiple activities are open, audio and video not working on Record and TamTam
|-
| Tom Gilliard ||http://www.smolts.org/client/show/pub_34858d7b-dda5-4fc0-bcca-57ade97d6048 ||Fedora 11 beta with Sugar Desktop wired
|-
| James Simmons || http://www.smolts.org/client/show/pub_3aab3f17-ab4f-4883-a152-de25125d86bc || used boot diskette, everything works, word highlighting on Read Etexts lags behind spoken words.
|-
| Eduardo NH Silva || http://www.smolts.org/client/show/pub_fe227e13-5847-494c-b96b-cfe2484aab90 || ok
|-
| Frederick Grose || http://www.smolts.org/client/show/pub_ae2467bf-9802-4dfe-9849-69922fd9082b || VirtualBox2.2.0 on Jackalope64 host
|-
| Tom Gilliard || http://www.smolts.org/client/show/pub_b69296a9-4326-465e-b3e2-99963dfe75c3 || Soas2-200905031329 Live USB Creator Dell 520n
|-
| Frederick Grose || http://www.smolts.org/client/show/pub_7618393d-bf0c-4227-901a-0bb3f5cfc982 || USB stick prepared with livecd-iso-to-disk.sh on SoaS running in VirtualBox2.2.0
|-
| Caroline Meeks Dell || http://www.smolts.org/client/show/pub_fa888e3a-3c29-44dc-b1cb-e28be354f9c5 ||
|-
| Walter Bender || http://www.smolts.org/client/show/pub_270553cf-91ed-495c-834c-521da796d345 || Magalâes Classmate: no sound
|-
| Frederick Grose || http://www.smolts.org/client/show/pub_ee2f82d0-f863-454f-9d72-b1ee60fb3c65 || USB stick prepared with LiveUSB-creator3.6.5 on Vista32
|-
| Elena Grandi || http://www.smolts.org/client/show/pub_a3bddcf4-644e-43dd-b0a1-b84b5c3b7201 || Soas2-200905031329.iso prepared with livecd-iso-to-disk.sh
|-
| Frederick Grose || http://www.smolts.org/client/show/pub_f2cf5101-8203-4941-be03-408deedd03e5 || soas-beta (0414) installed in VirtualBox2.2.2 disc on Win7-64 with onboard livecd-iso-to-disk
|-
| Tom Gilliard || http://www.smolts.org/client/show/pub_8b055063-0284-4dc3-99cc-ed3a3fb98e1a ||Fedora 11Preview Gnome with Sugar Desktop on Virtual box 2.2.2
|-
| Nicolas Thill || http://www.smolts.org/client/show/pub_3f863f30-dc41-4cc9-b236-8ab41295da00 || Lenovo X61 running SoaS release 1 (snapshot)
|-
| Dave Bauer || http://www.smolts.org/client/show/pub_56a19e3b-42b9-4e2e-9461-09e674f431e5 || Asus eeePC 901 SoaS 20090524 LiveUSB Creator from F11 Preview
|-
| <your name here> || <your smolt link here> || <your comments here>
|- 
|} 

== Upcoming Improvements ==

We're working on getting Smolt integrated in a Sugar Activity to ease the process of submitting the information.

VirtualBox

2009-04-20T18:06:44Z

Daveb:

These are instructions for using a copy of Sugar on a Stick, configured to run in virtual environments.

* Download http://www.sugarlabs.org/static/soas/soas-beta-1.zip
* Unzip the file you just downloaded and remember where you put it - you'll get a .vdi file.
* Follow the instructions below to get and configure VirtualBox.

Please be aware of the fact that this is still alpha quality and not at all ready for production use. You might want to create your own image, though. Probably obsolete instructions to do so are located [[Sugar_on_a_Stick/VirtualBox/Preparing_a_disk_image|here]].

==Install VirtualBox==
=== OS X ===
# Download VirtualBox for OS X from here, http://www.virtualbox.org/wiki/Downloads
# Install it by opening the DMG.
# Follow the instructions in the window
## Double click VirtualBox.mpkg
## If you see a warning about running a program from the internet click OK to run it.
## click continue until you see the license popup, click Agree.
## Choose location to install, probably something like Macintosh HD then click Continue.
## Click Continue, then Install. Enter password if required.
# Now you can run VirtualBox by opening the Applications folder and double clicking on the icon.

=== Windows ===

: Download from http://www.virtualbox.org/wiki/Downloads.

=== Linux ===
:See http://www.virtualbox.org/wiki/Linux_Downloads
:For Ubuntu, it is available in Synaptic Package Manager, once you add the the URI, distribution & components to your 3rd-party software sources or enter the following in your /etc/apt/sources.list.
deb <nowiki>http://download.virtualbox.org/virtualbox/debian</nowiki> <distribution> non-free

:Install '''dkms''', as well, so upgrades will update the kernel modules.

==Setup a Virtual Machine for Sugar on a Stick==

# In VirtualBox click New
# Click Next
# Enter a name "Sugar"
# Operating System: choose Linux
# Version: choose Fedora
# Click Next
# For memory leave 256 MB
# Click Next
# Virtual Hard Disk click Existing
## A new window pops up
## Click Add button in the toolbar
## Browse to the location where you extracted the .vmdk disk image
## Click Open
## Click Select
# Click Next
# Click Finish
# Select Sugar on the left
# Click Start in the toolbar
# After a minute or two you should see the Sugar screen asking for you name
# Enter your name
# Click Next.
# From now on you can start VirtualBox and start the "Sugar" virtual machine

[[Category:HowTo]]

Sugar on a Stick Parallels

2009-03-13T00:03:26Z

Daveb:

At the pilot school for SoaS in Boston all the teachers have Apple laptops. We expect the most convenient way for the teachers to run Sugar will be as an emulation of their existing laptop.

These are instructions for using a copy of Sugar on a Stick configured to run in Parallels. It is a Parallels disk image created from SoaS that allows saving changes and includes Parallels Tools which allows 1024x768 resolution.

First download the parallels disk image () then unzip this file and remember where you put it. While you are waiting for SoaS to download you can set up Parallels.

'''Note:''' Parallels is for Intel-based Macs.

==Install Parallels==
=== OS X ===
# Download Parallels for OS X from here, http://www.parallels.com/download/ It is not free, but you can download a two week free trial.
# Install it by opening the DMG.
# Follow the instructions in the window

==Setup a Virtual Machine for Sugar on a Stick==

# Start Parallels
# If you see the "Welcome to Parallels Desktop" screen click Import Virtual machines.
# If you don't see the welcome screen, click File -> Open.
# Navigate to the folder where you unzipped the download.
# Choose SoaS1-200903051021.pvm and click Open.
# Now you are ready to use it. Click Start button in the window to start up Sugar.

Sugar on a Stick Parallels

2009-03-12T21:27:39Z

Daveb: New page: At the pilot school for SoaS in Boston all the teachers have apple laptops. We expect the most convenient way for the teachers to run Sugar will be as an emulation of their existing laptop...

Activities

2009-03-12T15:37:13Z

Daveb:

<noinclude>{{ GoogleTrans-en | es =show | bg =show | zh-CN =show | zh-TW =show | hr =show | cs =show | da =show | nl =show | fi =show | fr =show | de =show | el =show | hi =show | it =show | ja =show | ko =show | no =show | pl =show | pt =show | ro =show | ru =show | sv =show }}</noinclude>{{Translations}}

== Activities ==
Sugar applications are called [[Activities]]. This is a list of some Activities that are installed by default. http://activities.sugarlabs.org is a portal for activities.

<div style="float:left">
__TOC__
</div>

<table border="0">
<tr>
<td width="33%" style="text-align: center;">
[[Image:activity-journal.png|40px]]
 Journal 
Object and activity browser
</td>

<td width="33%" style="text-align: center;">
[[Image:activity-pippy.png|40px]]
 Pippy 
Python Programming language/environment
</td>

<td width="33%" style="text-align: center;">

[http://sugarlabs.org/go/Activities/Browse http://sugarlabs.org/wiki/images/c/c6/Activity-web.png]
 [[Activities/Browse|Browse]] 
Web browser based on Mozilla Firefox

</td>
</tr>

<tr>
<td width="33%" style="text-align: center;">
[[Image:activity-etoys.png|40px]]
 [[Activities/Etoys|Etoys]] 
Learning / programming / authoring environment
</td>

<td width="33%" style="text-align: center;">
[[Image:activity-read.png|40px]]
 Read 
Book/PDF reader
</td>

<td width="33%" style="text-align: center;">

[http://sugarlabs.org/go/Activities/Turtle_Art http://sugarlabs.org/wiki/images/c/cb/Activity-turtleart-40.png]
 [[Activities/Turtle Art|Turtle Art]] 
Pseudo-Logo graphical programming language

</td>
</tr>

<tr>
<td width="33%" style="text-align: center;">
[[Image:activity-write.png|40px]]
 Write 
Word processor</td>

<td width="33%" style="text-align: center;">
[[Image:activity-calculate.png|40px]]
 Calculate 
Basic calculator
</td>

<td width="33%" style="text-align: center;">
[[Image:activity-news.png|40px]]
 News Reader 
News reader
</td>
</tr>

<tr>
<td width="33%" style="text-align: center;">
[[Image:activity-measure.png|40px]]
 Measure 
Oscilloscope and Data Logging
</td>

<td width="33%" style="text-align: center;">
[[Image:activity-draw.png|40px]]
 Paint 
Simple paint activity
</td>

<td width="33%" style="text-align: center;">
[[Image:activity-acousticmeasure.png|40px]]
 Distance 
Measure distance between two laptops
</td>
</tr>

<tr>
<td width="33%" style="text-align: center;">
[[Image:activity-record.png|40px]]
 Record 
Still, video, and audio capture
</td>

<td width="33%" style="text-align: center;">
[[Image:activity-analyze.png|40px]]
 Analyze 
An activity version of the Sugar analyze tool
</td>

<td width="33%" style="text-align: center;">
[[Image:activity-log.png|40px]]
 Log 
An activity version of the Sugar logging tool
</td>
</tr>

<tr>
<td width="33%" style="text-align: center;">
[[Image:activity-terminal.png|40px]]
 Terminal 
An activity version of the Sugar terminal
</td>

<td width="33%" style="text-align: center;">
[[Image:activity-tamtamjam.png|40px]]
 TamTam 
Music composition and synthesis.
</td>

<td width="33%" style="text-align: center;">
 And more 
* http://addons.sugarlabs.org is a site for browsing, recommending activities.
* [[olpc:Activities/All]] lists many more.
</td>
</tr>

</table>

[[Category:Activity]]

=Running Linux Applications Under Sugar=

There are two ways to run Linux applications as Activities under Sugar (meaning you don't need to use Terminal to load them):
*'''Sugar Coating''' - Making Linux apps run under Sugar, but not modifying them to take advantage of Sugar's collaborative capabilities
*'''Sugarizing''' - A fully integrated Linux application, re-engineered to take advantage of Sugar's advanced collaboration abilities

===Sugar Coating Activities===

To run Linux apps under Sugar (i.e. making them to run in the Sugar interface, without the collaboration and other Sugar integration programmed into them), read these instructions on [[Running Linux Applications Under Sugar]].

In the future, we hope that Sugar will be able to run Linux applications natively without these steps.

===Sugarizing Activities===

See [[ActivityTeam]] for information on porting regular applications to run as native Sugar activities.

=Useful Linux Applications=

===VLC Media Player===
The VLC media player is a highly portable multimedia player for various audio and video formats (MPEG-1, MPEG-2, MPEG-4, DivX, mp3, flv, avi, ogg, ...) as well as DVDs, VCDs, and various streaming protocols. It can also be used as a server to stream in unicast or multicast in IPv4 or IPv6 on a high-bandwidth network.; the VLC Player is considered to be better by some users then MPlayer because it offer more settings, options and features. There is also no need to run it from Terminal. Read [[Activity_VLC]] to learn how to install it.

===Seamonkey===
SeaMonkey has inherited the successful all-in-one concept of the original Netscape Communicator and continues that product line based on the modern, cross-platform architecture provided by the Mozilla project.

* The Internet browser at the core of the SeaMonkey suite uses the same rendering engine as its sibling Mozilla Firefox, with popular features like tabbed browsing, popup blocking, find as you type and a lot of other functionality for a smooth web experience.
* SeaMonkey's Mail and Newsgroups client shares lots of code with Mozilla Thunderbird and features adaptive Junk mail filtering, labels and mail views, multiple accounts, S/MIME, address books with LDAP support and is ready for both private and corporate use.
* Additonal components include an easy-to-use HTML Editor, the ChatZilla IRC chat application and web development tools like a DOM Inspector and a JavaScript debugger.
* If that's still not enough, SeaMonkey can be extended with numerous Add-Ons that provide additional functionality and customization for a complete Internet experience.

Seamonkey can be Sugar-coated.

===Midnight Commander===
Midnight Commander is a text-mode file manager. It is easily Sugar-coated for access from the Activities panel.[http://www.ibiblio.org/mc/images/mc-panels.png Screenshot]

===Totem Media Player===
The Totem media player is already installed in the OLPC XO-1. It is the engine that supports media on the system. Out of the box it does not support MP3 music or MPEG-4 video. A free driver can be downloaded to add MP3 compatability. A Sugar-coating can be applied to easily access the program from the Activities panel.

===[http://tux4kids.alioth.debian.org/ Tux4Kids]===
;TuxType2: [http://tuxtype.sourceforge.net/ TuxType] is a touch typing tutorial/game than can be installed on the OLPC XO-1 using the yum command. A Sugar-coating can be applied to easily access the program from the Activities panel.
;TuxMath: [http://tux4kids.alioth.debian.org/tuxmath.php TuxMath] is an arcade game that helps kids practice their math facts. A Sugar-coating can be applied to easily access the program from the Activities panel.
;TuxPaint: [http://www.tuxpaint.org/ Tux Paint] is a drawing program for children ages 3 to 12. It combines an easy-to-use interface, fun sound effects, and an encouraging cartoon mascot who guides children as they use the program. A Sugar-coating can be applied to easily access the program from the Activities panel.

-----

(Let's try to organize this page based on some criteria of completion as per the discussion in [[Talk:{{PAGENAME}}]].)

VirtualBox

2009-02-05T22:31:34Z

Daveb:

At the pilot school for SoaS in Boston all the teachers have apple laptops. We expect the most convenient way for the teachers to run Sugar will be as an emulation of their existing laptop.

These are instructions for using a copy of Sugar on a Stick configured to run in VirtualBox. It is a VirtualBox disk image created from SoaS-7 that allows saving changes and includes VirtualBox Guest Additions which allows 1024x768 resolution.

First download the virtualbox disk image http://sugarlabs.org/static/soas-7-vbox.zip (md5sum 4f9f29cfc88d61e7686b872897840aae) then unzip this file and remember where you put it. While you are waiting for SoaS to download you can set up Virtual Box

===Setup Virtual Box on OS X===
1. Download virtualbox for OS X http://download.virtualbox.org/virtualbox/2.1.0/VirtualBox-2.1.0-41146-OSX_x86.dmg
2. Install it by opening the DMG.
3. Follow the instructions in the window
1. Double click VirtualBox.mpkg
2. If you see a warning about running a program from the internet click OK to run it.
3. click continue until you see the license popup, click Agree.
4. Choose location to install, probably something like Macintosh HD then click Continue.
5. Click Continue, then Install. Enter password if required.
4. Now you can run VirtualBox by opening the Applications folder and double clicking on the icon.

===Setup VirtualBox on Linux or Windows===

Download VirtualBox http://www.virtualbox.org/wiki/Downloads

===Setup Virtual Machine for Sugar on a Stick===

1. In VirtualBox click New
2. click Next.
3. Enter a name "Sugar"
4. Operating System: choose Linux
5. Version: choose Fedora
6. click Next.
7. For memory leave 256 MB then click Next.
8. Virtual Hard Disk click Existing
1. a new window pops up
2. click Add button in the toolbar
3. browse to the location where you downloaded the disk image
4. click Open
5. click Select
9. click Next
10. click Finish
11. select Sugar in the left then click Start in the toolbar
12. after a minute or two you should see the sugar screen asking for you name. Enter your name and click Next.
13. From now on you can start Virtualbox and start the Sugar install.

VirtualBox

2009-02-05T21:12:17Z

Daveb:

At the pilot school for SoaS in Boston all the teachers have apple laptops. We expect the most convenient way for the teachers to run Sugar will be as an emulation of their existing laptop.

These are instructions for using a copy of Sugar on a Stick configured to run in VirtualBox. It is a VirtualBox disk image created from SoaS-7 that allows saving changes and includes VirtualBox Guest Additions which allows 1024x768 resolution.

First download the virtualbox disk image http://solutiongrove.com:8080/soas-7-vbox.zip then unzip this file and remember where you put it. While you are waiting for SoaS to download you can set up Virtual Box

===Setup Virtual Box on OS X===
1. Download virtualbox for OS X http://download.virtualbox.org/virtualbox/2.1.0/VirtualBox-2.1.0-41146-OSX_x86.dmg
2. Install it by opening the DMG.
3. Follow the instructions in the window
1. Double click VirtualBox.mpkg
2. If you see a warning about running a program from the internet click OK to run it.
3. click continue until you see the license popup, click Agree.
4. Choose location to install, probably something like Macintosh HD then click Continue.
5. Click Continue, then Install. Enter password if required.
4. Now you can run VirtualBox by opening the Applications folder and double clicking on the icon.

===Setup VirtualBox on Linux or Windows===

Download VirtualBox http://www.virtualbox.org/wiki/Downloads

===Setup Virtual Machine for Sugar on a Stick===

1. In VirtualBox click New
2. click Next.
3. Enter a name "Sugar"
4. Operating System: choose Linux
5. Version: choose Fedora
6. click Next.
7. For memory leave 256 MB then click Next.
8. Virtual Hard Disk click Existing
1. a new window pops up
2. click Add button in the toolbar
3. browse to the location where you downloaded the disk image
4. click Open
5. click Select
9. click Next
10. click Finish
11. select Sugar in the left then click Start in the toolbar
12. after a minute or two you should see the sugar screen asking for you name. Enter your name and click Next.
13. From now on you can start Virtualbox and start the Sugar install.

VirtualBox

2008-12-19T20:26:43Z

Daveb: Initial page for setting up sugar on a stick with virtualbox

These are instructions for using a copy of Sugar on a Stick configured to run in VirtualBox. It is a VirtualBox disk image created from SoaS-7 that allows saving changes and includes VirtualBox Guest Additions which allows 1024x768 resolution.

First download the virtualbox disk image http://solutiongrove.com/soas-7-vbox.zip then unzip this file and remember where you put it. While you are waiting for SoaS to download you can set up Virtual Box

===Setup Virtual Box on OS X===
1. Download virtualbox for OS X http://download.virtualbox.org/virtualbox/2.1.0/VirtualBox-2.1.0-41146-OSX_x86.dmg
2. Install it by opening the DMG.
3. Follow the instructions in the window
1. Double click VirtualBox.mpkg
2. If you see a warning about running a program from the internet click OK to run it.
3. click continue until you see the license popup, click Agree.
4. Choose location to install, probably something like Macintosh HD then click Continue.
5. Click Continue, then Install. Enter password if required.
4. Now you can run VirtualBox by opening the Applications folder and double clicking on the icon.

===Setup VirtualBox on Linux or Windows===

Download VirtualBox http://www.virtualbox.org/wiki/Downloads

===Setup Virtual Machine for Sugar on a Stick===

1. In VirtualBox click New
2. click Next.
3. Enter a name "Sugar"
4. Operating System: choose Linux
5. Version: choose Fedora
6. click Next.
7. For memory leave 256 MB then click Next.
8. Virtual Hard Disk click Existing
1. a new window pops up
2. click Add button in the toolbar
3. browse to the location where you downloaded the disk image
4. click Open
5. click Select
9. click Next
10. click Finish
11. select Sugar in the left then click Start in the toolbar
12. after a minute or two you should see the sugar screen asking for you name. Enter your name and click Next.
13. From now on you can start Virtualbox and start the Sugar install.

Sugar on a Stick

2008-12-19T20:22:00Z

Daveb: Add link to virtualbox

==About Sugar on a Stick (SoaS) ==

[[Image:Soas.jpg|thumb]]

The goal of the Sugar on a Stick project is to give children access to *their* Sugar on any computer in their environment with just a USB key.

We are still in preAlpha on this project. It is not ready to use with children yet.

===Creating a USB Stick===

The basics of creating a Live, bootable USB are you download a '.iso' image. Then you use a USB creator program to copy it to a USB, create a space for users to store files on the USB (if required) and set it to be bootable.

In practice this means the first thing you need is a Live USB creator.

We are working with live USBs based on both Fedora and Ubuntu (these are different distributions of Linux), you can try either or both.

If you are helping us with testing, please be sure to use one of the Sugar .iso's from this page. Please keep notes on which you got and when. Please report bugs to dev.sugarlabs.org and finally, please join the Moodle Class where we are coordinating testing. http://schools.sugarlabs.org/course/view.php?id=17

This is still in testing, its not ready for production use yet.

====Fedora based Sugar on a Stick from Windows====

To create a Fedora based Sugar from a Windows machine: https://fedorahosted.org/releases/l/i/liveusb-creator/liveusb-creator-3.0.zip [http://sdz.fedorapeople.org/olpc/liveusb-creator-3.0.zip broken link??]

Download that file to a windows machine and install it. (I couldn't get it to run in wine... --[[User:Walter|Walter]] 17:40, 3 December 2008 (UTC))

Next download current version of Sugar that we are testing for Sugar on a Stick:

http://download.sugarlabs.org/soas/soas-7.iso

#Plug in a 1GB or larger USB stick into your computer.
#Open "liveusb-creator.exe"
#Use "Browse" to select the iso file that you just downloaded.
#Set the Target Device to your USB device
#Move the slider to set some persistent storage (hint, set it high then it will tell you how much space there is and you can adjust it to the right point)
#Click "Create Live USB". It will take a few minutes.

How much persistent memory you set will depend on the size of the .iso and the size of your USB but make sure you have some so people can save files.

====Ubuntu based Sugar on a Stick====

* Detailed instructions are here: http://dev.laptop.org/~probono/sbuntu/ and in [[Sugar on a Stick Ubuntu]]

===Using Sugar on a Stick===

The trick is to set the BIOS to boot from USB. Unfortunately this is slightly different on each computer. Try Google on BIOS your computer model and explore the setup screen for your system.

If you have trouble try creating a "Boot Helper" CD using the .iso below. This will start the boot from the CD then read files from the USB.

http://www.sugarlabs.org/~marco/boot.iso

You can also use the 'PLoP Boot Manager' to create a boot floppy for machines without the ability to boot from CD or USB, see http://syslinux.zytor.com/wiki/index.php/No_native_BIOS_support

===VirtualBox and Sugar on a Stick===

Instructions for using a preconfigured VirtualBox disk image with Sugar on a Stick [[Sugar on a Stick VirtualBox]]

===Join the development effort===

We are coordinating work on this project on Sugar Labs Moodle system. Please create an account and join the Sugar on a Stick Class. http://schools.sugarlabs.org/course/view.php?id=17

====Report Sugar on a Stick Bugs====

Use the Sugar Trac system at http://dev.sugarlabs.org to report bugs. Use the "SoaS" component.

===Project Goals===

* Sugar on a Stick as 1 to 1 computing in an elementary school
* Sugar on a Stick to empower middle and high school students to help test [[Sugar as Service Learning]]
* Sugar on a Stick for conferences to let people try Sugar and collaborate with other conference participants

=== See Also ===
*[[DeploymentTeam/School_Key]]