8,288
edits
Changes
Jump to navigation
Jump to search
Line 2:
Line 2: − + + + + + − : ''a Sugar environment you can carry in your pocket - '''this is a draft - work in progress''''' − + − :'''TODO:''' work website content out − :'''TODO:''' add further instructions − + + + + + + + + + + + + − 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.+ − '''Windows:''' [[Image:Windows.gif|link=Sugar on a Stick/Blueberry#Windows_Users]]+ − '''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 ====+ − :'''TODO:''' add screenshots (we'll use the .iso file here)+ − # 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); − # 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 ====+ + − + − # Download the ''Sugar on a Stick (Blueberry)'' live image from here: '''TODO:''' add link to pre-partitioned image+ − # 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 ====+ − :'''TODO:''' need to add and test instructions here+ − :'''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+ − # Open a terminal and run <code>diskutil unmountDisk /dev/diskX</code> (whereas X is the devices number) − # Run <code>sudo dd if=/path/to/downloaded.img of=/dev/diskX bs=1024</code> ('''NOTE:''' This will wipe your flash drive entirely!) − # Eject your flash drive by running: <code>diskutil eject /dev/diskX</code> − ==== XO Users ====+ + + + − + − ==== Appliance Users ====+ − + + − # Download and extract the ''Sugar on a Stick (Blueberry)'' virtual appliance from here: '''TODO:''' add link to virtual appliance+ − # Download ''VirtualBox'' for your operating system from here: http://www.virtualbox.org/wiki/Downloads+ − # Install it by following the on-screen instructions.+ − # Start ''VirtualBox'' and create a new virtual machine.+ − # Chose ''Fedora'' as Linux version and leave ''512 MB'' for its memory.+ − # When it comes to selecting the hard disk, select the existing ''.vmdk'' file you extracted in step one.+ − # Follow the process until the end and start your newly created virtual machine then.
Sugar on a Stick/Blueberry (view source)
Revision as of 00:46, 17 August 2011
, 00:46, 17 August 2011no edit summary
[[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 ==
:'''TODO:''' new splash image is needed
: ''a Sugar environment you can carry in your pocket''
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.
* 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.
:'''TODO:''' we'll use image-writer here (requires 2-gig key)
For general questions about Sugar, you may want to start with our user manual:
* http://flossmanuals.net/Sugar, and
* http://wiki.sugarlabs.org/go/The_Undiscoverable
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]]).
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.)
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:
* [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]
:'''TODO:''' need instructions (NAND install)
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]].
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 instructions, too
* 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
== 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).