website view en/doc/handbook/gen-livecd.html @ rev 159
en: General Tidyup
| author | Paul Issott <paul@slitaz.org> |
|---|---|
| date | Wed Sep 10 17:52:18 2008 +0000 (2008-09-10) |
| parents | cbc3753477f5 |
| children | 3c4edaebb9b5 |
line source
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4 <head>
5 <title>SliTaz Handbook (en) - Gen a LiveCD to taste</title>
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
7 <meta name="description" content="slitaz tazlito build livecd flavor support all in RAM" />
8 <meta name="expires" content="never" />
9 <meta name="modified" content="2008-07-20 06:08:00" />
10 <meta name="publisher" content="www.slitaz.org" />
11 <meta name="author" content="Christophe Lincoln"/>
12 <link rel="shortcut icon" href="favicon.ico" />
13 <link rel="stylesheet" type="text/css" href="book.css" />
14 </head>
15 <body bgcolor="#ffffff">
17 <!-- Header and quick navigation -->
18 <div id="header">
19 <div align="right" id="quicknav">
20 <a name="top"></a>
21 <a href="liveusb.html">LiveUSB media</a> |
22 <a href="index.html">Table of contents</a>
23 </div>
24 <h1><font color="#3E1220">SliTaz Handbook (en)</font></h1>
25 </div>
27 <!-- Content. -->
28 <div id="content">
29 <div class="content-right"></div>
31 <h2><font color="#DF8F06">Generate a LiveCD to taste</font></h2>
32 <p>
33 Create your own LiveCD quickly and easily with Tazlito.
34 </p>
36 <ul>
37 <li><a href="#intro">To begin.</a></li>
38 <li><a href="#2cmds">A LiveCD in 2 commands.</a></li>
39 <li><a href="#get-flavor">Get a taste.</a></li>
40 <li><a href="#gen-distro">Generate the distribution.</a></li>
41 <li><a href="#gen-flavor">Create a flavor.</a></li>
42 <li><a href="#addfiles">Additional files.</a></li>
43 <li><a href="#pkgs">Packages used.</a></li>
44 <li><a href="#configure">Configuration file.</a></li>
45 </ul>
47 <a name="intro"></a>
48 <h3>To begin</h3>
49 <p>
50 Creating your own LiveCD version of SliTaz with Tazlito
51 takes very little time and you can choose precisely the software
52 packages that you want to find on the system. The support
53 of flavors permits you to generate a customized LiveCD
54 amended by a list of packages or flavors created by the SliTaz
55 community. Tazlito is a command line tool that is not too
56 demanding, you can have your own ISO image in two commands
57 or burned in one.
58 </p>
59 <p>
60 The generation of the LiveCD requires a minimum of 256 MB
61 RAM and system compression with LZMA may take some time. It's
62 possible to create a distribution from the LiveCD or from an
63 installed system. In LiveCD mode, it's advisable to use persistent
64 media or a USB drive to store generated files and save space in RAM.
65 </p>
66 <p>
67 Tazlito is used by developers to generate the official LiveCD.
68 The only prerequisite is to have Tazlito installed, this is installed
69 by default on SliTaz, but you can generate from another
70 LiveCD distribution if they have the necessary packages on hand
71 or can be downloaded.
72 </p>
73 <h4>Install Tazlito on another distribution</h4>
74 <p>
75 Tazlito does not generate dependencies for the LiveCD, but
76 it depends of Cdrkit to burn the image and Tazpkg to
77 regenerate SliTaz packages not already installed. To retrieve
78 and install Tazlito, follow the instructions in the README
79 file in <a href="http://download.tuxfamily.org/slitaz/sources/tazlito/"
80 >the sources of Tazlito</a>.
81 </p>
83 <a name="2cmds"></a>
84 <h3>A LiveCD in 2 commands</h3>
85 <ul>
86 <li>Get a flavor : <code>tazlito get-flavor core</code></li>
87 <li>Optional : Amend the list of packages or add
88 additional files.</li>
89 <li>Generate the distribution : <code>tazlito gen-distro</code></li>
90 </ul>
91 <p>
92 Once finished, you will find the LiveCD ISO image in the
93 <code>/home/slitaz/distro</code>.
94 </p>
95 <p>
96 For simple instructions click <a href="simple-gen-livecd.html">here</a> .
97 </p>
99 <a name="get-flavor"></a>
100 <h3>Get a taste</h3>
101 <p>
102 A flavor is a <code>.flavor</code> file containing all the necessary information
103 for the creation of the CD. The flavor provides the list of
104 packages (<code>distro-packages.list</code>) and additional files for the
105 chosen flavor. A list of flavors can be downloaded and
106 updated with Tazlito:
107 </p>
108 <pre>
109 # tazlito list-flavors
110 Or :
111 # tazlito list-flavors --recharge
112 </pre>
113 <p>
114 A list of flavors will automatically be displayed, giving the
115 size of the LiveCD and a brief description. For the remainder,
116 the <code>get-flavor</code> command will download the flavor file,
117 automatically extract the package list and description in
118 the current directory and put additional files in the
119 <code>/home/slitaz/distro/addfiles</code> directory. To store <em>flavors</em>,
120 we suggest that you use a specific directory such as
121 <code>/home/slitaz/flavors</code>, you can create this yourself and proceed
122 inside:
123 </p>
124 <pre>
125 # mkdir -p /home/slitaz/flavors
126 # cd /home/slitaz/flavors
127 </pre>
128 <p>
129 To download and/or extract the files in a particular flavor:
130 </p>
131 <pre>
132 # tazlito get-flavor particular-flavor
133 </pre>
134 <p>
135 The description of the flavor can be displayed with the
136 <code>show-flavor</code> command. Once the chosen flavor is downloaded
137 you can start to generate the distribution.
139 </p>
141 <a name="gen-distro"></a>
142 <h3>Generate the distribution</h3>
143 <p>
144 For your first ISO, we advise you to test without modifying
145 the list, then you can start to delete or add packages
146 at will. But beware, the base system packages are essential.
147 The <code>gen-distro</code> command generates an ISO image with all the
148 packages on the list, it must be run as root and be in the
149 same directory as the list and the configuration file.
150 To generate a LiveCD:
151 </p>
152 <pre>
153 # tazlito gen-distro
154 </pre>
155 <p>
156 Voilà, your first LiveCD ISO image is generated in <code>/home/slitaz/distro</code>,
157 but without an account for the user hacker.
158 </p>
159 <h4>The user hacker</h4>
160 <p>
161 If you want to have a hacker user account, we must add one
162 and then recreate the compressed root filesystem:
163 </p>
164 <pre>
165 # tazlito addhacker
166 # tazlito gen-initiso
167 </pre>
168 <h4>Clean and regenerate distro</h4>
169 <p>
170 To continue to go further, you can simply add one or two packages
171 to the list, clean the distro and regenerate the root
172 filesystem with a new ISO image:
173 </p>
174 <pre>
175 # tazlito clean-distro
176 # tazlito gen-distro
177 </pre>
178 <p>
179 Tazlito also offers several possibilities, such as burning the
180 ISO or copying additional files in the system or directly
181 on to the cdrom. The Tazlito <a href="../manuals/tazlito.en.html">Manual</a>
182 provides more information.
184 </p>
186 <a name="gen-flavor"></a>
187 <h3>Create a flavor</h3>
188 <p>
189 Tazlito allows you to easily create your own flavor from
190 the results of generating the distribution (<code>gen-distro</code>).
191 The file will contain all the flavor's additional files,
192 a description and a list of packages which can be reused later
193 and updated according to the versions of packages. To generate
194 your own flavor responding to one or two questions:
195 </p>
196 <pre>
197 # tazlito gen-flavor new-flavor
198 </pre>
199 <p>
200 Once your flavor is fully functioning and well tested, you
201 can send it to slitaz.org to make it available to all and sundry,
202 listed via <code>list-flavor</code> and usable via <code>get-flavor</code>. To send
203 a flavor you have several means, announce through the mailing list,
204 save the file online and report on the forum or send by mail
205 to a contributor of the project.
206 </p>
208 <a name="addfiles"></a>
209 <h3>Additional files</h3>
210 <p>
211 The files containing flavors usually have additional files
212 copied directly into the filesystem or the root of the cdrom.
213 The path to the files used is specified in the configuration
214 file <code>tazlito.conf</code> - by default the files are
215 located in <code>/home/slitaz/distro/addfiles</code>. The additional files
216 the core flavor provides are for example, the window manager
217 JWM and some wallpapers. It is easy enough to modify, add
218 or delete files in the root filesystem (<code>rootfs</code>) or the root
219 of the CD (<code>rootcd</code>) and regenerate the distribution.
220 To clean and regenerate the distribution:
221 </p>
222 <pre>
223 # tazlito clean-distro
224 # tazlito gen-distro
225 </pre>
227 <a name="pkgs"></a>
228 <h3>Packages used</h3>
229 <p>
230 To create your distro you need SliTaz packages. Tazlito and
231 Tazpkg allow us to recreate packages from a SliTaz system
232 in operation or to download packages directly depending on
233 the flavor chosen. By default, SliTaz packages are located
234 in the directory <code>/home/slitaz/packages</code>, but you can change
235 this via the Tazlito configuration file (tazlito.conf).
236 </p>
237 <p>
238 If you want to retrieve packages manually, you can use
239 FTP software such as gFTP (installed by default on SliTaz)
240 or the command line and <code>wget</code> to download official packages.
241 The direct URL to package versions:
242 <a href="ftp://download.tuxfamily.org/slitaz/packages/"
243 >ftp://download.tuxfamily.org/slitaz/packages/</a>
244 </p>
245 <p>
246 You can also use your own packages by putting them in the
247 packages directory. If you are looking for documentation
248 about the creation of SliTaz packages, you can refer to the
249 <a href="../cookbook/">Cookbook</a>.
250 </p>
252 <a name="configure"></a>
253 <h3>Configuration file</h3>
254 <p>
255 By default, Tazlito uses the system configuration file
256 <code>/etc/tazlito/tazlito.conf</code> or the <code>tazlito.conf</code>
257 located in the current directory. This means that you can use the default
258 file or a configuration file specific to the distro you want to
259 create. This file can change the name of the ISO image, the
260 name of the maintainer and the paths to the working
261 directories. To create and configure your own configuration
262 file, you just need to run Tazlito with the <code>configure</code>
263 command from the working directory of the distro.
264 Assuming you have the tree of the distro in <code>/home/slitaz/distro</code>
265 and you're located within:
266 </p>
267 <pre>
268 $ tazlito configure
269 </pre>
270 <p>
271 Once you've answered the questions, you can either
272 create the ISO image, rebuild the root filesystem and ISO or
273 generate a new distro with the list of packages.
274 </p>
276 <!-- End of content -->
277 </div>
279 <!-- Footer. -->
280 <div id="footer">
281 <div class="footer-right"></div>
282 <a href="#top">Top of the page</a> |
283 <a href="index.html">Table of contents</a>
284 </div>
286 <div id="copy">
287 Copyright © 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
288 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
289 Documentation is under
290 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
291 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
292 </div>
294 </body>
295 </html>