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

From Sugar Labs
Jump to navigation Jump to search
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><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)
+
<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 /media/soas}}</li>
 
<li> Mount the .iso file as a disk: {{Code|mount '''/path/to/downloaded'''.iso /media/soas/}}
 
<li> Mount the .iso file as a disk: {{Code|mount '''/path/to/downloaded'''.iso /media/soas/}}
Line 31: Line 31:
 
<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, as the '''root''' user in <u>one</u> command with arguments, the following:<br><div style="padding: 1em; border: 1px dashed #2F6FAB; background-color: #FBFBFB; margin: 1em 0px 1em 1.6em; font-family: Courier;">/media/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb '''500''' --home-size-mb '''900''' --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 arguments:<br><div style="padding: 1em; border: 1px dashed #2F6FAB; background-color: #FBFBFB; margin: 1em 0px 1em 1.6em; font-family: Courier;">/media/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb '''500''' --home-size-mb '''900''' --delete-home --unencrypted-home '''/path/to/downloaded'''.iso /dev/sd'''?'''1</div>
 
: where '{{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.
 
: where '{{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 ~510 MB, and the overlay and home size arguments, '''500''' and '''900''', were selected to fit in a 2 GB device, but may be adjusted according to your device capacity.
 
: The operating system will occupy ~510 MB, and the overlay and home size arguments, '''500''' and '''900''', were selected to fit in a 2 GB device, but may be adjusted according to your device capacity.
Line 95: Line 95:
 
Target device is now set up with a Live image!
 
Target device is now set up with a Live image!
 
</pre>}}<br>
 
</pre>}}<br>
<li> '''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>
  
 
::* You may create more Sugar Sticks on other 1 GB or greater USB or SD devices. In the Terminal Activity of a running ''Sugar on a Stick'', run this command as root:<br><div style="padding: 1em; border: 1px dashed #2F6FAB; background-color: #FBFBFB; margin: 1em 0px 1em 0em; font-family: Courier;">/run/initramfs/live/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb '''300''' --home-size-mb '''175''' --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd'''?'''1</div>
 
::* You may create more Sugar Sticks on other 1 GB or greater USB or SD devices. In the Terminal Activity of a running ''Sugar on a Stick'', run this command as root:<br><div style="padding: 1em; border: 1px dashed #2F6FAB; background-color: #FBFBFB; margin: 1em 0px 1em 0em; font-family: Courier;">/run/initramfs/live/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb '''300''' --home-size-mb '''175''' --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd'''?'''1</div>

Revision as of 00:27, 2 August 2012

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 /media/soas
    • Mount the .iso file as a disk: mount /path/to/downloaded.iso /media/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 blkid or df -Th command 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   509M  509M     0 100% /media/soas
      /dev/sdc1      vfat      995M  983M   13M  99% /run/media/MyAccount/LG
      
           where the mount point and filesystem sizes 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 arguments:
    /media/soas/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 900 --delete-home --unencrypted-home /path/to/downloaded.iso /dev/sd?1
    where '?' 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 ~510 MB, and the overlay and home size arguments, 500 and 900, were selected to fit in a 2 GB device, but may be adjusted according to your device capacity.
          The installation transcript should look something like the following:
    [LiveOS]$ sudo ./livecd-iso-to-disk --reset-mbr --overlay-size-mb 500 --home-size-mb 900 --delete-home --unencrypted-home /media/soas/Fedora-17-x86_64-Live-SoaS.iso /dev/sdc1
    Verifying image...
    /media/soas/Fedora-17-x86_64-Live-SoaS.iso:   470134baa7e48085595243e53b55d41e
    Fragment sums: 7de3e14f3d5aa991343fa35bdfe3a1db59d578db95a844a63d22de789de1
    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
       512344064 100%   43.04MB/s    0:00:11 (xfer#1, to-check=0/1)
    
    sent 512406681 bytes  received 31 bytes  44557105.39 bytes/sec
    total size is 512344064  speedup is 1.00
    osmin.img
            8192 100%    0.00kB/s    0:00:00 (xfer#1, to-check=0/1)
    
    sent 8265 bytes  received 31 bytes  16592.00 bytes/sec
    total size is 8192  speedup is 0.99
    Updating boot config file
    Initializing persistent overlay file
    500+0 records in
    500+0 records out
    524288000 bytes (524 MB) copied, 5.1728 s, 101 MB/s
    Initializing persistent /home
    900+0 records in
    900+0 records out
    943718400 bytes (944 MB) copied, 152.195 s, 6.2 MB/s
    Formatting unencrypted /home
    mke2fs 1.42.3 (14-May-2012)
    Filesystem label=
    OS type: Linux
    Block size=4096 (log=2)
    Fragment size=4096 (log=2)
    Stride=0 blocks, Stripe width=0 blocks
    57600 inodes, 230400 blocks
    11520 blocks (5.00%) reserved for the super user
    First data block=0
    Maximum filesystem blocks=239075328
    8 block groups
    32768 blocks per group, 32768 fragments per group
    7200 inodes per group
    Superblock backups stored on blocks: 
    	32768, 98304, 163840, 229376
    
    Allocating group tables: done                            
    Writing inode tables: done                            
    Creating journal (4096 blocks): done
    Writing superblocks and filesystem accounting information: done
    
    tune2fs 1.42.3 (14-May-2012)
    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.

  • You may create more Sugar Sticks on other 1 GB or greater USB or SD devices. In the Terminal Activity of a running Sugar on a Stick, run this command as root:
    /run/initramfs/live/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /run/initramfs/livedev /dev/sd?1