Sugar on a Stick/Installation

Following download, Sugar on a Stick must be Installed (instructions here), then booted. Then you are ready to start exploring Sugar.

SoaS installation on USB/SD devices

with Microsoft Windows

There are three ways to do this:

• 1. Use Fedora Live USB Creator

  (This installation method is not recommended for long-time usage of Sugar on a Stick. See why.)

  1. Download the Live USB Creator from Fedora.
  2. Insert a USB flash drive (or SD Card) with 2 GB or more of free space into your computer.
  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 with the Safely Remove Hardware and Eject Media notification area icon dialog, and eject it.

See a video of an earlier version of this process here.

• 2. Burn a CD-ROM disc, boot from it, then run the script, livecd-iso-to-disk
  1. Use Windows 7 built-in Disk Image Burner or a free utility, like ImgBurn, to write the downloaded Sugar on a Stick .iso file onto a blank CD.
  2. Insert a USB flash drive (or SD Card) with 2 GB or more of free space into your computer.
  3. Boot your computer with the CD-ROM disc. You probably need to press F1, F10, F12, Esc, or a similar key as the computer starts up in order to set the boot source for your computer to the CD-ROM device.
  4. A successful boot will take you into Sugar on a Stick. You can From there, open the Terminal Activity, , from the Home view.
  5. Click the 'Become root' icon, , to gain administrative permissions in the Terminal session.
  6. Change the working directory to /LiveOS/
cd /LiveOS/
  7. Be certain of your USB/SD scsi drive node name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example, /dev/sdb1.

     Use the df -Th command to confirm your devices before executing the following script.

  8. execute the Linux command line:
     ./livecd-iso-to-disk --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /dev/sr0 /dev/sd?1
  9. Shutdown the physical machine.
  10. Reboot from the newly-installed Live USB with Sugar on a Stick.

• 3. Launch a virtual machine, then run the script, livecd-iso-to-disk
  1. Download and install VirtualBox (for example; you could do something similar with another vm).
  2. Create a new virtual machine.
  3. Choose Linux for the Operating System and Version Fedora (64 bit) if available, or Fedora, on systems lacking 64-bit functionality.
  4. Attach the Sugar on a Stick .iso file as a CD in the Storage Section
  5. Insert a USB storage device into your physical computer and enable the VirtualBox USB controller. Then add a filter to recognize the inserted device in the USB section of the VirtualBox machine setup.
  6. Start the new virtual machine.
  7. Verify that the USB device is recognized in the running virtual machine.
     • Your device appears in the hover box for the USB stick icon in the virtual machine bottom frame.
     • df -Th reveals your device mounted mounted on a device node, for example, /dev/sda1, on a filesystem volume mount point, such as /media/<USBdeviceManufacturer>

You should see something like the following:

[root@localhost LiveOS]# df -Th
Filesystem    Type    Size  Used Avail Use% Mounted on
/dev/mapper/live-rw
             ext4    4.0G  1.5G  2.5G  37% /
tmpfs        tmpfs    250M  236K  249M   1% /dev/shm
/dev/sr0   iso9660    477M  477M     0 100% /mnt/live
varcacheyum  tmpfs    250M     0  250M   0% /var/cache/yum
/tmp         tmpfs    250M   24K  249M   1% /tmp
vartmp       tmpfs    250M     0  250M   0% /var/tmp
/dev/sda1     vfat     15G  2.4G   13G  17% /media/TOSHIBA

9. Continue from step #4 in the Burn a CD-ROM disc section above.
10. Shutdown the virtual machine.
11. Reboot your physical computer from the newly-installed Live USB with Sugar on a Stick.

with Apple Macintosh

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

Fedora 15 and Fedora 16

• Sugar on a Stick CD boots in a Mac; Community/Distributions/Fedora-SoaS#MacBook Pro i7 CD Boot

The following work on some Intel MacBooks

Persistent USB for Mac:Community/Distributions/Fedora-SoaS#MacBook Persistent SoaS v5 and SoaS v6 EFI Boot USB

dd writable USB.img Community/Distributions/Fedora-SoaS#dd writable 1 GB EFI Boot .28MAC.29 USB Soas-v5-Coconut-USB .img

with GNU/Linux

0. Use this script file http://bit.ly/livecd-iso-to-disk to create a bootable image.
   (Run chmod +x tools_livecd-iso-to-disk.sh after you download the script to make it executable.)
1. Execute, as the root user, in one command with arguments, the following:
   ./tools_livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --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., and
   

   make sure to replace /path/to/source.iso with the path to the downloaded sugar-on-a-stick iso file.
   

   The operating system will occupy ~520 MB, and the overlay and home size arguments, 300 and 175, were selected to fit in a 1 GB device, but may be adjusted according to your device capacity.

   Be certain of your USB/SD scsi drive node name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.).
   

   Use the df -Th command to confirm your devices before executing the script.

[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

$ sudo ./livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 300 --home-size-mb 200 --delete-home --unencrypted-home /mnt/VMs/Fedora-13-x86_64-Live-SoaS.iso /dev/sdb1
Verifying image...
/mnt/VMs/Fedora-13-x86_64-Live-SoaS.iso:   7bb43cb6237802347e06d636b5974796
Fragment sums: 5cb46db2dd7545c7154d99616eaa942ca515fb37188c34cf82564a498b68
Fragment count: 20
Press [Esc] to abort check.
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
300+0 records in
300+0 records out
314572800 bytes (315 MB) copied, 35.3334 s, 8.9 MB/s
Initializing persistent /home
200+0 records in
200+0 records out
209715200 bytes (210 MB) copied, 24.2014 s, 8.7 MB/s
Formatting unencrypted /home
mke2fs 1.41.12 (17-May-2010)
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 33 mounts or
180 days, whichever comes first.  Use tune2fs -c or -i to override.
tune2fs 1.41.12 (17-May-2010)
Setting maximal mount count to -1
Setting interval between checks to 0 seconds
Installing boot loader
USB stick set up as live image!

(See Sugar on a Stick/Linux for more details.)

Note: The graphical Liveusb-creator method may be used (see the first Windows method).

If the USB device does not boot, try the command liveusb-creator --reset-mbr

on an OLPC XO

• See F16 SoaS Pineapple USB boot image for XO-1

Very slow but works

Hard disk and alternate USB stick installations

with a Netinstall CD

• Fedora with the Sugar graphical environment
• Installs to a hard disk or to a 4 GB USB stick (not a LiveOS image like SoaS, but all of Sugar).

This requires a high-speed Internet connection for software component downloading during installation.

with the liveinst command

..from a booted Fedora 16 SoaS Live CD/USB

• 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.

SoaS on VirtualBox

• See VirtualBox

Chat room help

• Sugar chat room in English

• 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.
  Los voluntarios no pueden estar en línea todo el tiempo.
  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.)

• Read the Floss Manuals first

Backup and Restore

Some backup and restore options for Sugar on a Stick include the following:

• Backup and Restore - these are Activities that can be used on any Sugar installation to backup or restore the Sugar Journal.

These activities are also on ASLOxo-5.iso(DVD)

Look at the Contents_of_ASLOxo-5-iso

• olpc:School Server - requires a server installation.
• Sugar on a Stick/deja-dup - a configurable backup tool.
• Sugar on a Stick/Sugar Clone - full image (operating system and home folder) cloning.

Subpage index