# HG changeset patch
# User Dominique Corbex
# Date 1360843932 -3600
# Node ID b0ed6cbb9de0f5ee661ab39ebae53a8fd27aa3f0
# Parent 3129931fdc6556687cc09dcbaeea514fd21277f0
Use UUIDs, boot delay on mobile disks, GPT support, boot flag, new slitaz-installer and web frontends
diff -r 3129931fdc65 -r b0ed6cbb9de0 Makefile
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/Makefile Thu Feb 14 13:12:12 2013 +0100
@@ -0,0 +1,120 @@
+# Makefile for TazUSB.
+# Check the README for more information.
+#
+PREFIX?=/usr
+DOCDIR?=/usr/share/doc
+DESTDIR?=
+TAZPANEL?=/var/www/tazpanel
+LINGUAS?=el es es_AR fr pt_BR sv ru
+
+PACKAGE = tazinst
+VERSION := $(shell grep ^VERSION ${PACKAGE} | cut -d '=' -f 2)
+TARBALL = $(PACKAGE)-$(VERSION).tar.gz
+
+all:
+
+# i18n.
+
+pot:
+ xgettext -o po/tazinst/tazinst.pot -L Shell \
+ --package-name="Tazinst" \
+ --package-version="$(VERSION)" \
+ ./tazinst
+ xgettext -o po/slitaz-installer/slitaz-installer.pot -L Shell \
+ --package-name="slitaz-installer" \
+ --package-version="$(VERSION)" \
+ ./slitaz-installer
+ xgettext -o po/installer/installer.pot -L Shell \
+ --package-name="installer.cgi" \
+ --package-version="$(VERSION)" \
+ ./installer.cgi
+
+msgmerge:
+ @for l in $(LINGUAS); do \
+ if [ -f "po/tazinst/$$l.po" ]; then \
+ echo -n "Updating tazinst $$l po file."; \
+ msgmerge -U po/tazinst/$$l.po po/tazinst/tazinst.pot ; \
+ fi;\
+ if [ -f "po/slitaz-installer/$$l.po" ]; then \
+ echo -n "Updating slitaz-installer $$l po file."; \
+ msgmerge -U po/slitaz-installer/$$l.po \
+ po/slitaz-installer/slitaz-installer.pot ; \
+ fi;\
+ if [ -f "po/installer/$$l.po" ]; then \
+ echo -n "Updating installer $$l po file."; \
+ msgmerge -U po/installer/$$l.po po/installer/installer.pot ; \
+ fi;\
+ done;
+
+msgfmt:
+ @for l in $(LINGUAS); do \
+ if [ -f "po/tazinst/$$l.po" ]; then \
+ echo "Compiling tazinst $$l mo file..."; \
+ mkdir -p po/mo/$$l/LC_MESSAGES; \
+ msgfmt -o po/mo/$$l/LC_MESSAGES/tazinst.mo po/tazinst/$$l.po ; \
+ fi;\
+ if [ -f "po/slitaz-installer/$$l.po" ]; then \
+ echo "Compiling slitaz-installer $$l mo file..."; \
+ mkdir -p po/mo/$$l/LC_MESSAGES; \
+ msgfmt -o po/mo/$$l/LC_MESSAGES/slitaz-installer.mo \
+ po/slitaz-installer/$$l.po ; \
+ fi;\
+ if [ -f "po/installer/$$l.po" ]; then \
+ echo "Compiling installer $$l mo file..."; \
+ mkdir -p po/mo/$$l/LC_MESSAGES; \
+ msgfmt -o po/mo/$$l/LC_MESSAGES/installer.mo po/installer/$$l.po ; \
+ fi;\
+ done;
+
+# Installation.
+
+install: msgfmt
+ @echo "Installing Tazinst into $(DESTDIR)$(PREFIX)/sbin..."
+ mkdir -p $(DESTDIR)$(PREFIX)/sbin
+ install -m 0755 tazinst $(DESTDIR)$(PREFIX)/sbin
+ @echo "Installing slitaz-installer into $(DESTDIR)$(PREFIX)/sbin..."
+ mkdir -p $(DESTDIR)$(PREFIX)/sbin
+ install -m 0755 slitaz-installer $(DESTDIR)$(PREFIX)/sbin
+ @echo "Installing installer.cgi into $(DESTDIR)$(TAZPANEL)..."
+ mkdir -p $(DESTDIR)$(TAZPANEL)
+ install -m 0755 installer.cgi $(DESTDIR)$(TAZPANEL)
+ @echo "Installing config file into $(DESTDIR)/etc/slitaz.."
+ mkdir -p $(DESTDIR)/etc/slitaz
+ install -m 0755 etc/tazinst.conf $(DESTDIR)/etc/slitaz
+
+ @echo "Installing Tazinst documentation..."
+ mkdir -p $(DESTDIR)$(DOCDIR)/tazinst
+ cp -a doc/* $(DESTDIR)$(DOCDIR)/tazinst
+ # i18n
+ mkdir -p $(DESTDIR)$(PREFIX)/share/locale
+ cp -a po/mo/* $(DESTDIR)$(PREFIX)/share/locale
+ # Desktop integration
+ @echo "Setting up desktop integration..."
+ mkdir -p $(DESTDIR)$(PREFIX)/share
+ cp -a applications $(DESTDIR)$(PREFIX)/share
+
+# Uninstallation and tarball clean-up commands.
+
+uninstall:
+ rm -f $(DESTDIR)/etc/slitaz/tazinst.conf
+ rm -f $(DESTDIR)$(PREFIX)/sbin/tazinst
+ rm -f $(DESTDIR)$(PREFIX)/sbin/slitaz_installer
+ rm -f $(DESTDIR)$(TAZPANEL)/installer.cgi
+ rm -rf $(DESTDIR)$(DOCDIR)/tazinst
+ rm -rf $(DESTDIR)$(PREFIX)/share/locale/*/LC_MESSAGES/tazinst*.mo
+ rm -rf $(DESTDIR)$(PREFIX)/share/locale/*/LC_MESSAGES/slitaz-installer*.mo
+ rm -rf $(DESTDIR)$(PREFIX)/share/locale/*/LC_MESSAGES/installer*.mo
+ rm -f $(DESTDIR)$(PREFIX)/share/applications/tazinst.desktop
+
+clean:
+ rm -rf _pkg
+ rm -rf po/mo
+ rm -f po/*/*~
+
+dist-clean:
+ rm -rf $(DISTDIR)
+
+# Build tarball and MD5 file for packaging.
+dist: dist-clean
+ hg archive -t tgz $(TARBALL)
+ md5sum $(TARBALL) > $(PACKAGE)-$(VERSION).md5
diff -r 3129931fdc65 -r b0ed6cbb9de0 NOTES
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/NOTES Thu Feb 14 13:12:12 2013 +0100
@@ -0,0 +1,126 @@
+tazinst - SliTaz GNU/Linux installer - Version 4.0
+
+New features:
+=============
+- extensive use of UUID for disk operations
+- boot delay automatically added for slow mobile disks
+- GPT partition scheme support
+- boot flag automatically added
+- more images to install directly from the web
+- slitaz-installer is back
+- new web frontend
+- many bug fixes
+
+Tests:
+======
+All tests were done by using rolling version (2012-01-17)
+
+partitionning tests:
+!---------!--------!--------!--------!!--------!
+! mode ! format !separate! format !! RESULT !
+! ! / ! /home ! /home !! !
+!---------!--------!--------!--------!!--------!
+! install ! ! ! !!OK 3.90 !
+!---------!--------!--------!--------!!--------!
+! install ! ! X ! !!OK 3.90 !
+!---------!--------!--------!--------!!--------!
+! install ! ! X ! X !!OK 3.90 !
+!---------!--------!--------!--------!!--------!
+! install ! X ! ! !!OK 3.90 !
+!---------!--------!--------!--------!!--------!
+! install ! X ! X ! !!OK 3.90 !
+!---------!--------!--------!--------!!--------!
+! install ! X ! X ! X !!OK 3.90 !
+!---------!--------!--------!--------!!--------!
+! upgrade ! ! ! !!OK 3.897! xorg nok
+!---------!--------!--------!--------!!--------!
+! upgrade ! ! X ! !!OK 3.987! xorg nok
+!---------!--------!--------!--------!!--------!
+
+medias tests:
+!---------!!--------!
+! media !! RESULT !
+!---------!!--------!
+! cdrom !! !
+!---------!!--------!
+! usb !!OK 3.897!
+!---------!!--------!
+! iso !!OK 3.90 !
+!---------!!--------!
+! web !!OK 3.90 !
+!---------!!--------!
+
+iso (stable flavours) tests:
+!---------!!--------!
+! iso !! RESULT !
+!---------!!--------!
+! stable !!OK 3.90 !
+!---------!!--------!
+! cooking !! NOK ! no login
+!---------!!--------!
+! rolling !!OK 3.90 !
+!---------!!--------!
+! base !!OK 3.897!
+!---------!!--------!
+! core !!OK 3.897!
+!---------!!--------!
+! gtkonly !! NOK ! no login
+!---------!!--------!
+! justx !! NOK ! no login
+!---------!!--------!
+
+Bootloader tests (ext2):
+!---------!--------!--------!--------!!--------!
+! mode ! grub1 ! syslnx ! dualbt !! RESULT !
+!---------!--------!--------!--------!!--------!
+! install ! X ! ! !!OK 3.90 !
+!---------!--------!--------!--------!!--------!
+! install ! X ! ! X !!OK 3.896!
+!---------!--------!--------!--------!!--------!
+! install ! ! X ! !!OK 3.90 !
+!---------!--------!--------!--------!!--------!
+! install ! ! X ! X !! !
+!---------!--------!--------!--------!!--------!
+! upgrade ! X ! ! !! !
+!---------!--------!--------!--------!!--------!
+! upgrade ! X ! ! X !! !
+!---------!--------!--------!--------!!--------!
+! upgrade ! ! X ! !!OK 3.897! xorg nok
+!---------!--------!--------!--------!!--------!
+! upgrade ! ! X ! X !! !
+!---------!--------!--------!--------!!--------!
+
+Filesystems tests:
+!---------!!--------!!--------!!--------!
+! fs !! RESULT !! RESULT !! RESULT !
+! !! install!! boot !! boot !
+! !! !! grub !! syslnx !
+!---------!!--------!!--------!!--------!
+! ext2 !!OK 3.90 !!OK 3.90 !!OK 3.897!
+!---------!!--------!!--------!!--------!
+! ext3 !!OK 3.90 !!OK 3.90 !!OK 3.897!
+!---------!!--------!!--------!!--------!
+! ext4 !!OK 3.90 !!OK 3.896!!OK 3.90 !
+!---------!!--------!!--------!!--------!
+! btrfs !!OK 3.90 !! NOK !!OK 3.90 !
+!---------!!--------!!--------!!--------!
+! jfs !! !! !!########!
+!---------!!--------!!--------!!--------!
+! reiser4 !! !! !!########!
+!---------!!--------!!--------!!--------!
+! reiserfs!! !! !!########!
+!---------!!--------!!--------!!--------!
+! ufs !! !! !!########!
+!---------!!--------!!--------!!--------!
+! xfs !! NOK !! !!########!
+!---------!!--------!!--------!!--------!
+
+Partition schemes boot tests
+!---------!!--------!!--------!
+! partit. !! RESULT !! RESULT !
+! table !! grub1 !! syslnx !
+!---------!!--------!!--------!
+! msdos !!OK 3.90 !!OK 3.897!
+!---------!!--------!!--------!
+! gpt !!########!!OK 3.90 !
+!---------!!--------!!--------!
diff -r 3129931fdc65 -r b0ed6cbb9de0 README
--- a/README Thu Feb 14 12:49:41 2013 +0100
+++ b/README Thu Feb 14 13:12:12 2013 +0100
@@ -1,29 +1,21 @@
SliTaz Installer
================================================================================
-
-The first SliTaz installer was built using ncurses Dialog within a SHell script.
-It was the last SliTaz home made tool that didn't have a desktop integrated
-interface and had some crappy code as it was written at the start of the
-project.
-
-Tazinst is the new installer written entirely in SHell script and usable from
-the cmdline without dialog or any other gui-like interface! This new installer
+Tazinst is the SliTaz installer written entirely in SHell script and usable from
+the cmdline without dialog or any other gui-like interface! This installer
is able to perform an installation automatically based on a simple config 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 config
-file and start the cmdline installer and report steps in a nice way (progress
-bar or/and messages).
+Dialog, CGI/web. Two frontends are included: slitaz-installer, a ncurses frontend,
+and a CGI/web frontend.
i18n
----
Tazinst has been coded from the beginning with gettext support. Please
forget 'echo' and use gettext, but remember that gettext "" is equivalent
-to echo -n. All scripts use the same TEXTDOMAIN and the same pot files, all
-translations go in the po/ folder.
+to echo -n. All translations go in the po/ folder.
To start a new translation please use msginit from the pot file directory.
Example for French/France locale (fr_FR):
diff -r 3129931fdc65 -r b0ed6cbb9de0 applications/tazinst-doc.desktop
--- a/applications/tazinst-doc.desktop Thu Feb 14 12:49:41 2013 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,11 +0,0 @@
-[Desktop Entry]
-Encoding=UTF-8
-Name=Tazinst manual
-Name[pt]=Manual do Tazinst
-Name[pt_BR]=Manual do Tazinst
-Name[fr]=Manuel de Tazinst
-Name[ru]=Руководство TazInst
-Exec=browser file:///usr/share/doc/slitaz/tazinst.html
-Icon=text-html
-Type=Application
-Categories=Documentation;
diff -r 3129931fdc65 -r b0ed6cbb9de0 applications/tazinst.desktop
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/applications/tazinst.desktop Thu Feb 14 13:12:12 2013 +0100
@@ -0,0 +1,6 @@
+[Desktop Entry]
+Type=Application
+Name=SliTaz Installer
+Icon=slitaz-icon
+Exec=browser http://tazpanel:82/installer.cgi
+Categories=System;
diff -r 3129931fdc65 -r b0ed6cbb9de0 doc/tazinst.en.html
--- a/doc/tazinst.en.html Thu Feb 14 12:49:41 2013 +0100
+++ b/doc/tazinst.en.html Thu Feb 14 13:12:12 2013 +0100
@@ -23,24 +23,24 @@
SYNTAX
-tazinst [command] [option]
+tazinst [command] <setting> <value> <file>
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 is a lightweight SliTaz HDD installer. It installs SliTaz
+ to a hard drive from a local media like 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, 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 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
@@ -49,155 +49,156 @@
version.
- Tazinst was created independently for the needs of the SliTaz GNU/Linux mini
- distribution.
+ 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.
+
-SETUP FILE
+
+
+SETTINGS
+
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"
.
+ a few settings.
+
- 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).
+
+mode
+
+ Mode of install that will be performed by tazinst. Type
+ tazinst help mode
in order to have a list of supported
+ modes.
+
+
+media
- The setup file contains the following variables:
+ The media containing the SliTaz source files, either: cdrom
+ (SliTaz LiveCD), usb (SliTaz LiveUSB), iso
+ (ISO image of SliTaz), web (ISO image on the Web).
-
-
- 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
-
+
+source
+
+ The name of the source file containing SliTaz.
+ It depends on the type of media:
+
+
+ cdrom: |
+ unused |
+
+
+ usb: |
+ name of the partition on the host USB device. Type
+ tazinst list usb to list USB partitions. |
+
+
+ iso |
+ name of the ISO file, ex: ~/slitaz-rolling.iso
+ . Type tazinst list iso to list
+ iso files on your disks. |
+
+
+ web |
+ name of the image on the web, ex: stable cooking rolling
+ base core gtkonly justx , for a full list type
+ tazinst list web , or enter the full URL of the image,
+ ex:
+ http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso .
+ |
+
+
-
-
-
-
+
-
- The variables describing the target
- partition:
+
+
root_uuid
+
+ The name of the target partition SliTaz will install to. Type
+ tazinst list uuid
to list partitions on your disks.
+
-
-
- *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
-
-
-
-
+
+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.
+
-
- The system settings:
+
+
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.
+
-
-
- TGT_HOSTNAME: name of the system,
- ex: TGT_HOSTNAME=hd-slitaz
, by default
- TGT_HOSTNAME=slitaz
-
-
- TGT_ROOT_PWD: superuser password,
- ex: TGT_ROOT_PWD=toor
, by default
- TGT_ROOT_PWD=root
-
-
- TGT_USER: user name,
- ex: TGT_USER=toto
, by default TGT_USER=tux
-
-
- TGT_USER_PWD: user password,
- ex: TGT_USER_PWD=titi
, by default
- TGT_USER_PWD=tux
-
-
-
-
+
+home_format
+
+ Optional. If this setting is used, and a separate /home partition will be
+ created, this partition will be formatted in the file system specified.
+
-
- The boot loader (bootloader)
- configuration variables:
+
+
hostname
+
+ Optional. Name of the system, slitaz
by
+ default.
+
-
-
- TGT_GRUB: install the GRUB bootloader (yes or no),
- ex: TGT_GRUB=yes
, by default TGT_GRUB=no
-
-
- 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© detects,
- ex: TGT_WINBOOT=auto
-
-
-
-
+
+root_pwd
+
+ Optional. Superuser password, root
, by
+ default.
+
+
+user_login
- Note that only variables preceded by a asterisk are mandatory, others are
- optional. Thus a minimal setup file can be:
+ Optional. First user name, tux
by default.
-
-INST_TYPE=cdrom
-TGT_PARTITION=/dev/hda3
-
+
+
+user_pwd
- This file will install SliTaz on /dev/hda3 formatting the partition from a
- LiveCD.
+ 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
@@ -205,59 +206,140 @@
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.
+ 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
-
-
-install
+
+set
- 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.
+ Assign a new value to a given setting.
+Examples:
-tazinst install /var/lib/tazinst.conf
+tazinst set mode install
+tazinst set mode install /var/lib/tazinst.conf
-
-upgrade
+
+unset
- 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.
+ Unset, clear a setting.
+Examples:
-tazinst upgrade /var/lib/tazinst.conf
+tazinst unset mode
+tazinst unset mode /var/lib/tazinst.conf
-
-showurl
+
+get
- Display the full URL of the predefined shortcuts: 'stable', 'cooking,
- 'rolling'.
+ Get the value of a setting. Without parameter, get the values of all
+ settings.
-
- Note: You may overwrite these shortcuts in the system file:
- /etc/slitaz/tazinst.conf.
-
+Examples:
-tazinst showurl stable
+tazinst get
+tazinst get mode
+tazinst get mode /var/lib/tazinst.conf
check
- Check a setup file for errors.
+ Check a setting for errors. Without parameter, check all settings.
+
+Examples:
-tazinst check /var/lib/tazinst.conf
+tazinst check
+tazinst check mode
+tazinst check mode /var/lib/tazinst.conf
+
+
+
+list
+
+ List system ressources. Ressources are:
+
+
+ mode |
+ Available modes of install |
+
+
+ media |
+ Available media to install from. Ex: cdrom is not listed on systems
+ with no cdrom drive |
+
+
+ usb |
+ Partitions of USB disks |
+
+
+ iso |
+ Iso images located on local drives, in /root, all user's home and
+ first subdir of all user's home |
+
+
+ web |
+ Predefined names of iso images to download automatically from the
+ Internet. |
+
+
+ format |
+ Installed filesystems |
+
+
+ bootloader |
+ Available bootloaders |
+
+
+ partition_table |
+ Partition tables scheme of local disks |
+
+
+ winboot |
+ Bootable 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.
+
+Examples:
+
+tazinst execute
+tazinst execute /var/lib/tazinst.conf
+
+
+
+clean
+
+ Remove install and log files.
+
+Examples:
+
+tazinst clean
+tazinst clean /var/lib/tazinst.conf
@@ -265,6 +347,7 @@
Display the last log file contents and exit.
+Example:
tazinst log
@@ -274,69 +357,153 @@
Print the version information and exit.
+Example:
tazinst version
-SYSTEM FILE
+
+usage
- 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:
+ 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.
+
+Example:
+
+tazinst help mode
+
+
+
+EXAMPLES
+
+Install
+
+
+ How to Install SliTaz on one 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.
-
-Predefined urls:
+
+- Create an install file:
# tazinst new
+- Set mode as install:
# tazinst set mode install
+- Use a cdrom as source:
# tazinst set media cdrom
+- Select the partition to install SliTaz on:
+
# tazinst set root_uuid /dev/hda1
+- Install a bootloader:
# tazinst set bootloader auto
+ - Execute installation:
# tazinst execute
+
+
+
Complex Install
+
+
+ How to Install SliTaz on your hard disk drive, with a separate home
+ partition, and a Windows™ dual-boot. /home and root partitions
+ are both formatted, all existing data will be lost.
+
- URL of the current stable version:
- URL_STABLE="http://mirror.slitaz.org/iso/stable/slitaz-4.0.iso"
-
-
- URL of the current cooking version:
- URL_COOKING="http://mirror.slitaz.org/iso/cooking/slitaz-cooking.iso"
-
-
- URL of the current rolling version:
- URL_ROLLING="http://mirror.slitaz.org/iso/rolling/slitaz-core.iso"
-
-
+- Create an install file:
# tazinst new
+- Set mode as install:
# tazinst set mode install
+- Use a Live USB as source:
# tazinst set media usb
+- Select a partition on the Live USB:
+
# tazinst set source /dev/sda1
+- Select the partition to install SliTaz on:
+
# tazinst set root_uuid /dev/hda1
+- Format / as ext4:
+
# tazinst set root_format ext4
+- Use a separate /home partition:
+
# tazinst set home_uuid /dev/hda2
+- Format /home as ext2:
+
# tazinst set home_format ext2
+- Install a bootloader:
# tazinst set bootloader auto
+ - Set up a Windows™ dual-boot:
+
# tazinst set winboot auto
+- Execute installation:
# tazinst execute
+ - Don't let traces behind:
# tazinst clean
-
-
-
-Mount points:
+
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.
+
-
- Source partition mount point:
- SOURCE_ROOT="/media/source"
-
-
- Target partition mount point:
- TARGET_ROOT="/mnt/target"
-
+- Create an install file:
# tazinst new
+- Set mode as upgrade:
# tazinst set mode upgrade
+- Use web as source:
# tazinst set media web
+- Select the stable image:
+
# tazinst set source stable
+- Select the partition containing Slitaz to upgrade:
+
# tazinst set root_uuid /dev/hda1
+- Install a bootloader:
# tazinst set bootloader auto
+ - Execute installation:
# tazinst execute
-
-
-
-Log and Debug:
+
Tips
- Log File Location:
- LOG="/var/log/tazinst.log"
-
- Debugging: (quiet => 0, debug => 1)
- DEBUG=0
- It is highly recommended to set DEBUG=1
and attach the
- contents of the resulting Log file when sending a bug report to
- developers.
-
+- Not all settings are used depending on the mode of install. List all
+ settings to see which you need to edit:
+
# tazinst get
+- 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.
+
+
+SYSTEM FILE
+
+ The /etc/slitaz/tazinst.conf
configuration file allows you to
+ change the default settings of tazinst
, in the 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 allways 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.
+
MAINTAINERS
@@ -348,7 +515,7 @@