Servidor de gráficas

2012-11-11T22:20:15Z

Piura: /* Definicion */

Archivo:SNPServices.png

2012-11-11T22:19:17Z

Piura:

Módulo Drupal Guifi.net

2012-11-09T18:05:57Z

Piura: /* API */

La [[Web Guifi.net|web de Guifi.net]] funciona con el gestor de contenidos Drupal.

Para añadirle las funcionalidades de documentación de red libre se usa un módulo especial llamado drupal-guifi. Este módulo es software libre y está disponible en el repositorio de Gitorious<ref>http://gitorious.org/guifi/drupal-guifi</ref>.

La portada está diseñada mediante plantillas y se pueden encontrar en otro repositorio de Gitorious<ref>http://gitorious.org/guifi/portada</ref>.

== Historial de cambios ==
* [https://lists.guifi.net/pipermail/guifi-rdes/2012-June/024678.html Mapas y Google API v3], junio de 2012

== Características ==
* Gestión de zonas y nodos
* [https://guifi.net/guifi/menu/stats/growthmap Mapa de crecimiento]
* [[Unsolclic]]

=== API ===
El [[módulo Drupal Guifi.net]] implementa una '''API''' que permite a los desarrolladores crear aplicaciones externas que consulten y modifiquen la base de datos de Guifi.net. Las peticiones a la API se realizan mediante consultas de tipo GET del protocolo HTTP.

La documentación de dicha API se encuentra en el repositorio drupal-guifi, en la carpeta contrib/api_doc/<ref>http://gitorious.org/guifi/drupal-guifi/trees/master/contrib/api_doc</ref> y en la url [http://guifi.net/sites/all/modules/guifi/contrib/api_doc/index.php Documentació de l'API de guifi.net]. También hay disponible una librería PHP para trabajar más cómodamente con la API. Se puede encontrar en la carpeta contrib/api_client/<ref>http://gitorious.org/guifi/drupal-guifi/trees/master/contrib/api_client</ref>.

Las acciones posibles que se pueden realizar desde la API son las siguientes:



{| class="wikitable sortable"
|- style="background:#ececec;"
! Comando
! Descripción
! Ejemplo
|-
| guifi.auth.login
| Autentificar un usuario
| http://guifi.net/api?command=guifi.auth.login&username=&password=
|-
| guifi.zone.add
| Añadir una zona nueva
| http://guifi.net/api?command=guifi.zone.add
|-
| guifi.zone.update
| Actualizar una zona
| http://guifi.net/api?command=guifi.zone.update
|-
| guifi.zone.remove
| Borrar una zona
| http://guifi.net/api?command=guifi.zone.remove
|-
| guifi.zone.nearest
| Buscar la zona más cercana a un punto geográfico
| http://guifi.net/api?command=guifi.zone.nearest
|-
| guifi.node.add
| Añadir un nodo nuevo
| http://guifi.net/api?command=guifi.node.add
|-
| guifi.node.update
| Actualizar un nodo
| http://guifi.net/api?command=guifi.node.update
|-
| guifi.node.remove
| Borrar un nodo
| http://guifi.net/api?command=guifi.node.remove
|-
| guifi.device.add
| Añadir un nuevo dispositivo
| http://guifi.net/api?command=guifi.device.add
|-
| guifi.device.update
| Actualizar un dispositivo
| http://guifi.net/api?command=guifi.device.update
|-
| guifi.device.remove
| Borrar un dispositivo
| http://guifi.net/api?command=guifi.device.remove
|-
| guifi.radio.add
| Añadir una nueva radio
| http://guifi.net/api?command=guifi.radio.add
|-
| guifi.radio.update
| Actualizar una radio
| http://guifi.net/api?command=guifi.radio.update
|-
| guifi.radio.remove
| Borrar una radio
| http://guifi.net/api?command=guifi.radio.remove
|-
| guifi.radio.nearest
| Buscar las radios en modo AP más cercanas a un nodo
| http://guifi.net/api?command=guifi.radio.nearest
|-
| guifi.interface.add
| Añadir una nueva interfaz a una radio
| http://guifi.net/api?command=guifi.interface.add
|-
| guifi.interface.remove
| Borrar una interfaz de una radio
| http://guifi.net/api?command=guifi.interface.remove
|-
| guifi.link.add
| Añadir un nuevo enlace entre dos interfaces
| http://guifi.net/api?command=guifi.link.add
|-
| guifi.link.update
| Actualizar un enlace
| http://guifi.net/api?command=guifi.link.update
|-
| guifi.link.remove
| Borrar un enlace
| http://guifi.net/api?command=guifi.link.remove
|-
| guifi.misc.model
| Obtener los modelos de dispositivos soportados en Guifi.net
| http://guifi.net/api?command=guifi.misc.model
|-
| guifi.misc.manufacturer
| Obtener los fabricantes de dispositivos soportados en Guifi.net
| http://guifi.net/api?command=guifi.misc.manufacturer
|-
| guifi.misc.firmware
| Obtener los firmwares de dispositivos soportados en Guifi.net
| http://guifi.net/api?command=guifi.misc.firmware
|-
| guifi.misc.protocol
| Obtener los protocolos soportados en Guifi.net
| http://guifi.net/api?command=guifi.misc.protocol
|-
| guifi.misc.channel
| Obtener los canales de un protocolo soportados en Guifi.net
| http://guifi.net/api?command=guifi.misc.channel
|}

<pre>
'''MENSAJE OBTENIDO DE LISTAS DE CORREO PARA AGREGAR AQUI SI INTERESA'''
Para hacer uso de la capa de abstracción de base de datos que proporciona guifi_db.inc.php, o funciones ya desarrolladas tipo guifi_log, guifi_notify, etc
</pre>

=== Roles de usuarios ===
Los roles definen lo que puede hacer cada usuario registrado. Por ejemplo: traducir páginas, modificar nodos que no son tuyos... etc.

Más información aquí en [https://guifi.net/es/node/38115 Roles de la web]

Por defecto, el usuario tiene el rol más básico. Si necesitas más permisos para hacer algo, pídelos en alguna de las [[listas de correo]] como guifi-hispano, guifi-usuaris o guifi-rdes.

== Referencias ==
<references/>

== Véase también ==
* [[Módulo apadrinamientos]]
* [[Web Guifi.net]]

== Enlaces externos ==
* [http://drupal.org/ Sitio oficial de Drupal]
* [[wikipedia:es:Interfaz de programación de aplicaciones|API]] (Wikipedia)

[[Categoría:Desarrollo]]
[[Categoría:Web]]

SNPServices

2012-11-07T09:36:59Z

Piura: /* Instalacion del servicio SNPServices mediante GIT */

==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 mediante GIT===

<pre>Nota: Este metodo de instalacion depende de que el repositorio este actualizado y a fecha de 07/11/2012 no lo esta.
Me ha sido mas fácil la instalación mediante apt-get install.</pre>
* [[Servidor de gráficas 1]] (Debian/Ubuntu) método apt + configuración virtualhost apache
* [[Servidor de gráficas 2]] (Debian/Ubuntu) método dpkg
* [[Servidor de gráficas 3]] (Debian/Ubuntu) extendido

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.

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

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

* [[Configurar_Repositorio_apt_guifi|Configurar el Repositorio de apt de Guifi]]

Una vez configurado el repositorio, descargamos servicio.

<pre># apt-get install snpservices</pre>

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

<pre> Alias /snpservices /var/www/html/snpservices </pre>

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

<pre>mkdir /tmp
chmod a+rw snpservices/tmp
</pre>

.Crea els ervicio en al base de datos usando esta direccion
<pre> http://yourserver/snpservices</pre>

te saldra una pagina asi
<pre>
ERROR: No service specified
CNML services
Version: 2.0
USAGE:
index.php?call=[service][&parameter[=value]]

services: help version phpinfo serverinfo [service]
help
...sigue...
</pre>

si fueras un cliente, el procedimiento continua cambiando el servidor root al que te conectas modificando el archivo /common/config.php.
Es por esto que nos sale el error "ERROR: No service specified", pero en este caso nosotros somos el root y aqui tenemos que poner un que representa al servidor web. Para guifi tenemos un valor reservado. Si quieres contactar con el servidor root, debes de pedirlo en los foros abiertos en las listas de desarrollo. Para cualquier entorno podria valer con poner otro servidor de gráficas.

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.
<pre>
<?php

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

Este es el numero de nodo que nos ha dado el servidor web al crear el servicio SNP Cliente.
<pre>
// SNPGraphServerID: Default Graph Server ID
$SNPGraphServerId = 6579;

</pre>

Servicio root. El root de nuestro servidor guifi actual es la pagina web www.guifi.net
<pre>
// rootZone: which is the ROOT zone
$rootZone = ****; (valor reservado por seguridad)

</pre>

Aqui la direccion desde donde se enlaza a los servicios mediante web. Esta variable es usada en varios archivos de configuracion
<pre>
// SNPDataServer_url: without ending backslash, the url where the data is
$SNPDataServer_url = 'http://guifi.net';

</pre>

Configuracion del servicio MRTG creador de gráficas. Aqui le diremos donde almacenar los datos.
Tienes que crear el directorio mrtg en /snpservices/mrtg
<pre>

// MRTGConfigSource: mrtg csv data
// As a input, could be either a local (to be created from
// 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';
</pre>
Aqui almacenamos los datos mrtg que recojamos. La carpeta data no esta creada por defecto. La tenemos que crear mediante mkdir data desde el directorio snpservice
<pre>
//$MRTGConfigSource='../data/guifi_mrtg.csv';

</pre>
Configuracino para la creacion de archivo CNML
<pre>

// 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)
</pre>
Aqui almacenamos los datos CNML que recojamos
<pre>

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

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

// 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";

</pre>
Configuracion de entorno MRTG. No hace falta hacer nada aqui
<pre>

// 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>
';

?>
</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 refresh.sh y este nos envia a refresh.cnml.php
refress.sh llama a dos archivos php.

<pre>
root@webserver:/var/www/guifi/snpservices/common# cat refresh.sh
#!/bin/bash
# Refreshing CNML local file (optional)
php refresh_cnml.php
</pre>

=== Configurar refresh.cnml.php ===
Veamos ahora el archivo de configuracion refresh.cnml.php

Si queremos ejecutar este archivo lo hacemos mediante la llamada a php
Aqui vemos que error genera y podremos ir a ver donde esta ocurriendo.

Este es el archivo. Primero carga una configuración común en el archivo config.php. Sino busca la plantilla config.php.template
<pre>
<?php

if (file_exists("config.php")) {
include_once("./config.php");
} else {
include_once("config.php.template");
}

$minX = 999;
$minY = 999;
$maxX = -999;
$maxY = -999;

$members = array();

</pre>
Intenta abrir archivo ya creado. Tenemos que modificar la ruta donde almacena esta informacion. Compara la fecha de actualización anterior y la actual para decidir si hacer un refresco completo o no.
si todo esta actualizado, ejecuta exit() y acaba.

<pre>

$hlastnow = @fopen($SNPDataServer_url."/guifi/refresh/cnml", "r")
or die('Error reading last timestamp\n');
$last_now = fgets($hlastnow);
fclose($hlastnow);

$hlast= @fopen("/tmp/last_update.cnml", "r");
if (($hlast) and ($last_now == fgets($hlast))) {
fclose($hlast);
echo "No changes.\n";
exit();

</pre>

Si está mal configurado estos parámetros, tendremos el siguiente error
<pre>
root@webserver:/var/www/guifi/snpservices/common# php refresh_cnml.php
Getting CNML file
Error reading last timestamp
root@webserver:/var/www/guifi/snpservices/common#
</pre>

Aqui es cuando empieza la búsqueda de cambios.
El primer open abre un archivo de la web con los contenidos. estos son comparados con el archivo que tenemos en /tmp. Si son diferentes, realiza una descarga y lo actualiza.
<pre>

echo "Getting CNML file\n";
$hcnml = @fopen($SNPDataServer_url."/guifi/cnml/".$rootZone."/detail", "r")
or die ('Error redaing CNML source\n');
$wcnml = @fopen("../data/guifi.cnml.tmp", "w");
while (!feof($hcnml)) {
$buffer = fgets($hcnml, 4096);
fwrite($wcnml,$buffer);
}
fclose($hcnml);
fclose($wcnml);
exec ("/bin/cp ../data/guifi.cnml.tmp ../data/guifi.cnml");

$hlast= @fopen("/tmp/last_update.cnml", "w") or die('Error!');
fwrite($hlast,$last_now);
fclose($hlast);
?>

}

</pre>

Si esta mal configurado, recibiremos este error. Tambien puede identificar falta de recursos para Apache.Mira el log de Apache.
<pre>
root@webserver:/var/www/guifi/snpservices/common# php refresh_cnml.php
Getting CNML file
Error redaing CNML source\n
root@webserver:/var/www/guifi/snpservices[Sat May 22 00:39:01 2010] [notice] child pid 14787 exit signal Segmentation fault (11)/common#
</pre>
El sistema dentro de la web que crea el archivo CNML es un proceso de un modulo de Drupal del sistema guifi
Lo encontraras aqui

<pre>
/sites/all/modules/guifi/guifi_cnml.inc.php
</pre>

Ahora tenemos dentro de /data dos archivos iguales llamados guifi.cnml i guifi.cnml.tmp con os contenidos encontrados.
También actualiza datos en /tmp/last_update.cnml que se usara nuevamente en la próxima actualizacion

=== Prueba de servicio ===

Un cliente con servici SNPService usara el servicio SNPService Master recien creado para preguntar informacion acerca un nodo de esta manera
http://www.guifi.net/snpservices/graphs/cnml2mrtgcsv.php?server=6558

Esto nos devuelve un archivo CNML como este
<pre>
46491,#VicPuigsacalm2Rd1,10.138.48.51,wlan1;VicVcPgsclm2Rd1CPE0,Planned
38297,#VicCnvntCrmltsRd1,10.138.160.39,ath0;Vic-1-NOVcCnvntCrmltsRd1CPE0,Working
45489,#Vic11Set38Rd1,10.138.168.170,wlan1;Vic-1-NOVc11St38Rd1CPE0,Planned
44406,#Vic11set40Rd2,10.138.101.4,ath0;Vic-1-NO11st40Rd2CPE0,Working
33929,#Vic11setembre25Rd1,10.138.22.87,wifi0;Vic-1-NOVc11stmbr25Rd1CPE0,Working
18809,#VicAGrifollRd2,10.138.14.104,6,Working
40356,#VicAlbergCanongeRd2,10.138.10.80,Lan/Lan;Vic-1-NOVclbrgCnngRd2CPE0,Working
22068,#VicAlemanyRd1,10.138.14.135,wifi0;Vic-1 NOVclmnyRd1CPE0,Working
30303,#VicAlemanyRd2,10.138.14.201,wifi0;Vic-1 NOVclmnyRd2CPE0,Planned
36620,#VicAlinaRd2,10.138.10.72,wlan1;Vic-1-NOVclnRd2CPE0,Working
7211,#VicAngladaRd1,10.138.10.73,Lan/Lan;VicAngladaRadio1-0,Working
19857,#VicAnnaBRd2,10.138.11.62,wifi0;VicVcnnBRd2CPE0,Working
14203,#VicAnnaMaxenchsRd1,10.138.22.41,wifi0;VicVcnnMxnchsRd1CPE0,Working
13655,#VicAnnaPratRd1,10.138.11.51,;VicVcnnPrtRd2CPE0,Working
17035,#VicAnnaSolerRd3,10.138.22.196,6,Working
</pre>

La configuracion puede que no funcione. Para ver errores, pedir a apache que nos mustre su log
<pre>
root@webserver:~# tail -f /var/log/apache2/*.log
</pre>

Yo me he encotnrado este error
<pre>
[Mon Oct 22 23:27:07 2012] [error] [client 192.168.1.40] PHP Warning: DOMDocument::load():
Premature end of data in tag html line 3 in /var/www/drupal-6.26/snpservices/data/guifi.cnml, line: 149 in /var/www/drupal-6.26/snpservices/graphs/cnml2mrtgcsv.php on line 270

</pre>

Tambien este. Parece que al intentar cargar la zona, da un error Apache a causa de falta de memoria al cargar todos los datos en una variable
Para solucioanrlo se tiene que modificar el limite d ememoria para php dentro de /etc/php5/apache/php.ini
La variable se llama
memory_limit = 128M
Parece que si lo pones a -1 equivale a que no tenga limite.
http://es1.php.net/manual/es/ini.core.php#ini.memory-limit

<pre>
==> /var/log/apache2/error.log <==
[Tue Oct 23 20:54:16 2012] [error] [client 192.168.1.44] PHP Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 20 bytes) in /var/www/drupal-6.26/includes/database.mysqli.inc on line 150
</pre>

De todas maneras, los recursos son limitados. Este mensaje en Apache identifica lo msimo. Falta de recursos. En mi caso, como no tengo mas, hago una consulta mas pequeña para poder probar.el error que me salia es este
<pre>
[Sat May 22 00:39:01 2010] [notice] child pid 14787 exit signal Segmentation fault (11)
</pre>
He aprendido la causas aquí http://www.webhostingtalk.com/showthread.php?t=950165

=== 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

[[Categoría:SNPServices]]

SNPServices

2012-11-07T09:36:31Z

Piura: /* Instalacion del servicio SNPServices mediante GIT */

==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 mediante GIT===

<pre>Nota: Este metodo de instalacion depende de que el repositorio este actualizado y a fecha de 07/11/2012 no loe sta. Me ha sido mas facil la isntalacion mediante apt-get install.</pre>
* [[Servidor de gráficas 1]] (Debian/Ubuntu) método apt + configuración virtualhost apache
* [[Servidor de gráficas 2]] (Debian/Ubuntu) método dpkg
* [[Servidor de gráficas 3]] (Debian/Ubuntu) extendido

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.

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

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

* [[Configurar_Repositorio_apt_guifi|Configurar el Repositorio de apt de Guifi]]

Una vez configurado el repositorio, descargamos servicio.

<pre># apt-get install snpservices</pre>

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

<pre> Alias /snpservices /var/www/html/snpservices </pre>

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

<pre>mkdir /tmp
chmod a+rw snpservices/tmp
</pre>

.Crea els ervicio en al base de datos usando esta direccion
<pre> http://yourserver/snpservices</pre>

te saldra una pagina asi
<pre>
ERROR: No service specified
CNML services
Version: 2.0
USAGE:
index.php?call=[service][&parameter[=value]]

services: help version phpinfo serverinfo [service]
help
...sigue...
</pre>

si fueras un cliente, el procedimiento continua cambiando el servidor root al que te conectas modificando el archivo /common/config.php.
Es por esto que nos sale el error "ERROR: No service specified", pero en este caso nosotros somos el root y aqui tenemos que poner un que representa al servidor web. Para guifi tenemos un valor reservado. Si quieres contactar con el servidor root, debes de pedirlo en los foros abiertos en las listas de desarrollo. Para cualquier entorno podria valer con poner otro servidor de gráficas.

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.
<pre>
<?php

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

Este es el numero de nodo que nos ha dado el servidor web al crear el servicio SNP Cliente.
<pre>
// SNPGraphServerID: Default Graph Server ID
$SNPGraphServerId = 6579;

</pre>

Servicio root. El root de nuestro servidor guifi actual es la pagina web www.guifi.net
<pre>
// rootZone: which is the ROOT zone
$rootZone = ****; (valor reservado por seguridad)

</pre>

Aqui la direccion desde donde se enlaza a los servicios mediante web. Esta variable es usada en varios archivos de configuracion
<pre>
// SNPDataServer_url: without ending backslash, the url where the data is
$SNPDataServer_url = 'http://guifi.net';

</pre>

Configuracion del servicio MRTG creador de gráficas. Aqui le diremos donde almacenar los datos.
Tienes que crear el directorio mrtg en /snpservices/mrtg
<pre>

// MRTGConfigSource: mrtg csv data
// As a input, could be either a local (to be created from
// 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';
</pre>
Aqui almacenamos los datos mrtg que recojamos. La carpeta data no esta creada por defecto. La tenemos que crear mediante mkdir data desde el directorio snpservice
<pre>
//$MRTGConfigSource='../data/guifi_mrtg.csv';

</pre>
Configuracino para la creacion de archivo CNML
<pre>

// 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)
</pre>
Aqui almacenamos los datos CNML que recojamos
<pre>

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

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

// 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";

</pre>
Configuracion de entorno MRTG. No hace falta hacer nada aqui
<pre>

// 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>
';

?>
</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 refresh.sh y este nos envia a refresh.cnml.php
refress.sh llama a dos archivos php.

<pre>
root@webserver:/var/www/guifi/snpservices/common# cat refresh.sh
#!/bin/bash
# Refreshing CNML local file (optional)
php refresh_cnml.php
</pre>

=== Configurar refresh.cnml.php ===
Veamos ahora el archivo de configuracion refresh.cnml.php

Si queremos ejecutar este archivo lo hacemos mediante la llamada a php
Aqui vemos que error genera y podremos ir a ver donde esta ocurriendo.

Este es el archivo. Primero carga una configuración común en el archivo config.php. Sino busca la plantilla config.php.template
<pre>
<?php

if (file_exists("config.php")) {
include_once("./config.php");
} else {
include_once("config.php.template");
}

$minX = 999;
$minY = 999;
$maxX = -999;
$maxY = -999;

$members = array();

</pre>
Intenta abrir archivo ya creado. Tenemos que modificar la ruta donde almacena esta informacion. Compara la fecha de actualización anterior y la actual para decidir si hacer un refresco completo o no.
si todo esta actualizado, ejecuta exit() y acaba.

<pre>

$hlastnow = @fopen($SNPDataServer_url."/guifi/refresh/cnml", "r")
or die('Error reading last timestamp\n');
$last_now = fgets($hlastnow);
fclose($hlastnow);

$hlast= @fopen("/tmp/last_update.cnml", "r");
if (($hlast) and ($last_now == fgets($hlast))) {
fclose($hlast);
echo "No changes.\n";
exit();

</pre>

Si está mal configurado estos parámetros, tendremos el siguiente error
<pre>
root@webserver:/var/www/guifi/snpservices/common# php refresh_cnml.php
Getting CNML file
Error reading last timestamp
root@webserver:/var/www/guifi/snpservices/common#
</pre>

Aqui es cuando empieza la búsqueda de cambios.
El primer open abre un archivo de la web con los contenidos. estos son comparados con el archivo que tenemos en /tmp. Si son diferentes, realiza una descarga y lo actualiza.
<pre>

echo "Getting CNML file\n";
$hcnml = @fopen($SNPDataServer_url."/guifi/cnml/".$rootZone."/detail", "r")
or die ('Error redaing CNML source\n');
$wcnml = @fopen("../data/guifi.cnml.tmp", "w");
while (!feof($hcnml)) {
$buffer = fgets($hcnml, 4096);
fwrite($wcnml,$buffer);
}
fclose($hcnml);
fclose($wcnml);
exec ("/bin/cp ../data/guifi.cnml.tmp ../data/guifi.cnml");

$hlast= @fopen("/tmp/last_update.cnml", "w") or die('Error!');
fwrite($hlast,$last_now);
fclose($hlast);
?>

}

</pre>

Si esta mal configurado, recibiremos este error. Tambien puede identificar falta de recursos para Apache.Mira el log de Apache.
<pre>
root@webserver:/var/www/guifi/snpservices/common# php refresh_cnml.php
Getting CNML file
Error redaing CNML source\n
root@webserver:/var/www/guifi/snpservices[Sat May 22 00:39:01 2010] [notice] child pid 14787 exit signal Segmentation fault (11)/common#
</pre>
El sistema dentro de la web que crea el archivo CNML es un proceso de un modulo de Drupal del sistema guifi
Lo encontraras aqui

<pre>
/sites/all/modules/guifi/guifi_cnml.inc.php
</pre>

Ahora tenemos dentro de /data dos archivos iguales llamados guifi.cnml i guifi.cnml.tmp con os contenidos encontrados.
También actualiza datos en /tmp/last_update.cnml que se usara nuevamente en la próxima actualizacion

=== Prueba de servicio ===

Un cliente con servici SNPService usara el servicio SNPService Master recien creado para preguntar informacion acerca un nodo de esta manera
http://www.guifi.net/snpservices/graphs/cnml2mrtgcsv.php?server=6558

Esto nos devuelve un archivo CNML como este
<pre>
46491,#VicPuigsacalm2Rd1,10.138.48.51,wlan1;VicVcPgsclm2Rd1CPE0,Planned
38297,#VicCnvntCrmltsRd1,10.138.160.39,ath0;Vic-1-NOVcCnvntCrmltsRd1CPE0,Working
45489,#Vic11Set38Rd1,10.138.168.170,wlan1;Vic-1-NOVc11St38Rd1CPE0,Planned
44406,#Vic11set40Rd2,10.138.101.4,ath0;Vic-1-NO11st40Rd2CPE0,Working
33929,#Vic11setembre25Rd1,10.138.22.87,wifi0;Vic-1-NOVc11stmbr25Rd1CPE0,Working
18809,#VicAGrifollRd2,10.138.14.104,6,Working
40356,#VicAlbergCanongeRd2,10.138.10.80,Lan/Lan;Vic-1-NOVclbrgCnngRd2CPE0,Working
22068,#VicAlemanyRd1,10.138.14.135,wifi0;Vic-1 NOVclmnyRd1CPE0,Working
30303,#VicAlemanyRd2,10.138.14.201,wifi0;Vic-1 NOVclmnyRd2CPE0,Planned
36620,#VicAlinaRd2,10.138.10.72,wlan1;Vic-1-NOVclnRd2CPE0,Working
7211,#VicAngladaRd1,10.138.10.73,Lan/Lan;VicAngladaRadio1-0,Working
19857,#VicAnnaBRd2,10.138.11.62,wifi0;VicVcnnBRd2CPE0,Working
14203,#VicAnnaMaxenchsRd1,10.138.22.41,wifi0;VicVcnnMxnchsRd1CPE0,Working
13655,#VicAnnaPratRd1,10.138.11.51,;VicVcnnPrtRd2CPE0,Working
17035,#VicAnnaSolerRd3,10.138.22.196,6,Working
</pre>

La configuracion puede que no funcione. Para ver errores, pedir a apache que nos mustre su log
<pre>
root@webserver:~# tail -f /var/log/apache2/*.log
</pre>

Yo me he encotnrado este error
<pre>
[Mon Oct 22 23:27:07 2012] [error] [client 192.168.1.40] PHP Warning: DOMDocument::load():
Premature end of data in tag html line 3 in /var/www/drupal-6.26/snpservices/data/guifi.cnml, line: 149 in /var/www/drupal-6.26/snpservices/graphs/cnml2mrtgcsv.php on line 270

</pre>

Tambien este. Parece que al intentar cargar la zona, da un error Apache a causa de falta de memoria al cargar todos los datos en una variable
Para solucioanrlo se tiene que modificar el limite d ememoria para php dentro de /etc/php5/apache/php.ini
La variable se llama
memory_limit = 128M
Parece que si lo pones a -1 equivale a que no tenga limite.
http://es1.php.net/manual/es/ini.core.php#ini.memory-limit

<pre>
==> /var/log/apache2/error.log <==
[Tue Oct 23 20:54:16 2012] [error] [client 192.168.1.44] PHP Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 20 bytes) in /var/www/drupal-6.26/includes/database.mysqli.inc on line 150
</pre>

De todas maneras, los recursos son limitados. Este mensaje en Apache identifica lo msimo. Falta de recursos. En mi caso, como no tengo mas, hago una consulta mas pequeña para poder probar.el error que me salia es este
<pre>
[Sat May 22 00:39:01 2010] [notice] child pid 14787 exit signal Segmentation fault (11)
</pre>
He aprendido la causas aquí http://www.webhostingtalk.com/showthread.php?t=950165

=== 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

[[Categoría:SNPServices]]

SNPServices

2012-11-07T09:36:08Z

Portada

2012-10-24T19:07:44Z

Piura: /* Servicios básicos */

<div style="width: 600px; margin: 0 auto; background-color: #fcfcfc; border: 1px solid #ccc; border-bottom: 5px groove #999999; border-right:5px groove #999999; text-align: center; padding: 0.4em;">
<div style="font-size: 162%; padding: 0.1em;">[[Archivo:Logo_guifi.svg|left|56px]][[Archivo:Logo_guifi.svg|right|56px]]Bienvenid@ al wiki de '''Guifi.net'''</div>
<div style="font-size: 95%;">Documentación sobre la red abierta, libre y neutral.</div>
<div style="font-size: 85%;">En estos momentos tenemos [[Especial:Estadísticas|{{NUMBEROFARTICLES}}]] [[Especial:Todas|artículos]] en español.</div></div>

__NOTOC__
{| style="width:100%; background:#f6f6f6; border:1px solid #C7D0F8; font-size:107%; -moz-border-radius:1em; -webkit-border-radius:1em;border-radius:1em;"
| valign="top" style="padding:12px 17px 5px 17px" |
'''Guifi.net''' es de todos, participa [[conectar|conectando]] tu [[tramo de la red]] con la de los demás.

Es un proyecto colaborativo organizado horizontalmente que agrupa tanto a personas individuales como a colectivos, empresas y administraciones. Es abierto, por lo que todo el mundo puede participar en igualdad de condiciones, en el marco de [http://guifi.net/es/ProcomunXOLN Procomún de la Red Abierta, Libre y Neutral]

{| style="width:100%; background:#f6f6f6"
| style="background:#f5e9be; border:1px solid #C7D0F8; font-size:107%; -moz-border-radius:1em; -webkit-border-radius:1em;border-radius:1em; width:20%" |
* [[Qué es un wiki]]
* [[Guifi.net|Más sobre Guifi.net]]
* [http://guifi.net/es/experiencias Casos de éxito]
| style="text-align: right; width 30%; padding:30px" |''La documentación de guifi.net contiene los documentos de referencia para usuarios nuevos, experimentados y desarrolladores. Sé libre [[Qué es un wiki|de editar esta wiki]] para mejorar su contenido.''
|}
<div style=" text-align: center">Contacta: [http://guifi.net/es/forum/231 Foros] '''|''' [http://lists.guifi.net Listas de correo] '''|''' [http://irc.guifi.net/?channels=guifi Chat]</div>
|}

{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"
| style="width:50%; background:#FFFFE0; border:1px solid #EECFA1; padding:10px; margin-bottom:7px; vertical-align:top; -moz-border-radius:1em; -webkit-border-radius:1em; border-radius:1em;" |

<div id="mp-tfa">
{| id="mp-left" style="vertical-align:top; background:#FFFFE0; border-spacing: 0px;"
! style="background:#FFDEAD; border:1px solid #EECFA1; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Cómo conectarse a Guifi.net
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" |
|-
| colspan=2 style="color:#000; background:#FFFFE0; padding:15px 5px" | <div id="mp-itn"><div style="text-align:left; font-size:95%;">

* [[tres pasos|Cómo dar de alta y enlazar un nodo]]
* [[Elige el material]]
* [[Configura tu ordenador]]
* [[Buenas Prácticas|Código de buenas prácticas]]

|}</div>

| style="border:1px solid transparent;" |
| style="width:50%;background:#f5fffa;border:1px solid #99CC33;padding:10px;margin-bottom:7px; vertical-align:top;-moz-border-radius:1em;-webkit-border-radius:1em;border-radius:1em; " |
<div id="mp-itn">
{| id="mp-left" style="vertical-align:top; background:#f5fffa; border-spacing: 0px;"
! style="background:#a5e085; border:1px solid #99CC33; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Supernodos e islas
! style="background:#a5e085; border:1px solid #99CC33; border-left:0px; padding:0px; vertical-align:middle;" |
|-
| colspan=2 style="color:#000; background:#f5fffa; padding:15px 5px" |<div id="mp-itn"><div style="text-align:left; font-size:95%;">
* [[Empezar una isla desde 0|Comenzar una isla desde cero]]
* [[Crear un supernodo]]
* [[Buenas Prácticas|Código de buenas prácticas]]</div></div>
|}</div>
|}

{| id="mp-upper" style="width: 100%; margin:6px 0 0 0; background:none; border-spacing: 0px;"
| style="width:50%; style="background:#f5faff;border:1px solid #cedff2;padding:10px;margin-bottom:7px; vertical-align:top;-moz-border-radius:1em;-webkit-border-radius:1em;border-radius:1em; " |
<div id="mp-dyk">
{| id="mp-left" style="vertical-align:top; background:#f5faff; border-spacing: 0px;"
! style="background:#cedff2; border:1px solid #cedff2; border-right:0px; padding:0px; font-size:150%; vertical-align:middle; font-weight:normal; width:100%;" | Guifi.net ++
! style="background:#cedff2; border:1px solid #cedff2; border-left:0px; padding:0px; vertical-align:middle;" |
|-
| colspan=2 style="color:#000; background:#f5fffa; padding:15px 5px" |<div id="mp-itn"><div style="text-align:left; font-size:95%;">

== [[Legal]] ==
* [[Ayuntamientos]] / [[Anexo:Guifi.net en Ayuntamientos]]
* [[Associación|Constitución de una asociación]]
* [[Legislaciones|Legislaciones Países]]
* [[FAQ_Legal|FAQ]]

== Red ==
=== Los básicos en la web ===
* [[Zona|Crear y modificar una zona]]
* [[Añadir_un_nodo_de_guifi.net|Añadir un nodo de guifi.net]]
* [[Servicios|Crear servicios y vincularlos en los servidores]]
* [[Herramientas|Herramientas (localización de IPs y MACs, estadísticas, mapas de enrutamiento, etc.)]]

=== Infraestructura ===
* [[Crear_un_supernodo|Montaje de supernodos]]
* [[Filtros de red]]
* [[Enlaces virtuales]]
* [[Herramienta para buscar rangos de IPs libres]]
* [[Nanostations: Modificando configuración por consola]]

=== Mesh ===
* [[Alix+GSF|ALIX + Conectarse a la nube de gracia con mesh]]

=== Enrutamientos y conceptos de redes ===
{{div col|cols=2}}
* [[Enrutamientos]]
* [[Peerings]]
* [[IPv4]]
* [[IPv6]]
* [[Criterios de asignación de direcciones IPv4]]
* [[ARP]]
* [[Cables_UTP|Cables UTP]]
{{div end}}

=== General ===
{{div col|cols=2}}
* [[Cómo se vertebra la red: Troncal, puntos de acceso y conexiones simples]]
* [[La seguridad en la red abierta]]
* [[Aplicaciones | Aplicaciones de guifi.net]]
* [[Recursos externos]]
* [[Instalar firmware Ubiquiti Rocket M5]]
{{div end}}

== Sistemas ==
* [[Distribución guinux]]
* [[Servidor compacto con una routerstation]]

=== Servicios básicos ===
{{div col|cols=2}}
* [[Configurar Repositorio APT guifi]]
* [[Servidor Proxy]]
* [[Servidor de gráficas]]
* [[SNPServices]]
* [[Servidor DNS]]
* [[Servidor Reloj|Servidor de Reloj (NTP)]]
* [[Salida a Internet]] (aka proxy)
{{div end}}

=== Servicios de compartición de ficheros ===
{{div col|cols=2}}
* [[Servidor FTP]]
* [[Servidor Peer 2 Peer]]
* [[Servidor DCC]]
{{div end}}

=== Servicios de mensajería ===
{{div col|cols=2}}
* [[Servidor de Correo]]
* [[Webmail]]
* [[Servidor Jabber]]
* [[Servidor IRC]]
* [[Mailman]]
{{div end}}

=== Servicios de Voz y Vídeo ===
{{div col|cols=2}}
* [[VoIP|Servidor de VeuIP (VoIP)]]
* [[Servidor Radio Streaming]]
{{div end}}

=== Otros Servicios ===
{{div col|cols=2}}
* [[LDAP|Servidor LDAP]]
* [[Apache|Servidor web Apache]]
* [[Servidor Repositorio Linux]]
* [[Servidor Repositorio Linux (Cache)]]
* [[Servidor Iperf]]
* [[Servidor repositorio subversion]]
* [[DHCP|Servidor DHCP]]
* [[MySQL]] (Bases de Datos)
* [[Proxmox]] (virtualitzación)
* [[Cacti]] (monitorización)
* [[Clamav]] (antivirus con GNU/Linux)
* [[Trac]] (sistema de gestión de tiquets)
* [[Monitor]] (Monitorización de la red distribuida)
{{div end}}

=== Sistema ===
{{div col|cols=2}}
* [[ACPI]]
* [[Bridges_con_Linux|Bridges con GNU/Linux]]
* [[Chroot]]
* [[Corkscrew]]
{{div end}}

== Estandares de transmisión de datos y organizaciones colaboradoras ==
{{div col|cols=2}}
* [http://es.wikipedia.org/wiki/IEEE_802.11 IEEE 802.11]
* [http://es.wikipedia.org/wiki/Multimedia_over_Coax_Alliance Multimedia over Coax Alliance]
* [http://en.wikipedia.org/wiki/HomePNA HomePNA]
* [[Aprovechar el cable de antena de televisión]]
{{div end}}

== Instaladores ==
{{div col|cols=2}}
* [[Pararrayos]]
* [[Aprovechar el cable de antena de televisión]]
* [[Presupuestos]]
* [http://guifi.net/ca/node/12486 Comunidad de vecinos, caso de ejemplo]
* [[Reinicio remoto de nodos]]
{{div end}}

== Desarrolladores ==
{{div col|cols=2}}
* [[Preparando el entorno de desarrollo]]
* [[Manual editor wiki]]
* [http://wiki.guifi.net/wiki/Trac Trac de Guifi.net]
* [[Actualizaciones módulos drupal]]
* [[Mapas de nodos en la web]]
* [http://gitorious.org/guifi Repositorios del código del proyecto guifi.net]
* [[Mapa del código]]
* [[API de Guifi]]
* [[CNML]]
* [[Empotrar_mapa_de_guifi|Empotrar el mapa de Guifi-Google Maps en una web]]
* [[Unsóloclic]]
* [[:Categoría:router|Routers]]
* [[:Categoría:Telefonía móvil|Telefonía móvil sobre guifi.net]]
{{div end}}

== Diseñadores ==
{{div col|cols=2}}
* [[Logos]]
* [[Maquetación de las distintas páginas web]]
* [[Usabilidad]]
* [[Presentaciones de guifi.net]]
{{div end}}

== Desarrollo colectivo de la red ==
{{div col|cols=2}}
* [[Cursos]]
* [[Necesidades]]
{{div end}}

== Glosario ==
* [[Términos usados habitualmente]]
* [[Guia Rápida de Guifi.net]]
* [[Preguntas Frecuentes]]
* [http://guifi.net/es/ESDocs Documentos basados en la web de guifi.net] antigua "ComEsFa"
|}
|}

= Accesos Rápidos =
* [http://planet.guifi.net Planet]
* [http://guifi.net/es/ProcomunXOLN Procomún XOLN (Licencia de la red)]
* [http://guifi.net/es/maps Mapa guifi]
* [http://guifi.net/es/grups Webs Regionales]
* [http://trac.guifi.net Reporta Errores de la web]
* [http://fundacio.guifi.net Fundación]
* [http://lists.guifi.net Listas de Correo]

[[ca:Portada]]
[[en:Main Page]]
[[eu:Azala]]
[[fr:Accueil]]
[[gl:Portada]]

2012-10-23T19:01:16Z

Piura: /* Prueba de servicio */

==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.

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

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

* [[Configurar_Repositorio_apt_guifi|Configurar el Repositorio de apt de Guifi]]

Una vez configurado el repositorio, descargamos servicio.

<pre># apt-get install snpservices</pre>

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

<pre> Alias /snpservices /var/www/html/snpservices </pre>

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

<pre>mkdir /tmp
chmod a+rw snpservices/tmp
</pre>

.Crea els ervicio en al base de datos usando esta direccion
<pre> http://yourserver/snpservices</pre>

te saldra una pagina asi
<pre>
ERROR: No service specified
CNML services
Version: 2.0
USAGE:
index.php?call=[service][&parameter[=value]]

services: help version phpinfo serverinfo [service]
help
...sigue...
</pre>

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.
<pre>
<?php

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

Este es el numero de nodo que nos ha dado el servidor web al crear el servicio SNP Cliente.
<pre>
// SNPGraphServerID: Default Graph Server ID
$SNPGraphServerId = 6579;

</pre>

Servicio root. El root de nuestro servidor guifi actual es el 3671
<pre>
// rootZone: which is the ROOT zone
$rootZone = 3671;

</pre>

Aqui la direccion desde donde se enlaza a los servicios mediante web. Esta variable es usada en varios archivos de configuracion
<pre>
// SNPDataServer_url: without ending backslash, the url where the data is
$SNPDataServer_url = 'http://guifi.net';

</pre>

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

// MRTGConfigSource: mrtg csv data
// As a input, could be either a local (to be created from
// 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';
</pre>
Aqui almacenamos los datos mrtg que recojamos. La carpeta data no esta creada por defecto. La tenemos que crear mediante mkdir data desde el directorio snpservice
<pre>
//$MRTGConfigSource='../data/guifi_mrtg.csv';

</pre>
Configuracino para la creacion de archivo CNML
<pre>

// 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)
</pre>
Aqui almacenamos los datos CNML que recojamos
<pre>

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

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

// 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";

</pre>
Configuracion de entorno MRTG. No hace falta hacer nada aqui
<pre>

// 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>
';

?>
</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 refresh.sh y este nos envia a refresh.cnml.php
refress.sh llama a dos archivos php.

<pre>
root@webserver:/var/www/guifi/snpservices/common# cat refresh.sh
#!/bin/bash
# Refreshing CNML local file (optional)
php refresh_cnml.php
</pre>

=== Configurar refresh.cnml.php ===
Veamos ahora el archivo de configuracion refresh.cnml.php

Si queremos ejecutar este archivo lo hacemos mediante la llamada a php
Aqui vemos que error genera y podremos ir a ver donde esta ocurriendo.

Este es el archivo. Primero carga una configuración común en el archivo config.php. Sino busca la plantilla config.php.template
<pre>
<?php

if (file_exists("config.php")) {
include_once("./config.php");
} else {
include_once("config.php.template");
}

$minX = 999;
$minY = 999;
$maxX = -999;
$maxY = -999;

$members = array();

</pre>
Intenta abrir archivo ya creado. Tenemos que modificar la ruta donde almacena esta informacion. Compara la fecha de actualización anterior y la actual para decidir si hacer un refresco completo o no.
si todo esta actualizado, ejecuta exit() y acaba.

<pre>

$hlastnow = @fopen($SNPDataServer_url."/guifi/refresh/cnml", "r")
or die('Error reading last timestamp\n');
$last_now = fgets($hlastnow);
fclose($hlastnow);

$hlast= @fopen("/tmp/last_update.cnml", "r");
if (($hlast) and ($last_now == fgets($hlast))) {
fclose($hlast);
echo "No changes.\n";
exit();

</pre>

Si está mal configurado estos parámetros, tendremos el siguiente error
<pre>
root@webserver:/var/www/guifi/snpservices/common# php refresh_cnml.php
Getting CNML file
Error reading last timestamp
root@webserver:/var/www/guifi/snpservices/common#
</pre>

Aqui es cuando empieza la búsqueda de cambios.
El primer open abre un archivo de la web con los contenidos. estos son comparados con el archivo que tenemos en /tmp. Si son diferentes, realiza una descarga y lo actualiza.
<pre>

echo "Getting CNML file\n";
$hcnml = @fopen($SNPDataServer_url."/guifi/cnml/".$rootZone."/detail", "r")
or die ('Error redaing CNML source\n');
$wcnml = @fopen("../data/guifi.cnml.tmp", "w");
while (!feof($hcnml)) {
$buffer = fgets($hcnml, 4096);
fwrite($wcnml,$buffer);
}
fclose($hcnml);
fclose($wcnml);
exec ("/bin/cp ../data/guifi.cnml.tmp ../data/guifi.cnml");

$hlast= @fopen("/tmp/last_update.cnml", "w") or die('Error!');
fwrite($hlast,$last_now);
fclose($hlast);
?>

}

</pre>

Si esta mal configurado, recibiremos este error
<pre>
root@webserver:/var/www/guifi/snpservices/common# php refresh_cnml.php
Getting CNML file
Error redaing CNML source\n
root@webserver:/var/www/guifi/snpservices/common#
</pre>
El sistema dentro de la web que crea el archivo CNML es un proceso de un modulo de Drupal del sistema guifi
Lo encontraras aqui

<pre>
/sites/all/modules/guifi/guifi_cnml.inc.php
</pre>

Ahora tenemos dentro de /data dos archivos iguales llamados guifi.cnml i guifi.cnml.tmp con os contenidos encontrados.
También actualiza datos en /tmp/last_update.cnml que se usara nuevamente en la próxima actualizacion

=== Prueba de servicio ===

Un cliente con servici SNPService usara el servicio SNPService Master recien creado para preguntar informacion acerca un nodo de esta manera
http://www.guifi.net/snpservices/graphs/cnml2mrtgcsv.php?server=6558

Esto nos devuelve un archivo CNML como este
<pre>
46491,#VicPuigsacalm2Rd1,10.138.48.51,wlan1;VicVcPgsclm2Rd1CPE0,Planned
38297,#VicCnvntCrmltsRd1,10.138.160.39,ath0;Vic-1-NOVcCnvntCrmltsRd1CPE0,Working
45489,#Vic11Set38Rd1,10.138.168.170,wlan1;Vic-1-NOVc11St38Rd1CPE0,Planned
44406,#Vic11set40Rd2,10.138.101.4,ath0;Vic-1-NO11st40Rd2CPE0,Working
33929,#Vic11setembre25Rd1,10.138.22.87,wifi0;Vic-1-NOVc11stmbr25Rd1CPE0,Working
18809,#VicAGrifollRd2,10.138.14.104,6,Working
40356,#VicAlbergCanongeRd2,10.138.10.80,Lan/Lan;Vic-1-NOVclbrgCnngRd2CPE0,Working
22068,#VicAlemanyRd1,10.138.14.135,wifi0;Vic-1 NOVclmnyRd1CPE0,Working
30303,#VicAlemanyRd2,10.138.14.201,wifi0;Vic-1 NOVclmnyRd2CPE0,Planned
36620,#VicAlinaRd2,10.138.10.72,wlan1;Vic-1-NOVclnRd2CPE0,Working
7211,#VicAngladaRd1,10.138.10.73,Lan/Lan;VicAngladaRadio1-0,Working
19857,#VicAnnaBRd2,10.138.11.62,wifi0;VicVcnnBRd2CPE0,Working
14203,#VicAnnaMaxenchsRd1,10.138.22.41,wifi0;VicVcnnMxnchsRd1CPE0,Working
13655,#VicAnnaPratRd1,10.138.11.51,;VicVcnnPrtRd2CPE0,Working
17035,#VicAnnaSolerRd3,10.138.22.196,6,Working
</pre>

La configuracion puede que no funcione. Para ver errores, pedir a apache que nos mustre su log
<pre>
root@webserver:~# tail -f /var/log/apache2/*.log
</pre>

Yo me he encotnrado este error
<pre>
[Mon Oct 22 23:27:07 2012] [error] [client 192.168.1.40] PHP Warning: DOMDocument::load():
Premature end of data in tag html line 3 in /var/www/drupal-6.26/snpservices/data/guifi.cnml, line: 149 in /var/www/drupal-6.26/snpservices/graphs/cnml2mrtgcsv.php on line 270

</pre>

Tambien este. Parece que al intentar cargar la zona, da un error Apache a causa de falta de memoria al cargar todos los datos en una variable
Para solucioanrlo se tiene que modificar el limite d ememoria para php dentro de /etc/php5/apache/php.ini
La variable se llama
memory_limit = 128M
Parece que si lo pones a -1 equivale a que no tenga limite.
http://es1.php.net/manual/es/ini.core.php#ini.memory-limit

<pre>
==> /var/log/apache2/error.log <==
[Tue Oct 23 20:54:16 2012] [error] [client 192.168.1.44] PHP Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 20 bytes) in /var/www/drupal-6.26/includes/database.mysqli.inc on line 150
</pre>

=== 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

[[Categoría:SNPServices]]