shinken_10min_start

Table of Contents

Goal

By following this tutorial, in 10 minutes you will have a fully installed monitoring tool for your network. Ready? Let's go.

Installation

On Ubuntu, Debian, CentOS, [add all OS here ;)]

Save time, use the shinken.sh installation script !

cd ~
wget http://www.shinken-monitoring.org/pub/shinken-0.8.1.tar.gz
tar xfz shinken-0.8.1.tar.gz
cd shinken-0.8.1
sudo chmod +x shinken.sh
sudo ./shinken.sh -i

You want more? A shinken.sh -h will show you what you can do :

check_esx3, nagios-plugins, check_oracle_health, check_mysql_health, check_wmi_plus, check_mongodb, check_emc_clariion, check_nwc_health, check_hpasm, capture_plugin, pnp4nagios, multisite

Just type shinken.sh -p <wanted_plugin> and you will be done :)

To be continued ;)

On windows

Get the http://shinken-monitoring.org/pub/shinken-0.8.1.tar.gz file in c:\shinken

During portions of the installation you'll need to have administrator access to your server. Make sure you've installed the following packages on your Windows installation before continuing.

Take the files instsrv.exe and srvany.exe from the directory of the resource kit (typically “c:\program files\Windows Resource Kits\Tools”) and put them in the directory “c:\shinken\windows” (it should already exist by decompressing the archive, or you are a directory level to deep).

To install all services, launch the installation batch file :

c:\shinken\windows\install-all.bat

Launch services.msc to see you brand new services (Shinken-*).

But don't start them yet, you should jump up to the discovery part before starting new Shinken services.

On Fedora with RPM

Prerequisites :

Install python Pyro :

# yum install python-pyro

Install Shinken :

Download RPM to the url http://hvad.fedorapeople.org/fedora/shinken/RPM/

# yum localinstall --nogpgcheck shinken-0.8.1-1.fc15.noarch.rpm shinken-arbiter-0.8.1-1.fc15.noarch.rpm shinken-broker-0.8.1-1.fc15.noarch.rpm shinken-poller-0.8.1-1.fc15.noarch.rpm shinken-reactionner-0.8.1-1.fc15.noarch.rpm shinken-receiver-0.8.1-1.fc15.noarch.rpm shinken-scheduler-0.8.1-1.fc15.noarch.rpm

Enable Shinken services :

# for i in arbiter poller reactionner scheduler broker; do systemctl enable shinken-$i.service ; done    

Start Shinken services :

# for i in arbiter poller reactionner scheduler broker; do systemctl start shinken-$i.service ; done    

Stop Shinken services :

# for i in arbiter poller reactionner scheduler broker; do systemctl stop shinken-$i.service ; done 

On Debian with DEB packages

Shinken is packaged on the debian “sid” : Prerequisites :

aptitude install shinken python-simplejson python-pysqlite2 python-mysqldb python-redis python-memcache

Start Shinken services :

# for i in  broker poller reactionner receiver scheduler arbiter ; do /etc/init.d/shinken-$i start ;done

Stop Shinken services :

for i in  broker poller reactionner receiver scheduler arbiter ; do /etc/init.d/shinken-$i stop ;done

First launch

You are now ready to start the system, launch Shinken and Thruk.

/etc/init.d/shinken start
/etc/init.d/thruk start

You can validate that the software is running smoothly by tailing the main log file at :

tail -f /var/lib/shinken/shinken.log

And by connecting to the web interface at http://localhost:3000 (or use the IP address of your server)

Congrats, you just launched your next monitoring tool ^_^

Now you can go through the rest of the wiki to learn how to work with the configuration, and customize it as you need. There are tutorials in the getting started section for common tasks and there is an official documentation manual that provides in depth coverage of features and options.

Now are ready to learn how to configure the Shinken daemons, your gentle introduction to distributed monitoring, by reading the configure Shinken page.

shinken_10min_start.txt · Last modified: 2012/01/31 19:12 by seb-solon
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0