https://wiki.sugarlabs.org/api.php?action=feedcontributions&user=Interested&feedformat=atomSugar Labs - User contributions [en]2024-03-29T05:11:10ZUser contributionsMediaWiki 1.35.2https://wiki.sugarlabs.org/index.php?title=Supported_systems&diff=59382Supported systems2010-11-17T03:23:05Z<p>Interested: </p>
<hr />
<div><noinclude>[[Category:Supported systems]]</noinclude><br />
<br />
:<big>'''Note:''' Development changes occur rapidly, and the documentation here lags the current state of systems development. For the latest information on any development project, visit their work sites.</big><br />
<br />
See [[Sugar System Stack]] for a picture of the software stack.<br />
=== Ways to run Sugar ===<br />
<br />
Determine which of the various methods of running Sugar meet your needs:<br />
* '''Pre-installed Sugar:'''<br />
*: Some computers come with Sugar pre-installed, most notably the OLPC XO-1 laptop.<br />
* '''LiveCD/LiveUSB:'''<br />
*: Suitable for trying Sugar without having to install any software on almost any computer&mdash;just boot Sugar off of a CD or USB drive. Note: the Journal is not saved. All changes are lost upon shutdown or reboot. For USB Solutions goto our [[Sugar on a Stick]] project page.<br />
* '''Install Sugar:'''<br />
*: If you are running one of the currently supported distributions, you can install Sugar using your systems standard package manager, e.g., Synaptic, apt-get, or yum.<br />
*: Make custom Fedora F11/F12 Sugar Install or Live DVD/CD's [http://wiki.sugarlabs.org/go/Community/Distributions/Fedora#Make_you_own_custom_Fedora_F11.2F12_Install_or_Live_DVD.2FCD.27s]<br />
* '''Emulator/Virtualizer:'''<br />
*: [[QEMU]], [[VirtualBox]], or [[VMware]] let you run Sugar in an emulator or by virtualization on your computer&mdash;you'll need to install an emulator from which you launch Sugar and one of the [[Emulator image files]].<br />
Refer to the [[#Table of Sugar solutions|matrix]] below to find a Sugar solution that works for you.<br />
<br />
=== Computer labs ===<br />
<br />
* Bill Kerr has written up instructions for trying Sugar in computer labs which run only Windows <br />
*:(Please see [http://billkerr2.blogspot.com/2008/07/evaluating-sugar-in-developed-world.html].)<br />
<br />
* Caroline Meeks is developing a deployment model that only requires one USB stick per child. (Please see [[Sugar on a Stick]].)<br />
<br />
==Matrix of Sugar solutions==<br />
There are many ways to run Sugar: <br />
* As a [[#Starch|complete disk image]] on an existing machine;<br />
* As a [[#Sucrose|session]] on a Linux system; or<br />
* As part of a [[#Systems|complete hardware-software platform]].<br />
<br />
===[[/Technical considerations | Technical considerations]]===<br />
: A discussion of '''technical considerations''' regarding supported systems.<br />
<br />
===Starch===<br />
<br />
[[Image:Sugar-on-CD-USB.jpg]]<br />
<br />
[[Taxonomy#Starch.28es.29:_A_complete_disk_image_for_Sugar|Starch]] is a complete disk image for Sugar.<br />
{{Dated}}<br />
{| class="wikitable"<br />
|+ '''A complete disk image for Sugar'''<br />
|-<br />
!Name<br />
!Sugar Version<br />
!Tested<br />
!Notes<br />
|-<br />
|[[Sugar on a Stick]]<br />
|0.84<br />
|In process<br />
|This is a Live USB of the Sugar, and one of the primary focuses of Sugar development.<br />
|-<br />
|[ftp://rohrmoser-engineering.de/pub/XO-LiveCD/XO-LiveCD_091203.iso LiveBackup XO-LiveCD]<br />
|0.82<br />
|No<br />
|This is a Live CD of the OLPC system. [ftp://rohrmoser-engineering.de/pub/XO-LiveCD/XO-LiveCD_090308.pdf Release Notes]<br />
|-<br />
|[[Image:Fedora.jpg|30px]]<br />
|0.84.2<br />
|yes<br />
|Sugar Desktop on a Stick is a Fedora11 Sugar USB.img [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux#Download_of_Prebuilt_SUGAR-DESKTOP_USB.img_file] "real install" 4GB stick<br />
|-<br />
|[[Image:Fedora.jpg|30px]]<br />
|<br />
|<br />
|Sugar on a Stick is a Fedora Live USB. There is also [http://dev.laptop.org/~cjb/rawhide-xo/ Fedora "Rawhide" on XO] development.<br />
|-<br />
|[[Image:Ubuntu.jpg|30px]][http://dev.laptop.org/~probono/sbuntu/ Ubuntu LiveCD/LiveUSB]<br />
|0.82<br />
|<br />
|Instructions for installing a Ubuntu LiveUSB<br />
|}<br />
<br />
===Sucrose===<br />
<br />
[[Taxonomy#Sucrose:_The_interface.2C_plus_a_set_of_demonstration_activities|Sucrose]] is the Sugar interface plus a set of demonstration activities. System maintainers should visit the [[Packaging Team]] page.<br />
<br />
{| class="wikitable"<br />
|+ '''The interface, plus a set of demonstration activities'''<br />
|-<br />
!Operating System !! Version !! Sugar Version !! Bundled !! Tested !! [[Packaging Team|Collaboration Links]] !! Notes<br />
|-<br />
|colspan=7 align=center|binary packages available<br />
|-<br />
|[[Image:Debian.jpg|30px]]Debian||4.0 (Lenny)||0.82||Yes||Yes|| [http://wiki.debian.org/Sugar Sugar on Debian] ||<br />
|-<br />
| ||5.0 (Squeeze)||0.84 - 0.88||Yes||Yes|| ||<br />
|-<br />
|[[Image:Fedora.jpg|30px]]Fedora||7,8,9||0.82||Yes||Yes|| || [[Community/Distributions/Fedora | Sugar on Fedora]]<br />
|-<br />
|[[Image:Ubuntu.jpg|30px]]Ubuntu||8.04 (Hardy)||0.79.0-0ubuntu3||Yes||Yes||https://wiki.ubuntu.com/Sugar|| [[Community/Distributions/Ubuntu | Sugar on Ubuntu]]<br />
|-<br />
| ||8.10 (Intrepid)||0.82||Yes|| || || [[Community/Distributions/Ubuntu#Sucrose_0.82 | Sugar on Ubuntu]]<br />
|-<br />
| ||9.04 (Jackalope)<br>9.10 (Koala)||0.84||Yes|| || || [[Community/Distributions/Ubuntu#Sugar on Ubuntu 9.04 (jaunty) | Sugar on Jackalope or Koala]]<br />
|-<br />
|[[Image:Ubuntu.jpg|30px]]Ubuntu||10.04||0.88.0||?||?||http://wiki.sugarlabs.org/go/Community/Distributions/Ubuntu|| [[Community/Distributions/Ubuntu | Sugar on Ubuntu]]|<br />
|-<br />
|[[Image:Alt_linux_team_small.png|36px]]ALT Linux||4.1<br>Sisyphus||0.82<br>SugarPlatform-0.84||Yes|||| || [[Community/Distributions/ALTLinux | Sugar on ALT Linux]]<br />
|-<br />
|[[Image:mandriva.png|36px]]Mandriva||2009.1<br>Cooker||SugarPlatform-0.84<br>SugarPlatform-0.84||Yes<br>Yes|||| ||[[Community/Distributions/Mandriva | Sugar on Mandriva]]<br />
|-<br />
|[[Image:Caixa Mágica.png|36px]]Caixa Mágica||12||SugarPlatform-0.84||Yes|| || || [[Community/Distributions/Magalhães | Sugar on Magalhães]]<br />
|-<br />
|colspan=7 align=center|packages not pre-built<br />
|-<br />
|[[Image:Gentoo-logo.svg|36px]]Gentoo||2009-03-19||0.84<br>9999||Yes|| || || [[Community/Distributions/Gentoo | Sugar on Gentoo]]<br />
|-<br />
|[[Image:Suse-small.jpg|36px]]OpenSUSE||11.1||0.84||Yes|| ||http://en.opensuse.org/Sugar<br>IRC Freenode #opensuse-edu|| [http://en.opensuse.org/Sugar Sugar on OpenSUSE]]<br />
|-<br />
|[[Image:Apple.gif|36px]]|| || || || || || [[Supported_systems/Mac|Sugar on a Mac (in emulation)]]<br />
|-<br />
|[[Image:Slackware.png|65px]]||Slackware 12|| || || || ||[http://wiki.laptop.org/go/Sugar_on_Slackware Sugar on Slackware]<br />
|-<br />
|[[Image:XP.gif|78px]]||WindowsXP|| || ||No|| || [[Supported systems/Windows|Sugar on Windows (using QEMU)]]<br />
|}<br />
<br />
===Sugar for various hardware systems===<br />
Since Sugar is now available on most major GNU/Linux distributions, it is possible to run Sugar almost any computer that can run GNU/Linux. We highlight some systems below. Please add your favorite to the list.<br />
<br />
{| class="wikitable"<br />
|+ '''Complete Sugar Solutions'''<br />
|-<br />
!Manufacturer <br />
!Model <br />
!Operating System<br />
!Tested<br />
!Notes<br />
|-<br />
| [http://www.laptop.org OLPC]<br />
| XO-1<br />
| Fedora 9<br />
| Yes<br />
| Standard (reference) distribution<br />
|-<br />
| [http://www.asus.com ASUSTeK]<br />
| Eee PC<br />
| <br />
| In initial testing phase<br />
| <br />
|-<br />
| [http://www.intel.com Intel]<br />
| Classmate Gen 1 & Gen 2<br />
| <br />
| under development<br />
| <br />
|}<br />
<br />
== Getting the Sugar sources ==<br />
Distributors can find the latest sources for the sucrose components [[Development Team/Release/CurrentRelease/Sucrose#Getting_the_sources|here]]. Each [http://sugarlabs.org/go/Development_Team/Release/Roadmap#Schedule sucrose roadmap] entry has as well links to the release pages of earlier releases.<br />
<br />
==Updating Sugar to the Latest Version==<br />
<br />
<span class="plainlinks"><br />
[http://wiki.sugarlabs.org/go/Community/Distributions/Ubuntu http://wiki.sugarlabs.org/images/e/e2/Ubuntu.jpg]<br />
</span><br />
<br />
===Ubuntu===<br />
<br />
'''http://wiki.sugarlabs.org/go/Community/Distributions/Ubuntu'''<br />
: UbuntuSugarRemix and 10.04LTS<br />
<br />
'''https://wiki.ubuntu.com/Sugar'''<br />
: UbuntuSugarRemix<br />
<br />
The Sugar packages in <br />
Ubuntu 9.04 and 8.10 [http://wiki.sugarlabs.org/go/Community/Distributions/Ubuntu#Using_sugar_PPAs.]<br />
<br />
For a LiveCD/LiveUSB, check out the instructions [http://dev.laptop.org/~probono/sbuntu/].'''(Note that this produces a very old sugar version 0.82.1)'''<br />
<br />
Updated sucrose packages are usually published in a PPA: See [[Community/Distributions/Ubuntu#Sugar_on_Ubuntu_8.04|here]] for details.<br />
<br />
If you want up-to-the-minute freshness (and brokenness) you can use [[Development Team/Jhbuild|jhbuild]] to build from source instead of the released packages. Follow the instructions [[Development Team/Jhbuild#Creating_an_xsession_for_Sugar-jhbuild|here]] to install sugar-jhbuild as an xsession option.<br />
<br />
<span class="plainlinks"><br />
[http://wiki.sugarlabs.org/go/Community/Distributions/Debian http://wiki.sugarlabs.org/images/a/a1/Debian.jpg]<br />
</span><br />
<br />
===Debian===<br />
<br />
Sucrose packages are usually updated in unstable. These packages migrate to testing after a while. You can see the current package versions [http://packages.debian.org/search?keywords=sugar&searchon=names&suite=all&section=all here].<br />
<br />
If you want up-to-the-minute freshness (and brokenness) you can use [[Development Team/Jhbuild|jhbuild]] to build from source instead of the released packages.<br />
<br />
<span class="plainlinks"><br />
[http://wiki.sugarlabs.org/go/Community/Distributions/Fedora http://wiki.sugarlabs.org/images/1/1e/Fedora.jpg]<br />
</span><br />
<br />
===Fedora===<br />
<br />
==== Fedora LiveCD/Live USB ====<br />
:Project page: http://fedoraproject.org/wiki/Sugar (superseding: http://fedoraproject.org/wiki/Sugar_Spin)<br />
<br />
With this spin, you'll be able to run Sugar, which is developed by Sugarlabs and the desktop environment used on the OLPC, directly from a Live CD! You'll find several activities on the image including most notably... <br />
<br />
* sugar-browse - a web browsing activity based on xulrunner<br />
* sugar-write - a word processor based on abiword<br />
<br />
...along with several other activities including Chat support.<br />
<br />
:See our [[Sugar_on_a_Stick | Sugar on a Stick page]].<br />
<br />
The Fedora OLPC SIG, https://fedoraproject.org/wiki/OLPC, will be importing further activities into Fedora, which might be installed using ''yum install sugar-*'' at a later time.<br />
<br />
:Recent development spins:<br />
::http://download.sugarlabs.org/soas/snapshots/1/<br />
<br />
For more information, please refer to the announcement here:<br />
<br />
https://www.redhat.com/archives/fedora-olpc-list/2008-December/msg00061.html<br />
<br />
Fedora 11 Preview contains USB Creator which can make USB and SD's with persistence of Fedora F11 (and Sugar if added with Synaptic) and Soas-beta's [satellit 04/30/2009]<br />
<br />
What if you wanted to put it quickly onto your USB Key? You'll just need to grab Luke Macken's liveusb-creator, which already includes support for the Sugar Spin. Here's the link:<br />
<br />
:http://fedorahosted.org/liveusb-creator/<br />
<br />
The liveusb-creator still contains an old link, which is the reason why you'll need to download the spin manually until this gets fixed.<br />
<br />
'''Tip of the hat:''' Sebastian Dziallas and the Fedora team<br />
<br />
==== Fedora on an OLPC XO ====<br />
<br />
On an OLPC XO-1 laptop, run olpc-update as root.<br />
<br />
Normally you only need to run ''olpc-update'' in the Terminal application with a build number, like this:<br />
<br />
# sudo olpc-update 767<br />
<br />
'''Note:''' Now you can do this by means of the graphical [[olpc:Sugar Control Panel|Sugar Control Panel]].<br />
<br />
===OLPC Clean Install===<br />
<br />
http://wiki.laptop.org/go/Clean-install_procedure<br />
<br />
<br />
====Joyride====<br />
See [[OLPC:Future releases]], the Joyride train is in the round house.<br />
<br />
<big><font color=red>Joyride is for developers; it is not supported. Joyride builds may cause data corruption and in rare cases, even cause hardware damage, so please do not use Joyride on mission-critical systems.</font></big><br />
<br />
Joyride contains all the "bleeding-edge" features that are being debugged for inclusion in the next release.<br />
<br />
Open the Terminal application and type the following, substituting 2469 for the latest version number.<br />
<br />
# olpc-update joyride-2469<br />
<br />
'''What's the latest version?''' You can find the latest build number (shown above as 1779) at the bottom of http://xs-dev.laptop.org/~cscott/xo-1/streams/joyride/<br />
<br />
Updates usually takes 10–15 minutes. It's advised that you plug your XO in while Sugar updates itself, then reboot it to see the new OS take effect.<br />
<br />
==== Other Options ====<br />
<br />
These are options that can be used with the update command:<br />
<br />
# olpc-update --help<br />
<pre><nowiki><br />
Usage: <br />
olpc-update [options] --hints hints-file<br />
olpc-update [options] [-rf] build-number<br />
olpc-update [options] [-rf] --usb<br />
olpc-update --version<br />
olpc-update --help<br />
<br />
For example:<br />
olpc-update 630<br />
olpc-update joyride-1779<br />
olpc-update update.1-700<br />
<br />
Options:<br />
-h, --help show this help message and exit<br />
-f, --full skip incremental update attempt.<br />
--force force update to an unsigned build.<br />
-r, --reboot reboot after a successful update.<br />
--hints=FILE name of json-encoded hints dictionary identifying the desired<br />
new version.<br />
-u, --usb upgrade from new build on inserted USB stick.<br />
-v display verbose progress information; repeat for more verbose<br />
output.<br />
-q, --quiet don't output anything; use exit status to indicate success.<br />
--version display version and license information.<br />
</nowiki></pre><br />
<br />
<br />
[[File:Gentoo-logo-small.jpg|link=Community/Distributions/Gentoo]]<br />
<br />
<br />
==== Fedora on the XO-1 ====<br />
<br />
One of the updated ways of installing sugar on the XO can be seen here.<br />
<br />
http://wiki.laptop.org/go/F11_for_XO-1<br />
<br />
==== SOAS on the XO ====<br />
You can also install sugar on a stick on the XO-1<br />
<br />
* [[Sugar_on_a_Stick/Installation/OLPC]]<br />
<br />
===Gentoo===<br />
* There are two methods to get Sugar on your Gentoo box: [[Community/Distributions/Gentoo#sugar-jhbuild|sugar-jhbuild]] and [[Community/Distributions/Gentoo#Sugar overlay|Sugar overlay]]. '''See''' [[Community/Distributions/Gentoo|Gentoo]] for details.<br />
<br />
<span class="linkgroup"><br />
[[File:Alt_linux_team_tiny.png|link=Community/Distributions/ALTLinux]]<br />
</span><br />
<br />
===ALT Linux===<br />
* ALT Linux Team is an international software developers team, collectively working on [http://en.altlinux.org/Sisyphus Sisyphus].<br />
<br />
*'''To install''' Sugar try these [[Community/Distributions/ALTLinux#Setup|packages]].<br />
<br />
<span class="linkgroup"><br />
[[File:Mandriva.png|link=Community/Distributions/Mandriva]]<br />
</span><br />
<br />
===Mandriva===<br />
To install Sugar on Mandriva follow these [[Community/Distributions/Mandriva#Setup|instructions]].</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/Live_CD&diff=52191Macintosh/Live CD2010-05-19T04:32:02Z<p>Interested: </p>
<hr />
<div>Restart, '''Play.''' Restart, '''Mac.'''<br />
<br />
<br />
Get a hands on experience with Sugar by booting from a CD. Restart and return to your Mac, completely unchanged. This is the easiest way to get a '''Taste of Sugar''' on a Mac. <br />
<br><br><br />
<br />
'''To Get Started''' choose your flavor:<br><br />
* intel processor<br />
* powerPC processor<br />
<br />
[[Sugar_on_a_Mac/processor | Click to discover the processor]] at the heart of your Mac.<br />
<br><br><br />
<br />
'''To Download'''<br><br />
<!-- mirabele --><br />
Download a LiveOS image of Sugar. [http://download.sugarlabs.org/soas/releases] <br />
<br />
Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br><br><br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><br />
''Replace mySugarFlavor with the name of the file you downloaded.''<br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/mySugarFlavor.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/mySugarFlavor.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br><br><br />
<br />
'''To burn onto CD'''<br><br />
* Open the Disk Utility. Drag the downloaded .iso file to the bottom of the list.<br />
* Select your flavor .iso in the list, then press the Burn button. <br />
* Insert a blank CD disc when prompted.<br />
The CD created is '''bootable in most PC'''s including Intel Mac. Please burn many copies and share them freely.<br />
<br><br><br />
<br />
'''To try a Taste of Sugar'''<br><br />
* Insert the CD you burned.<br />
* Press the Power Button on the Intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the Sugar logo appears.<br />
<br><br />
<br />
A Taste of Sugar is a safe read-only experience that doesn't write or remember anything. Unfortunately, this means the Journal is not saved. Nothing is saved. '''All learner progress is lost when the machine reboots.''' A Taste of Sugar is only a demonstration and is not intended to be used on a recurring basis. See [[Sugar_on_a_Mac]] to install Sugar for a learner.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/Live_CD&diff=52190Macintosh/Live CD2010-05-19T04:20:02Z<p>Interested: </p>
<hr />
<div>Restart, '''Play.''' Restart, '''Mac.'''<br />
<br />
<br />
Get a hands on experience with Sugar by booting from a CD. Restart and return to your Mac, completely unchanged. This is the easiest way to get a '''Taste of Sugar''' on a Mac. <br />
<br><br><br />
<br />
'''To Get Started''' choose your flavor:<br><br />
* intel processor<br />
* powerPC processor<br />
<br />
[[Sugar_on_a_Mac/processor | Click to discover the processor]] at the heart of your Mac.<br />
<br><br><br />
<br />
'''To Download'''<br><br />
<!-- mirabele --><br />
Download a LiveOS image of Sugar. [[Downloads ]] <br />
<br />
Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br><br><br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><br />
''Replace mySugarFlavor with the name of the file you downloaded.''<br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/mySugarFlavor.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/mySugarFlavor.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br><br><br />
<br />
'''To burn onto CD'''<br><br />
* Open the Disk Utility. Drag the downloaded .iso file to the bottom of the list.<br />
* Select your flavor .iso in the list, then press the Burn button. <br />
* Insert a blank CD disc when prompted.<br />
The CD created is '''bootable in most PC'''s including Intel Mac. Please burn many copies and share them freely.<br />
<br><br><br />
<br />
'''To try a Taste of Sugar'''<br><br />
* Insert the CD you burned.<br />
* Press the Power Button on the Intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the Sugar logo appears.<br />
<br><br />
<br />
A Taste of Sugar is a safe read-only experience that doesn't write or remember anything. Unfortunately, this means the Journal is not saved. Nothing is saved. '''All learner progress is lost when the machine reboots.''' A Taste of Sugar is only a demonstration and is not intended to be used on a recurring basis. See [[Sugar_on_a_Mac]] to install Sugar for a learner.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/Live_CD&diff=52189Macintosh/Live CD2010-05-19T04:13:11Z<p>Interested: </p>
<hr />
<div>Restart, '''Play.''' Restart, '''Mac.'''<br />
<br />
<br />
Get a hands on experience with Sugar by booting from a CD. Restart and return to your Mac, completely unchanged. This is the easiest way to get a '''Taste of Sugar''' on a Mac. <br />
<br><br><br />
<br />
'''To Get Started''' choose your flavor:<br><br />
* intel processor<br />
* powerPC processor<br />
<br />
[[Sugar_on_a_Mac/processor | Click to discover the processor]] at the heart of your Mac.<br />
<br><br><br />
<br />
'''To Download'''<br><br />
<!-- mirabele --><br />
Download a LiveOS image of Sugar. [http://www.sugarlabs.org] <br />
<br />
Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br><br><br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><br />
''Replace mySugarFlavor with the name of the file you downloaded.''<br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/mySugarFlavor.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/mySugarFlavor.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br><br><br />
<br />
'''To burn onto CD'''<br><br />
* Open the Disk Utility. Drag the downloaded .iso file to the bottom of the list.<br />
* Select your flavor .iso in the list, then press the Burn button. <br />
* Insert a blank CD disc when prompted.<br />
The CD created is '''bootable in most PC'''s including Intel Mac. Please burn many copies and share them freely.<br />
<br><br><br />
<br />
'''To try a Taste of Sugar'''<br><br />
* Insert the CD you burned.<br />
* Press the Power Button on the Intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the Sugar logo appears.<br />
<br><br />
<br />
A Taste of Sugar is a safe read-only experience that doesn't write or remember anything. Unfortunately, this means the Journal is not saved. Nothing is saved. '''All learner progress is lost when the machine reboots.''' A Taste of Sugar is only a demonstration and is not intended to be used on a recurring basis. See [[Sugar_on_a_Mac]] to install Sugar for a learner.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/run_Linux&diff=52188Macintosh/run Linux2010-05-19T04:07:49Z<p>Interested: </p>
<hr />
<div>Farewell '''Mac'''. Hello '''Sugar'''.<br />
<br />
<br />
Linux runs on Mac.<br><br />
Sugar runs on Linux.<br><br />
A two step install of both Linux then Sugar onto an erased Hard Drive will work on most Macintosh computers including powerPC Mac and Intel Mac. <br><br><br />
<br />
'''To identify the Mac's processor and OS X version'''<br><br />
Choose '''Apple menu''' > About This Mac. A small window will appear titled ''About This Mac''. The processor type should be in the window.<br>Note: ''Sugar on a Stick is for the intel processor only. Macs with powerPC will need to get their sugar from a Linux distribution.''<br> <br><br />
<br />
'''To get started, get Linux'''<br><br />
Sugar has been ported by the major Linux distributions and many minor ones. There are many choices available for easy installation; but after first boot, their support for Sugar varies. Search the internet for Linux Mac powerPC Install. Once you've found a version of Linux for your processor, search within to see if Sugar is pre-packaged for easy install and what support or discussions they've had. <!--Those stating educational focus may provide a better experience. But without published reviews, this is baseless bias. --> <!-- Two distributions leave powerPC unsupported: Sugar on a Stick and Toast ''aka Trisquel education distribution'' --><br />
<br><br><br><br></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/Live_CD&diff=52187Macintosh/Live CD2010-05-19T04:04:36Z<p>Interested: </p>
<hr />
<div>Restart, '''Play.''' Restart, '''Mac.'''<br />
<br />
<br />
Get a hands on experience with Sugar by booting from a CD. Restart and return to your Mac, completely unchanged. This is the easiest way to get a '''Taste of Sugar''' on a Mac. <br />
<br><br><br />
<br />
'''To Get Started''' choose your flavor:<br><br />
* intel processor<br />
* powerPC processor<br />
<br />
[[Sugar_on_a_Mac/processor | Click to discover the processor]] at the heart of your Mac.<br />
<br><br><br />
<br />
'''To Download'''<br><br />
<!-- mirabele --><br />
Download a LiveOS image. <br />
<br />
Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br><br><br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><br />
''Replace mySugarFlavor with the name of the file you downloaded.''<br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/mySugarFlavor.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/mySugarFlavor.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br><br><br />
<br />
'''To burn onto CD'''<br><br />
* Open the Disk Utility. Drag the downloaded .iso file to the bottom of the list.<br />
* Select your flavor .iso in the list, then press the Burn button. <br />
* Insert a blank CD disc when prompted.<br />
The CD created is '''bootable in most PC'''s including Intel Mac. Please burn many copies and share them freely.<br />
<br><br><br />
<br />
'''To try a Taste of Sugar'''<br><br />
* Insert the CD you burned.<br />
* Press the Power Button on the Intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the Sugar logo appears.<br />
<br><br />
<br />
A Taste of Sugar is a safe read-only experience that doesn't write or remember anything. Unfortunately, this means the Journal is not saved. Nothing is saved. '''All learner progress is lost when the machine reboots.''' A Taste of Sugar is only a demonstration and is not intended to be used on a recurring basis. See [[Sugar_on_a_Mac]] to install Sugar for a learner.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/Sugar_in_a_window&diff=52186Macintosh/Sugar in a window2010-05-19T04:03:23Z<p>Interested: </p>
<hr />
<div>Click '''Sugar'''. Click '''Mac'''.<br />
<br />
Use Mac and Sugar at the same time on the same computer. '''Sugar in a Window''' allows you to switch instantly between them. This is the most flexible way of using Sugar on an intel Mac.<br />
<br />
*The Journal is saved to disk, so a learner's work is preserved. <br />
*Multiple learners may share the same machine with minor effort.<br />
*Sugar shares your Mac's media effortlessly. CD/DVD, Network, etc.<br />
<br />
<br />
All this is possible by using Virtual Machine software. Virtualization puts an entire computer into a file on your Intel Mac. Install Sugar in that file and boot it with a Virtual computer. Once the boot finishes, you have '''Sugar in a Window'''. There are many virtualization applications for Intel Mac, to name a few:<br />
*VirtualBox<br />
*Parallels<br />
*Fusion<br />
<br />
VirtualBox has a free to use license. Learn how to use it here: [[VirtualBox#OS_X |VirtualBox]]. Instructions for other applications may be available on this wiki and elsewhere.<br> '''Note:''' Virtualization doesn't have a speed penalty like emulation. The use of intel processor Emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Linux and Sugar will drastically outperform emulation.<br />
<br><br><br></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/run_Linux&diff=52185Macintosh/run Linux2010-05-19T04:01:45Z<p>Interested: /* On Unix like OS */</p>
<hr />
<div>Farewell '''Mac'''. Hello '''Sugar'''.<br />
Linux runs on Mac.<br><br />
Sugar runs on Linux.<br><br />
A two step install of both Linux then Sugar onto an erased Hard Drive will work on most Macintosh computers including powerPC Mac and Intel Mac. <br><br><br />
<br />
'''To identify the Mac's processor and OS X version'''<br><br />
Choose '''Apple menu''' > About This Mac. A small window will appear titled ''About This Mac''. The processor type should be in the window.<br>Note: ''Sugar on a Stick is for the intel processor only. Macs with powerPC will need to get their sugar from a Linux distribution.''<br> <br><br />
<br />
'''To get started, get Linux'''<br><br />
Sugar has been ported by the major Linux distributions and many minor ones. There are many choices available for easy installation; but after first boot, their support for Sugar varies. Search the internet for Linux Mac powerPC Install. Once you've found a version of Linux for your processor, search within to see if Sugar is pre-packaged for easy install and what support or discussions they've had. <!--Those stating educational focus may provide a better experience. But without published reviews, this is baseless bias. --> <!-- Two distributions leave powerPC unsupported: Sugar on a Stick and Toast ''aka Trisquel education distribution'' --><br />
<br><br><br><br></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/Live_CD&diff=52184Macintosh/Live CD2010-05-19T03:57:44Z<p>Interested: </p>
<hr />
<div>Restart, '''Play.''' Restart, '''Mac.'''<br />
Get a hands on experience with Sugar by booting from a CD. Restart and return to your Mac, completely unchanged. This is the easiest way to get a '''Taste of Sugar''' on a Mac. <br />
<br><br><br />
<br />
'''To Get Started''' choose your flavor:<br><br />
* intel processor<br />
* powerPC processor<br />
<br />
[[Sugar_on_a_Mac/processor | Click to discover the processor]] at the heart of your Mac.<br />
<br><br><br />
<br />
'''To Download'''<br><br />
<!-- mirabele --><br />
Download a LiveOS image. <br />
<br />
Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br><br><br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><br />
''Replace mySugarFlavor with the name of the file you downloaded.''<br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/mySugarFlavor.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/mySugarFlavor.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br><br><br />
<br />
'''To burn onto CD'''<br><br />
* Open the Disk Utility. Drag the downloaded .iso file to the bottom of the list.<br />
* Select your flavor .iso in the list, then press the Burn button. <br />
* Insert a blank CD disc when prompted.<br />
The CD created is '''bootable in most PC'''s including Intel Mac. Please burn many copies and share them freely.<br />
<br><br><br />
<br />
'''To try a Taste of Sugar'''<br><br />
* Insert the CD you burned.<br />
* Press the Power Button on the Intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the Sugar logo appears.<br />
<br><br />
<br />
A Taste of Sugar is a safe read-only experience that doesn't write or remember anything. Unfortunately, this means the Journal is not saved. Nothing is saved. '''All learner progress is lost when the machine reboots.''' A Taste of Sugar is only a demonstration and is not intended to be used on a recurring basis. See [[Sugar_on_a_Mac]] to install Sugar for a learner.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/Live_CD&diff=52183Macintosh/Live CD2010-05-19T03:54:57Z<p>Interested: /* Restart, Play. Restart, Mac. */</p>
<hr />
<div>Restart, '''Play.''' Restart, '''Mac.'''<br />
Get a hands on experience with Sugar by booting from a CD. Restart and return to your Mac, completely unchanged. This is the easiest way to get a '''Taste of Sugar''' on a Mac. <br />
<br><br><br />
<br />
'''To Get Started''' choose your flavor:<br><br />
* intel processor<br />
* powerPC processor<br />
<br />
[[Sugar_on_a_Mac/processor | Click to discover the processor]] at the heart of your Mac.<br />
<br><br><br />
<br />
'''To Download'''<br><br />
<!-- mirabele --><br />
Download a LiveOS image. <br />
<br />
Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br><br><br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><br />
''Replace mySugarFlavor with the name of the file you downloaded.''<br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/mySugarFlavor.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/mySugarFlavor.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br><br><br />
<br />
'''To burn onto CD'''<br><br />
* Open the Disk Utility. Drag the downloaded .iso file to the bottom of the list.<br />
* Select your flavor .iso in the list, then press the Burn button. <br />
* Insert a blank CD disc when prompted.<br />
The CD created is '''bootable in most PC'''s including Intel Mac. Please burn many copies and share them freely.<br />
<br><br><br />
<br />
'''To try a Taste of Sugar'''<br><br />
* Insert the CD you burned.<br />
* Press the Power Button on the Intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the Sugar logo appears.<br />
<br><br />
<br />
A Taste of Sugar is a safe read-only experience that doesn't write or remember anything. Unfortunately, this means the Journal is not saved. Nothing is saved. '''All learner progress is lost when the machine reboots.''' A Taste of Sugar is only a demonstration and is not intended to be used on a recurring basis. See [[Sugar_on_a_Mac/Sugar_in_a_Window | Sugar in a Window]] or [[#3 | Sugar on Linux]] to install Sugar for a learner.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh&diff=52182Macintosh2010-05-19T03:49:58Z<p>Interested: </p>
<hr />
<div><noinclude>[[Category:HowTo]]<br />
[[Category:Apple Macintosh]]<br />
</noinclude><br />
<br />
There are many options for using Sugar on an Apple Macintosh Computer.<br><br><br />
{{Definition_table<br />
|width=12em|Taste of Sugar | <!-- Read only LiveOS image<br />
--> provides a safe read-only experience that does not alter your Mac. Get to know the Sugar Learning Platform by using it first hand. The quickest way to experience Sugar is to [[Sugar_on_a_Mac/Taste_of_Sugar | go here...]]<br />
|Sugar in a Window | <!--Virtualization of a Linux OS with Sugar installed <br />
--> installs to a directory on your Hard Disk. In a Window or Full Screen you can switch between Mac and Sugar instantly. Your journal is safe and remembered between restarts. [[Sugar_on_a_Mac/Sugar_in_a_Window | Read more... ]]<br />
|Sugar on Linux | <!-- Bootable installation of a Linux OS with Sugar installed <br />
--> Linux runs on Apple computers long after Apple discontinues support. There are many choices available for easy installation; but after first boot, their support for Sugar varies. <!--Those stating educational focus may provide a better experience. But this is baseless bias. --> [[Sugar_on_a_Mac/on_Unix | Read more... ]]<br />
}}<br />
<br><br><br><br />
<br />
<br />
<big>'''Other ways to get Sugar on your Mac'''</big><br><br />
'''Sugar on a Stick''' loaded USB devices should run on Intel Macs. <br />
<br />
* [http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso Strawberry v1]<br />
* [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Blueberry v2]<br />
<br />
Follow these instructions '''every time''' you wish to use your '''Sugar on a Stick''' device on an intel Mac:<br />
*Boot the Mac with the boot-helper CD <br />
*interrupt the boot sequence<br />
*edit the kernel parameters<br />
vmlinuz0 initrd=initrd0.img root=LABEL=FEDORA rootfstype=iso9660 rw liveimg overlay=LABEL=soas-2-blueberry quiet rhgb selinux=0<br />
*continue the boot.<br />
<br />
You can create a '''Sugar on a Stick''' device with a Mac. However, to save the Journal you must create your stick on a PC or Linux machine: Instructions for [[Sugar_on_a_Stick/Windows|Windows]] and [[Sugar_on_a_Stick/Linux|Linux]] <!-- Have you tried to run the livecd-iso-to-disk bash script with --efi option on a 32-bit Intel Mac? (do they exist?) (would a bash script even run? could it be modified to run on a Mac, for example, substitute $(readlink -f "$2") calls with $(readlink "$2") and whatever else is required?) See http://www.mail-archive.com/soas@lists.sugarlabs.org/msg01010.html and https://answers.edge.launchpad.net/soas/+question/95622 --><br />
<br />
# Download the boot helper from: http://download.sugarlabs.org/soas/releases/soas-boot.iso<br />
# Put in the boot-helper CD<br />
# Plug in the USB<br />
# Turn on the Mac<br />
# At the chime press the "C" key<br />
<br />
The Mac should boot first from the CD then from the USB device. <br />
As of 12 April 2009, this is experimental. Let us know what results you get.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh&diff=52181Macintosh2010-05-19T03:41:52Z<p>Interested: /* Farewell Mac. Hello Sugar. */</p>
<hr />
<div><noinclude>[[Category:HowTo]]<br />
[[Category:Apple Macintosh]]<br />
</noinclude><br />
<br />
There are many options for using Sugar on an Apple Macintosh Computer.<br />
{{Definition_table<br />
|width=12em|Taste of Sugar | <!-- Read only LiveOS image<br />
--> provides a safe read-only experience that does not alter your Mac. Get to know the Sugar Learning Platform by using it first hand. The quickest way to experience Sugar is to [[Sugar_on_a_Mac/Taste_of_Sugar | go here...]]<br />
|Sugar in a Window | <!--Virtualization of a Linux OS with Sugar installed <br />
--> installs to a directory on your Hard Disk. In a Window or Full Screen you can switch between Mac and Sugar instantly. Your journal is safe and remembered between restarts. [[Sugar_on_a_Mac/Sugar_in_a_Window | Read more... ]]<br />
|Sugar on Linux | <!-- Bootable installation of a Linux OS with Sugar installed <br />
--> Linux runs on Apple computers long after Apple discontinues support. There are many choices available for easy installation; but after first boot, their support for Sugar varies. <!--Those stating educational focus may provide a better experience. But this is baseless bias. --> [[Sugar_on_a_Mac/on_Unix | Read more... ]]<br />
}}<br />
<br><br><br><br />
{{Anchor|1}}<br />
pick a flavor:<br><br />
* [http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso Strawberry v1] for intel processor<br />
* [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Blueberry v2] for intel processor<br />
* [http://alt.fedoraproject.org/pub/alt/nightly-composes/soas/ Mirabelle beta] for intel processor<br />
* [[#3 | Linux]] for powerPC processor<br />
<br />
<big>'''Other ways to get Sugar on your Mac'''</big><br><br />
'''Sugar on a Stick''' loaded USB devices should run on Intel Macs. Follow these instructions '''every time''' you wish to use your '''Sugar on a Stick''' device on an intel Mac:<br />
*Boot the Mac with the boot-helper CD <br />
*interrupt the boot sequence<br />
*edit the kernel parameters<br />
vmlinuz0 initrd=initrd0.img root=LABEL=FEDORA rootfstype=iso9660 rw liveimg overlay=LABEL=soas-2-blueberry quiet rhgb selinux=0<br />
*continue the boot.<br />
<br />
You can create a '''Sugar on a Stick''' device with a Mac. However, to save the Journal you must create your stick on a PC or Linux machine: Instructions for [[Sugar_on_a_Stick/Windows|Windows]] and [[Sugar_on_a_Stick/Linux|Linux]] <!-- Have you tried to run the livecd-iso-to-disk bash script with --efi option on a 32-bit Intel Mac? (do they exist?) (would a bash script even run? could it be modified to run on a Mac, for example, substitute $(readlink -f "$2") calls with $(readlink "$2") and whatever else is required?) See http://www.mail-archive.com/soas@lists.sugarlabs.org/msg01010.html and https://answers.edge.launchpad.net/soas/+question/95622 --><br />
<br />
# Download the boot helper from: http://download.sugarlabs.org/soas/releases/soas-boot.iso<br />
# Put in the boot-helper CD<br />
# Plug in the USB<br />
# Turn on the Mac<br />
# At the chime press the "C" key<br />
<br />
The Mac should boot first from the CD then from the USB device. <br />
As of 12 April 2009, this is experimental. Let us know what results you get.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh&diff=52180Macintosh2010-05-19T03:37:20Z<p>Interested: </p>
<hr />
<div><noinclude>[[Category:HowTo]]<br />
[[Category:Apple Macintosh]]<br />
</noinclude><br />
<br />
There are many options for using Sugar on an Apple Macintosh Computer.<br />
{{Definition_table<br />
|width=12em|Taste of Sugar | <!-- Read only LiveOS image<br />
--> provides a safe read-only experience that does not alter your Mac. Get to know the Sugar Learning Platform by using it first hand. The quickest way to experience Sugar is to [[Sugar_on_a_Mac/Taste_of_Sugar | go here...]]<br />
|Sugar in a Window | <!--Virtualization of a Linux OS with Sugar installed <br />
--> installs to a directory on your Hard Disk. In a Window or Full Screen you can switch between Mac and Sugar instantly. Your journal is safe and remembered between restarts. [[Sugar_on_a_Mac/Sugar_in_a_Window | Read more... ]]<br />
|Sugar on Linux | <!-- Bootable installation of a Linux OS with Sugar installed <br />
--> Linux runs on Apple computers long after Apple discontinues support. There are many choices available for easy installation; but after first boot, their support for Sugar varies. <!--Those stating educational focus may provide a better experience. But this is baseless bias. --> [[Sugar_on_a_Mac/on_Unix | Read more... ]]<br />
}}<br />
<br><br><br><br />
{{Anchor|1}}<br />
pick a flavor:<br><br />
* [http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso Strawberry v1] for intel processor<br />
* [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Blueberry v2] for intel processor<br />
* [http://alt.fedoraproject.org/pub/alt/nightly-composes/soas/ Mirabelle beta] for intel processor<br />
* [[#3 | Linux]] for powerPC processor<br />
<br />
==Farewell '''Mac'''. Hello '''Sugar'''.==<br />
Linux runs on Mac.<br><br />
Sugar runs on Linux.<br><br />
A two step install of both Linux then Sugar onto an erased Hard Drive will work on most Macintosh computers including powerPC Mac and Intel Mac. <br><br><br />
{{Anchor|4}}<br />
'''To identify the Mac's processor and OS X version'''<br><br />
Choose '''Apple menu''' > About This Mac. A small window will appear titled ''About This Mac''. The processor type should be in the window.<br>Note: ''Sugar on a Stick is for the intel processor only. Macs with powerPC will need to get their sugar from a Linux distribution.''<br> <br><br />
<br />
'''To get started, get Linux'''<br><br />
Sugar has been ported by the major Linux distributions and many minor ones. There are many choices available for easy installation; but after first boot, their support for Sugar varies. Search the internet for Linux Mac powerPC Install. Once you've found a version of Linux for your processor, search within to see if Sugar is pre-packaged for easy install and what support or discussions they've had. <!--Those stating educational focus may provide a better experience. But without published reviews, this is baseless bias. --> <!-- Two distributions leave powerPC unsupported: Sugar on a Stick and Toast ''aka Trisquel education distribution'' --><br />
<br><br><br><br><br />
<br />
<br />
<br />
<big>'''Other ways to get Sugar on your Mac'''</big><br><br />
'''Sugar on a Stick''' loaded USB devices should run on Intel Macs. Follow these instructions '''every time''' you wish to use your '''Sugar on a Stick''' device on an intel Mac:<br />
*Boot the Mac with the boot-helper CD <br />
*interrupt the boot sequence<br />
*edit the kernel parameters<br />
vmlinuz0 initrd=initrd0.img root=LABEL=FEDORA rootfstype=iso9660 rw liveimg overlay=LABEL=soas-2-blueberry quiet rhgb selinux=0<br />
*continue the boot.<br />
<br />
You can create a '''Sugar on a Stick''' device with a Mac. However, to save the Journal you must create your stick on a PC or Linux machine: Instructions for [[Sugar_on_a_Stick/Windows|Windows]] and [[Sugar_on_a_Stick/Linux|Linux]] <!-- Have you tried to run the livecd-iso-to-disk bash script with --efi option on a 32-bit Intel Mac? (do they exist?) (would a bash script even run? could it be modified to run on a Mac, for example, substitute $(readlink -f "$2") calls with $(readlink "$2") and whatever else is required?) See http://www.mail-archive.com/soas@lists.sugarlabs.org/msg01010.html and https://answers.edge.launchpad.net/soas/+question/95622 --><br />
<br />
# Download the boot helper from: http://download.sugarlabs.org/soas/releases/soas-boot.iso<br />
# Put in the boot-helper CD<br />
# Plug in the USB<br />
# Turn on the Mac<br />
# At the chime press the "C" key<br />
<br />
The Mac should boot first from the CD then from the USB device. <br />
As of 12 April 2009, this is experimental. Let us know what results you get.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/run_Linux&diff=52179Macintosh/run Linux2010-05-19T03:30:55Z<p>Interested: Created page with '==Farewell '''Mac'''. Hello '''Sugar'''.== Linux runs on Mac.<br> Sugar runs on Linux.<br> A two step install of both Linux then Sugar onto an erased Hard Drive will work on most...'</p>
<hr />
<div>==Farewell '''Mac'''. Hello '''Sugar'''.==<br />
Linux runs on Mac.<br><br />
Sugar runs on Linux.<br><br />
A two step install of both Linux then Sugar onto an erased Hard Drive will work on most Macintosh computers including powerPC Mac and Intel Mac. <br><br><br />
<br />
'''To identify the Mac's processor and OS X version'''<br><br />
Choose '''Apple menu''' > About This Mac. A small window will appear titled ''About This Mac''. The processor type should be in the window.<br>Note: ''Sugar on a Stick is for the intel processor only. Macs with powerPC will need to get their sugar from a Linux distribution.''<br> <br><br />
<br />
'''To get started, get Linux'''<br><br />
Sugar has been ported by the major Linux distributions and many minor ones. There are many choices available for easy installation; but after first boot, their support for Sugar varies. Search the internet for Linux Mac powerPC Install. Once you've found a version of Linux for your processor, search within to see if Sugar is pre-packaged for easy install and what support or discussions they've had. <!--Those stating educational focus may provide a better experience. But without published reviews, this is baseless bias. --> <!-- Two distributions leave powerPC unsupported: Sugar on a Stick and Toast ''aka Trisquel education distribution'' --><br />
<br><br><br><br></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh&diff=52178Macintosh2010-05-19T03:22:40Z<p>Interested: /* Click Sugar. Click Mac. */</p>
<hr />
<div><noinclude>[[Category:HowTo]]<br />
[[Category:Apple Macintosh]]<br />
</noinclude><br />
<br />
There are many options for using Sugar on an Apple Macintosh Computer.<br />
{{Definition_table<br />
|width=12em|Taste of Sugar | <!-- Read only LiveOS image<br />
--> provides a safe read-only experience that does not alter your Mac. Get to know the Sugar Learning Platform by using it first hand. The quickest way to experience Sugar is to [[Sugar_on_a_Mac/Taste_of_Sugar | go here...]]<br />
|Sugar in a Window | <!--Virtualization of a Linux OS with Sugar installed <br />
--> installs to a directory on your Hard Disk. In a Window or Full Screen you can switch between Mac and Sugar instantly. Your journal is safe and remembered between restarts. [[Sugar_on_a_Mac/Sugar_in_a_Window | Read more... ]]<br />
|Sugar on Linux | <!-- Bootable installation of a Linux OS with Sugar installed <br />
--> Linux runs on Apple computers long after Apple discontinues support. There are many choices available for easy installation; but after first boot, their support for Sugar varies. <!--Those stating educational focus may provide a better experience. But this is baseless bias. --> [[#3 | Read more... ]]<br />
}}<br />
<br><br><br><br />
{{Anchor|1}}<br />
pick a flavor:<br><br />
* [http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso Strawberry v1] for intel processor<br />
* [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Blueberry v2] for intel processor<br />
* [http://alt.fedoraproject.org/pub/alt/nightly-composes/soas/ Mirabelle beta] for intel processor<br />
* [[#3 | Linux]] for powerPC processor<br />
<br />
==Farewell '''Mac'''. Hello '''Sugar'''.==<br />
Linux runs on Mac.<br><br />
Sugar runs on Linux.<br><br />
A two step install of both Linux then Sugar onto an erased Hard Drive will work on most Macintosh computers including powerPC Mac and Intel Mac. <br><br><br />
{{Anchor|4}}<br />
'''To identify the Mac's processor and OS X version'''<br><br />
Choose '''Apple menu''' > About This Mac. A small window will appear titled ''About This Mac''. The processor type should be in the window.<br>Note: ''Sugar on a Stick is for the intel processor only. Macs with powerPC will need to get their sugar from a Linux distribution.''<br> <br><br />
<br />
'''To get started, get Linux'''<br><br />
Sugar has been ported by the major Linux distributions and many minor ones. There are many choices available for easy installation; but after first boot, their support for Sugar varies. Search the internet for Linux Mac powerPC Install. Once you've found a version of Linux for your processor, search within to see if Sugar is pre-packaged for easy install and what support or discussions they've had. <!--Those stating educational focus may provide a better experience. But without published reviews, this is baseless bias. --> <!-- Two distributions leave powerPC unsupported: Sugar on a Stick and Toast ''aka Trisquel education distribution'' --><br />
<br><br><br><br><br />
<br />
<br />
<br />
<big>'''Other ways to get Sugar on your Mac'''</big><br><br />
'''Sugar on a Stick''' loaded USB devices should run on Intel Macs. Follow these instructions '''every time''' you wish to use your '''Sugar on a Stick''' device on an intel Mac:<br />
*Boot the Mac with the boot-helper CD <br />
*interrupt the boot sequence<br />
*edit the kernel parameters<br />
vmlinuz0 initrd=initrd0.img root=LABEL=FEDORA rootfstype=iso9660 rw liveimg overlay=LABEL=soas-2-blueberry quiet rhgb selinux=0<br />
*continue the boot.<br />
<br />
You can create a '''Sugar on a Stick''' device with a Mac. However, to save the Journal you must create your stick on a PC or Linux machine: Instructions for [[Sugar_on_a_Stick/Windows|Windows]] and [[Sugar_on_a_Stick/Linux|Linux]] <!-- Have you tried to run the livecd-iso-to-disk bash script with --efi option on a 32-bit Intel Mac? (do they exist?) (would a bash script even run? could it be modified to run on a Mac, for example, substitute $(readlink -f "$2") calls with $(readlink "$2") and whatever else is required?) See http://www.mail-archive.com/soas@lists.sugarlabs.org/msg01010.html and https://answers.edge.launchpad.net/soas/+question/95622 --><br />
<br />
# Download the boot helper from: http://download.sugarlabs.org/soas/releases/soas-boot.iso<br />
# Put in the boot-helper CD<br />
# Plug in the USB<br />
# Turn on the Mac<br />
# At the chime press the "C" key<br />
<br />
The Mac should boot first from the CD then from the USB device. <br />
As of 12 April 2009, this is experimental. Let us know what results you get.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/Sugar_in_a_window&diff=52177Macintosh/Sugar in a window2010-05-19T03:20:32Z<p>Interested: </p>
<hr />
<div>==Click '''Sugar'''. Click '''Mac'''.==<br />
Use Mac and Sugar at the same time on the same computer. '''Sugar in a Window''' allows you to switch instantly between them. This is the most flexible way of using Sugar on an intel Mac.<br />
<br />
*The Journal is saved to disk, so a learner's work is preserved. <br />
*Multiple learners may share the same machine with minor effort.<br />
*Sugar shares your Mac's media effortlessly. CD/DVD, Network, etc.<br />
<br />
<br />
All this is possible by using Virtual Machine software. Virtualization puts an entire computer into a file on your Intel Mac. Install Sugar in that file and boot it with a Virtual computer. Once the boot finishes, you have '''Sugar in a Window'''. There are many virtualization applications for Intel Mac, to name a few:<br />
*VirtualBox<br />
*Parallels<br />
*Fusion<br />
<br />
VirtualBox has a free to use license. Learn how to use it here: [[VirtualBox#OS_X |VirtualBox]]. Instructions for other applications may be available on this wiki and elsewhere.<br> '''Note:''' Virtualization doesn't have a speed penalty like emulation. The use of intel processor Emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Linux and Sugar will drastically outperform emulation.<br />
<br><br><br></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh&diff=52176Macintosh2010-05-19T03:17:49Z<p>Interested: </p>
<hr />
<div><noinclude>[[Category:HowTo]]<br />
[[Category:Apple Macintosh]]<br />
</noinclude><br />
<br />
There are many options for using Sugar on an Apple Macintosh Computer.<br />
{{Definition_table<br />
|width=12em|Taste of Sugar | <!-- Read only LiveOS image<br />
--> provides a safe read-only experience that does not alter your Mac. Get to know the Sugar Learning Platform by using it first hand. The quickest way to experience Sugar is to [[Sugar_on_a_Mac/Taste_of_Sugar | go here...]]<br />
|Sugar in a Window | <!--Virtualization of a Linux OS with Sugar installed <br />
--> installs to a directory on your Hard Disk. In a Window or Full Screen you can switch between Mac and Sugar instantly. Your journal is safe and remembered between restarts. [[Sugar_on_a_Mac/Sugar_in_a_Window | Read more... ]]<br />
|Sugar on Linux | <!-- Bootable installation of a Linux OS with Sugar installed <br />
--> Linux runs on Apple computers long after Apple discontinues support. There are many choices available for easy installation; but after first boot, their support for Sugar varies. <!--Those stating educational focus may provide a better experience. But this is baseless bias. --> [[#3 | Read more... ]]<br />
}}<br />
<br><br><br><br />
{{Anchor|1}}<br />
pick a flavor:<br><br />
* [http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso Strawberry v1] for intel processor<br />
* [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Blueberry v2] for intel processor<br />
* [http://alt.fedoraproject.org/pub/alt/nightly-composes/soas/ Mirabelle beta] for intel processor<br />
* [[#3 | Linux]] for powerPC processor<br />
<br />
==Click '''Sugar'''. Click '''Mac'''.==<br />
Use Mac and Sugar at the same time on the same computer. '''Sugar in a Window''' allows you to switch instantly between them. This is the most flexible way of using Sugar on an intel Mac.<br />
<br />
*The Journal is saved to disk, so a learner's work is preserved. <br />
*Multiple learners may share the same machine with minor effort.<br />
*Sugar shares your Mac's media effortlessly. CD/DVD, Network, etc.<br />
<br />
<br />
All this is possible by using Virtual Machine software. Virtualization puts an entire computer into a file on your Intel Mac. Install Sugar in that file and boot it with a Virtual computer. Once the boot finishes, you have '''Sugar in a Window'''. There are many virtualization applications for Intel Mac, to name a few:<br />
*VirtualBox<br />
*Parallels<br />
*Fusion<br />
<br />
VirtualBox has a free to use license. Learn how to use it here: [[VirtualBox#OS_X |VirtualBox]]. Instructions for other applications may be available on this wiki and elsewhere.<br> '''Note:''' Virtualization doesn't have a speed penalty like emulation. The use of intel processor Emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Linux and Sugar will drastically outperform emulation.<br />
<br><br><br><br />
{{Anchor|3}}<br />
==Farewell '''Mac'''. Hello '''Sugar'''.==<br />
Linux runs on Mac.<br><br />
Sugar runs on Linux.<br><br />
A two step install of both Linux then Sugar onto an erased Hard Drive will work on most Macintosh computers including powerPC Mac and Intel Mac. <br><br><br />
{{Anchor|4}}<br />
'''To identify the Mac's processor and OS X version'''<br><br />
Choose '''Apple menu''' > About This Mac. A small window will appear titled ''About This Mac''. The processor type should be in the window.<br>Note: ''Sugar on a Stick is for the intel processor only. Macs with powerPC will need to get their sugar from a Linux distribution.''<br> <br><br />
<br />
'''To get started, get Linux'''<br><br />
Sugar has been ported by the major Linux distributions and many minor ones. There are many choices available for easy installation; but after first boot, their support for Sugar varies. Search the internet for Linux Mac powerPC Install. Once you've found a version of Linux for your processor, search within to see if Sugar is pre-packaged for easy install and what support or discussions they've had. <!--Those stating educational focus may provide a better experience. But without published reviews, this is baseless bias. --> <!-- Two distributions leave powerPC unsupported: Sugar on a Stick and Toast ''aka Trisquel education distribution'' --><br />
<br><br><br><br><br />
<br />
<br />
<br />
<big>'''Other ways to get Sugar on your Mac'''</big><br><br />
'''Sugar on a Stick''' loaded USB devices should run on Intel Macs. Follow these instructions '''every time''' you wish to use your '''Sugar on a Stick''' device on an intel Mac:<br />
*Boot the Mac with the boot-helper CD <br />
*interrupt the boot sequence<br />
*edit the kernel parameters<br />
vmlinuz0 initrd=initrd0.img root=LABEL=FEDORA rootfstype=iso9660 rw liveimg overlay=LABEL=soas-2-blueberry quiet rhgb selinux=0<br />
*continue the boot.<br />
<br />
You can create a '''Sugar on a Stick''' device with a Mac. However, to save the Journal you must create your stick on a PC or Linux machine: Instructions for [[Sugar_on_a_Stick/Windows|Windows]] and [[Sugar_on_a_Stick/Linux|Linux]] <!-- Have you tried to run the livecd-iso-to-disk bash script with --efi option on a 32-bit Intel Mac? (do they exist?) (would a bash script even run? could it be modified to run on a Mac, for example, substitute $(readlink -f "$2") calls with $(readlink "$2") and whatever else is required?) See http://www.mail-archive.com/soas@lists.sugarlabs.org/msg01010.html and https://answers.edge.launchpad.net/soas/+question/95622 --><br />
<br />
# Download the boot helper from: http://download.sugarlabs.org/soas/releases/soas-boot.iso<br />
# Put in the boot-helper CD<br />
# Plug in the USB<br />
# Turn on the Mac<br />
# At the chime press the "C" key<br />
<br />
The Mac should boot first from the CD then from the USB device. <br />
As of 12 April 2009, this is experimental. Let us know what results you get.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/Sugar_in_a_window&diff=52175Macintosh/Sugar in a window2010-05-19T03:15:03Z<p>Interested: Created page with 'Click'</p>
<hr />
<div>Click</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh&diff=52174Macintosh2010-05-19T03:11:16Z<p>Interested: /* Restart, Play. Restart, Mac. */</p>
<hr />
<div><noinclude>[[Category:HowTo]]<br />
[[Category:Apple Macintosh]]<br />
</noinclude><br />
<br />
There are many options for using Sugar on an Apple Macintosh Computer.<br />
{{Definition_table<br />
|width=12em|Taste of Sugar | <!-- Read only LiveOS image<br />
--> provides a safe read-only experience that does not alter your Mac. Get to know the Sugar Learning Platform by using it first hand. The quickest way to experience Sugar is to [[Sugar_on_a_Mac/Taste_of_Sugar | go here...]]<br />
|Sugar in a Window | <!--Virtualization of a Linux OS with Sugar installed <br />
--> installs to a directory on your Hard Disk. In a Window or Full Screen you can switch between Mac and Sugar instantly. Your journal is safe and remembered between restarts. [[#2 | Read more... ]]<br />
|Sugar on Linux | <!-- Bootable installation of a Linux OS with Sugar installed <br />
--> Linux runs on Apple computers long after Apple discontinues support. There are many choices available for easy installation; but after first boot, their support for Sugar varies. <!--Those stating educational focus may provide a better experience. But this is baseless bias. --> [[#3 | Read more... ]]<br />
}}<br />
<br><br><br><br />
{{Anchor|1}}<br />
pick a flavor:<br><br />
* [http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso Strawberry v1] for intel processor<br />
* [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Blueberry v2] for intel processor<br />
* [http://alt.fedoraproject.org/pub/alt/nightly-composes/soas/ Mirabelle beta] for intel processor<br />
* [[#3 | Linux]] for powerPC processor<br />
<br />
==Click '''Sugar'''. Click '''Mac'''.==<br />
Use Mac and Sugar at the same time on the same computer. '''Sugar in a Window''' allows you to switch instantly between them. This is the most flexible way of using Sugar on an intel Mac.<br />
<br />
*The Journal is saved to disk, so a learner's work is preserved. <br />
*Multiple learners may share the same machine with minor effort.<br />
*Sugar shares your Mac's media effortlessly. CD/DVD, Network, etc.<br />
<br />
<br />
All this is possible by using Virtual Machine software. Virtualization puts an entire computer into a file on your Intel Mac. Install Sugar in that file and boot it with a Virtual computer. Once the boot finishes, you have '''Sugar in a Window'''. There are many virtualization applications for Intel Mac, to name a few:<br />
*VirtualBox<br />
*Parallels<br />
*Fusion<br />
<br />
VirtualBox has a free to use license. Learn how to use it here: [[VirtualBox#OS_X |VirtualBox]]. Instructions for other applications may be available on this wiki and elsewhere.<br> '''Note:''' Virtualization doesn't have a speed penalty like emulation. The use of intel processor Emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Linux and Sugar will drastically outperform emulation.<br />
<br><br><br><br />
{{Anchor|3}}<br />
==Farewell '''Mac'''. Hello '''Sugar'''.==<br />
Linux runs on Mac.<br><br />
Sugar runs on Linux.<br><br />
A two step install of both Linux then Sugar onto an erased Hard Drive will work on most Macintosh computers including powerPC Mac and Intel Mac. <br><br><br />
{{Anchor|4}}<br />
'''To identify the Mac's processor and OS X version'''<br><br />
Choose '''Apple menu''' > About This Mac. A small window will appear titled ''About This Mac''. The processor type should be in the window.<br>Note: ''Sugar on a Stick is for the intel processor only. Macs with powerPC will need to get their sugar from a Linux distribution.''<br> <br><br />
<br />
'''To get started, get Linux'''<br><br />
Sugar has been ported by the major Linux distributions and many minor ones. There are many choices available for easy installation; but after first boot, their support for Sugar varies. Search the internet for Linux Mac powerPC Install. Once you've found a version of Linux for your processor, search within to see if Sugar is pre-packaged for easy install and what support or discussions they've had. <!--Those stating educational focus may provide a better experience. But without published reviews, this is baseless bias. --> <!-- Two distributions leave powerPC unsupported: Sugar on a Stick and Toast ''aka Trisquel education distribution'' --><br />
<br><br><br><br><br />
<br />
<br />
<br />
<big>'''Other ways to get Sugar on your Mac'''</big><br><br />
'''Sugar on a Stick''' loaded USB devices should run on Intel Macs. Follow these instructions '''every time''' you wish to use your '''Sugar on a Stick''' device on an intel Mac:<br />
*Boot the Mac with the boot-helper CD <br />
*interrupt the boot sequence<br />
*edit the kernel parameters<br />
vmlinuz0 initrd=initrd0.img root=LABEL=FEDORA rootfstype=iso9660 rw liveimg overlay=LABEL=soas-2-blueberry quiet rhgb selinux=0<br />
*continue the boot.<br />
<br />
You can create a '''Sugar on a Stick''' device with a Mac. However, to save the Journal you must create your stick on a PC or Linux machine: Instructions for [[Sugar_on_a_Stick/Windows|Windows]] and [[Sugar_on_a_Stick/Linux|Linux]] <!-- Have you tried to run the livecd-iso-to-disk bash script with --efi option on a 32-bit Intel Mac? (do they exist?) (would a bash script even run? could it be modified to run on a Mac, for example, substitute $(readlink -f "$2") calls with $(readlink "$2") and whatever else is required?) See http://www.mail-archive.com/soas@lists.sugarlabs.org/msg01010.html and https://answers.edge.launchpad.net/soas/+question/95622 --><br />
<br />
# Download the boot helper from: http://download.sugarlabs.org/soas/releases/soas-boot.iso<br />
# Put in the boot-helper CD<br />
# Plug in the USB<br />
# Turn on the Mac<br />
# At the chime press the "C" key<br />
<br />
The Mac should boot first from the CD then from the USB device. <br />
As of 12 April 2009, this is experimental. Let us know what results you get.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh&diff=52173Macintosh2010-05-19T03:05:09Z<p>Interested: </p>
<hr />
<div><noinclude>[[Category:HowTo]]<br />
[[Category:Apple Macintosh]]<br />
</noinclude><br />
<br />
There are many options for using Sugar on an Apple Macintosh Computer.<br />
{{Definition_table<br />
|width=12em|Taste of Sugar | <!-- Read only LiveOS image<br />
--> provides a safe read-only experience that does not alter your Mac. Get to know the Sugar Learning Platform by using it first hand. The quickest way to experience Sugar is to [[Sugar_on_a_Mac/Taste_of_Sugar | go here...]]<br />
|Sugar in a Window | <!--Virtualization of a Linux OS with Sugar installed <br />
--> installs to a directory on your Hard Disk. In a Window or Full Screen you can switch between Mac and Sugar instantly. Your journal is safe and remembered between restarts. [[#2 | Read more... ]]<br />
|Sugar on Linux | <!-- Bootable installation of a Linux OS with Sugar installed <br />
--> Linux runs on Apple computers long after Apple discontinues support. There are many choices available for easy installation; but after first boot, their support for Sugar varies. <!--Those stating educational focus may provide a better experience. But this is baseless bias. --> [[#3 | Read more... ]]<br />
}}<br />
<br><br><br><br />
{{Anchor|1}}<br />
==Restart, '''Play.''' Restart, '''Mac.'''==<br />
Get a hands on experience with Sugar by booting from a CD. Restart and return to your Mac, completely unchanged. This is the easiest way to get a '''Taste of Sugar''' on a Mac. <br />
<br><br><br />
<br />
'''To Get Started''' pick a flavor:<br><br />
* [http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso Strawberry v1] for intel processor<br />
* [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Blueberry v2] for intel processor<br />
* [http://alt.fedoraproject.org/pub/alt/nightly-composes/soas/ Mirabelle beta] for intel processor<br />
* [[#3 | Linux]] for powerPC processor<br />
<br />
[[#4 | Click to discover the processor]] at the heart of your Mac.<br />
<br />
Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br><br><br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><br />
''Replace mySugarFlavor with the name of the file you downloaded.''<br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/mySugarFlavor.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/mySugarFlavor.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br><br><br />
<br />
'''To burn onto CD'''<br><br />
* Open the Disk Utility. Drag the downloaded .iso file to the bottom of the list.<br />
* Select your flavor .iso in the list, then press the Burn button. <br />
* Insert a blank CD disc when prompted.<br />
The CD created is '''bootable in most PC'''s including Intel Mac. Please burn many copies and share them freely.<br />
<br><br><br />
<br />
'''To try a Taste of Sugar'''<br><br />
* Insert the CD you burned.<br />
* Press the Power Button on the Intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the Sugar logo appears.<br />
<br><br />
<br />
A Taste of Sugar is a safe read-only experience that doesn't write or remember anything. Unfortunately, this means the Journal is not saved. Nothing is saved. '''All learner progress is lost when the machine reboots.''' A Taste of Sugar is only a demonstration and is not intended to be used on a recurring basis. See [[#2 | Sugar in a Window]] or [[#3 | Sugar on Linux]] to install Sugar for a learner.<br />
<br><br><br><br />
{{Anchor|2}}<br />
==Click '''Sugar'''. Click '''Mac'''.==<br />
Use Mac and Sugar at the same time on the same computer. '''Sugar in a Window''' allows you to switch instantly between them. This is the most flexible way of using Sugar on an intel Mac.<br />
<br />
*The Journal is saved to disk, so a learner's work is preserved. <br />
*Multiple learners may share the same machine with minor effort.<br />
*Sugar shares your Mac's media effortlessly. CD/DVD, Network, etc.<br />
<br />
<br />
All this is possible by using Virtual Machine software. Virtualization puts an entire computer into a file on your Intel Mac. Install Sugar in that file and boot it with a Virtual computer. Once the boot finishes, you have '''Sugar in a Window'''. There are many virtualization applications for Intel Mac, to name a few:<br />
*VirtualBox<br />
*Parallels<br />
*Fusion<br />
<br />
VirtualBox has a free to use license. Learn how to use it here: [[VirtualBox#OS_X |VirtualBox]]. Instructions for other applications may be available on this wiki and elsewhere.<br> '''Note:''' Virtualization doesn't have a speed penalty like emulation. The use of intel processor Emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Linux and Sugar will drastically outperform emulation.<br />
<br><br><br><br />
{{Anchor|3}}<br />
==Farewell '''Mac'''. Hello '''Sugar'''.==<br />
Linux runs on Mac.<br><br />
Sugar runs on Linux.<br><br />
A two step install of both Linux then Sugar onto an erased Hard Drive will work on most Macintosh computers including powerPC Mac and Intel Mac. <br><br><br />
{{Anchor|4}}<br />
'''To identify the Mac's processor and OS X version'''<br><br />
Choose '''Apple menu''' > About This Mac. A small window will appear titled ''About This Mac''. The processor type should be in the window.<br>Note: ''Sugar on a Stick is for the intel processor only. Macs with powerPC will need to get their sugar from a Linux distribution.''<br> <br><br />
<br />
'''To get started, get Linux'''<br><br />
Sugar has been ported by the major Linux distributions and many minor ones. There are many choices available for easy installation; but after first boot, their support for Sugar varies. Search the internet for Linux Mac powerPC Install. Once you've found a version of Linux for your processor, search within to see if Sugar is pre-packaged for easy install and what support or discussions they've had. <!--Those stating educational focus may provide a better experience. But without published reviews, this is baseless bias. --> <!-- Two distributions leave powerPC unsupported: Sugar on a Stick and Toast ''aka Trisquel education distribution'' --><br />
<br><br><br><br><br />
<br />
<br />
<br />
<big>'''Other ways to get Sugar on your Mac'''</big><br><br />
'''Sugar on a Stick''' loaded USB devices should run on Intel Macs. Follow these instructions '''every time''' you wish to use your '''Sugar on a Stick''' device on an intel Mac:<br />
*Boot the Mac with the boot-helper CD <br />
*interrupt the boot sequence<br />
*edit the kernel parameters<br />
vmlinuz0 initrd=initrd0.img root=LABEL=FEDORA rootfstype=iso9660 rw liveimg overlay=LABEL=soas-2-blueberry quiet rhgb selinux=0<br />
*continue the boot.<br />
<br />
You can create a '''Sugar on a Stick''' device with a Mac. However, to save the Journal you must create your stick on a PC or Linux machine: Instructions for [[Sugar_on_a_Stick/Windows|Windows]] and [[Sugar_on_a_Stick/Linux|Linux]] <!-- Have you tried to run the livecd-iso-to-disk bash script with --efi option on a 32-bit Intel Mac? (do they exist?) (would a bash script even run? could it be modified to run on a Mac, for example, substitute $(readlink -f "$2") calls with $(readlink "$2") and whatever else is required?) See http://www.mail-archive.com/soas@lists.sugarlabs.org/msg01010.html and https://answers.edge.launchpad.net/soas/+question/95622 --><br />
<br />
# Download the boot helper from: http://download.sugarlabs.org/soas/releases/soas-boot.iso<br />
# Put in the boot-helper CD<br />
# Plug in the USB<br />
# Turn on the Mac<br />
# At the chime press the "C" key<br />
<br />
The Mac should boot first from the CD then from the USB device. <br />
As of 12 April 2009, this is experimental. Let us know what results you get.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/Live_CD&diff=52172Macintosh/Live CD2010-05-19T03:01:57Z<p>Interested: /* Restart, Play. Restart, Mac. */</p>
<hr />
<div>==Restart, '''Play.''' Restart, '''Mac.'''==<br />
Get a hands on experience with Sugar by booting from a CD. Restart and return to your Mac, completely unchanged. This is the easiest way to get a '''Taste of Sugar''' on a Mac. <br />
<br><br><br />
<br />
'''To Get Started''' choose your flavor:<br><br />
* intel processor<br />
* powerPC processor<br />
<br />
[[Sugar_on_a_Mac/processor | Click to discover the processor]] at the heart of your Mac.<br />
<br><br><br />
<br />
'''To Download'''<br><br />
<!-- mirabele --><br />
Download a LiveOS image. <br />
<br />
Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br><br><br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><br />
''Replace mySugarFlavor with the name of the file you downloaded.''<br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/mySugarFlavor.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/mySugarFlavor.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br><br><br />
<br />
'''To burn onto CD'''<br><br />
* Open the Disk Utility. Drag the downloaded .iso file to the bottom of the list.<br />
* Select your flavor .iso in the list, then press the Burn button. <br />
* Insert a blank CD disc when prompted.<br />
The CD created is '''bootable in most PC'''s including Intel Mac. Please burn many copies and share them freely.<br />
<br><br><br />
<br />
'''To try a Taste of Sugar'''<br><br />
* Insert the CD you burned.<br />
* Press the Power Button on the Intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the Sugar logo appears.<br />
<br><br />
<br />
A Taste of Sugar is a safe read-only experience that doesn't write or remember anything. Unfortunately, this means the Journal is not saved. Nothing is saved. '''All learner progress is lost when the machine reboots.''' A Taste of Sugar is only a demonstration and is not intended to be used on a recurring basis. See [[#2 | Sugar in a Window]] or [[#3 | Sugar on Linux]] to install Sugar for a learner.<br />
<br><br><br><br />
{{Anchor|2}}</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/Live_CD&diff=52171Macintosh/Live CD2010-05-19T02:58:17Z<p>Interested: /* Restart, Play. Restart, Mac. */</p>
<hr />
<div>==Restart, '''Play.''' Restart, '''Mac.'''==<br />
Get a hands on experience with Sugar by booting from a CD. Restart and return to your Mac, completely unchanged. This is the easiest way to get a '''Taste of Sugar''' on a Mac. <br />
<br><br><br />
<br />
'''To Get Started''' choose your flavor:<br><br />
* intel processor<br />
* powerPC processor<br />
<br />
[[Sugar_on_a_Mac/processor | Click to discover the processor]] at the heart of your Mac.<br />
<br><br><br />
<br />
'''To Download'''<br><br />
<!-- mirabele --><br />
Download<br />
<br />
Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br><br><br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><br />
''Replace mySugarFlavor with the name of the file you downloaded.''<br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/mySugarFlavor.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/mySugarFlavor.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br><br><br />
<br />
'''To burn onto CD'''<br><br />
* Open the Disk Utility. Drag the downloaded .iso file to the bottom of the list.<br />
* Select your flavor .iso in the list, then press the Burn button. <br />
* Insert a blank CD disc when prompted.<br />
The CD created is '''bootable in most PC'''s including Intel Mac. Please burn many copies and share them freely.<br />
<br><br><br />
<br />
'''To try a Taste of Sugar'''<br><br />
* Insert the CD you burned.<br />
* Press the Power Button on the Intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the Sugar logo appears.<br />
<br><br />
<br />
A Taste of Sugar is a safe read-only experience that doesn't write or remember anything. Unfortunately, this means the Journal is not saved. Nothing is saved. '''All learner progress is lost when the machine reboots.''' A Taste of Sugar is only a demonstration and is not intended to be used on a recurring basis. See [[#2 | Sugar in a Window]] or [[#3 | Sugar on Linux]] to install Sugar for a learner.<br />
<br><br><br><br />
{{Anchor|2}}</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Sugar_on_a_Mac/processor&diff=52170Sugar on a Mac/processor2010-05-19T02:49:11Z<p>Interested: Created page with ''''To identify the Mac's processor and OS X version'''<br> Choose '''Apple menu''' > About This Mac. A small window will appear titled ''About This Mac''. The processor type...'</p>
<hr />
<div>'''To identify the Mac's processor and OS X version'''<br><br />
Choose '''Apple menu''' > About This Mac.<br />
<br />
A small window will appear titled ''About This Mac''. <br />
The processor type will be listed in the window.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/Live_CD&diff=52169Macintosh/Live CD2010-05-19T02:39:55Z<p>Interested: /* Restart, Play. Restart, Mac. */</p>
<hr />
<div>==Restart, '''Play.''' Restart, '''Mac.'''==<br />
Get a hands on experience with Sugar by booting from a CD. Restart and return to your Mac, completely unchanged. This is the easiest way to get a '''Taste of Sugar''' on a Mac. <br />
<br><br><br />
<br />
'''To Get Started''' choose your flavor:<br><br />
* intel processor<br />
* powerPC processor<br />
<br />
[[#4 | Click to discover the processor]] at the heart of your Mac.<br />
<br><br><br />
<br />
'''To Download'''<br><br />
<!-- mirabele --><br />
Download<br />
<br />
Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br><br><br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><br />
''Replace mySugarFlavor with the name of the file you downloaded.''<br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/mySugarFlavor.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/mySugarFlavor.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br><br><br />
<br />
'''To burn onto CD'''<br><br />
* Open the Disk Utility. Drag the downloaded .iso file to the bottom of the list.<br />
* Select your flavor .iso in the list, then press the Burn button. <br />
* Insert a blank CD disc when prompted.<br />
The CD created is '''bootable in most PC'''s including Intel Mac. Please burn many copies and share them freely.<br />
<br><br><br />
<br />
'''To try a Taste of Sugar'''<br><br />
* Insert the CD you burned.<br />
* Press the Power Button on the Intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the Sugar logo appears.<br />
<br><br />
<br />
A Taste of Sugar is a safe read-only experience that doesn't write or remember anything. Unfortunately, this means the Journal is not saved. Nothing is saved. '''All learner progress is lost when the machine reboots.''' A Taste of Sugar is only a demonstration and is not intended to be used on a recurring basis. See [[#2 | Sugar in a Window]] or [[#3 | Sugar on Linux]] to install Sugar for a learner.<br />
<br><br><br><br />
{{Anchor|2}}</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/Live_CD&diff=52168Macintosh/Live CD2010-05-19T02:14:47Z<p>Interested: /* Restart, Play. Restart, Mac. */</p>
<hr />
<div>==Restart, '''Play.''' Restart, '''Mac.'''==<br />
Get a hands on experience with Sugar by booting from a CD. Restart and return to your Mac, completely unchanged. This is the easiest way to get a '''Taste of Sugar''' on a Mac. <br />
<br><br><br />
<br />
'''To Get Started''' choose your flavor:<br><br />
* intel processor<br />
* powerPC processor<br />
<br />
[[#4 | Click to discover the processor]] at the heart of your Mac.<br />
<br />
Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br><br><br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><br />
''Replace mySugarFlavor with the name of the file you downloaded.''<br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/mySugarFlavor.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/mySugarFlavor.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br><br><br />
<br />
'''To burn onto CD'''<br><br />
* Open the Disk Utility. Drag the downloaded .iso file to the bottom of the list.<br />
* Select your flavor .iso in the list, then press the Burn button. <br />
* Insert a blank CD disc when prompted.<br />
The CD created is '''bootable in most PC'''s including Intel Mac. Please burn many copies and share them freely.<br />
<br><br><br />
<br />
'''To try a Taste of Sugar'''<br><br />
* Insert the CD you burned.<br />
* Press the Power Button on the Intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the Sugar logo appears.<br />
<br><br />
<br />
A Taste of Sugar is a safe read-only experience that doesn't write or remember anything. Unfortunately, this means the Journal is not saved. Nothing is saved. '''All learner progress is lost when the machine reboots.''' A Taste of Sugar is only a demonstration and is not intended to be used on a recurring basis. See [[#2 | Sugar in a Window]] or [[#3 | Sugar on Linux]] to install Sugar for a learner.<br />
<br><br><br><br />
{{Anchor|2}}</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh/Live_CD&diff=52167Macintosh/Live CD2010-05-19T02:09:36Z<p>Interested: Created page with '==Restart, '''Play.''' Restart, '''Mac.'''== Get a hands on experience with Sugar by booting from a CD. Restart and return to your Mac, completely unchanged. This is the easiest ...'</p>
<hr />
<div>==Restart, '''Play.''' Restart, '''Mac.'''==<br />
Get a hands on experience with Sugar by booting from a CD. Restart and return to your Mac, completely unchanged. This is the easiest way to get a '''Taste of Sugar''' on a Mac. <br />
<br><br><br />
<br />
'''To Get Started''' pick a flavor:<br><br />
* [http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso Strawberry v1] for intel processor<br />
* [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Blueberry v2] for intel processor<br />
* [http://alt.fedoraproject.org/pub/alt/nightly-composes/soas/ Mirabelle beta] for intel processor<br />
* [[#3 | Linux]] for powerPC processor<br />
<br />
[[#4 | Click to discover the processor]] at the heart of your Mac.<br />
<br />
Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br><br><br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><br />
''Replace mySugarFlavor with the name of the file you downloaded.''<br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/mySugarFlavor.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/mySugarFlavor.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br><br><br />
<br />
'''To burn onto CD'''<br><br />
* Open the Disk Utility. Drag the downloaded .iso file to the bottom of the list.<br />
* Select your flavor .iso in the list, then press the Burn button. <br />
* Insert a blank CD disc when prompted.<br />
The CD created is '''bootable in most PC'''s including Intel Mac. Please burn many copies and share them freely.<br />
<br><br><br />
<br />
'''To try a Taste of Sugar'''<br><br />
* Insert the CD you burned.<br />
* Press the Power Button on the Intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the Sugar logo appears.<br />
<br><br />
<br />
A Taste of Sugar is a safe read-only experience that doesn't write or remember anything. Unfortunately, this means the Journal is not saved. Nothing is saved. '''All learner progress is lost when the machine reboots.''' A Taste of Sugar is only a demonstration and is not intended to be used on a recurring basis. See [[#2 | Sugar in a Window]] or [[#3 | Sugar on Linux]] to install Sugar for a learner.<br />
<br><br><br><br />
{{Anchor|2}}</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=Macintosh&diff=51977Macintosh2010-05-12T06:57:52Z<p>Interested: Created page with '<noinclude>Category:HowTo Category:Apple Macintosh </noinclude> There are many options for using Sugar on an Apple Macintosh Computer. {{Definition_table |width=12em|Tas...'</p>
<hr />
<div><noinclude>[[Category:HowTo]]<br />
[[Category:Apple Macintosh]]<br />
</noinclude><br />
<br />
There are many options for using Sugar on an Apple Macintosh Computer.<br />
{{Definition_table<br />
|width=12em|Taste of Sugar | <!-- Read only LiveOS image<br />
--> provides a safe read-only experience that does not alter your Mac. Get to know the Sugar Learning Platform by using it first hand. The quickest way to experience Sugar is to [[#1 | go here...]]<br />
|Sugar in a Window | <!--Virtualization of a Linux OS with Sugar installed <br />
--> installs to a directory on your Hard Disk. In a Window or Full Screen you can switch between Mac and Sugar instantly. Your journal is safe and remembered between restarts. [[#2 | Read more... ]]<br />
|Sugar on Linux | <!-- Bootable installation of a Linux OS with Sugar installed <br />
--> Linux runs on Apple computers long after Apple discontinues support. There are many choices available for easy installation; but after first boot, their support for Sugar varies. <!--Those stating educational focus may provide a better experience. But this is baseless bias. --> [[#3 | Read more... ]]<br />
}}<br />
<br><br><br><br />
{{Anchor|1}}<br />
==Restart, '''Play.''' Restart, '''Mac.'''==<br />
Get a hands on experience with Sugar by booting from a CD. Restart and return to your Mac, completely unchanged. This is the easiest way to get a '''Taste of Sugar''' on a Mac. <br />
<br><br><br />
<br />
'''To Get Started''' pick a flavor:<br><br />
* [http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso Strawberry v1] for intel processor<br />
* [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Blueberry v2] for intel processor<br />
* [http://alt.fedoraproject.org/pub/alt/nightly-composes/soas/ Mirabelle beta] for intel processor<br />
* [[#3 | Linux]] for powerPC processor<br />
<br />
[[#4 | Click to discover the processor]] at the heart of your Mac.<br />
<br />
Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br><br><br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><br />
''Replace mySugarFlavor with the name of the file you downloaded.''<br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/mySugarFlavor.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/mySugarFlavor.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br><br><br />
<br />
'''To burn onto CD'''<br><br />
* Open the Disk Utility. Drag the downloaded .iso file to the bottom of the list.<br />
* Select your flavor .iso in the list, then press the Burn button. <br />
* Insert a blank CD disc when prompted.<br />
The CD created is '''bootable in most PC'''s including Intel Mac. Please burn many copies and share them freely.<br />
<br><br><br />
<br />
'''To try a Taste of Sugar'''<br><br />
* Insert the CD you burned.<br />
* Press the Power Button on the Intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the Sugar logo appears.<br />
<br><br />
<br />
A Taste of Sugar is a safe read-only experience that doesn't write or remember anything. Unfortunately, this means the Journal is not saved. Nothing is saved. '''All learner progress is lost when the machine reboots.''' A Taste of Sugar is only a demonstration and is not intended to be used on a recurring basis. See [[#2 | Sugar in a Window]] or [[#3 | Sugar on Linux]] to install Sugar for a learner.<br />
<br><br><br><br />
{{Anchor|2}}<br />
==Click '''Sugar'''. Click '''Mac'''.==<br />
Use Mac and Sugar at the same time on the same computer. '''Sugar in a Window''' allows you to switch instantly between them. This is the most flexible way of using Sugar on an intel Mac.<br />
<br />
*The Journal is saved to disk, so a learner's work is preserved. <br />
*Multiple learners may share the same machine with minor effort.<br />
*Sugar shares your Mac's media effortlessly. CD/DVD, Network, etc.<br />
<br />
<br />
All this is possible by using Virtual Machine software. Virtualization puts an entire computer into a file on your Intel Mac. Install Sugar in that file and boot it with a Virtual computer. Once the boot finishes, you have '''Sugar in a Window'''. There are many virtualization applications for Intel Mac, to name a few:<br />
*VirtualBox<br />
*Parallels<br />
*Fusion<br />
<br />
VirtualBox has a free to use license. Learn how to use it here: [[VirtualBox#OS_X |VirtualBox]]. Instructions for other applications may be available on this wiki and elsewhere.<br> '''Note:''' Virtualization doesn't have a speed penalty like emulation. The use of intel processor Emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Linux and Sugar will drastically outperform emulation.<br />
<br><br><br><br />
{{Anchor|3}}<br />
==Farewell '''Mac'''. Hello '''Sugar'''.==<br />
Linux runs on Mac.<br><br />
Sugar runs on Linux.<br><br />
A two step install of both Linux then Sugar onto an erased Hard Drive will work on most Macintosh computers including powerPC Mac and Intel Mac. <br><br><br />
{{Anchor|4}}<br />
'''To identify the Mac's processor and OS X version'''<br><br />
Choose '''Apple menu''' > About This Mac. A small window will appear titled ''About This Mac''. The processor type should be in the window.<br>Note: ''Sugar on a Stick is for the intel processor only. Macs with powerPC will need to get their sugar from a Linux distribution.''<br> <br><br />
<br />
'''To get started, get Linux'''<br><br />
Sugar has been ported by the major Linux distributions and many minor ones. There are many choices available for easy installation; but after first boot, their support for Sugar varies. Search the internet for Linux Mac powerPC Install. Once you've found a version of Linux for your processor, search within to see if Sugar is pre-packaged for easy install and what support or discussions they've had. <!--Those stating educational focus may provide a better experience. But without published reviews, this is baseless bias. --> <!-- Two distributions leave powerPC unsupported: Sugar on a Stick and Toast ''aka Trisquel education distribution'' --><br />
<br><br><br><br><br />
<br />
<br />
<br />
<big>'''Other ways to get Sugar on your Mac'''</big><br><br />
'''Sugar on a Stick''' loaded USB devices should run on Intel Macs. Follow these instructions '''every time''' you wish to use your '''Sugar on a Stick''' device on an intel Mac:<br />
*Boot the Mac with the boot-helper CD <br />
*interrupt the boot sequence<br />
*edit the kernel parameters<br />
vmlinuz0 initrd=initrd0.img root=LABEL=FEDORA rootfstype=iso9660 rw liveimg overlay=LABEL=soas-2-blueberry quiet rhgb selinux=0<br />
*continue the boot.<br />
<br />
You can create a '''Sugar on a Stick''' device with a Mac. However, to save the Journal you must create your stick on a PC or Linux machine: Instructions for [[Sugar_on_a_Stick/Windows|Windows]] and [[Sugar_on_a_Stick/Linux|Linux]] <!-- Have you tried to run the livecd-iso-to-disk bash script with --efi option on a 32-bit Intel Mac? (do they exist?) (would a bash script even run? could it be modified to run on a Mac, for example, substitute $(readlink -f "$2") calls with $(readlink "$2") and whatever else is required?) See http://www.mail-archive.com/soas@lists.sugarlabs.org/msg01010.html and https://answers.edge.launchpad.net/soas/+question/95622 --><br />
<br />
# Download the boot helper from: http://download.sugarlabs.org/soas/releases/soas-boot.iso<br />
# Put in the boot-helper CD<br />
# Plug in the USB<br />
# Turn on the Mac<br />
# At the chime press the "C" key<br />
<br />
The Mac should boot first from the CD then from the USB device. <br />
As of 12 April 2009, this is experimental. Let us know what results you get.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=51972SoaS Blueberry Instructions2010-05-12T03:34:53Z<p>Interested: /* To calculate a file's SHA-1 checksum */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
<div style="background: #ffe792; padding: 10px; border: 1px solid #cde7a8" align=left>'''NOTE to Instruction Editors:''' Please test and adjust instructions for the soon-to-be-released [[Sugar on a Stick/Mirabelle]].<br />
Draft instructions at [[Sugar on a Stick/Beta]] and [[SoaS Mirabelle Instructions]].</div><br />
<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
* See also [[Sugar on a Stick/Mac]].<br />
<br />
====To identify the Mac's processor and OS X version====<br />
Choose '''Apple menu''' > About This Mac. A small window will appear titled ''About This Mac''. The processor type should be in the window.<br />
<br />
====To download Sugar on a Stick====<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
====To calculate a file's SHA-1 checksum====<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac ]<br>''PythonLauncher may automatically open the file; don't allow that, just download it.''<br />
<br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To create a Boot Helper CD'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the Disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Select the Disc Image in the list, then press the Burn button. <br />
* Insert a blank disc when prompted.<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.<br />
* insert the Boot Helper CD.<br />
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the sugar logo appears.<br />
<br />
===Suggestion: Using boot_helper_disk_with_blueberry_usb_on_intel_mac (may fix bugs listed below)===<br />
'''Link:'''[http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions#Using_boot_helper_disk_with_blueberry_usb_on_intel_mac]<br />
<br />
<br />
==== Mac Bugs ====<br />
''The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac''<br>''Note: to the child it is named SUGAR. But the stick they take home is named FEDORA.''<!-- How do you file style bugs? <br />
bugs.sugarlabs.org will take task and enhancement requests in addition to defect reports.<br />
Forcing users to rename their USB sticks something esoteric like FEDORA is just wrong --><br />
<br><br><br />
<!--I'd prefer something more legible than white text on white background when entering secret codes. --><br />
*BootHelperCD cannot boot Mac without typing secret code into difficult to read window:<br> ''for complete details [[ Talk:SoaS_Blueberry_Instructions#Using_boot_helper_disk_with_blueberry_usb_on_intel_mac | click here ]]''<br />
<!--See the end of this discussion, http://answers.edge.launchpad.net/soas/+question/95622. It provides a way to edit the boot kernel arguments to boot on a Mac. You may be able to advance the instructions from there. --><br />
** press the tab key to interrupt the boot sequence.<br />
** append selinux=0 to the kernel's list of boot parameters.<br />
** press return or enter to continue the boot process.<br />
Submit bugs to request a different flavor of boot helper CD that boots Mac automatically, without typing selinux=0 and removes the countdown, Macs innately have the option key interrupt, the mouse down interrupt and the power button interrupt to handle this boot time issue.<br />
<br><br />
*BootHelperCD will not boot sticks created by a Mac:<br />
** BootHelperCD can only boot sticks named FEDORA.<br />
** Image-writer-mac writes the name blueberry-2-soas onto the stick.<br />
** USB stick is created as read only. So the name is not easily changed by mere mortals.<br />
This is a showstopper.<br>You cannot boot without hacking the USB stick name.<br>Use windows instructions to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br><br />
*Sugar on a Stick is READ-ONLY when created by a Mac:<br />
**Nothing is saved between reboots. Sugar asks for your name and colors each boot.<br />
**image-writer-mac does not create a persistent overlay file.<br />
There is no way to create a persistent overlay on Mac without hacking the USB stick.<br>Use windows instructions to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=51970SoaS Blueberry Instructions2010-05-12T02:45:26Z<p>Interested: /* Suggestion: Using boot_helper_disk_with_blueberry_usb_on_intel_mac (may fix bugs listed below) */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
* See also [[Sugar on a Stick/Mac]].<br />
<br />
====To identify the Mac's processor and OS X version====<br />
Choose '''Apple menu''' > About This Mac. A small window will appear titled ''About This Mac''. The processor type should be in the window.<br />
<br />
====To download Sugar on a Stick====<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
====To calculate a file's SHA-1 checksum====<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>(If you get an error from PythonLauncher, it may be because you are trying to open the file, don't do that, just download it).<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To create a Boot Helper CD'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Select the Disc Image in the list, then press the Burn button. <br />
* Insert a blank disc when prompted.<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.<br />
* insert the Boot Helper CD.<br />
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the sugar logo appears.<br />
<br />
===Suggestion: Using boot_helper_disk_with_blueberry_usb_on_intel_mac (may fix bugs listed below)===<br />
'''Link:'''[http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions#Using_boot_helper_disk_with_blueberry_usb_on_intel_mac]<br />
<br />
<br />
==== Mac Bugs ====<br />
''The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac''<br>''Note: to the child it is named SUGAR. But the stick they take home is named FEDORA.''<!-- How do you file style bugs? <br />
bugs.sugarlabs.org will take task and enhancement requests in addition to defect reports.<br />
Forcing users to rename their USB sticks something esoteric like FEDORA is just wrong --><br />
<br><br><br />
<!--I'd prefer something more legible than white text on white background when entering secret codes. --><br />
*BootHelperCD cannot boot Mac without typing secret code into difficult to read window:<br> ''for complete details [[ Talk:SoaS_Blueberry_Instructions#Using_boot_helper_disk_with_blueberry_usb_on_intel_mac | click here ]]''<br />
<!--See the end of this discussion, http://answers.edge.launchpad.net/soas/+question/95622. It provides a way to edit the boot kernel arguments to boot on a Mac. You may be able to advance the instructions from there. --><br />
** press the tab key to interrupt the boot sequence.<br />
** append selinux=0 to the kernel's list of boot parameters.<br />
** press return or enter to continue the boot process.<br />
Submit bugs to request a different flavor of boot helper CD that boots Mac automatically, without typing selinux=0<!-- and removes the countdown, Macs innately have the option key interrupt, the mouse down interrupt and the power button interrupt to handle this boot time issue.--><br />
<br><br />
*BootHelperCD will not boot sticks created by a Mac:<br />
** BootHelperCD can only boot sticks named FEDORA.<br />
** Image-writer-mac writes the name blueberry-2-soas onto the stick.<br />
** USB stick is created as read only. So the name is not easily changed by mere mortals.<br />
This is a showstopper.<br>You cannot boot without hacking the USB stick name.<br>Use windows instructions to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br><br />
*Sugar on a Stick is READ-ONLY when created by a Mac:<br />
**Nothing is saved between reboots. Sugar asks for your name and colors each boot.<br />
**image-writer-mac does not create a persistent overlay file.<br />
There is no way to create a persistent overlay on Mac without hacking the USB stick.<br>Use windows instructions to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=51969SoaS Blueberry Instructions2010-05-12T02:14:24Z<p>Interested: </p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
* See also [[Sugar on a Stick/Mac]].<br />
<br />
====To identify the Mac's processor and OS X version====<br />
Choose '''Apple menu''' > About This Mac. A small window will appear titled ''About This Mac''. The processor type should be in the window.<br />
<br />
====To download Sugar on a Stick====<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
====To calculate a file's SHA-1 checksum====<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>(If you get an error from PythonLauncher, it may be because you are trying to open the file, don't do that, just download it).<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To create a Boot Helper CD'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Select the Disc Image in the list, then press the Burn button. <br />
* Insert a blank disc when prompted.<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.<br />
* insert the Boot Helper CD.<br />
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the sugar logo appears.<br />
<br />
===Suggestion: Using boot_helper_disk_with_blueberry_usb_on_intel_mac (may fix bugs listed below)===<br />
'''Link:'''[http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions#Using_boot_helper_disk_with_blueberry_usb_on_intel_mac]<br />
==== Mac Boot Bugs ====<br />
''The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac.''<br>''Note: to the child it is named SUGAR. But the stick they take home is named FEDORA.''<!-- How do you file style bugs? <br />
bugs.sugarlabs.org will take task and enhancement requests in addition to defect reports.<br />
Forcing users to rename their USB sticks something esoteric like FEDORA is just wrong --><br />
<br />
<br />
<!--I'd prefer something more legible than white text on white background when entering secret codes. --><br />
*BootHelperCD cannot boot Mac without typing secret code into difficult to read window:<br> ''See [[#Boot Helper | Boot Helper ]]... "If your boot hangs..." for complete details''<br />
<!--See the end of this discussion, http://answers.edge.launchpad.net/soas/+question/95622. It provides a way to edit the boot kernel arguments to boot on a Mac. You may be able to advance the instructions from there. --><br />
** interrupt the boot sequence<br />
** append selinux=0 to the kernel's list of boot parameters.<br />
** press return or enter to continue the boot process.<br />
Submit bugs to request a different flavor of boot helper CD that boots Mac automatically, without typing selinux=0<!-- and removes the countdown, Macs innately have the option key interrupt, the mouse down interrupt and the power button interrupt to handle this boot time issue.--><br />
<br><br />
*BootHelperCD will not boot sticks created by a Mac.<br />
** BootHelperCD can only boot sticks named FEDORA.<br />
** Image-writer-mac writes the name blueberry-2-soas onto the stick.<br />
** USB stick is created as read only. So the name is not easily changed by mere mortals.<br />
This is a showstopper.<br>You cannot boot without hacking the USB stick name.<br>Use windows instructions to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br><br />
*Sugar on a Stick is READ-ONLY<br />
**Nothing is saved between reboots. Sugar asks for your name and colors each boot.<br />
**image-writer-mac does not create a persistent overlay file.<br />
There is no way to create a persistent overlay on Mac without hacking the USB stick.<br>Use windows instructions to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50767SoaS Blueberry Instructions2010-04-03T06:56:15Z<p>Interested: /* Mac Boot Bugs */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
====To identify the Mac's processor and OS X version====<br />
Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br />
<br />
====To download Sugar on a Stick====<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
====To calculate a file's SHA-1 checksum====<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To create a Boot Helper CD'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Select the Disc Image in the list, then press the Burn button. <br />
* Insert a blank disc when prompted.<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.<br />
* insert the Boot Helper CD.<br />
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the sugar logo appears.<br />
<br />
==== Mac Boot Bugs ====<br />
''The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac.''<br>''Note: to the child it is named SUGAR. But the stick they take home is named FEDORA.''<!-- How do you file style bugs? Foricng users to rename their USB sticks something esoteric like FEDORA is just wrong, it should default to SUGAR. While I'm whining, I'd prefer something more legible than white text on white background when entering secret codes.--><br />
<br />
*image-writer-mac and BootHelperCD are not compatible:<br />
** BootHelperCD can only boot sticks named FEDORA.<br />
** Image-writer gives the USB stick the name of blueberry-2-soas.<br />
** USB stick is created as read only. So the name is not easily changed by mere mortals.<br />
This is a showstopper.<br>You cannot boot without hacking the USB stick name.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*Sugar on a Stick is READ-ONLY<br />
**Nothing is saved between reboots. Sugar asks for your name and colors each boot.<br />
**image-writer-mac does not create a persistent overlay file.<br />
There is no way to create a persistent overlay on Mac without hacking the USB stick.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*BootHelperCD cannot boot Mac without typing secret code into difficult to read window:<br> ''See [[#Boot Helper | Boot Helper ]]... "If your boot hangs..." for complete details''<br />
** interrupt the boot sequence<br />
** append selinux=0 to the kernel's list of boot parameters.<br />
** press return or enter to continue the boot process.<br />
Submit bugs to request a different flavor of boot helper CD that boots Mac automatically, without typing selinux=0<!-- and removes the countdown, Macs innately have the option key interrupt, the mouse down interrupt and the power button interrupt to handle this boot time issue.--><br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50766SoaS Blueberry Instructions2010-04-03T06:40:55Z<p>Interested: /* Mac Boot Bugs */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
====To identify the Mac's processor and OS X version====<br />
Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br />
<br />
====To download Sugar on a Stick====<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
====To calculate a file's SHA-1 checksum====<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To create a Boot Helper CD'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Select the Disc Image in the list, then press the Burn button. <br />
* Insert a blank disc when prompted.<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.<br />
* insert the Boot Helper CD.<br />
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the sugar logo appears.<br />
<br />
==== Mac Boot Bugs ====<br />
''The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac.''<br><br />
<br />
*image-writer-mac and BootHelperCD are not compatible:<br />
** BootHelperCD can only boot sticks named FEDORA.<br />
** Image-writer gives the USB stick the name of blueberry-2-soas.<br />
** USB stick is created as read only. So the name is not easily changed by mere mortals.<br />
This is a showstopper.<br>You cannot boot without hacking the USB stick name.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*Sugar on a Stick is READ-ONLY<br />
**Nothing is saved between reboots. Sugar asks for your name and colors each boot.<br />
**image-writer-mac does not create a persistent overlay file.<br />
There is no way to create a persistent overlay on Mac without hacking the USB stick.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*BootHelperCD cannot boot Mac without typing secret code into difficult to read window:<br> ''See [[#Boot Helper | Boot Helper ]]... "If your boot hangs..." for complete details''<br />
** interrupt the boot sequence<br />
** append selinux=0 to the kernel's list of boot parameters.<br />
** press return or enter to continue the boot process.<br />
Submit bugs to request a version of boot helper CD that boots Mac automatically, without typing selinux=0<br><br />
''Note: to a child it is named SUGAR. But the stick they take home is named FEDORA.''<!-- How do you file style bugs? Foricng users to rename their USB sticks something esoteric like FEDORA is just wrong, it should default to SUGAR. While I'm whining, I'd prefer something more legible than white text on white background when entering secret codes.--><br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50765SoaS Blueberry Instructions2010-04-03T06:26:47Z<p>Interested: /* Mac Boot Bugs */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
====To identify the Mac's processor and OS X version====<br />
Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br />
<br />
====To download Sugar on a Stick====<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
====To calculate a file's SHA-1 checksum====<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To create a Boot Helper CD'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Select the Disc Image in the list, then press the Burn button. <br />
* Insert a blank disc when prompted.<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.<br />
* insert the Boot Helper CD.<br />
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the sugar logo appears.<br />
<br />
==== Mac Boot Bugs ====<br />
''The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac.''<br><br />
<br />
*image-writer-mac and BootHelperCD are not compatible:<br />
** BootHelperCD can only boot sticks named FEDORA.<br />
** Image-writer gives the USB stick the name of blueberry-2-soas.<br />
** USB stick is created as read only. So the name is not easily changed by mere mortals.<br />
This is a showstopper.<br>You cannot boot without hacking the USB stick name.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*Sugar on a Stick is READ-ONLY<br />
**Nothing is saved between reboots. Sugar asks for your name and colors each boot.<br />
**image-writer-mac does not create a persistent overlay file.<br />
There is no way to create a persistent overlay on Mac without hacking the USB stick.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*BootHelperCD cannot boot Mac without typing secret code into difficult to read window:<br> ''See [[#Boot Helper | Boot Helper ]]... "If your boot hangs..." for complete details''<br />
** interrupt the boot sequence<br />
** append selinux=0 to the kernel's list of boot parameters.<br />
** press return or enter to continue the boot process.<br />
Submit bugs to request a boot helperCD that boots without selinux=0<br>Note: the product is for children. For them the product is named SUGAR. Foricng users to rename their USB sticks something esoteric like FEDORA is just wrong.<!-- While I'm whining, I'd prefer something more legible than white text on white background when entering secret codes. --><br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50764SoaS Blueberry Instructions2010-04-03T06:05:44Z<p>Interested: /* Mac Boot Bugs */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
====To identify the Mac's processor and OS X version====<br />
Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br />
<br />
====To download Sugar on a Stick====<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
====To calculate a file's SHA-1 checksum====<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To create a Boot Helper CD'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Select the Disc Image in the list, then press the Burn button. <br />
* Insert a blank disc when prompted.<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.<br />
* insert the Boot Helper CD.<br />
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the sugar logo appears.<br />
<br />
==== Mac Boot Bugs ====<br />
''The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac.''<br><br />
<br />
*image-writer-mac and BootHelperCD are not compatible:<br />
** BootHelperCD can only boot sticks named FEDORA.<br />
** Image-writer gives the USB stick the name of blueberry-2-soas.<br />
** USB stick is created as read only. So the name is not easily changed by mere mortals.<br />
This is a showstopper.<br>You cannot boot without hacking the USB stick name.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*Sugar on a Stick is READ-ONLY<br />
**Nothing is saved between reboots. Sugar asks for your name and colors each boot.<br />
**image-writer-mac does not create a persistent overlay file.<br />
There is no way to create a persistent overlay on Mac without hacking the USB stick.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*BootHelperCD cannot boot Mac without typing secret code into difficult to read window:<br> ''See [[#Boot Helper | Boot Helper ]]... "If your boot hangs..." for complete details''<br />
** interrupt the boot sequence<br />
** append selinux=0 to the kernel's list of boot parameters.<br />
** press return or enter to continue the boot process.<br />
Submit bugs and gripe at developers until they create a boot helperCD that boots without selinux=0<br>We'd prefer something more legible than white text on white background.<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50763SoaS Blueberry Instructions2010-04-03T06:00:42Z<p>Interested: /* For Mac OS X Users */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
====To identify the Mac's processor and OS X version====<br />
Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br />
<br />
====To download Sugar on a Stick====<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
====To calculate a file's SHA-1 checksum====<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To create a Boot Helper CD'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Select the Disc Image in the list, then press the Burn button. <br />
* Insert a blank disc when prompted.<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.<br />
* insert the Boot Helper CD.<br />
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the sugar logo appears.<br />
<br />
==== Mac Boot Bugs ====<br />
''The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac.''<br><br />
<br />
*image-writer-mac and BootHelperCD are not compatible:<br />
** BootHelperCD can only boot sticks named FEDORA.<br />
** Image-writer gives the USB stick the name of blueberry-2-soas.<br />
** USB stick is created as read only. So the name is not easily changed by mere mortals.<br />
This is a showstopper.<br>You cannot boot without hacking the USB stick name.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*Sugar on a Stick is READ-ONLY<br />
**Nothing is saved between reboots. Sugar asks for your name and colors each boot.<br />
**image-writer-mac does not create a persistent overlay file.<br />
There is no way to create a persistent overlay on Mac without hacking the USB stick.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*BootHelperCD cannot boot Mac without typing secret code into difficult to read window:<br> ''See [[#Boot Helper | Boot Helper ]] for complete details''<br />
** interrupt the boot sequence<br />
** append selinux=0 to the kernel's list of boot parameters.<br />
** press return or enter to continue the boot process.<br />
Submit bugs and gripe at developers until they create a boot helperCD that boots without selinux=0<br>We'd prefer something more legible than white text on white background.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50762SoaS Blueberry Instructions2010-04-03T05:59:17Z<p>Interested: /* For Mac OS X Users */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
====To identify the Mac's processor and OS X version====<br />
Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br />
<br />
====To download Sugar on a Stick====<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
====To calculate a file's SHA-1 checksum====<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To create a Boot Helper CD'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Select the Disc Image in the list, then press the Burn button. <br />
* Insert a blank disc when prompted.<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.<br />
* insert the Boot Helper CD.<br />
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the sugar logo appears.<br />
<br />
==== Mac Boot Bugs ====<br />
''The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac.''<br><br />
<br />
*image-writer-mac and BootHelperCD are not compatible:<br />
** BootHelperCD can only boot sticks named FEDORA.<br />
** Image-writer gives the USB stick the name of blueberry-2-soas.<br />
** USB stick is created as read only. So the name is not easily changed by mere mortals.<br />
This is a showstopper.<br>You cannot boot without hacking the USB stick name.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*Sugar on a Stick is READ-ONLY<br />
**Nothing is saved between reboots. Sugar asks for your name and colors each boot.<br />
**image-writer-mac does not create a persistent overlay file.<br />
There is no way to create a persistent overlay on Mac without hacking the USB stick.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*BootHelperCD cannot boot Mac without typing secret code into difficult to read window:<br> ''See [[# Boot Helper | Boot Helper ]] for complete details''<br />
** interrupt the boot sequence<br />
** append selinux=0 to the kernel's list of boot parameters.<br />
** press return or enter to continue the boot process.<br />
Submit bugs and gripe at developers until they create a boot helperCD that boots without selinux=0<br>We'd prefer something more legible than white text on white background.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50761SoaS Blueberry Instructions2010-04-03T05:50:21Z<p>Interested: /* To calculate a file's SHA-1 checksum */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
====To identify the Mac's processor and OS X version====<br />
Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br />
<br />
====To download Sugar on a Stick====<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
====To calculate a file's SHA-1 checksum====<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To create a Boot Helper CD'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Select the Disc Image in the list, then press the Burn button. <br />
* Insert a blank disc when prompted.<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.<br />
* insert the Boot Helper CD.<br />
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the sugar logo appears.<br />
<br />
==== Mac Boot Bugs ====<br />
''The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac.''<br><br />
<br />
*image-writer-mac and BootHelperCD are not compatible:<br />
** BootHelperCD can only boot sticks named FEDORA.<br />
** Image-writer gives the USB stick the name of blueberry-2-soas.<br />
** USB stick is created as read only. So the name is not easily changed by mere mortals.<br />
This is a showstopper.<br>You cannot boot without hacking the USB stick name.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*Sugar on a Stick is READ-ONLY<br />
**Nothing is saved between reboots. Sugar asks for your name and colors each boot.<br />
**image-writer-mac does not create a persistent overlay file.<br />
There is no way to create a persistent overlay on Mac without hacking the USB stick.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*BootHelperCD cannot boot Mac without typing secret code into difficult to read window:<br />
** interrupt the countdown boot sequence by pressing F4. Unless you're on that other screen, where you press TAB key. <br />
** append selinux=0 to the kernel's list of boot parameters.<br />
** press return or enter to continue the boot process.<br />
Submit bugs and gripe at developers until they create a boot helperCD that boots without selinux=0<br>We'd prefer something more legible than white text on white background.<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50760SoaS Blueberry Instructions2010-04-03T05:41:45Z<p>Interested: /* Mac Boot Bugs */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
====To identify the Mac's processor and OS X version====<br />
Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br />
<br />
====To download Sugar on a Stick====<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
====To calculate a file's SHA-1 checksum====<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To create a Boot Helper CD'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Press the Burn button. Insert a blank disc when prompted.<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.<br />
* insert the Boot Helper CD.<br />
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the sugar logo appears. <br />
<br />
<br />
==== Mac Boot Bugs ====<br />
''The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac.''<br><br />
<br />
*image-writer-mac and BootHelperCD are not compatible:<br />
** BootHelperCD can only boot sticks named FEDORA.<br />
** Image-writer gives the USB stick the name of blueberry-2-soas.<br />
** USB stick is created as read only. So the name is not easily changed by mere mortals.<br />
This is a showstopper.<br>You cannot boot without hacking the USB stick name.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*Sugar on a Stick is READ-ONLY<br />
**Nothing is saved between reboots. Sugar asks for your name and colors each boot.<br />
**image-writer-mac does not create a persistent overlay file.<br />
There is no way to create a persistent overlay on Mac without hacking the USB stick.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*BootHelperCD cannot boot Mac without typing secret code into difficult to read window:<br />
** interrupt the countdown boot sequence by pressing F4. Unless you're on that other screen, where you press TAB key. <br />
** append selinux=0 to the kernel's list of boot parameters.<br />
** press return or enter to continue the boot process.<br />
Submit bugs and gripe at developers until they create a boot helperCD that boots without selinux=0<br>We'd prefer something more legible than white text on white background.<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50759SoaS Blueberry Instructions2010-04-03T05:34:58Z<p>Interested: /* For Mac OS X Users */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
====To identify the Mac's processor and OS X version====<br />
Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br />
<br />
====To download Sugar on a Stick====<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
====To calculate a file's SHA-1 checksum====<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To create a Boot Helper CD'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Press the Burn button. Insert a blank disc when prompted.<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.<br />
* insert the Boot Helper CD.<br />
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the sugar logo appears. <br />
<br />
<br />
==== Mac Boot Bugs ====<br />
''The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac.''<br><br />
<br />
*image-writer-mac and BootHelperCD are not compatible:<br />
** BootHelperCD can only boot sticks named FEDORA<br />
** Image-writer gives the USB stick the name of blueberry-2-soas<br />
** USB stick is created as read only. So the name is not easily changed by mere mortals.<br />
This is a showstopper.<br>You cannot boot without hacking the USB stick name.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*Sugar on a Stick is READ-ONLY<br />
**Nothing is saved between reboots. Sugar asks for your name and colors each boot.<br />
**imge-writer-mac does not create a persistent overlay file.<br />
There is no way to create a persistent overlay on Mac without hacking the USB stick.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*BootHelperCD cannot boot Mac without typing secret code into difficult to read window:<br />
** interrupt the countdown boot sequence by pressing F4 <br />
** append selinux=0 to the kernel's list of boot parameters<br />
** press return or enter to continue the boot process<br />
Submit bugs and gripe at developers until they create a boot helperCD that boots without selinux=0<br>We'd prefer something more legible than white text on white background.<br />
<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50758SoaS Blueberry Instructions2010-04-03T05:27:55Z<p>Interested: /* For Mac OS X Users */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
<br />
'''To identify the Mac's processor and OS X version'''<br>Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br> <br />
<br />
===To download Sugar on a Stick===<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
===To calculate a file's SHA-1 checksum===<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To create a Boot Helper CD'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Press the Burn button. Insert a blank disc when prompted.<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.<br />
* insert the Boot Helper CD.<br />
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the sugar logo appears. <br />
<br />
<br />
==== Mac Boot Bugs ====<br />
''The boot sequence does not work properly due to minor bugs. Follow these workarounds to boot an intel Mac.''<br><br />
<br />
*image-writer-mac and BootHelperCD are not compatible:<br />
** BootHelperCD can only boot sticks named FEDORA<br />
** Image-writer gives the USB stick the name of blueberry-2-soas<br />
** USB stick is created as read only. So the name is not easily changed by mere mortals.<br />
This is a showstopper.<br>You cannot boot without hacking the USB stick name.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*Sugar on a Stick is READ-ONLY<br />
**Nothing is saved between reboots. Sugar asks for your name and colors each boot.<br />
**imge-writer-mac does not create a persistent overlay file.<br />
There is no way to create a persistent overlay on Mac without hacking the USB stick.<br>Use a windows machine to create Sugar on a Stick, named FEDORA, with persistent overlay.<br />
<br />
*BootHelperCD cannot boot Mac without typing secret code into difficult to read window:<br />
** interrupt the countdown boot sequence by pressing F4 <br />
** append selinux=0 to the kernel's list of boot parameters<br />
** press return or enter to continue the boot process<br />
Submit bugs and gripe at developers until they create a boot helperCD that boots without selinux=0<br>We'd prefer something more legible than white text on white background.<br />
<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50754SoaS Blueberry Instructions2010-04-03T04:22:38Z<p>Interested: /* To calculate a file's SHA-1 checksum */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
<br />
'''To identify the Mac's processor and OS X version'''<br>Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br> <br />
<br />
===To download Sugar on a Stick===<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
===To calculate a file's SHA-1 checksum===<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To create a Boot Helper CD'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Press the Burn button. Insert a blank disc when prompted.<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* insert the USB drive loaded with Blueberry flavor Sugar on a Stick.<br />
* insert the Boot Helper CD.<br />
* Press the Power Button on the intel Mac. If a dialog box appears, press the Restart Button.<br />
* During the startup sound, press and hold the letter C.<br> If the apple logo appears, Sugar is not booting. Restart and try again.<br />
**the C key must be pressed during the startup sound and you must continue to hold it down.<br />
**you may release the c key once the sugar logo appears. <br />
* Proceed as stated in the instructions for Linux Users.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50753SoaS Blueberry Instructions2010-04-03T03:58:53Z<p>Interested: /* To calculate a file's SHA-1 checksum */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
<br />
'''To identify the Mac's processor and OS X version'''<br>Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br> <br />
<br />
===To download Sugar on a Stick===<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
===To calculate a file's SHA-1 checksum===<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br><br />
* Download the USB boot helper [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
* Open the disk Utility. Drag the downloaded soas-2-boot.iso to the bottom of the list.<br />
* Press the Burn button. Insert a blank disc when prompted.<br />
* Proceed as stated in the instructions for Linux Users.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50747SoaS Blueberry Instructions2010-04-03T01:54:03Z<p>Interested: /* Older Mac with powerPC processor */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
<br />
'''To identify the Mac's processor and OS X version'''<br>Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br> <br />
<br />
===To download Sugar on a Stick===<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
===To calculate a file's SHA-1 checksum===<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br>Proceed as stated in the instructions for Linux Users.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly onto the hard drive. The use of intel processor emulation on powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50364SoaS Blueberry Instructions2010-03-29T23:03:34Z<p>Interested: /* To calculate a file's SHA-1 checksum */</p>
<hr />
<div>__NOTOC__<br />
<br />
== For Windows Users ==<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
== For GNU/Linux Users ==<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
== Boot Helper ==<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<!--<br />
template does not allow enough separation between disparate sections. Try using wiki sections with the ===section_title=== wikiformat. See http://wiki.sugarlabs.org/go/Wiki_Team/Guide/Formatting. If that is not sufficient, a skin change would be required to avoid the newline and <br> workarounds. Please post a screenshot of your issue. We are planning skin changes (see [[Wiki_Team/Roadmap/Wiki_skin_redesign]]). Comments are usually left on the Discussion/Talk pages for greater visibility and ease of linking. Changes to either page trigger watchlist notifications. Thanks again for your edits!<br />
--><br />
== For Mac OS X Users ==<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
<br />
'''To identify the Mac's processor and OS X version'''<br>Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br> <br />
<br />
===To download Sugar on a Stick===<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
===To calculate a file's SHA-1 checksum===<br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac.py soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br>Proceed as stated in the instructions for Linux Users.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly, ''yum''. The use of intel processor emulation on a powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50362SoaS Blueberry Instructions2010-03-29T18:39:11Z<p>Interested: </p>
<hr />
<div>__NOTOC__<br />
<br />
=== For Windows Users ===<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
=== For GNU/Linux Users ===<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
<br />
=== Boot Helper ===<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.<br />
<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--><br />
=== For Mac OS X Users ===<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
<br />
'''To identify the Mac's processor and OS X version'''<br>Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br> <br />
<br />
<br />
'''To download Sugar on a Stick'''<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br>Proceed as stated in the instructions for Linux Users.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly, ''yum''. The use of intel processor emulation on a powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--></div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50361SoaS Blueberry Instructions2010-03-29T17:48:55Z<p>Interested: /* For Mac OS X Users */</p>
<hr />
<div>__NOTOC__<br />
<br />
=== For Windows Users ===<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
=== For GNU/Linux Users ===<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--><br />
=== For Mac OS X Users ===<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
<br />
'''To identify the Mac's processor and OS X version'''<br>Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br> <br />
<br />
<br />
'''To download Sugar on a Stick'''<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br>Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br>'''WARNING:''' your entire flash drive will be overwritten in the next step! All partitions will be erased.<br />
<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br>Proceed as stated in the instructions for Linux Users.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly, ''yum''. The use of intel processor emulation on a powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--><br />
<br />
=== Boot Helper ===<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50360SoaS Blueberry Instructions2010-03-29T17:42:50Z<p>Interested: /* For Mac OS X Users */</p>
<hr />
<div>__NOTOC__<br />
<br />
=== For Windows Users ===<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
=== For GNU/Linux Users ===<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--><br />
=== For Mac OS X Users ===<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
<br />
'''To identify the Mac's processor and OS X version'''<br>Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br> <br />
<br />
<br />
'''To download Sugar on a Stick'''<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br> '''WARNING:''' your flash drive will be wiped in the next step! All partitions will be erased.<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br>Proceed as stated in the instructions for Linux Users.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly -''yum''. The use of intel processor emulation on a powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><!-- template does not allow enough separation between disparate sections--><br />
<br />
=== Boot Helper ===<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50359SoaS Blueberry Instructions2010-03-29T17:41:43Z<p>Interested: /* For Mac OS X Users */</p>
<hr />
<div>__NOTOC__<br />
<br />
=== For Windows Users ===<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
=== For GNU/Linux Users ===<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
=== For Mac OS X Users ===<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
<br />
'''To identify the Mac's processor and OS X version'''<br>Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br> <br />
<br />
<br />
'''To download Sugar on a Stick'''<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6<br> <big> <code> shasum ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Mac OS version ≤10.5<br> <big> <code> openssl sha1 ~/Downloads/soas-2-blueberry.iso</code></big><br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''always compare the checksum of each download'''.<br />
<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br> '''WARNING:''' your flash drive will be wiped in the next step! All partitions will be erased.<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br><big><code>cd ~/Downloads; python image-writer-mac soas-2-blueberry.iso</code></big><br />
<br />
<!-- extra spaces would add code legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br>Proceed as stated in the instructions for Linux Users.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly -''yum''. The use of intel processor emulation on a powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><br />
<br />
=== Boot Helper ===<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50358SoaS Blueberry Instructions2010-03-29T17:11:13Z<p>Interested: /* For Mac OS X Users */</p>
<hr />
<div>__NOTOC__<br />
<br />
=== For Windows Users ===<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
=== For GNU/Linux Users ===<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
=== For Mac OS X Users ===<br />
''Sugar on a Stick Blueberry and Strawberry images are for the Intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an Intel processor.''<br />
<br />
<br />
'''To identify the Mac's processor and OS X version'''<br>Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br> <br />
<br />
<br />
'''To download Sugar on a Stick'''<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and transmission errors, '''you should always compare the checksum of each download'''.<br />
<br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6 type the following ''shasum ~/Downloads/soas-2-blueberry.iso<!--removed <code> tag for readability on Mac-->''<br />
* Mac OS version ≤10.5 type the following ''openssl sha1 ~/Downloads/soas-2-blueberry.iso''<br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and transmission errors, '''you should always compare the checksum of each download'''.<br />
<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br> '''WARNING:''' your flash drive will be wiped in the next step! All partitions will be erased.<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br> <big><big><code>cd Downloads; python image-writer-mac soas-2-blueberry.iso</code></big></big><!--removed <code> tag for readability on Mac--><!-- extra spaces would add legibility, how to wiki format it? Try <big><code>codetext</code></big> or <big><big><code>codetext</code></big></big> Thank you for your contributing to the wiki! We've really needed help in this area. Please continue. --User:FGrose --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br>Proceed as stated in the instructions for Linux Users.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick Blueberry and Strawberry images are for the Intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download Blueberry and Strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Server has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly -''yum''. The use of intel processor emulation on a powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar directly will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><br />
<br />
=== Boot Helper ===<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.</div>Interestedhttps://wiki.sugarlabs.org/index.php?title=SoaS_Blueberry_Instructions&diff=50325SoaS Blueberry Instructions2010-03-29T05:43:56Z<p>Interested: /* For Mac OS X Users */</p>
<hr />
<div>__NOTOC__<br />
<br />
=== For Windows Users ===<br />
<br />
Persons using PCs running Windows have two options for creating a Sugar/Blueberry USB flash drive:<br />
<br />
::'''Option #1: Use LiveUSB Creator from within Windows to create a Sugar-on-a-Stick Live USB with a compressed filesystem.'''<br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:fedora-liveusb-creator.png|left|300px]]<br />
|valign=top|<br />
# Download the latest version of the '''Fedora LiveUSB Creator''' from [https://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].<br />
# Plug a blank target USB flash drive (or SD Card) into your computer (1GB or greater). (See [http://wiki.sugarlabs.org/go/Category:Live_USB#Cautions_with_using_Live_USB.27s Cautions with using Live USB] regarding flash drive size.)<br />
# Launch LiveUSB Creator.<br />
# Select '''Sugar on a Stick v2 Blueberry''' in the drop-down menu on the upper-right side to download the liveUSB disk image. <br />
# Adjust the Persistent Storage slider. This enables you to save the child's work in Sugar onto the device.<br />
# Select your flash drive as the target and click the '''Create Live USB''' button.<br />
# Wait for the process to finish, then close the LiveUSB Creator program.<br />
# Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.<br />
|}<br />
<br />
::'''Option #2: (ADVANCED USERS ONLY) Create a bootable Sugar/Blueberry USB flash drive that does not have a compressed filesystem.''' This option requires at least a 4GB drive. <br />
<br />
::::'''WARNING: MAKING A MISTAKE IN THIS PROCEDURE COULD WIPE YOUR PC'S HARD DISK!!!!'''<br />
<br />
::# In Windows, download the latest version of the [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso Live CD image], and burn the image to a CD.<br />
::# Follow the instructions [http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller here] to create the bootable Sugar/Blueberry USB flash drive by (i) booting the PC into Sugar with the CD and (ii) running ZyX-LiveInstaller within the Terminal activity. You will also need a spare, blank (or erasable) USB flash drive -- preferably manufactured by a different manufacturer than the target USB -- to use as a swap drive during the procedure. Any data on the swap drive will be wiped.<br />
<br />
Notes: <br />
<br />
* If you do Option #1 often, you may want to download the Blueberry [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso CD Image] once. Then, when it comes to create the flash drive, hit the Browse button and select the downloaded file rather than selecting "Blueberry" from the menu as above.<br />
<br />
* Option #1 creates an SoaS that cannot detect when its drive space eventually runs out, causing stick failure.<br />
<br />
* Option #2 creates a more-robust, more-stable drive whose free space can be monitored using the Terminal activity. Non-compressed SoaS drives, however, are not bootable with a boot helper CD.<br />
<br />
=== For GNU/Linux Users ===<br />
<br />
1-)Linux Users will use a slightly different approach than Windows Users to ensure maximum compatibility<br />
with different distributions. Please follow the instructions carefully to ensure your data is preserved.<br />
<br />
If you are a '''Fedora User''', run the following command:<br />
<br />
<code>''yum install liveusb-creator''</code><br />
<br />
Then download [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] and select it by using the Browse button. You can check to make sure that the .iso downloaded properly by comparing the sha1sum to the one here:[http://download.sugarlabs.org/soas/releases/SHA1SUM](sha1sum)<br />
<br />
sha1sum soas-2-blueberry.iso<br />
8022b68433295f12fbfffa66bf49205851a6a1e0 <br />
<br />
* Launch LiveUSB Creator and follow the instructions [[SoaS_Blueberry_Instructions#For_Windows_Users|above]].<br />
<br />
2-)If you use any '''other distribution''', download the '''image-writer''' tool from [http://download.sugarlabs.org/soas/releases/image-writer here] and the '''live image''' from [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso here].<br />
<br />
'''This solution will not create a persistent storage overlay'''<br />
<br />
* Open a terminal and become root, either by using su or sudo.<br />
* Enter the following command: ''./image-writer soas-2-blueberry.iso''<br />
* '''WARNING:''' If you proceed here, your flash drive will be wiped!<br />
* The script will output a device name; confirm that it matches with your flash drive.<br />
* You will be notified once the process has finished.<br />
<br />
3-)'''zyx-liveinstaller:'''[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/ZyX-LiveInstaller]<br />
<br />
4-)Unsupported''' instructions for creating a key with persistent storage for Blueberry:''' [http://wiki.sugarlabs.org/go/Talk:SoaS_Blueberry_Instructions] and on other distributions are available here:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Linux]<br />
<br />
=== For Mac OS X Users ===<br />
''Sugar on a Stick Blueberry and Strawberry images are for the intel processor.''<br><br />
''See [[#Older Mac with powerPC processor | Using Sugar with powerPC]] if you do not have an intel processor.''<br />
<br />
<br />
'''To identify the Mac's processor and OS X version'''<br>Choose '''Apple menu''' > About This Mac. The version and processor type appear at the top of the list.<br> <br />
<br />
<br />
'''To download Sugar on a Stick'''<br />
*Download the liveUSB image [http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso soas-2-blueberry.iso] <br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br><br />
For protection against tampering and poor transmission errors, '''you should always compare the checksum of each download'''.<br />
<br />
<br />
'''To calculate a file's SHA-1 checksum'''<br><br />
Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command. <br />
<!-- "md5" will work too, but creates a different checksum e.g. ''$ md5 /Downloads/soas-2-blueberry.iso'' --><br />
*Mac OS version ≥10.6 type the following ''shasum ~/Downloads/soas-2-blueberry.iso<!--removed <code> tag for readability on Mac-->''<br />
* Mac OS version ≤10.5 type the following ''openssl sha1 ~/Downloads/soas-2-blueberry.iso''<br />
* Compare the result to the official [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum] stored at Sugar Labs.<br />
<br />
<br />
'''To install Sugar onto a Stick'''<br />
* Download the [http://download.sugarlabs.org/soas/releases/image-writer-mac image-writer for Mac computers ]<br />
* Verify the file was downloaded properly ''by calculating its [http://download.sugarlabs.org/soas/releases/SHA1SUM SHA-1 checksum]''<br>For protection against tampering and poor transmission errors, '''you should always compare the checksum of each download'''.<br />
<br />
<br />
* Eject all USB drives. Insert the flash drive you wish to install Sugar on a Stick.<br> '''WARNING:''' your flash drive will be wiped in the next step! All partitions will be erased.<br />
* Open the Terminal Utility and type into the Terminal Window. Press the return key to run the command.<br> ''cd Downloads; python image-writer-mac soas-2-blueberry.iso''<!--removed <code> tag for readability on Mac--><!-- extra spaces would add legibility, how to wiki format it? --><br />
<br />
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: white;"<br />
|-<br />
|valign=top|[[Image:image-writer-mac.png|left|300px]]<br />
|valign=top|<br />
|}<br />
<br />
<br />
'''To boot Sugar on a Stick'''<br>Proceed as stated in the instructions for Linux Users.<br />
<br />
<br />
====Older Mac with powerPC processor====<br />
Sugar on a Stick blueberry and strawberry images are for the intel processor. <br><br />
Mac computers with powerPC processors will need a different flavor image to run.<br />
*It is possible to download blueberry and strawberry images and flash them onto usb drives with a powerPC Mac.<br />
*It is also possible to develop Sugar Activities with a powerPC Mac.<br />
*The use of powerPC Mac as a School Sever has not been tested.<br />
<br />
<br />
Fedora Core is available for the powerPC processor. By booting Fedora on your Mac, you change it into a Fedora machine. You may then install Sugar directly -''yum''. The use of intel processor emulation on a powerPC Mac is not recommended. Due to the aging speeds of powerPC Macs, installing Fedora and Sugar directly will drastically outperform emulation.<br />
<br />
See the Linux section for more details.<br />
<br><br><br><br />
<br />
=== Boot Helper ===<br />
If your machine doesn't support booting from USB devices, then download the [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso soas-2-boot.iso] and burn it to a CD. [http://www.imgburn.com/ ImgBurn] is a free Windows application to do so, in case your current computer does not come with such a software.<br />
<br />
* Use the [[wikipedia:Windows Explorer|Windows Explorer]] to name your USB flash drive FEDORA (from the Properties dialog for your device), as otherwise, it won't be recognized by the boot-helper CD.<br />
* Put both the boot-helper CD and the USB flash drive in your computer and let it boot from the CD.<br />
<br />
If your boot hangs, you may need to modify the boot command by appending:<br />
<br />
selinux=0<br />
<br />
You do this by interrupting the Helper CD boot by hitting the Esc key once the initial splash-screen appears. You should see a list of four boot options. At this point, hit the Tab key. The command line should appear. Add selinix=0 to the end of the line and hit Return (or Enter). The boot should proceed from here as normal.</div>Interested