Changes

livecd-tools now onboard
Line 1: Line 1: −
{{TOCright}}
+
<noinclude>
 +
[[Category:HowTo]]
 +
 
    
== Introduction ==
 
== Introduction ==
   −
This page is designed to help you to put your [[Sugar on a Stick]] image under Windows on a thumbdrive. If you have questions, trouble or feedback, please let us know on the [[Talk:Sugar on a Stick|SoaS talk]] page. If you can improve these instructions, please edit the page and do so!
+
This page is designed to help you to put your [[Sugar on a Stick]] image on a thumbdrive using Microsoft Windows. If you have questions, trouble or feedback, please let us know on the [[Talk:Sugar on a Stick|Sugar on a Stick talk]] page. If you can improve these instructions, please edit the page and do so!</noinclude>
 
+
=== with Microsoft Windows ===
== Windows Instructions ==
+
[[File:Windows.gif|link=Sugar on a Stick/Windows]]
 +
There are three ways to do this:
   −
The recommended process for creating a SoaS stick in Windows is to use the [http://fedorahosted.org/liveusb-creator/ Fedora LiveUSB Creator], a cross-platform tool for easily installing live operating systems on to USB flash drives.
+
{{Anchor|Burn a CD-ROM}}
 +
* '''1. Burn a CD-ROM disc, boot from it, then run the script, ''livecd-iso-to-disk'''''
 +
*# 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 Sugar on a Stick .iso file onto a blank CD.
 +
*# Insert a USB flash drive (or SD Card<sup> [[#Notes|Notes]]</sup>) with 2 GB or more of free space into your computer.
 +
*# [[Sugar on a Stick/Boot|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.
 +
*# A successful boot will take you into ''Sugar on a Stick''.  You can From there, open the Terminal Activity, [[File:Activity-terminal.png|bottom|link=http://en.flossmanuals.net/terminal]], from the <span class=plainlinks>[http://wiki.sugarlabs.org/images/9/9b/Home_ListView_button.png Home list View]</span>.
 +
*# Switch to run commands with 'root' user permissions by entering {{Code|su -}} on the command line.
 +
*# Change the working directory, by entering {{Code|cd /run/initramfs/live/LiveOS}}
 +
*# ''Verify the USB/SD '''s'''csi '''d'''rive node name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.) for your USB/SD device.''  It would look like, for example, {{Code|/dev/sd'''b'''1}}.
 +
*#* The {{Code|df -Th}} command shows your device filesystem on a device node, for example, /dev/sdb1, mounted on a directory [[wikipedia:Mount (computing)|mount point]], such as /run/media/liveuser/<USBdeviceManufacturer>
 +
<ul><ul><ul><ul>
 +
{{Show|You should see something like the following:
 +
|<pre>
 +
[root@localhost ~]# df -Th
 +
Filesystem          Type      Size  Used Avail Use% Mounted on
 +
/dev/mapper/live-rw ext4      2.9G  2.1G  773M  74% /
 +
devtmpfs            devtmpfs  2.0G    0  2.0G  0% /dev
 +
tmpfs              tmpfs    2.0G  72K  2.0G  1% /dev/shm
 +
tmpfs              tmpfs    2.0G  632K  2.0G  1% /run
 +
tmpfs              tmpfs    2.0G    0  2.0G  0% /sys/fs/cgroup
 +
/dev/sr0            iso9660  670M  670M    0 100% /run/initramfs/live
 +
tmpfs              tmpfs    2.0G  32K  2.0G  1% /tmp
 +
varcacheyum        tmpfs    2.0G    0  2.0G  0% /var/cache/yum
 +
vartmp              tmpfs    2.0G    0  2.0G  0% /var/tmp
 +
/dev/sdb1          vfat      3.8G  4.0K  3.8G  1% /run/media/liveuser/SanDisk
 +
</pre>}}</ul></ul></ul>
 +
<ol start="8">
 +
<li> Unmount the USB device filesystem with this command: {{Code|umount /run/media/liveuser/'''MyUSBdiscMountPoint'''}}, where {{Code|'''MyUSBdiscMountPoint'''}} is {{Code|SanDisk}} in the dropdown example, above.</li>
 +
<li> Execute this command line: &nbsp;(Substitute the {{Code|/dev/sd'''?'''1}}, below, with the node name you determined in step 7, above.)<br><div style="padding: 1em; border: 1px dashed #2F6FAB; background-color: #FBFBFB; margin: 1em 0px 1em 0em; font-family: monospace,Consolas; overflow: auto;">./livecd-iso-to-disk --reset-mbr --overlay-size-mb '''500''' --home-size-mb '''800''' --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd'''?'''1</div>
 +
</li>
 +
(The '''500''' and '''800''' size values, above, are suitable for a 2 GB USB device. For a 4 GB device, one might use '''1000''' and '''1600''' megabytes instead.)
 +
{{Show|The installation transcript should look like the following:
 +
|<pre>
 +
[root@localhost LiveOS]# livecd-iso-to-disk --overlay-size-mb 500 --home-size-mb 800 --unencrypted-home /run/initramfs/livedev /dev/sdb1
 +
Verifying image...
 +
/dev/sr0:  b0a9414ff7eb79b680d5c86440e19587
 +
Fragment sums: 9bfe23577651c88dcfb78c76ac3a28a5c53eead4561e3bdc5921b8b2e748
 +
Fragment count: 20
 +
Press [Esc] to abort check.
 +
Checking: 100.0%
   −
# Download and then extract the [https://fedorahosted.org/liveusb-creator/ Windows executable] for Fedora LiveUSB Creator. This creates a folder named liveusb-creator-''version''.
+
The media check is complete, the result is: PASS.
# Download Sugar on a Stick http://download.sugarlabs.org/soas/releases/soas-strawberry.iso
  −
# Insert your stick into a USB port.
  −
# In File Manager's Properties dialog for your USB device, rename it to FEDORA.
  −
# Navigate to the LiveUSB folder you extracted and double-click on the <tt>liveusb-creator.exe</tt> file to open the program.
  −
# Browse to find the soas-strawberry.iso file that you downloaded in step 2.
  −
# Set the Target Device to your USB device FEDORA.
  −
# Move the slider to set some persistent storage. (''Hint:'' Set it to maximum, then it will tell you how much space there is, and you can adjust it to your desired value. How much persistent storage space you set will depend on the size of the .iso and the storage capacity of your USB device.  Persistent storage is needed to save your work in the Journal or to save changes to the system.)  You may leave some of your device capacity unallocated if you want to use that space when not booting Sugar.
  −
#:'''Note:''' persistent storage will save Journal items between reboots&mdash;but not between Sugar system updates with the LiveUSB Creator (in its current version).  Watch this page for instructions on making your Journal persist between system updates.  (The Linux livecd-iso-to-disk script does provide this feature with the --home-size-mb option.)
  −
# Click "Create Live USB". It will take a few minutes.
  −
# When finished, '''be sure''' to properly eject the USB device using the Safely Remove Hardware icon in the system tray. Failure to do this can render your stick unbootable.
     −
== What's next? ==
+
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
   −
Please return to the [[Sugar_on_a_Stick#Step_3:_Boot|Sugar on a Stick]] page for instructions how to boot from your USB key!
+
Allocating group tables: done                           
 +
Writing inode tables: done                           
 +
Creating journal (4096 blocks): done
 +
Writing superblocks and filesystem accounting information: done
   −
CAUTION: Circular Reference: The above page refers you back to this page!
+
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!
 +
</pre>}}
 +
<li> Shutdown the physical machine.</li>
 +
<li> [[Sugar on a Stick/Boot|Reboot your computer]] from the newly-installed Live USB with Sugar on a Stick.</li>
 +
</ol>
   −
== See Also ==
  −
[[#UNetbootin instructions|Unetbootin]] for an alternate method for Windows users.
     −
== Caroline's Repeatable Process for Creating Sticks ==
+
* '''2. Use Fedora Live USB Creator'''
 +
*: (This installation method is NOT recommended for LONG-TERM usage of Sugar on a Stick!!  Catastrophic data corruption may occur when the USB stick gets full!  [[fedora:LiveOS_image#Home_filesystem|See why.]])
 +
*# Download the Live USB Creator from [http://fedorahosted.org/liveusb-creator/ Fedora].
 +
*# Insert a USB flash drive (or SD Card<sup> [[#Notes|Notes]]</sup>) with 2 GB or more of free space into your computer.
 +
*# Launch Live USB Creator.
 +
*# Select Either
 +
*# 1) the 'Browse' button to 'Use existing Live CD' and find the downloaded .iso file image on your system.
 +
*# 2) Download Fedora and select  Fedora-SoaS-{i386|x86_64}-{22|23}  (This automates the download and checksum routine and directly  burns to the USB/ SDCard
 +
*# Adjust the Persistent Storage slider. This enables you to save changes to the system and additional Sugar Activities onto the device. (aka persistence file or Overlay --this space  by default is write once  only)  --see below for  additional way to make /home a  rw overlay
 +
*# Select your flash drive as the target, and click the '''Create Live USB''' button.
 +
*# With the latest version of Fedora LiveUSB Creator you have TWO (2) option for burning method
 +
*# 1) CP (non destructive) -- meaning you can still use the unused space on a larger (8-16-32-64Gb) usb for whatever post burn.
 +
*# 2) DD ( the old school way) Note:  THIS WILL destroy any previous data make sure you properly  select the drive to use AND make backups of any pre-existing important data (you will not be easily able to retrieve overwritten data)
 +
*# Wait for the process to finish, then close the Live USB Creator program.
 +
*# Stop your flash drive with the '''Safely Remove Hardware and Eject Media''' notification area icon dialog, and eject it.
 +
::: See a [[Tutorials/Installation/Create_a_SoaS_v7_Live_USB_in_Windows|screenshot tutorial]] for this.
 +
::: See a [http://www.youtube.com/watch?v=ieIj4aECk88 video] of an earlier version of this process.
   −
This is the process I (Caroline Meeks) use.  Some of the things I do maybe superstition, but here is it.
     −
=== Preparation: ===
+
* '''3. Launch a virtual machine with the Sugar on a Stick .iso file, then run the script, ''livecd-iso-to-disk'''''
 +
*# Download and install [[VirtualBox]] (for example; you could do something similar with another vm).
 +
*# Create a new virtual machine.
 +
*# Choose Linux for the Operating System and Version Fedora (64 bit) if available, or Fedora, on systems lacking 64-bit functionality.
 +
*# Attach the Sugar on a Stick .iso file as a CD in the Storage Section
 +
*# 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.
 +
*# Start the new virtual machine.
 +
*# 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.
 +
*#* {{Code|df -Th}} shows your device filesystem on a device node, for example, /dev/sda1, mounted on a directory [[wikipedia:Mount (computing)|mount point]], such as /run/media/<AccountName>/<USBdeviceManufacturer>
 +
<ul><ul><ul>
 +
{{Show|You should see something like the following:
 +
|<pre>
 +
[root@localhost LiveOS]# df -Th
 +
Filesystem          Type      Size  Used Avail Use% Mounted on
 +
rootfs              rootfs    4.0G  2.5G  1.5G  63% /
 +
devtmpfs            devtmpfs  1.6G    0  1.6G  0% /dev
 +
tmpfs              tmpfs    1.6G  84K  1.6G  1% /dev/shm
 +
tmpfs              tmpfs    1.6G  1.2M  1.6G  1% /run
 +
/dev/sr0            iso9660  509M  509M    0 100% /run/initramfs/live
 +
/dev/mapper/live-rw ext4      4.0G  2.5G  1.5G  63% /
 +
tmpfs              tmpfs    1.6G    0  1.6G  0% /sys/fs/cgroup
 +
tmpfs              tmpfs    1.6G    0  1.6G  0% /media
 +
varcacheyum        tmpfs    1.6G    0  1.6G  0% /var/cache/yum
 +
tmp                tmpfs    1.6G  40K  1.6G  1% /tmp
 +
vartmp              tmpfs    1.6G    0  1.6G  0% /var/tmp
 +
/dev/sda1          vfat      3.7G  2.1G  1.7G  56% /run/media/liveuser/TOSHIBA
 +
</pre>}}</ul></ul>
 +
<ol start="9">
 +
<li> Continue from step #4 in the '''Burn a CD-ROM disc''' section above.</li>
 +
<li> Shutdown the virtual machine.</li>
 +
<li> Reboot your physical computer from the newly-installed Live USB with Sugar on a Stick.</li>
 +
</ol>
 +
</ul>
   −
# Download and install version 3.6.5 live usb creator for XP
+
===Notes===
# Download the iso snapshot you want to create - You only have to download it once.
+
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:
+
{{:Sugar on a Stick/Linux/bootable device}}
=== For Each Stick ===
  −
 
  −
# Insert a 1 or 2 GB Stick
  −
# Delete files so that you have 700 MiB or more of space available.
  −
#: (This step is not needed, but may help if other methods don't work) Format it using FAT. If it has anything on it it will be completely erased so you can reuse sticks.
  −
#: See [[olpc:How to Damage a FLASH Storage Device]] before formatting. The 'Stick' probably came with a FAT file system that the Fedora LiveUSB Creator will use.  You can even leave some of your files on the drive.  You may want to try using the native drive formatting to see if it works before reformatting the drive.
  −
# Name the volume FEDORA (The File Manager's properties, General tab panel will let you rename a volume.)
  −
# Open the live USB creator
  −
# Click Browse and find your snapshot
  −
# Move the slider for persistent storage but don't use absolutely everything on the stick. These days I use about 500 MB for a 1 GB Stick
  −
# Burn the stick. It takes about 15 minutes or so for me
  −
# Close the live USB creator
  −
# Eject the stick
  −
# Create a boot-helper CD that matches your snapshot (I use my mac for that, but I've never heard of problems so any way of creating a LiveCD should work)
  −
 
  −
 
  −
[[Category:HowTo]]