alignak_notifications 1.0.1

Alignak notifications script pack

Alignak package for notifications (simple mail, HTML mail, XMPP)

Installation

The installation of this package 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 packs (eg. arbiter/packs).

Some JSON files

From PyPI

To install the package from PyPI:

sudo pip install alignak-notifications

From source files

To install the package from the source files:

git clone https://github.com/Alignak-monitoring-contrib/alignak-notifications
cd alignak-checks-notifications
sudo pip install .

Note: using `sudo python setup.py install` will not correctly manage the package configuration files! The recommended way is really to use `pip`;)

Documentation

This pack embeds several scripts that can be used to send notifications from Alignak:

• simple printf sent to sendmail

• python script to send HTML mail

• python script to send XMPP notifications

Important: The HTML mail script is using an Alignak logo image in the mail composition. The default file for this logo is the alignak.png file located in the main directory of the project repository. An alternative logo URL can be specified in the notification command parameters.

Configuration

Edit the /usr/local/etc/alignak/arbiter/packs/resource.d/notifications.cfg file and configure the SMTP server address, port, user name and password.

#-- SMTP server configuration
$SMTP_SERVER$=your_smtp_server_address
$SMTP_PORT$=25
$SMTP_LOGIN$=your_smtp_login
$SMTP_PASSWORD$=your_smtp_password

Note: The python scripts assume that you have a direct python runnable … if you need to use python2.7 or something else to run python, you should:

cd /usr/local/bin
ln -s python2.7 python

Bugs, issues and contributing

Contributions to this project are welcome and encouraged … issues in the project repository are the common way to raise an information.