tazinst view doc/tazinst.fr.html @ rev 0
Initial commit: copying files from slitaz-tools and tazpanel.
| author | Dominique Corbex <domcox@slitaz.org> |
|---|---|
| date | Thu Feb 14 12:48:04 2013 +0100 (2013-02-14) |
| parents | |
| children | 256a06ea3d55 |
line source
1 <!DOCTYPE html>
2 <html xmlns="http://www.w3.org/1999/xhtml">
3 <head>
4 <title>Tazinst Manual - Manuel de l'installateur 'tazinst'</title>
5 <meta charset="utf-8" />
6 <link rel="shortcut icon" href="favicon.ico" />
7 <link rel="stylesheet" type="text/css" href="style.css" />
8 </head>
9 <body>
11 <!-- Header -->
12 <div id="header">
13 <h1>Manuel de Tazinst</h1>
14 </div>
16 <!-- Start content -->
17 <div id="content">
19 <h2>NOM</h2>
20 <p>
21 Tazinst - Tiny autonomous zone installer manager
22 </p>
24 <h2>SYNTAXE</h2>
25 <pre>
26 tazinst [commande] [option]
27 </pre>
29 <h2>DESCRIPTION</h2>
30 <p>
31 Tazinst est l'installateur ultra léger (~31 Ko) de SliTaz sur disque dur.
32 Il permet d'installer SliTaz au choix à partir du Live-CD, d'une clé
33 LiveUSB, d'une image ISO de SliTaz, ou depuis le web en téléchargeant la
34 version stable, la version cooking ou en donnant le lien http d'une autre
35 iso (ex: iso de developpement).
36 </p>
37 <p>
38 Tazinst permet de formatter la partition cible aux formats de base ext2,
39 ext3, ext4 ou d'autres formats si les paquets correspondants ont été
40 installés. La partition /home peut être installée sur une autre partition,
41 et si besoin être formattée avant l'installation dans un des formats
42 disponibles. Tazinst peut, à la demande, installer le chargeur de démarrage
43 Grub dans le mbr du disque cible. Un dual-boot avec une partition Windows©
44 existante est possible, la recherche de la partition Windows© étant soit
45 automatique, soit précisée manuellement.
46 </p>
47 <p>
48 Tazinst permet également la mise à jour de SliTaz déjà installé sur une
49 partition du disque dur, ce qui est pratique en cas de changement de
50 version. Dans ce cas, Slitaz est mis à jour, les données présentes dans
51 /home sont préservées, et les paquets supplémentaires sont réinstallés
52 dans la nouvelle version.
53 </p>
54 <p>
55 Tazinst a été créé pour les besoins de SliTaz GNU/Linux, mini distribution
56 autonome.
57 </p>
58 <p>
59 Tazinst, écrit en script shell à partir de zéro est compatible Bash, et
60 fonctionne avec Ash du projet Busybox. Tazinst est distribué sous license
61 libre GNU gpl v3.
62 </p>
64 <h2>FICHIER DE PARAMÈTRES</h2>
65 <p>
66 L'installateur Tazinst permet de réaliser une installation automatiquement
67 à l'aide d'un simple fichier de paramètres contenant des variables
68 significatives telles que :
69 <code>INST_TYPE="iso"</code>, <code>TGT_PARTITION="/dev/hda1"</code>.
71 De cette manière, cela permet aux développeurs de créer différents types de
72 frontend : Dialog, GTK et CGI/web dans TazPanel. Le frontend doit juste
73 créer un fichier de paramètres, puis lancer tazinst en ligne de commande et
74 afficher un rapport d'avancement des différentes étapes (Jauges et/ou
75 messages).
76 </p>
77 <p>
78 Le fichier de paramètres contient les variables suivantes :
79 </p>
80 <ul>
81 <li class="level1"><div class="li">
82 Les variables décrivant la source d'installation :
84 <ol>
85 <li class="level1"><div class="li">
86 <strong>*INST_TYPE</strong> : le type du support contenant les fichiers
87 sources de SliTaz, au choix : <strong>cdrom</strong> (LiveCD de SliTaz),
88 <strong>usb</strong> (LiveUSB de SliTaz), <strong>iso</strong> (Image ISO
89 de SliTaz), <strong>web</strong> (Image ISO sur le Web),
90 <strong>weboot</strong>,
91 ex : <code>INST_TYPE=web</code>
92 </div></li>
93 <li class="level1"><div class="li">
94 <strong>*SRC_FILE</strong> : le nom de la source contenant SliTaz. Il dépend
95 du type de support :
96 <ul>
97 <li class="level2"><div class="li">cdrom (LiveCD de SliTaz) :
98 <i>inutilisé</i>
99 </div></li>
100 <li class="level2"><div class="li">usb (LiveUSB de SliTaz) : Nom de la
101 partition hôte de périphérique USB, ex : <code>SRC_FILE=/dev/sdb1</code>
102 </div></li>
103 <li class="level2"><div class="li">iso (Image ISO de SliTaz) : Nom du
104 fichier ISO, ex : <code>SRC_FILE=~/slitaz.3.0.iso</code>
105 </div></li>
106 <li class="level2"><div class="li">web (Image ISO sur le Web) : Nom de
107 l'URL, ex : <code>
108 SRC_FILE=http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso</code>.
109 À noter que 3 URL sont prédéfinies : 'stable', 'cooking, 'rolling', ex :
110 <code>SRC_FILE=cooking</code> téléchargera la dernière cooking disponible
111 sur le web
112 </div></li>
113 <li class="level2"><div class="li">weboot : <i>inutilisé</i>
114 </div></li>
115 </ul>
116 </div></li>
117 </ol>
118 </div></li>
119 </ul>
121 <ul>
122 <li class="level1"><div class="li"> Les variables décrivant la partition
123 cible :
125 <ol>
126 <li class="level1"><div class="li">
127 <strong>*TGT_PARTITION</strong> : Le nom de la partition cible sur laquelle
128 SliTaz sera installé ou mis à jour,
129 ex : <code>TGT_PARTITION=/dev/hda3</code>
130 </div></li>
131 <li class="level1"><div class="li">
132 <strong>TGT_FS</strong> : Si cette variable est renseignée, la partition
133 cible sera formatée dans le système de fichiers indiqué, sinon, la partition
134 sera nettoyée et le répertoire /home sera conservé,
135 ex : <code>TGT_FS=ext3</code>
136 </div></li>
137 <li class="level1"><div class="li">
138 <strong>TGT_HOME</strong> : Cette variable indique, si besoin est, le nom de
139 la partition recevant le répertoire /home,
140 ex : <code>TGT_HOME=/dev/hda5</code>
141 </div></li>
142 <li class="level1"><div class="li">
143 <strong>TGT_HOME_FS</strong> : Si cette variable est renseignée, la
144 partition /home sera formatée dans le système de fichiers indiqué,
145 ex : <code>TGT_HOME_FS=ext2</code>
146 </div></li>
147 </ol>
148 </div></li>
149 </ul>
151 <ul>
152 <li class="level1"><div class="li"> Les paramètres du système :
154 <ol>
155 <li class="level1"><div class="li">
156 <strong>TGT_HOSTNAME</strong> : Nom du système,
157 ex : <code>TGT_HOSTNAME=hd-slitaz</code>, par défaut
158 <code>TGT_HOSTNAME=slitaz</code>
159 </div></li>
160 <li class="level1"><div class="li">
161 <strong>TGT_ROOT_PWD</strong> : Mot de passe du super-utilisateur,
162 ex : <code>TGT_ROOT_PWD=toor</code>, par défaut
163 <code>TGT_ROOT_PWD=root</code>
164 </div></li>
165 <li class="level1"><div class="li">
166 <strong>TGT_USER</strong> : Nom de l'utitisateur par défaut,
167 ex : <code>TGT_USER=toto</code>, par défaut
168 <code>TGT_USER=tux</code>
169 </div></li>
170 <li class="level1"><div class="li">
171 <strong>TGT_USER_PWD</strong> : Mot de passe de l'utilisateur par défaut,
172 ex : <code>TGT_USER_PWD=titi</code>, par défaut
173 <code>TGT_USER_PWD=tux</code>
174 </div></li>
175 </ol>
176 </div></li>
177 </ul>
179 <ul>
180 <li class="level1"><div class="li"> Les variables de configuration du chargeur
181 de démarrage (bootloader) :
183 <ol>
184 <li class="level1"><div class="li">
185 <strong>TGT_GRUB</strong> : Installation de GRUB (yes ou no),
186 ex : <code>TGT_GRUB=yes</code>, par défaut <code>TGT_GRUB=no</code>
187 </div></li>
188 <li class="level1"><div class="li">
189 <strong>TGT_WINBOOT</strong> : Si cette variable est renseignée, elle
190 indique la partition contenant Windows© pour mettre en place un Dual-boot.
191 Elle peut être aussi positionnée à 'auto', dans ce cas le dual-boot se
192 fera sur la première partition Windows© détectée,
193 ex : <code>TGT_WINBOOT=auto</code>
194 </div></li>
195 </ol>
196 </div></li>
197 </ul>
199 <p>
200 À noter que seules les variables précédées d'une atérisque sont
201 obligatoires, les autres sont optionnelles. Ainsi un fichier de
202 paramètres minimaliste peut être le suivant:
203 </p>
204 <pre>
205 INST_TYPE=cdrom
206 TGT_PARTITION=/dev/hda3
207 </pre>
208 <p>
209 Ce fichier permettra une installation de SliTaz sur /dev/hda3, sans
210 formatter la partition, à partir d'un LiveCD.
211 </p>
213 <h2>COMMANDES</h2>
215 <a id="new"></a>
216 <h3>new</h3>
217 <p>
218 Génère un fichier de paramètres autodocumenté, qui une fois édité
219 suivant les besoins de l'utilisateur, permettra d'installer ou mettre
220 à jour SliTaz sur disque dur.
221 </p>
222 <pre>
223 tazinst new /var/lib/tazinst.conf
224 </pre>
226 <a id="install"></a>
227 <h3>install</h3>
228 <p>
229 Lance l'installation de SliTaz en fonction des données présentes dans le
230 fichier de paramètres. Si le formattage de la partition est demandé,
231 toutes les données seront perdues. Si le disque n'est pas formatté, toutes
232 les données sauf un répertoire /home existant seront effacées, ce répertoire
233 /home sera gardé tel quel.
234 </p>
235 <pre>
236 tazinst install /var/lib/tazinst.conf
237 </pre>
239 <a id="upgrade"></a>
240 <h3>upgrade</h3>
241 <p>
242 Lance la mise à jour de SliTaz en fonction des données présentes dans le
243 fichier de paramètres. Les répertoires /home /etc /var/www seront
244 conservés, tous les autres répertoires seront supprimés. Tout paquet ajouté
245 à la configuration de votre ancien système SliTaz sera mis à jour à la
246 condition qu'une connexion internet soit active.
247 </p>
248 <pre>
249 tazinst upgrade /var/lib/tazinst.conf
250 </pre>
252 <a id="showurl"></a>
253 <h3>showurl</h3>
254 <p>
255 Affiche l'URL complète des raccourcis prédéfinis : 'stable', 'cooking,
256 'rolling'.
257 </p>
258 <p>
259 Note: Vous pouvez redéfinir ces raccourcis dans le fichier système :
260 /etc/slitaz/tazinst.conf.
261 </p>
262 <pre>
263 tazinst showurl stable
264 </pre>
266 <a id="check"></a>
267 <h3>check</h3>
268 <p>
269 Vérifie que le fichier de paramètres ne contient pas d'erreurs.
270 </p>
271 <pre>
272 tazinst check /var/lib/tazinst.conf
273 </pre>
275 <a id="log"></a>
276 <h3>log</h3>
277 <p>
278 Affiche le contenu du fichier journal.
279 </p>
280 <pre>
281 tazinst log
282 </pre>
284 <a id="version"></a>
285 <h3>version</h3>
286 <p>
287 Affiche les informations de version.
288 </p>
289 <pre>
290 tazinst version
291 </pre>
293 <h2>FICHIER SYSTÈME DE CONFIGURATION</h2>
294 <p>
295 Le fichier système de configuration /etc/slitaz/tazinst.conf permet de
296 changer les paramètres par défaut de tazinst. Pour utiliser des valeurs
297 personnalisées pour les URL, répertoires et fichiers, ce fichier doit être
298 créé et les variables suivantes modifiées :
299 </p>
301 <ul>
302 <li class="level1"><div class="li">URLs prédéfinies :
304 <ol>
305 <li class="level1"><div class="li">URL de la version stable actuelle :<br />
306 <code>URL_STABLE="http://mirror.slitaz.org/iso/stable/slitaz-4.0.iso"
307 </code>
308 </div></li>
309 <li class="level1"><div class="li">URL de la version cooking :<br />
310 <code>URL_COOKING="http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso"
311 </code>
312 </div></li>
313 <li class="level1"><div class="li">URL de la version rolling :<br />
314 <code>URL_ROLLING="http://mirror.slitaz.org/iso/rolling/slitaz-core.iso"
315 </code>
316 </div></li>
317 </ol>
318 </div></li>
319 </ul>
321 <ul>
322 <li class="level1"><div class="li">Points de montage :
324 <ol>
325 <li class="level1"><div class="li">
326 Point de montage de la partition Source :<br />
327 <code>SOURCE_ROOT="/media/source"</code>
328 </div></li>
329 <li class="level1"><div class="li">
330 Point de montage de la partition Cible :<br />
331 <code>TARGET_ROOT="/mnt/target"</code>
332 </div></li>
333 </ol>
334 </div></li>
335 </ul>
337 <ul>
338 <li class="level1"><div class="li">Debug et journal :
340 <ol>
341 <li class="level1"><div class="li">Emplacement du fichier journal :<br />
342 <code>LOG="/var/log/tazinst.log"</code>
343 </div></li>
344 <li class="level1"><div class="li">Debugging: (non => 0, debug => 1)<br />
345 <code>DEBUG=0</code><br />
346 Il est chaudement recommandé de définir <code>DEBUG=1</code> et de
347 joindre le fichier journal resultant lors de l'envoi d'un rapport de
348 bogue aux développeurs.
349 </div></li>
350 </ol>
351 </div></li>
352 </ul>
354 <h2>MAINTENEURS</h2>
355 <p>
356 Christophe Lincoln <pankso at slitaz.org> <br />
357 Dominique Corbex <domcox at slitaz.org>
358 </p>
360 <!-- End of content -->
361 </div>
363 <div id="footer">
364 Copyright © 2012 <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a>
365 </div>
367 </body>
368 </html>