1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
===================================
Presentation Of the Shinken project
===================================
Welcome in the Shinken project.
Shinken is a new, Nagios compatible monitoring tool, written in
Python. The main goal of Shinken is to allow users to have a fully
flexible architecture for their monitoring system that can easily
scale to large environments. It’s as simple as in all the marketing
“cloud computing” slides, but here, it’s real!
Shinken is backwards-compatible with the Nagios configuration standard
and plug-ins. It works on any operating system and architecture that
supports Python, which includes Windows and GNU/Linux.
How to install Shinken
=========================
You just need to add a shinken user (in the shinken group) on your
system::
useradd --user-group shinken
usermod --lock shinken
First way: all in a directory (ugly but quick way ;)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Then move the shinken directory and give it to the shinken user::
mv shinken /usr/local
chown -R shinken:shinken /usr/local/shinken
Second way: district directory (clean way)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
You can install really the application by using the `setup.py` script.
It will install the shinken library in the python path, create the
`/etc/shinken` and `/var/lib/shinken` directory (you can change them in
the `setup.cfg` file before launching `setup.py`). You will
need the `python-setuptools` package for it. Then just run::
sudo python setup.py install --install-scripts=/usr/bin/
For the compilation part in both way it's easy: there is no
compilation!
Requirements
=========================
`shinken` requires
* `Python`__ 2.4 or higher (Python 2.6 or higher is recommended)
* `setuptools`__ or `distribute`__ for installation (see below).
* `Pyro`__
* `multiprocessing` Python package when using Python 2.4 or 2.5
(`multiprocessing` is already included in Python 2.6 and higher)
__ http://www.python.org/download/
__ pyro
__ http://pypi.python.org/pypi/multiprocessing/
If (and only if) you plan to use the `livestatus` module, I'll also
need
* `simplejson`__
* `pysqlite`__
__ http://pypi.python.org/pypi/simplejson/ and
__ http://code.google.com/p/pysqlite/
Just untar and launch `python setup.py install` (and be sure to have
installed the `python-devel` package too).
For Python, it should be okay with nearly all distribution.
Under ubuntu, you can grab the Pyro module with::
sudo apt-get install pyro
Under other distributions, you can search for it::
yum search pyro
And if you do not find it, you can install it from PyPI::
easy_install pyro
And that all folks :)
Where is the configuration?
================================
The configuration is where you put the etc directory (in
`/usr/local/shinken/etc` for a quick and dirty install, `/etc/shinken`
for a clean one).
The `nagios.cfg` file is meant ot be shared with Nagios. All Shinken
specific objects (like link to daemons or realms) are in the file
`shinken-specific.cfg`.
I need to change my existing Nagios configuration?
===================================================
No, there is no need to change the existing configuration - unless
you want to add some new hosts and services.
How to run Shinken
================================
Quick and dirty way
~~~~~~~~~~~~~~~~~~~~
It's easy, there is a already launch script for you::
shinken/bin/launch_all.sh
Clean way
~~~~~~~~~~~~~~~~~~~~
The `setup.py` installes some `init.d` scripts, let's use them::
/etc/init.d/shinken-scheduler start
/etc/init.d/shinken-poller start
/etc/init.d/shinken-reactionner start
/etc/init.d/shinken-broker start
/etc/init.d/shinken-arbiter start
Known bugs
================================
None we know :)
If you find one, please post it in our trac site:
https://sourceforge.net/apps/trac/shinken/report/2
How to run uninstall Shinken
================================
Clean all :)
~~~~~~~~~~~~~~~~~~~~
There a script call clean.sh on the source directory for this :)
Beware, it will supress all Shinken related files!
|