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

         You should see something like the following:

[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

where the mount point and filesystem sizes should help you identify what you want.

$ 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 is an alternative installation method (see the first 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 liveusb-creator --reset-mbr may help.

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 instructions from the VirtualBox page (transcluded here):

VirtualBox

With VirtualBox^® one can run Sugar on Microsoft Windows, Intel-based Apple Macintosh, or Linux host computers from within a virtual machine window.

See this VirtualBox overview.

VirtualBox is a large software installation with many features and operating system options. It may take some time for a new user to take advantage of it.

Virtualbox 4.0 Downloads: http://www.oracle.com/technetwork/server-storage/virtualbox/downloads/index.html

(See VirtualBox/Technical for some collected details, and the VirtualBox.org Web site.)

See VirtualBox/Preparing a disk image for instructions on building a VirtualBox virtual machine disk from an .iso disk image.

Problems using MacBook Pro i7 (sandyBridge) with some OS Guests http://www.virtualbox.org/ticket/8474

The following instructions are intended for those Learners interested in using VirtualBox to run Sugar. The process is not fully mature as the technology is evolving both in the VirtualBox and operating system software.

Online IRC support is available from http://www.virtualbox.org/wiki/IRC

Various VirtualBox experiments may be found on the discussion page.

Sugar disc images

Sugar on a Stick

Below are instructions for running a copy of Sugar on a Stick, available from this Fedora download site, in a VirtualBox window.

Note:
Prebuilt virtual machines that may be run in VirtualBox are available here: Emulator image files#VirtualBox.

Install VirtualBox

on Mac OS X

 - the Apple Macintosh operating system

Please help:
Assistance is needed from Macintosh system experts to sort out the peculiarities involved with the operating system and VirtualBox.

1. Download VirtualBox for OS X from here, http://www.virtualbox.org/wiki/Downloads
2. Install it by opening the .dmg.
3. Follow the instructions in the window
   1. Double click VirtualBox.mpkg
   2. If you see a warning about running a program from the Internet, click OK to run it.
   3. Click continue until you see the license popup, click Agree.
   4. Choose location to install, probably something like Macintosh HD, then click Continue.
   5. Click Continue, then Install. Enter password, if required.
4. Now you can run VirtualBox by opening the Applications folder and double clicking on the icon.
5. Next Follow the instructions Setup a Virtual Machine for Sugar on a Stick

   You can watch a screencast video of the rest of the process on a Mac below in the Setup section (click the [show] link.)

on Microsoft Windows

Download from http://www.virtualbox.org/wiki/Downloads.

on GNU/Linux

See http://www.virtualbox.org/wiki/Linux_Downloads

For Ubuntu, it is available in Synaptic Package Manager, once you add the the URI, distribution & components to your 3rd-party software sources or enter the following in your /etc/apt/sources.list.

deb http://download.virtualbox.org/virtualbox/debian <distribution> non-free

Install dkms, as well, so upgrades to your system will update the kernel modules.

(See the Talk:VirtualBox page for experimental installation variations.)

Setup a Virtual Machine for Sugar on a Stick

Notice: Prebuilt VirtualBox 4.1 Appliances are available. Just click "import" on one of the .vmdk or .ovf files.

One may also use these instructions, VirtualBox/Preparing a disk image, to prepare one's own.

You can watch a screencast video of the process with an earlier version of SoaS on a Mac here:

1. In VirtualBox click New
2. Click Next
3. Enter a name "Sugar"
4. Operating System: choose Linux
5. Version: choose Fedora
6. Click Next
7. For memory leave 256 MB
8. Click Next
9. Virtual Hard Disk click Existing
10. Click the little folder to the right of the selection box
    1. A new window pops up
    2. Click Add button in the toolbar
    3. Browse to the location where you extracted the .vdi disk image
    4. Click Open
    5. Click Select
11. Click Next
12. Click Finish
13. Select Sugar on the left
14. Click Start in the toolbar
15. After a minute or two you should see the Sugar screen asking for you name
16. Enter your name
17. Click Done at the bottom of the window. You might have to scroll.
18. From now on you can start VirtualBox and start the "Sugar" virtual machine

Issues

• Activating the Frame might be a little difficult. The lower 2 corners are easiest and you may want to configure edge activation in the My Settings > Frame panel. With VirtualBox Guest Additions installed (see here), only the bottom edge and corners are available for Frame activation.

• On Mac keyboards, you might wish to change the Virtual Box default key for switching the Sugar cursor to the normal one, as the default key (control right arrow on Mac keyboards) is trapped by Sugar. (Windows and Linux keyboards use Right Ctrl.) You may do this change in File/settings of the Virtual Box menu.

Resources

• http://www.virtualbox.org/
• OLPC:VirtualBox
• How To Install Virtualbox Guest Additions in Fedora Guest (Based on Fedora 8)
• install the virtualbox guest additions

2nd Method

sudo apt-get install virtualbox-ose-guest-utils

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

Sugar on a Stick/Installation/OLPC	Sugar on a Stick/Installation/OLPC/lang-es	Sugar on a Stick/Installation/OLPC/lang-fr
Sugar on a Stick/Installation/Variations	Sugar on a Stick/Installation/Windows