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