Downloads: Difference between revisions

Line 42:

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

{|

|-

Line 50:

Line 49:

[[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.)~~

# '''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~~. Be sure to download a '''64-bit''' image~~.

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

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

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

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

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

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

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

#* [[Sugar_on_a_Stick/~~Macintosh#Building_a_bootable_Mac_USB_stick|Building and Booting a Live USB stick on a Mac]]~~

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

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

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

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

@@ Line 42: / Line 42: @@
 === 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.
 {|
 |-
@@ Line 50: / Line 49: @@
 [[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.)<br><br>
+# '''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. Be sure to download a '''64-bit''' image.<br><br>
+# '''Download''' the latest [[Sugar on a Stick/Downloads|Sugar on a Stick]] .iso file.<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>
+# '''Load''': <br>Here is a simple way to recognize a bootable USB on a Mac.<br>
-#* [http://refit.sourceforge.net/doc/c1s5_burning.html How to Burn a rEFIt CD]
+## Enter the Terminal: <code>/Applications/Utilities/Terminal</code>.
-#: You can rename the .cdr file to .iso for use in GNU/Linux.
+## Type <code>diskutil list</code>. You should see all the disk drives you have inserted into your computer.
-#* [[Sugar_on_a_Stick/Macintosh#Building_a_bootable_Mac_USB_stick|Building and Booting a Live USB stick on a Mac]]<br><br>
+## Insert the disk drive to which you want to write Sugar on a Stick.
-# '''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.
+## 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; 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).
 #* 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.<br>