Web   ·   Wiki   ·   Activities   ·   Blog   ·   Lists   ·   Chat   ·   Meeting   ·   Bugs   ·   Git   ·   Translate   ·   Archive   ·   People   ·   Donate
summaryrefslogtreecommitdiffstats
path: root/Customization Guide/en-US/Building.xml
diff options
context:
space:
mode:
Diffstat (limited to 'Customization Guide/en-US/Building.xml')
-rw-r--r--Customization Guide/en-US/Building.xml42
1 files changed, 42 insertions, 0 deletions
diff --git a/Customization Guide/en-US/Building.xml b/Customization Guide/en-US/Building.xml
new file mode 100644
index 0000000..b13008a
--- /dev/null
+++ b/Customization Guide/en-US/Building.xml
@@ -0,0 +1,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>