cactialternc

Module Cacti pour AlternC.

Cette documentation présente le package alternc-cacti, et explique son fonctionnement, comment l'installer sur un serveur, et comment configurer Cacti pour utiliser les données produites par la sonde du package.
(C) Benjamin Sonntag, 12/2004. Distribué sous licence GPL, de même qu'AlternC et AlternC-cacti.

Pré-requis pour l'installation et l'utilisation de cette documentation

Cette documentation a été construite en décembre 2004, et correspond aux version 0.9.3 d'AlternC, 0.1 de AlternC-cacti, et 0.8.5a de Cacti. Si cette documentation est obsolete, vérifiez que vous avez bien la dernière mouture de la documentation sur http://www.alternc.org/ et dans ce cas, n'hésitez pas à me contacter par mail : benjamin AT alternc POINT org.

I. Histoire, cacti, rrdtool, mrtg.

Il était une fois mrtg (http://people.ee.ethz.ch/~oetiker/webtools/mrtg/), un logiciel perl permettant de créer des graphiques de tout et de rien (bande passante, débits, températures, bref, toute donnée mesurable.). Mrtg permettait aussi de sonder des systèmes informatiques simples (par snmp ou par shell-scripts)

L'auteur de mrtg a ensuite créé rrdtool (http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/), un logiciel de création de graphiques statistiques simples, mais très configurable. tellement configurable que bien peu d'utilisateurs savaient l'utiliser à pleine puissance.

Cacti est donc arrivé (http://www.cacti.net/). Cacti un logiciel php/mysql qui pilote rrdtool. A travers une interface web très puissante, il est possible de définir l'ensemble des paramètres des graphiques, et de créer des modèles (templates) de configuration.

Une idée a donc germée dans la tête des développeurs d'AlternC : pourquoi ne pas mettre au point une sonde générique et un modèle de configuration pour Cacti, permettant de dresser des graphiques pour n'importe quel serveur sous AlternC en quelques minutes ? ainsi naquit AlternC-cacti.

II. Installation et configuration de AlternC-cacti et de Cacti.

AlternC étant un logiciel pour serveurs, il est pratique de disposer de graphiques présentant l'activité du serveur, la charge des logiciels et divers paramètres techniques (requetes apache, connexions mysql, réseau, mémoire, processeur...). Le paquet debian alternc-cacti vous permet de réaliser ces graphiques le plus simplement du monde.

1. Installation d'AlternC-cacti

Pour installer alternc-cacti, il suffit de disposer d'un serveur sous AlternC et de procéder ainsi :
AlternC-cacti contient un programme d'extraction de données, lancé toutes les 5 minutes par cron grâce au fichier /etc/cron.d/alternc-cacti.
Ce programme d'extraction de données rempli la table mysql system.cacti avec les données de statistiques du serveur. Ces données sont identifiées par les informations de la table mysql system.cacti_stid

2. Configuration de AlternC-cacti

Pour configurer AlternC-cacti, éditez le fichier /etc/alternc/cacti.php.conf. Ce fichier contient quelques lignes à configurer comme suit : 
// Which network device are we using ?
$CACTI_NET_DEV="eth0";

// Which network is the private lan (if there is a private lan ;) )
$CACTI_NET_PRIVATE="eth1";

// The server ip address (for apache server-status)
// will be replaced by 127.0.0.1 when this ip will be allowed by default for server-status ;)
$MYIP="217.24.84.23";

// Root (system) partition
$CACTI_ROOT_PART="/dev/sda3";

// Data (/var/alternc) partition
$CACTI_DATA_PART="/dev/sda3";
CACTI_NET_DEV est le nom de la carte réseau principale de votre serveur. La plupart du temps il s'agit de eth0.
CACTI_NET_PRIVATE est le nom de la carte réseau privée de votre serveur. C'est eth1 le plus souvent si votre serveur dispose d'une interface réseau privée. Ca n'est pas toujours le cas. Si ca n'est pas le cas, ou si vous ne savez pas, vous pouvez laisser cette valeur à eth1 ou vide.
MYIP est l'adresse ip de votre serveur. Du fait de la mauvaise configuration d'apache par AlternC avant la version 0.9.3, il est nécessaire de fournir l'ip du serveur dans la configuration. Ce paramètre disparaitra à l'avenir.
CACTI_ROOT_PART est le nom de la partition du système qui contient le système d'exploitation (/ ou /usr ou /var).
CACTI_DATA_PART est le nom de la partition du système qui contient les données AlternC des membres. (/var/alternc ou /var selon vos choix initiaux)

voilà, c'est tout ce que vous avez besoin de configurer pour AlternC-cacti.

Ensuite, vous pouvez installer et configurer Cacti lui-même pour pouvoir utiliser ces données.

3. Création d'un utilisateur Cacti

Note : Si vous avez une ancienne version d'AlternC (<0.9.3), il vous faudra mettre à jour le fichier /var/alternc/bureau/admin/adm_panel.php en y ajoutant les lignes suivantes : 
<?php

// here we include any "adminmenu_*" file content
$d=opendir(".");
if ($d) {
  $lst=2;
  while ($c=readdir($d)) {
    if (substr($c,0,10)=="adminmenu_") {
      echo "<tr class=\"lst$lst\">";
      include($c);
      echo "</tr>\n";
      $lst=3-$lst;
    }
  }
}

closedir($d);
?>
juste avant le "</table>
Après cela, vous verrez apparaitre un nouveau élement dans le menu "Panneau Administrateur" du compte root de votre serveur sous AlternC. Ce menu "Gérer les utilisateurs Cacti" vous permet de créer un ou plusieurs comptes qui permettront à cacti d'aller chercher vos statistiques. Pour cela, entrez un login et un mot de passe, et cliquez sur "Créer ce compte autorisé". Notez bien ces informations : elles seront entrées dans Cacti au II.5

4. Installation de Cacti

Pour installer cacti, vous pouvez procéder comme suit (sur Debian). Notez bien qu'il n'est pas obligatoire d'installer Cacti sur le serveur AlternC lui-même : vous pouvez tout-à-fait l'installer sur un serveur qui centralisera tous les graphiques de tous vos serveurs...

5. Configuration de Cacti