Changes

== Summary ==

== Summary ==

This is [[Harmonic_Distribution/Deployment|one of the possible]] reference implementations of [[Harmonic Distribution]] based solutions. The goal is creating a Sugar based downstream distribution to run on OLPC XO laptops by end-users. The created reference implementation is intended to be a template for final deployment distributions.

This is [[Deployment_Platform/Deployment|one of the possible]] reference implementations of [[Deployment Platform]] based solutions. The goal is creating a Sugar based downstream distribution to run on OLPC XO laptops by end-users. The created reference implementation is intended to be a template for final deployment distributions.

== Overview ==

== Overview ==

'''Initial Sugar Activities'''

'''Initial Sugar Activities'''

:[[Harmonic Distribution]] based solutions are based on [[Sugar Network]], which makes all Sugar Activities accessible from a local school server or an Internet located one. Nonetheless, it is useful to have some first-time activities already included with the image.

:[[Deployment Platform]] based solutions are based on [[Sugar Network]], which makes all Sugar Activities accessible from a local school server or an Internet located one. Nonetheless, it is useful to have some first-time activities already included with the image.

: Activities will be downloaded from the Sugar Network and placed in the {{Code|~/Activities}} directory in the image.

: Activities will be downloaded from the Sugar Network and placed in the {{Code|~/Activities}} directory in the image.

=== Deployment repository ===

=== Deployment repository ===

Make sure that the Fedora repository is accessible from the building host and end-users. If you are looking for a building and hosting environment, try [[Platform_Team/Open_Build_System|packages.sugarlabs.org]], which is an instance of [http://www.open-build-service.org/ Open Build Service].

Make sure that the Fedora repository is accessible from the building host and end-users. If you are looking for a building and hosting environment, try [[Platform_Team/Open_Build_Service|packages.sugarlabs.org]], which is an instance of [http://www.open-build-service.org/ Open Build Service].

If you are using [[Platform_Team/Open_Build_System|packages.sugarlabs.org]], create a new project, and add the Fedora 14 repository from the [[Sweets Distribution]] project your implementation is based on. For example, there is {{OBS/project|SweetsDistribution:Factory:ReferenceXO|reference project}} based on {{OBS/project|SweetsDistribution:Factory|SweetsDistribution:Factory] repositories.

If you are using [[Platform_Team/Open_Build_Service|packages.sugarlabs.org]], create a new project, and add the Fedora 14 repository from the [[Sweets Distribution]] project your implementation is based on. For example, there is {{OBS/project|SweetsDistribution:Factory:ReferenceXO|reference project}} based on {{OBS/project|SweetsDistribution:Factory|SweetsDistribution:Factory}} repositories.

=== Deployment package ===

=== Deployment package ===

  make dist

  make dist

If you are using [[Platform_Team/Open_Build_System|packages.sugarlabs.org]], call the [http://en.opensuse.org/Build_Service/CLI osc] utility to upload newly created sources tarball and spec file to OBS.

If you are using [[Platform_Team/Open_Build_Service|packages.sugarlabs.org]], call the [http://en.opensuse.org/Build_Service/CLI osc] utility to upload newly created sources tarball and spec file to OBS.

=== Create images ===

=== Create images ===

=== Post-install support ===

=== Post-install support ===

Post installation support is all about updating packages in the [[#Deployment_repository|deployment repository]], e.g., update the configuration in the [[#Deployment_package|deployment package]]. Then, using one of the [[Harmonic_Distribution/Deployment#Scenarios|deployment scenarios]], distribute the package updates among users.

Post installation support is all about updating packages in the [[#Deployment_repository|deployment repository]], e.g., update the configuration in the [[#Deployment_package|deployment package]]. Then, using one of the [[Deployment_Platform/Deployment#Scenarios|deployment scenarios]], distribute the package updates among users.

{{Anchor|Try reference implementation}}

{{Anchor|Try reference implementation}}

To try a reference implementation on an XO laptop, download one of the prebuilt images and proceed with the  instructions below to flash it. Note that images were built using a recent development version of the software. So, images might be used to easily test recent changes.

To try a reference implementation on an XO laptop, download one of the prebuilt images and proceed with the  instructions below to flash it. Note that images were built using a recent development version of the software. So, images might be used to easily test recent changes.

=== XO-1 ===

=== XO-1 ===

* First, ensure that your laptop is [http://wiki.laptop.org/go/Activation_and_developer_keys unlocked].

* First, ensure that your laptop is [http://wiki.laptop.org/go/Activation_and_developer_keys unlocked].

* Download [http://download.sugarlabs.org/platform/reference-xo/xo1/os.img os.img] and [http://download.sugarlabs.org/platform/reference-xo/xo1/os.crc os.crc] files to the root directory of a USB stick or SD card.

* Download [http://download.sugarlabs.org/images/reference-xo/xo1/os.img os.img] and [http://download.sugarlabs.org/images/reference-xo/xo1/os.crc os.crc] files to the root directory of a USB stick or SD card.

* Drop to the [[OLPC:Open Firmware|Open Firmware]] "'''ok'''" prompt by pressing [[File:Esc.svg|24px]] (Esc) repeatedly during boot.

* Drop to the Open Firmware [[OLPC:Ok|"'''ok'''"]] prompt by pressing [[File:Esc.svg|24px]] (Esc) repeatedly during boot.

* Type the command: <code>'''copy-nand u:\xo.img'''</code> for a USB stick or <code>'''copy-nand sd:\xo.img'''</code> for a SD card followed by [[File:Key_enter.jpg|50px]] (enter).

* Type the command: <code>'''copy-nand u:\os.img'''</code> for a USB stick or <code>'''copy-nand sd:\os.img'''</code> for a SD card followed by [[File:Key_enter.jpg|50px]] (enter).

* Wait for the display to fill in with color and the "'''ok'''" prompt to return

* Wait for the display to fill in with color and the "'''ok'''" prompt to return

* Type the command <code>'''reboot'''</code> followed by [[File:Key_enter.jpg|50px]] (enter)

* Type the command <code>'''reboot'''</code> followed by [[File:Key_enter.jpg|50px]] (enter)

* First, ensure that your laptop is [http://wiki.laptop.org/go/Activation_and_developer_keys unlocked].

* First, ensure that your laptop is [http://wiki.laptop.org/go/Activation_and_developer_keys unlocked].

* Download [http://download.sugarlabs.org/platform/reference-xo/xo1.5/os.zd os.zd] to the root directory of a USB stick

* Download [http://download.sugarlabs.org/platform/reference-xo/xo1.5/os.zd os.zd] to the root directory of a USB stick

* Drop to the [[OLPC:Open Firmware|Open Firmware]] "'''ok'''" prompt by pressing [[File:Esc.svg|24px]] (Esc) repeatedly during boot

* Drop to the Open Firmware [[OLPC:Ok|"'''ok'''"]] prompt by pressing [[File:Esc.svg|24px]] (Esc) repeatedly during boot

* Type the command: <code>'''fs-update u:\xo.zd'''</code> followed by [[File:Key_enter.jpg|50px]] (enter)

* Type the command: <code>'''fs-update u:\os.zd'''</code> followed by [[File:Key_enter.jpg|50px]] (enter)

* Wait for the display to fill in with color and the "'''ok'''" prompt to return

* Wait for the display to fill in with color and the "'''ok'''" prompt to return

* Type the command <code>'''reboot'''</code> followed by [[File:Key_enter.jpg|50px]] (enter)

* Type the command <code>'''reboot'''</code> followed by [[File:Key_enter.jpg|50px]] (enter)

* [http://pe.sugarlabs.org/go/Proyecto_Piloto_Hexoquinasa Hexokinase].

* [http://pe.sugarlabs.org/go/Proyecto_Piloto_Hexoquinasa Hexokinase].