[[PageOutline]]
= Howto =

This is a short howto install and configure SALI.

== Installation == 

You can fetch the latest stable from:
 * ftp://ftp.sara.nl/pub/sali/sali.tar.gz

or build the latest version:
 * [wiki:SaliRequirements build latest version from source]

Extract the tarball into the ''tftpboot directory'' on your installation host. At SARA we use [http://freecode.com/projects/atftp atftp (advance tftp server)]. The `tftpboot directory' at SARA is `/data/tftpboot'. We use this directory in our howto.
{{{
cd /data/tftpboot
mkdir sali
tar xvzf sali.tar.gz
-rw-r--r-- root/root       166 2012-04-18 15:32 AUTHORS
-rw-r--r-- root/root     11688 2012-04-18 15:32 CHANGELOG
-rw-r--r-- root/root     10299 2012-04-18 15:32 CREDITS
drwxr-xr-x root/root         0 2012-04-18 15:32 example/
-rw-r--r-- root/root      1186 2012-02-14 11:00 example/pxelinux.example
-rw-r--r-- root/root     24021 2012-02-14 11:00 example/masterscript.old
drwxr-xr-x root/root         0 2012-04-18 15:32 example/post-install/
-rw-r--r-- root/root      1038 2012-03-08 16:21 example/post-install/02all.bootloader
-rw-r--r-- root/root       662 2012-03-02 08:51 example/post-install/98all.pxeconfig
-rw-r--r-- root/root      4125 2012-03-08 16:02 example/masterscript.new
-rw-r--r-- root/root      7651 2012-04-18 15:32 LICENSE
-rw-r--r-- root/root       445 2012-04-18 15:32 README
-rw-r--r-- root/root         6 2012-04-18 15:32 VERSION
drwxr-xr-x root/root         0 2012-04-18 15:32 x86_64/
-rw-r--r-- root/root  26269984 2012-04-18 15:32 x86_64/initrd.img
-rw-r--r-- root/root   2260864 2012-04-18 15:32 x86_64/kernel
}}}

To make sure that the include `example/pxelinux.example` works create this link:
{{{
cd /data/tftpboot/sali
ln -s x86_64 trunk
}}}

To test the installation copy the `pxelinux.example` to your ``pxelinux.cfg`` directory. Is your tftpboot directory  with `pxelinux.cfg` appended. See [https://subtrac.sara.nl/oss/pxeconfig SARA pxeconfig utility]:
{{{
cp /data/tftpboot/sali/x86_64/example/pxelinux.example /data/tftpboot/pxelinux.cfg/default.sali_test
}}}