Downloads: Difference between revisions

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:

# '''Prepare''':

#:~~{{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}}

#* Create a mount point: {{Code|sudo mkdir /media/soas}}

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

#* Mount the .iso file as a disk: {{Code|mount '''/path/to/source'''.iso /media/soas/}}

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

#* Insert a USB stick of 2 GB or greater capacity into your 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)~~:

#* Use the {{Code|sudo blkid}} or {{Code|df}} command to get the USB device node name.

#*:~~{{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}}

#* (You should have the isomd5sum package installed so that the following installation script can verify the download.)

# '''Load''': Execute, as the '''root''' user in one command with arguments, the following: <div style="padding: 1em; border: 1px dashed #2F6FAB; background-color: #FBFBFB; margin: 1em 0px 1em 1.6em; font-family: Courier;">sudo /media/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb '''500''' --home-size-mb '''900''' --delete-home --unencrypted-home '''/path/to/source'''.iso /dev/sd'''?'''1</div>

#: where '{{Code|'''?'''}}' in the final parameter represents the target USB device node, such as {{Code|sd'''b'''1}} or {{Code|sd'''c'''1}}, etc. and '''/path/to/source'''.iso file is the location and name of the .iso file.

# '''Boot''': Insert the USB stick into a bootable 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 other 1 GB or greater USB or SD devices. In the Terminal Activity of a running ''Sugar on a Stick'', run this command as root: <div style="padding: 1em; border: 1px dashed #2F6FAB; background-color: #FBFBFB; margin: 1em 0px 1em 0em; font-family: Courier;">/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb '''300''' --home-size-mb '''175''' --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd'''?'''1</div>

|}

Line 47:

Line 51:

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.

@@ Line 27: / Line 27: @@
 ----
 === 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>
-[[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]]
 |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>
 # '''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:
+# '''Prepare''':
-#:{{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}}
+#* Create a mount point: {{Code|sudo mkdir /media/soas}}
-#: 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>
+#* Mount the .iso file as a disk: {{Code|mount '''/path/to/source'''.iso /media/soas/}}
-# '''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.
+#* Insert a USB stick of 2 GB or greater capacity into your 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):
+#* Use the {{Code|sudo blkid}} or {{Code|df}} command to get the USB device node name.
-#*:{{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}}
+#* (You should have the isomd5sum package installed so that the following installation script can verify the download.)<br><br>
+# '''Load''': Execute, as the '''root''' user in <u>one</u> command with arguments, the following:<br><div style="padding: 1em; border: 1px dashed #2F6FAB; background-color: #FBFBFB; margin: 1em 0px 1em 1.6em; font-family: Courier;">sudo /media/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb '''500''' --home-size-mb '''900''' --delete-home --unencrypted-home '''/path/to/source'''.iso /dev/sd'''?'''1</div>
+#: where '{{Code|'''?'''}}' in the final parameter represents the target USB device node, such as {{Code|sd'''b'''1}} or {{Code|sd'''c'''1}}, etc. and '''/path/to/source'''.iso file is the location and name of the .iso file.<br><br>
+# '''Boot''': Insert the USB stick into a bootable 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.<br><br>
+::* You may create more Sugar Sticks on other 1 GB or greater USB or SD devices. In the Terminal Activity of a running ''Sugar on a Stick'', run this command as root:<br><div style="padding: 1em; border: 1px dashed #2F6FAB; background-color: #FBFBFB; margin: 1em 0px 1em 0em; font-family: Courier;">/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb '''300''' --home-size-mb '''175''' --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd'''?'''1</div>
 |}
@@ Line 47: / Line 51: @@
 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.