Changes

update for lack of embedded livecd-iso-to-disk script.
Line 4: Line 4:  
This page is transcluded to various installation instruction pages.</noinclude>
 
This page is transcluded to various installation instruction pages.</noinclude>
 
<ol start="0">
 
<ol start="0">
<li> '''Download''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br><br></li>
+
<li> '''Download''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br></li>
<li> '''Prepare''': (with [[olpc:Root|'''root''' user]] permissions at a terminal or [[Wikipedia:System_console|console]] command line)
+
{{Note/important|Important change in Fedora 24 SoaS|The ''livecd-iso-to-disk'' installation script is no longer packaged in the SoaS .iso file. 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><li> Create a mount point directory: {{Code|mkdir /run/soas}}</li>
  −
<li> Mount the .iso file to make it accessible as a disk: {{Code|mount '''/path/to/downloaded'''.iso /run/soas/}}
  −
: <small>(Where '''/path/to/downloaded'''.iso is the [[Wikipedia:File system|filesystem]] [[Wikipedia:Path_(computing)|path, or fully specified name,]] of the downloaded .iso file.)
  −
: This is the source for the installation, and must remain [[Wikipedia:Mount_(computing)|mounted]] until the installation is complete.</small>
  −
</li>
   
<li> Insert a USB stick of 2 GB or greater capacity into your computer.</li>
 
<li> Insert a USB stick of 2 GB or greater capacity into your computer.</li>
<li> Use the command {{Code|df -Th}} or {{Code|blkid}} to get the USB device node name.</li>
+
<li> With [[olpc:Root|'''root''' user]] permissions at a terminal or [[Wikipedia:System_console|console]] command line, use the command {{Code|df -Th}} or {{Code|blkid}} to get the USB device node name.</li>
 
{{Show|&nbsp;You should see something like the following:
 
{{Show|&nbsp;You should see something like the following:
 
|<pre>
 
|<pre>
Line 38: Line 33:  
<li> Unmount the USB device filesystem:<br>{{Code|umount /run/media/MyAccount/MyUSBdiscMountPoint}}
 
<li> Unmount the USB device filesystem:<br>{{Code|umount /run/media/MyAccount/MyUSBdiscMountPoint}}
 
: <small>(The {{Code|/run/media/MyAccount/}} path is the new, Fedora 17 standard mount point. Other operating systems may use {{Code|/media/MyMountPoint}}.)</small></li>
 
: <small>(The {{Code|/run/media/MyAccount/}} path is the new, Fedora 17 standard mount point. Other operating systems may use {{Code|/media/MyMountPoint}}.)</small></li>
<li> (You should have the isomd5sum package installed so that the following installation script can verify the download.)<br><br>
+
<li> (You should have the isomd5sum package installed so that the following installation script can verify the download.)<br><br></li>
</li></ul>
+
<li> '''Load''': Execute the following installation command, as the [[olpc:Root|'''root''' user]], in <u>one</u> command line with many options:<br><div style="margin: 1em 0px 1em 1.6em; border: 1px dashed #2F6FAB; padding: 1em; background-color: #FBFBFB; font-family: Courier;">livecd-iso-to-disk --reset-mbr --overlay-size-mb '''500''' --home-size-mb '''800''' --unencrypted-home '''/path/to/downloaded'''.iso /dev/sd'''?'''1</div>
<li> '''Load''': Execute the following installation command, as the [[olpc:Root|'''root''' user]], in <u>one</u> command line with many options:<br><div style="margin: 1em 0px 1em 1.6em; border: 1px dashed #2F6FAB; padding: 1em; background-color: #FBFBFB; font-family: Courier;">/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</div>
   
: The '{{Code|'''?'''}}' in the final parameter represents the target USB device '''''s'''csi '''d'''rive'' node, such as {{Code|sd'''b'''1}} or {{Code|sd'''c'''1}}, etc., and {{Code|'''/path/to/downloaded'''.iso}} is the location and name of the .iso file.
 
: The '{{Code|'''?'''}}' in the final parameter represents the target USB device '''''s'''csi '''d'''rive'' node, such as {{Code|sd'''b'''1}} or {{Code|sd'''c'''1}}, etc., and {{Code|'''/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 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.
Line 100: Line 94:  
<li> '''[[Sugar on a Stick/Boot|Boot]]''': Insert the USB stick into a bootable USB port on your computer. Set the option to "boot from USB" in your computer's <abbr title="Basic Input/Output System">BIOS</abbr> setup, and then start up the computer.<br><br></li></ol>
 
<li> '''[[Sugar on a Stick/Boot|Boot]]''': Insert the USB stick into a bootable USB port on your computer. Set the option to "boot from USB" in your computer's <abbr title="Basic Input/Output System">BIOS</abbr> setup, and then start up the computer.<br><br></li></ol>
   −
::* To create more Sugar Sticks on other 1 GB or greater USB or SD devices, while running ''Sugar on a Stick'', in the [[Activities/Terminal|Terminal Activity]], execute this command as the root user:<br><div style="margin: 1em 0px 1em 0em; border: 1px dashed #2F6FAB; padding: 1em; background-color: #FBFBFB; font-family: Courier;">/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</div>
+
::* To create more Sugar Sticks on other 1 GB or greater USB or SD devices, while running ''Sugar on a Stick'', one must first obtain the ''livecd-tools'' installer as above, then in the [[Activities/Terminal|Terminal Activity]], execute this command as the root user:<br><div style="margin: 1em 0px 1em 0em; border: 1px dashed #2F6FAB; padding: 1em; background-color: #FBFBFB; font-family: Courier;">livecd-iso-to-disk --reset-mbr --overlay-size-mb '''160''' --home-size-mb '''170''' --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd'''?'''1</div>
 
::: <small>Replace {{Code|/dev/sd'''?'''1}} with a new device node for the second USB/SD device that you want to load with ''Sugar on a Stick''.</small>
 
::: <small>Replace {{Code|/dev/sd'''?'''1}} with a new device node for the second USB/SD device that you want to load with ''Sugar on a Stick''.</small>