Deployment Platform/XO reference distribution: Difference between revisions
No edit summary |
|||
| (9 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
== Summary == | == Summary == | ||
This is [[ | 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''' | ||
:[[ | :[[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/ | 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/ | 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/ | 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 [[ | 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/ | * 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: | * 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:\ | * 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: | * 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:\ | * 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]. | ||
== | == 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. | ||