Changes

Downloads (view source)

Revision as of 00:29, 17 May 2016

4,540 bytes removed , 00:29, 17 May 2016

Remove dextrose link as its dead

Line 6: Line 6:

==Are you new to Sugar?==

−

The ~~quickest~~ download is '''[[Sugar on a Stick]]'''. Basic instructions are found below:

+

The SoaS download is found here: '''[[Sugar on a Stick]]'''. Basic instructions are found below:

== Sugar on a Stick installation instructions ==

Line 27: Line 27:

----

=== GNU/Linux ===

−

{|

+

{|style="width: 800px;"

|-

−

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

+

|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:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]

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

|valign=top|

−

# '''Prepare''': Use this script [http://git.fedorahosted.org/git?p=hosted/livecd;a=blob_plain;f=tools/livecd-iso-to-disk.sh;hb=HEAD livecd-iso-to-disk] to create a bootable image. (You may need to run {{Code|chmod +x tools_livecd-iso-to-disk.sh}} after you download the script to make it executable.) You should have the isomd5sum package installed so that the script can verify the download.

+

−

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

−

~~# '''Load''': Insert a USB stick of 2 GB or greater capacity. Execute, as the '''root''' user, in the directory where you downloaded the script, in one command with arguments, the following:~~

−

~~#:{{Code|./tools_livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 500 --home-size-mb 900 --delete-home --unencrypted-home '''/path/to/source'''.iso /dev/sd'''?'''1}}~~

−

#: where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc. and /path/to/source is the location and name of the .iso file. You can use the {{Code|blkid}} or {{~~Code|df}} command to get the device node name. ~~

−

~~# '''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.~~

−

~~#* You may create more Sugar Sticks on extra USB or SD devices from within a running ''~~Sugar on a Stick~~'' by running this command in the Terminal activity as root (doesn't work with alternative installation methods):~~

−

~~#*:{{Code|/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /dev/sr0~~ /~~dev~~/~~sd?1~~}}

|}

Line 47: Line 40:

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 ===

−

'''DRAFT''': These instructions are incomplete. Please help with testing and documentation. In the meantime, we recommend the '''[[#Virtual Machines on all platforms|Virtual Machines instructions]]''' below.

{|

|-

−

|width="160px" valign="top"|[[File:Apple.gif|link=~~Sugar_on_a_Stick/Mac~~]]

+

|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|

−

# '''Prepare''': These instructions are ~~only~~ for '''64-bit''' ~~processor machines. (To identify the processor type, choose Apple menu > About This Mac. A small window will appear titled~~ ''~~About This Mac~~''. ~~The processor type is displayed in this window. Sugar on a Stick is for the Intel processor only.)~~

+

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

−

# '''Download''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file~~. Be sure to download a '''64-bit''' image~~.

+

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

−

# '''Load''': ~~[[File:question.png|link=|middle]] '''Help: Does someone have a simple way to load a Live USB on a Mac?'''~~ Here is a simple way to ~~recognize~~ a bootable USB on a Mac. ~~Go to rEFIt (http~~://~~refit~~.~~sourceforge.net~~/~~) and make a bootable cd~~. ~~There is no need to install rEFIt on~~ your ~~mac~~. ~~In fact installing rEFIt may make it impossible~~ to ~~upgrade the Mac OS~~ to ~~a newer version later~~ on ~~(personal experience, I had to do~~ a ~~clean install)~~. ~~Put the rEFIt CD in and hold the option key after turning~~ the ~~computer on~~. ~~The Mac will recognize the CD because it uses EFI~~ and ~~then the CD will recognize the bootable USB~~.

+

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

−

~~#* [http:~~/~~/refit~~.~~sourceforge.net~~/~~doc~~/~~c1s5_burning.html How~~ to ~~Burn~~ a ~~rEFIt CD]~~

+

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

−

#~~: You can rename~~ the .~~cdr~~ file to .~~iso~~ for ~~use in GNU~~/~~Linux~~.

+

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

−

#* [[Sugar_Creation_Kit#~~Building_a_bootable_Mac_USB|Building and Booting a Live USB on a Mac]]~~

+

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

−

# '''Boot''': Insert the USB stick into a USB port on your computer~~. '''Is this correct?''': During the startup sound~~, press and hold the ~~'''c'''~~ key. If ~~the Apple logo appears,~~ Sugar is not ~~booting. Restart and try again.~~

+

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

−

~~#* the '''c''' key must~~ be ~~pressed during the startup sound and~~ you ~~must continue to hold it down.~~

+

## 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.

−

~~#* you may release the '''c''' key once the Sugar logo appears~~.

+

## 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]] [[~~Community~~/~~Distributions~~/~~Fedora-SoaS~~#MacBook Persistent SoaS v5 USB EFI Boot|'''MacBook Persistent SoaS v5 USB EFI Boot''']]

+

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

−

~~:: [[Community/Distributions/Fedora#Bootable_f15_gnome3_CD_on_MacBook_Pro| Bootable F15 Gnome3 CD on MacBook Pro]]~~

−

~~:: [[Talk:Downloads#Bootable_DVD_of_f14_for_MacBook_Air|Bootable DVD of F14 for MacBook Air~~]]

:: [[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]] [[~~Sugar_Creation_Kit~~/~~sck~~/Burn_a_CD.iso_on_a_Mac|'''Burning a CD from an .iso file on a Mac''']]

+

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

:* Have an iBook or PowerPC Mac?

−

:: See [[~~Community/Distributions/~~Ubuntu/PPC]].

+

:: See [[Ubuntu/PPC]] and [[Fedora#PowerPC]].

|}

−

Alternative [[~~Sugar on a Stick/Mac~~|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]].

+

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?==

Line 86: Line 82:

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

|valign=top|

−

* '''Upgrade''' to the latest ''[[olpc:Releases]]'' from OLPC.

+

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

−

* '''Upgrade''' to ''[[Dextrose |Dextrose Sugar 0.88 with Fedora 11 and GNOME]]'' (~~requires~~ 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.

Line 95: Line 89:

==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 16 SoaS Live CD/USB may be used to install Sugar to a hard disk or a 4 GB USB stick [[~~Sugar_Creation_Kit~~/~~sck~~/liveinst|with the '''{{Code|liveinst}} command''']].

+

* Once you download, and then burn or load a Sugar on a Stick (SoaS) .iso file, and boot it, the running Fedora 17 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.

−

:- The Fedora-16-Live-SoaS.iso file is a ~~443~~ MB download.

+

:- The Fedora-17-Live-SoaS.iso file is a 509 MB download.

−

* If you have a high-speed Internet connection, '''Fedora with the Sugar graphical learning environment''' may be installed to a hard disk or a a 4 GB USB stick [[~~Sugar_Creation_Kit~~/~~sck~~/netinstall|with a '''Netinstall CD''']].

+

* If you have a high-speed Internet connection, '''Fedora with the Sugar graphical learning environment''' may be installed to a hard disk or a a 4 GB USB stick [[Tutorials/Installation/Install with netinstall|with a '''Netinstall CD''']].

:- Not a compressed LiveOS image like SoaS, but all of Sugar.

:- {{Highlight|bgcolor=#f9f6b7|''This requires a high-speed Internet connection for software component downloading during installation.''}}

==Do you use GNU/Linux?==

+

−

{|

−

|-

−

~~|width="178px" valign="top"|Select your favorite distribution [[File:Gnulinux.png|link=Community/Distributions]] [[Community/Distributions]]||~~

−

{|

−

|-

−

~~|[[Image:Fedora-small.jpg|link=Community/Distributions/Fedora]] [[Community/Distributions/Fedora|Fedora]]~~

−

|-

−

~~|[[Image:Debian-small.jpg|link=Community/Distributions/Debian]] [[Community/Distributions/Debian|Debian]]~~

−

~~|[[File:Trisquel_icon.png|link=Community/Distributions/Trisquel]] [[Community/Distributions/Trisquel|Trisquel]]~~

−

~~|align="center"|[[Image:Ubuntu-small.jpg|link=Community/Distributions/Ubuntu]] [[Community/Distributions/Ubuntu|Ubuntu]]~~

−

~~|align="center"|[[File:LMD-small.png|link=Community/Distributions/Linux_Mint_Debian]] [[Community/Distributions/Linux_Mint_Debian|Linux Mint Debian]]~~

−

|-

−

−

~~|align="center"|[[Image:Mandriva-small.png|link=Community/Distributions/Mandriva]] [[Community/Distributions/Mandriva|Mandriva]]~~

−

~~|align="center"|[[Image:Caixa_M%C3%A1gica-small.jpg|link=Community/Distributions/Magalhães]] [[Community/Distributions/Magalhães|Caixa Mágica]]~~

−

|-

−

~~|align="center"|[[Image:Suse-small.jpg|link=Community/Distributions/OpenSUSE]] [[Community/Distributions/OpenSUSE| openSUSE]]~~

−

~~|[[Image:Suse-small.jpg|link=http://en.opensuse.org/Sugar]] [http://en.opensuse.org/Sugar openSUSE]||~~

−

|-

−

~~|align="center"|[[Image:Arch-logo.png|link=http://wiki.archlinux.org/index.php/Sugar]] [http://wiki.archlinux.org/index.php/Sugar Archlinux]||~~

−

|-

−

~~|align="center"|[[Image:Altlinux-small.png|link=Community/Distributions/ALTLinux]] [[Community/Distributions/ALTLinux|AltLinux]]~~

−

|-

−

−

|-

−

|}

−

|-

−

~~|width="180px" valign="top"|Or try a Live USB version of Sugar~~

−

|[[File:Soas-pineapple.svg|middle|200px|link=Sugar on a Stick/Pineapple]], Pineapple with Sugar 0.94.1 and Fedora 16 (Verne) [[File:SugaronastickQuandong.png|100px]][[Sugar_on_a_Stick/Quandong | v7 Quandong with Sugar 0.96.1 and Fedora 17 (Beefy Miracle)]] To be released 05/29/2012 [[File:Trisquel_icon.png|link=Trisquel On A Sugar Toast]] Trisquel TOAST

−

|}

===Are you a developer?===

{|

|-

−

|width="174px" valign=top|[[File:Gear.png|link=~~Community/Distributions~~]]

+

|width="174px" valign=top|[[File:Gear.png|link=Development Team]]

−

|~~Learn how to get setup on the~~ [~~[Supported systems~~]~~] page~~.

+

|Please see this [http://developer.sugarlabs.org/ developer documentation website] for the sugar-build development environment.

+

Some additional references you may find useful:

−

* [[Platform_Team/Guide/Sweets Usage|Sweets]], to launch Sugar using the Sugar Package Management System

+

* See https://github.com/sugarlabs/,

−

* [[Development Team/Jhbuild | jhbuild]]

+

* [http://git.sugarlabs.org Gitorious source code repository],

−

* [http://git.sugarlabs.org Gitorious source code repository]

+

* The [[Supported systems]] page,

−

* [[Emulator image files|Virtual machine or emulator image files]]

+

* [[Platform_Team/Guide/Sweets Usage|Sweets]], to launch Sugar using the Sugar Package Management System,

−

* Adding Sugar to your [[~~Community~~/~~Distributions~~|favorite distro...]]

+

* [[Emulator image files|Virtual machine or emulator image files]],

+

* Adding Sugar to your [[Sweets_Distribution/Supported_platforms|favorite distro...]]

|}

Line 155: Line 123:

{|

|-

−

+

|valign=top|

===[[Sugar Creation Kit/VirtualBox|VirtualBox Appliances]] ===

Line 174: Line 142:

If you run into problems, you may want to consult the [[Talk:VirtualBox]] page for help.

−

==Are you preparing a deployment without Internet access?==

Davelab6

Administrators

534

edits

Changes

Downloads (view source)

Revision as of 00:29, 17 May 2016

Navigation menu

Search