Deployment Platform/Deployment
Summary
This is a Dextrose-3 based distribution that is being targeted to
- Fedora-14 on XO-1 and XO-1.5 laptops, and
- Trisquel-4.1 LTS for regular hardware.
In both cases, downstream packages are built on OBS in Hexokinase project from the same sources. And composed to XO and Trisquel images.
Build packages
This is about how to create downstream packages on OBS to include them later to resulting images.
Requirements
- Install sweets utility
Will be used for uploading package sources to the OBS. - Install gatch utility
Will be used for re-basing package sources to pull recent upstream changes. - Have Sugar Labs account to login to OBS (ping alsroot to add your to Hexokinase project users).
Sources
For all packages, sources are being stored in Gitorious hexokinase project. Clone sources you want to create packages for.
All sugar*
source repositories are downstream branches for dextrose-0.94
upstream branches from Gitorious SDK project. Thus, all of them are sweet projects and contain sweets.recipe files that describe how to create packages on OBS.
Sources re-base
Since, sugar sources are downstream branches for SDK project, if upstream sources where changed, hexokinase sources need to be re-based. Go to the particular source directory and type:
gatch merge
Build packages
If sources were updated, to create new packages, go to the particular source directory and type:
sweets commit -m <COMMIT-DESCRIPTION>
The building process might be observed starting from OBS's monitor page. If build process is successful, the resulting packages will be hosted on download.sugarlabs.org site.
Since packages were built from sweet sources, all packages are located in /opt/sweets
instead of /usr
This is useful when sugar packages require [re]building system packages, placing all downstream packages to /opt
will make it possible to use new system packages only with downstream Sugar and do not interfere with the rest of the system when user want to run, e.g, Gnome session.
Use packages
For all supported distributions:
- install
sweets-sugar
package; - use
sweets-sugar
to launch Sugar session; - use
sweets-sugar-emulator
to launch Sugar session in Xephyr.
Fedora-14
Create repository file /etc/yum.repos.d/hexokinase.repo
:
[hexokinase] name=hexokinase failovermethod=priority baseurl=http://download.sugarlabs.org/packages/Hexokinase/Fedora-14/ enabled=1 metadata_expire=1 gpgcheck=0
Install Sugar packages:
yum install sweets-sugar
Trisquel-4.1
Attach downstream repository:
sudo apt-add-repository 'deb http://download.sugarlabs.org/packages/Hexokinase/Ubuntu-10.04/ ./' wget -qO- http://download.sugarlabs.org/packages/Hexokinase/Ubuntu-10.04/Release.key | sudo apt-key add - apt-get update
Install Sugar packages:
apt-get install sweets-sugar