Diferencia entre revisiones de «SNPServices»

De Guifi.net - Wiki Hispano

(Configuración del archivo config.php)
(Configuración del archivo config.php)
Línea 89: Línea 89:
 
Vamos al grano.
 
Vamos al grano.
  
Aquí se configura el directorio raiz del servisio SNP. Esta variable es usada en varios sitios.
+
Aquí se configura el directorio raiz del servicio SNP. Esta variable es usada en varios sitios.
 
<pre>
 
<pre>
 
<?php
 
<?php
Línea 119: Línea 119:
 
</pre>
 
</pre>
  
Configuracion del servicio MRTG creador de gráficas
+
Configuracion del servicio MRTG creador de gráficas. Aqui le diremos donde almacenar los datos.
 
<pre>
 
<pre>
  
Línea 125: Línea 125:
 
// As a input, could be either a local (to be created from
 
// As a input, could be either a local (to be created from
 
// cached CNML file, or remote
 
// cached CNML file, or remote
 +
</pre>
 +
El programa cnml2mrtfcsv es el servicio SNPService principal y busca en la BBDD del servidor web los cambios que han habido. Si ha cambiado algo desde la ultima actualización, genera de nuevo el archivo CNML.
 +
Se tiene que modificar a la ruta que tengamos nosotros, normalmente dentro de ./graphs
 +
<pre>
 
$MRTGConfigSource='http://proves.elserrat.guifi.net/snpservices/graphs/cnml2mrtgcsv.php';
 
$MRTGConfigSource='http://proves.elserrat.guifi.net/snpservices/graphs/cnml2mrtgcsv.php';
 +
</pre>
 +
Aqui almacenamos los datos mrtg que recojamos
 +
<pre>
 
//$MRTGConfigSource='../data/guifi_mrtg.csv';
 
//$MRTGConfigSource='../data/guifi_mrtg.csv';
 +
 +
</pre>
 +
Configuracino para la creacion de archivo CNML
 +
<pre>
  
 
// CNMLSource: url for CNML node query, use sprintf syntax
 
// CNMLSource: url for CNML node query, use sprintf syntax
Línea 132: Línea 143:
 
//$CNMLSource='http://proves.elserrat.guifi.net/guifi/cnml/%s/node';
 
//$CNMLSource='http://proves.elserrat.guifi.net/guifi/cnml/%s/node';
 
// Cached CNML source (prefered)
 
// Cached CNML source (prefered)
 +
</pre>
 +
Aqui almacenamos los datos CNML que recojamos
 +
<pre>
 +
 
$CNMLSource='http://proves.elserrat.guifi.net/snpservices/common/qnodes.php?nodes=%s';
 
$CNMLSource='http://proves.elserrat.guifi.net/snpservices/common/qnodes.php?nodes=%s';
 
$CNMLData='../data/guifi.cnml';
 
$CNMLData='../data/guifi.cnml';
Línea 200: Línea 215:
  
 
?>
 
?>
 +
</pre>
 +
 +
=== Arrancamos y actualizamos datos ===
 +
Para arrancar y actualizar datos se hace mediante un comando llamado refresh.sh
 +
Mas adelante configuraremos para que refresque solo. Primero lo ejecutaremos manualmente
 +
 +
Lo he arrancado y me da el siguiente error
 +
<pre>
 +
root@webserver:/var/www/guifi/snpservices/common# ./refresh.sh
 +
Getting CNML file
 +
Error redaing CNML source\nroot
 +
</pre>
 +
Esto es porque no hay configurado algu parametro. Entramos en refhresh.sh y este nos envia a refresh.cnml.php
 +
 +
<pre>
 +
 
</pre>
 
</pre>
  

Revisión de 21:44 22 oct 2012

Servicio SNPServices =

SNPServices es un servicio de gráficas...


El sistema de monitorización de la red se realiza mediante 3 sistemas principales. Vea este documento para ver el esquema general http://es.wiki.guifi.net/wiki/Monitor



Configuración de servidor Cliente SNPServices El cliente SNPServices recoge información de su red mas cercana. La almacena y se la entrega al servidor web en modo de gráficas que incrusta en el entorno de guifi.net. Esta configuración es la que realizaras si quieres servir gráficos a la zona donde estas. Es muy probable que lo montes en el servidor proxy que tengáis, pero podría ser dedicado. El procedimiento lo encontrarás aquí http://es.wiki.guifi.net/wiki/Servidor_de_gr%C3%A1ficas


Servidor WEB El servidor web de guifi, única ente que accede a las bases de datos del sistema. Para montar un servicio WEB idéntico a www.guifi.net, o sea, un entorno de desarrollo se realiza mediante este procedimiento http://es.wiki.guifi.net/wiki/Preparando_el_entorno_de_desarrollo

Configuración de servidor MASTER SNPServices Este servicio solo es alcanzable desde el cliente SNPServices. Solo existe un servicio como este y esta en la central de GUIFI.NET. Desde aquí se crea el archivo CNML que se lo cede a los clientes SNPServices. Esta información se necesita para que los servicios SNPServices locales hagan sus comprobaciones de los sistemas cercanos. Básicamente SNPServices sirve recopilar información general de la red que esta en la BBDD de GUIFI. Cuando un cliente SNPServices le pide información de su red, el servidor se la concede en formato CNML.

Instalacion del servicio SNPServices

El servicio SNPServices Master y Cliente se instala del mismo modo. A diferencia entre ambos es que usan procedimientos diferentes en al ejecución de sus tareas. También alguno común.

Para instalarlo se hace así Nos creamos una cuenta en el repositorio gitorius. Clonamos el servicio snpservices para poder enviar nuestras mejoras. Lo descargamos.


cd /var/www/html
git clone git://gitorious.org/guifi/snpservices.git


También se puede descargar mediante repositorio. http://es.wiki.guifi.net/wiki/Configurar_Repositorio_apt_guifi


Una vez configurado el repositorio, descargamos servicio.

# apt-get install snpservices

Si quieres instalar el servicio SNPServices para servir gráficas sigue los pasos aqui http://es.wiki.guifi.net/wiki/Servidor_de_gr%C3%A1ficas

A partir de ahora configuraremos el servicio SNPServices Master para servir datos a los clientes SNPServicves

Configuración del servicio SNPServices Master

.Se crea un alias que apunte a nuestra carpeta donde hemos instalado el servicio

 Alias /snpservices /var/www/html/snpservices 

. Creas la rarpeta /tmp y le das permisos de escritura

mkdir /tmp
chmod a+rw snpservices/tmp

.Crea els ervicio en al base de datos usando esta direccion

 http://yourserver/snpservices

te saldra una pagina asi

ERROR: No service specified
CNML services
Version: 2.0
USAGE:
index.php?call=[service][&parameter[=value]]

services: help version phpinfo serverinfo [service]
  help
...sigue...

si fueras un cliente, el procedimiento continua cambiando el servidor root al que te conectas modificando el archivo /common/config.php. Es pro esto que nos sale el error "ERROR: No service specified", pero en este caso nosotros somos el roor y aqui tenemos que poner 3671 que representa al servidor web. Tenemos un archivo llamado common/config.php.template que nos servirá de plantilla

Configuración del archivo config.php

Vamos al grano.

Aquí se configura el directorio raiz del servicio SNP. Esta variable es usada en varios sitios.

<?php

// snp_pat: full directory where snp services are located
$snp_path='/var/www/html/snpservices';


Este es el numero de nodo que nos ha dado el servidor web al crear el servicio SNP Cliente.

// SNPGraphServerID: Default Graph Server ID
$SNPGraphServerId = 6579;

Servicio root. El root de nuestro servidor guifi actual es el 3671

// rootZone: which is the ROOT zone
$rootZone = 3671;

Aqui la direccion desde donde se enlaza a los servicios mediante web. Esta variable es usada en varios archivos de configuracion

// SNPDataServer_url: without ending backslash, the url where the data is
$SNPDataServer_url = 'http://guifi.net';

Configuracion del servicio MRTG creador de gráficas. Aqui le diremos donde almacenar los datos.


// MRTGConfigSource: mrtg csv data
// As a input, could be either a local (to be created from
// cached CNML file, or remote

El programa cnml2mrtfcsv es el servicio SNPService principal y busca en la BBDD del servidor web los cambios que han habido. Si ha cambiado algo desde la ultima actualización, genera de nuevo el archivo CNML. Se tiene que modificar a la ruta que tengamos nosotros, normalmente dentro de ./graphs

$MRTGConfigSource='http://proves.elserrat.guifi.net/snpservices/graphs/cnml2mrtgcsv.php';

Aqui almacenamos los datos mrtg que recojamos

//$MRTGConfigSource='../data/guifi_mrtg.csv';

Configuracino para la creacion de archivo CNML


// CNMLSource: url for CNML node query, use sprintf syntax
// MySQL-drupal source
//$CNMLSource='http://proves.elserrat.guifi.net/guifi/cnml/%s/node';
// Cached CNML source (prefered)

Aqui almacenamos los datos CNML que recojamos


$CNMLSource='http://proves.elserrat.guifi.net/snpservices/common/qnodes.php?nodes=%s';
$CNMLData='../data/guifi.cnml';


Configuracion de herramienta rrdtool. transforma tdatos en archivi .rrd para poder ser exportado. No hace falta hacer nada aqui


// rrdtool parameters
$rrdtool_path='/usr/bin/rrdtool';
$rrddb_path='/home1/comesfa/mrtg/logs/';
$rrdimg_path='/home1/comesfa/mrtg/images/';

// which version does have this server? 
// currently supported versions are:
// 1.2
// 1.3
$rrdtool_version = "1.3";

Configuracion de entorno MRTG. No hace falta hacer nada aqui


// mrtg local header
$rrdtool_header='# 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: %s
ImageDir: %s 
LogDir: %s
LogFormat: rrdtool
ThreshDir: %s
Forks: 12
';

// mrtg ping template
$mrtg_ping_template ='Title[%s_ping]: Temps del ping de %s 
PageTop[%s_ping]: <H1>Latència %s</H1>
     <TABLE
     <TR><TD>System:</TD>     <TD>%s</TD></TR>
     <TR><TD>Maintainer:</TD> <TD>guifi@guifi.net</TD></TR>
     <TR><TD>Description:</TD><TD>ping</TD></TR>
     <TR><TD>IP:</TD>         <TD>%s</TD></TR>
     </TABLE>
Target[%s_ping]: `/etc/mrtg/ping.sh %s`
MaxBytes[%s_ping]: 2000
Options[%s_ping]: growright,unknaszero,nopercent,gauge
LegendI[%s_ping]: Perduts %
LegendO[%s_ping]: Temps mig
Legend1[%s_ping]: Temps max. en ms
Legend2[%s_ping]: Temps min. en ms
YLegend[%s_ping]: RTT (ms)
';

$mrtg_traffic_template='Target[%s_traf]: %s:public@%s:
SetEnv[%s_traf]: MRTG_INT_IP="%s" MRTG_INT_DESCR="%s"
MaxBytes[%s_traf]: 104857600
Title[%s_traf]: Trànsit a %s de %s
PageTop[%s_traf]: <H1>Trànsit a %s de %s</H1>
     <TABLE>
     <TR><TD>System:</TD>     <TD>%s</TD></TR>
     <TR><TD>Maintainer:</TD> <TD>guifi@guifi.net</TD></TR>
     <TR><TD>Description:</TD><TD>%s</TD></TR>
     <TR><TD>Max Speed:</TD>  <TD>100.0 Mbytes/s</TD></TR>
     </TABLE>
';


?>

Arrancamos y actualizamos datos

Para arrancar y actualizar datos se hace mediante un comando llamado refresh.sh Mas adelante configuraremos para que refresque solo. Primero lo ejecutaremos manualmente

Lo he arrancado y me da el siguiente error

root@webserver:/var/www/guifi/snpservices/common# ./refresh.sh 
Getting CNML file
Error redaing CNML source\nroot

Esto es porque no hay configurado algu parametro. Entramos en refhresh.sh y este nos envia a refresh.cnml.php


Migración de un servidor a otro

Si quieres migrar un servidor de gráficas a otro servidor manteniendo las gráficas es tan simple como configurar el snpservices con el mismo ID que el antiguo y copiar los ficheros .rrd de /var/lib/snpservices/rrdb de la máquian vieja a la nueva.

Si la máquina nueva funciona con una arquitectura (por ejemplo, antes 32bits y ahora 64bits), los ficheros .rrd deben ser reconvertidos. Para ello hay que convertir el .rrd a XML y volver a crear el fichero .rrd a partir del XML.

En la máquina de 32bits ejecutamos esto:

rrdtool dump fitxer_32bits_.rrd > fitxer.xml

Copiamos el ficheor a la nueva máquina de 64bits y ejecutamos:

rrdtool restore fitxer.xml

Y queda generado el fichero .rrd

Herramientas personales