Thruk¶

Shinken installation¶

Create a new user shinken:

adduser shinken

Important

Be sure to create a home directory for shinken user. If not, you will not be able to start the shinken arbiter.

Next step retrieve the last version of shinken and uncompress it:

tar xfv shinken-0.5.1.tar.gz

Get into this directory and install it on your system:

sudo python setup.py install --install-scripts=/usr/bin

You will get new binaries into /usr/bin (files shinken-*) and some new directory (/etc/shinken, /var/lib/shinken).

Now, to unleash the daemons (ah ah ah!), you can use the script in init.d, or create your own script like:

root@Enclume:/etc/init.d# more shinken.sh
#!/bin/bash
cd /etc/init.d

for script in shinken-scheduler shinken-poller shinken-reactionner shinken-broker shinken-arbiter
do
  ./$script $1
done

Start your deamon:

/etc/init.d/shinken.sh start

Now check that the shinken processes are up and running:

patrice@Enclume:~/tmp/shinken-0.4$ ps -u shinken
PID TTY          TIME CMD
?        00:00:09 shinken-schedul
?        00:00:10 shinken-poller
?        00:00:00 shinken-poller
?        00:00:09 shinken-reactio
?        00:00:00 shinken-reactio
?        00:00:13 shinken-broker
?        00:00:00 shinken-poller
?        00:00:00 shinken-poller
?        00:00:00 shinken-poller
?        00:00:18 shinken-broker
?        00:00:00 shinken-broker
?        00:00:00 shinken-reactio
?        00:00:00 shinken-poller
?        00:00:10 shinken-arbiter

Configure Thruk¶

Get a fresh copy of Thruk (http://www.thruk.org/download.html) then uncompress your version and get into the root directory.

Now, create a new file named thruk_local.conf. Bellow, the content of this file:

~/tmp/Thruk-0.74$ cat thruk_local.conf
######################################
# Backend Configuration, enter your backends here
<Component Thruk::Backend>
  <peer>
      name   = Shinken
      type   = livestatus
      <options>
          peer    = 127.0.0.1:50000
     </options>
  </peer>
#    <peer>
#        name   = External Icinga
#        type   = livestatus
#        <options>
#            peer    = 172.16.0.2:9999
#       </options>
#    </peer>
</Component>

Now launch the Thruk daemon:

~/tmp/Thruk-0.74/script$ ./thruk_server.pl
You can connect to your server at http://enclume:3000

Important

This article doesn’t describe a true Thruk installation with Apache connection. Please refer Thruk documentation to get a cleaner installation.

Now, run your favorite internet browser with http://localhost:3000 and enjoy your Shinken installation !