website view en/doc/handbook/gen-livecd.html @ rev 72
en: Add new LiveCD page to Hbk
| author | Paul Issott <paul@slitaz.org> |
|---|---|
| date | Sun Jun 22 11:21:54 2008 +0000 (2008-06-22) |
| parents | 50e15b2b22ac |
| children | 9e30e64c8198 |
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-02-26 18:30: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 you 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 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 burnt 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 advisible 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 provides several possibilities, such as burning the
180 ISO or copying additional files in the system or directly
181 on to the cdrom.
182 </p>
184 <a name="gen-flavor"></a>
185 <h3>Create a flavor</h3>
186 <p>
187 Tazlito allows you to easily create your own flavor from
188 the results of manufacturing the distribution (<code>gen-distro</code>).
189 The file will contain all the flavor's additional files,
190 a description and a list of packages which can be reused later
191 and updated according to the versions of packages. To generate
192 you own flavor responding to one or two questions:
193 </p>
194 <pre>
195 # tazlito gen-flavor new-flavor
196 </pre>
197 <p>
198 Once your flavor is fully functioning and well tested, you
199 can send it to slitaz.org to make it available to all and sundry,
200 listed via <code>list-flavor</code> and usable via <code>get-flavor</code>. To send
201 a flavor you have several means, announce through the mailing list,
202 save the file online and report on the forum or send by mail
203 to a contributor of the project.
204 </p>
206 <a name="addfiles"></a>
207 <h3>Additional files</h3>
208 <p>
209 The files containing flavors usually have additional files
210 copied directly into the filesystem or the root of the cdrom.
211 The path to the files used is specified in the configuration
212 file <code>tazlito.conf</code> - by default the files are
213 located in <code>/home/slitaz/distro/addfiles</code>. The additional files
214 the core flavor provides are for example the window manager
215 JWM and some wallpapers. It is easy enough to modify, add
216 or delete files in the root filesystem (<code>rootfs</code>) or the root
217 of the CD (<code>rootcd</code>) and regenerate the distribution.
218 To clean and regenerate the distribution:
219 </p>
220 <pre>
221 # tazlito clean-distro
222 # tazlito gen-distro
223 </pre>
225 <a name="pkgs"></a>
226 <h3>Packages used</h3>
227 <p>
228 To create your distro you need SliTaz packages. Tazlito and
229 Tazpkg allow us to recreate packages from a SliTaz system
230 in operation or to download packages directly depending on
231 the flavor chosen. By default, SliTaz packages are located
232 in the directory <code>/home/slitaz/packages</code>, but you can change
233 this via the Tazlito configuration file (tazlito.conf).
234 </p>
235 <p>
236 If you want to retrieve packages manually, you can use
237 FTP software such as gFTP (installed by default on SliTaz)
238 or the command line and <code>wget</code> to download official packages.
239 The direct URL to package versions:
240 <a href="ftp://download.tuxfamily.org/slitaz/packages/"
241 >ftp://download.tuxfamily.org/slitaz/packages/</a>
242 </p>
243 <p>
244 You can also use your own packages by putting them in the
245 packages directory. If you are looking for documentation
246 about the creation of SliTaz packages, you can refer to the
247 <a href="../cookbook/">Cookbook</a>.
248 </p>
250 <a name="configure"></a>
251 <h3>Configuration file</h3>
252 <p>
253 By default, Tazlito uses the system configuration file
254 <code>/etc/tazlito/tazlito.conf</code> or the <code>tazlito.conf</code>
255 located in the current directory. This means that you can use the default
256 file or a configuration file specific to the distro you want to
257 create. This file can change the name of the ISO image, the
258 name of the maintainer and the paths to the working
259 directories. To create and configure your own configuration
260 file, you just need to run Tazlito with the <code>configure</code>
261 command from the working directory of the distro.
262 Assuming you have the tree of the distro in <code>/home/slitaz/distro</code>
263 and you're located within:
264 </p>
265 <pre>
266 $ tazlito configure
267 </pre>
268 <p>
269 Once you've answered the questions, you can either
270 create the ISO image, rebuild the root filesystem and ISO or
271 generate a new distro with the list of packages.
272 </p>
274 <!-- End of content -->
275 </div>
277 <!-- Footer. -->
278 <div id="footer">
279 <div class="footer-right"></div>
280 <a href="#top">Top of the page</a> |
281 <a href="index.html">Table of contents</a>
282 </div>
284 <div id="copy">
285 Copyright © 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
286 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
287 Documentation is under
288 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
289 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
290 </div>
292 </body>
293 </html>