# HG changeset patch # User Aleksej Bobylev # Date 1367691220 0 # Node ID d3ae670696d2657fcb189a60d46c55a94f7a6a2c # Parent 1dbbd8b962e30d8b96182b9b9119917618211601 Apply common stylesheet for docs; light reformatting of html code. diff -r 1dbbd8b962e3 -r d3ae670696d2 doc/tazinst.en.html --- a/doc/tazinst.en.html Sat Mar 23 08:44:40 2013 +0100 +++ b/doc/tazinst.en.html Sat May 04 18:13:40 2013 +0000 @@ -1,384 +1,368 @@ - + - Tazinst Manual - Manual for 'tazinst' installer + Tazinst Manual—Manual for “tazinst” installer - + + - - +

NAME

-

- Tazinst - Tiny autonomous zone installer manager -

+ +

Tazinst—Tiny autonomous zone installer manager

+

SYNTAX

+ 
 tazinst [command] <setting> <value> <file>
+

DESCRIPTION

-

- Tazinst is a lightweight SliTaz HDD installer. It installs SliTaz - to a hard drive from any local media such as a Live-CD, a LiveUSB key, an ISO - image located on one of your disks, or from the web by automatically - downloading a SliTaz image. -

-

- Tazinst can format the target partition to ext2, ext3 or ext4. The home - partition can be installed on another partition and if need be, formatted - before installation into any one of the available formats. Tazinst may - upon request install a bootloader on the target disk. A dual-boot with an - existing Windows™ partition is possible - finding the - Windows™ partition can either be done automatically or - manually specified. -

-

- Tazinst can also update SliTaz installed on a hard disk partition which is - handy in case of version changes. In this case, Slitaz is updated, any data in - /home is preserved and additional packages are reinstalled on to the new - version. -

-

- Tazinst was created independently for the needs of the SliTaz GNU/Linux - mini distribution. -

-

- Tazinst is written from scratch in shell script and is compatible with - Busybox Ash and Bash. Tazinst is licensed under the GNU Free gpl v3. -

+ +

Tazinst is a lightweight SliTaz HDD installer. It installs SliTaz to a hard +drive from any local media such as a Live-CD, a LiveUSB key, an ISO image +located on one of your disks, or from the web by automatically downloading a +SliTaz image.

+

Tazinst can format the target partition to ext2, ext3 or ext4. The home +partition can be installed on another partition and if need be, formatted before +installation into any one of the available formats. Tazinst may upon request +install a bootloader on the target disk. A dual-boot with an existing Windows™ +partition is possible—finding the Windows™ partition can either be done +automatically or manually specified.

+

Tazinst can also update SliTaz installed on a hard disk partition which is +handy in case of version changes. In this case, Slitaz is updated, any data in +/home is preserved and additional packages are reinstalled on to the new +version.

+

Tazinst was created independently for the needs of the SliTaz GNU/Linux mini +distribution.

+

Tazinst is written from scratch in shell script and is compatible with +Busybox Ash and Bash. Tazinst is licensed under the GNU Free GPL v3.

+ +

Known limitations

-

- Tazinst doesn't allow SliTaz to boot on (U)EFI systems (mostly - Windows™ 8 systems), except in BIOS compatibility mode. -

+

Tazinst doesn't allow SliTaz to boot on (U)EFI systems (mostly Windows™ 8 +systems), except in BIOS compatibility mode.

SETTINGS

-

- Tazinst installer is able to perform an installation automatically based on - a few settings. -

+

Tazinst installer is able to perform an installation automatically based on a +few settings.

- -

mode

-

- Installation mode that will be performed by tazinst. Type - tazinst help mode in order to have a list of supported - modes. -

- -

media

-

- The media containing the SliTaz source files, either cdrom - (SliTaz LiveCD), usb (SliTaz LiveUSB), iso - (ISO image of SliTaz), or web (ISO image on the Web). -

+

mode

- -

source

-

- The name of the source file containing SliTaz. - It depends on the type of media: - +

Installation mode that will be performed by tazinst. Type tazinst help +mode in order to have a list of supported modes.

+ + +

media

+ +

The media containing the SliTaz source files, either cdrom +(SliTaz LiveCD), usb (SliTaz LiveUSB), iso +(ISO image of SliTaz), or web (ISO image on the Web).

+ + +

source

+ +

The name of the source file containing SliTaz. It depends on the type of +media:

+ +
- - + + - - + + - - + + - - + + -
cdrom:unusedcdrom:unused
usb:name of the partition on the host USB device. Type - tazinst list usb to list USB partitions.usb:name of the partition on the host USB device. Type tazinst + list usb to list USB partitions.
isoname of the ISO file, example: ~/slitaz-rolling.iso - . Type tazinst list iso to list - iso files on your disks.isoname of the ISO file, example: ~/slitaz-rolling.iso. + Type tazinst list iso to list iso files on your + disks.
webname of the image on the web, example: stable cooking rolling - base core gtkonly justx, for a full list type - tazinst list web, or enter the full URL of the image, - example: - http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso. - webname of the image on the web, example: stable cooking rolling + base core gtkonly justx, for a full list type tazinst + list web, or enter the full URL of the image, example: + http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso. +
- -

+ - -

root_uuid

-

- The name of the target partition SliTaz will install to. Type - tazinst list uuid to list partitions on your disks. -

- -

root_format

-

- Optional. If this setting is used, the target partition will be formatted - in the file system specified, otherwise the partition will be cleaned and - /home will be preserved. Type tazinst help format - to get the list of all supported filesystems, and - tazinst list root_format to see filesystems already - installed on your system. -

+

root_uuid

- -

home_uuid

-

- Optional. A separate home partition may be created if needed. This setting - indicates if need be, the name of the partition to receive the /home - directory. -

+

The name of the target partition SliTaz will install to. Type tazinst +list uuid to list partitions on your disks.

- -

home_format

-

- Optional. If this setting is used, a separate /home partition will be - created, this partition will be formatted in the file system specified. -

- -

hostname

-

- Optional. Hostname of the system, slitaz by - default. -

+

root_format

- -

root_pwd

-

- Optional. Superuser [root] password, root, by - default. -

+

Optional. If this setting is used, the target partition will be formatted in +the file system specified, otherwise the partition will be cleaned and /home +will be preserved. Type tazinst help format to get the list of all +supported filesystems, and tazinst list root_format to see +filesystems already installed on your system.

- -

user_login

-

- Optional. First user name, tux by default. -

- -

user_pwd

-

- Optional. First user password, tux by default. -

+

home_uuid

- -

bootloader

-

- Optional. Install a bootloader. Usually you should set it to - auto unless you want to use an already installed bootloader - on your system, install a bootloader by hand yourself or install a specific - bootloader. In this case type tazinst help bootloader - to list supported bootloaders. -

+

Optional. A separate home partition may be created if needed. This setting +indicates if need be, the name of the partition to receive the /home +directory.

- -

winboot

-

- Optional. If a bootloader is installed, this setting indicates the - partition containing Windows™ to implement a dual-boot. It can - also be set to auto, in this case the - dual-boot will be on the first Windows™ partition. Type - tazinst list winboot to see values tazinst - automatically detects. -

+ +

home_format

+ +

Optional. If this setting is used, a separate /home partition will be +created, this partition will be formatted in the file system specified.

+ + +

hostname

+ +

Optional. Hostname of the system, slitaz by default.

+ + +

root_pwd

+ +

Optional. Superuser [root] password, root, by default.

+ + +

user_login

+ +

Optional. First user name, tux by default.

+ + +

user_pwd

+ +

Optional. First user password, tux by default.

+ + +

bootloader

+ +

Optional. Install a bootloader. Usually you should set it to +auto unless you want to use an already installed bootloader on your +system, install a bootloader by hand yourself or install a specific bootloader. +In this case type tazinst help bootloader to list supported +bootloaders.

+ + +

winboot

+ +

Optional. If a bootloader is installed, this setting indicates the partition +containing Windows™ to implement a dual-boot. It can also be set to +auto, in this case the dual-boot will be on the first Windows™ +partition. Type tazinst list winboot to see values tazinst +automatically detects.

+

COMMANDS

- -

new

-

- Generates a new self-documenting install file containing settings which, - when set up as required by the user, will allow tazinst to execute an - unattended installation. The default file is ./tazint.rc, but - an optional file name may be given as a parameter. -

+ +

new

+ +

Generates a new self-documenting install file containing settings which, when +set up as required by the user, will allow tazinst to execute an unattended +installation. The default file is ./tazint.rc, but an optional file +name may be given as a parameter.

+
Examples:
+ 
 tazinst new
 tazinst new /var/lib/tazinst.conf
- -

set

-

- Assign a new value to a given setting. -

+ +

set

+ +

Assign a new value to a given setting.

+
Examples:
+ 
 tazinst set mode install
 tazinst set mode install /var/lib/tazinst.conf
- -

unset

-

- Unset, clears a setting. -

+ +

unset

+ +

Unset, clears a setting.

+
Examples:
+ 
 tazinst unset mode
 tazinst unset mode /var/lib/tazinst.conf
- -

get

-

- Get the value of a setting. Without a parameter, gets the values of all - settings. -

+ +

get

+ +

Get the value of a setting. Without a parameter, gets the values of all +settings.

+
Examples:
+ 
 tazinst get
 tazinst get mode
 tazinst get mode /var/lib/tazinst.conf
- -

check

-

- Check a setting for errors. Without a parameter, checks all settings. -

+

check

+ +

Check a setting for errors. Without a parameter, checks all settings.

+
Examples:
+ 
 tazinst check
 tazinst check mode
 tazinst check mode /var/lib/tazinst.conf
- -

list

-

- List the system resources. Resources are: - + +

list

+ +

List the system resources. Resources are:

+ +
- - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + -
modeAvailable modes of installmodeAvailable modes of install
mediaAvailable media to install from. Example: cdrom is not listed on systems - with no cdrom drivemediaAvailable media to install from. Example: cdrom is not listed on + systems with no cdrom drive
usbPartitions of USB disksusbPartitions of USB disks
isoIso images located on local drives, in /root, and in all user's home and - first subdirectoryisoIso images located on local drives, in /root, and in all user's home + and first subdirectory
webPredefined names of iso images to download automatically from the - InternetwebPredefined names of iso images to download automatically from the + Internet
formatInstalled filesystemsformatInstalled filesystems
bootloaderAvailable bootloadersbootloaderAvailable bootloaders
partition_tablePartition table schemes of local diskspartition_tablePartition table schemes of local disks
winbootBootable Windows™ partitionswinbootBootable Windows™ partitions
-

+ +
Examples:
+ 
 tazinst list
 tazinst list media
- -

execute

-

- Performs a SliTaz install on a HDD based on data in the install file. - If you selected to format your HDD, all data will be lost. If you do not, - all data except for any existing /home directory will be removed, - (the home directory will be kept as is). -

+ +

execute

+ +

Performs a SliTaz install on a HDD based on data in the install file. If you +selected to format your HDD, all data will be lost. If you do not, all data +except for any existing /home directory will be removed, (the home directory +will be kept as is).

+
Examples:
+ 
 tazinst execute
 tazinst execute /var/lib/tazinst.conf
- -

clean

-

- Remove installation and log files. -

+ +

clean

+ +

Remove installation and log files.

+
Examples:
+ 
 tazinst clean
 tazinst clean /var/lib/tazinst.conf
- -

log

-

- Display the last log file contents and exit. -

+ +

log

+ +

Display the last log file contents and exit.

+
Example:
+ 
 tazinst log
- -

version

-

- Print the version information and exit. -

+ +

version

+ +

Print the version information and exit.

+
Example:
+ 
 tazinst version
- -

usage

-

- Print a short help and exit. -

+ +

usage

+ +

Print a short help and exit.

+
Example:
+ 
 tazinst usage
- -

help

-

- Print a short help for a given setting and exit. Without an argument, print - a short help for all settings. -

+ +

help

+ +

Print a short help for a given setting and exit. Without an argument, print a +short help for all settings.

+
Example:
+ 
 tazinst help mode
@@ -386,137 +370,147 @@

EXAMPLES

+

Install

-

- How to Install SliTaz on a partition of your hard disk drive. The root - partition is not formatted, all data except for any existing /home - directory will be removed, (the home directory will be - kept as is). -

+

How to Install SliTaz on a partition of your hard disk drive. The root +partition is not formatted, all data except for any existing /home +directory will be removed, (the home directory will be kept as +is).

    -
  1. Create an install file:
    # tazinst new
    2. -
  2. Set the mode as install:
    # tazinst set mode install
    3. -
  3. Use a cdrom as source:
    # tazinst set media cdrom
    4. -
  4. Select the partition to install SliTaz on: - 
    # tazinst set root_uuid /dev/hda1
    5. -
  5. Install a bootloader:
    # tazinst set bootloader auto
    -
  6. Execute an installation:
    # tazinst execute
    +
  7. Create an install file: + 
    # tazinst new
    8. +
  8. Set the mode as install: + 
    # tazinst set mode install
    9. +
  9. Use a cdrom as source: + 
    # tazinst set media cdrom
    10. +
  10. Select the partition to install SliTaz on: + 
    # tazinst set root_uuid /dev/hda1
    11. +
  11. Install a bootloader: + 
    # tazinst set bootloader auto
    12. +
  12. Execute an installation: + 
    # tazinst execute
+

Complex Install

-

- How to Install SliTaz on your hard disk drive with a separate home - partition and a Windows™ dual-boot. The /home and root partitions - are both formatted, (all existing data will be lost). -

+

How to Install SliTaz on your hard disk drive with a separate home partition +and a Windows™ dual-boot. The /home and root partitions are both formatted, (all +existing data will be lost).

    -
  1. Create an install file:
    # tazinst new
    2. -
  2. Set the mode as install:
    # tazinst set mode install
    3. -
  3. Use a Live USB as source:
    # tazinst set media usb
    4. -
  4. Select a partition on the Live USB: - 
    # tazinst set source /dev/sda1
    5. -
  5. Select the partition to install SliTaz on: - 
    # tazinst set root_uuid /dev/hda1
    6. -
  6. Format / as ext4: - 
    # tazinst set root_format ext4
    7. -
  7. Use a separate /home partition: - 
    # tazinst set home_uuid /dev/hda2
    8. -
  8. Format /home as ext2: - 
    # tazinst set home_format ext2
    9. -
  9. Install a bootloader:
    # tazinst set bootloader auto
    -
  10. Set up a Windows™ dual-boot: - 
    # tazinst set winboot auto
    11. -
  11. Execute an installation:
    # tazinst execute
    -
  12. Remove any traces behind:
    # tazinst clean
    +
  13. Create an install file: + 
    # tazinst new
    14. +
  14. Set the mode as install: + 
    # tazinst set mode install
    15. +
  15. Use a Live USB as source: + 
    # tazinst set media usb
    16. +
  16. Select a partition on the Live USB: + 
    # tazinst set source /dev/sda1
    17. +
  17. Select the partition to install SliTaz on: + 
    # tazinst set root_uuid /dev/hda1
    18. +
  18. Format / as ext4: + 
    # tazinst set root_format ext4
    19. +
  19. Use a separate /home partition: + 
    # tazinst set home_uuid /dev/hda2
    20. +
  20. Format /home as ext2: + 
    # tazinst set home_format ext2
    21. +
  21. Install a bootloader: + 
    # tazinst set bootloader auto
    22. +
  22. Set up a Windows™ dual-boot: + 
    # tazinst set winboot auto
    23. +
  23. Execute an installation: + 
    # tazinst execute
    24. +
  24. Remove any traces behind: + 
    # tazinst clean
+

Upgrade

-

- How to upgrade an already installed SliTaz system on your hard disk drive. - Your /home /etc /var/www directories will be kept, all other - directories will be removed. Any additional packages added to your old - Slitaz system will be updated as long you have an active internet - connection. -

+

How to upgrade an already installed SliTaz system on your hard disk drive. +Your /home /etc /var/www directories will be kept, all other +directories will be removed. Any additional packages added to your old Slitaz +system will be updated as long you have an active internet connection.

    -
  1. Create an install file:
    # tazinst new
    2. -
  2. Set the mode as upgrade:
    # tazinst set mode upgrade
    3. -
  3. Use web as source:
    # tazinst set media web
    4. -
  4. Select the stable image: - 
    # tazinst set source stable
    5. -
  5. Select the partition containing Slitaz to upgrade: - 
    # tazinst set root_uuid /dev/hda1
    6. -
  6. Install a bootloader:
    # tazinst set bootloader auto
    -
  7. Execute an installation:
    # tazinst execute
    +
  8. Create an install file: + 
    # tazinst new
    9. +
  9. Set the mode as upgrade: + 
    # tazinst set mode upgrade
    10. +
  10. Use web as source: + 
    # tazinst set media web
    11. +
  11. Select the stable image: + 
    # tazinst set source stable
    12. +
  12. Select the partition containing Slitaz to upgrade: + 
    # tazinst set root_uuid /dev/hda1
    13. +
  13. Install a bootloader: + 
    # tazinst set bootloader auto
    14. +
  14. Execute an installation: + 
    # tazinst execute
+

Tips

    -
  1. Not all settings are used depending on the mode of install. List all - settings to see which you need to edit: - 
    # tazinst get
    2. -
  2. Check your settings before executing install: -
    # tazinst check
    3. +
  3. Not all settings are used depending on the mode of install. List all + settings to see which you need to edit: + 
    # tazinst get
    4. +
  4. Check your settings before executing install: + 
    # tazinst check
+

FILES

+

INSTALL FILE

-

- Settings are saved in the install file, then used by tazinst to execute - an unattended installation. The default file is ./tazint.rc, - but an optional file name may be given as a parameter. The install file is - self-documented. The clean command erases this file. -

+

Settings are saved in the install file, then used by tazinst to execute an +unattended installation. The default file is ./tazint.rc, but an +optional file name may be given as a parameter. The install file is +self-documented. The clean command erases this file.

+

SYSTEM FILE

-

- The /etc/slitaz/tazinst.conf configuration file allows you to - change the default settings of tazinst in case you want - to use default custom values. -

-

- All settings are customisable, if a particular setting is missing, just add - the name of the setting in caps and enter the new value. -

+

The /etc/slitaz/tazinst.conf configuration file allows you to +change the default settings of tazinst in case you want to use +default custom values.

+ +

All settings are customisable, if a particular setting is missing, just add +the name of the setting in caps and enter the new value.

Example:

-

- If you intend to always install SliTaz from the same iso on the web, you - just have to modify or add the following values: -

MEDIA="web"
-SOURCE="stable"
-

+

If you intend to always install SliTaz from the same iso on the web, you just +have to modify or add the following values:

+ +
+MEDIA="web"
+SOURCE="stable"
+

LOG FILE

-

- The file /var/log/tazinst.log contains a log of the install - process. The clean command erases this file. -

+

The file /var/log/tazinst.log contains a log of the install +process. The clean command erases this file.

+

MAINTAINERS

-

- Christophe Lincoln <pankso at slitaz.org>
- Dominique Corbex <domcox at slitaz.org> -

+ +

Christophe Lincoln <pankso at slitaz.org>
+Dominique Corbex <domcox at slitaz.org>

- + diff -r 1dbbd8b962e3 -r d3ae670696d2 doc/tazinst.fr.html --- a/doc/tazinst.fr.html Sat Mar 23 08:44:40 2013 +0100 +++ b/doc/tazinst.fr.html Sat May 04 18:13:40 2013 +0000 @@ -1,368 +1,298 @@ - + - Tazinst Manual - Manuel de l'installateur 'tazinst' + Tazinst Manual — Manuel de l'installateur « tazinst » - + + - - +
+

NOM

-

- Tazinst - Tiny autonomous zone installer manager -

+ +

Tazinst — Tiny autonomous zone installer manager

+

SYNTAXE

+ 
 tazinst [commande] [option]
+

DESCRIPTION

-

- Tazinst est l'installateur ultra léger (~31 Ko) de SliTaz sur disque dur. - Il permet d'installer SliTaz au choix à partir du Live-CD, d'une clé - LiveUSB, d'une image ISO de SliTaz, ou depuis le web en téléchargeant la - version stable, la version cooking ou en donnant le lien http d'une autre - iso (ex: iso de developpement). -

-

- Tazinst permet de formatter la partition cible aux formats de base ext2, - ext3, ext4 ou d'autres formats si les paquets correspondants ont été - installés. La partition /home peut être installée sur une autre partition, - et si besoin être formattée avant l'installation dans un des formats - disponibles. Tazinst peut, à la demande, installer le chargeur de démarrage - Grub dans le mbr du disque cible. Un dual-boot avec une partition Windows© - existante est possible, la recherche de la partition Windows© étant soit - automatique, soit précisée manuellement. -

-

- Tazinst permet également la mise à jour de SliTaz déjà installé sur une - partition du disque dur, ce qui est pratique en cas de changement de - version. Dans ce cas, Slitaz est mis à jour, les données présentes dans - /home sont préservées, et les paquets supplémentaires sont réinstallés - dans la nouvelle version. -

-

- Tazinst a été créé pour les besoins de SliTaz GNU/Linux, mini distribution - autonome. -

-

- Tazinst, écrit en script shell à partir de zéro est compatible Bash, et - fonctionne avec Ash du projet Busybox. Tazinst est distribué sous license - libre GNU gpl v3. -

+ +

Tazinst est l'installateur ultra léger (~31 Ko) de SliTaz sur disque dur. Il +permet d'installer SliTaz au choix à partir du Live-CD, d'une clé LiveUSB, d'une +image ISO de SliTaz, ou depuis le web en téléchargeant la version stable, la +version cooking ou en donnant le lien http d'une autre iso (ex : iso de +developpement).

+

Tazinst permet de formatter la partition cible aux formats de base ext2, +ext3, ext4 ou d'autres formats si les paquets correspondants ont été installés. +La partition /home peut être installée sur une autre partition, et si besoin +être formattée avant l'installation dans un des formats disponibles. Tazinst +peut, à la demande, installer le chargeur de démarrage Grub dans le mbr du +disque cible. Un dual-boot avec une partition Windows™ existante est possible, +la recherche de la partition Windows™ étant soit automatique, soit précisée +manuellement.

+

Tazinst permet également la mise à jour de SliTaz déjà installé sur une +partition du disque dur, ce qui est pratique en cas de changement de version. +Dans ce cas, Slitaz est mis à jour, les données présentes dans /home sont +préservées, et les paquets supplémentaires sont réinstallés dans la nouvelle +version.

+

Tazinst a été créé pour les besoins de SliTaz GNU/Linux, mini distribution +autonome.

+

Tazinst, écrit en script shell à partir de zéro est compatible Bash, et +fonctionne avec Ash du projet Busybox. Tazinst est distribué sous license libre +GNU GPL v3.

+

FICHIER DE PARAMÈTRES

-

- L'installateur Tazinst permet de réaliser une installation automatiquement - à l'aide d'un simple fichier de paramètres contenant des variables - significatives telles que : - INST_TYPE="iso", TGT_PARTITION="/dev/hda1". - De cette manière, cela permet aux développeurs de créer différents types de - frontend : Dialog, GTK et CGI/web dans TazPanel. Le frontend doit juste - créer un fichier de paramètres, puis lancer tazinst en ligne de commande et - afficher un rapport d'avancement des différentes étapes (Jauges et/ou - messages). -

-

- Le fichier de paramètres contient les variables suivantes : -

+

L'installateur Tazinst permet de réaliser une installation automatiquement à +l'aide d'un simple fichier de paramètres contenant des variables significatives +telles que : INST_TYPE="iso", +TGT_PARTITION="/dev/hda1". +De cette manière, cela permet aux développeurs de créer différents types de +frontend : Dialog, GTK et CGI/web dans TazPanel. Le frontend doit juste créer un +fichier de paramètres, puis lancer tazinst en ligne de commande et afficher un +rapport d'avancement des différentes étapes (Jauges et/ou messages).

+

Le fichier de paramètres contient les variables suivantes :

+
+
    +
  1. *INST_TYPE : le type du support contenant les + fichiers sources de SliTaz, au choix : + cdrom (LiveCD de SliTaz), + usb (LiveUSB de SliTaz), + iso (Image ISO de SliTaz), + web (Image ISO sur le Web), + weboot, + ex : INST_TYPE=web
    2. +
  2. *SRC_FILE : le nom de la source contenant + SliTaz. Il dépend du type de support : +
      +
    • cdrom (LiveCD de SliTaz) : inutilisé
      • +
    • usb (LiveUSB de SliTaz) : Nom de la partition hôte de + périphérique USB, ex : + SRC_FILE=/dev/sdb1
      • +
    • iso (Image ISO de SliTaz) : Nom du fichier ISO, ex : + SRC_FILE=~/slitaz.3.0.iso
      • +
    • web (Image ISO sur le Web) : Nom de l'URL, ex : + SRC_FILE=http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso. + À noter que 3 URL sont prédéfinies : « stable », + « cooking », « rolling », ex : + SRC_FILE=cooking téléchargera la dernière + cooking disponible sur le web
      • +
    • weboot : inutilisé
      • +
    +
    3. +
+ +
  • Les variables décrivant la partition cible : +
      +
    1. *TGT_PARTITION : Le nom de la partition cible + sur laquelle SliTaz sera installé ou mis à jour, ex : + TGT_PARTITION=/dev/hda3
      2. +
    2. TGT_FS : Si cette variable est renseignée, la + partition cible sera formatée dans le système de fichiers + indiqué, sinon, la partition sera nettoyée et le répertoire + /home sera conservé, ex : TGT_FS=ext3
      3. +
    3. TGT_HOME : Cette variable indique, si besoin + est, le nom de la partition recevant le répertoire /home, ex : + TGT_HOME=/dev/hda5
      4. +
    4. TGT_HOME_FS : Si cette variable est renseignée, + la partition /home sera formatée dans le système de fichiers + indiqué, ex : TGT_HOME_FS=ext2
      5. +
    +
    • +
  • Les paramètres du système : +
      +
    1. TGT_HOSTNAME : Nom du système, ex : + TGT_HOSTNAME=hd-slitaz, par défaut + TGT_HOSTNAME=slitaz
      2. +
    2. TGT_ROOT_PWD : Mot de passe du + super-utilisateur, ex : TGT_ROOT_PWD=toor, par + défaut TGT_ROOT_PWD=root
      3. +
    3. TGT_USER : Nom de l'utitisateur par défaut, + ex : TGT_USER=toto, par défaut + TGT_USER=tux
      4. +
    4. TGT_USER_PWD : Mot de passe de l'utilisateur + par défaut, ex : TGT_USER_PWD=titi, par défaut + TGT_USER_PWD=tux
      5. +
    +
    • +
  • Les variables de configuration du chargeur de démarrage (bootloader) : +
      +
    1. TGT_GRUB : Installation de GRUB (yes ou no), + ex : TGT_GRUB=yes, par défaut + TGT_GRUB=no
      2. +
    2. TGT_WINBOOT : Si cette variable est renseignée, + elle indique la partition contenant Windows™ pour mettre en + place un Dual-boot. Elle peut être aussi positionnée à « auto », + dans ce cas le dual-boot se fera sur la première partition + Windows™ détectée, ex : TGT_WINBOOT=auto
      3. +
    +
    • - - - - - - -

    - À noter que seules les variables précédées d'une atérisque sont - obligatoires, les autres sont optionnelles. Ainsi un fichier de - paramètres minimaliste peut être le suivant: -

     INST_TYPE=cdrom
 TGT_PARTITION=/dev/hda3
    -

    - Ce fichier permettra une installation de SliTaz sur /dev/hda3, sans - formatter la partition, à partir d'un LiveCD. -

    + +

    Ce fichier permettra une installation de SliTaz sur /dev/hda3, sans formatter +la partition, à partir d'un LiveCD.

    +

    COMMANDES

    - -

    new

    -

    - Génère un fichier de paramètres autodocumenté, qui une fois édité - suivant les besoins de l'utilisateur, permettra d'installer ou mettre - à jour SliTaz sur disque dur. -

    + +

    new

    + +

    Génère un fichier de paramètres autodocumenté, qui une fois édité suivant les +besoins de l'utilisateur, permettra d'installer ou mettre à jour SliTaz sur +disque dur.

    + 
     tazinst new /var/lib/tazinst.conf
    - -

    install

    -

    - Lance l'installation de SliTaz en fonction des données présentes dans le - fichier de paramètres. Si le formattage de la partition est demandé, - toutes les données seront perdues. Si le disque n'est pas formatté, toutes - les données sauf un répertoire /home existant seront effacées, ce répertoire - /home sera gardé tel quel. -

    + +

    install

    + +

    Lance l'installation de SliTaz en fonction des données présentes dans le +fichier de paramètres. Si le formattage de la partition est demandé, toutes les +données seront perdues. Si le disque n'est pas formatté, toutes les données sauf +un répertoire /home existant seront effacées, ce répertoire /home sera gardé tel +quel.

    + 
     tazinst install /var/lib/tazinst.conf
    - -

    upgrade

    -

    - Lance la mise à jour de SliTaz en fonction des données présentes dans le - fichier de paramètres. Les répertoires /home /etc /var/www seront - conservés, tous les autres répertoires seront supprimés. Tout paquet ajouté - à la configuration de votre ancien système SliTaz sera mis à jour à la - condition qu'une connexion internet soit active. -

    + +

    upgrade

    + +

    Lance la mise à jour de SliTaz en fonction des données présentes dans le +fichier de paramètres. Les répertoires /home /etc /var/www seront conservés, +tous les autres répertoires seront supprimés. Tout paquet ajouté à la +configuration de votre ancien système SliTaz sera mis à jour à la condition +qu'une connexion internet soit active.

    + 
     tazinst upgrade /var/lib/tazinst.conf
    - -

    showurl

    -

    - Affiche l'URL complète des raccourcis prédéfinis : 'stable', 'cooking, - 'rolling'. -

    -

    - Note: Vous pouvez redéfinir ces raccourcis dans le fichier système : - /etc/slitaz/tazinst.conf. -

    + +

    showurl

    + +

    Affiche l'URL complète des raccourcis prédéfinis : « stable », « cooking », +« rolling ».

    +

    Note : Vous pouvez redéfinir ces raccourcis dans le fichier système : +/etc/slitaz/tazinst.conf.

    + 
     tazinst showurl stable
    - -

    check

    -

    - Vérifie que le fichier de paramètres ne contient pas d'erreurs. -

    + +

    check

    + +

    Vérifie que le fichier de paramètres ne contient pas d'erreurs.

    + 
     tazinst check /var/lib/tazinst.conf
    - -

    log

    -

    - Affiche le contenu du fichier journal. -

    + +

    log

    + +

    Affiche le contenu du fichier journal.

    + 
     tazinst log
    - -

    version

    -

    - Affiche les informations de version. -

    + +

    version

    + +

    Affiche les informations de version.

    + 
     tazinst version
    +

    FICHIER SYSTÈME DE CONFIGURATION

    -

    - Le fichier système de configuration /etc/slitaz/tazinst.conf permet de - changer les paramètres par défaut de tazinst. Pour utiliser des valeurs - personnalisées pour les URL, répertoires et fichiers, ce fichier doit être - créé et les variables suivantes modifiées : -

    + +

    Le fichier système de configuration /etc/slitaz/tazinst.conf permet de +changer les paramètres par défaut de tazinst. Pour utiliser des valeurs +personnalisées pour les URL, répertoires et fichiers, ce fichier doit être créé +et les variables suivantes modifiées :

    - - -

    MAINTENEURS

    -

    - Christophe Lincoln <pankso at slitaz.org>
    - Dominique Corbex <domcox at slitaz.org> -

    + +

    Christophe Lincoln <pankso at slitaz.org>
    +Dominique Corbex <domcox at slitaz.org>

    - + diff -r 1dbbd8b962e3 -r d3ae670696d2 doc/tazinst.html --- a/doc/tazinst.html Sat Mar 23 08:44:40 2013 +0100 +++ b/doc/tazinst.html Sat May 04 18:13:40 2013 +0000 @@ -1,355 +1,1 @@ - - - - Tazinst Manual - Manual for 'tazinst' installer - - - - - - - - - - -
    - -

    NAME

    -

    - Tazinst - Tiny autonomous zone installer manager -

    - -

    SYNTAX

    -
    -tazinst [command] [option]
-
    - -

    DESCRIPTION

    -

    - Tazinst is a lightweight SliTaz HDD installer (~ 31 KB). It installs SliTaz - to a hard drive from a Live-CD, a LiveUSB key, a SliTaz ISO image, or from - the web by downloading a stable, cooking or rolling version or by giving - the http link of another iso (eg: Development ISO). -

    -

    - Tazinst can format the target partition to ext2, ext3, ext4 or other formats - if the matching packages are installed. The home partition can be installed - on another partition and if need be, formatted before installation into any - one of the available formats. Tazinst may upon request install the Grub - bootloader in the MBR of the target disk. A dual-boot with an existing - Windows© partition is possible, finding the Windows© partition can either be - done automatically or manually specified. -

    -

    - Tazinst can also update SliTaz installed on a hard disk partition which is - handy in case of version changes. In this case, Slitaz is updated, data in - /home is preserved and additional packages are reinstalled on to the new - version. -

    -

    - Tazinst was created independently for the needs of the SliTaz GNU/Linux mini - distribution. -

    -

    - Tazinst is written from scratch in shell script and is compatible with - Busybox Ash and Bash. Tazinst is licensed under the GNU Free gpl v3. -

    - -

    SETUP FILE

    -

    - Tazinst installer is able to perform an installation automatically based on - a simple setup file with clear variables such as: - INST_TYPE="iso", TGT_PARTITION="/dev/hda1". - - With this way, it allows developers to create a different kind of frontend: - Dialog, GTK and CGI/web in TazPanel. The frontend just has to create a - setup file and start the cmdline installer and report steps in a nice way - (progress bar or/and messages). -

    -

    - The setup file contains the following variables: -

    - - - - - - - - -

    - Note that only variables preceded by a asterisk are mandatory, others are - optional. Thus a minimal setup file can be: -

    -
    -INST_TYPE=cdrom
-TGT_PARTITION=/dev/hda3
-
    -

    - This file will install SliTaz on /dev/hda3 formatting the partition from a - LiveCD. -

    - -

    COMMANDS

    - - -

    new

    -

    - Generates a new self-documenting setup file which when edited as required - by the user will install or update SliTaz to a hard drive. -

    -
    -tazinst new /var/lib/tazinst.conf
-
    - - - -

    install

    -

    - Performs a SliTaz install on a HDD based on data in the setup file. - If you decide to format your HDD, all data will be lost. If you do not - format, all data except for any existing /home directory will be removed, - the home directory will be kept as is. -

    -
    -tazinst install /var/lib/tazinst.conf
-
    - - -

    upgrade

    -

    - Upgrade an existing SliTaz system on a HDD based on data in the setup file. - Your /home /etc /var/www directories will be kept, all other directories - will be removed. Any additional package added to your old Slitaz system - will be updated as long you have an active internet connection. -

    -
    -tazinst upgrade /var/lib/tazinst.conf
-
    - - -

    showurl

    -

    - Display the full URL of the predefined shortcuts: 'stable', 'cooking, - 'rolling'. -

    -

    - Note: You may overwrite these shortcuts in the system file: - /etc/slitaz/tazinst.conf. -

    -
    -tazinst showurl stable
-
    - - -

    check

    -

    - Check a setup file for errors. -

    -
    -tazinst check /var/lib/tazinst.conf
-
    - - -

    log

    -

    - Display the last log file contents and exit. -

    -
    -tazinst log
-
    - - -

    version

    -

    - Print the version information and exit. -

    -
    -tazinst version
-
    - -

    SYSTEM FILE

    -

    - The /etc/slitaz/tazinst.conf configuration file allows you to change the default - settings of tazinst, if you want to use custom values for URLs, directories - and files, you'll have to create one and modify the following variables: -

    - - - - - - - -

    MAINTAINERS

    -

    - Christophe Lincoln <pankso at slitaz.org>
    - Dominique Corbex <domcox at slitaz.org> -

    - - -
    - - - - - +tazinst.en.html \ No newline at end of file diff -r 1dbbd8b962e3 -r d3ae670696d2 doc/tazinst.pt.html --- a/doc/tazinst.pt.html Sat Mar 23 08:44:40 2013 +0100 +++ b/doc/tazinst.pt.html Sat May 04 18:13:40 2013 +0000 @@ -1,352 +1,291 @@ -html xmlns="http://www.w3.org/1999/xhtml"> + + Manual do instalador Tazinst Manual - - + + - - +
    +

    NOME

    -

    - Tazinst - Instalador do SliTaz -

    + +

    Tazinst — Instalador do SliTaz

    +

    SINTAXE

    + 
     tazinst [comando] [opção]
    +

    DESCRIÇÃO

    -

    - O Tazinst é o instalador do SliTaz em disco rígidos, com um executável que - possui mais ou menos 31 Kb. Ele instala o SliTaz no disco rígido a partir - de uma mídia LiveCD, de um LiveUSB, de uma Imagem ISO ou a partir da web, - usando uma versão estável, de testes (cooking) ou rolling, ou então - a partir de uma ISO encontrada em um link da web (uma ISO de - desenvolvimento, por exemplo, encontrada num mirror oficial). -

    -

    - O Tazinst pode formatar uma partiçÃo em ext2, ext3, ext4 ou outro formato - caso os pacotes necessários estejam instalados. O diretório /home pode ser - instalado em qualquer partição, caso necessário, e ser formatado em qualquer - formato requerido. Ele também pode instalar o Grub na MBR do disco alvo. - Dual Boot com Windows é suportado caso uma partição Windows seja encontrada, - seja automaticamente ou manualmente. -

    -

    - O Tazinst pode atualizar o SliTaz instalado em um disco rígido, o que é - útil em mudanças de versão. Neste caso, a distribuição é atualizada, - os dados em /home são preservados e pacotes adicionais são reinstalados - com sua nova versão. -

    -

    - O Tazinst foi criado em Shell Script e é compatível com o Ash e Bash - do Busybox. É licenciado sob GNU Free gpl v3. -

    + +

    O Tazinst é o instalador do SliTaz em disco rígidos, com um executável que +possui mais ou menos 31 Kb. Ele instala o SliTaz no disco rígido a partir de uma +mídia LiveCD, de um LiveUSB, de uma Imagem ISO ou a partir da web, usando uma +versão estável, de testes (cooking) ou rolling, ou então a partir de uma ISO +encontrada em um link da web (uma ISO de desenvolvimento, por exemplo, +encontrada num mirror oficial).

    +

    O Tazinst pode formatar uma partição em ext2, ext3, ext4 ou outro formato +caso os pacotes necessários estejam instalados. O diretório /home pode ser +instalado em qualquer partição, caso necessário, e ser formatado em qualquer +formato requerido. Ele também pode instalar o Grub na MBR do disco alvo. Dual +Boot com Windows é suportado caso uma partição Windows seja encontrada, seja +automaticamente ou manualmente.

    +

    O Tazinst pode atualizar o SliTaz instalado em um disco rígido, o que é útil +em mudanças de versão. Neste caso, a distribuição é atualizada, os dados em +/home são preservados e pacotes adicionais são reinstalados com sua nova +versão.

    +

    O Tazinst foi criado em Shell Script e é compatível com o Ash e Bash do +Busybox. É licenciado sob GNU Free GPL v3.

    +

    ARQUIVO DE CONFIGURAÇÃO

    -

    - O instalador Tazinst pode instalar o SliTaz automaticamente usando um - arquivo de configuração que possui variáveis como - INST_TYPE="iso", TGT_PARTITION="/dev/hda1". - Desta forma, permite aos desenvolvedores criar diferentes interfaces de - usuário: Dialog, GTK e Web/CGI no TazPanel. A interface cria um arquivo - de configuração e inicia o instalador na linha de comando, informando os - passos com mensagens ou uma barra de progresso. -

    -

    - O arquivo de configuração possui as seguintes variáveis: -

    + +

    O instalador Tazinst pode instalar o SliTaz automaticamente usando um arquivo +de configuração que possui variáveis como INST_TYPE="iso", +TGT_PARTITION="/dev/hda1". Desta forma, permite aos desenvolvedores +criar diferentes interfaces de usuário: Dialog, GTK e Web/CGI no TazPanel. A +interface cria um arquivo de configuração e inicia o instalador na linha de +comando, informando os passos com mensagens ou uma barra de progresso.

    +

    O arquivo de configuração possui as seguintes variáveis:

    + - +

    Note que somente variáveis marcadas com um asterisco nesta ajuda ajuda são +obrigatórias, as outras são opcionais. Então, um arquivo de configuração mínimo +para instalação seria:

    - - - - -

    - Note que somente variáveis marcadas com um asterisco nesta ajuda ajuda - são obrigatórias, as outras são opcionais. Então, um arquivo de configuração - mínimo para instalação seria: -

     INST_TYPE=cdrom
 TGT_PARTITION=/dev/hda3
    -

    - Este arquivo mínimo instala o SliTaz na partição /dev/hda3, formatando a - partição e utilizando o LiveCD como fonte. -

    + +

    Este arquivo mínimo instala o SliTaz na partição /dev/hda3, formatando +a partição e utilizando o LiveCD como fonte.

    +

    COMANDOS

    - -

    new

    -

    - Gera um arquivo de configuração comentado que, ao ser editado pelo usuário, - irá instalar ou atualizar o SliTaz no dísco rígido -

    + +

    new

    + +

    Gera um arquivo de configuração comentado que, ao ser editado pelo usuário, +irá instalar ou atualizar o SliTaz no dísco rígido

    + 
     tazinst new /var/lib/tazinst.conf
    - -

    install

    -

    - Instala o SliTaz no dísco rígido utilizando os dados informados no - arquivo de configuração. Caso se decida formatar o HD, todos os dados nele - serão perdidos. Caso não se formate, todos os dados a não ser os contidos - em /home serão removidos, ou seja, o diretório /home será mantido. -

    + +

    install

    + +

    Instala o SliTaz no dísco rígido utilizando os dados informados no arquivo +de configuração. Caso se decida formatar o HD, todos os dados nele serão +perdidos. Caso não se formate, todos os dados a não ser os contidos em /home +serão removidos, ou seja, o diretório /home será mantido.

    + 
     tazinst install /var/lib/tazinst.conf
    - -

    upgrade

    -

    - Atualiza uma instalação do SliTaz existente no disco rígido baseado nos - dados informados no arquivo de configuração. Os diretórios /home, /etc e - /var/www serão mantidos, todos os outros diretórios serão removidos. - Qualquer pacote adicional adicionado à antiga instalação será atualizado, - desde que haja uma conexão de internet disponível. -

    + +

    upgrade

    + +

    Atualiza uma instalação do SliTaz existente no disco rígido baseado nos dados +informados no arquivo de configuração. Os diretórios /home, /etc e /var/www +serão mantidos, todos os outros diretórios serão removidos. Qualquer pacote +adicional adicionado à antiga instalação será atualizado, desde que haja uma +conexão de internet disponível.

    + 
     tazinst upgrade /var/lib/tazinst.conf
    - -

    showurl

    -

    - Mostra os endereços predefinidos nos atalhos 'stable', 'cooking' e - 'rolling'. -

    -

    - Note que é possível refefinir estes atalhos no arquivo de sistema: - /etc/slitaz/tazinst.conf. -

    + +

    showurl

    + +

    Mostra os endereços predefinidos nos atalhos “stable”, “cooking” e +“rolling”.

    +

    Note que é possível refefinir estes atalhos no arquivo de sistema: +/etc/slitaz/tazinst.conf.

    + 
     tazinst showurl stable
    - -

    check

    -

    - Verifica um arquivo de configuração: -

    + +

    check

    + +

    Verifica um arquivo de configuração:

    + 
     tazinst check /var/lib/tazinst.conf
    - -

    log

    -

    - Mostra o conteúdo do último arquivo de log: -

    + +

    log

    + +

    Mostra o conteúdo do último arquivo de log:

    + 
     tazinst log
    - -

    version

    -

    - Mostra informação sobre a versão: -

    + +

    version

    + +

    Mostra informação sobre a versão:

    + 
     tazinst version
    +

    ARQUIVO DO SISTEMA

    -

    - O arquivo /etc/slitaz/tazinst.conf permite mudar as configurações do - instalador Tazinst, permitindo atribuir valores alternativos para - endereços da web, diretórios e arquivos. Caso se queira, deve-se criar um - e modificar com as seguintes variáveis: -

    + +

    O arquivo /etc/slitaz/tazinst.conf permite mudar as configurações do +instalador Tazinst, permitindo atribuir valores alternativos para endereços +da web, diretórios e arquivos. Caso se queira, deve-se criar um e modificar com +as seguintes variáveis:

    - - -

    MANTENEDORES

    -

    - Christophe Lincoln <pankso at slitaz.org>
    - Dominique Corbex <domcox at slitaz.org> -

    + +

    Christophe Lincoln <pankso at slitaz.org>
    +Dominique Corbex <domcox at slitaz.org>

    - +