Changes

'''Sugar Clone''' is, at this point in time (May 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 (July 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.

A small, utility script, '''Sugar Cellar''', is available in the bundle, or separately.  It is used to report on the storage space available on the persistent overlay, home directory, and other file spaces attached to the running image.  

A small, utility script, '''Sugar Cellar''', is available in the bundle, or separately.  It is used to report on the storage space available on the persistent overlay, home directory, and other file spaces attached to the running image.  

# Obtain the SugarClone script at http://people.sugarlabs.org/fgrose/SugarClone.

# Obtain the SugarClone script at http://people.sugarlabs.org/fgrose/SugarClone.

# 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 for the device, or to /mnt/live (from the perspective of a running LiveOS image).  

# Before booting the SoaS device that will be the source of the new Sugar Clone, copy the SugarClone script to the root, '/', folder at the base of the filesystem for the device, or, to /mnt/live (from the perspective of a running LiveOS image).

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

# Boot the computer from the USB stick into SoaS, and insert, or have a second USB device inserted, into the computer.

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

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

::<big><code>/mnt/live/SugarClone</code></big>

::{{Code|/mnt/live/SugarClone}}

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

If there is more than one USB/SD storage device available, a menu of the devices will appear allowing 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.

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 Sugar Clone.

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

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

In the Terminal Activity, change the working directory, and get the file:<big>

In the Terminal Activity, change the working directory, and get the file:<big>

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

: {{Code|cd /mnt/live}}

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

: {{Code|wget http://people.sugarlabs.org/fgrose/SugarClone}}

 

At this point,<big>

At this point,

: <code>SugarClone</code>

 

: {{Code|SugarClone}}

 

will launch the script.

will launch the script.

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

The script is copied to any new Sugar Clone devices prepared with this script so that Sugar Clone images can easily propagate themselves.  This also applies to all new SoaS installations that are prepared with these scripts.

==Needed:==

==Needed:==

===Bundle===

===Bundle===

{{Iframe|collapsed=|http://people.sugarlabs.org/fgrose/bundle|http://people.sugarlabs.org/fgrose/bundle|800|200|1}}

{{Iframe|collapsed=|http://people.sugarlabs.org/fgrose/bundle|http://people.sugarlabs.org/fgrose/bundle|800|200|1}}