Sugar on a Stick: Difference between revisions

(53 intermediate revisions by 6 users not shown)

Line 5:

{{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792}}__NOTOC__</noinclude>

==What is Sugar on a Stick?==

=== ~~Want to use~~ Sugar on a Stick? ===

=== What's new in Sugar on a Stick? ===

* Sugar [[0.118]], see the [[0.118/Notes|release notes for 0.118]],

* several updated activities,

* based on Fedora 35, see the [[fedoradocs:fedora/f34/release-notes/|release notes for Fedora 35]]

:

==== Known bugs ====

* See also [[fedora:Common_F34_bugs|Common Fedora 35 bugs]].

== Sugar on a Stick installation instructions ==

=== MS Windows ===

{|

|-

|width="160px" valign="top"|[[File:Windows.gif|left|link=Sugar on a Stick/Windows]]

[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]

[[File:USB flash drive.jpg|left|156px|link=Sugar on a Stick/Downloads]]

|valign=top|

# '''Prepare''': [http://fedorahosted.org/liveusb-creator/#Download Download] the Fedora Live USB Creator from [http://fedorahosted.org/liveusb-creator/#Download FedoraHosted].

# '''Download''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.

# '''Load''': Insert a USB flash drive (or SD Card) with 2 GB or more of free space into your computer and launch Fedora Live USB Creator to create a Sugar-on-a-Stick bootable image. '''Note''': Be sure to set the ''persistent storage'' slider to a non-zero value.

# '''Boot''': Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's <abbr title="Basic Input/Output System">BIOS</abbr> setup, and then start up the computer.

|}

|~~After you've tried out~~ Sugar on a Stick~~, we hope you'll come back here and join our community of contributors~~ to ~~help us make the next release even better~~.

Detailed [[Sugar on a Stick/Windows|installation instructions for Windows]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Getting Started/Explore|guide to exploring Sugar]].

----

=== GNU/Linux ===

{|style="width: 800px;"

|-

|width="160px" valign=top| [[File:Gnulinux.png|link=Sugar on a Stick/Linux]]

[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]

[[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]]

|valign=top|

|}

Detailed [[Sugar on a Stick/Linux|installation instructions for GNU/Linux]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Getting Started/Explore|guide to exploring Sugar]].

GNU/Linux users may also want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] on their favorite distro, apart from Sugar on a Stick.

----

=== Apple Mac OS X ===

{|

|-

|width="160px" valign="top"|[[File:Apple.gif|link=Macintosh]]

[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]

[[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]]

|valign=top|

The instructions below are based on the Ubuntu Web page at <http://www.ubuntu.com/download/desktop/create-a-usb-stick-on-mac-osx>.

# '''Prepare''': These instructions are for '''32-bit''' and '''64-bit''' processors.

# '''Download''' the latest [[Sugar on a Stick/Downloads|Sugar on a Stick]] .iso file.

# '''Load''': Here is a simple way to load a bootable USB on a Mac.

## Enter the Terminal: <code>/Applications/Utilities/Terminal</code>.

## Type <code>diskutil list</code>. You should see all the disk drives you have inserted into your computer.

## Insert the disk drive to which you want to write Sugar on a Stick.

## Type <code>diskutil list</code> again. You should see that your USB drive has been added to the list. If not, wait a while and repeat.

## Type <code>hdiutil convert -format UDRW -o <Sugar on a Stick image file>.img <Sugar on a Stick image file></code> to convert the image into a bootable format.

## Type <code>sudo diskutil unmountDisk <device name></code> to unmount the disk (it will not be ejected).

## Type <code>sudo dd if=<Sugar on a Stick image file>.img.dmg of=<device name> bs=1m</code>. <code>sudo</code> will ask for your password, and then <code>dd</code> will start writing the disk file.

## When <code>dd</code> finishes writing the disk file, type <code>sudo diskutil eject <device name></code>.

# '''Boot''': Insert the USB stick into a USB port on your computer, then reboot and press and hold the Option key while rebooting. You should see a list of all the EFI-recognizable USB drives that can be bootstrapped. If Sugar on a Stick is not one such drive, it cannot be bootstrapped: you need rEFInd (a fork of rEFIt).

:* Have a MacBook? Consider these options:

::[[File:Usb1.png|50px]] [[Testing/Reports/Sugar on a Stick#MacBook Persistent SoaS v5 USB EFI Boot|'''MacBook Persistent SoaS v5 USB EFI Boot''']]

:: [[Talk:Downloads#Bootable_CD_of_Trisquel_4.5_for_MacBook_Air|Bootable CD of Trisquel 4.5 for MacBook Air]]

:: See other installation variations at [[Sugar Creation Kit]]

::[[File:Apple.gif|30px]] [[Tutorials/Installation/Burn_a_CD.iso_on_a_Mac|'''Burning a CD from an .iso file on a Mac''']]

|}

Alternative [[Macintosh|installation instructions for Mac OS X]]. Also, [[Sugar_on_a_Stick/Blueberry#For_Mac_OS_X_Users|these older installation instructions]] and [[Sugar on a Stick/Boot|booting instructions]] may be consulted. There is also a [[Getting Started/Explore|guide to exploring Sugar]].

----

===Advanced users===

==Do you have an OLPC XO?==

{|

|-

|width="174px"|[[File:OLPCXO.png|middle|link=olpc:Releases]]

|valign=top|

* '''Upgrade''' to the latest ''[[olpc:Releases]]'' from OLPC (which may require a [[olpc:Activation_and_developer_keys|developer key]]).

* '''Experiment''' with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release.

|}

==Some alternate installations==

* Once you download, and then burn or load a Sugar on a Stick (SoaS) .iso file, and boot it, the running Fedora 34 SoaS Live CD/USB may be used to install Fedora with Sugar to a hard disk or a 4 GB USB stick [[Tutorials/Installation/Install with liveinst|with the '''{{Code|liveinst}} command''']].

:- You start with a SoaS LiveOS image, and then load an uncompressed version onto the hard disk or USB stick.

=== Want to contribute to Sugar on a Stick? ===

Line 87:

Line 172:

== What's happening? ==

===[[Sugar on a Stick/Beta]]===

~~===[[Sugar_on_a_Stick/Virtual_machines| Sugar Virtual Box Appliances]]===~~

* Import into VirtualBox

=== Contributor stories ===

@@ Line 5: / Line 5: @@
 {{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792}}__NOTOC__</noinclude>
 ==What is Sugar on a Stick?==
 {{:Sugar on a Stick/Downloads}}
-=== Want to use Sugar on a Stick? ===
+=== What's new in Sugar on a Stick? ===
+* Sugar [[0.118]], see the [[0.118/Notes|release notes for 0.118]],
+* several updated activities,
+* based on Fedora 35, see the [[fedoradocs:fedora/f34/release-notes/|release notes for Fedora 35]]
+:
+==== Known bugs ====
+* See also [[fedora:Common_F34_bugs|Common Fedora 35 bugs]].
+== Sugar on a Stick installation instructions ==
+=== MS Windows ===
 {|
 |-
-| style="border: 0; border-width: 0; width: 350px;" | [[File:Cici-maze.jpg |300px|left|link=Sugar_on_a_Stick/Downloads]]
+|width="160px" valign="top"|[[File:Windows.gif|left|link=Sugar on a Stick/Windows]]
+<br><br><br>
+<span class="linkgroup">[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span>
+[[File:USB flash drive.jpg|left|156px|link=Sugar on a Stick/Downloads]]
+|valign=top|
+# '''Prepare''': [http://fedorahosted.org/liveusb-creator/#Download Download] the Fedora Live USB Creator from [http://fedorahosted.org/liveusb-creator/#Download FedoraHosted].<br><br>
+# '''Download''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br><br>
+# '''Load''': Insert a USB flash drive (or SD Card) with 2 GB or more of free space into your computer and launch Fedora Live USB Creator to create a Sugar-on-a-Stick bootable image.<br/>'''Note''': Be sure to set the ''persistent storage'' slider to a non-zero value.<br><br>
+# '''Boot''': Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's <abbr title="Basic Input/Output System">BIOS</abbr> setup, and then start up the computer.
+|}
-|After you've tried out Sugar on a Stick, we hope you'll come back here and join our community of contributors to help us make the next release even better.
+Detailed [[Sugar on a Stick/Windows|installation instructions for Windows]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Getting Started/Explore|guide to exploring Sugar]].
+----
+=== GNU/Linux ===
+{|style="width: 800px;"
+|-
+|width="160px" valign=top|<br><span class="linkgroup">[[File:Gnulinux.png|link=Sugar on a Stick/Linux]]
+<br>
+[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span>
+[[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]]
+|valign=top|
+{{:Sugar on a Stick/Linux/Installation}}
 |}
+Detailed [[Sugar on a Stick/Linux|installation instructions for GNU/Linux]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Getting Started/Explore|guide to exploring Sugar]].
+GNU/Linux users may also want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] on their favorite distro, apart from Sugar on a Stick.
+----
+=== Apple Mac OS X ===
+{|
+|-
+|width="160px" valign="top"|[[File:Apple.gif|link=Macintosh]]
+<br>
+<span class="linkgroup">[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span>
+[[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]]
+|valign=top|
+The instructions below are based on the Ubuntu Web page at &lt;http://www.ubuntu.com/download/desktop/create-a-usb-stick-on-mac-osx&gt;.
+# '''Prepare''': These instructions are for '''32-bit''' and '''64-bit''' processors.<br><br>
+# '''Download''' the latest [[Sugar on a Stick/Downloads|Sugar on a Stick]] .iso file.<br><br>
+# '''Load''': <br>Here is a simple way to load a bootable USB on a Mac.<br>
+## Enter the Terminal: <code>/Applications/Utilities/Terminal</code>.
+## Type <code>diskutil list</code>. You should see all the disk drives you have inserted into your computer.
+## Insert the disk drive to which you want to write Sugar on a Stick.
+## Type <code>diskutil list</code> again. You should see that your USB drive has been added to the list. If not, wait a while and repeat.
+## Type <code>hdiutil convert -format UDRW -o &lt;<i>Sugar on a Stick image file</i>&gt;.img &lt;<i>Sugar on a Stick image file</i>&gt;</code> to convert the image into a bootable format.
+## Type <code>sudo diskutil unmountDisk &lt;<i>device name</i>&gt;</code> to unmount the disk (it will not be ejected).
+## Type <code>sudo dd if=&lt;<i>Sugar on a Stick image file</i>&gt;.img.dmg of=&lt;<i>device name</i>&gt; bs=1m</code>. <code>sudo</code> will ask for your password, and then <code>dd</code> will start writing the disk file.
+## When <code>dd</code> finishes writing the disk file, type <code>sudo diskutil eject &lt;<i>device name</i>&gt;</code>.
+# '''Boot''': Insert the USB stick into a USB port on your computer, then reboot and press and hold the Option key while rebooting. You should see a list of all the EFI-recognizable USB drives that can be bootstrapped. If Sugar on a Stick is not one such drive, it cannot be bootstrapped: you need rEFInd (a fork of rEFIt).<br>
+<br>
+:* Have a MacBook? Consider these options:
+::[[File:Usb1.png|50px]] [[Testing/Reports/Sugar on a Stick#MacBook Persistent SoaS v5 USB EFI Boot|'''MacBook Persistent SoaS v5 USB EFI Boot''']]
+:: [[Talk:Downloads#Bootable_CD_of_Trisquel_4.5_for_MacBook_Air|Bootable CD of Trisquel 4.5 for MacBook Air]]
+:: See other installation variations at [[Sugar Creation Kit]]
+::[[File:Apple.gif|30px]] [[Tutorials/Installation/Burn_a_CD.iso_on_a_Mac|'''Burning a CD from an .iso file on a Mac''']]
+|}
+Alternative [[Macintosh|installation instructions for Mac OS X]]. Also, [[Sugar_on_a_Stick/Blueberry#For_Mac_OS_X_Users|these older installation instructions]] and [[Sugar on a Stick/Boot|booting instructions]] may be consulted.<br>There is also a [[Getting Started/Explore|guide to exploring Sugar]].
+----
+===Advanced users===
+==Do you have an OLPC XO?==
+{|
+|-
+|width="174px"|[[File:OLPCXO.png|middle|link=olpc:Releases]]
+|valign=top|
+* '''Upgrade''' to the latest ''[[olpc:Releases]]'' from OLPC (which may require a [[olpc:Activation_and_developer_keys|developer key]]).
+* '''Experiment''' with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release.
+|}
+<br/><br/>
+==Some alternate installations==
+* Once you download, and then burn or load a Sugar on a Stick (SoaS) .iso file, and boot it, the running Fedora 34 SoaS Live CD/USB may be used to install Fedora with Sugar to a hard disk or a 4 GB USB stick [[Tutorials/Installation/Install with liveinst|with the '''{{Code|liveinst}} command''']].
+:- You start with a SoaS LiveOS image, and then load an uncompressed version onto the hard disk or USB stick.
 === Want to contribute to Sugar on a Stick? ===
@@ Line 87: / Line 172: @@
 == What's happening? ==
 ===[[Sugar on a Stick/Beta]]===
-===[[Sugar_on_a_Stick/Virtual_machines| Sugar Virtual Box Appliances]]===
-* Import into VirtualBox
 === Contributor stories ===