Difference between revisions of "Sugar on a Stick/Beta"

From Sugar Labs
Jump to navigation Jump to search
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]].

Revision as of 00:57, 10 May 2010


SoaS Release Testing

Sugar 0.88 release testing is underway with Sugar on a Stick Mirabelle with Fedora 13 (Goddard).

Download and test

SoaS installation on USB/SD devices

with Linux

(Run 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).

Note: To install the .iso disc image, execute the shell script as the root user in one command with arguments as follows:

./livecd-iso-to-disk --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd?1

where '?' in the final parameter represents the target bootable device node, such as sdb1 or sdc1, etc.
  • Be certain of your USB/SD storage device name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example, /dev/sdb1. Use the mount command or the partition manager to confirm it before executing the script.

with Microsoft Windows

  • Using Fedora Live USB Creator
    1. Download the Live USB Creator from FedoraHosted here.
    2. Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer. (See LiveOS image and Cautions with using Live USB devices regarding flash drive size and usage.)
    3. Launch Live USB Creator.
    4. Select the 'Browse' button to 'Use existing Live CD' and find the downloaded .iso file image on your system.
    5. Adjust the Persistent Storage slider. This enables you to save changes to the system and additional Sugar Activities onto the device.
    6. Select your flash drive as the target, and click the Create Live USB button.
    7. Wait for the process to finish, then close the Live USB Creator program.
    8. Stop your flash drive using the Safely Remove Hardware dialog, and eject it.
    Note: This installation method does not allow the full optimization of data storage that comes from installing a separate, persistent home directory—see the alternate method below.
  • Burn the soas-mirabelle.iso file onto a CD-ROM disc.
    1. Use Windows 7 built-in Disk Image Burner or a free utility like ImgBurn to write the downloaded SoaS.iso file onto a blank CD.
    2. Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer. (See LiveOS image and Cautions with using Live USB devices regarding flash drive size and usage.)
    3. 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.
    4. A successful boot will take you into Sugar on a Stick Mirabelle. From there you can open the Terminal Activity from the Home view.
    5. Click the 'Become root' icon 55px-Activity-terminal.svg.png to gain administrative permissions.
    6. Change the working directory to /mnt/live/LiveOS/ or /LiveOS/ (depending on pending image configuration).
    7. execute the Linux command line:

./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 storage device name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example, /dev/sdb1. Use the mount command to confirm it before executing the script.

with Apple Macintosh

See and adapt the instructions at Sugar on a Stick/Mac.