Sugar on a Stick/Customization - Revision history

FGrose at 14:17, 14 October 2010

2010-10-14T14:17:33Z

← Older revision		Revision as of 10:17, 14 October 2010
Line 1:		Line 1:
	{{~~TOCright~~}}		{{Dated}}
	== Customizing your SoaS ==		== Customizing your SoaS ==

	'''Note:''' As of October 30, this is only a draft, most certainly incomplete and still subject to changes.		'''Note:''' As of 30 October 2009, this is only a draft, most certainly incomplete and still subject to changes.

	Creating your own SoaS is not as hard as it probably sounds. Depending on whether you just want to adjust some settings or need to modify it for a deployment, you might want to look a bit deeper into the process of creating the images, even if the procedure itself is always the same. Please make sure to adhere to the naming conditions when releasing a customized version publicly.		Creating your own SoaS is not as hard as it probably sounds. Depending on whether you just want to adjust some settings or need to modify it for a deployment, you might want to look a bit deeper into the process of creating the images, even if the procedure itself is always the same. Please make sure to adhere to the naming conditions when releasing a customized version publicly.

Sdz: smaller updates

2009-10-30T16:10:11Z

smaller updates

← Older revision		Revision as of 12:10, 30 October 2009
Line 2:		Line 2:
	== Customizing your SoaS ==		== Customizing your SoaS ==

	'''Note:''' As of ~~June 23~~, this is only a draft, most certainly incomplete and still subject to changes.		'''Note:''' As of October 30, this is only a draft, most certainly incomplete and still subject to changes.

	Creating your own SoaS is not as hard as it probably sounds. Depending on whether you just want to adjust some settings or need to modify it for a deployment, you might want to look a bit deeper into the process of creating the images, even if the procedure itself is always the same.		Creating your own SoaS is not as hard as it probably sounds. Depending on whether you just want to adjust some settings or need to modify it for a deployment, you might want to look a bit deeper into the process of creating the images, even if the procedure itself is always the same. Please make sure to adhere to the naming conditions when releasing a customized version publicly.

	=== Components ~~of SoaS~~ ===		=== Components ===

	First of all, it is important to understand from which components SoaS it is composed. It consists basically of the following parts:		First of all, it is important to understand from which components SoaS it is composed. It consists basically of the following parts:

	* Fedora, as the base operating system, providing most of the packages we are using (this includes the Sugar Environment & Platform~~, as well as the basic Fructose Activities~~).		* Fedora, as the base operating system, providing most of the packages we are using (this includes the Sugar Environment & Platform).
	* Additional packages from a repository at download.sugarlabs.org to add our branding ~~and some other features~~.		* Additional packages from a repository at download.sugarlabs.org to add our branding (we are trying to keep the number of packages here as small as possible).
	* ~~Further~~ activities, which are directly downloaded from activities.sugarlabs.org.		* The activities, which are directly downloaded from [http://activities.sugarlabs.org activities.sugarlabs.org].

	=== Prerequirements ===		=== Prerequirements ===

	~~Development takes place in~~ the ~~SoaS GIT repo located here (http://git~~.~~sugarlabs~~.~~org/projects/soas)~~, ~~so it is recommended to check that out to your local drive.~~		You will need a Fedora system to run the scripts to create the live media, preferably the most current version of it. Additionally, you will need the a few packages, like the tools used for composing and a distributed version control system. To get them, become root by using su and run the following command:

	~~You~~ will ~~also~~ need a ~~Fedora system to run the scripts~~ to ~~create the live media~~, ~~preferably~~ the ~~most current version of it. Finally~~, you ~~will need the tools used for composing~~, ~~which~~ you ~~can~~ grab ~~by running yum install livecd-tools as root~~.		<code>yum install git livecd-tools</code>

			Development takes place in the SoaS GIT repository, which you will need to checkout first. As it is a GIT repository, make sure to have GIT installed, before executing:

			<code>git clone git://git.sugarlabs.org/soas/mainline.git soas</code>

			In case you encounter any issues while checking the files out, probably because you are behind a firewall, you might try using HTTP instead:

			<code>git clone http://git.sugarlabs.org/git/soas/mainline.git soas</code>

			This will grab all the latest files in the project's directory and place them in a folder called soas.

	=== Getting Started ===		=== Getting Started ===
Line 24:		Line 34:
	Now we will have a look at the config files themselves, which are used to create the builds. Starting with soas-base.ks, which provides the base system, you will notice some arguments at the top of the file:		Now we will have a look at the config files themselves, which are used to create the builds. Starting with soas-base.ks, which provides the base system, you will notice some arguments at the top of the file:

	lang en_US.UTF-8		* lang en_US.UTF-8
	keyboard us		* keyboard us
	timezone US/Eastern		* timezone US/Eastern

	You can easily adjust that to modify the default language settings. Fedora provides more information on the various options here (http://fedoraproject.org/wiki/Anaconda/Kickstart).		You can easily adjust that to modify the default language settings. Fedora provides more information on the various options here (http://fedoraproject.org/wiki/Anaconda/Kickstart).

	Next, we will focus on the soas-sugar.ks, which contains all the Sugar parts, as well as some customizations. The first part listed under # sugar! contains the activities, that have been packaged for Fedora, meaning that they are available as RPM files. You can run yum list 'sugar-*' on your build machine to find out what is available in the repos.		Next, we will focus on the soas-sugar.ks, which contains all the Sugar parts, as well as some customizations. The first part listed under # sugar! contains the activities, that have been packaged for Fedora, meaning that they are available as RPM files. You can run yum list 'sugar-*' on your build machine to find out what is available in the repos.

FGrose at 01:30, 24 June 2009

2009-06-24T01:30:33Z

← Older revision		Revision as of 21:30, 23 June 2009
Line 1:		Line 1:
			{{TOCright}}
	== Customizing your SoaS ==		== Customizing your SoaS ==

Sdz: upload first draft

2009-06-23T21:25:17Z

upload first draft

New page

== Customizing your SoaS ==

'''Note:''' As of June 23, this is only a draft, most certainly incomplete and still subject to changes.

Creating your own SoaS is not as hard as it probably sounds. Depending on whether you just want to adjust some settings or need to modify it for a deployment, you might want to look a bit deeper into the process of creating the images, even if the procedure itself is always the same.

=== Components of SoaS ===

First of all, it is important to understand from which components SoaS it is composed. It consists basically of the following parts:

* Fedora, as the base operating system, providing most of the packages we are using (this includes the Sugar Environment & Platform, as well as the basic Fructose Activities).
* Additional packages from a repository at download.sugarlabs.org to add our branding and some other features.
* Further activities, which are directly downloaded from activities.sugarlabs.org.

=== Prerequirements ===

Development takes place in the SoaS GIT repo located here (http://git.sugarlabs.org/projects/soas), so it is recommended to check that out to your local drive.

You will also need a Fedora system to run the scripts to create the live media, preferably the most current version of it. Finally, you will need the tools used for composing, which you can grab by running yum install livecd-tools as root.

=== Getting Started ===

Now we will have a look at the config files themselves, which are used to create the builds. Starting with soas-base.ks, which provides the base system, you will notice some arguments at the top of the file:

lang en_US.UTF-8
keyboard us
timezone US/Eastern

You can easily adjust that to modify the default language settings. Fedora provides more information on the various options here (http://fedoraproject.org/wiki/Anaconda/Kickstart).

Next, we will focus on the soas-sugar.ks, which contains all the Sugar parts, as well as some customizations. The first part listed under # sugar! contains the activities, that have been packaged for Fedora, meaning that they are available as RPM files. You can run yum list 'sugar-*' on your build machine to find out what is available in the repos.