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

From Sugar Labs
Jump to navigation Jump to search
(44 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
<noinclude>
 
<noinclude>
 
[[Category:Live USB]]
 
[[Category:Live USB]]
</noinclude>{{TOCright}}
+
</noinclude>
==SoaS Release Testing==
+
==SoaS nightly builds==
Sugar 0.88 release testing is underway with Sugar on a Stick Mirabelle with Fedora 13 (Goddard).
+
[https://www.happyassassin.net/nightlies.html Fedora nightly-composes page] - Look for the '''SoaS live''' section well down in the table.
==Download and test==
+
* See [[Fedora 30]], [[Testing/Reports/Sugar on a Stick]] for testing results.
* [[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]
 
* See [[Sugar on a Stick/Mirabelle]]
 
* [[0.88/Testing|Sugar 0.88 Testing]].
 
==SoaS installation on USB/SD devices==
 
===with Linux===
 
* Use this script file to create a bootable image, http://bit.ly/livecd-iso-to-disk.
 
:(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).
 
  
'''Note:'''
+
==Install, test, report==
To install the .iso disc image, execute the shell script as the root user in <u>one</u> command with arguments as follows:
+
* See [[Sugar on a Stick/Installation]]
 +
**Note that with larger images one may need to adjust the overlay or home folder size in order to fit the installation onto a 1-GB USB device (for example, with soas-x86_64-20101004.16.iso (503 MB), {{Code|--home-size-mb 190}} was needed), otherwise, the filesystem will get corrupted during the creation of the home folder as the disc space is exhausted.
  
{{Code|./livecd-iso-to-disk --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd'''?'''1}}
+
* [[0.112/Testing|Sugar 0.112 Testing]]
 +
* [[Sugar on a Stick QA]]
 +
* [[Sugar on a Stick/Bugs]]
 +
* [[BugSquad/Bug Report]]
 +
<!--
  
: where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc.
+
Let's simplify the base instructions and leave this sort of information on a troubleshooting page.
  
:* ''Be certain of your USB/SD '''s'''torage '''d'''evice node 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===
 
* 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|900|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|/mnt/live/LiveOS/}} or {{Code|/LiveOS/}} (depending on a pending image configuration).<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'''torage '''d'''evice node 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.''
 
:'''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
 
*:{{Show|See the instructions at [[VirtualBox]]: |{{Transclude|VirtualBox}}}}
 
===with Apple Macintosh===
 
* See and adapt the instructions at [[Sugar on a Stick/Mac]].
 

Revision as of 12:34, 31 January 2019


SoaS nightly builds

Fedora nightly-composes page - Look for the SoaS live section well down in the table.

Install, test, report

  • See Sugar on a Stick/Installation
    • Note that with larger images one may need to adjust the overlay or home folder size in order to fit the installation onto a 1-GB USB device (for example, with soas-x86_64-20101004.16.iso (503 MB), --home-size-mb 190 was needed), otherwise, the filesystem will get corrupted during the creation of the home folder as the disc space is exhausted.