Changes

no edit summary
Line 1: Line 1: −
Consult these subpages:
+
<noinclude>{{TOCright}}
 +
[[Category:Sugar on a Stick]]
 +
[[Category:Live USB]]
 +
</noinclude>
 +
 
 +
==SoaS installation on USB/SD devices==
 +
 
 +
===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|/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 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.
 +
*: See [[#SoaS on VirtualBox|SoaS on VirtualBox]] below.
 +
 
 +
===with Apple Macintosh===
 +
* See and adapt the instructions at [[Sugar on a Stick/Mac]].
 +
===with GNU/Linux===
 +
<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>Execute, as the root user, in <u>one</u> command with arguments, the following:<br>
 +
{{Code|./livecd-iso-to-disk.sh --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /path/to/source.iso /dev/sd'''?'''1}}<br>
 +
: where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc.<br>
 +
''Be certain of your USB/SD '''s'''csi '''d'''rive node name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.).<br>
 +
: Use the {{Code|df -Th}} command to confirm your devices before executing the script.
 +
</li></ol>
 +
{{Show|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;You should see something like the following:
 +
|<pre>
 +
[root@MyComputer ~]# df -Th
 +
Filesystem    Type    Size  Used Avail Use% Mounted on
 +
/dev/sda1    ext4    18G  6.6G  11G  38% /
 +
tmpfs        tmpfs    1.6G  740K  1.6G  1% /dev/shm
 +
/dev/sdc1    vfat    15G  697M  15G  5% /media/SANDY
 +
/dev/sdb1    vfat    15G  2.0G  13G  14% /media/TOSHIBA
 +
</pre>
 +
:: where the mount point and filesystem sizes should help you identify what you want.
 +
 
 +
<pre>
 +
[root@MyComputer ~]#
 +
./livecd-iso-to-disk.sh --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /mnt/VMs/soas-x86_64-20100509.09.iso /dev/sdb1
 +
 
 +
Verifying image...
 +
/mnt/VMs/soas-x86_64-20100509.09.iso:  7c5f3227e4d87bb03f1cf89415ee80ce
 +
Fragment sums: b68ffc49a1213bca823fd5f16887291c571b44d55755488b3c229dafb631
 +
Fragment count: 20
 +
Checking: 100.0%
 +
 
 +
The media check is complete, the result is: PASS.
 +
 
 +
It is OK to use this media.
 +
 
 +
Copying live image to USB stick
 +
Updating boot config file
 +
Initializing persistent overlay file
 +
200+0 records in
 +
200+0 records out
 +
209715200 bytes (210 MB) copied, 16.6121 s, 12.6 MB/s
 +
Initializing persistent /home
 +
200+0 records in
 +
200+0 records out
 +
209715200 bytes (210 MB) copied, 15.2779 s, 13.7 MB/s
 +
Formatting unencrypted /home
 +
mke2fs 1.41.10 (10-Feb-2009)
 +
Filesystem label=
 +
OS type: Linux
 +
Block size=1024 (log=0)
 +
Fragment size=1024 (log=0)
 +
Stride=0 blocks, Stripe width=0 blocks
 +
51200 inodes, 204800 blocks
 +
10240 blocks (5.00%) reserved for the super user
 +
First data block=1
 +
Maximum filesystem blocks=67371008
 +
25 block groups
 +
8192 blocks per group, 8192 fragments per group
 +
2048 inodes per group
 +
Superblock backups stored on blocks:
 +
8193, 24577, 40961, 57345, 73729
 +
 
 +
Writing inode tables: done                           
 +
Creating journal (4096 blocks): done
 +
Writing superblocks and filesystem accounting information: done
 +
 
 +
This filesystem will be automatically checked every 23 mounts or
 +
180 days, whichever comes first.  Use tune2fs -c or -i to override.
 +
tune2fs 1.41.10 (10-Feb-2009)
 +
Setting maximal mount count to -1
 +
Setting interval between checks to 0 seconds
 +
Installing boot loader
 +
USB stick set up as live image!
 +
</pre>}}<!--
 +
 
 +
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==
 +
{{Transclude|VirtualBox|note=&nbsp;&nbsp;&nbsp;See instructions from the [[VirtualBox]] page (transcluded here): |collapsed=collapsed}}
 +
== Backup and Restore ==
 +
Some backup and restore options for Sugar on a Stick include the following:
 +
* [[olpc:School Server]] - requires a server installation.
 +
* [[Sugar on a Stick/deja-dup]]
 +
* [[Sugar on a Stick/Sugar Clone]]
 +
 
 +
 
 +
==Subpage index==
    
{{Special:PrefixIndex/{{FULLPAGENAME}}/}}
 
{{Special:PrefixIndex/{{FULLPAGENAME}}/}}