website annotate 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
rev   line source
pankso@16 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
pankso@16 2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
pankso@16 3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
pankso@16 4 <head>
pankso@16 5 <title>SliTaz - HD Installation</title>
pankso@16 6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
pankso@16 7 <meta name="description" content="slitaz English handbook installation" />
pankso@16 8 <meta name="expires" content="never" />
pankso@16 9 <meta name="modified" content="2008-04-07 11:30:00" />
pankso@16 10 <meta name="publisher" content="www.slitaz.org" />
pankso@16 11 <meta name="author" content="Christophe Lincoln"/>
pankso@16 12 <link rel="shortcut icon" href="favicon.ico" />
pankso@16 13 <link rel="stylesheet" type="text/css" href="book.css" />
pankso@16 14 </head>
pankso@16 15 <body bgcolor="#ffffff">
pankso@16 16
pankso@16 17 <!-- Header and quick navigation -->
pankso@16 18 <div id="header">
pankso@16 19 <div align="right" id="quicknav">
pankso@16 20 <a name="top"></a>
pankso@16 21 <a href="packages.html">Packages</a> |
pankso@16 22 <a href="index.html">Table of contents</a>
pankso@16 23 </div>
pankso@16 24 <h1><font color="#3E1220">SliTaz Handbook (en)</font></h1>
pankso@16 25 </div>
pankso@16 26
pankso@16 27 <!-- Content. -->
pankso@16 28 <div id="content">
pankso@16 29 <div class="content-right"></div>
pankso@16 30
pankso@16 31 <h2><font color="#DF8F06">HD Installation</font></h2>
pankso@16 32
pankso@16 33 <ul>
pankso@16 34 <li><a href="#intro">Introduction.</a></li>
pankso@16 35 <li><a href="#installer">SliTaz Installer.</a></li>
pankso@16 36 <li><a href="#byhand">Installation by hand.</a></li>
pankso@16 37 <li><a href="#grub">GRUB bootloader.</a></li>
pankso@16 38 </ul>
pankso@16 39
pankso@16 40 <a name="intro"></a>
pankso@16 41 <h3>Introduction</h3>
pankso@16 42 <p>
pankso@16 43 This document give some informations and necessary instructions on how to
pankso@16 44 install SliTaz on a hard disk. You will need about 10 minutes, SliTaz core
pankso@16 45 LiveCD expand to 80 Mb so we suggest a minimum of 120 Mb of free space like
pankso@16 46 this you will be able to install a few more packages. If you can
pankso@16 47 <a href="livecd.html">use the LiveCD</a>, you should be able to install SliTaz.
pankso@16 48 </p>
pankso@16 49
pankso@16 50 <a name="installer"></a>
pankso@16 51 <h3>SliTaz Installer</h3>
pankso@16 52 <p>
pankso@16 53 SliTaz provide a simple to use Installer who can be launch from the
pankso@16 54 "System Tools" menu. SliTaz 1.0 Installer messages are only in French and can
pankso@16 55 be considered as an errata, but English speakers should manage to use it with
pankso@16 56 this complemantary documentation.
pankso@16 57 </p>
pankso@16 58 <h4>Install type</h4>
pankso@16 59 <p>
pankso@16 60 The first step let you choose the type of installation: new install or system
pankso@16 61 upgrade. In most case you will want a new and clean installation. When accepted
pankso@16 62 the installer will mount the master cdrom device and search for the compressed
pankso@16 63 filesystem (<code>rootfs.gz</code>). If any filesystem was found installation
pankso@16 64 will abort.
pankso@16 65 </p>
pankso@16 66 <p>
pankso@16 67 If you get into trouble because the compressed filesystem is not found, please
pankso@16 68 check that SliTaz is in the master CD/DVD device, if the problem persist you
pankso@16 69 can use a downloaded ISO image and mount it on <code>/media/cdrom</code> where
pankso@16 70 the HD Installer wanted to find it:
pankso@16 71 </p>
pankso@16 72 <pre>
pankso@16 73 # mount -o loop slitaz-1.0.iso /media/cdrom
pankso@16 74 </pre>
pankso@16 75 <h4>Target partition</h4>
pankso@16 76 <p>
pankso@16 77 Second step is the partition configuration. If you have already a free partition
pankso@16 78 you can directly use it, if not you will have to creat one graphicaly with
pankso@16 79 Gparted or from the command line with fdisk. For example if you want to install
pankso@16 80 SliTaz on the first partition of the first disk recognized as <code>hda</code>:
pankso@16 81 </p>
pankso@16 82 <pre class="script">
pankso@16 83 /dev/hda1
pankso@16 84 </pre>
pankso@16 85 <h4>Formating</h4>
pankso@16 86 <p>
pankso@16 87 The next step let you format the target partition into <code>ext3</code>. Ext3
pankso@16 88 is a robust, stable and journalised filesystem. If the partition is already
pankso@16 89 formated you dont need to reformat if not just accept. Warning formating a
pankso@16 90 partition will destroy all current data.
pankso@16 91 </p>
pankso@16 92 <h4>Hostname</h4>
pankso@16 93 <p>
pankso@16 94 Hostname configuration let you set the machine name. The hostname is used
pankso@16 95 internaly and to indentify the host on the network. This value can also be
pankso@16 96 changed when the system is installed.
pankso@16 97 </p>
pankso@16 98 <h4>Bootloader - GRUB</h4>
pankso@16 99 <p>
pankso@16 100 When the installation process is finish you have the option to install the GRUB
pankso@16 101 bootloader who is capable of booting almost all kind of operating system. If
pankso@16 102 you want to use an existing GRUB installation, skip this step and add the
pankso@16 103 correct lines to your GRUB configuration file (<code>menu.lst</code>). Note
pankso@16 104 that SliTaz Installer created a configuration file on the target who can be
pankso@16 105 used as example (/mnt/target/boot/grub/menu.lst).
pankso@16 106 </p>
pankso@16 107 <h4>End of installation</h4>
pankso@16 108 <p>
pankso@16 109 When the Installer did all his job you have the option to exit or directly
pankso@16 110 reboot on your new SliTaz GNU/Linux operating system. First boot is like the
pankso@16 111 LiveCD, you will be prompt for locale, keyboard, sound card and screen
pankso@16 112 selection, future reboot will not prompt you anymore for configuration but
pankso@16 113 all the values can be changed manually or with the project tools such as
pankso@16 114 <code>tazlocale</code> or <code>tazx</code>.
pankso@16 115 </p>
pankso@16 116
pankso@16 117 <a name="byhand"></a>
pankso@16 118 <h3>Installation by hand</h3>
pankso@16 119 <p>
pankso@16 120 SliTaz can also be installed by hand from the command line. To install SliTaz
pankso@16 121 by hand you can use a cdrom or an ISO image. The given commands can be
pankso@16 122 copy/past from Firefox to Xterm.
pankso@16 123 </p>
pankso@16 124 <p>
pankso@16 125 The first thing you have to do is prepare a target partition and mount it.
pankso@16 126 Example using partition <code>/dev/hda1</code>:
pankso@16 127 </p>
pankso@16 128 <pre>
pankso@16 129 # mkdir /mnt/target
pankso@16 130 # mount /dev/hda1 /mnt/target
pankso@16 131 </pre>
pankso@16 132 <h4>Mount cdrom or ISO image</h4>
pankso@16 133 <p>
pankso@16 134 Now you have to mount the cdrom:
pankso@16 135 </p>
pankso@16 136 <pre>
pankso@16 137 # mount /dev/cdrom /media/cdrom
pankso@16 138 </pre>
pankso@16 139 <p>
pankso@16 140 Or an ISO image
pankso@16 141 </p>
pankso@16 142 <pre>
pankso@16 143 # mount -o loop slitaz-1.0.iso /media/cdrom
pankso@16 144 </pre>
pankso@16 145 <h4>Install and extract</h4>
pankso@16 146 <p>
pankso@16 147 The goal now is to copy neede files from the media into the target partition
pankso@16 148 and then extract the compressed filesystem (<code>rootfs.gz</code>). Creat a
pankso@16 149 boot directory and install the Linux Kernel:
pankso@16 150 </p>
pankso@16 151 <pre>
pankso@16 152 # mkdir /mnt/target/boot
pankso@16 153 # cp -a /media/cdrom/boot/vmlinuz-* /mnt/target/boot
pankso@16 154 </pre>
pankso@16 155 <p>
pankso@16 156 Copy the rootfs:
pankso@16 157 </p>
pankso@16 158 <pre>
pankso@16 159 # cp /media/cdrom/boot/rootfs.gz /mnt/target
pankso@16 160 </pre>
pankso@16 161 <p>
pankso@16 162 Now the necessary files are present so you can change directory (<code>cd</code>)
pankso@16 163 to the target and uncompress the the filesystem with <code>lzma</code> and
pankso@16 164 <code>cpio</code>:
pankso@16 165 </p>
pankso@16 166 <pre>
pankso@16 167 # cd /mnt/target
pankso@16 168 # lzma d rootfs.gz -so | cpio -id
pankso@16 169 # rm rootfs.gz init
pankso@16 170 </pre>
pankso@16 171 <p>
pankso@16 172 That's all, SliTaz is installed. Before rebooting on you new SliTaz GNU/Linux
pankso@16 173 installation please check that you have a bootloader (GRUB or Lilo) and add
pankso@16 174 the necessary lines to boot SliTaz.
pankso@16 175 </p>
pankso@16 176
pankso@16 177 <a name="grub"></a>
pankso@16 178 <h3>GRUB bootloader</h3>
pankso@16 179 <p>
pankso@16 180 GRUB is an universal bootloader capable of booting almost all operating such
pankso@16 181 as Linux, BSD or Windows. GRUB use single configuration file named
pankso@16 182 <code>menu.lst</code>, if you used <a href="#installer">SliTaz Installer</a>
pankso@16 183 and installed GRUB you dont need to install manually GRUB, just reboot.
pankso@16 184 </p>
pankso@16 185 <p>
pankso@16 186 Installation of GRUB onto the mbr, using root directory /mnt/target (the taget
pankso@16 187 mounted partition) and the disk named <code>hda</code>:
pankso@16 188 </p>
pankso@16 189 <pre>
pankso@16 190 # grub-install --root-directory=/mnt/target /dev/hda
pankso@16 191 </pre>
pankso@16 192 <p>
pankso@16 193 You can now creat GRUB configuration file and add the lines who will boot
pankso@16 194 SliTaz. Menu.lst can be edited with your favorite text editor such as Nano or
pankso@16 195 Leafpad:
pankso@16 196 </p>
pankso@16 197 <pre>
pankso@16 198 # leafpad /mnt/target/boot/grub/menu.lst
pankso@16 199 </pre>
pankso@16 200 <h4>/boot/grub/menu.lst - Example</h4>
pankso@16 201 <pre class="script">
pankso@16 202
pankso@16 203 title SliTaz GNU/Linux 1.0 (Kernel 2.6.24.2-slitaz)
pankso@16 204 root(hd0,0)
pankso@16 205 kernel /boot/vmlinuz-2.6.24.2-slitaz root=/dev/hda1 vga=normal
pankso@16 206
pankso@16 207 </pre>
pankso@16 208 <p>
pankso@16 209 Verify again that everything is in place before rebooting:
pankso@16 210 </p>
pankso@16 211 <pre>
pankso@16 212 # reboot
pankso@16 213 </pre>
pankso@16 214
pankso@16 215 <!-- End of content -->
pankso@16 216 </div>
pankso@16 217
pankso@16 218 <!-- Footer. -->
pankso@16 219 <div id="footer">
pankso@16 220 <div class="footer-right"></div>
pankso@16 221 <a href="#top">Top of the page</a> |
pankso@16 222 <a href="index.html">Table of contents</a>
pankso@16 223 </div>
pankso@16 224
pankso@16 225 <div id="copy">
pankso@16 226 Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
pankso@16 227 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
pankso@16 228 Documentation is under
pankso@16 229 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
pankso@16 230 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
pankso@16 231 </div>
pankso@16 232
pankso@16 233 </body>
pankso@16 234 </html>