SoaS Blueberry Instructions

From Sugar Labs
Jump to navigation Jump to search


Soas-blueberry-logo.png

Soas-blueberry-instructions-text.png
Logo white 04.png



For Windows Users

Logo square black 04.png
  • Download the latest version of the 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.
  • Adjust the Persistent Storage slider. This enables you to save your work in Sugar onto the device.
  • Select your flash drive as the target and click the Create Live USB button.
  • Wait for the process to finish, then close the LiveUSB Creator program.
  • Stop your flash drive using the Safely Remove Hardware dialog and eject it.

For Linux Users

Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility with different distributions. Please follow the instructions carefully to ensure your data is preserved.

  • Download the Sugar on a Stick (Blueberry) live image from here: http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso
  • If you are a Fedora User, download the livecd-iso-to-disk script from here: http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk.sh
    • Become root and execute the following command in a terminal:
      • ./livecd-iso-to-disk.sh --overlay-size-mb xxx --delete-home ./soas-2-blueberry.iso /dev/sdX
      • In this case, xxx is a size in MB, allocated for persistently storing your data.
      • The X stands for the letter/number identifier of your flash drive.
      • Advanced usage: You can simultaneously format your flash drive by adding the option --format --reset-mbr when you call the livecd-iso-to-disk script.
  • If you use any other distribution, download the image-writer tool from here: http://download.sugarlabs.org/soas/releases/image-writer
    • Open a terminal and become root, either by using su or sudo.
    • Enter the following command: ./image-writer soas-2-blueberry.iso
    • The script will output a device name; confirm that it matches with your flash drive.
    • You will be notified once the process has finished.

For Mac/OSX Users

The procedure for Mac OS/X Users follows the one for Linux Users, but differs in some parts. Additionally, Mac Users should be aware that they are able to prepare their flash drive on a Mac, while booting the flash drive itself on a Mac may not necessarily work. This depends especially on their hardware's generation. In this case, using a boot helper as explained in the wiki might help. Please pay attention when running the dd command, as it will wipe your flash drive!

  • Download the Sugar on a Stick (Blueberry) live image from here: http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso
  • Open a terminal and run: diskutil unmountDisk /dev/diskX (whereas X is the device number)
  • Run: sudo dd if=./soas-2-blueberry.iso of=/dev/diskX bs=512
  • Eject your flash drive by running: diskutil eject /dev/diskX

For More Information

With its Sugar on a Stick (Blueberry) release, Sugar Labs also provides additional instructions for using Sugar on a Stick on OLPC's XO-1, as well as for running it in virtual appliances. The wiki contains more information for these purposes. In case you encounter any issues, do not hesitate to ask on our bug tracker here: https://launchpad.net/soas

For more information, please visit
www.sugarlabs.org

About This Document

A PDF layout of this file is available at http://people.sugarlabs.org/sdz/soas-v2-instructions.pdf with SVG source at http://people.sugarlabs.org/sdz/soas-v2-instructions.svg. Note that the wiki page version is likely to be more up-to-date.