tazinst annotate 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
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 &lt;pankso at slitaz.org&gt; <br />
domcox@0 357 Dominique Corbex &lt;domcox at slitaz.org&gt;
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 &copy; 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>