Changes

Jump to navigation Jump to search
Remove line as it was unnecessary
Line 1: Line 1: −
<noinclude>{{TOCright}}
+
<noinclude>
 +
[[Category:HowTo]]
 
[[Category:Sugar on a Stick]]
 
[[Category:Sugar on a Stick]]
[[Category:Live USB]]
+
</noinclude>__TOC__
</noinclude>
      +
Sugar on a Stick is best installed by following the [https://docs.fedoraproject.org/en-US/fedora/rawhide/install-guide/ Fedora Installation Guide].
 +
 +
The rest of this Wiki page is outdated, or superceded by the Fedora Installation Guide.
 +
 +
{{outdated}}
 +
 +
----
 +
{|http://wiki.sugarlabs.org/index.php?title=Sugar_on_a_Stick/Installation&action=submit#SoaS_on_VirtualBox
 +
|-
 +
|
 +
* [[#with_Microsoft_Windows|Microsoft Windows]]
 +
* [[#with_GNU.2FLinux|GNU/Linux]]
 +
* [[#on_an_OLPC_XO|OLPC XO]]
 +
* [[#SoaS_on_VirtualBox|VirtualBox]]
 +
* [[#with_Apple_Macintosh|Apple Mac OS X]]
 +
* [[#Backup and Restore|Backup and Restore]]
 +
|
 +
* Following [[Sugar on a Stick/Downloads|download]], ''Sugar on a Stick'' may be [[Sugar_on_a_Stick/Installation|Installed]] (instructions here), then [[Sugar on a Stick/Boot|booted]].
 +
* Then you are ready to [[Getting Started/Explore|start exploring Sugar]].
 +
|}
 
==SoaS installation on USB/SD devices==
 
==SoaS installation on USB/SD devices==
 +
{{:Sugar on a Stick/Windows}}
   −
===with Microsoft Windows===
  −
[[File:Windows.gif|link=]]
  −
* 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|945|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 {{Code|df -Th}} command to confirm your devices 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===
 
===with Apple Macintosh===
[[File:Apple.gif|link=]]
+
[[File:Apple.gif|link=Macintosh]]
* See and adapt the instructions at [[Sugar on a Stick/Mac]].
+
* See and adapt the instructions at [[Macintosh]].
 +
===='''Fedora 15 and Fedora 16'''====
 +
* Sugar on a Stick CD boots in a Mac - [[Testing/Reports/Sugar on a Stick#MacBook Pro i7 CD Boot]]
 +
: The following work on some Intel MacBooks
 +
:: Persistent USB for Mac - [[Testing/Reports/Sugar on a Stick#MacBook Persistent SoaS v5 and SoaS v6 EFI Boot USB]]
 +
::dd writable USB.img - [[Testing/Reports/Sugar_on_a_Stick#dd_writable_1_GB_EFI_Boot_.28MAC.29_USB_Soas-v6-Pineapple_x86-USB_.img]]
 +
 
    
===with GNU/Linux===
 
===with GNU/Linux===
[[File:Gnulinux.png|link=]]<ol start="0">
+
<span class="linkgroup">[[File:Gnulinux.png|link=Sugar on a Stick/Linux]]</span>
<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>
+
{{:Sugar on a Stick/Linux/Installation}}
<li>Execute, as the root user, in <u>one</u> command with arguments, the following:<br>
+
:: (See [[Sugar on a Stick/Linux]] for more details.)
{{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>
+
:'''Note''': The graphical Liveusb-creator is an alternative installation method (see the first Windows [[#with Microsoft Windows |method]]), but it does not create the separate home.img filesystem, and so, the write-once persistent storage on the disk is more quickly consumed (see [[LiveOS image]]). If the USB device does not boot after running Liveusb-creator, the command {{Code|liveusb-creator --reset-mbr}} may help.
: 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
+
=== Sugar on a Stick on Raspberry Pi 2/3 ===
Updating boot config file
+
{{:Sugar on a Stick/Raspberry Pi}}
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                           
+
=== on an OLPC XO ===
Creating journal (4096 blocks): done
+
[[File:OLPCXO.png|link=Testing/Reports/Sugar on a Stick#F16 SoaS Pineapple USB boot image for XO-1|50px]]
Writing superblocks and filesystem accounting information: done
+
* See [[Testing/Reports/Sugar on a Stick#F16 SoaS Pineapple USB boot image for XO-1|F16 SoaS Pineapple USB boot image for XO-1]]
 +
: Very slow but works
   −
This filesystem will be automatically checked every 23 mounts or
+
==Hard disk and alternate USB stick installations==
180 days, whichever comes first. Use tune2fs -c or -i to override.
+
====[[Tutorials/Installation/Install with netinstall|with a Netinstall CD]]====
tune2fs 1.41.10 (10-Feb-2009)
+
* Fedora with the Sugar graphical environment
Setting maximal mount count to -1
+
* Installs to a hard disk or to a 4 GB USB stick (not a LiveOS image like SoaS, but all of Sugar).
Setting interval between checks to 0 seconds
+
: {{Highlight|bgcolor=#f9f6b7|''This requires a high-speed Internet connection for software component downloading during installation.''}}
Installing boot loader
+
====[[Tutorials/Installation/Install with liveinst|with the {{Code|liveinst}} command]]====
USB stick set up as live image!
+
: '''..from a booted Fedora 16 SoaS Live CD/USB'''
</pre>}}<!--
+
* Installs to a hard disk or a 4 GB USB stick. You start with a SoaS LiveOS image, and then load an uncompressed version onto the hard disk or USB stick.
 +
: The Fedora-16-Live-SoaS.iso file is a 443 MB download.
   −
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==
 
==SoaS on VirtualBox==
 
<noinclude>{{Transclude|VirtualBox|note=&nbsp;&nbsp;&nbsp;See instructions from the [[VirtualBox]] page (transcluded here): |collapsed=collapsed}}</noinclude><includeonly>
 
<noinclude>{{Transclude|VirtualBox|note=&nbsp;&nbsp;&nbsp;See instructions from the [[VirtualBox]] page (transcluded here): |collapsed=collapsed}}</noinclude><includeonly>
 
* See [[VirtualBox]]</includeonly>
 
* See [[VirtualBox]]</includeonly>
== Backup and Restore ==
+
 
 +
 
 +
= Chat room help =
 +
*'''[http://webchat.freenode.net/?randomnick=1&channels=sugar&prompt=1 Sugar chat room in English]'''
 +
 
 +
*'''[http://webchat.freenode.net/?randomnick=1&channels=sugar-es&prompt=1 Sugar chat room in Español]''' (with translations to English)
 +
*: Pida ayuda a través de este canal #sugar-es Por favor, sea cortés y hacer sus preguntas.<br>Los voluntarios no pueden estar en línea todo el tiempo.<br>Sea paciente y permanecer conectado durante varios minutos para ver su respuest.
 +
*::(Utilizar la función de meeting para la traducción de estos artículos.)
 +
 
 +
 
 +
= Backup and Restore =
 
Some backup and restore options for Sugar on a Stick include the following:
 
Some backup and restore options for Sugar on a Stick include the following:
 +
* [http://activities.sugarlabs.org/en-US/sugar/addon/4326 Backup] and [http://activities.sugarlabs.org/en-US/sugar/addon/4327 Restore] - these are Activities that can be used on any Sugar installation to backup or restore the Sugar Journal.
 +
 
* [[olpc:School Server]] - requires a server installation.
 
* [[olpc:School Server]] - requires a server installation.
* [[Sugar on a Stick/deja-dup]]
+
* [[Sugar on a Stick/Sugar Clone]] - full image (operating system and home folder) cloning.
* [[Sugar on a Stick/Sugar Clone]]
        −
==Subpage index==
+
=Subpage index=
    
{{Special:PrefixIndex/Sugar on a Stick/Installation/}}
 
{{Special:PrefixIndex/Sugar on a Stick/Installation/}}
89

edits

Navigation menu