Web   ·   Wiki   ·   Activities   ·   Blog   ·   Lists   ·   Chat   ·   Meeting   ·   Bugs   ·   Git   ·   Translate   ·   Archive   ·   People   ·   Donate
summaryrefslogtreecommitdiffstats
path: root/Customization Guide/en-US/Building.xml
blob: b13008a6aee299e1882c2e98f790787e69160133 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
]>
<chapter id="chap-Customization_Guide-Building">
	<title>Building</title>
	<para>
		At the end of the customization process, you will run your own build, resulting in a new image file. This chapter describes how to do so and mentions aspects to pay attention to.
	</para>
	<para>
		To run the build process, Sugar on a Stick makes of the <firstterm>livecd-creator</firstterm> from Fedora's livecd-tools. The process, which may take depending on your machine up to an hour, requires to be executed as root.
	</para>
	<warning>
	<para>
		The build process is hardware-intensive and will demand both your internet connection and your computer itself in general. Make sure proceed only if you are aware of this.
	</para>
	</warning>
	<itemizedlist>
		<listitem>
		<para>
			Make sure you comply with the system requirements as listed in the first chapter, especially concerning the amount of free hard disk space.
		</para>
		</listitem>
		<listitem>
		<para>
			Turn SELinux <footnote><para>http://fedoraproject.org/wiki/SELinux</para></footnote> temporarily into a permissive mode by executing: <command>/usr/sbin/setenforce 0</command>
		</para>
		</listitem>
		<listitem>
		<para>
			Start the build process by executing the following command from the directory where you placed both kickstart files: <command>livecd-creator --config=fedora-livecd-soas.ks</command>
			<note>
			<para>
				You may also specify a <firstterm>file system label</firstterm>, influencing the name of the resulting image, as well as a <firstterm>cache directory</firstterm>, preventing livecd-creator from redownloading the required packages again, unless updates have occurred. For more information, execute: <command>livecd-creator --help</command>
			</para>
			</note>
		</para>
		</listitem>
	</itemizedlist>
	<para>
		Congratulations! You have just taken the final step towards customizing Sugar on a Stick for your needs. If you ran into any issues or have comments, suggestions, or feedback in general, feel free to contact us on the Sugar on a Stick <ulink url="http://lists.sugarlabs.org/listinfo/soas">mailing list</ulink>.
	</para>
</chapter>