Revisión de 10:22 7 nov 2012

Definicion

El servidor de gráficas se baas en el servicio de GUIFI llamado SNPServices. El servidor SNPServices, y para ser mas exactos cliente SNPServices es un servidor linux, con php, apache, mrtg y rrdtool, no necesita nada mas. Le llamamos cliente porque el servidor Master SNPServices es un servidor que nos enviará informacion a nuestro servidor cliente SNPServices. Aqui tienes un esquema que te hará ver claro esta definicion.

Definicion para expertos El cliente SNPServices consulta al Master snpservices la lista de nodos a monitorear, recogida previamente del servidor web mediante CNML, se parsea la lista y formatea scripts mrtg y los ejecuta (pings y trafico) para generar un rrd y con consultas http desde el servidor web, se ejecuta un php que convierte los .rrd en imagenes y las muestra.

El servidor WEB de guifi.net conoce la url del servidor de graficas de la zona de un nodo, o sea, los SNPServices clientes de cada zona. La web muestra sus datos locales y los datos remotos.

Definicion extendida

Pas 1.-Un nodo crea un servicio de servidor de gráficas en la web. Este servicio le concede un numero que le identifica. A este valor le llamamos $SNPGraphServerId Aquest servidor de gràfics, s'instalara un servei Apache, php i els ervei SNPServices. La direccio web l'anomenarem com $SNPDataServer_url

Este servicio puede ser ademas supernodo de una zona y por tanto tiene el código de la zona. A este valor el llamamos $rootZone

Pas 2,. Al crearse este nodo, se actualiza la BBDD de la web- Esta base de datos contiene toda la información de los nodos,servicios y demas de GUIFI.NET

Pas 3 i 4 Abans de continuar amb el treball que fa el servidor SNPServices client, el Master SNPServices ha de fer un treball. El Master SNPServices consulta al servidor Web una lista de todos los nodos de una zona. Aquesta pregunta la fa amb el script php que es diu refresh_cnml.php. . El servidor web li torna una llista de nodes en format CNML que enmagatzema en un arxiu que es diu /var/lib/snpservices/data/guifi.cnml

Mostro l'inici de l'arxiu guifi.cnml

<?xml version="1.0"?>
<cnml version="0.1" server_id="1" server_url="http://guifi.net" generated="20121105 1247">

Exactament l'arxiu que obre es aixi $SNPDataServer_url."/guifi/cnml/".$rootZone."/detail"

El servidor web torna un arxiu i el servidor SNPServices el guarda a /var/lib/snpservices/data/guifi.cnml Aquest arxiu s'actualitza de tant en tant i es necessari fer-ho ja que els canvis a la web no es reflexarien en els serveis a monitoritzar.

Pas 5 i 6.-Tornem al nostre servidor client SNPServices que estem muntant.

El servidor SNPServices te una direccio an on buscar l'arxiu cnml crear per el Master SNPServices $MRTGConfigSource='$SNPDataServer_url."/graphs/cnml2mrtgcsv.php?server".='.$SNPGraphServerId;

En aquesta direccio es descarrega la llista de nodes a monitoritzar i transforma el contingut en una arxiu que conte els nodes a monitotritzar i en un llenguatge que el pugui entendre el servei mrtg.

Mostro l'inici de l'arxiu mrtg.cfg

# PathAdd: /usr/local/rrdtool-1.2.12/bin
# LibAdd: /usr/local/rrdtool-1.2.12/lib/perl/5.8.8/i386-linux-thread-multi
HtmlDir: /var/lib/snpservices/rrimg/
ImageDir: /var/lib/snpservices/rrimg/ 
LogDir: /var/lib/snpservices/rrdb/
LogFormat: rrdtool
ThreshDir: /var/lib/snpservices/rrdb/
Forks: 12
Title[11833_ping]: Temps del ping de Futbol-Remei-VicRd1 

Per veure aquesta llista en format csv desde web la podem demanar aixi

$SNPDataServer_url/snpservices/graphs/cnml2mrtgcsv.php?server=$SNPGraphServerId

Jo ho faig amb aquests valors
http://192.168.1.44/snpservices/graphs/cnml2mrtgcsv.php?server=6833

De pas, veurem si fins aqui funciona tot.

El los del sistema a on ens diu els moviments d'aques proces esta a /var/log/snpservices/mrtgccfg.log

Al instalar el serveis SNPServices , s'ens ha afegit un cron a

Aquest cron (script que s'autoexecuta segons programació) esta aqui /etc/cron.d/snpservices

*/30 *  * * *   root    if [ -x /usr/bin/php ]; then env LANG=C /usr/bin/php /usr/share/snpservices/graphs/mrtgcsv2mrtgcfg.php >> /var/log/snpservices/mrtgccfg.log 2>&1; fi
*/5 *   * * *   root    if [ ! -x /var/lock/mrtg ]; then mkdir /var/lock/mrtg ; fi; if [ -x /usr/bin/mrtg ] && [ -r /var/lib/snpservices/data/mrtg.cfg ]; then env LANG=C /usr/bin/mrtg /var/lib/snpservices/data/mrtg.cfg --lock-file /var/lock/mrtg/guifi_l >> /var/log/snpservices/mrtg.log 2>&1; fi
/usr/share/snpservices/graphs/mrtgcsv2mrtgcfg.php 

Aquest ve a dir que mitjançant el script /usr/share/snpservices/graphs/mrtgcsv2mrtgcfg.php, consulti l'arxiu guifi.cnml abans descrit i transformi el contingut en un xml disponible per al servei mrtg. Ho enmagatzema en /var/lib/snpservices/data/mrtg.cfg

Una vegada el nostre servidor SNPServices client te les dades dels nodes a monitoritzar, es qua s'executa el proces de recerca de dades al mon amb el sistema mrtg. Ho fa amb /usr/bin/mrtg /var/lib/snpservices/data/mrtg.cfg

Pas 7 El servei mrtg consulta les dades amb ping i els envia a rrdtood que fabrica el gràfic. el log dels movimetns del servei mrtg estan a /var/log/snpservices/mrtgc.log Les dades per fer el gràfic s'enmagatzemen en /var/lib/snpservices/rrdb

Pas 8 Els clients que volen informació dels nodes, la busquen al servidor web, el servidor web busca les dades i les troba dins del seu MySQL, pero els gràfics els va a buscar al servidor de gràfics d'aquell node, o sigui, al server $SNPGraphServerId.

Manuales

• SNPservices Instalacion SNPServices mediante GIT. Aqui hay explicacion interesante, pero GIT no esta actualizado. Mejor usar instalacion de snpservices como servicio de Debian con metodo at-get
• Manual instalación Servicio SNPServices 1 (Debian/Ubuntu) método apt + configuración virtualhost apache
• Manual instalación Servicio SNPServices 2 (Debian/Ubuntu) método dpkg
• Manual instalación Servicio SNPServices 3 (Debian/Ubuntu) extendido
• [Tutorial servicio SNPServices http:www3.uji.es/~vrubert/guifi_linux/graph.html]

PMF

• Regenerar los ficheros rrd
• tener en cuenta que al connectar un dispositivo por cable ponerlo en Lan o en la ubicacion que sea, sino puede que no grafique correctamente.

Referencias

• manual debian de guifi.net
• manual de la associació Juvenil el Cueto (Rioja)