[[PageOutline]]

= ImageServer installation =

First download the stable version of SALI from:
  - ftp://ftp.surfsara.nl/pub/sali/sali.tar.gz. 

Extract the tarball
{{{
# cd /var/tmp
# wget ftp://ftp.surfsara.nl/pub/sali/sali.tar.gz
# tar xvf sali.tar.gz
}}}

All files are available in the directory ```sali-VERSION```

== DHCP configuration ==

For PXE booting you will need to install a DHCP server. On our site we use the isc DHCP server. The configuration here below shows an example on how to configure the pxeboot functionality on your network.

{{{
# define the option
option sali-imgsrv code 224 = ip-address;

# Admin network
#
subnet 192.168.144.0 netmask 255.255.248.0 {
  # The value for sali-imgsrv has to be an ip address
  option sali-imgsrv 192.168.146.10;
  next-server 192.168.146.10;
  filename "pxelinux.0";
}
}}}

Optional you can specify a special dhcp option that SALI uses to identify which imageserver must be used. We have chosen for option code 224.


== TFTP/PXE environment ==

Make sure that the your PXE-enabled network card is your first boot device. So you will have complete control of your node.

=== TFTP ===

To setup a TFTP enviroment you can visit one of the following pages
 - RedHat/Centos/Fedora, http://www.thelinuxdaily.com/2010/02/guide-on-tftp-server-setup-in-fedora/
 - Ubuntu/Debian, http://mohammadthalif.wordpress.com/2010/03/05/installing-and-testing-tftpd-in-ubuntudebian/
 - SUSE/OpenSuse, http://sellingfreesoftwareforaliving.blogspot.nl/2011/11/install-and-configure-tftp-server-for.html


Copy the following files from the extracted tar.gz to your tftp directory. Depending on your operating systems this can be ```/srv/tftpboot, /var/lib/tftboot```. In our examples we shall use ```/data/tftp```
{{{
# cd /data/tftp
# mkdir sali
# cd sali/
# cp -a /var/tmp/sali-1.5.8/x86_64 .
# ls -1 x86_64/
initrd.img
kernel
# ln -s x86_64 default
}}}

=== PXE ===
To setup a dynamic PXE environment visit our project [https://oss.trac.surfsara.nl/pxeconfig pxeconfig]

If you have setup you PXE environment you copy the example file to the `pxelinux.cfg` directory in your `tftp` root.
{{{
# cd /var/tmp/sali-1.5.8/examples
# cp pxelinux.example /data/tftp/pxelinux.cfg/default.sali__test
}}}

The default action of the `default.sali_test` is to start a SALI rescue shell:
{{{
# pxeconfig <nodename> -f default.sali_test
}}}



== SALI Server Tools ==