# 10 Minutes Shinken Installation Guide¶

## Summary¶

By following this tutorial, in 10 minutes you will have the core monitoring system for your network.

The very first step is to verify that your server meets the requirements, the installation script will try to meet all requirements automatically.

You can get familiar with the Shinken Architecture now, or after the installation. This will explain the software components and how they fit together.

## Requirements¶

### Mandatory Requirements¶

• Python 2.6 or higher (2.7 will get higher performance)
• python-pycurl Python package for Shinken daemon communication
• setuptools or distribute Python package for installation

### Conditional Requirements¶

• Python 2.7 is required for developers to run the test suite, shinken/test/
• python-cherrypy3 (recommended) enhanceddaemons communications, especially in HTTPS mode
• Monitoring Plugins (recommended) provides a set of plugins to monitor host (Shinken uses check_icmp by default install). Monitoring plugins are available on most linux distributions (nagios-plugins package)

Warning

Do not mix installation methods! If you wish to change method, use the uninstaller from the chosen method THEN install using the alternate method.

## GNU/Linux & Unix Installation¶

### Method 1: Pip¶

Shinken 2.4 is available on Pypi : https://pypi.python.org/pypi/Shinken/2.4 You can download the tarball and execute the setup.py or just use the pip command to install it automatically.

apt-get install python-pip python-pycurl
pip install shinken


### Method 2: Packages¶

For now the 2.4 packages are not available, but the community is working hard for it! Packages are simple, easy to update and clean. Packages should be available on Debian/Ubuntu and Fedora/RH/CentOS soon (basically .deb and .rpm).

### Method 3: Installation from sources¶

Download last stable Shinken tarball archive (or get the latest git snapshot) and extract it somewhere:

adduser shinken
wget http://www.shinken-monitoring.org/pub/shinken-2.4.tar.gz
tar -xvzf shinken-2.4.tar.gz
cd shinken-2.4
python setup.py install


Shinken 2.X uses LSB path. If you want to stick to one directory installation you can of course. Default paths are the following:

• /etc/shinken for configuration files
• /var/lib/shinken for shinken modules, retention files...
• /var/log/shinken for log files
• /var/run/shinken for pid files

## Windows Installation¶

For 2.X+ the executable installer may not be provided. Consequently, installing Shinken on a Windows may be manual with setup.py. Steps are basically the same as on Linux (Python install etc.) but in windows environment it’s always a bit tricky.

Versions
latest
stable
branch-1.4
2.4.1
2.2
2.0.3
1.4.2