slitaz-tools annotate doc/tazinst.fr.html @ rev 762

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