Changes

update to SoaS 29 details
Line 5: Line 5:  
<ol start="0">
 
<ol start="0">
 
<li> '''Download''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br></li>
 
<li> '''Download''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br></li>
{{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}}}}
+
<li> 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}}
 
<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> 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>
+
<li> With [[olpc:Root|'''root''' user]] permissions at a terminal or [[Wikipedia:System_console|console]] command line, use the command {{Code|sudo df -Th}} or {{Code|sudo blkid}} to get the USB device node name.</li>
 +
:<small>(Items in angle brackets, such as <MyAccount> are descriptive placeholders.)</small>
 
{{Show|&nbsp;You should see something like the following:
 
{{Show|&nbsp;You should see something like the following:
 
|<pre>
 
|<pre>
[root@MyComputer ~]# df -Th
+
[<user>@<system> <working directory>]$ sudo df -Th
 
Filesystem    Type      Size  Used Avail Use% Mounted on
 
Filesystem    Type      Size  Used Avail Use% Mounted on
 
rootfs        rootfs    20G  5.5G  14G  29% /
 
rootfs        rootfs    20G  5.5G  14G  29% /
Line 18: Line 19:  
tmpfs          tmpfs    1.6G    0  1.6G  0% /sys/fs/cgroup
 
tmpfs          tmpfs    1.6G    0  1.6G  0% /sys/fs/cgroup
 
tmpfs          tmpfs    1.6G    0  1.6G  0% /media
 
tmpfs          tmpfs    1.6G    0  1.6G  0% /media
/dev/loop0    iso9660  668M 668M     0 100% /run/soas
+
/dev/loop0    iso9660  959M 959M     0 100% /run/soas
/dev/sdc1      vfat      2.0G  2.0G  53M  98% /run/media/MyAccount/LG
+
/dev/sdc1      vfat      2.0G  2.0G  53M  98% /run/media/<MyAccount>/<filesystem label>/
/</pre>
+
</pre>
: <small>(The {{Code|/run/media/MyAccount/}} path is the new, Fedora 17 standard mount point for removable media.<br>{{Code|/media/MyMountPoint}} is common on other operating systems.)</small>
+
: <small>(The {{Code|/run/media/<MyAccount>/}} path is the standard mount point for removable media.<br>{{Code|/media/<MyMountPoint>}} is common on other operating systems.)</small>
 
   
<pre>
 
<pre>
[root@MyComputer ~]# blkid
+
[<user>@<system> <working directory>]$ sudo blkid
/dev/sda1: LABEL="Fedora-20" UUID="8962913a-c335-4c3b-b3ed-90fbb9c97580" TYPE="ext4" PARTUUID="1549f232-01"  
+
/dev/sda1: LABEL="Fedora29" UUID="45e12f4a-51f2-463e-a33b-a6c0f157ab77" TYPE="ext4" PARTUUID="000b2340-04"  
 
/dev/sdc1: LABEL="LIVE" UUID="D2AC-5056" TYPE="vfat"  PARTUUID="000056b3-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"  
+
/dev/loop0: UUID="2018-10-25-00-02-47-00" LABEL="Fedora-SoaS-Live-29-1-2" TYPE="iso9660" PTUUID="3299e5ae" PTTYPE="dos"  
 
</pre>
 
</pre>
 
:: <small>(Additional disk drive partitions may be listed on your computer.)</small>
 
:: <small>(Additional disk drive partitions may be listed on your computer.)</small>
 
: The mount point (Mounted on), Filesystem, Size, and LABEL should help you identify what you want.}}
 
: The mount point (Mounted on), Filesystem, Size, and LABEL should help you identify what you want.}}
<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 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>
 
<li> (You should have the isomd5sum package installed so that the following installation script can verify the download.)<br><br></li>
<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;">livecd-iso-to-disk --reset-mbr --overlay-size-mb '''500''' --home-size-mb '''500''' --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 ~960 MB, and the overlay and home size arguments, '''500''' and '''500''', were selected to fit in a 2 GB device. These may be adjusted depending on your preferences and device capacity (see [[LiveOS image]]). On a 4 GB device, one might use '''1000''' and '''1600''' for the size arguments.
 
{{Show|&nbsp;The installation transcript should look something like the following:  
 
{{Show|&nbsp;The installation transcript should look something like the following:  
 
|<pre>
 
|<pre>
[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
+
[<user>@<system> <working directory>]$ sudo livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 500 --unencrypted-home /<path to>/Fedora-SoaS-Live-x86_64-29-1.2.iso /dev/sdc1
 
Verifying image...
 
Verifying image...
/home/MyAccount/Downloads/Fedora-Live-SoaS-x86_64-20-1.iso:  b0a9414ff7eb79b680d5c86440e19587
+
/<path to>/Fedora-SoaS-Live-x86_64-29-1.2.iso:  7641738bb0493f4a521af3a694e4f4ae
Fragment sums: 9bfe23577651c88dcfb78c76ac3a28a5c53eead4561e3bdc5921b8b2e748
+
Fragment sums: 7c5f6e26254ca7438da4d5b28a72a9f38711e3bb34b2748e177533ef5c25
 
Fragment count: 20
 
Fragment count: 20
 +
Supported ISO: no
 
Press [Esc] to abort check.
 
Press [Esc] to abort check.
 
Checking: 100.0%
 
Checking: 100.0%
Line 50: Line 51:     
It is OK to use this media.
 
It is OK to use this media.
Copying live image to target device.
+
 
 +
Copying LiveOS image to target device...
 
squashfs.img
 
squashfs.img
     630,784,000 100%   1.96MB/s    0:05:06 (xfr#1, to-chk=0/1)
+
     905,187,328 100% 374.66MB/s    0:00:02 (xfr#1, to-chk=0/1)
osmin.img
+
 
          8,192 100%    0.00kB/s    0:00:00 (xfr#1, to-chk=0/1)
+
Syncing filesystem writes to disc.
Updating boot config file
+
    Please wait, this may take a while...
Initializing persistent overlay file
+
Setting up /EFI/BOOT
 +
Updating boot config files.
 +
Initializing persistent overlay...
 
500+0 records in
 
500+0 records in
 
500+0 records out
 
500+0 records out
524288000 bytes (524 MB) copied, 216.717 s, 2.4 MB/s
+
524288000 bytes (524 MB, 500 MiB) copied, 0.448825 s, 1.2 GB/s
 
Initializing persistent /home
 
Initializing persistent /home
800+0 records in
+
500+0 records in
800+0 records out
+
500+0 records out
838860800 bytes (839 MB) copied, 344.643 s, 2.4 MB/s
+
524288000 bytes (524 MB, 500 MiB) copied, 0.415686 s, 1.3 GB/s
Formatting unencrypted /home
+
Formatting unencrypted home.img
mke2fs 1.42.8 (20-Jun-2013)
+
mke2fs 1.44.3 (10-July-2018)
Filesystem label=
+
Creating filesystem with 512000 1k blocks and 128016 inodes
OS type: Linux
+
Filesystem UUID: 8fc0d8be-5c67-46a8-b621-6bd62bad3267
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:  
 
Superblock backups stored on blocks:  
32768, 98304, 163840
+
8193, 24577, 40961, 57345, 73729, 204801, 221185, 401409
    
Allocating group tables: done                             
 
Allocating group tables: done                             
 
Writing inode tables: done                             
 
Writing inode tables: done                             
Creating journal (4096 blocks): done
+
Creating journal (8192 blocks): done
Writing superblocks and filesystem accounting information: done
+
Writing superblocks and filesystem accounting information: done  
   −
tune2fs 1.42.8 (20-Jun-2013)
+
tune2fs 1.44.3 (10-July-2018)
 
Setting maximal mount count to -1
 
Setting maximal mount count to -1
 
Setting interval between checks to 0 seconds
 
Setting interval between checks to 0 seconds
Installing boot loader
+
Installing boot loader...
 
Target device is now set up with a Live image!
 
Target device is now set up with a Live image!
 
</pre>}}<br></li>
 
</pre>}}<br></li>
 
<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'', 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>
+
::* To create more Sugar Sticks on other 2 GB or greater USB or SD devices, while running ''Sugar on a Stick'', one may run the [[Activities/Terminal|Terminal Activity]], and 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 '''500''' --home-size-mb '''500''' --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>