Sugar on a Stick/Linux/Installation

These are the steps for installing Sugar on a Stick on a USB/SD device.

This page is transcluded to various installation instruction pages.

0. Download the latest Sugar on a Stick .iso file.
   
   
1. Prepare: (with root user permissions at a terminal or console command line)
   • Create a mount point directory: mkdir /run/soas
   • Mount the .iso file to make it accessible as a disk: mount /path/to/downloaded.iso /run/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.
    You should see something like the following:

   [root@MyComputer ~]# df -Th
   Filesystem     Type      Size  Used Avail Use% Mounted on
   rootfs         rootfs     20G  5.5G   14G  29% /
   devtmpfs       devtmpfs  1.6G     0  1.6G   0% /dev
   tmpfs          tmpfs     1.6G  788K  1.6G   1% /dev/shm
   tmpfs          tmpfs     1.6G  1.3M  1.6G   1% /run
   tmpfs          tmpfs     1.6G     0  1.6G   0% /sys/fs/cgroup
   tmpfs          tmpfs     1.6G     0  1.6G   0% /media
   /dev/loop0     iso9660   668M  668M     0 100% /run/soas
   /dev/sdc1      vfat      2.0G  2.0G   53M  98% /run/media/MyAccount/LG
   /

   (The /run/media/MyAccount/ path is the new, Fedora 17 standard mount point for removable media.
   /media/MyMountPoint is common on other operating systems.)

   [root@MyComputer ~]# blkid
   /dev/sda1: LABEL="Fedora-20" UUID="8962913a-c335-4c3b-b3ed-90fbb9c97580" TYPE="ext4" PARTUUID="1549f232-01" 
   /dev/sdc1: LABEL="LIVE" UUID="D2AC-5056" TYPE="vfat"  PARTUUID="000056b3-01" 
   /dev/loop0: UUID="2013-12-12-01-40-45-00" LABEL="Fedora-Live-SoaS-x86_64-20-1" TYPE="iso9660" PTUUID="461863db" PTTYPE="dos" 
   

   (Additional disk drive partitions may be listed on your computer.)

   The mount point (Mounted on), Filesystem, Size, and LABEL should help you identify what you want.

   • 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.)
     
     
2. Load: Execute the following installation command, as the root user, in one command line with many options:
   
   /run/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 800 --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 ~670 MB, and the overlay and home size arguments, 500 and 800, were selected to fit in a 2 GB device. These may be adjusted depending on your preferences and device capacity (see LiveOS image). SoaS 10 can be squeezed into a 1 GB device with 160 and 170. On a 4 GB device, one might use 1000 and 1600 for the size arguments.

    The installation transcript should look something like the following:

   [root@MyComputer ~]# /run/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 800 --unencrypted-home /home/MyAccount/Downloads/Fedora-Live-SoaS-x86_64-20-1.iso /dev/sdc1
   Verifying image...
   /home/MyAccount/Downloads/Fedora-Live-SoaS-x86_64-20-1.iso:   b0a9414ff7eb79b680d5c86440e19587
   Fragment sums: 9bfe23577651c88dcfb78c76ac3a28a5c53eead4561e3bdc5921b8b2e748
   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 target device.
   squashfs.img
       630,784,000 100%    1.96MB/s    0:05:06 (xfr#1, to-chk=0/1)
   osmin.img
             8,192 100%    0.00kB/s    0:00:00 (xfr#1, to-chk=0/1)
   Updating boot config file
   Initializing persistent overlay file
   500+0 records in
   500+0 records out
   524288000 bytes (524 MB) copied, 216.717 s, 2.4 MB/s
   Initializing persistent /home
   800+0 records in
   800+0 records out
   838860800 bytes (839 MB) copied, 344.643 s, 2.4 MB/s
   Formatting unencrypted /home
   mke2fs 1.42.8 (20-Jun-2013)
   Filesystem label=
   OS type: Linux
   Block size=4096 (log=2)
   Fragment size=4096 (log=2)
   Stride=0 blocks, Stripe width=0 blocks
   51296 inodes, 204800 blocks
   10240 blocks (5.00%) reserved for the super user
   First data block=0
   Maximum filesystem blocks=209715200
   7 block groups
   32768 blocks per group, 32768 fragments per group
   7328 inodes per group
   Superblock backups stored on blocks: 
   	32768, 98304, 163840
   
   Allocating group tables: done                            
   Writing inode tables: done                            
   Creating journal (4096 blocks): done
   Writing superblocks and filesystem accounting information: done
   
   tune2fs 1.42.8 (20-Jun-2013)
   Setting maximal mount count to -1
   Setting interval between checks to 0 seconds
   Installing boot loader
   Target device is now set up with a Live image!
   

   
   
3. 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 160 --home-size-mb 170 --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.