Changes

Jump to navigation Jump to search
starting with Fedora 24...
Line 1: Line 1: −
<noinclude>{{TOCright}}
+
<noinclude>
 
[[Category:HowTo]]
 
[[Category:HowTo]]
   Line 5: Line 5:  
== Introduction ==
 
== Introduction ==
   −
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|SoaS talk]] page. If you can improve these instructions, please edit the page and do so!</noinclude>
+
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===
+
=== with Microsoft Windows ===
 
[[File:Windows.gif|link=Sugar on a Stick/Windows]]
 
[[File:Windows.gif|link=Sugar on a Stick/Windows]]
* Either use '''Fedora Live USB Creator'''  
+
There are three ways to do this:
*# Download the Live USB Creator from [http://fedorahosted.org/liveusb-creator/#Download FedoraHosted here].  
+
 
*# Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer. (See [[LiveOS image]] and [[Sugar on a Stick/Installation/Variations#Cautions with using Live USB devices|Cautions with using Live USB devices]] regarding flash drive size and usage.)
+
{{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.
 +
{{Note/important|Important change since Fedora 24 SoaS|The ''livecd-iso-to-disk'' installation script is no longer packaged in the SoaS .iso file.  Starting with Fedora 24, if you want a Live USB with persistent storage, you must install the ''livecd-tools'' package to obtain the installation script and the SYSLINUX boot loader. Use this command to obtain the installer:{{Code|sudo dnf install livecd-tools}}}}<ul>
 +
<ol start="6">
 +
<li>''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}}.</li>
 +
<li> 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></li>
 +
 
 +
{{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>}}
 +
<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%
 +
 
 +
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!
 +
</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>
 +
 
 +
 
 +
* '''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.
 
*# Launch Live USB Creator.
*# Select the 'Browse' button to 'Use existing Live CD' and find the downloaded .iso file image on your system.  
+
*# Select Either
*# Adjust the Persistent Storage slider. This enables you to save changes to the system and additional Sugar Activities onto the device.
+
*# 1) the 'Browse' button to 'Use existing Live CD' and find the downloaded .iso file image on your system.  
*# Select your flash drive as the target, and click the '''Create Live USB''' button.
+
*# 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.
 
*# 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.
 
*# 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 [http://www.youtube.com/watch?v=ieIj4aECk88 here].
+
::: See a [[Tutorials/Installation/Create_a_SoaS_v7_Live_USB_in_Windows|screenshot tutorial]] for this.
:'''Note:''' The above installation method does not allow the full [[LiveOS image|optimization]] of data storage that comes from installing a separate, persistent home directory&mdash;see the alternate method just below.
+
::: See a [http://www.youtube.com/watch?v=ieIj4aECk88 video] of an earlier version of this process.
* or '''Burn a CD-ROM disc''' with the SoaS Mirabelle .iso file.
+
 
*# 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 SoaS .iso file onto a blank CD.
+
 
*# Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer. (See [[LiveOS image]] and [[Sugar on a Stick/Installation/Variations#Cautions with using Live USB devices|Cautions with using Live USB devices]] regarding flash drive size and usage.)
+
* '''3. Launch a virtual machine with the Sugar on a Stick .iso file, then run the script, ''livecd-iso-to-disk'''''  
*# 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.
+
*# Download and install [[VirtualBox]] (for example; you could do something similar with another vm).
*# A successful boot will take you into ''Sugar on a Stick Mirabelle''. From there, open the Terminal Activity, [[File:Activity-terminal.png|bottom|link=http://en.flossmanuals.net/terminal]], from the Home view.<br>{{Iframe|[http://en.flossmanuals.net/terminal ''See the Terminal Activity manual.''] |http://en.flossmanuals.net/terminal|945|400|1}}
+
*# Create a new virtual machine.
*# Click the 'Become root' icon, [[File:Activity-become-root.svg|40px|bottom|link=http://en.flossmanuals.net/terminal]], to gain administrative permissions in the Terminal session.
  −
*# Change the working directory to {{Code|/LiveOS/}}<br>{{Code|cd /LiveOS/}}
  −
*# ''Be certain of your USB/SD '''s'''csi '''d'''rive node name (such as sda, sdb, etc.) and partition (such as 1, 2, etc.), yielding, for example,'' {{Code|/dev/sdb1}}.
  −
*#: Use the {{Code|df -Th}} command to confirm your devices before executing the following script.
  −
*# execute the Linux command line:<br>{{Code|./livecd-iso-to-disk --overlay-size-mb 200 --home-size-mb 200 --delete-home --unencrypted-home /dev/live /dev/sd'''?'''1}}
  −
*# Shutdown the physical machine.
  −
*# Reboot from the newly-installed Live USB with Mirabelle.
  −
* or '''Launch a virtual machine''', such as VirtualBox with the SoaS Mirabelle .iso file.
  −
*# Download and install [[VirtualBox]].
  −
*# Create a new virtual machine, choose a name, such as Mirabelle.
   
*# Choose Linux for the Operating System and Version Fedora (64 bit) if available, or Fedora, on systems lacking 64-bit functionality.
 
*# Choose Linux for the Operating System and Version Fedora (64 bit) if available, or Fedora, on systems lacking 64-bit functionality.
*# Choose Base Memory Size: 256 MB to match an XO-1, 512 or 1024 MB to match an XO-1.5.
+
*# Attach the Sugar on a Stick .iso file as a CD in the Storage Section
*# Attach the SoaS-Mirabelle.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.
 
*# 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.
 
*# Start the new virtual machine.
 
*# Verify that the USB device is recognized in the running 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.
 
*#* Your device appears in the hover box for the USB stick icon in the virtual machine bottom frame.
*#* {{Code|df -Th}} reveals your device mounted mounted on a device node, for example, /dev/sda1, on a filesystem volume [[wikipedia:Mount (Computing)|mount point]], such as /media/<USBdeviceManufacturer><br>
+
*#* {{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>
{{Show|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;You should see something like the following:
+
<ul><ul><ul>
 +
{{Show|You should see something like the following:
 
|<pre>
 
|<pre>
[root@localhost ~]# df -Th
+
[root@localhost LiveOS]# df -Th
Filesystem   Type   Size  Used Avail Use% Mounted on
+
Filesystem         Type     Size  Used Avail Use% Mounted on
/dev/mapper/live-rw
+
rootfs              rootfs   4.0G 2.5G 1.5G  63% /
              ext4   4.0G  1.5G  2.5G 37% /
+
devtmpfs            devtmpfs  1.6G    0 1.6G  0% /dev
tmpfs       tmpfs   250M 236K  249M   1% /dev/shm
+
tmpfs               tmpfs     1.6G  84K 1.6G   1% /dev/shm
/dev/sr0  iso9660    477M 477M     0 100% /mnt/live
+
tmpfs              tmpfs    1.6G  1.2M  1.6G  1% /run
varcacheyum tmpfs   250M     0  250M   0% /var/cache/yum
+
/dev/sr0           iso9660   509M 509M     0 100% /run/initramfs/live
/tmp         tmpfs   250M   20K 249M   1% /tmp
+
/dev/mapper/live-rw ext4      4.0G  2.5G  1.5G  63% /
vartmp       tmpfs   250M     0  250M   0% /var/tmp
+
tmpfs              tmpfs    1.6G    0  1.6G  0% /sys/fs/cgroup
/dev/sda1     vfat     15G 2.4G  13G 17% /media/TOSHIBA
+
tmpfs              tmpfs    1.6G    0  1.6G  0% /media
</pre>}}
+
varcacheyum         tmpfs     1.6G     0  1.6G   0% /var/cache/yum
<ul>
+
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">
 
<ol start="9">
 
<li> Continue from step #4 in the '''Burn a CD-ROM disc''' section above.</li>
 
<li> Continue from step #4 in the '''Burn a CD-ROM disc''' section above.</li>
 
<li> Shutdown the virtual machine.</li>
 
<li> Shutdown the virtual machine.</li>
<li> Reboot your physical computer from the newly-installed Live USB with Mirabelle.</li>
+
<li> Reboot your physical computer from the newly-installed Live USB with Sugar on a Stick.</li>
 
</ol>
 
</ol>
 
</ul>
 
</ul>
 +
 +
===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:
 +
{{:Sugar on a Stick/Linux/bootable device}}

Navigation menu