Sugar on a Stick/Blueberry

From Sugar Labs
< Sugar on a Stick
Revision as of 12:53, 7 November 2009 by Sdz (talk | contribs) (add linux and mac instructions)
Jump to navigation Jump to search

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

a Sugar environment you can carry in your pocket!

Sugar on a Stick - Blueberry

a Sugar environment you can carry in your pocket - this is a draft - work in progress
TODO: new splash image is needed
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.

Get it!

Please select your operating system by clicking on one of the icons below.

Windows.gif Apple.gif Gnulinux.png

Windows Users

TODO: add screenshots (we'll use the .iso file here)
  1. Download the latest version of Fedora LiveUSB Creator from http://fedorahosted.org/liveusb-creator/ and extract it;
  2. Plug a target USB flash drive into your computer (minimum 1-gigabyte);
  3. Launch LiveUSB Creator;
  4. Select Sugar on a Stick (Blueberry) in the drop-down menu on the upper-right side of the LiveUSB Creator window;
  5. 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.
  6. Select your USB flash drive as the target;
  7. Click the Create Live USB button and then wait for the process to finish (the time required will depend mostly on your download speed);
  8. Close the LiveUSB Creator program;
  9. When ejecting the USB flash drive from the computer, first stop the device with the Safely Remove Hardware dialog.

GNU/Linux Users

TODO: we'll use image-writer here (requires 2-gig key)
  1. Download the Sugar on a Stick (Blueberry) live image from here: TODO: add link to pre-partitioned image
  2. Download the image-writer tool from here: TODO: grab working version and put it on dl.sl.o (direct link)
  3. Open a terminal and become root, either by using su or sudo (the latter one each time on the next commands).
  4. If necessary, unmount your flash drive by running: umount /dev/sdX (whereas X is the devices number)
  5. Enter the following command: ./image-writer soas-2-blueberry.img TODO: check filename
  6. The script will output a device name; confirm that this matches with your flash drive.
  7. 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
  1. Download the Sugar on a Stick (Blueberry) live image from here: TODO: add link to pre-partitioned image
  2. Open a terminal and run diskutil unmountDisk /dev/diskX (whereas X is the devices number)
  3. Run sudo dd if=/path/to/downloaded.img of=/dev/diskX bs=1024 (NOTE: This will wipe your flash drive entirely!)
  4. Eject your flash drive by running: diskutil eject /dev/diskX
Retrieved from "https://wiki.sugarlabs.org/index.php?title=Sugar_on_a_Stick/Blueberry&oldid=39965"