Sugar on a Stick/Beta: Difference between revisions

No edit summary
Line 3: Line 3:
</noinclude>{{TOCright}}
</noinclude>{{TOCright}}
==SoaS Release Testing==
==SoaS Release Testing==
Sugar 0.88 release testing is underway on a Sugar on a Stick image with Fedora 13 (Goddard).
Sugar 0.88 release testing is underway with Sugar on a Stick Mirabelle with Fedora 13 (Goddard).
==Download and test==
==Download and test==
* [[File:Soas-mirabelle-logo.png|120px|link=http://alt.fedoraproject.org/pub/alt/nightly-composes/soas/]] ''Mirabelle'' [http://alt.fedoraproject.org/pub/alt/nightly-composes/soas/ Nightly builds]  
* [[File:Soas-mirabelle-logo.png|120px|link=http://alt.fedoraproject.org/pub/alt/nightly-composes/soas/]] ''Mirabelle'' [http://alt.fedoraproject.org/pub/alt/nightly-composes/soas/ Nightly builds]  
Line 11: Line 11:
===with Linux===
===with Linux===
* Use this script file to create a bootable image, http://bit.ly/livecd-iso-to-disk.
* Use this script file to create a bootable image, http://bit.ly/livecd-iso-to-disk.
:(Don't forget to {{Code|chmod +x livecd-iso-to-disk.sh}} after you download the script.)
:(Run {{Code|chmod +x livecd-iso-to-disk.sh}} after you download the script to make it executable.)
* The .iso file may be burnt to a CD-ROM and booted on your PC (or mounted in a virtual machine to boot it).
* The .iso file may be burnt to a CD-ROM and booted on your PC (or mounted in a virtual machine to boot it).


Line 20: Line 20:


: 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.
: (You may use '\' line-continuation symbols followed by a newline [enter or return keypress] to break a long line visually on the terminal, but not logically to the script processing software.)


:* (*) ''be sure of your USB/SD '''s'''torage '''d'''evice name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,'' {{Code|/dev/sdb1}}. ''Use the mount command or the partition manager to confirm it before executing the script.''
:* ''Be certain of your USB/SD '''s'''torage '''d'''evice name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,'' {{Code|/dev/sdb1}}. ''Use the mount command or the partition manager to confirm it before executing the script.''
<!-- let 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.  
:* <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.
:*: [[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.''
:* 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.'' -->


===with Microsoft Windows===
===with Microsoft Windows===
In Microsoft Windows, one may use the '''Fedora Live USB Creator''' from [http://fedorahosted.org/liveusb-creator/#Download FedoraHosted here], (but one will not have the full [[LiveOS image|optimization]] of data storage allowed by installing a separate, persistent home directory).
* Using '''Fedora Live USB Creator'''  
* Plug a blank target USB flash drive (or SD Card) into your computer (1 GB or greater). (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.)
*# Download the Live USB Creator from [http://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].  
* Launch Live USB Creator.
*# 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.)
* Select the Browse button to 'Use existing Live CD' and find the downloaded .iso file image on your system.  
*# Launch Live USB Creator.
* Adjust the Persistent Storage slider. This enables you to save changes to the system and Sugar Activities onto the device.
*# Select the 'Browse' button to 'Use existing Live CD' and find the downloaded .iso file image on your system.  
* Select your flash drive as the target and click the '''Create Live USB''' button.
*# Adjust the Persistent Storage slider. This enables you to save changes to the system and additional Sugar Activities onto the device.
* Wait for the process to finish, then close the Live USB Creator program.
*# Select your flash drive as the target, and click the '''Create Live USB''' button.
* Stop your flash drive using the '''Safely Remove Hardware''' dialog and eject it.
*# 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:''' This 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.
* Burn the soas-mirabelle.iso file onto a CD-ROM disc.
*# 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 you can open the Terminal Activity from the Home view.
*# Click the 'Become root' icon <span class="plainlinks">[{{fullurle:Terminal}} http://wiki.laptop.org/images/thumb/1/14/Activity-terminal.svg/55px-Activity-terminal.svg.png]</span> to gain administrative permissions.
*# Change the working directory to {{Code|/mnt/live/LiveOS/}} or {{Code|/LiveOS/}} (depending on pending image configuration).
*# 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}}<br>
:: ''Be certain of your USB/SD '''s'''torage '''d'''evice name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,'' {{Code|/dev/sdb1}}. ''Use the mount command to confirm it before executing the script.''
===with Apple Macintosh===
===with Apple Macintosh===
See and adapt the instructions at [[Sugar on a Stick/Mac]].
See and adapt the instructions at [[Sugar on a Stick/Mac]].