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

From Sugar Labs
Jump to navigation Jump to search
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 tools_livecd-iso-to-disk.sh</code> after you download the script.)
+
:(Don't forget to {{Code|chmod +x livecd-iso-to-disk.sh}} after you download the script.)
 
* 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 22: Line 22:
 
: (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.)
 
: (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</code>. ''Use the mount command or the partition manager to confirm it before executing the script.''
+
:* (*) ''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.''
 
:* <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*</code> with no partition number, instead of <code>/dev/sd*1</code> 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).
 
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).

Revision as of 05:01, 9 May 2010


SoaS Release Testing

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

Download and test

SoaS installation on USB/SD devices

with Linux

(Don't forget to chmod +x livecd-iso-to-disk.sh after you download the script.)
  • 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.
(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 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.
  • --format --reset-mbr 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 /dev/sd? with no partition number, instead of /dev/sd?1 as in the example above used to specify an existing partition. As noted above, confirm your target disc device name—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

In Microsoft Windows, one may use the Fedora Live USB Creator from FedoraHosted here, (but one will not have the full optimization of data storage allowed by installing a separate, persistent home directory).

  • Plug a blank target USB flash drive (or SD Card) into your computer (1 GB or greater). (See LiveOS image and Cautions with using Live USB devices regarding flash drive size.)
  • 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 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.

with Apple Macintosh

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