tazinst view doc/tazinst.de.html @ rev 93
slight modifications in tazinst manual
| author | Hans-G?nter Theisgen |
|---|---|
| date | Fri Oct 06 17:15:36 2017 +0100 (2017-10-06) |
| parents | cb43e34f342f |
| children |
line source
1 <!DOCTYPE html>
2 <html lang="de">
3 <head>
4 <meta charset="UTF-8">
5 <title>Tazinst-Handbuch — Handbuch für die Installationsprozedur “tazinst”</title>
6 <link rel="shortcut icon" href="favicon.ico">
7 <link rel="stylesheet" href="../slitaz-doc.css">
8 <script src="../slitaz-doc.js"></script>
9 </head>
10 <body>
12 <header>
13 <h1>Tazinst-Handbuch</h1>
14 </header>
16 <!-- Start content -->
17 <div id="content">
19 <h2>NAME</h2>
21 <p>Tazinst — "Tiny autonomous zone installer manager"</p>
23 <h2>SYNTAX</h2>
25 <pre>
26 tazinst [command] <setting> <value> <file>
27 </pre>
29 <h2>BESCHREIBUNG</h2>
31 <p>Tazinst ist eine ressourcenschonende Installationsprozedur, die SliTaz auf einer Platte installiert.
32 Das Installationsmedium kann ein lokaler Datenträger wie ein optischer Direktstart-Datentrager,
33 ein USB-Direktstart-Datenträger oder ein ISO-Abbild auf einer Platte sein oder es kann durch Transferieren eines SliTaz-ISO-Abbilds
34 über das Netzwerk installiert werden.</p>
35 <p>Tazinst kann die Zielpartition mit den Dateisystemformaten ext2, ext3 oder ext4 einrichten. Wenn gewünscht,
36 kann das Verzeichnis /home in einer eigenen Partition mit einem der verfügbaren Dateisystemformate eingerichtet
37 werden. Tazinst kann auch einen Urlader ("bootloader") auf der Ziel-Partition installieren. Auch eine
38 Installation neben einer vorhandenen Windows™-Partition zum alternativen Laden ("dual boot") ist möglich, wobei die
39 Windows™-Partition automatisch gefunden oder manuell spezifiziert werden kann.</p>
40 <p>Tazinst kann auch ein SliTaz aktualisieren, das in einer Partition einer Platte installiert ist; dies kann
41 für einen Versionswechsel nützlich sein. In diesem Fall wird nur SliTaz aktualisiert, alle Dateien im Verzeichnis
42 /home werden beibehalten. Zusätzlich installierte Pakete werden nach der SliTaz-Aktualisierung ebenfalls aktualisiert.</p>
43 <p>Tazinst wurde eigens für die Bedürfnisse der "SliTaz GNU/Linux mini"-Distribution entwickelt.</p>
44 <p>Tazinst wurde von Grund auf als Kommandoprozedur ("shell script") geschrieben und ist mit "Busybox Ash" und "Bash"
45 kompatibel. Tazinst ist unter "GNU Free GPL v3" lizensiert.</p>
48 <h3>Bekannte Einschränkungen</h3>
50 <p>Mit Tazinst installierte SliTaz-Systeme können nicht mit (U)EFI (hauptsächlich auf Windows™ 8 Rechnern) geladen
51 werden, es sei denn im BIOS-Kompatibilitätsmodus.</p>
54 <h2>EINSTELLUNGEN</h2>
56 <p>Das Tazinst-Installationsprogramm kann eine Installation automatisiert ausführen, wenn zuvor einige Einstellungen
57 vorgenommen wurden.</p>
60 <h3 id="mode">mode</h3>
62 <p>Der Installationsmodus in dem tazinst ablaufen soll. Mit <code>tazinst help mode</code>
63 erhält man eine Liste der unterstützten Modi.</p>
66 <h3 id="media">media</h3>
68 <p>Das Medium, das die SliTaz-Quelldateien enthält, entweder
69 <strong>cdrom</strong> (optischer SliTaz-Direktstart-Datenträger),
70 <strong>usb</strong> (SliTaz-USB-Direktstart-Datenträger),
71 <strong>iso</strong> (ISO-Abbild von SliTaz), or
72 <strong>web</strong> (ISO-Abbild über Netzwerk).</p>
75 <h3 id="source">source</h3>
77 <p>Der Name der Quelldatei die SliTaz enthält, abhängig vom Typ von <strong>media</strong>:</p>
79 <table>
80 <tr>
81 <td>cdrom:</td>
82 <td><i>nicht verwendet</i></td>
83 </tr>
84 <tr> <td valign="top">usb:</td>
85 <td>Name der Partition auf dem Medium in dem USB-Gerät. Mit <code>tazinst list usb</code>
86 erhält man eine Liste der Partitionen des Mediums in dem USB-Gerät.</td>
87 </tr>
88 <tr>
89 <td valign="top">iso:</td>
90 <td>Name des ISO-Abbilds, z.B.: <code>~/slitaz-rolling.iso</code>. Mit <code>tazinst list iso</code>
91 erhält man eine Liste der ISO-Abbilder auf den Platten.</td>
92 </tr>
93 <tr>
94 <td valign="top">web:</td>
95 <td>Name des ISO-Abbilds im Netzwerk, z.B.:
96 <code>stable, cooking, rolling, base, core, gtkonly, justx</code>.
97 Mit <code>tazinst list web</code> erhält man eine Liste der über das Netzwerk zugreifbaren ISO-Abbilder.
98 Man kann auch den vollständigen URL des ISO-Abbilds angeben, z.B.:
99 <code>http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso</code>. </td>
100 </tr>
101 </table>
104 <h3 id="root_uuid">root_uuid</h3>
106 <p>Die Bezeichnung der Ziel-Partition, in der SliTaz installiert werden soll.
107 Mit <code>tazinst list uuid</code> erhält man eine Liste der Partitionen auf den Platten.</p>
110 <h3 id="root_format">root_format</h3>
112 <p>Optional. Wenn angegeben, wird die Ziel-Partition mit dem spezifizierten Dateisystem formatiert,
113 sonst werden alle Dateien der Partition gelöscht mit Ausnahme derer im Verzeichnis /home.
114 Mit <code>tazinst help format</code> erhält man eine Liste aller unterstützten Dateisysteme.
115 <code>tazinst list root_format</code> zeigt die bereits installierten Dateisysteme auf den Platten.</p>
118 <h3 id="home_uuid">home_uuid</h3>
120 <p>Optional. Damit kann das Verzeichnis /home in einer separaten Partition angelegt werden.
121 Es ist die Bezeichnung der Partition anzugeben, die das Verzeichnis /home aufnehmen soll.</p>
124 <h3 id="home_format">home_format</h3>
126 <p>Optional. Damit wird bewirkt, dass die Partition, die das Verzeichnis /home aufnehmen soll,
127 mit dem angegebenen Dateisystem formatiert wird.</p>
130 <h3 id="hostname">hostname</h3>
132 <p>Optional. Name ("hostname") des zu installierenden Systems;
133 das ist <code>slitaz</code>, wenn nicht anders angegeben.</p>
136 <h3 id="root_pwd">root_pwd</h3>
138 <p>Optional. Kennwort des privilegierten Benutzers [root];
139 das ist <code>root</code>, wenn nicht anders angegeben.</p>
141 <h3 id="user_login">user_login</h3>
143 <p>Optional. Name eines ersten nichtprivilegierten Benutzers;
144 das ist <code>tux</code>, wenn nicht anders angegeben.</p>
146 <h3 id="user_pwd">user_pwd</h3>
148 <p>Optional. Kennwort des ersten nichtprivilegierten Benutzers;
149 das ist <code>tux</code>, wenn nicht anders angegeben.</p>
152 <h3 id="bootloader">bootloader</h3>
154 <p>Optional. Es soll ein Urlader ("bootloader") installiert werden. Hier sollte <code>auto</code> angegeben werden,
155 ausser wenn ein bereits (in einer anderen Partition) installierter Urlader verwendet werden soll,
156 ein Urlader manuell oder ein bestimmter Urlader installiert werden soll.
157 Mit <code>tazinst help bootloader</code> erhält man eine Liste der unterstützten Urlader.</p>
160 <h3 id="winboot">winboot</h3>
162 <p>Optional. Wenn ein Urlader ("bootloader") installiert wird, wird hiermit bestimmt,
163 dass alternatives Laden von Windows™ ("dual boot") von einer anzugebenden Partition ermöglicht werden soll.
164 Ist <code>auto</code> angegeben, wird die erste Partition ausgewählt, die ein ladefähiges Windows™ enthält.
165 Mit <code>tazinst list winboot</code> kann man feststellen,
166 welche Windows™-Partitionen <code>tazinst</code> automatisch findet.</p>
169 <h2>KOMMANDOS</h2>
171 <h3 id="new">new</h3>
173 <p>Es wird eine Datei mit Installations-Einstellungen nach den Anforderungen des Benutzers erstellt,
174 die in sich dokumentiert ist und mithilfe derer tazinst eine automatisierte Installation durchführen kann.
175 Der Standardname der Datei ist <code>./tazinst.rc</code>;
176 optional kann ein anderer Dateiname als Parameter angegeben werden.</p>
178 <h5>Beispiele:</h5>
180 <code>
181 tazinst new<br>
182 tazinst new /var/lib/tazinst.conf
183 </code>
186 <h3 id="set">set</h3>
188 <p>Einer Einstellung wird ein neuer Wert zugewiesen.</p>
190 <h5>Beispiele:</h5>
192 <code>
193 tazinst set mode install<br>
194 tazinst set mode install /var/lib/tazinst.conf
195 </code>
197 <h3 id="unset">unset</h3>
199 <p>Der Wert einer Einstellung wird gelöscht.</p>
201 <h5>Beispiele:</h5>
203 <code>
204 tazinst unset mode<br>
205 tazinst unset mode /var/lib/tazinst.conf
206 </code>
208 <h3 id="get">get</h3>
210 <p>Der Wert einer Einstellung wird angezeigt. Ohne Parameter wird der Wert aller Einstellungen angezeigt.</p>
212 <h5>Beispiele:</h5>
214 <code>
215 tazinst get<br>
216 tazinst get mode<br>
217 tazinst get mode /var/lib/tazinst.conf
218 </code>
221 <h3 id="check">check</h3>
223 <p>Eine Einstellung wird auf Fehler geprüft. Ohne Parameter werden alle Einstellungen geprüft.</p>
225 <h5>Beispiele:</h5>
227 <code>
228 tazinst check<br>
229 tazinst check mode<br>
230 tazinst check mode /var/lib/tazinst.conf
231 </code>
234 <h3 id="list">list</h3>
236 <p>Es werden die Betriebsmittel angezeigt. Betriebsmittel sind:</p>
238 <table>
239 <tr>
240 <td>mode</td>
241 <td>Verfügbare Installationsmodi</td>
242 </tr>
243 <tr>
244 <td valign="top">media</td>
245 <td>Verfügbare Installationsmedien. Beispiel: cdrom wird an Rechnern ohne optische Laufwerke nicht angezeigt</td>
246 </tr>
247 <tr>
248 <td>usb</td>
249 <td>Partitionen eines Mediums in einem USB-Laufwerk</td>
250 </tr>
251 <tr>
252 <td valign="top">iso</td>
253 <td>ISO-Abbilder auf lokalen Laufwerken, im Verzeichnis /root und
254 im Stammverzeichnis aller Benutzer und deren ersten Unterverzeichnissen</td>
255 </tr>
256 <tr>
257 <td valign="top">web</td>
258 <td>Vordefinierte Namen von ISO-Abbildern zum impliziten Transferieren über das Internet</td>
259 </tr>
260 <tr>
261 <td>format</td>
262 <td>Installierte Dateisystemformate</td>
263 </tr>
264 <tr>
265 <td>bootloader</td>
266 <td>Verfügbare Urlader ("bootloader")</td>
267 </tr>
268 <tr>
269 <td>partition_table</td>
270 <td>Partitionstabellen lokaler Platten</td>
271 </tr>
272 <tr>
273 <td>winboot</td>
274 <td>Ladbare Windows™-Partitionen</td>
275 </tr>
276 </table>
278 <h5>Beispiele:</h5>
280 <code>
281 tazinst list<br>
282 tazinst list media
283 </code>
286 <h3 id="execute">execute</h3>
288 <p>SliTaz wird nach den Angaben in der Installationsdatei auf Platte installiert.
289 Dabei gehen alle Daten auf der Platte verloren, wenn Formatierung der Platte ausgewählt wurde.
290 Andernfalls werden alle Dateien bis auf die im Verzeichnis <code>/home</code> gelöscht;
291 das Verzeichnis <code>/home</code> bleibt dann unverändert erhalten.</p>
293 <h5>Beispiele:</h5>
295 <code>
296 tazinst execute<br>
297 tazinst execute /var/lib/tazinst.conf
298 </code>
301 <h3 id="clean">clean</h3>
303 <p>Es werden die Installations- und Protokoll-Dateien gelöscht.</p>
305 <h5>Beispiele:</h5>
307 <code>
308 tazinst clean<br>
309 tazinst clean /var/lib/tazinst.conf
310 </code>
313 <h3 id="log">log</h3>
315 <p>Es wird der Inhalt der letzten Protokoll-Datei angezeigt und die Verarbeitung beendet.</p>
317 <h5>Beispiel:</h5>
319 <code>
320 tazinst log
321 </code>
324 <h3 id="version">version</h3>
326 <p>Es wird die Versionsinformation angezeigt und die Verarbeitung beendet.</p>
328 <h5>Beispiel:</h5>
330 <code>
331 tazinst version
332 </code>
335 <h3 id="usage">usage</h3>
337 <p>Es wird eine kurze Anwendungshilfe angezeigt und die Verarbeitung beendet.</p>
339 <h5>Beispiel:</h5>
341 <code>
342 tazinst usage
343 </code>
346 <h3 id="help">help</h3>
348 <p>Es wird eine kurze Anwendungshilfe für eine Einstellung angezeigt und die Verarbeitung beendet.
349 Ohne Parameter wird eine kurze Anwendungshilfe für alle Einstellungen angezeigt.</p>
351 <h5>Beispiel:</h5>
353 <code>
354 tazinst help mode
355 </code>
358 <h2>BEISPIELE</h2>
360 <h3>Installation</h3>
362 <p>Installation von SliTaz in einer Partition einer Platte.
363 Die Wurzel-Partition wird nicht formatiert, alle Dateien ausser
364 in einem vorhandenen Verzeichnis <code>/home</code> werden gelöscht;
365 das Verzeichnis <code>/home</code> bleibt unverändert erhalten.</p>
367 <ol>
368 <li>Es soll eine neue Installationsdatei mit Standardnamen erzeugt werden:
369 <pre># tazinst new</pre></li>
370 <li>Der Modus wird auf <code>install</code> gesetzt:
371 <pre># tazinst set mode install</pre></li>
372 <li>Als Installationsmedium soll ein optischer Datenträger verwendet werden:
373 <pre># tazinst set media cdrom</pre></li>
374 <li>SliTaz soll in der Partition <code>/dev/hda1</code> installiert werden:
375 <pre># tazinst set root_uuid /dev/hda1</pre></li>
376 <li>Es soll ein Urlader installiert werden:
377 <pre># tazinst set bootloader auto</pre></li>
378 <li>Die Installation wird gestartet:
379 <pre># tazinst execute</pre></li>
380 </ol>
383 <h3>Komplexe Installation</h3>
385 <p>Installation von SliTaz auf Platte, wobei das Verzeichnis <code>/home</code>
386 in einer eigenen Partition angelegt werden soll und alternativ Windows™
387 von einer anderen Partition geladen werden können soll ("dual boot").
388 Die Partitionen für das Wurzeldateisystem und für das Verzeichnis <code>/home</code>
389 werden beide formatiert, sodass alle dort vorhandenen Daten verloren gehen.</p>
391 <ol>
392 <li>Es soll eine neue Installationsdatei mit Standardnamen erzeugt werden:
393 <pre># tazinst new</pre></li>
394 <li>Der Modus wird auf <code>install</code> gesetzt:
395 <pre># tazinst set mode install</pre></li>
396 <li>Als Installationsmedium soll ein Direktstart-Datenträger in einem USB-Gerät verwendet werden:
397 <pre># tazinst set media usb</pre></li>
398 <li>Es soll die Partition 1 auf dem USB-Datenträger als Installationsquelle verwendet werden:
399 <pre># tazinst set source /dev/sda1</pre></li>
400 <li>SliTaz soll in der Partition <code>/dev/hda1</code> installiert werden:
401 <pre># tazinst set root_uuid /dev/hda1</pre></li>
402 <li>Die Partition für das Wurzeldateisystem soll mit einem Dateisystem vom Typ ext4 formatiert werden:
403 <pre># tazinst set root_format ext4</pre></li>
404 <li>Das Verzeichnis <code>/home</code> soll in einer eigenen Partition <code>/dev/hda2</code> angelegt werden:
405 <pre># tazinst set home_uuid /dev/hda2</pre></li>
406 <li>Die Partition für das Verzeichnis <code>/home</code> soll mit einem Dateisystem vom Typ ext2 formatiert werden:
407 <pre># tazinst set home_format ext2</pre></li>
408 <li>Es soll ein Urlader ("bootloader") installiert werden:
409 <pre># tazinst set bootloader auto</pre></li>
410 <li>Das alternative Laden von Windows™ ("dual boot") soll ermöglicht werden:
411 <pre># tazinst set winboot auto</pre></li>
412 <li>Die Installation wird gestartet:
413 <pre># tazinst execute</pre></li>
414 <li>Die Installations- und Protokoll-Dateien sollen gelöscht werden:
415 <pre># tazinst clean</pre></li>
416 </ol>
419 <h3>Versionsaktualisierung</h3>
421 <p>Aktualisierung eines auf Platte installierten SliTaz. Die Verzeichnisse
422 <code>/home, /etc</code> und <code>/var/www</code> bleiben erhalten,
423 alle anderen Verzeichnisse werden gelöscht.
424 Wenn eine Internet-Verbindung besteht, werden auch alle zusätzlich zu SliTaz
425 installierten Pakete aktualisiert.</p>
427 <ol>
428 <li>Es soll eine neue Installationsdatei mit Standardnamen erzeugt werden:
429 <pre># tazinst new</pre></li>
430 <li>Der Modus wird auf <code>upgrade</code> gesetzt:
431 <pre># tazinst set mode upgrade</pre></li>
432 <li>Als Installationsmedium soll das Netzwerk verwendet werden:
433 <pre># tazinst set media web</pre></li>
434 <li>Als Installationsquelle soll die freigegebene SliTaz-Version verwendet werden:
435 <pre># tazinst set source stable</pre></li>
436 <li>SliTaz in der Partition <code>/dev/hda1</code> soll aktualisiert werden:
437 <pre># tazinst set root_uuid /dev/hda1</pre></li>
438 <li>Es soll ein Urlader ("bootloader") installiert werden:
439 <pre># tazinst set bootloader auto</pre></li>
440 <li>Die Installation wird gestartet:
441 <pre># tazinst execute</pre></li>
442 </ol>
445 <h3>Tipps</h3>
447 <ol>
448 <li>Abhängig vom gewählten Installationsmodus werden nicht alle Einstellungen benötigt. Mit
449 <pre># tazinst get</pre></li>
450 kann festgestellt werden, welche Einstellungen bearbeitet werden müssen.<br><br>
451 <li>Vor dem Starten der Installation können die Einstellungen geprüft werden mit:
452 <pre># tazinst check</pre></li>
453 </ol>
456 <h2>DATEIEN</h2>
458 <h3>INSTALLATIONSDATEI</h3>
460 <p>Einstellungen werden in die Installationsdatei geschrieben und dann von tazinst
461 für eine automatisierte Installation verwendet.
462 Der Standardname der Datei ist <code>./tazinst.rc</code>;
463 optional kann ein anderer Dateiname als Parameter angegeben werden.
464 Die Installationsdatei ist in sich dokumentiert.
465 Das Kommando <code>clean</code> löscht diese Datei.</p>
468 <h3>SYSTEMDATEI</h3>
470 <p>Die Konfigurationsdatei <code>/etc/slitaz/tazinst.conf</code> ermöglicht es,
471 die Voreinstellungen von <code>tazinst</code>
472 zu ändern, wenn eigene Voreinstellungen verwendet werden sollen.</p>
474 <p>Alle Einstellungen können angepasst werden. Wenn eine Einstellung in der Datei fehlt,
475 kann der Name der Einstellung (in Großbuchstaben) mit einem neuen Wert einfach
476 in die Datei eingefügt werden.</p>
478 <h4>Beispiel:</h4>
480 <p>Wenn SliTaz immer über das Netzwerk aus demselben ISO-Abbild installiert werden soll,
481 kann man die folgenden Werte ändern oder einfügen:</p>
483 <pre>
484 MEDIA="web"
485 SOURCE="stable"
486 </pre>
488 <h3>PROTOKOLLDATEI</h3>
489 <p>Die Datei <code>/var/log/tazinst.log</code> enthält ein Protokoll des Installationsvorgangs.
490 Das Kommando <code>clean</code> löscht diese Datei.</p>
493 <h2>BETREUER</h2>
495 <p>Christophe Lincoln <pankso at slitaz.org><br />
496 Dominique Corbex <domcox at slitaz.org></p>
498 <!-- End of content -->
499 </div>
501 <footer>
502 Copyright © 2017-<span class="year"></span> <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a>
503 </footer>
505 </body>
506 </html>