Line 1: |
Line 1: |
− | __TOC__
| + | {{Downloads/Get_Sugar_Landing}} |
| + | __NOTOC__ |
| | | |
| + | <br/><br/> |
| ==Are you new to Sugar?== | | ==Are you new to Sugar?== |
| | | |
− | The easiest way to get started is to use [[Sugar on a Stick]]. Basic instructions are found below. A more detailed [http://download.sugarlabs.org/soas/docs/creation-kit/ Sugar-on-a-Stick Creation Guide] is also available. | + | The easiest way to get started is to use [[Sugar on a Stick]]. Basic instructions are found below. A more detailed [http://download.sugarlabs.org/soas/docs/creation-kit/ Sugar-on-a-Stick Creation Guide] is also available. (If you already use GNU/Linux, you may want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] available from your distro.) |
− | | + | ---- |
| === MS Windows === | | === MS Windows === |
| | | |
Line 13: |
Line 15: |
| |[[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]||valign=top|'''(2) Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso. | | |[[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]||valign=top|'''(2) Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso. |
| |- | | |- |
− | |[[File:USB flash drive.jpg|156px]]||valign=top|'''(3) Burn''': Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer and launch Fedora Live USB Creator to create a Sugar-on-a-Stick bootable image. | + | |[[File:USB flash drive.jpg|156px]]||valign=top|'''(3) Burn''': Insert a USB flash drive (or SD Card) with 1 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. |
| |- | | |- |
| | ||valign=top|'''(4) Boot''': Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's BIOS, and then start up the computer. | | | ||valign=top|'''(4) Boot''': Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's BIOS, and then start up the computer. |
Line 19: |
Line 21: |
| | | |
| Detailed [[Sugar on a Stick/Windows|installation instructions for Windows]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Sugar on a Stick/Usage|guide to using Sugar on a Stick]]. | | Detailed [[Sugar on a Stick/Windows|installation instructions for Windows]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Sugar on a Stick/Usage|guide to using Sugar on a Stick]]. |
− | | + | ---- |
| === GNU/Linux === | | === GNU/Linux === |
− | GNU/Linux users may want to install the [[#Do_you_use_a_GNU.2FLinux_distro.3F|Sugar packages]] on their favorite distro. | + | GNU/Linux users may want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] on their favorite distro. |
| | | |
| {| | | {| |
Line 30: |
Line 32: |
| |- | | |- |
| |[[File:USB flash drive.jpg|156px]]||valign=top|'''(3) Burn''': Execute, as the root user, in <u>one</u> command with arguments, the following:<br> | | |[[File:USB flash drive.jpg|156px]]||valign=top|'''(3) Burn''': Execute, as the root user, in <u>one</u> command with arguments, the following:<br> |
− | {{Code|./livecd-iso-to-disk.sh --format --reset-mbr --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd'''?'''1}}<br> | + | {{Code|./livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd'''?'''1}}<br> |
| : where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc. | | : where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc. |
| |- | | |- |
Line 37: |
Line 39: |
| | | |
| 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 [[Sugar on a Stick/Usage|guide to using Sugar on a Stick]]. | | 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 [[Sugar on a Stick/Usage|guide to using Sugar on a Stick]]. |
− | | + | ---- |
| === Apple OSX === | | === Apple OSX === |
− | '''DRAFT''' | + | '''DRAFT''': These instructions are incomplete. Please help with testing and documentation. You may want to refer to the '''[[#Virtual Machines on all platforms|Virtual Machines instructions]]''' below. |
| {| | | {| |
| |- | | |- |
− | |width="160px"|[[File:Apple.gif|link=Sugar_on_a_Stick/Mac]]||valign=top|'''(1) Prepare''': These instructions are only for '''64-bit''' machines. (To identify processor, 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.) You may want to refer to the [[#Virtual Machines on all platforms|Virtual Machines instructions]] below. | + | |width="160px"|[[File:Apple.gif|link=Macintosh]]||valign=top|'''(1) Prepare''': These instructions are only for '''64-bit''' machines. (To identify processor, 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.) |
| |- | | |- |
| |[[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]||valign=top|'''(2) Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso. Be sure to download a '''64-bit''' image. | | |[[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]||valign=top|'''(2) Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso. Be sure to download a '''64-bit''' image. |
Line 48: |
Line 50: |
| |[[File:USB flash drive.jpg|156px]]||valign=top|'''(3) Burn''': '''Does someone have a simple way to burn a Live USB on a Mac?''' | | |[[File:USB flash drive.jpg|156px]]||valign=top|'''(3) Burn''': '''Does someone have a simple way to burn a Live USB on a Mac?''' |
| |- | | |- |
− | | ||valign=top|'''(4) 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.<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. | + | | ||valign=top|'''(4) 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. |
| + | * the '''c''' key must be pressed during the startup sound and you must continue to hold it down. |
| + | * you may release the '''c''' key once the Sugar logo appears. |
| |} | | |} |
| | | |
− | Alternative [[Sugar on a Stick/Mac|installation instructions for OSX]] Also:[http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Blueberry#For_Mac_OS_X_Users] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Sugar on a Stick/Usage|guide to using Sugar on a Stick]]. | + | Alternative [[Macintosh|installation instructions for OSX]] Also, [[Sugar_on_a_Stick/Blueberry#For_Mac_OS_X_Users|these older installation instructions]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Sugar on a Stick/Usage|guide to using Sugar on a Stick]]. |
| + | ---- |
| | | |
| === Advanced users === | | === Advanced users === |
Line 57: |
Line 62: |
| {| | | {| |
| |- | | |- |
− | |style="width: 160px;"|[[File:Sugar Creation Kit.png]]||valign=top| • '''Explore''' the [[Sugar_Creation_Kit]]<br/> • '''Try''' [[Sugar_on_a_Stick/Installation/Variations|customizing]] Sugar on a Stick;<br/> • '''Read''' the [http://download.sugarlabs.org/soas/docs/customization-guide/ detailed Customization Guide]; and<br/> • '''Read''' additional instructions for using [[VirtualBox]] and other virtual machines. | + | |style="width: 160px;"|[[File:Sugar Creation Kit.png]]||valign=top| |
| + | * '''Explore''' the [[Sugar Creation Kit]] |
| + | * '''Try''' [[Sugar_on_a_Stick/Installation/Variations|customizing]] Sugar on a Stick; |
| + | * '''Read''' the [http://download.sugarlabs.org/soas/docs/customization-guide/ detailed Customization Guide]; and |
| + | * '''Read''' additional instructions for using [[VirtualBox]] and other virtual machines. |
| |} | | |} |
| | | |
− | == Virtual Machines on all platforms == | + | <br/><br/> |
| + | ==Do you have an OLPC XO?== |
| | | |
| {| | | {| |
| |- | | |- |
− | | ||valign=top|'''(1) Prepare''': [http://www.virtualbox.org/wiki/Downloads Download] Sun Virtualbox (It is recommended that you read [http://people.sugarlabs.org/Tgillard/soas-v3-MirabelleREADME_FIRST.txt README_FIRST] before starting.) | + | |style="width: 160px"|[[Image:OLPCXO.png|middle|link=Dextrose]]||<!-- valign="top"|[[File:Dextrose-py-692x96.png|346px|link=Dextrose]]--> |
− | |- | + | * '''Upgrade''' to [[Deployment_Team/Fedora_on_the_XO-1 |Sugar 0.84 with Fedora 11 and Gnome]], the ''[http://wiki.laptop.org/go/OS_images#Stable_builds stable]'' OLPC release |
− | |width="160px"|[[File:VirtualBox.png|100px|left]]||valign=top|'''(2) Download''': Download these three files:<br/> [http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.mf soas-v3-Mirabelle.mf]<br/> [http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.ovf soas-v3-Mirabelle.ovf]<br/> [http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.vmdk soas-v3-Mirabelle.vmdk]<br/>Note that on some browsers on OSX, the file extensions are reset upon download. You may have to modify them to match those shown above.<br/>'''sugarroot''' is the root password.
| + | * '''Upgrade''' to [[Dextrose |Dextrose Sugar 0.88 with Fedora 11 and Gnome]] (requires a ''[http://wiki.laptop.org/go/Activation_and_developer_keys developer key]'') |
− | |-
| + | * '''Load ''' another one of the [[OLPC:OS images]] |
− | | ||valign=top|'''(3) Launch''': Virtualbox
| + | * '''Experiment''' with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release. |
− | |-
| |
− | | ||valign=top|'''(4) Import''': soas-v3-Mirabelle.ovf from the ''Import Appliance'' option under the ''File'' menu.
| |
| |} | | |} |
| | | |
− | Other virtual machine may also work but have not undergone testing with our images.
| + | <br/><br/> |
| | | |
− | ==Do you have an OLPC XO?== | + | ==Do you use GNU/Linux?== |
| | | |
| {| | | {| |
| |- | | |- |
− | |style="width: 160px"|[[Image:OLPCXO.png|middle|link=Dextrose]]||valign="top"|[[File:Dextrose-py-692x96.png|346px|link=Dextrose]]<br/> • '''Upgrade''' to [[Dextrose |Sugar 0.88 with Fedora 11 and Gnome]] | + | |width="160px" valign="top"|Select your favorite distribution<br/>[[File:Gnulinux.png]]|| |
| + | {| |
| + | |- |
| + | |[[Image:Fedora-small.jpg|link=Community/Distributions/Fedora]]<br/>[[Community/Distributions/Fedora|Fedora]] |
| + | |- |
| + | |[[Image:Debian-small.jpg|link=Community/Distributions/Debian]]<br/>[[Community/Distributions/Debian|Debian]]||[[Image:Trisquel_icon.png|link=Community/Distributions/Trisquel]]<br/>[[Community/Distributions/Trisquel|Trisquel]]||[[Image:Ubuntu-small.jpg|link=Community/Distributions/Ubuntu]]<br/>[[Community/Distributions/Ubuntu|Ubuntu]]||[[Image:Ubuntu-small.jpg|link=https://wiki.ubuntu.com/Sugar]]<br/>[https://wiki.ubuntu.com/Sugar Ubuntu Sugar Remix] |
| + | |- |
| + | |[[Image:Mandriva-small.png|link=Community/Distributions/Mandriva]]<br/>[[Community/Distributions/Mandriva|Mandriva]]||[[Image:Caixa_M%C3%A1gica-small.jpg|link=Community/Distributions/Magalhães]]<br/>[[Community/Distributions/Magalhães|Caixa Mágica]] |
| + | |- |
| + | |[[Image:Suse-small.jpg|link=http://en.opensuse.org/Sugar]]<br/>[http://en.opensuse.org/Sugar OpenSuse]|| |
| |- | | |- |
− | | || • '''Upgrade''' to [[Deployment_Team/Fedora_on_the_XO-1 |Sugar 0.84 with Fedora 11 and Gnome]]. | + | |[[Image:Altlinux-small.png|link=Community/Distributions/ALTLinux]]<br/>[[Community/Distributions/ALTLinux|AltLinux]] |
| |- | | |- |
− | | || • '''Load ''' one of the [[OLPC:OS images]] | + | |[[Image:Gentoo-small.png|link=Community/Distributions/Gentoo]]<br/>[[Community/Distributions/Gentoo|Gentoo]] |
| + | |} |
| |- | | |- |
− | | || • '''Experiment''' with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release. | + | |valign="top"|Or try a Live USB version of Sugar||[[File:Soas-mirabelle-logo.png|middle|200px|link=Sugar_on_a_Stick/Beta]], v4 alpha with Sugar 0.89.1 and Fedora 14 (Branched)<br/>[[Image:Trisquel_icon.png|link=Trisquel On A Sugar Toast]] Trisquel on a Sugar Toast (Trisquel 3.0 ''Dwyn'')<br/>[[Image:Suse-small.jpg|link=http://en.opensuse.org/Education/Live|Education/Live]] OpenSuse Live USB |
| |} | | |} |
| | | |
− | ==Do you use a GNU/Linux distro?== | + | <br/><br/> |
| + | == Virtual Machines on all platforms == |
| | | |
| {| | | {| |
| |- | | |- |
− | |style="width: 160px; valign: top" align="right"|Select your favorite distribution||[[Image:Fedora-small.jpg|link=Community/Distributions/Fedora]] [[Image:Debian-small.jpg|link=Community/Distributions/Debian]] [[Image:Ubuntu-small.jpg|link=https://wiki.ubuntu.com/Sugar]] [[Image:Ubuntu-small.jpg|link=Community/Distributions/Ubuntu]] [[Image:Gentoo-small.png|link=Community/Distributions/Gentoo]] [[Image:Altlinux-small.png|link=Community/Distributions/ALTLinux]] [[Image:Mandriva-small.png|link=Community/Distributions/Mandriva]] [[Image:Caixa_M%C3%A1gica-small.jpg|link=Community/Distributions/Magalhães]] [[Image:Suse-small.jpg|link=http://en.opensuse.org/Sugar]] [[Image:Suse-small.jpg|link=http://en.opensuse.org/Education/Live|Education/Live]] [[Image:Trisquel_icon.png|link=Community/Distributions/Trisquel]] | + | | ||valign=top|'''(1) Prepare''': [http://www.virtualbox.org/wiki/Downloads Download] Sun VirtualBox (It is recommended that you [http://people.sugarlabs.org/Tgillard/soas-v3-MirabelleREADME_FIRST.txt read this first].) |
| |- | | |- |
− | |valign="top" align="right"|Or try a Live USB version of Sugar||[[File:Soas-mirabelle-logo.png|middle|200px|link=Sugar_on_a_Stick/Beta]], v4 alpha with Sugar 0.89.1 and Fedora 14 (Branched)<br/>[[Image:Trisquel_icon.png|link=Trisquel On A Sugar Toast]] Trisquel on a Sugar Toast (Trisquel 3.0 ''Dwyn'') | + | |width="160px"|[[File:VirtualBox.png|100px|left]]||valign=top|'''(2) Download''': Download these three files: |
| + | ::[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.mf soas-v3-Mirabelle.mf] |
| + | ::[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.ovf soas-v3-Mirabelle.ovf] |
| + | ::[http://people.sugarlabs.org/Tgillard/soas-v3-Mirabelle.vmdk soas-v3-Mirabelle.vmdk] |
| + | :Note that on some browsers on OSX, the file extensions are reset upon download. You may have to modify them to match those shown above. |
| + | :'''sugarroot''' is the root password. |
| + | |- |
| + | | ||valign=top|'''(3) Launch''': VirtualBox |
| + | |- |
| + | | ||valign=top|'''(4) Import''': soas-v3-Mirabelle.ovf from the ''Import Appliance'' option under the ''File'' menu. |
| + | :If you run into problems, you may want to consult the [[Talk:VirtualBox]] page for help. |
| + | |- |
| + | | ||'''[[User_talk:Walter/Get_Sugar|Other virtual machines]]''' may also work but have not undergone testing with our images. |
| + | |
| |} | | |} |
| | | |
− | ==Are you looking for Sugar Activities?== | + | <br/><br/> |
| + | ==Are you a developer?== |
| + | |
| {| | | {| |
| |- | | |- |
− | |width="160px" valign="top" align="right"|Visit the [http://activities.sugarlabs.org Activity Portal]||[[Image:Sugarlabs_mainpage_02.png|link=http://activities.sugarlabs.org]] | + | |style="width: 160px"| ||valign=top|Learn how to get setup on the [[Supported systems]] page. |
| + | |- |
| + | |[[Image:Gear.png|middle|link=Supported_systems]]||valign=top|Some additional references you may find useful: |
| + | * [[Development Team/Jhbuild | jhbuild]] |
| + | * [http://git.sugarlabs.org Gitorious source code repository] |
| + | * [[Emulator image files|Virtual machine or emulator image files]] |
| + | * Adding Sugar to your [[Supported systems|favorite distro...]] |
| |} | | |} |
| | | |
− | ==Are you a systems developer?== | + | <br/><br/> |
| + | ==Are you preparing a deployment without Internet access?== |
| + | |
| {| | | {| |
| |- | | |- |
− | |style="width: 160px"|[[Image:Gear.png|middle|link=Supported_systems]]||valign=top|Learn how to get setup on the [[Supported systems]] page. | + | |style="width: 160px"|[[File:Sugar Creation Kit.png|left|link=Sugar Creation Kit]]||valign="top"|See [[Sugar Creation Kit]] |
− | |-
| |
− | | ||valign=top|Some additional references you may find useful:<br/> • [[Development Team/Jhbuild | jhbuild]]<br/> • [http://git.sugarlabs.org Gitorious source code repository]<br/> • [[Emulator image files|Virtual machine or emulator image files]]<br/> • Adding Sugar to your [[Supported systems|favorite distro...]]
| |
| |} | | |} |
| | | |
− | ==Are you preparing a deployment without Internet access?== | + | <br/><br/> |
| + | |
| + | ==Are you looking for Sugar Activities?== |
| | | |
| {| | | {| |
| |- | | |- |
− | |style="width: 160px"|[[File:Sugar Creation Kit.png|left|link=Sugar Creation Kit]]||valign="top"|See [[Sugar Creation Kit]] | + | |width="160px" valign="top"|Visit the [http://activities.sugarlabs.org Sugar Activity Library]||<imagemap> |
| + | File:Sugarlabs_mainpage_02.png |
| + | rect 14 14 38 47 [[sal:4076|Calculate]] |
| + | rect 74 15 107 44 [[sal:4069|Chat]] |
| + | rect 137 16 171 43 [[sal:4086|Implode]] |
| + | rect 201 14 238 46 [[sal:4264|Distance]] |
| + | rect 265 12 298 47 [[sal:4030|Etoys]] |
| + | rect 11 79 41 108 [[sal:4034|Moon]] |
| + | rect 74 78 106 110 [[sal:4082|Paint]] |
| + | rect 140 78 170 109 [[sal:4041|Pippy]] |
| + | rect 201 80 235 108 [[sal:4028|Read]] |
| + | rect 266 82 298 107 [[sal:4081|Record]] |
| + | rect 11 143 41 172 [[sal:4062|TamTam Synth Lab]] |
| + | rect 75 146 105 169 [[sal:4043|Terminal]] |
| + | rect 142 140 166 173 [[sal:4027|Turtle Blocks]] |
| + | rect 201 144 235 171 [[olpc:WikiBrowse|WikiBrowse]] |
| + | rect 269 142 299 173 [[sal:4201|Write]] |
| + | default [http://activities.sugarlabs.org Sugar Activity Library] |
| + | desc none |
| + | </imagemap> |
| |} | | |} |