website diff en/doc/handbook/install.html @ rev 16

Add install instruction + Slim default user setting
author Christophe Lincoln <pankso@slitaz.org>
date Mon Apr 07 14:10:16 2008 +0200 (2008-04-07)
parents
children fc69ec3c3b99
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/en/doc/handbook/install.html	Mon Apr 07 14:10:16 2008 +0200
     1.3 @@ -0,0 +1,234 @@
     1.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     1.5 +    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     1.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
     1.7 +<head>
     1.8 +    <title>SliTaz - HD Installation</title>
     1.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    1.10 +    <meta name="description" content="slitaz English handbook installation" />
    1.11 +    <meta name="expires" content="never" />
    1.12 +    <meta name="modified" content="2008-04-07 11:30:00" />
    1.13 +    <meta name="publisher" content="www.slitaz.org" />
    1.14 +    <meta name="author" content="Christophe Lincoln"/>
    1.15 +    <link rel="shortcut icon" href="favicon.ico" />
    1.16 +    <link rel="stylesheet" type="text/css" href="book.css" />
    1.17 +</head>
    1.18 +<body bgcolor="#ffffff">
    1.19 +
    1.20 +<!-- Header and quick navigation -->
    1.21 +<div id="header">
    1.22 +<div align="right" id="quicknav">
    1.23 +    <a name="top"></a>
    1.24 +    <a href="packages.html">Packages</a> |
    1.25 +    <a href="index.html">Table of contents</a>
    1.26 +</div>
    1.27 +<h1><font color="#3E1220">SliTaz Handbook (en)</font></h1>
    1.28 +</div>
    1.29 +
    1.30 +<!-- Content. -->
    1.31 +<div id="content">
    1.32 +<div class="content-right"></div>
    1.33 +
    1.34 +<h2><font color="#DF8F06">HD Installation</font></h2>
    1.35 +
    1.36 +<ul>
    1.37 +	<li><a href="#intro">Introduction.</a></li>
    1.38 +	<li><a href="#installer">SliTaz Installer.</a></li>
    1.39 +	<li><a href="#byhand">Installation by hand.</a></li>
    1.40 +	<li><a href="#grub">GRUB bootloader.</a></li>
    1.41 +</ul>
    1.42 +
    1.43 +<a name="intro"></a>
    1.44 +<h3>Introduction</h3>
    1.45 +<p>
    1.46 +This document give some informations and necessary instructions on how to 
    1.47 +install SliTaz on a hard disk. You will need about 10 minutes, SliTaz core
    1.48 +LiveCD expand to 80 Mb so we suggest a minimum of 120 Mb of free space like
    1.49 +this you will be able to install a few more packages. If you can
    1.50 +<a href="livecd.html">use the LiveCD</a>, you should be able to install SliTaz.
    1.51 +</p>
    1.52 +
    1.53 +<a name="installer"></a>
    1.54 +<h3>SliTaz Installer</h3>
    1.55 +<p>
    1.56 +SliTaz provide a simple to use Installer who can be launch from the 
    1.57 +"System Tools" menu. SliTaz 1.0 Installer messages are only in French and can
    1.58 +be considered as an errata, but English speakers should manage to use it with
    1.59 +this complemantary documentation.
    1.60 +</p>
    1.61 +<h4>Install type</h4>
    1.62 +<p>
    1.63 +The first step let you choose the type of installation: new install or system 
    1.64 +upgrade. In most case you will want a new and clean installation. When accepted
    1.65 +the installer will mount the master cdrom device and search for the compressed
    1.66 +filesystem (<code>rootfs.gz</code>). If any filesystem was found installation
    1.67 +will abort.
    1.68 +</p>
    1.69 +<p>
    1.70 +If you get into trouble because the compressed filesystem is not found, please
    1.71 +check that SliTaz is in the master CD/DVD device, if the problem persist you
    1.72 +can use a downloaded ISO image and mount it on <code>/media/cdrom</code> where
    1.73 +the HD Installer wanted to find it: 
    1.74 +</p>
    1.75 +<pre>
    1.76 + # mount -o loop slitaz-1.0.iso /media/cdrom
    1.77 +</pre>
    1.78 +<h4>Target partition</h4>
    1.79 +<p>
    1.80 +Second step is the partition configuration. If you have already a free partition
    1.81 +you can directly use it, if not you will have to creat one graphicaly with 
    1.82 +Gparted or from the command line with fdisk. For example if you want to install
    1.83 +SliTaz on the first partition of the first disk recognized as <code>hda</code>: 
    1.84 +</p>
    1.85 +<pre class="script">
    1.86 +/dev/hda1
    1.87 +</pre>
    1.88 +<h4>Formating</h4>
    1.89 +<p>
    1.90 +The next step let you format the target partition into <code>ext3</code>. Ext3
    1.91 +is a robust, stable and journalised filesystem. If the partition is already 
    1.92 +formated you dont need to reformat if not just accept. Warning formating a
    1.93 +partition will destroy all current data.
    1.94 +</p>
    1.95 +<h4>Hostname</h4>
    1.96 +<p>
    1.97 +Hostname configuration let you set the machine name. The hostname is used 
    1.98 +internaly and to indentify the host on the network. This value can also be
    1.99 +changed when the system is installed.
   1.100 +</p>
   1.101 +<h4>Bootloader - GRUB</h4>
   1.102 +<p>
   1.103 +When the installation process is finish you have the option to install the GRUB
   1.104 +bootloader who is capable of booting almost all kind of operating system. If
   1.105 +you want to use an existing GRUB installation, skip this step and add the
   1.106 +correct lines to your GRUB configuration file (<code>menu.lst</code>). Note 
   1.107 +that SliTaz Installer created a configuration file on the target who can be
   1.108 +used as example (/mnt/target/boot/grub/menu.lst).
   1.109 +</p>
   1.110 +<h4>End of installation</h4>
   1.111 +<p>
   1.112 +When the Installer did all his job you have the option to exit or directly 
   1.113 +reboot on your new SliTaz GNU/Linux operating system. First boot is like the
   1.114 +LiveCD, you will be prompt for locale, keyboard, sound card and screen 
   1.115 +selection, future reboot will not prompt you anymore for configuration but
   1.116 +all the values can be changed manually or with the project tools such as
   1.117 +<code>tazlocale</code> or <code>tazx</code>.
   1.118 +</p>
   1.119 +
   1.120 +<a name="byhand"></a>
   1.121 +<h3>Installation by hand</h3>
   1.122 +<p>
   1.123 +SliTaz can also be installed by hand from the command line. To install SliTaz
   1.124 +by hand you can use a cdrom or an ISO image. The given commands can be
   1.125 +copy/past from Firefox to Xterm.
   1.126 +</p>
   1.127 +<p>
   1.128 +The first thing you have to do is prepare a target partition and mount it. 
   1.129 +Example using partition <code>/dev/hda1</code>:
   1.130 +</p>
   1.131 +<pre>
   1.132 + # mkdir /mnt/target
   1.133 + # mount /dev/hda1 /mnt/target
   1.134 +</pre>
   1.135 +<h4>Mount cdrom or ISO image</h4>
   1.136 +<p>
   1.137 +Now you have to mount the cdrom:
   1.138 +</p>
   1.139 +<pre>
   1.140 + # mount /dev/cdrom /media/cdrom
   1.141 +</pre>
   1.142 +<p>
   1.143 +Or an ISO image
   1.144 +</p>
   1.145 +<pre>
   1.146 + # mount -o loop slitaz-1.0.iso /media/cdrom
   1.147 +</pre>
   1.148 +<h4>Install and extract</h4>
   1.149 +<p>
   1.150 +The goal now is to copy neede files from the media into the target partition
   1.151 +and then extract the compressed filesystem (<code>rootfs.gz</code>). Creat a
   1.152 +boot directory and install the Linux Kernel:
   1.153 +</p>
   1.154 +<pre>
   1.155 + # mkdir /mnt/target/boot
   1.156 + # cp -a /media/cdrom/boot/vmlinuz-* /mnt/target/boot
   1.157 +</pre>
   1.158 +<p>
   1.159 +Copy the rootfs:
   1.160 +</p>
   1.161 +<pre>
   1.162 + # cp /media/cdrom/boot/rootfs.gz /mnt/target
   1.163 +</pre>
   1.164 +<p>
   1.165 +Now the necessary files are present so you can change directory (<code>cd</code>)
   1.166 +to the target and uncompress the the filesystem with <code>lzma</code> and
   1.167 +<code>cpio</code>:
   1.168 +</p>
   1.169 +<pre>
   1.170 + # cd /mnt/target
   1.171 + # lzma d rootfs.gz -so | cpio -id 
   1.172 + # rm rootfs.gz init
   1.173 +</pre>
   1.174 +<p>
   1.175 +That's all, SliTaz is installed. Before rebooting on you new SliTaz GNU/Linux
   1.176 +installation please check that you have a bootloader (GRUB or Lilo) and add 
   1.177 +the necessary lines to boot SliTaz.
   1.178 +</p>
   1.179 +
   1.180 +<a name="grub"></a>
   1.181 +<h3>GRUB bootloader</h3>
   1.182 +<p>
   1.183 +GRUB is an universal bootloader capable of booting almost all operating such
   1.184 +as Linux, BSD or Windows. GRUB use single configuration file named 
   1.185 +<code>menu.lst</code>, if you used <a href="#installer">SliTaz Installer</a>
   1.186 +and installed GRUB you dont need to install manually GRUB, just reboot.
   1.187 +</p>
   1.188 +<p>
   1.189 +Installation of GRUB onto the mbr, using root directory /mnt/target (the taget
   1.190 +mounted partition) and the disk named <code>hda</code>:
   1.191 +</p>
   1.192 +<pre>
   1.193 + # grub-install --root-directory=/mnt/target /dev/hda
   1.194 +</pre>
   1.195 +<p>
   1.196 +You can now creat GRUB configuration file and add the lines who will boot
   1.197 +SliTaz. Menu.lst can be edited with your favorite text editor such as Nano or
   1.198 +Leafpad:
   1.199 +</p>
   1.200 +<pre>
   1.201 + # leafpad /mnt/target/boot/grub/menu.lst
   1.202 +</pre>
   1.203 +<h4>/boot/grub/menu.lst - Example</h4>
   1.204 +<pre class="script">
   1.205 +
   1.206 +title  SliTaz GNU/Linux 1.0 (Kernel 2.6.24.2-slitaz)
   1.207 +       root(hd0,0)
   1.208 +       kernel /boot/vmlinuz-2.6.24.2-slitaz root=/dev/hda1 vga=normal
   1.209 +
   1.210 +</pre>
   1.211 +<p>
   1.212 +Verify again that everything is in place before rebooting:
   1.213 +</p>
   1.214 +<pre>
   1.215 + # reboot
   1.216 +</pre>
   1.217 +
   1.218 +<!-- End of content -->
   1.219 +</div>
   1.220 +
   1.221 +<!-- Footer. -->
   1.222 +<div id="footer">
   1.223 +	<div class="footer-right"></div>
   1.224 +	<a href="#top">Top of the page</a> | 
   1.225 +	<a href="index.html">Table of contents</a>
   1.226 +</div>
   1.227 +
   1.228 +<div id="copy">
   1.229 +    Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
   1.230 +    <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
   1.231 +    Documentation is under
   1.232 +    <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
   1.233 +    and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
   1.234 +</div>
   1.235 +
   1.236 +</body>
   1.237 +</html>