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