Package: alignak_module_nsca
Alignak NSCA module for the Alignak ReceiverInstallationThe installation of this module will copy some configuration files in the Alignak default configuration directory (eg./usr/local/etc/alignak). The copied files are located in the default sub-directory used for the modules (eg.arbiter/modules).From Alignak packages repositoriesMore information in theonline Alignak documentation. Here is only an abstract…Debian:# Alignak DEB stable packages
sudo echo deb https://dl.bintray.com/alignak/alignak-deb-stable xenial main | sudo tee -a /etc/apt/sources.list.d/alignak.list
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv D401AB61

sudo apt-get update
sudo apt install python-alignak-module-nscaCentOS:sudo vi /etc/yum.repos.d/alignak-stable.repo:
   [Alignak-rpm-stable]
   name=Alignak RPM stable packages
   baseurl=https://dl.bintray.com/alignak/alignak-rpm-stable
   gpgcheck=0
   repo_gpgcheck=0
   enabled=1

sudo yum repolist
sudo yum install python-alignak-module-nscaFrom PyPITo install the module from PyPI:sudo pip install alignak-module-nscaFrom source filesTo install the module from the source files (for developing purpose):git clone https://github.com/Alignak-monitoring-contrib/alignak-module-nsca
cd alignak-module-nsca
sudo pip install . -eNote:using `sudo python setup.py install` will not correctly manage the package configuration files! The recommended way is really to use `pip`;)Short descriptionThis module for Alignak receiver reads and decodes NSCA passive notifications to dispatch them into the Alignak framework.Features / Known limitationsHandles NSCA version 3 protocolCheck the NSCA packet timestamp for staled data (older than a certain amount of time) or ‘future’ data (future timestamp).Consider thehost_checkservice received data as a passive host check. Useful if your NSCA client does not handle correctly the passive host check syntax ;)The NSCA module implementation is currently limited to the “xor” obfuscation/encryption.NoteTo make the module add some information in the daemon log file, define theALIGNAK_LOG_ACTIONSenvironment variable. It will dump a part of the received NSCA packets…ConfigurationOnce installed, this module has its own configuration file in the/usr/local/share/alignak/etc/alignak.ddirectory.
The default configuration file isalignak-module-nsca.ini. This file is commented to help configure all the parameters.The default configuration is convenient for ‘recent’ NSCA client implementing NSCA version 3.This configuration has been tested with Linux send_nsca 2.9.1 and Windows NSClient most recent versions (from 0.4.1).Notereceived NSCA packets which are not containing version 3 information are dropped by the module!To configure Alignak receiver to use this module:edit your receiver daemon configuration fileadd themodule_aliasparameter value (nsca) to themodulesparameter of the daemonTo set up several NSCA listeners:copy the default configuration to another file,change the module alias parameter (nsca_bis)change the listening portedit your receiver daemon configuration fileadd the newmodule_aliasparameter value (nsca_bis) to themodulesparameter of the daemonBugs, issues and contributingContributions to this project are welcome and encouraged …issues in the project repositoryare the common way to raise an information.