Site Tools

New release available: 2022-07-31 "Igor". upgrade now! [52.2] (what's this?)

Monitoring Setup

This describes the basic setup of an Icinga instance to be used for monitoring GxFS Storage Appliances. This howto describes the setup for KIT envoronemnt but can be adapted easily to other environments. For monitoring the NetApp devices NetApp Santricity Webproxy services is needed. This tool provides an interface to get the status of NetApp devices via CLI commands. Functionality is provided by a java application, where the systems need to be registered. After that the current status and be taken via HTTP.


basic setup

  • setup yum repository to get icinga packages directly. Yum info to be plaed in /etc/yum.repo.d/icinga.repo
name=ICINGA (stable release for epel)
  • install icinga related packages
yum install icinga icinga-doc icinga-gui icinga-gui-config

The checks to be used by Icinga will be installed as well from the repository.

yum install nagios-plugins*

Some dependencies need to be solved while installing the plugins. This can be done package by package or yum can be configured to use temporarily all available/known repositories. To achieve this behaviour /etc/yum/pluginconf.d/search-disabled-repos.conf need to edited and notify_only need to be set to 0.

sed s/notify_only=0/notify_only=1/ /etc/yum/pluginconf.d/search-disabled-repos.conf

Icinga configuration

  • add user to be authenticated by Webserver machanism.
[root@LSDF-gxfsadmin ~]# htpasswd /etc/icinga/passwd user1
New password: 
Re-type new password: 
Adding password for user user1
[root@LSDF-gxfsadmin ~]# 
  • add gxfs server configuration files to /etc/icinga/objects/gxfs-server.cfg

sample configuration for LSDF can be found here: gxfs-server.cfg

  • add gxfs-server.cfg config file to master Icinga config file
  • check Icinga syntax of config files before restaring icinga
/usr/bin/icinga -v /etc/icinga/icinga.cfg

NetApp webservices proxy

basic setup

This NetApp tool provides an http interface to monitor or configure NetApp Storage devices. In our case it is just used to get the current status informatio form the NetApp boxes and trigger an alarm in case it turns from optimal to degraded. Current version is 2.0 and is available from the usual NetApp download site:

  • download software
  • chmod +x webservice-02.00.7000.0007.bin
  • ./webservice-02.00.7000.0007.bin
  • accept license agreements and changes pathes and settings if needed

If the webservices confuses to start redhat-lsb-core might be the cause. Doing yum install redhat-lsb-core' solved the problem.

  • systemctl start web_services_proxy
  • use a browser and connect to This shows just a overview html page.
  • browse to /docs/ and here into the API specification
  • a website is displayed, where all available commands are visible.
  • the systems need to be registered, which can be done here or via script:
[root@LSDF-gxfsadmin webproxy]# cat
curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{ "id": "lsdf-40-101", "controllerAddresses": "" }' 'http://rw:rw@'
curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{ "id": "lsdf-41-101", "controllerAddresses": "" }' 'http://rw:rw@'
curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{ "id": "lsdf-42-101", "controllerAddresses": "" }' 'http://rw:rw@'
[root@LSDF-gxfsadmin webproxy]# bash 
{"id":"lsdf-40-101","alreadyExits":false,"alreadyExists":false}{"id":"lsdf-41-101","alreadyExits":false,"alreadyExists":false}{"id":"lsdf-42-101","alreadyExits":false,"alreadyExists":false}[root@LSDF-gxfsadmin webproxy]# 
[root@LSDF-gxfsadmin webproxy]# 

setup JSON check

  1. place this script to /usr/lib64/nagios/plugins/
kit_icinga.txt · Last modified: 2022/07/10 09:34 by