8,288
edits
Changes
Jump to navigation
Jump to search
Line 24:
Line 24: − + Line 72:
Line 72: − + − + − + − + + +
no edit summary
:*''[[wikipedia:dm-crypt|cryptsetup]]'' is only needed for the option to provide password protection and encryption for the persistent /home/liveuser folder. It is not necessary if one applies the recommended {{Code|--unencrypted-home}} option. The {{Code|--unencrypted-home}} option is preferred because the reduced overhead improves robustness with the compressed ''[[wikipedia:SquashFS|SquashFS]]'' file system employed by the Live USB deployment.
:*''[[wikipedia:dm-crypt|cryptsetup]]'' is only needed for the option to provide password protection and encryption for the persistent /home/liveuser folder. It is not necessary if one applies the recommended {{Code|--unencrypted-home}} option. The {{Code|--unencrypted-home}} option is preferred because the reduced overhead improves robustness with the compressed ''[[wikipedia:SquashFS|SquashFS]]'' file system employed by the Live USB deployment.
* Plug in a 1-GB or larger USB stick into your computer.
* Plug in a 1-GB or larger USB stick into your computer.
* Download the installation script: http://bit.ly/livecd-iso-to-disk.<br>(You will execute this script several steps below.)<br>Execute {{Code|livecd-iso-to-disk --help}} for usage details.
* Download the installation script: http://bit.ly/livecd-iso-to-disk.<br>(You will execute this script several steps below.)<br>Execute {{Code|tools_livecd-iso-to-disk --help}} for usage details.
** Alternatively, with 3 available loop devices, loop mount the 'SoaS.iso' image to reach the onboard livecd-iso-to-disk script:
** Alternatively, with 3 available loop devices, loop mount the 'SoaS.iso' image to reach the onboard livecd-iso-to-disk script:
**: {{Code|mkdir /mnt/soas/}}
**: {{Code|mkdir /mnt/soas/}}
::# {{Code|quit}}
::# {{Code|quit}}
* Change mode to make the script executable.
* (You may need to change the file mode to make the script executable.)
: {{Code|chmod +x livecd-iso-to-disk.sh}}
: {{Code|chmod +x tools_livecd-iso-to-disk.sh}}
* Run it as root, making sure to pass the correct USB device and to set overlay and home size appropriately, depending on the stick size.
* Run it as root, making sure to pass the correct USB device and to set overlay and home size appropriately, depending on the stick size.
: {{Code|sudo ./livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /path/to/SoaS.iso /dev/sd''b1''}}
*: {{Code|sudo ./tools_livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /path/to/SoaS.iso /dev/sd''b1''}}
:: The ''livecd-iso-to-disk'' installation method has advantages over the ''liveusb-creator'' method by allowing the creation of a separate, persistent /home/liveuser folder with the <tt>--home-size-mb ''NNN''</tt> option. This feature avoids consumption of the write-once persistent overlay for Activity storage (see [[LiveOS image]]) and allows one to update the OS image while keeping the user files (by running the script against your existing installation but <u>leaving out</u> the --home-size-mb NNN option).
** {{Highlight|'''Note''': Subsequent USB or SD devices may be installed from a running Sugar on a Stick image that was installed with the livecd-iso-to-disk script downloaded after 15 February 2011 (but not those installed by other methods) by running this command from a root user Terminal window:}}
**: {{Code|/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /dev/sr0 /dev/sd?1}}
: The ''livecd-iso-to-disk'' installation method has other advantages over the ''liveusb-creator'' method by allowing the creation of a separate, persistent /home/liveuser folder with the <tt>--home-size-mb ''NNN''</tt> option. This feature avoids consumption of the write-once persistent overlay for Activity storage (see [[LiveOS image]]) and allows one to update the OS image while keeping the user files (by running the script against your existing installation but <u>leaving out</u> the --home-size-mb NNN option).
::* The {{Code|--delete-home}} option is used to avoid an error message while requesting both a new home (with {{Code|--home-size-mb}}) and a persistent home (indirectly with {{Code|--unencrypted-home}}). You wouldn't use the --delete-home option on an upgrade of the operation system only.
::* The {{Code|--delete-home}} option is used to avoid an error message while requesting both a new home (with {{Code|--home-size-mb}}) and a persistent home (indirectly with {{Code|--unencrypted-home}}). You wouldn't use the --delete-home option on an upgrade of the operation system only.
:Depending on the size of your USB stick, you may have to decrease {{Code|--overlay-size-mb}} and {{Code|--home-size-mb}} values (for example, for a 1-GB stick, use 300 for the overlay and 175 for the home folder).
:Depending on the size of your USB stick, you may have to decrease {{Code|--overlay-size-mb}} and {{Code|--home-size-mb}} values (for example, for a 1-GB stick, use 300 for the overlay and 175 for the home folder).