Sugar on a Stick/Installation: Difference between revisions

No edit summary
No edit summary
Line 1: Line 1:
<noinclude>{{TOCright}}
<noinclude>{{TOCright}}
[[Category:HowTo]]
[[Category:Sugar on a Stick]]
[[Category:Sugar on a Stick]]
[[Category:Live USB]]
[[Category:Live USB]]
Line 5: Line 6:


==SoaS installation on USB/SD devices==
==SoaS installation on USB/SD devices==
 
{{:Sugar on a Stick/Windows}}
===with Microsoft Windows===
[[File:Windows.gif|link=]]
* Either use '''Fedora Live USB Creator'''
*# Download the Live USB Creator from [http://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].
*# Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer. (See [[LiveOS image]] and [[Sugar on a Stick/Installation/Variations#Cautions with using Live USB devices|Cautions with using Live USB devices]] regarding flash drive size and usage.)
*# Launch Live USB Creator.
*# Select the 'Browse' button to 'Use existing Live CD' and find the downloaded .iso file image on your system.
*# Adjust the Persistent Storage slider. This enables you to save changes to the system and additional Sugar Activities onto the device.
*# Select your flash drive as the target, and click the '''Create Live USB''' button.
*# Wait for the process to finish, then close the Live USB Creator program.
*# Stop your flash drive using the '''Safely Remove Hardware''' dialog, and eject it.
:'''Note:''' The above installation method does not allow the full [[LiveOS image|optimization]] of data storage that comes from installing a separate, persistent home directory&mdash;see the alternate method below.
* or '''Burn a CD-ROM disc''' with the soas-mirabelle.iso file.
*# Use [http://windowsteamblog.com/blogs/windowsexperience/archive/2009/04/13/burn-iso-images-natively-in-windows-7.aspx Windows 7 built-in Disk Image Burner] or a free utility, like [http://www.imgburn.com/ ImgBurn], to write the downloaded SoaS.iso file onto a blank CD.
*# Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer. (See [[LiveOS image]] and [[Sugar on a Stick/Installation/Variations#Cautions with using Live USB devices|Cautions with using Live USB devices]] regarding flash drive size and usage.)
*# Boot your computer with the CD-ROM disc.  You probably need to press F1, F12, Esc, or a similar key as the computer starts up to adjust the boot source to the CD-ROM device.
*# A successful boot will take you into ''Sugar on a Stick Mirabelle''.  From there, open the Terminal Activity, [[File:Activity-terminal.png|bottom|link=http://en.flossmanuals.net/terminal]], from the Home view.<br>{{Iframe|[http://en.flossmanuals.net/terminal ''See the Terminal Activity manual.''] |http://en.flossmanuals.net/terminal|945|400|1}}
*# Click the 'Become root' icon, [[File:Activity-become-root.svg|40px|bottom|link=http://en.flossmanuals.net/terminal]], to gain administrative permissions in the Terminal session.
*# Change the working directory to {{Code|/LiveOS/}}<br>{{Code|cd /LiveOS/}}
*# execute the Linux command line:<br>{{Code|./livecd-iso-to-disk --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /dev/live /dev/sd'''?'''1}}
:: ''Be certain of your USB/SD '''s'''csi '''d'''rive node name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,'' {{Code|/dev/sdb1}}.
::: Use the {{Code|df -Th}} command to confirm your devices before executing the script.
:'''Note:''' Every ''[[Sugar on a Stick/Mirabelle|Mirabelle]] or [[Sugar on a Stick/Strawberry|Strawberry]] Sugar on a Stick'' can copy its original installation to another USB stick or SD card by following the above instructions.  See [[Sugar on a Stick/Sugar Clone]] for instructions on how to customize the contents of a Sugar on a Stick device.
* or '''Launch a virtual machine''', such as VirtualBox with the soas-mirabelle.iso file.
*: See [[#SoaS on VirtualBox|SoaS on VirtualBox]] below.


===with Apple Macintosh===
===with Apple Macintosh===
[[File:Apple.gif|link=]]
[[File:Apple.gif|link=Sugar on a Stick/Mac]]
* See and adapt the instructions at [[Sugar on a Stick/Mac]].
* See and adapt the instructions at [[Sugar on a Stick/Mac]].


===with GNU/Linux===
===with GNU/Linux===
[[File:Gnulinux.png|link=]]<ol start="0">
[[File:Gnulinux.png|link=Sugar on a Stick/Linux]] (See [[Sugar on a Stick/Linux]] for more details.)
<ol start="0">
<li>Use this script file http://bit.ly/livecd-iso-to-disk to create a bootable image.<br>(Run {{Code|chmod +x livecd-iso-to-disk.sh}} after you download the script to make it executable.)</li>
<li>Use this script file http://bit.ly/livecd-iso-to-disk to create a bootable image.<br>(Run {{Code|chmod +x livecd-iso-to-disk.sh}} after you download the script to make it executable.)</li>
<li>Execute, as the root user, in <u>one</u> command with arguments, the following:<br>
<li>Execute, as the root user, in <u>one</u> command with arguments, the following:<br>
Line 108: Line 85:
Installing boot loader
Installing boot loader
USB stick set up as live image!
USB stick set up as live image!
</pre>}}<!--
</pre>}}
=== on an OLPC XO-1 ===
[[File:OLPCXO.png|link=Sugar on a Stick/Installation/OLPC|50px]]
This [http://www.mail-archive.com/devel@lists.laptop.org/msg23544.html discussion thread] explains why Fedora 13 and [[Sugar on a Stick/Mirabelle]] are not compatible with the XO-1 (until a fix is implemented).
* See [[Deployment Team/Sugar-0.88 Notes]] for the latest Sugar version 0.88 on Fedora 11 for the XO-1.


Let's simplify the base instructions and leave this sort of information on a troubleshooting page.
:* <code>--format --reset-mbr</code> are optional arguments for the shell script, but may be excluded to preserve the existing disc format and data.  See [[olpc:How to Damage a FLASH Storage Device]] for a discussion of why you might want to try to keep your factory format on a flash storage device.
:*: [[Talk:Downloads]] and [[LiveOS image]] have more information on this and other installation options.
:* If you do use the format and reset master boot record arguments, you'll want to specify the target device name and not a partition, that is {{Code|/dev/sd'''?'''}} with no partition number, instead of {{Code|/dev/sd'''?'''1}} as in the example above used to specify an existing partition. ''As noted above, confirm your target disc device name&mdash;in this case, it is VERY DANGEROUS to your other discs if this is entered wrong, as the whole disc will be reformatted and a new master boot record written causing all previously written data on that disc to be lost.''  -->
==SoaS on VirtualBox==
==SoaS on VirtualBox==
<noinclude>{{Transclude|VirtualBox|note=&nbsp;&nbsp;&nbsp;See instructions from the [[VirtualBox]] page (transcluded here): |collapsed=collapsed}}</noinclude><includeonly>
<noinclude>{{Transclude|VirtualBox|note=&nbsp;&nbsp;&nbsp;See instructions from the [[VirtualBox]] page (transcluded here): |collapsed=collapsed}}</noinclude><includeonly>
* See [[VirtualBox]]</includeonly>
* See [[VirtualBox]]</includeonly>
== Backup and Restore ==
= Backup and Restore =
Some backup and restore options for Sugar on a Stick include the following:
Some backup and restore options for Sugar on a Stick include the following:
* [[olpc:School Server]] - requires a server installation.
* [[olpc:School Server]] - requires a server installation.
* [[Sugar on a Stick/deja-dup]]
* [[Sugar on a Stick/deja-dup]]
* [[Sugar on a Stick/Sugar Clone]]
* [[Sugar on a Stick/Sugar Clone]]


==Subpage index==
==Subpage index==


{{Special:PrefixIndex/Sugar on a Stick/Installation/}}
{{Special:PrefixIndex/Sugar on a Stick/Installation/}}