wiki:SaliHowto

Version 12 (modified by dennis, 12 years ago) (diff)

--

Howto install

This is a short howto install and configure SALI.

Installation

You can fetch the latest stable from:

or build the latest version:

Extract the tarball into the tftpboot directory on your installation host. At SARA we use atftp (advance tftp server). The tftpboot directory at SARA is /data/tftpboot. We use this directory in this 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

The example/pxelinux.example included in the tarball requires that this link exists:

cd /data/tftpboot/sali
ln -s x86_64 trunk

Configuration

Before you boot SALI from tftp you first must configure the IMAGESERVER variable. SALI uses this variable to determine if your central image server is reachable. If this is not the case SALI will stop the startup process.

There are two ways to configure this:

  1. Specify IMAGSERVER=<ip> in your pxe file as a KERNEL parameter
  2. Specify the ip of the imageserver in your dhcp configuration

An example for isc dhcpd server

## Support for the SALI and the 'old' imageserver settings
#
option option-140 code 140 = text;
option sali-imgsrv code 224 = ip-address;

# Admin network
#
subnet 192.168.144.0 netmask 255.255.248.0 {
  ##  option-140 is the IP address of your SystemImager server
  #    sali-imgsrv is the new setting for the Systemimager server
  #
  option sali-imgsrv 192.168.146.10;
  option option-140 "192.168.146.10";
  next-server 192.168.146.10;
....
}

For a bit more information see this wiki page

Test

To test the installation copy the pxelinux.example to your pxelinux.cfg directory, is your tftpboot directory with pxelinux.cfg appended. See SARA pxeconfig utility:

cp /data/tftpboot/sali/x86_64/example/pxelinux.example /data/tftpboot/pxelinux.cfg/default.sali_test

The default action for pxelinux.example is to start a shell and you can login on the node via ssh. With the aid of SARA pxeconfig utility you can instruct a node to use this configuration file, eg:

pxeconfig gb-r7n2 -f default.sali_test

If you haven't change your dhcpd configuration to specify the variable IMAGESERVER you must add it to your pxe file.

Reboot the node and if your node has a Remote Access Card take over the console and see how the node boots. If the node has finished the boot process you can login on the node:

ssh gb-r7n2

The default password for SALI is SaliRoot. If you can login and execute a command you have successfully installed SALI:

gb-r7n2:~ root# uname -a
Linux gb-r7n2.irc.sara.nl 3.1.4-sali_v1.5.0 #1 SMP Tue Mar 6 16:18:17 CET 2012 x86_64 GNU/Linux