Sugar on a Stick/Installation

From Sugar Labs
Jump to: navigation, search

Contents

Microsoft WindowsGNU/LinuxOLPC XOVirtualBoxApple Mac OS XBackup and RestoreDownload-circle.png

SoaS installation on USB/SD devices

with Microsoft Windows

Windows.gif There are three ways to do this:

  • 1. Use Fedora Live USB Creator
    (This installation method is not recommended for long-term 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 Notes) 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 screenshot tutorial for this.
See a video of an earlier version of this process.


  • 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 Notes) 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, Activity-terminal.png, from the Home view.
    5. Click the 'Become root' icon, Activity-become-root.svg, to gain administrative permissions in the Terminal session.
    6. Change the working directory to /run/initramfs/live/LiveOS
      (Versions earlier than Fedora 17 would use /mnt/live/LiveOS or /LiveOS.)
    7. Be certain of your USB/SD scsi drive node name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), for example, /dev/sdb1.
      • The df -Th command shows your device filesystem on a device node, for example, /dev/sda1, mounted on a directory mount point, such as /run/media/<AccountName>/<USBdeviceManufacturer>
    1. Unmount the USB device filesystem: umount /run/media/MyAccount/MyUSBdiscMountPoint
    2. Execute the Linux command line:
      ./livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 900 --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd?1
      (Versions earlier than Fedora 17 would use /dev/live or /dev/sr0 instead of /run/initramfs/livedev.)
    3. Shutdown the physical machine.
    4. Reboot from the newly-installed Live USB with Sugar on a Stick.


  • 3. Launch a virtual machine with the Sugar on a Stick .iso file, 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 shows your device filesystem on a device node, for example, /dev/sda1, mounted on a directory mount point, such as /run/media/<AccountName>/<USBdeviceManufacturer>
    1. Continue from step #4 in the Burn a CD-ROM disc section above.
    2. Shutdown the virtual machine.
    3. Reboot your physical computer from the newly-installed Live USB with Sugar on a Stick.

Notes

A Secure Digital (SD) card may not be marked as a bootable device. To check this, use these instructions at a Linux terminal or console:

  • Check the disk partition table for a device, such as /dev/sdc,
sudo fdisk -l /dev/sdc   <----that's a lowercase letter 'L' for the list option.

    The asterisk, * , under the Boot column indicates that the partition is bootable.


with Apple Macintosh

Apple.gif

  • See and adapt the instructions at Macintosh.

Fedora 15 and Fedora 16

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

Gnulinux.png

  1. Download the latest Sugar on a Stick .iso file.

  2. Prepare: (with root user permissions at a terminal or console command line)
    • Create a mount point directory: mkdir /media/soas
    • Mount the .iso file to make it accessible as a disk: mount /path/to/downloaded.iso /media/soas/
      (Where /path/to/downloaded.iso is the filesystem path, or fully specified name, of the downloaded .iso file.)
      This is the source for the installation, and must remain mounted until the installation is complete.
    • Insert a USB stick of 2 GB or greater capacity into your computer.
    • Use the command df -Th or blkid to get the USB device node name.
    • Unmount the USB device filesystem:
      umount /run/media/MyAccount/MyUSBdiscMountPoint
      (The /run/media/MyAccount/ path is the new, Fedora 17 standard mount point. Other operating systems may use /media/MyMountPoint.)
    • (You should have the isomd5sum package installed so that the following installation script can verify the download.)

  3. Load: Execute the following installation command, as the root user, in one command line with many options:
    /media/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 900 --delete-home --unencrypted-home /path/to/downloaded.iso /dev/sd?1
    The '?' in the final parameter represents the target USB device scsi drive node, such as sdb1 or sdc1, etc., and /path/to/downloaded.iso is the location and name of the .iso file.
    The operating system will occupy ~510 MB, and the overlay and home size arguments, 500 and 900, were selected to fit in a 2 GB device. These may be adjusted depending on your preferences and device capacity (see LiveOS image).

  4. Boot: Insert the USB stick into a bootable USB port on your computer. Set the option to "boot from USB" in your computer's BIOS setup, and then start up the computer.

  • To create more Sugar Sticks on other 1 GB or greater USB or SD devices, while running Sugar on a Stick, in the Terminal Activity, execute this command as the root user:
    /run/initramfs/live/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd?1
Replace /dev/sd?1 with a new device node for the second USB/SD device that you want to load with Sugar on a Stick.
(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

OLPCXO.png

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


Chat room help

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


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.


Subpage index

Sugar on a Stick/Installation/OLPCSugar on a Stick/Installation/OLPC/lang-esSugar on a Stick/Installation/OLPC/lang-fr
Sugar on a Stick/Installation/Variations
Sugar on a Stick/Installation/Windows
Retrieved from "http://wiki.sugarlabs.org/index.php?title=Sugar_on_a_Stick/Installation&oldid=81398"
Personal tools
Namespaces

Variants
Actions
Sugar
Projects
Teams
Local Labs
Using the Wiki
Google translations