Line 1: |
Line 1: |
| == 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 == |
Line 19: |
Line 19: |
| '''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. |
| | | |
Line 32: |
Line 32: |
| === 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 === |
Line 56: |
Line 56: |
| 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 === |
Line 71: |
Line 71: |
| === 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}} |
Line 78: |
Line 78: |
| | | |
| 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. |
| + | |
| + | Reference XO images might not be up-to-date (since there are not intended to be used as-is by deployments), so, run full system update right after flashing to make sure that system is recent: |
| + | |
| + | sudo yum update |
| | | |
| === 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) |
Line 94: |
Line 98: |
| * 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) |
Line 106: |
Line 110: |
| * [http://pe.sugarlabs.org/go/Proyecto_Piloto_Hexoquinasa Hexokinase]. | | * [http://pe.sugarlabs.org/go/Proyecto_Piloto_Hexoquinasa Hexokinase]. |
| | | |
− | == Resource == | + | == Resources == |
| | | |
| * Sources for deployment package [http://git.sugarlabs.org/platform/reference-xo reference implementation]. | | * Sources for deployment package [http://git.sugarlabs.org/platform/reference-xo reference implementation]. |
Line 112: |
Line 116: |
| * {{OBS/project|SweetsDistribution:Factory:ReferenceXO|OBS project}} for reference deployment repository. | | * {{OBS/project|SweetsDistribution:Factory:ReferenceXO|OBS project}} for reference deployment repository. |
| * {{OBS/package|SweetsDistribution:Factory:ReferenceXO|deployment|OBS package}} for reference deployment package. | | * {{OBS/package|SweetsDistribution:Factory:ReferenceXO|deployment|OBS package}} for reference deployment package. |
| + | * [http://download.sugarlabs.org/packages/SweetsDistribution:/Factory:/ReferenceXO/ Binary packages] for reference deployment repository. |
| + | * Prebuilt [http://download.sugarlabs.org/platform/reference-xo/ XO images]. |
| * [[Sweets Distribution]] this reference implementation is based on. | | * [[Sweets Distribution]] this reference implementation is based on. |