tazinst annotate doc/tazinst.fr.html @ rev 110

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