website 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 | cd23fe9aa506 |
| children | fc69ec3c3b99 |
| files | en/doc/handbook/index.html en/doc/handbook/install.html en/doc/handbook/livecd.html en/doc/handbook/liveusb.html en/doc/handbook/system-admin.html en/doc/handbook/x-window.html |
line diff
1.1 --- a/en/doc/handbook/index.html Fri Apr 04 22:48:44 2008 +0000 1.2 +++ b/en/doc/handbook/index.html Mon Apr 07 14:10:16 2008 +0200 1.3 @@ -34,6 +34,7 @@ 1.4 <ul> 1.5 <li><a href="livecd.html">LiveCD usage</a> - How to boot and set options 1.6 at the command prompt.</li> 1.7 + <li><a href="install.html">Installation</a> - HD install instructions.</li> 1.8 <li><a href="packages.html">Packages</a> - Install more software, keep 1.9 system up-to-date.</li> 1.10 <li><a href="network-config.html">Network configuration</a> - Ethernet, DHCP,
2.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 2.2 +++ b/en/doc/handbook/install.html Mon Apr 07 14:10:16 2008 +0200 2.3 @@ -0,0 +1,234 @@ 2.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 2.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 2.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 2.7 +<head> 2.8 + <title>SliTaz - HD Installation</title> 2.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 2.10 + <meta name="description" content="slitaz English handbook installation" /> 2.11 + <meta name="expires" content="never" /> 2.12 + <meta name="modified" content="2008-04-07 11:30:00" /> 2.13 + <meta name="publisher" content="www.slitaz.org" /> 2.14 + <meta name="author" content="Christophe Lincoln"/> 2.15 + <link rel="shortcut icon" href="favicon.ico" /> 2.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 2.17 +</head> 2.18 +<body bgcolor="#ffffff"> 2.19 + 2.20 +<!-- Header and quick navigation --> 2.21 +<div id="header"> 2.22 +<div align="right" id="quicknav"> 2.23 + <a name="top"></a> 2.24 + <a href="packages.html">Packages</a> | 2.25 + <a href="index.html">Table of contents</a> 2.26 +</div> 2.27 +<h1><font color="#3E1220">SliTaz Handbook (en)</font></h1> 2.28 +</div> 2.29 + 2.30 +<!-- Content. --> 2.31 +<div id="content"> 2.32 +<div class="content-right"></div> 2.33 + 2.34 +<h2><font color="#DF8F06">HD Installation</font></h2> 2.35 + 2.36 +<ul> 2.37 + <li><a href="#intro">Introduction.</a></li> 2.38 + <li><a href="#installer">SliTaz Installer.</a></li> 2.39 + <li><a href="#byhand">Installation by hand.</a></li> 2.40 + <li><a href="#grub">GRUB bootloader.</a></li> 2.41 +</ul> 2.42 + 2.43 +<a name="intro"></a> 2.44 +<h3>Introduction</h3> 2.45 +<p> 2.46 +This document give some informations and necessary instructions on how to 2.47 +install SliTaz on a hard disk. You will need about 10 minutes, SliTaz core 2.48 +LiveCD expand to 80 Mb so we suggest a minimum of 120 Mb of free space like 2.49 +this you will be able to install a few more packages. If you can 2.50 +<a href="livecd.html">use the LiveCD</a>, you should be able to install SliTaz. 2.51 +</p> 2.52 + 2.53 +<a name="installer"></a> 2.54 +<h3>SliTaz Installer</h3> 2.55 +<p> 2.56 +SliTaz provide a simple to use Installer who can be launch from the 2.57 +"System Tools" menu. SliTaz 1.0 Installer messages are only in French and can 2.58 +be considered as an errata, but English speakers should manage to use it with 2.59 +this complemantary documentation. 2.60 +</p> 2.61 +<h4>Install type</h4> 2.62 +<p> 2.63 +The first step let you choose the type of installation: new install or system 2.64 +upgrade. In most case you will want a new and clean installation. When accepted 2.65 +the installer will mount the master cdrom device and search for the compressed 2.66 +filesystem (<code>rootfs.gz</code>). If any filesystem was found installation 2.67 +will abort. 2.68 +</p> 2.69 +<p> 2.70 +If you get into trouble because the compressed filesystem is not found, please 2.71 +check that SliTaz is in the master CD/DVD device, if the problem persist you 2.72 +can use a downloaded ISO image and mount it on <code>/media/cdrom</code> where 2.73 +the HD Installer wanted to find it: 2.74 +</p> 2.75 +<pre> 2.76 + # mount -o loop slitaz-1.0.iso /media/cdrom 2.77 +</pre> 2.78 +<h4>Target partition</h4> 2.79 +<p> 2.80 +Second step is the partition configuration. If you have already a free partition 2.81 +you can directly use it, if not you will have to creat one graphicaly with 2.82 +Gparted or from the command line with fdisk. For example if you want to install 2.83 +SliTaz on the first partition of the first disk recognized as <code>hda</code>: 2.84 +</p> 2.85 +<pre class="script"> 2.86 +/dev/hda1 2.87 +</pre> 2.88 +<h4>Formating</h4> 2.89 +<p> 2.90 +The next step let you format the target partition into <code>ext3</code>. Ext3 2.91 +is a robust, stable and journalised filesystem. If the partition is already 2.92 +formated you dont need to reformat if not just accept. Warning formating a 2.93 +partition will destroy all current data. 2.94 +</p> 2.95 +<h4>Hostname</h4> 2.96 +<p> 2.97 +Hostname configuration let you set the machine name. The hostname is used 2.98 +internaly and to indentify the host on the network. This value can also be 2.99 +changed when the system is installed. 2.100 +</p> 2.101 +<h4>Bootloader - GRUB</h4> 2.102 +<p> 2.103 +When the installation process is finish you have the option to install the GRUB 2.104 +bootloader who is capable of booting almost all kind of operating system. If 2.105 +you want to use an existing GRUB installation, skip this step and add the 2.106 +correct lines to your GRUB configuration file (<code>menu.lst</code>). Note 2.107 +that SliTaz Installer created a configuration file on the target who can be 2.108 +used as example (/mnt/target/boot/grub/menu.lst). 2.109 +</p> 2.110 +<h4>End of installation</h4> 2.111 +<p> 2.112 +When the Installer did all his job you have the option to exit or directly 2.113 +reboot on your new SliTaz GNU/Linux operating system. First boot is like the 2.114 +LiveCD, you will be prompt for locale, keyboard, sound card and screen 2.115 +selection, future reboot will not prompt you anymore for configuration but 2.116 +all the values can be changed manually or with the project tools such as 2.117 +<code>tazlocale</code> or <code>tazx</code>. 2.118 +</p> 2.119 + 2.120 +<a name="byhand"></a> 2.121 +<h3>Installation by hand</h3> 2.122 +<p> 2.123 +SliTaz can also be installed by hand from the command line. To install SliTaz 2.124 +by hand you can use a cdrom or an ISO image. The given commands can be 2.125 +copy/past from Firefox to Xterm. 2.126 +</p> 2.127 +<p> 2.128 +The first thing you have to do is prepare a target partition and mount it. 2.129 +Example using partition <code>/dev/hda1</code>: 2.130 +</p> 2.131 +<pre> 2.132 + # mkdir /mnt/target 2.133 + # mount /dev/hda1 /mnt/target 2.134 +</pre> 2.135 +<h4>Mount cdrom or ISO image</h4> 2.136 +<p> 2.137 +Now you have to mount the cdrom: 2.138 +</p> 2.139 +<pre> 2.140 + # mount /dev/cdrom /media/cdrom 2.141 +</pre> 2.142 +<p> 2.143 +Or an ISO image 2.144 +</p> 2.145 +<pre> 2.146 + # mount -o loop slitaz-1.0.iso /media/cdrom 2.147 +</pre> 2.148 +<h4>Install and extract</h4> 2.149 +<p> 2.150 +The goal now is to copy neede files from the media into the target partition 2.151 +and then extract the compressed filesystem (<code>rootfs.gz</code>). Creat a 2.152 +boot directory and install the Linux Kernel: 2.153 +</p> 2.154 +<pre> 2.155 + # mkdir /mnt/target/boot 2.156 + # cp -a /media/cdrom/boot/vmlinuz-* /mnt/target/boot 2.157 +</pre> 2.158 +<p> 2.159 +Copy the rootfs: 2.160 +</p> 2.161 +<pre> 2.162 + # cp /media/cdrom/boot/rootfs.gz /mnt/target 2.163 +</pre> 2.164 +<p> 2.165 +Now the necessary files are present so you can change directory (<code>cd</code>) 2.166 +to the target and uncompress the the filesystem with <code>lzma</code> and 2.167 +<code>cpio</code>: 2.168 +</p> 2.169 +<pre> 2.170 + # cd /mnt/target 2.171 + # lzma d rootfs.gz -so | cpio -id 2.172 + # rm rootfs.gz init 2.173 +</pre> 2.174 +<p> 2.175 +That's all, SliTaz is installed. Before rebooting on you new SliTaz GNU/Linux 2.176 +installation please check that you have a bootloader (GRUB or Lilo) and add 2.177 +the necessary lines to boot SliTaz. 2.178 +</p> 2.179 + 2.180 +<a name="grub"></a> 2.181 +<h3>GRUB bootloader</h3> 2.182 +<p> 2.183 +GRUB is an universal bootloader capable of booting almost all operating such 2.184 +as Linux, BSD or Windows. GRUB use single configuration file named 2.185 +<code>menu.lst</code>, if you used <a href="#installer">SliTaz Installer</a> 2.186 +and installed GRUB you dont need to install manually GRUB, just reboot. 2.187 +</p> 2.188 +<p> 2.189 +Installation of GRUB onto the mbr, using root directory /mnt/target (the taget 2.190 +mounted partition) and the disk named <code>hda</code>: 2.191 +</p> 2.192 +<pre> 2.193 + # grub-install --root-directory=/mnt/target /dev/hda 2.194 +</pre> 2.195 +<p> 2.196 +You can now creat GRUB configuration file and add the lines who will boot 2.197 +SliTaz. Menu.lst can be edited with your favorite text editor such as Nano or 2.198 +Leafpad: 2.199 +</p> 2.200 +<pre> 2.201 + # leafpad /mnt/target/boot/grub/menu.lst 2.202 +</pre> 2.203 +<h4>/boot/grub/menu.lst - Example</h4> 2.204 +<pre class="script"> 2.205 + 2.206 +title SliTaz GNU/Linux 1.0 (Kernel 2.6.24.2-slitaz) 2.207 + root(hd0,0) 2.208 + kernel /boot/vmlinuz-2.6.24.2-slitaz root=/dev/hda1 vga=normal 2.209 + 2.210 +</pre> 2.211 +<p> 2.212 +Verify again that everything is in place before rebooting: 2.213 +</p> 2.214 +<pre> 2.215 + # reboot 2.216 +</pre> 2.217 + 2.218 +<!-- End of content --> 2.219 +</div> 2.220 + 2.221 +<!-- Footer. --> 2.222 +<div id="footer"> 2.223 + <div class="footer-right"></div> 2.224 + <a href="#top">Top of the page</a> | 2.225 + <a href="index.html">Table of contents</a> 2.226 +</div> 2.227 + 2.228 +<div id="copy"> 2.229 + Copyright © 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> - 2.230 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 2.231 + Documentation is under 2.232 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 2.233 + and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>. 2.234 +</div> 2.235 + 2.236 +</body> 2.237 +</html>
3.1 --- a/en/doc/handbook/livecd.html Fri Apr 04 22:48:44 2008 +0000 3.2 +++ b/en/doc/handbook/livecd.html Mon Apr 07 14:10:16 2008 +0200 3.3 @@ -18,7 +18,7 @@ 3.4 <div id="header"> 3.5 <div align="right" id="quicknav"> 3.6 <a name="top"></a> 3.7 - <a href="packages.html">Packages</a> | 3.8 + <a href="install.html">Installation</a> | 3.9 <a href="index.html">Table of contents</a> 3.10 </div> 3.11 <h1><font color="#3E1220">SliTaz Handbook (en)</font></h1>
4.1 --- a/en/doc/handbook/liveusb.html Fri Apr 04 22:48:44 2008 +0000 4.2 +++ b/en/doc/handbook/liveusb.html Mon Apr 07 14:10:16 2008 +0200 4.3 @@ -27,7 +27,7 @@ 4.4 <div id="content"> 4.5 <div class="content-right"></div> 4.6 4.7 -<h2><font color="#DF8F06">Tazusb</font></h2> 4.8 +<h2><font color="#DF8F06">LiveUSB media</font></h2> 4.9 4.10 <a name="tazusb"></a> 4.11 <h3>Tazusb - Live USB Tool</h3>
5.1 --- a/en/doc/handbook/system-admin.html Fri Apr 04 22:48:44 2008 +0000 5.2 +++ b/en/doc/handbook/system-admin.html Mon Apr 07 14:10:16 2008 +0200 5.3 @@ -34,8 +34,8 @@ 5.4 <li><a href="#devices">Devices and disks access.</a></li> 5.5 <li><a href="#users-admin">Users, groups and passwords.</a></li> 5.6 <li><a href="#locale">Language and keyboard.</a></li> 5.7 - <li><a href="#bash">Install the Bash shell.</a></li> 5.8 - <li><a href="#time">Adjust the system time.</a></li> 5.9 + <li><a href="#bash">Install the Bash shell.</a></li> 5.10 + <li><a href="#time">Set the system time.</a></li> 5.11 </ul> 5.12 5.13 <a name="devices"></a> 5.14 @@ -131,7 +131,7 @@ 5.15 as <code>su</code> install bash, copy the <code>.profile</code> found in your 5.16 home directory and rename it <code>.bashrc</code>, then edit the 5.17 <code>/etc/passwd</code> file with your favorite text editor and change your 5.18 -shell to: /bin/bash 5.19 +shell to :/bin/bash 5.20 </p> 5.21 <pre> 5.22 # tazpkg get-install bash 5.23 @@ -207,4 +207,3 @@ 5.24 5.25 </body> 5.26 </html> 5.27 -
6.1 --- a/en/doc/handbook/x-window.html Fri Apr 04 22:48:44 2008 +0000 6.2 +++ b/en/doc/handbook/x-window.html Mon Apr 07 14:10:16 2008 +0200 6.3 @@ -4,11 +4,11 @@ 6.4 <head> 6.5 <title>SliTaz Handbook (en) - X Window System</title> 6.6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 6.7 - <meta name="description" content="slitaz English handbook" /> 6.8 + <meta name="description" content="slitaz English handbook X server window manager jwm openbox e17 slim login" /> 6.9 <meta name="expires" content="never" /> 6.10 <meta name="modified" content="2008-03-01 22:30:00" /> 6.11 <meta name="publisher" content="www.slitaz.org" /> 6.12 - <meta name="author" content="Christophe Lincoln"/> 6.13 + <meta name="author" content="Christophe Lincoln, Paul Issot"/> 6.14 <link rel="shortcut icon" href="favicon.ico" /> 6.15 <link rel="stylesheet" type="text/css" href="book.css" /> 6.16 </head> 6.17 @@ -32,10 +32,11 @@ 6.18 6.19 <ul> 6.20 <li><a href="#X11">X Window System</a></li> 6.21 - <li><a href="#slim">Slim.</a></li> 6.22 - <li><a href="#jwm">JWM.</a></li> 6.23 - <li><a href="#enlightenment">Enlightenment (e17).</a></li> 6.24 - <li><a href="#openbox">Openbox.</a></li> 6.25 + <li><a href="#slim">Slim</a> - Simple Login Manager</li> 6.26 + <li><a href="#jwm">JWM</a> - Window Manager</li> 6.27 + <li><a href="#enlightenment">Enlightenment (e17)</a> - Desktop 6.28 + environement.</li> 6.29 + <li><a href="#openbox">Openbox</a> - Window Manager.</li> 6.30 </ul> 6.31 6.32 <a name="X11"></a> 6.33 @@ -69,6 +70,16 @@ 6.34 More details and themes can be found on the 6.35 <a href="http://slim.berlios.de">website.</a> 6.36 </p> 6.37 +<h4>Default user</h4> 6.38 +<p> 6.39 +Slim offer a way to pre-load a user login name, by defaut hacker is configured 6.40 +for convenience. You can change this by editing Slim configuration file 6.41 +<code>/etc/slim.conf</code> and modifiy the line <code>default_user</code> or 6.42 +leave the line blank to avoid pre-loading user name. Example: 6.43 +</p> 6.44 +<pre class="script"> 6.45 +default_user hacker 6.46 +</pre> 6.47 6.48 <a name="jwm"></a> 6.49 <h3>JWM - Window manager</h3> 6.50 @@ -94,7 +105,8 @@ 6.51 Enlightenment aka e17 is a lightweight and fast desktop environment that can be 6.52 configured graphically. To install e17: 6.53 </p> 6.54 -<pre> # tazpkg get-install enlightenment 6.55 +<pre> 6.56 + # tazpkg get-install enlightenment 6.57 </pre> 6.58 <p> 6.59 Logout your current X session, type <code>F1</code> at Slim login and choose 6.60 @@ -107,8 +119,9 @@ 6.61 Openbox is a lightweight window manager than can be configured using the obconf 6.62 utility. To install openbox: 6.63 </p> 6.64 -<pre># tazpkg get-install openbox 6.65 -# tazpkg get-install obconf 6.66 +<pre> 6.67 + # tazpkg get-install openbox 6.68 + # tazpkg get-install obconf 6.69 </pre> 6.70 <p> 6.71 Logout your current X session, type <code>F1</code> at Slim login and choose