Hub’erte est une application qui permet à Hobbit/Xymon d’envoyer des alertes par téléphone.

Voici une documentation sur son installation.

Pré-requis :

Connaissances

  • Connaissances de base en systèmes X (Linux, Unix, *BSD …)
  • Culture générale en informatique
  • Connaissances de base sur Hobbit/Xymon Monitor

Matériel / Logiciel

Si vous avez deux serveurs :

  • Un serveur Asterisk 1.4 (non compatible pour le moment avec la 1.6) avec la suite Apache, PHP (php-cli aussi), MySQL, SSH, sudo
  • Un serveur Xymon/Hobbit Monitor avec sudo d’installé.
  • Les deux serveurs doivent pouvoir communiquer bilatéralement en SSH

Si vous avez le monitoring + l’Asterisk sur le même serveur :

  • Xymon/Hobbit Monitor, Asterisk 1.4 (non compatible pour le moment avec la 1.6) avec la suite Apache, PHP (php-cli aussi), MySQL, SSH, sudo

Spécifications :

  • OS : Linux
  • Distribution : Debian Etch
  • Objectif : Mise en place de l’application Hub’erte.

Installation

Tout d’abord on créé la base MySQL :

mysql> create database huberte ;
Puis l’utilisateur :

grant all privileges on huberte.* to huberte@’localhost’ identified by « motdepasse »;

Changez « motdepasse » par un mot de passe de votre choix.

Dans la configuration asterisk, dans le fichier manager.conf, ajoutez le lignes suivantes :

[huberte]
secret = motdepasse
deny=0.0.0.0/0.0.0.0
permit=127.0.0.1/255.255.255.0
read = call
write = call
Changez « motdepasse » par le mot de passe de votre choix.

 

Installation Hub’erte

Sur le serveur Asterisk, téléchargez les sources, et extrayez les.

SRV-Linux:/usr/src# tar zxvf huberte-0.X.X.tar.gz

Puis on se place dans le répertoire nouvellement créé :

SRV-Linux:/usr/src# cd huberte-0.X.X

Et on lance le script d’installation locale :

SRV-Linux:/usr/src/huberte-0.X.X# ./install.local.sh

===> User creation <===

Vous pouvez laisser par défaut la partie.

===> Hobbit/Xymon & Asterisk <===

Remplissez cette partie avec vos paramètres.

===> MySQL Database <===

Reprenez les paramètres MySQL précédemment créés.

===> Asterisk Manager <===

Reprenez les paramètres du manager asterisk, précédemment configurés.

===> Others <=== »

What is the context used to call numbers from huberte ?
Entrez un context Asterisk, d’ou Hub’erte lancera les appels (from-internal si vous êtes sur FreePBX).

What is a delivery strategy to apply [per_alert] ?
Il y a deux types de vidage de spool d’appels :

  • Par alerte (per_alert): avant de continuer sur d’autres alertes, l’application va attendre que tous les utilisateurs aient été notifiés ou aient pris en compte l’alerte. Cette règle a pour avantage de garder une chronologie dans la distribution des appels, mais peut faire prendre du retard à la distribution si l’alerte n’a pas été prise en compte.
  • Par Utilisateur (per_owner) : Distribue les alertes par utilisateur, indépendement les uns des autres, chaque utilisateur a sa queue de distribution d’appels.

What is escalation delay to set [1800] (seconds) ?
Le temps en seconde, si une personne en escalade est configurée, avant que l’escalade soit effectuée.

Non-business hour start [20] ?
Le début de la période non ouvrée

Non-business hour end [8] ?
La fin de la période non ouvrée.

 

Si et seulement si vous avez choisi une installation sur deux serveurs :

Comme indiqué à la fin de l’installation, copiez le fichier install.hobbit.sh sur votre serveur Hobbit/Xymon, et exécutez le.

N’oubliez pas de copier la chaîne de caractères retournée par cette commande :

SRV-Linux:/usr/src/huberte-1.0.0# vim ~huberte/.ssh/authorized_keys
SRV-Linux:/usr/src/huberte-1.0.0# chown -R huberte: !$

Vérifiez sur chacun des deux serveurs en tant qu’utilisateur « huberte « , que vous pouvez vous connecter à l’autre serveur sans avoir besoin de vous authentifier.

Dans les deux cas

Faites aussi la modif asterisk indiquée à la fin de la première installation :

SRV-Linux:/usr/src/huberte-1.0.0# vim /etc/asterisk/extensions.conf

…
#include /usr/local/huberte/asterisk/extensions_huberte.conf
Les paramètres réglés dans les scripts d’installation sont modifiables dans les fichiers /usr/local/huberte/ext/Config.php, wwwroot/Config.php, ext/HobbitAlert.sh.

Copiez le fichier ext/HobbitAlert.sh à la racine du repertoire « /usr/local/huberte » sur le serveur Hobbit/Xymon. Pour l’appeler à partir de Xymon, ajoutez la ligne suivante dans le fichier hobbit-alerts.cfg :

SCRIPT /usr/local/huberte/ext/HobbitAlert.sh Plateform DURATION>1 RECOVERED COLOR=red,blue,yellow
La partie en gras est à configurer par vos soins.

 

Installation interface Web

Copiez le répertoire wwwroot dans un répertoire accessible par le web. Par exemple :

SRV-Linux:/usr/src/huberte-1.0.0# cp -r wwwroot/ /var/www/huberte
Sur l’interface Web, pour vous authentifier utilisez le login et mot de passe par défaut : admin/password.

 

Pour finir il faut rajouter sur le serveur huberte dans les crons de l’utilisateur huberte la ligne suivante :

SRV-Linux:/# crontab -e -u huberte

 

La ligne en question est :

* * * * * cd /usr/local/huberte/ext/ && ./CheckAlerts.php >> /tmp/huberte.log 2>&1

 

Ce tutoriel est terminé, n’hésitez pas à nous contacter si vous rencontrez des soucis d’installation ou d’utilisation. Cette application est récente, et en version beta, et donc il est possible que certains soucis soient rencontrés.