slitaz-tools view doc/tazinst.fr.html @ rev 656

tazinst: showurl+check commands added
author Dominique Corbex <domcox@slitaz.org>
date Mon Jul 25 12:03:18 2011 +0200 (2011-07-25)
parents
children 2b69f8b15b5a
line source
1 <!DOCTYPE html>
2 <html xmlns="http://www.w3.org/1999/xhtml">
3 <head>
4 <title>Tazinst Manual - Manuel de l'installeur '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>Tazinst Manual</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] [fichier de configuration]
27 </pre>
29 <h2>DESCRIPTION</h2>
30 <p>
31 Tazinst est l'installateur ultra léger (~29 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>COMMANDES</h2>
65 <a name="config"></a>
66 <h3>config</h3>
67 <p>
68 Génère un fichier de configuration autodocumenté, qui une fois édité
69 suivant les besoins de l'utilisateur, permettra d'installer ou mettre
70 à jour SliTaz sur disque dur, en utilisant <code>tazinst install
71 [nom du fichier]</code>.
72 </p>
73 <pre>
74 tazinst config /var/lib/tazinst.conf
75 </pre>
77 <p>
78 Le fichier de configuration contient les variables suivantes :
79 </p>
80 <ul>
81 <li>Les variables décrivant la source d'installation :</li>
82 </ul>
84 <ol>
85 <li class="level1"><div class="li"> * INST_TYPE : le type du support contenant
86 les fichiers sources de SliTaz, au choix : cdrom (LiveCD de SliTaz), usb
87 (LiveUSB de SliTaz), iso (Image ISO de SliTaz), web (Image ISO sur le Web),
88 weboot, ex : <code>INST_TYPE=web</code></div>
89 </li>
90 <li class="level1"><div class="li"> * SRC_FILE : le nom de la source contenant
91 SliTaz. Il dépend du type de support :
92 <ul>
93 <li class="level2"><div class="li">cdrom (LiveCD de SliTaz) :
94 <i>inutilisé</i></div>
95 </li>
96 <li class="level2"><div class="li">usb (LiveUSB de SliTaz) : Nom de la
97 partition hôte de périphérique USB, ex : <code>SRC_FILE=/dev/sdb1</code>
98 </div>
99 </li>
100 <li class="level2"><div class="li">iso (Image ISO de SliTaz) : Nom du
101 fichier ISO, ex : <code>SRC_FILE=~/slitaz.3.0.iso</code></div>
102 </li>
103 <li class="level2"><div class="li">web (Image ISO sur le Web) : Nom de
104 l'URL, ex : <code>
105 SRC_FILE=http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso</code>.
106 À noter que 3 URL sont prédéfinies : 'stable', 'cooking, 'rolling', ex :
107 <code>SRC_FILE=cooking</code> téléchargera la dernière cooking disponible
108 sur le web</div>
109 </li>
110 <li class="level2"><div class="li">weboot : <i>inutilisé</i></div></li>
111 </ul></div>
112 </li>
113 </ol>
115 <ul>
116 <li class="level1"><div class="li"> Les variables décrivant la partition
117 cible : </div>
118 </li>
119 </ul>
121 <ol>
122 <li class="level1"><div class="li"> * TGT_PARTITION : Le nom de la partition
123 cible sur laquelle SliTaz sera insallé ou mis à jour, ex : <code>TGT_PARTITION=
124 /dev/hda3</code></div>
125 </li>
126 <li class="level1"><div class="li">TGT_FS : Si cette variable est renseignée,
127 la partition cible sera formatée dans le système de fichiers indiqué, sinon,
128 la partition sera nettoyée et le répertoire /home sera conservé, ex : <code>
129 TGT_FS=ext3</code></div>
130 </li>
131 <li class="level1"><div class="li">TGT_HOME : Cette variable indique, si
132 besoin est, le nom de la partition recevant le répertoire /home, ex : <code>
133 TGT_HOME=/dev/hda5</code></div>
134 </li>
135 <li class="level1"><div class="li">TGT_HOME_FS : Si cette variable est
136 renseignée, la partition/home sera formatée dans le système de fichiers
137 indiqué, ex : <code>TGT_HOME_FS=ext2</code></div>
138 </li>
139 </ol>
141 <ul>
142 <li class="level1"><div class="li"> Les variables de configuration de Slitaz :
143 </div>
144 </li>
145 </ul>
147 <ol>
148 <li class="level1"><div class="li">TGT_HOSTNAME : Nom du système, ex : <code>
149 TGT_HOSTNAME=hd-slitaz</code>, par défaut <code>TGT_HOSTNAME=slitaz</code>
150 </div>
151 </li>
152 <li class="level1"><div class="li">TGT_ROOT_PWD : Mot de passe du super-
153 utilisateur, ex : <code>TGT_ROOT_PWD=toor</code>, par défaut <code>
154 TGT_ROOT_PWD=root</code></div>
155 </li>
156 <li class="level1"><div class="li">TGT_USER : Nom de l'utitisateur par défaut,
157 ex : <code>TGT_USER=toto</code>, par défaut <code>TGT_USER=tux</code></div>
158 </li>
159 <li class="level1"><div class="li">TGT_USER_PWD : Mot de passe de
160 l'utilisateur par défaut, ex : <code>TGT_USER_PWD=titi</code>, par défaut
161 <code>TGT_USER_PWD=tux</code></div>
162 </li>
163 </ol>
165 <ul>
166 <li class="level1"><div class="li"> Les variables de configuration du chargeur
167 de démarrage (bootloader) : </div>
168 </li>
169 </ul>
171 <ol>
172 <li>TGT_GRUB : Installation de GRUB (yes ou no), ex :
173 <code>TGT_GRUB=yes</code>, par défaut <code>TGT_GRUB=no</code>
174 </li>
175 <li class="level1"><div class="li">TGT_MENU_PARTITION: Nom de la partition
176 où le fichier de configuration de GRUB est installé. Normalement, cette
177 variable n'est pas renseignée, elle peut servir dans le cas où GRUB est
178 installé dans une partition dédiée, ou dans une configuration multi-os,
179 ex : <code>TGT_MENU_PARTITION=/dev/hda4</code></div>
180 </li>
181 <li class="level1"><div class="li">TGT_WINBOOT : Si cette variable est
182 renseignée, elle indique la partition contenant Windows© pour mettre en
183 place un Dual-boot. Elle peut être aussi positionnée à 'auto', dans ce
184 cas le dual-boot se fera sur la première partition Windows© détectée,
185 ex : <code>TGT_WINBOOT=auto</code></div>
186 </li>
187 </ol>
189 <p>
190 À noter que seules les variables précédées d'une atérisque sont
191 obligatoires, les autres sont optionnelles. Ainsi un fichier de
192 configuration minimaliste peut être le suivant:
193 </p>
194 <pre>
195 INST_TYPE=cdrom
196 TGT_PARTITION=/dev/hda3
197 </pre>
198 <p>
199 Ce fichier permettra une installation de SliTaz sur /dev/hda3, sans
200 formatter la partition, à partir d'un LiveCD.
201 </p>
203 <a name="install"></a>
204 <h3>install</h3>
205 <p>
206 Lance l'installation de SliTaz en fonction des données présentes dans le
207 fichier de configuration.
208 </p>
209 <pre>
210 tazinst install /var/lib/tazinst.conf
211 </pre>
213 <a name="upgrade"></a>
214 <h3>upgrade</h3>
215 <p>
216 Lance la mise à jour de SliTaz en fonction des données présentes dans le
217 fichier de configuration.
218 </p>
219 <pre>
220 tazinst upgrade /var/lib/tazinst.conf
221 </pre>
223 <h2>MAINTENEUR</h2>
224 <p>
225 Christophe Lincoln &lt;pankso at slitaz.org&gt;
226 Dominique Corbex &lt;domcox at slitaz.org&gt;
227 </p>
229 <!-- End of content -->
230 </div>
232 <div id="footer">
233 Copyright &copy; 2011 <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a>
234 </div>
236 </body>
237 </html>