On this page
Shinken: Installation and Configuration of Nagios' Successor
| Software version | 1.2.2 |
| Operating System | Debian 7 |
| Website | Shinken Website |
| Last Update | 03/01/2013 |
Introduction
Shinken1 is an application for system and network monitoring. It monitors specified hosts and services, alerting when systems malfunction and when they recover. It is free software under the GNU AGPL license. It is fully compatible with Nagios and aims to provide distributed and highly available monitoring that’s easy to set up. Starting as a proof of concept for distributed architectures in Nagios, the program quickly demonstrated much better performance and flexibility than its predecessor.
Following the Nagios developers’ refusal in December 2009 to make Shinken the new development branch of Nagios in the future, Shinken can now be considered an independent system and network monitoring project.
Installation
We could choose to install Shinken from the official Debian repositories, but unfortunately, that’s an old version as the project evolves very quickly. There’s an official installer that will allow us to get the latest version and all necessary dependencies. First, let’s install curl:
aptitude install curl
Then we launch the installation:
> curl -L http://install.shinken-monitoring.org | /bin/bash
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0
100 1533 100 1533 0 0 9919 0 --:--:-- --:--:-- --:--:-- 9919
Preparing the temporary directory /tmp/shinken-install-MDZFhh6
######################################################################## 100.0%
Unziping the Shinken package shinken-1.2.2.tar.gz
+--------------------------------------------------------------------------------
| Verifying compatible distros
+--------------------------------------------------------------------------------
> Found DEBIAN (Debian 7 x86_64)
> Version checking for Debian is not needed
+--------------------------------------------------------------------------------
| Checking for existing installation
+--------------------------------------------------------------------------------
+--------------------------------------------------------------------------------
| Checking prerequisites
+--------------------------------------------------------------------------------
> Checking for wget: OK
> Checking for sed: OK
> Checking for awk: OK
> Checking for grep: OK
> Checking for python: OK
> Checking for bash: OK
> Installing build-essential
> Installing libperl-dev
> Installing python-setuptools
> Installing libsqlite3-dev
> Installing python-dev
> Installing pyro
> Installing sqlite3
> Installing nmap
> Installing unzip
> Installing libmysqlclient-dev
> Installing python-ldap
> Installing libevent-dev
> Module paramiko (paramiko) not found. Installing...
> Module netifaces (netifaces) not found. Installing...
> Module simplejson (simplejson) not found. Installing...
> Module pysqlite found.
> Module MySQL_python (MySQLdb) not found. Installing...
> Module pymongo (pymongo) not found. Installing...
> Module kombu (kombu) not found. Installing...
+--------------------------------------------------------------------------------
| Creating user
+--------------------------------------------------------------------------------
+--------------------------------------------------------------------------------
| Relocate source tree to /usr/local/shinken
+--------------------------------------------------------------------------------
> relocating macro /usr/local/shinken/install.d/tools/macros/enable_log_mongo.macro
> relocating macro /usr/local/shinken/install.d/tools/macros/enable_retention_mongo.macro
> relocating macro /usr/local/shinken/install.d/tools/macros/disable_npcd.macro
> relocating macro /usr/local/shinken/install.d/tools/macros/set_webui_ouptput_length.macro
> relocating macro /usr/local/shinken/install.d/tools/macros/enable_npcd.macro
> relocating macro /usr/local/shinken/install.d/tools/macros/control_satelites.macro
> relocating macro /usr/local/shinken/install.d/tools/macros/enable_retention.macro
> relocate nagios plugin path
> Processing ./FOR_DEV
> Processing ./FROM_NAGIOS_TO_SHINKEN
> Processing ./README
> Processing ./README.rst
> Processing ./contrib/nconf/deployment.ini
> Processing ./etc/resource.cfg
> Processing ./etc/shinken-specific.cfg
> Processing ./etc/shinken-specific.cfg.orig
> Processing ./external_commands/ACKNOWLEDGE_HOST_PROBLEM.sh
> Processing ./external_commands/ADD_POLLER.sh
> Processing ./external_commands/CHANGE_CONTACT_HOST_NOTIFICATION_TIMEPERIOD.sh
> Processing ./external_commands/PROCESS_HOST_CHECK_RESULT.sh
> Processing ./install
> Processing ./install.d/config.nconf/deployment.ini
> Processing ./install.d/config.nconf/nconf.php
> Processing ./install.d/shinken.conf
> Processing ./install.d/tools/macros/control_satelites.macro
> Processing ./install.d/tools/macros/disable_npcd.macro
> Processing ./install.d/tools/macros/enable_log_mongo.macro
> Processing ./install.d/tools/macros/enable_npcd.macro
> Processing ./install.d/tools/macros/enable_retention.macro
> Processing ./install.d/tools/macros/enable_retention_mongo.macro
> Processing ./install.d/tools/macros/set_webui_ouptput_length.macro
> Processing ./libexec/SAN_discover_runner.py
> Processing ./libexec/eue/glpi.ini
> Processing ./libexec/eue/glpi.ini.in
> Processing ./libexec/fs_discovery_runner.py
> Processing ./libexec/vmware_discovery_runner.py
> Processing ./shinken/modules/npcdmod_broker.py
> Processing ./shinken/objects/config.py
> Processing ./shinken/webui/plugins/eue/eue.py
+--------------------------------------------------------------------------------
| Set some configuration directives
+--------------------------------------------------------------------------------
> Processing /usr/local/shinken/etc/brokerd.ini
> Going to /usr/local/shinken
> Setting workdir to /usr/local/shinken/var in /usr/local/shinken/etc/brokerd.ini
> Setting user to shinken in /usr/local/shinken/etc/brokerd.ini
> Setting group to shinken in /usr/local/shinken/etc/brokerd.ini
> Processing /usr/local/shinken/etc/pollerd.ini
> Going to /usr/local/shinken
> Setting workdir to /usr/local/shinken/var in /usr/local/shinken/etc/pollerd.ini
> Setting user to shinken in /usr/local/shinken/etc/pollerd.ini
> Setting group to shinken in /usr/local/shinken/etc/pollerd.ini
> Processing /usr/local/shinken/etc/reactionnerd.ini
> Going to /usr/local/shinken
> Setting workdir to /usr/local/shinken/var in /usr/local/shinken/etc/reactionnerd.ini
> Setting user to shinken in /usr/local/shinken/etc/reactionnerd.ini
> Setting group to shinken in /usr/local/shinken/etc/reactionnerd.ini
> Processing /usr/local/shinken/etc/receiverd.ini
> Going to /usr/local/shinken
> Setting workdir to /usr/local/shinken/var in /usr/local/shinken/etc/receiverd.ini
> Setting user to shinken in /usr/local/shinken/etc/receiverd.ini
> Setting group to shinken in /usr/local/shinken/etc/receiverd.ini
> Processing /usr/local/shinken/etc/schedulerd.ini
> Going to /usr/local/shinken
> Setting workdir to /usr/local/shinken/var in /usr/local/shinken/etc/schedulerd.ini
> Setting user to shinken in /usr/local/shinken/etc/schedulerd.ini
> Setting group to shinken in /usr/local/shinken/etc/schedulerd.ini
> Enable retention for broker scheduler and arbiter
> Installing startup scripts
> Enabling Debian startup script
+--------------------------------------------------------------------------------
| Install mongodb server
+--------------------------------------------------------------------------------
> repository configuration not found. Adding 10 gen repository
> Installing mongodb server
+--------------------------------------------------------------------------------
| Applying various fixes
+--------------------------------------------------------------------------------
> Starting shinken
+------------------------------------------------------------------------------
| Shinken is now installed on your server
| The install location is: /usr/local/shinken
| The configuration folder is: /usr/local/shinken/etc
|
| The Web Interface is available at: http://localhost:7767
| The default credentials for the webui are admin/admin
|
| You can now learn how to configure shinken at: http://www.shinken-monitoring.org/wiki
+------------------------------------------------------------------------------ > updated configuration of module[3] passwd=/usr/local/shinken/etc/htpasswd.users updated configuration of module[3] passwd=/usr/local/shinken/etc/htpasswd.users
> Found installation parameters
--> ETC=/usr/local/shinken/etc
--> VAR=/usr/local/shinken/var
--> LIBEXEC=/usr/local/shinken/libexec
--> TARGET=/usr/local/shinken
> checking if shinken is installed in /usr/local/shinken
+--------------------------------------------------------------------------------
| Install nagios plugins
+--------------------------------------------------------------------------------
> Installing prerequisites
> Getting nagios-plugins archive
> Extract archive content
> Configure source tree
> Building ....
> Installing
> Found installation parameters
--> ETC=/usr/local/shinken/etc
--> VAR=/usr/local/shinken/var
--> LIBEXEC=/usr/local/shinken/libexec
--> TARGET=/usr/local/shinken
> checking if shinken is installed in /usr/local/shinken
+--------------------------------------------------------------------------------
| Install check_mem
+--------------------------------------------------------------------------------
> Downloading check_mem
> Extracting archive
> Installing plugin
> Found installation parameters
--> ETC=/usr/local/shinken/etc
--> VAR=/usr/local/shinken/var
--> LIBEXEC=/usr/local/shinken/libexec
--> TARGET=/usr/local/shinken
> checking if shinken is installed in /usr/local/shinken
+--------------------------------------------------------------------------------
| Install manubulon plugins
+--------------------------------------------------------------------------------
> Installing prerequisites
> Getting manubulon archive
> Extract archive content
> Relocate libs
=> Processing /tmp/nagios_plugins/check_snmp_boostedge.pl
=> Installing /tmp/nagios_plugins/check_snmp_boostedge.pl
=> Processing /tmp/nagios_plugins/check_snmp_cpfw.pl
=> Installing /tmp/nagios_plugins/check_snmp_cpfw.pl
=> Processing /tmp/nagios_plugins/check_snmp_css.pl
=> Installing /tmp/nagios_plugins/check_snmp_css.pl
=> Processing /tmp/nagios_plugins/check_snmp_css_main.pl
=> Installing /tmp/nagios_plugins/check_snmp_css_main.pl
=> Processing /tmp/nagios_plugins/check_snmp_env.pl
=> Installing /tmp/nagios_plugins/check_snmp_env.pl
=> Processing /tmp/nagios_plugins/check_snmp_int.pl
=> Installing /tmp/nagios_plugins/check_snmp_int.pl
=> Processing /tmp/nagios_plugins/check_snmp_linkproof_nhr.pl
=> Installing /tmp/nagios_plugins/check_snmp_linkproof_nhr.pl
=> Processing /tmp/nagios_plugins/check_snmp_load.pl
=> Installing /tmp/nagios_plugins/check_snmp_load.pl
=> Processing /tmp/nagios_plugins/check_snmp_mem.pl
=> Installing /tmp/nagios_plugins/check_snmp_mem.pl
=> Processing /tmp/nagios_plugins/check_snmp_nsbox.pl
=> Installing /tmp/nagios_plugins/check_snmp_nsbox.pl
=> Processing /tmp/nagios_plugins/check_snmp_process.pl
=> Installing /tmp/nagios_plugins/check_snmp_process.pl
=> Processing /tmp/nagios_plugins/check_snmp_storage.pl
=> Installing /tmp/nagios_plugins/check_snmp_storage.pl
=> Processing /tmp/nagios_plugins/check_snmp_vrrp.pl
=> Installing /tmp/nagios_plugins/check_snmp_vrrp.pl
=> Processing /tmp/nagios_plugins/check_snmp_win.pl
=> Installing /tmp/nagios_plugins/check_snmp_win.pl
> Found installation parameters
--> ETC=/usr/local/shinken/etc
--> VAR=/usr/local/shinken/var
--> LIBEXEC=/usr/local/shinken/libexec
--> TARGET=/usr/local/shinken
> checking if shinken is installed in /usr/local/shinken
+--------------------------------------------------------------------------------
| Install pnp4nagios addon
+--------------------------------------------------------------------------------
> Found installation parameters
--> ETC=/usr/local/shinken/etc
--> VAR=/usr/local/shinken/var
--> LIBEXEC=/usr/local/shinken/libexec
--> TARGET=/usr/local/shinken
> Installing prerequisites
> Getting pnp4nagios archive
> Extracting archive
> Configuring source tree
> Building ....
> Installing
> Fix htpasswd.users path
> Enable npcdmod
> using ip address: x.x.x.x
> Starting npcd
Exiting
It’s now installed with its dependencies :-). We can restart it:
/etc/init.d/shinken restart
or
service shinken restart
Plugins
We can also install additional plugins such as Nagios plugins:
/usr/local/shinken/install -p nagios-plugins
Once installed, the plugins are located in /usr/local/shinken/libexec.
If you want to see the list of available Shinken plugins:
> /usr/local/shinken/install -h
[...]
-p | --plugin Install plugins. Argument should be one of the following:
check_esx3
nagios-plugins
check_oracle_health
check_mysql_health
capture_plugin
check_wmi_plus
check_mongodb
check_emc_clariion
check_nwc_health
manubulon (snmp plugins)
check_hpasm
check_netapp2
check_mem (local enhanced memory check plugin)
check_snmp_bandwidth (check bandwidth usage with snmp)
check_netint (enhanced version of check_snmp_int plugins)
check_IBM
check_IBM_DS
check_rsync
[...]
Configuration
FAQ
Opening the log file ‘arbiterd.log’ failed with ‘[Errno 13] Permission denied
If you get this kind of message, it’s simply due to a permission problem that the installer forgot:
FAILED: [1357199441] Error : Opening the log file 'arbiterd.log' failed with '[Errno 13] Permission denied: u'/usr/local/shinken/var/arbiterd.log (full output is in /tmp/bad_start_for_arbiter) ... failed!
You can fix the problem by reassigning permissions:
service shinken stop
chown -R shinken:shinken /usr/local/shinken
service shinken start
References
Last updated 03 Jan 2013, 07:56 +0200.