Difference between revisions of "Sugar on a Stick/Linux/Installation"

From Sugar Labs
Jump to: navigation, search
(Undo revision 102681 by Satellit (talk) This page is transcluded to others. Special installs are not appropriate here.)
(livecd-tools now onboard)
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></li>
+
<li> '''Download''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br><br></li>
<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> '''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 /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> 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>
 
<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>
Line 25: Line 30:
 
<pre>
 
<pre>
 
[<user>@<system> <working directory>]$ sudo blkid
 
[<user>@<system> <working directory>]$ sudo blkid
/dev/sda1: LABEL="Fedora29" UUID="45e12f4a-51f2-463e-a33b-a6c0f157ab77" TYPE="ext4" PARTUUID="000b2340-04"  
+
/dev/sda1: LABEL="Fedora30" 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="2018-10-25-00-02-47-00" LABEL="Fedora-SoaS-Live-29-1-2" TYPE="iso9660" PTUUID="3299e5ae" PTTYPE="dos"  
+
/dev/loop0: UUID="2019-04-26-02-34-40-00" LABEL="Fedora-WS-Live-30-1-2" TYPE="iso9660" PTUUID="34258370" PTTYPE="dos"
 +
/dev/loop0p1: UUID="2019-04-26-02-34-40-00" LABEL="Fedora-WS-Live-30-1-2" TYPE="iso9660" PTUUID="34258370" PTTYPE="dos" PARTUUID="34258370-01"
 +
/dev/loop0p2: SEC_TYPE="msdos" LABEL_FATBOOT="ANACONDA" LABEL="ANACONDA" UUID="E385-716D" TYPE="vfat" PARTUUID="34258370-02"
 +
/dev/loop0p3: UUID="8f5370e2-fd7c-3f3a-9d01-aa72345be183" LABEL="ANACONDA" TYPE="hfsplus" PARTUUID="34258370-03"
 
</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 33: Line 41:
 
<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 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></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 '''500''' --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 '''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 ~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.
 
: 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.

Revision as of 18:15, 30 April 2019

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.
    • With root user permissions at a terminal or console command line, use the command sudo df -Th or sudo blkid to get the USB device node name.
    • (Items in angle brackets, such as <MyAccount> are descriptive placeholders.)
       You should see something like the following:
      [<user>@<system> <working directory>]$ sudo 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   959M  959M     0 100% /run/soas
      /dev/sdc1      vfat      2.0G  2.0G   53M  98% /run/media/<MyAccount>/<filesystem label>/
      
      (The /run/media/<MyAccount>/ path is the standard mount point for removable media.
      /media/<MyMountPoint> is common on other operating systems.)
      [<user>@<system> <working directory>]$ sudo blkid
      /dev/sda1: LABEL="Fedora30" UUID="45e12f4a-51f2-463e-a33b-a6c0f157ab77" TYPE="ext4" PARTUUID="000b2340-04" 
      /dev/sdc1: LABEL="LIVE" UUID="D2AC-5056" TYPE="vfat"  PARTUUID="000056b3-01" 
      /dev/loop0: UUID="2019-04-26-02-34-40-00" LABEL="Fedora-WS-Live-30-1-2" TYPE="iso9660" PTUUID="34258370" PTTYPE="dos"
      /dev/loop0p1: UUID="2019-04-26-02-34-40-00" LABEL="Fedora-WS-Live-30-1-2" TYPE="iso9660" PTUUID="34258370" PTTYPE="dos" PARTUUID="34258370-01"
      /dev/loop0p2: SEC_TYPE="msdos" LABEL_FATBOOT="ANACONDA" LABEL="ANACONDA" UUID="E385-716D" TYPE="vfat" PARTUUID="34258370-02"
      /dev/loop0p3: UUID="8f5370e2-fd7c-3f3a-9d01-aa72345be183" LABEL="ANACONDA" TYPE="hfsplus" PARTUUID="34258370-03"
      
      (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 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 500 --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 ~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.
     The installation transcript should look something like the following:
    [<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...
    /<path to>/Fedora-SoaS-Live-x86_64-29-1.2.iso:   7641738bb0493f4a521af3a694e4f4ae
    Fragment sums: 7c5f6e26254ca7438da4d5b28a72a9f38711e3bb34b2748e177533ef5c25
    Fragment count: 20
    Supported ISO: no
    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 LiveOS image to target device...
    squashfs.img
        905,187,328 100%  374.66MB/s    0:00:02 (xfr#1, to-chk=0/1)
    
    Syncing filesystem writes to disc.
        Please wait, this may take a while...
    Setting up /EFI/BOOT
    Updating boot config files.
    Initializing persistent overlay...
    500+0 records in
    500+0 records out
    524288000 bytes (524 MB, 500 MiB) copied, 0.448825 s, 1.2 GB/s
    Initializing persistent /home
    500+0 records in
    500+0 records out
    524288000 bytes (524 MB, 500 MiB) copied, 0.415686 s, 1.3 GB/s
    Formatting unencrypted home.img
    mke2fs 1.44.3 (10-July-2018)
    Creating filesystem with 512000 1k blocks and 128016 inodes
    Filesystem UUID: 8fc0d8be-5c67-46a8-b621-6bd62bad3267
    Superblock backups stored on blocks: 
    	8193, 24577, 40961, 57345, 73729, 204801, 221185, 401409
    
    Allocating group tables: done                            
    Writing inode tables: done                            
    Creating journal (8192 blocks): done
    Writing superblocks and filesystem accounting information: done 
    
    tune2fs 1.44.3 (10-July-2018)
    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 2 GB or greater USB or SD devices, while running Sugar on a Stick, one may run the Terminal Activity, and execute this command as the root user:
    livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 500 --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.