Changes

Jump to navigation Jump to search

Sugar on a Stick/Blueberry (view source)

Revision as of 00:46, 17 August 2011

188 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"/>
   −
Please select your operating system by clicking on one of the icons below. Starting with Sugar on a Stick v2 Blueberry, Mac OS X operating systems, OLPC's XO-1 models and virtual appliances are additionally supported.
+
== Get It! ==
   −
'''Windows:''' [[Image:Windows.gif|link=Sugar on a Stick/Blueberry#Windows_Users]]
+
{{:SoaS_Blueberry_Instructions}}
−
'''Mac OS X:''' [[Image:Apple.gif|link=Sugar on a Stick/Blueberry#Mac_Users]]
  −
'''GNU/Linux:''' [[Image:Gnulinux.png|link=Sugar on a Stick/Blueberry#GNU.2FLinux_Users]]
  −
'''OLPC XO-1:''' [[Image:OLPCXO.png|link=Sugar on a Stick/Blueberry#XO_Users]]
  −
'''Virtual Appliance:''' [[Image:Gear.png|link=Sugar on a Stick/Blueberry#Appliance_Users]]
     −
==== Windows Users ====
+
== Get Help! ==
   −
:'''TODO:''' add screenshots (we'll use the .iso file here)
+
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.
   −
# Download the latest version of Fedora ''LiveUSB Creator'' from http://fedorahosted.org/liveusb-creator/ and extract it;
+
* Development discussions take place on the [http://lists.sugarlabs.org/listinfo/soas Sugar on a Stick (SoaS) mailing list].
−
# Plug a target USB flash drive into your computer (minimum 1-gigabyte);
+
* Go to the [http://lists.sugarlabs.org/listinfo/iaep ''It's an Education Project'' mailing list] for general discussions.
−
# 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 ====
+
For general questions about Sugar, you may want to start with our user manual:
   −
:'''TODO:''' we'll use image-writer here (requires 2-gig key)
+
* http://flossmanuals.net/Sugar, and
 +
* http://wiki.sugarlabs.org/go/The_Undiscoverable
   −
# Download the ''Sugar on a Stick (Blueberry)'' live image from here: '''TODO:''' add link to pre-partitioned image
+
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 ''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 ====
+
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.)
   −
:'''TODO:''' need to add and test instructions here
+
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:
−
:'''NOTE:''' While the following method allows you to prepare a Sugar on a Stick flash drive on your Mac, it does not guarantee that you will be able to boot it on the same machine. In this case, you might want to try booting it with our boot helper ('''TODO:''' add link) or using a virtual appliance ('''TODO:''' add link).
     −
# Download the ''Sugar on a Stick (Blueberry)'' live image from here: '''TODO:''' add link to pre-partitioned image
+
* [https://answers.launchpad.net/soas/+question/84994 Cannot boot from USB flash drive]
−
# Open a terminal and run <code>diskutil unmountDisk /dev/diskX</code> (whereas X is the devices number)
+
* [https://answers.launchpad.net/soas/+faq/746 Wireless isn't working properly]
−
# Run <code>sudo dd if=/path/to/downloaded.img of=/dev/diskX bs=1024</code> ('''NOTE:''' This will wipe your flash drive entirely!)
+
* [https://answers.launchpad.net/soas/+question/83772 Sugar on a Stick doesn't save anything?]
−
# Eject your flash drive by running: <code>diskutil eject /dev/diskX</code>
+
* [[#ZyX-LiveInstaller|How do I install Sugar onto my computer's hard drive?]][http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]
   −
==== XO Users ====
+
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]].
   −
:'''TODO:''' need instructions (NAND install)
+
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:
   −
==== Appliance Users ====
+
* 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
   −
:'''TODO:''' need instructions, too
+
== Bugs ==
 +
Please file bug reports in [http://bugs.sugarlabs.org The Sugar on a Stick bug tracker].
 +
* Here are [[BugSquad/Bug Report|some instructions for using the bug tracker]].
 +
* 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/39966...68220"

Navigation menu