Line 6: |
Line 6: |
| ==Are you new to Sugar?== | | ==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 == | | == Sugar on a Stick installation instructions == |
Line 27: |
Line 27: |
| ---- | | ---- |
| === GNU/Linux === | | === GNU/Linux === |
− | {| | + | {|style="width: 800px;" |
| |- | | |- |
− | |width="160px"|<span class="linkgroup">[[File:Gnulinux.png|link=Sugar on a Stick/Linux]] | + | |width="160px" valign=top|<br><span class="linkgroup">[[File:Gnulinux.png|link=Sugar on a Stick/Linux]] |
| <br> | | <br> |
− | [[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]] </span> | + | [[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span> |
| [[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]] | | [[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]] |
| |valign=top| | | |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.<br>(You may need to run {{Code|chmod +x tools_livecd-iso-to-disk.sh}} after you download the script to make it executable.) <br>You should have the isomd5sum package installed so that the script can verify the download.<br><br>
| + | {{:Sugar on a Stick/Linux/Installation}} |
− | # '''Download''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br><br>
| |
− | # '''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 <u>one</u> 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.<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.
| |
− | #* 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. | | 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 === | | === 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]] |
| <br> | | <br> |
| <span class="linkgroup">[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span> | | <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]] | | [[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]] |
| |valign=top| | | |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.)<br><br> | + | 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.<br><br> | + | # '''Prepare''': These instructions are for '''32-bit''' and '''64-bit''' processors.<br><br> |
− | # '''Load''': <span style="background-color:#f9f6b7; padding: 10px; padding-left: 5px;">[[File:question.png|link=|middle]] '''Help: Does someone have a simple way to load a Live USB on a Mac?'''</span><br>Here is a simple way to recognize a bootable USB on a Mac.<br>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.<br> | + | # '''Download''' the latest [[Sugar on a Stick/Downloads|Sugar on a Stick]] .iso file.<br><br> |
− | #* [http://refit.sourceforge.net/doc/c1s5_burning.html How to Burn a rEFIt CD]
| + | # '''Load''': <br>Here is a simple way to load a bootable USB on a Mac.<br> |
− | #: 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]]<br><br> | + | ## 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.<br>
| + | ## Type <code>hdiutil convert -format UDRW -o <<i>Sugar on a Stick image file</i>>.img <<i>Sugar on a Stick image file</i>></code> to convert the image into a bootable format. |
| + | ## Type <code>sudo diskutil unmountDisk <<i>device name</i>></code> to unmount the disk (it will not be ejected). |
| + | ## Type <code>sudo dd if=<<i>Sugar on a Stick image file</i>>.img.dmg of=<<i>device name</i>> 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 <<i>device name</i>></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> | | <br> |
| :* Have a MacBook? Consider these options: | | :* 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]] | | :: [[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]] | | :: 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? | | :* 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.<br>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.<br>There is also a [[Getting Started/Explore|guide to exploring Sugar]]. |
| ---- | | ---- |
| + | |
| ===Advanced users=== | | ===Advanced users=== |
| ==Do you have an OLPC XO?== | | ==Do you have an OLPC XO?== |
Line 86: |
Line 82: |
| |width="174px"|[[File:OLPCXO.png|middle|link=olpc:Releases]] | | |width="174px"|[[File:OLPCXO.png|middle|link=olpc:Releases]] |
| |valign=top| | | |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. | | * '''Experiment''' with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release. |
Line 95: |
Line 89: |
| <br/><br/> | | <br/><br/> |
| ==Some alternate installations== | | ==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. | | :- 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,<br>'''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,<br>'''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. | | :- 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.''}} | | :- {{Highlight|bgcolor=#f9f6b7|''This requires a high-speed Internet connection for software component downloading during installation.''}} |
| | | |
| ==Do you use GNU/Linux?== | | ==Do you use GNU/Linux?== |
| + | {{:Supported distributions}} |
| + | |
| | | |
− | {|
| |
− | |-
| |
− | |width="178px" valign="top"|Select your favorite distribution<br><br><span class="linkgroup">[[File:Gnulinux.png|link=Community/Distributions]]</span><br>[[Community/Distributions]]||
| |
− | {|
| |
− | |-
| |
− | |[[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]]
| |
− | |<span class="linkgroup">[[File:Trisquel_icon.png|link=Community/Distributions/Trisquel]]</span><br/>[[Community/Distributions/Trisquel|Trisquel]]
| |
− | |align="center"|[[Image:Ubuntu-small.jpg|link=Community/Distributions/Ubuntu]]<br/>[[Community/Distributions/Ubuntu|Ubuntu]]
| |
− | |align="center"|<span class="linkgroup">[[File:LMD-small.png|link=Community/Distributions/Linux_Mint_Debian]]</span><br/>[[Community/Distributions/Linux_Mint_Debian|Linux Mint Debian]]
| |
− | |-
| |
− | |align="center"|<span class="linkgroup">[[File:Mageia-2011.png|150px|link=Community/Distributions/Mageia]]</span><br/>[[Community/Distributions/Mageia|Mageia-2]]
| |
− | |align="center"|<span class="linkgroup">[[Image:Mandriva-small.png|link=Community/Distributions/Mandriva]]</span><br/>[[Community/Distributions/Mandriva|Mandriva]]
| |
− | |align="center"|[[Image:Caixa_M%C3%A1gica-small.jpg|link=Community/Distributions/Magalhães]]<br/>[[Community/Distributions/Magalhães|Caixa Mágica]]
| |
− | |-
| |
− | |align="center"|[[Image:Suse-small.jpg|link=Community/Distributions/OpenSUSE]]<br/>[[Community/Distributions/OpenSUSE| openSUSE]]
| |
− | |[[Image:Suse-small.jpg|link=http://en.opensuse.org/Sugar]]<br/>[http://en.opensuse.org/Sugar openSUSE]||
| |
− | |-
| |
− | |align="center"|[[Image:Arch-logo.png|link=http://wiki.archlinux.org/index.php/Sugar]]<br/> [http://wiki.archlinux.org/index.php/Sugar Archlinux]||
| |
− | |-
| |
− | |<span class="linkgroup">[[Image:Altlinux-small.png|link=Community/Distributions/ALTLinux]]</span><br/>[[Community/Distributions/ALTLinux|AltLinux]]
| |
− | |-
| |
− | |<span class="linkgroup"></span><br/>[[Sweets_Distribution#Installation|Sweets Distribution]]
| |
− | |-
| |
− | |}
| |
− | |-
| |
− | |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)<br/>[[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 <br/><span class="linkgroup">[[File:Trisquel_icon.png|link=Trisquel On A Sugar Toast]]</span> Trisquel TOAST <br/>
| |
− | |}
| |
| ===Are you a developer?=== | | ===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: | | 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: |
| {| | | {| |
| |- | | |- |
− | |width="160px"|[[File:VirtualBox.png|100px|left|link=Sugar Creation Kit/VirtualBox]] | + | |width="160px"|[[File:VirtualBox.png|100px|left|link=Sugar_on_a_Stick/Virtual_machines]] |
| |valign=top| | | |valign=top| |
| ===[[Sugar Creation Kit/VirtualBox|VirtualBox Appliances]] === | | ===[[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. | | If you run into problems, you may want to consult the [[Talk:VirtualBox]] page for help. |
| <br/><br/> | | <br/><br/> |
− |
| |
| | | |
| ==Are you preparing a deployment without Internet access?== | | ==Are you preparing a deployment without Internet access?== |