Installation

From the shinken.IO

The easiest solution to set up the Shinken WebUI is to use the CLI shinken install which will install from Shinken.IO.

• Install the WebUI

$ shinken install webui2

Note that the shinken.io package is webui2! This to avoid conflicting with a previous installation of the WebUI.

Then you also need to install some python dependencies using pip (depending on your distribution, you could also install theses packages from your distribution repositories):

$ sudo pip install pymongo>=3.0.3 requests arrow bottle==0.12.8

The packages required are listed in the requirements.txt file.

• And declare it into the modules of the broker configuration :

$ cat /etc/shinken/brokers/broker-master.cfg
[...]
modules     webui
[...]

• Restart Shinken

$ sudo service shinken restart

The configuration file (webui2.cfg) is located in the etc/shinken/modules directory and is self explanatory. You can look at the configuration documentation for more informations.

Then, you may want to look how to enable modules like authentication, preferences, graphs and even logs&availability.

Expert install: from the Github repository

Assuming you already installed from Shinken.IO, you simply need to replace the content of your modules/webui directory with the content of the module directory from the github repository.

[Get a release from the project repo]
$ wget https://github.com/shinken-monitoring/mod-webui/archive/branch.tar.gz
$ tar -xvf branch.tar.gz

[Stop Shinken]
$ sudo service shinken stop

[Update application]
$ cp -R mod-webui-branch/* /var/lib/shinken/modules/webui/.

[Start Shinken]
$ sudo service shinken start

Your configuration file is located in the etc/modules/webui.cfg and it will not be affected by the previous copy.

If you are updating from previous installation, you should consider getting the new webui2.cfg file and adpt its content to your configuration. webui2.cfg is available here: https://github.com/shinken-monitoring/mod-webui/blob/master/etc/modules/webui2.cfg

Your installation directories (etc, modules) are located in the .shinken.ini file of your home directory.