Changes

'''Sugar Clone''' is, at this point in time (April 2010), a Bash script that aids in the copying of a customized LiveOS image, such as [[Sugar on a Stick]], to a secondary device. It works from within a booted LiveOS image to copy that image.  Or it may be used to copy a LiveOS image between 2 attached USB/SD storage devices.  It is intended to support the Sugar customization kit projects.

'''Sugar Clone''' is, at this point in time (April 2010), a Bash script that aids in the copying of a customized LiveOS image, such as [[Sugar on a Stick]], to a secondary device. It works from within a booted LiveOS image to copy that image.  Or it may be used to copy a LiveOS image between 2 attached USB/SD storage devices.  It is intended to support the Sugar customization kit projects.

===Test Usage===

===Test Usage===

# Before booting the SoaS device that will be the source of the new SugarClone, copy the script files above to the root '/' folder at the base of the filesystem (not the /root folder).

 

# Before booting the SoaS device that will be the source of the new SugarClone, copy the SugarClone script to the root '/' folder at the base of the filesystem (not the /root folder).  

# Boot the USB stick into SoaS and insert a second USB device into the computer running that SoaS image.

# Boot the USB stick into SoaS and insert a second USB device into the computer running that SoaS image.

# In the Terminal Activity of that running SoaS image, enter the command,

# In the Terminal Activity of that running SoaS image, enter the command,

Step 1 above, from the perspective of the learner inside a currently running SoaS image, would be different: The root folder of the USB device would be reached through the /mnt/live mount point.  The scripts could be obtained (assuming Internet connectivity) as follows:

If there is more than one USB/SD storage device available, a menu of the devices will appear for selection of the target device.

 

The scripts will copy the currently running image to the target device. When that device is booted, a new, Sugar Learner sign-in will be triggered. The previously customized Journal and operating system will be present on the SugarClone image.

 

On a running LiveOS image, the root folder of the USB/SD device is available at the /mnt/live mount point.  The SugarClone script could be obtained (assuming Internet connectivity) as follows:

In the Terminal Activity, change the working directory, get the files, & make them executable:<big>

In the Terminal Activity, change the working directory, get the files, & make them executable:<big>

: <code>cd /mnt/live</code>

: <code>cd /mnt/live</code>

: <code>wget http://people.sugarlabs.org/fgrose/SugarClone</code>

: <code>wget http://people.sugarlabs.org/fgrose/SugarClone</code>

: <code>chmod +x SugarClone</code>

: <code>chmod +x SugarClone</code>

</big>

</big>

===Possible Use Cases===

===Possible Use Cases===

====Curriculum packaging====

====Curriculum packaging====

but should work with other versions of SoaS.

but should work with other versions of SoaS.

The current version of the scripts have the /bin/bash shell specified without the -x (xtrace) option.  Set this option, #!/bin/bash -x in the first line of the script to aid testing.  When set, they will show a lot of output on the screen as they run.

The current version of the script has the /bin/bash shell specified without the -x (xtrace) option.  Set this option, #!/bin/bash -x in the first line of the script to aid testing.  When set, the script will show a lot of output on the screen as it runs.

The scripts are copied to the new SugarClone devices prepared with these scripts so that they can easily propagate themselves.  This also applies to all new SoaS installations that are prepared with these scripts (using --image <source> options).

The script is copied to any new SugarClone devices prepared with this script so that SugarClone images can easily propagate themselves.  This also applies to all new SoaS installations that are prepared with these scripts (using --image <source> options).

==Needed:==

==Needed:==

# Modifications for Intel Macintosh computers.

# Modifications for Intel Macintosh computers.

#* https://answers.edge.launchpad.net/soas/+question/95622

#* https://answers.edge.launchpad.net/soas/+question/95622

# Extraction of the Learner's Sugar image name for labeling the Clone.

# <s>Extraction of the Learner's Sugar image name for labeling the Clone.</s> (available 14 April 2010)

# A Sugar Activity that calls or controls the scripts.

# A Sugar Activity that calls or controls the scripts.

# A way to automatically identify extra partitions on devices with more than one available partition.

# A way to automatically identify extra partitions on devices with more than one available partition.

# A way to automatically identify live media images on secondary devices and partitions that could be used as sources for a Sugar Clone.

# A way to automatically identify live media images on secondary devices and partitions that could be used as sources for a Sugar Clone.

# Bundling of the scripts for convenience until they are included in SoaS.

# <s>Bundling of the scripts for convenience until they are included in SoaS.</s> (available 23 April 2010)

# Extend the capability to write CD-ROM image files for inexpensive distribution.

# Extend the capability to write CD-ROM image files for inexpensive distribution.

# Extend the facility to any Sugar image.

# Extend the facility to any Sugar image.