Jump to content

Sugar on a Stick/Linux/Installation: Difference between revisions

From Sugar Labs
mNo edit summary
update sizes for SoaS 10
Line 6: Line 6:
<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><br></li>
<li> '''Prepare''': (with [[olpc:Root|'''root''' user]] permissions at a terminal or [[Wikipedia:System_console|console]] command line)
<li> '''Prepare''': (with [[olpc:Root|'''root''' user]] permissions at a terminal or [[Wikipedia:System_console|console]] command line)
<ul><li> Create a mount point directory: {{Code|mkdir /media/soas}}</li>
<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 /media/soas/}}
<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.)
: <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>
: This is the source for the installation, and must remain [[Wikipedia:Mount_(computing)|mounted]] until the installation is complete.</small>
Line 23: Line 23:
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  509M 509M     0 100% /media/soas
/dev/loop0    iso9660  668M 668M     0 100% /run/soas
/dev/sdc1      vfat      995M 983M   13M 99% /run/media/MyAccount/LG
/dev/sdc1      vfat      2.0G 2.0G   53M 98% /run/media/MyAccount/LG
</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 new, Fedora 17 standard mount point for removable media.<br>{{Code|/media/MyMountPoint}} is common on other operating systems.)</small>


<pre>
<pre>
[root@MyComputer ~]# blkid
[root@MyComputer ~]# blkid
/dev/sda1: LABEL="Fedora-17" UUID="8962913a-c335-4c3b-b3ed-90fbb9c97580" TYPE="ext4"  
/dev/sda1: LABEL="Fedora-20" UUID="8962913a-c335-4c3b-b3ed-90fbb9c97580" TYPE="ext4" PARTUUID="1549f232-01"  
/dev/sdc1: LABEL="LIVE" UUID="A7B2-6C07" TYPE="vfat"  
/dev/sdc1: LABEL="LIVE" UUID="D2AC-5056" TYPE="vfat"  PARTUUID="000056b3-01"  
/dev/loop0: LABEL="Fedora-17-x86_64-Live-SoaS.iso" TYPE="iso9660"  
/dev/loop0: UUID="2013-12-12-01-40-45-00" LABEL="Fedora-Live-SoaS-x86_64-20-1" TYPE="iso9660" PTUUID="461863db" 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>
Line 40: Line 40:
<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></ul>
</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;">/media/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb '''500''' --home-size-mb '''750''' --delete-home --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 ~600 MB, and the overlay and home size arguments, '''500''' and '''750''', were selected to fit in a 2 GB device. These may be adjusted depending on your preferences and device capacity (see [[LiveOS image]]).
: 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 squeased into a 1 GB device with '''160''' and '''170'''. 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 ~]# /media/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 900 --delete-home --unencrypted-home /home/MyAccount/Downloads/Fedora-17-x86_64-Live-SoaS.iso /dev/sdc1
[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...
Verifying image...
/home/MyAccount/Downloads/Fedora-17-x86_64-Live-SoaS.iso:  470134baa7e48085595243e53b55d41e
/home/MyAccount/Downloads/Fedora-Live-SoaS-x86_64-20-1.iso:  b0a9414ff7eb79b680d5c86440e19587
Fragment sums: 7de3e14f3d5aa991343fa35bdfe3a1db59d578db95a844a63d22de789de1
Fragment sums: 9bfe23577651c88dcfb78c76ac3a28a5c53eead4561e3bdc5921b8b2e748
Fragment count: 20
Fragment count: 20
Press [Esc] to abort check.
Press [Esc] to abort check.
Line 58: Line 58:
Copying live image to target device.
Copying live image to target device.
squashfs.img
squashfs.img
  512344064 100%   43.04MB/s    0:00:11 (xfer#1, to-check=0/1)
    630,784,000 100%   1.96MB/s    0:05:06 (xfr#1, to-chk=0/1)
 
sent 512406681 bytes  received 31 bytes  44557105.39 bytes/sec
total size is 512344064  speedup is 1.00
osmin.img
osmin.img
        8192 100%    0.00kB/s    0:00:00 (xfer#1, to-check=0/1)
          8,192 100%    0.00kB/s    0:00:00 (xfr#1, to-chk=0/1)
 
sent 8265 bytes  received 31 bytes  16592.00 bytes/sec
total size is 8192  speedup is 0.99
Updating boot config file
Updating boot config file
Initializing persistent overlay file
Initializing persistent overlay file
500+0 records in
500+0 records in
500+0 records out
500+0 records out
524288000 bytes (524 MB) copied, 5.1728 s, 101 MB/s
524288000 bytes (524 MB) copied, 216.717 s, 2.4 MB/s
Initializing persistent /home
Initializing persistent /home
900+0 records in
800+0 records in
900+0 records out
800+0 records out
943718400 bytes (944 MB) copied, 152.195 s, 6.2 MB/s
838860800 bytes (839 MB) copied, 344.643 s, 2.4 MB/s
Formatting unencrypted /home
Formatting unencrypted /home
mke2fs 1.42.3 (14-May-2012)
mke2fs 1.42.8 (20-Jun-2013)
Filesystem label=
Filesystem label=
OS type: Linux
OS type: Linux
Line 83: Line 77:
Fragment size=4096 (log=2)
Fragment size=4096 (log=2)
Stride=0 blocks, Stripe width=0 blocks
Stride=0 blocks, Stripe width=0 blocks
57600 inodes, 230400 blocks
51296 inodes, 204800 blocks
11520 blocks (5.00%) reserved for the super user
10240 blocks (5.00%) reserved for the super user
First data block=0
First data block=0
Maximum filesystem blocks=239075328
Maximum filesystem blocks=209715200
8 block groups
7 block groups
32768 blocks per group, 32768 fragments per group
32768 blocks per group, 32768 fragments per group
7200 inodes per group
7328 inodes per group
Superblock backups stored on blocks:  
Superblock backups stored on blocks:  
32768, 98304, 163840, 229376
32768, 98304, 163840


Allocating group tables: done                             
Allocating group tables: done                             
Line 98: Line 92:
Writing superblocks and filesystem accounting information: done
Writing superblocks and filesystem accounting information: done


tune2fs 1.42.3 (14-May-2012)
tune2fs 1.42.8 (20-Jun-2013)
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
Line 106: Line 100:
<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 '''240''' --home-size-mb '''120''' --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'', 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>
::: <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>

Revision as of 12:13, 14 December 2013

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

This page is transcluded to various installation instruction pages.

  1. Download the latest Sugar on a Stick .iso file.

  2. 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.)

  3. 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 squeased 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!
    

  4. 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.