Dans cet article, je vais vous montrer comment ajouter un Hosts et les graphs qui lui sont associés à l’aide de ces commandes.

Pour cela, placez-vous dans votre répertoire “cli”. Pour moi : “/var/www/html/cli”

Création du Host :

Dans cette section, nous allons utiliser la commande “add_device.php”.

Nous voulons ajouter un routeur à Cacti. Voici les caractéristiques de ce routeur :

IP d’admin : 192.168.0.1
Communauté SNMP : public
Nom : Routeur-1
Template d’hôte Cacti : Cisco Router

Pour la commande “add_device.php”, nous avons besoin de l’id du host template. Pour le connaitre, il faut exécuter cette commande :

# php -q add_device.php –list-host-templates
Valid Host Templates: (id, name)
0 None
1 Generic SNMP-enabled Host
3 ucd/net SNMP Host
4 Karlnet Wireless Bridge
5 Cisco Router
6 Netware 4/5 Server
7 Windows 2000/XP Host
8 Local Linux Machine
9 VMware ESX server
10 X MySQL Server HT
11 Windows 2k3
12 Brocade FC Switch Interfaces/Sensors
13 Site web

Nous pouvons voir que l’id du template “Cisco Router” est 5.

A présent, vous pouvez ajouter votre Hosts comme ceci :

# php -q add_device.php –description="Routeur-1" –ip="192.168.0.1" –template=5 –community="public"

Création des graphs pour un host

Maintenant, nous voulons créer un graph pour connaitre la charge de chaque interface active du routeur. Pour cela, nous avons besoin de connaitre :

• Id du Host
• Le modèle de graph
• Le modèle de “Data Query”
• Le type de données voulu

Récupérer l’identifiant du Host

Lancer la commande :

# php -q add_graphs.php --list-hosts
139     192.168.0.1  5       Router-1

L’identifiant du host est donc 139.

Récupérer le modèle de Graph :

# php -q add_graphs.php –list-graph-templates

Known Graph Templates:(id, name)

2       Interface – Traffic (bits/sec)

3       ucd/net – Available Disk Space

Nous voulons que tous les graphs se basent sur le modèle “Interface - Traffic (bits/sec)”. Donc l’identifiant sera 2.

Récupérer le modèle de “Data Query”

# php -q add_graphs.php –list-snmp-queries

Known SNMP Queries:(id, name)

1       SNMP – Interface Statistics

2       ucd/net -  Get Monitored Partitions

3       Karlnet – Wireless Bridge Statistics

4       Netware – Get Available Volumes

6       Unix – Get Mounted Partitions

7       Netware – Get Processor Information

8       SNMP – Get Mounted Partitions

9       SNMP – Get Processor Information

10      Win Services

11      VMware ESX – Get VM CPU usage

12      VMware ESX – Get VM NIC statistics

13      VMware ESX – Get VM disk statistics

14      VMware ESX – Get VM memory usage

15      ucd/net – Device I/O

16      SNMP – Running Processes

17      Brocade FC Switch Interfaces

18      Brocade FC Switch Sensors

Etant donné que nous voulons la charge sur chaque interface active du router, nous utiliserons la requête SNMP : “SNMP – Interface Statistics”. Soit l’identifiant 1.

Récupérer le type de données voulu :

# php -q add_graphs.php –snmp-query-id=1 –list-query-types

Known SNMP Query Types: (id, name)

2       In/Out Errors/Discarded Packets

3       In/Out Non-Unicast Packets

4       In/Out Unicast Packets

9       In/Out Bytes (64-bit Counters)

13      In/Out Bits

14      In/Out Bits (64-bit Counters)

16      In/Out Bytes

20      In/Out Bits with 95th Percentile

21      In/Out Bits with Total Bandwidth

22      In/Out Bytes with Total Bandwidth

Nous voulons la charge en bits/s. Donc l’identifiant du type de données sera 13.

Nous pouvons maintenant créer les graphs pour chaque interface de notre routeur :

php -q add_graphs.php –host-id=139 –graph-type=ds –graph-template-id=2 –snmp-query-id=1 –snmp-query-type-id=13 –snmp-field=ifOperStatus –snmp-value=Up

Pour ne pas créer les graphs pour les interfaces inutilisées, nous avons ajouter les arguments : –snmp-field=ifOperStatus –snmp-value=Up. De ce fait, la commande creera des graphs seulement pour les interfaces ayant la valeur “UP” pour le champ snmp “ifOperStatus”.

Vous pouvez lister les champs Snmp utilisable par cacti à l’aide de la commande :

# php -q add_graphs.php –host-id=132 –list-snmp-fields

Known SNMP Fields for host-id 132: (name)

ifAlias

ifDescr

ifHwAddr

ifIndex

ifIP

ifName

ifOperStatus

ifSpeed

ifType

 

Ajout du host dans l’arborescence de graph

On liste les arborescences existantes :

# php -q add_tree.php –list-trees

Known Trees:

id      sort method                     name

2       Alphabetic Ordering     PARIS

On ajoute le host dans l’arborescence :

php -q add_tree.php –type=node –node-type=host –tree-id=2 –host-id=139

Voilà, vous pouvez visualiser les graphs de votre hosts dans l’interface de Cacti.

Conclusion

Je pense que vous l’avez bien compris. Les commandes cli de Cacti vont nous permettre de gagner un temps considérable dans le cas d’ajout en masse d’un même type d’hosts. Il nous faudra un fichier de type IP|HOSTNAME et une boucle pour réaliser en quelques minutes ce qui nous prendrais des heures par l’interface graphique.

Pour plus d’infos : http://www.cacti.net/downloads/docs/html/scripts.html

Cette erreur apparait lorsque le template a été fait sur une version plus récente de cacti. La solution est de mettre à jour Cacti.

Voici la procédure de mise à jour :

Téléchargement :

Créer un répertoire temporaire et se placer dedans

Télécharger la dernière version de cacti et du plugin Architecture ici. Ou bien lancez directement les commandes suivantes pour la version 0.8.7g de Cacti : 

wget http://www.cacti.net/downloads/cacti-0.8.7g.tar.gz

wget http://mirror.cactiusers.org/downloads/plugins/cacti-plugin-0.8.7g-PA-v2.8.tar.gz

Sauvegarder la base de données :

Récupérer le nom d’utilisateur et le mot de passe de la base de données de cacti dans le fichier /var/www/html/include/config.php.

Par défaut, l’utilisateur est ‘cactiuser’ et le mot de passe est ‘CactiMadeEZ’.

Lancer la commande :

mysqldump -l -u cactiuser -p  –add-drop-table cacti > /tmp/bkp-cacti.sql

Saisissez le mot de passe

Installation de cacti :

Décompresser les archives téléchargée :

tar -xvzf cacti-0.8.7g.tar.gz

Renommer l’ancien répertoire de cacti :

mv /var/www/html /var/www/html_old

Renommer le cacti-0.8.7g en html

mv cacti-0.8.7g /var/www/html

Modifier les informations d’accès à la base de données du fichier var/www/html/include/config.php en vous basant sur le fichier /var/www/html_old/include/config.php

Récupération des données :

cp –reply=yes /var/www/html_old/rra/* /var/www/html/rra/

cp -u /var/www/html_old/scripts/* /var/www/html/scripts/

cp -u -R /var/www/html_old/resource/* /var/www/html/resource/

Ne pas écraser les fichiers existant.

Installation du nouveau plugin architecture :

mkdir plugin-arch

cp cacti-plugin-0.8.7g-PA-v2.8.tar.gz plugin-arch/

cd plugin-arch/

tar -xvzf cacti-plugin-0.8.7g-PA-v2.8.tar.gz

Copier le contenu de l’archive dans /var/www/html :

cp -R plugin-arch/cacti-plugin-arch/* /var/www/html/

Appliquer la mise à jour du plugin :

patch -p1 -N < cacti-plugin-0.8.7g-PA-v2.8.diff

Récupération des anciens plugins :

Renommer le fichier /var/www/html_old/plugins/index.php pour ne pas écraser le nouveau :

mv /var/www/html_old/plugins/index.php /var/www/html_old/plugins/index.php.old

Copier les plugins dans le nouveau répertoire :

cp -u -R /var/www/html_old/plugins/* /var/www/html/plugins/

chown -R apache.apache /var/www/html

Finalisation de l’installation de Cacti

Maintenant, vous pouvez tester d’accéder à Cacti. Il va falloir terminer l’installation via votre navigateur.

Pour cette version, il n’y a pas de mise à jour de la base de données. Vous inquiétez pas

Tout est correct? Cliquez sur “Finish”

Identifiez-vous :

Voilà vous êtes à présent en version 0.8.7g

Les plugins n’apparaissent plus. Il vous faut les activer.

Activation des plugins :

Aller dans  Configuration / Plugin Management . Les plugins sont présent mais ne sont pas activé. Vous pouvez les activer en cliquant sur l’icone bleu correspondant au plugin voulu. Il peut y avoir des problème d’incompatibilité entre les plugin et le nouveau plugin architecture.

Mises à jour des plugins

Les dernières versions de plugins sont disponibles à cette adresse : http://cactiusers.org/downloads/

Nous allons maintenant télécharger et installé les derniers plugins :

cd /var/www/html/plugins

wget http://cactiusers.org/downloads/boost.tar.gz

wget http://cactiusers.org/downloads/clog.tar.gz

wget http://cactiusers.org/downloads/cycle.tar.gz

wget http://cactiusers.org/downloads/discovery.tar.gz

wget http://cactiusers.org/downloads/docs.tar.gz

wget http://cactiusers.org/downloads/flowview.tar.gz

wget http://cactiusers.org/downloads/hostinfo.tar.gz

wget http://cactiusers.org/downloads/loginmod.tar.gz

wget http://cactiusers.org/downloads/mactrack.tar.gz

wget http://cactiusers.org/downloads/monitor.tar.gz

wget http://cactiusers.org/downloads/ntop.tar.gz

wget http://cactiusers.org/downloads/realtime.tar.gz

wget http://cactiusers.org/downloads/routerconfigs.tar.gz

wget http://cactiusers.org/downloads/settings.tar.gz

wget http://cactiusers.org/downloads/ssl.tar.gz

wget http://cactiusers.org/downloads/syslog.tar.gz

wget http://cactiusers.org/downloads/thold.tar.gz

wget http://cactiusers.org/downloads/tools.tar.gz

wget http://cactiusers.org/downloads/update.tar.gz

wget http://cactiusers.org/downloads/watermark.tar.gz

Décompresser toutes les archives :

for i in *.tar.gz; do echo working on $i; tar xvzf $i ; done

Rafraichissez la page des plugins. Vous ne devez plus avoir de problèmes de compatibilité.

Supprimer toutes les archives téléchargées:

rm -f *.tar.gz

Mise à jour du poller spine :

Télécharger la version de spine correspondant à la version de cacti :

wget http://www.cacti.net/downloads/spine/cacti-spine-0.8.7g.tar.gz

Décompresser et compiler :

tar xvzf cacti-spine-0.8.7g.tar.gz

cd cacti-spine-0.8.7g

./configure

make

Sauvegarder l’ancienne version de spine et installer la nouvelle version :

mv /usr/local/spine/spine /usr/local/spine/spine_old

mv /usr/local/spine/spine.conf /usr/local/spine/spine.conf_old

cp spine /usr/local/spine/

cp spine.conf.dist /usr/local/spine/spine.conf

chown apache.apache /usr/local/spine/*

Modifier les informations d’accès à la base de données dans le fichier /usr/local/spine/spine.conf en vous basant sur le fichier /usr/local/spine/spine.conf_old

Spine es maintenant installé et configuré.

Problème rencontré :

Les graphs du plugin realtime ne fonctionnait plus.

Solution :

Désinstaller le plugin dans le menu “plugin management”.

Télécharger la dernière version 0.43

http://docs.cacti.net/plugin:realtime.

Placer l’archive dans le répertoire /var/www/html/plugins

Décompresser l’archive

Donner les droits apache.apache au répertoire realtime

Actualiser la page du “plugin management”

Installer le plugin (icone bleu)

Activer le plugin

Conclusion :

J’espère que votre mise à jour a été effectuée avec succès. Maintenant vous pouvez installer les templates et scripts que vous voulez.

Comme vous avez pu le constater, l’installation d’un plugin, ne nécessite plus de modifier un fichier de configuration de Cacti grâce à la nouvelle version du plugin architecture. Pour installer un plugin, il vous suffi simplement de le décompresser dans le répertoire plugins et il apparaitra automatiquement dans le menu “plugin management”.

Bonne continuation,

Olivier

Sources :

http://www.spoonapedia.com/2010/07/upgrading-cacti.html

cp /usr/share/zoneinfo/Europe/Paris /etc/localtime

Le poller de CactiEZ étant configuré pour sonder toutes les minutes, si vous reculez dans le temps après avoir modifié votre client NTP, vous allez surement avoir un message d’erreur de ce type :

[root@localhost /]# php /var/www/html/poller.php 03/27/2009 05:14:04 PM – POLLER: Poller[0] NOTE: Poller Int: ’60′, Cron Int: ’60′, Time Since Last: ‘-20937′, Max Runtime ’58′, Poller Runs: ’1′

03/27/2009 05:14:04 PM – POLLER: Poller[0] NOTE: Cron is configured to run too often!  The Poller Interval is ’60′ seconds, with a minimum Cron period of ’60′ seconds, but only -20937 seconds have passed since the poller last ran.

Pour résoudre ce problème, il vous faudra taper cette commande :

[root@localhost /]# php /var/www/html/poller.php –force

Le fait de forcer le sondage va lui permettre de retrouver ses billes. Voilà, vous allez enfin refaire fonctionner vos graphs sans attendre des heures.

Téléchargement :

wget http://www.cacti.net/downloads/cacti-0.8.7g.tar.gz

Voici la page de téléchargement : http://www.cacti.net/download_cacti.php

Mise à jour :

Sauvegarder la base de données Cacti.

Décompresser le fichier téléchargé :

tar xvzf cacti-0.8.7g.tar.gz

Renommer l’ancien dossier cacti en cacti-old : (/usr/share/cacti chez moi)

# cd /usr/share
# mv cacti cacti-old

Placer la nouvelle version de cacti à la place de l’ancienne version :

# mv /tmp/cacti-0.8.7g /usr/share/cacti

Editer le fichier /usr/share/cacti/include/config.php et modifier les informations de base de données à l’aide de l’ancien fichier de conf (/usr/share/cacti-old/include/config.php)

$database_type = "mysql";
$database_default = "NOM_BDD";
$database_hostname = "SERVEUR_BDD";
$database_username = "USER_BDD";
$database_password = "MDP_BDD";
$database_port = "3306";

Récupérer les dossiers scripts, rra et resource :

cp –u -R cacti-old/resource/* cacti/resource/

cp cacti-old/rra/* cacti/rra/

cp -u cacti-old/scripts/* cacti/scripts/

cp -u cacti-old/scripts/* cacti/scripts/

Appliquer les patchs :

wget http://www.cacti.net/downloads/patches/0.8.7g/data_source_deactivate.patch
wget http://www.cacti.net/downloads/patches/0.8.7g/graph_list_view.patch
wget http://www.cacti.net/downloads/patches/0.8.7g/html_output.patch
wget http://www.cacti.net/downloads/patches/0.8.7g/ldap_group_authenication.patch
wget http://www.cacti.net/downloads/patches/0.8.7g/script_server_command_line_parse.patch
patch -p1 -N < data_source_deactivate.patch
patch -p1 -N < graph_list_view.patch
patch -p1 -N < html_output.patch
patch -p1 -N < ldap_group_authenication.patch
patch -p1 -N < script_server_command_line_parse.patch

Aller sur cacti avec le navigateur et suivez les écrans si besoin de mise à jour de base.

Problèmes rencontrés :

Dans le cas où vous avez des erreurs de ce type :

DB Exec Failed!

La solution de contournement est de remplacer le fichier lib/database.php par celui de la version 0.8.7e. Il est surement préférable dans ce cas là de rester en version 0.8.7e.

La version 0.8.7e est téléchargeable ici : http://www.cacti.net/downloads/cacti-0.8.7e.tar.gz

et les patchs à appliquer sont :

wget http://www.cacti.net/downloads/patches/0.8.7e/cli_add_graph.patch
wget http://www.cacti.net/downloads/patches/0.8.7e/snmp_invalid_response.patch
wget http://www.cacti.net/downloads/patches/0.8.7e/template_duplication.patch
wget http://www.cacti.net/downloads/patches/0.8.7e/fix_icmp_on_windows_iis_servers.patch
wget http://www.cacti.net/downloads/patches/0.8.7e/cross_site_fix.patch
wget http://www.cacti.net/downloads/patches/0.8.7e/sql_injection_template_export.patch
patch -p1 -N < cli_add_graph.patch
patch -p1 -N < snmp_invalid_response.patch
patch -p1 -N < template_duplication.patch
patch -p1 -N < fix_icmp_on_windows_iis_servers.patch
patch -p1 -N < cross_site_fix.patch
patch -p1 -N < sql_injection_template_export.patch

Après une mise à jour, Il est souvent préférable de régénérer le poller cache via : System Utilities/ Rebuild Poller Cache afin de régénérer les commandes utilisées par le poller.

Retour arrière :

Pour effectuer un retour arrière :

Renommer cacti-old en cacti

mv /usr/share/cacti /usr/share/cacti.marchepas

mv /usr/share/cacti-old /usr/share/cacti

Restaurer la base de données avec l’outil de votre choix.

Sources :

Upgrade Cacti : http://www.cacti.net/downloads/docs/html/upgrade.html