SoaS Blueberry Instructions
  |
 |
For Windows Users
- 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
TODO: add screenshot here & add liveusb-creator instructions!
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
- Replace "xxx" with the amount (in MB) of persistent storage you wish to allocate for saving you work in Sugar to the flash drive. We suggest at least 512 MB.
- Replace "X" with 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.
- 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
- 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 is similar to the one for Linux users. Mac users should be aware that they may be able to prepare their flash drive on a Mac, but depending on the generation of the hardware used, they may need to use another computer to test whether the prepared flash drive works.
- 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 (Please pay attention when running the dd command, as it will wipe your flash drive!)
- 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.
