Sugar Labs

Changes

Sugar on a Stick/Blueberry (view source)

Revision as of 00:46, 17 August 2011

1,007 bytes added ,  00:46, 17 August 2011
no edit summary
Line 2: Line 2:  
[[Category:Live USB]]
 
[[Category:Live USB]]
 
</noinclude>
 
</noinclude>
−
[[Image:SugarLabs3x.jpg|right|a Sugar environment you can carry in your pocket!]]
+
<div style="font-size: smaller" align="right">released 03 December 2009</div>
 +
[[File:SugaronastickBlueberry.png|450px|right|a Sugar environment you can carry in your pocket!|link=http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso]]
 +
[[File:Logo_SoaS_02.png|200px|link=http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso]][http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Blueberry]
 +
 
 +
{{Note/note||Sugar on a Stick v2 '''Blueberry''' has been superseded by the [[Sugar on a Stick/Mirabelle|Mirabelle]] release as of 25 May 2010. See [[Sugar on a Stick/Downloads]] for the most current version.}}
    
== Sugar on a Stick - Blueberry ==
 
== Sugar on a Stick - Blueberry ==
−
: ''a Sugar environment you can carry in your pocket - '''this is a draft - work in progress'''''
     −
:'''TODO:''' new splash image is needed
+
: ''a Sugar environment you can carry in your pocket''
−
:'''TODO:''' work website content out
  −
:'''TODO:''' add further instructions
      
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.
 
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.
   −
=== Get it! ===
+
If you want to proceed directly to downloading, please select your operating system here by clicking on one of the icons below. You might also want to read through the [[Sugar_on_a_Stick/Blueberry#What's_New?|release notes]].
 +
 
 +
'''Choose your operating system:'''<br>
 +
[[Image:Windows.gif|link=Sugar on a Stick/Blueberry#For_Windows_Users]] |
 +
<span class="linkgroup">[[Image:Gnulinux.png|link=Sugar_on_a_Stick/Blueberry#For_GNU.2FLinux_Users]]</span> |
 +
[[Image:Apple.gif|link=Sugar_on_a_Stick/Blueberry#For_Mac_OS_X_Users]]
 +
 
 +
'''Note:''' Andrew Brookes has created an illustrated guide (with step-by-step screen shots) of the SoaS-creation process (See http://www.nkran.net/sugar_install.jsp).
 +
 
 +
== What's New? ==
 +
 
 +
{{:SoaS_Blueberry_Notes}}
 +
 
 +
<br clear="all"/>
 +
 
 +
== Get It! ==
 +
 
 +
{{:SoaS_Blueberry_Instructions}}
 +
 
 +
== Get Help! ==
 +
 
 +
While we hope that Sugar on a Stick works flawlessly for you, if you do run into any problems, there are several forums for seeking help.
   −
Please select your operating system by clicking on one of the icons below.
+
* Development discussions take place on the [http://lists.sugarlabs.org/listinfo/soas Sugar on a Stick (SoaS) mailing list].
 +
* Go to the [http://lists.sugarlabs.org/listinfo/iaep ''It's an Education Project'' mailing list] for general discussions.
   −
[[Image:Windows.gif|link=Sugar on a Stick/Blueberry#Windows_Users]]
+
For general questions about Sugar, you may want to start with our user manual:
−
[[Image:Apple.gif|link=Sugar on a Stick/Blueberry#Mac_Users]]
  −
[[Image:Gnulinux.png|link=Sugar on a Stick/Blueberry#GNU.2FLinux_Users]]
     −
==== Windows Users ====
+
* http://flossmanuals.net/Sugar, and
 +
* http://wiki.sugarlabs.org/go/The_Undiscoverable
   −
:'''TODO:''' add screenshots (we'll use the .iso file here)
+
We also have a [[Sugar_help|help page]], [http://lists.sugarlabs.org mailing lists], this [[Welcome_to_the_Sugar_Labs_wiki|wiki]], and an IRC channel: irc.freenode.net #sugar (See [[Sugar_Labs/Resources/How_to_Attend_a_Meeting|help using IRC]]).
   −
# Download the latest version of Fedora ''LiveUSB Creator'' from http://fedorahosted.org/liveusb-creator/ and extract it;
+
We welcome feedback! Send e-mail to feedback AT sugarlabs DOT org (which will post your email to the ''It's an Education Project'' mailing list.)
−
# Plug a target USB flash drive into your computer (minimum 1-gigabyte);
  −
# Launch ''LiveUSB Creator'';
  −
# Select ''Sugar on a Stick (Blueberry)'' in the drop-down menu on the upper-right side of the ''LiveUSB Creator'' window;
  −
# Set the ''Persistent Storage'' slider to the maximum so you can save your Sugar work onto the USB device;
  −
#:(You may allocate as much storage as there is capacity on your device.  You may allocate less than the maximum, if you want to use some of the device storage when not booting Sugar.)
  −
#: If you repeat this installation on a device after having saved some Sugar work or changes, all Sugar work and changes will be lost.
  −
# Select your USB flash drive as the target;
  −
# Click the ''Create Live USB'' button and then wait for the process to finish (the time required will depend mostly on your download speed);
  −
# Close the ''LiveUSB Creator'' program;
  −
# When ejecting the USB flash drive from the computer, first stop the device with the ''Safely Remove Hardware'' dialog.
     −
==== GNU/Linux Users ====
+
Historically, several questions have been answered at this [http://answers.launchpad.net/soas SoaS community bug-tracking portal]. There you will find answers to frequently asked questions, such as:
   −
:'''TODO:''' we'll use image-writer here (requires 2-gig key)
+
* [https://answers.launchpad.net/soas/+question/84994 Cannot boot from USB flash drive]
 +
* [https://answers.launchpad.net/soas/+faq/746 Wireless isn't working properly]
 +
* [https://answers.launchpad.net/soas/+question/83772 Sugar on a Stick doesn't save anything?]
 +
* [[#ZyX-LiveInstaller|How do I install Sugar onto my computer's hard drive?]][http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]
   −
# Download the ''Sugar on a Stick (Blueberry)'' live image from here: '''TODO:''' add link to pre-partitioned image
+
As of 04 February 2010, bugs should be filed at http://bugs.sugarlabs.org under the SoaS component ([http://lists.sugarlabs.org/archive/soas/2010-February/000765.html announcement]). See [[Sugar_on_a_Stick/Blueberry#Bugs|Bugs below]].
−
# Download the ''image-writer'' tool from here: '''TODO:''' grab working version and put it on dl.sl.o ([http://git.moblin.org/cgit.cgi/moblin-image-creator/plain/image-writer direct link])
  −
# Open a terminal and become root, either by using ''su'' or ''sudo'' (the latter one each time on the next commands).
  −
# If necessary, unmount your flash drive by running: <code>umount /dev/sdX</code> (whereas X is the devices number)
  −
# Enter the following command: <code>./image-writer soas-2-blueberry.img</code> '''TODO:''' check filename
  −
# The script will output a device name; confirm that this matches with your flash drive.
  −
# You will be notified once the process has finished, while you can also check the ETA for reference.
     −
==== Mac Users ====
+
Sugar on a Stick (Blueberry) is based on Fedora 12 and consequently uses Fedora for device support, e.g., wireless support. There is additional help available for Fedora:
   −
:'''TODO:''' need to add and test instructions here
+
* http://fedorasolved.org/ is a "how to" website for Fedora
 +
* http://fedoramobile.org/ is a great place to learn more about wireless support on Fedora
   −
# Download the ''Sugar on a Stick (Blueberry)'' live image from here: '''TODO:''' add link to pre-partitioned image
+
== Bugs ==
−
# Open a terminal and run <code>diskutil unmountDisk /dev/diskX</code> (whereas X is the devices number)
+
Please file bug reports in [http://bugs.sugarlabs.org The Sugar on a Stick bug tracker].
−
# Run <code>sudo dd if=/path/to/downloaded.img of=/dev/diskX bs=1024</code> ('''NOTE:''' This will wipe your flash drive entirely!)
+
* Here are [[BugSquad/Bug Report|some instructions for using the bug tracker]].
−
# Eject your flash drive by running: <code>diskutil eject /dev/diskX</code>
+
* This link will [https://bugs.sugarlabs.org/query?component=SoaS&status=accepted&status=assigned&status=new&status=reopened query the database for all tickets designated with the SoaS component/tag].
 +
* You must [https://bugs.sugarlabs.org/register register an account] to enter new bugs.
 +
* This link will take you to a [http://bugs.sugarlabs.org/newticket?component=SoaS new bug/ticket form for SoaS] (once you are logged in).
Retrieved from "https://wiki.sugarlabs.org/go/Special:MobileDiff/39965...68220"