NAME
Tazinst - Tiny autonomous zone installer manager
SYNTAX
tazinst [command] [configuration file]
DESCRIPTION
Tazinst is a lightweight SliTaz HDD installer (~ 29 KB). It installs SliTaz to a hard drive from a Live-CD, LiveUSB key, a SliTaz ISO image, or from the web by downloading a stable version, a cooking 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.
COMMANDS
config
Generates a self-documenting configuration file which when edited as required by the user will install or update SliTaz to a hard drive using tazinst install [filename].
tazinst config /var/lib/tazinst.conf
The configuration file contains the following variables:
- The variables describing the installation source:
- * INST_TYPE : the type of media containing the SliTaz source files, either: cdrom (SliTaz LiveCD), usb (SliTaz LiveUSB), iso (ISO image of SliTaz), web (ISO image on the Web), weboot, ex :
INST_TYPE=web
- * SRC_FILE : the name of the source file containing SliTaz. It depends on the type of support:
- cdrom (SliTaz LiveCD) : unused
- usb (SliTaz LiveUSB) : name of the partition on the host USB device, ex :
SRC_FILE=/dev/sdb1
- iso (ISO image of SliTaz) : name of the ISO file, ex :
SRC_FILE=~/slitaz.3.0.iso
- web (ISO image on the Web) : name of the URL, ex :
SRC_FILE=http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso
. Note that 3 URLs are predefined: 'stable', 'cooking, 'rolling', ex :SRC_FILE=cooking
downloads the latest cooking available from the web - weboot : unused
- The variables describing the target partition:
- * TGT_PARTITION : the name of the target partition SliTaz will install to or update, ex :
TGT_PARTITION= /dev/hda3
- TGT_FS : if this variable is entered, the target partition will be formatted in the file system specified, otherwise the partition will be cleaned and /home will be preserved, ex :
TGT_FS=ext3
- TGT_HOME : this variable indicates if need be, the name of the partition to receive the /home directory, ex :
TGT_HOME=/dev/hda5
- TGT_HOME_FS : if this variable is entered, the home partition will be formatted in the file system specified, ex :
TGT_HOME_FS=ext2
- The configuration variables:
- TGT_HOSTNAME : name of the system, ex :
TGT_HOSTNAME=hd-slitaz
, by defaultTGT_HOSTNAME=slitaz
- TGT_ROOT_PWD : superuser password, ex :
TGT_ROOT_PWD=toor
, by defaultTGT_ROOT_PWD=root
- TGT_USER : user name, ex :
TGT_USER=toto
, by defaultTGT_USER=tux
- TGT_USER_PWD : user password, ex :
TGT_USER_PWD=titi
, by defaultTGT_USER_PWD=tux
- The boot loader (bootloader) configuration variables:
- TGT_GRUB : install the GRUB bootloader (yes or no), ex :
TGT_GRUB=yes
, by defaultTGT_GRUB=no
- TGT_MENU_PARTITION : name of the partition where the GRUB configuration file is installed. Normally, this variable is not set, it can be used if GRUB is installed to a dedicated partition, or in a multi-os configuration, ex :
TGT_MENU_PARTITION=/dev/hda4
- TGT_WINBOOT : if this variable is entered, it 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 partition Windows© detected, ex :
TGT_WINBOOT=auto
Note that only variables preceded by a asterisk are mandatory, others are optional. Thus a minimal configuration file can be:
INST_TYPE=cdrom TGT_PARTITION=/dev/hda3
This file will install SliTaz on /dev/hda3 formatting the partition from a LiveCD.
install
Launch the SliTaz installer based on data in the configuration file.
tazinst install /var/lib/tazinst.conf
upgrade
Launch and upgrade SliTaz based on data in the configuration file.
tazinst upgrade /var/lib/tazinst.conf
MAINTAINERS
Christophe Lincoln <pankso at slitaz.org>
Dominique Corbex <domcox at slitaz.org>