Agenda: ejercicios-mrtg-rrdtool.txt

MRTG y RRDTool
================

Notas:
------
------
* Comandos precedidos con "$" implican que Ud. debe ejecutar el comando como un usuario general no como root.
* Comandos precedidos con "#" implican que Ud. debe ejecutar el comando como root 
* Comandos con lineas de comando mas especificas (ej. "GW-RTR>" o "mysql>") implican que Ud. 
   esta ejecutando el comando en un dispositivo remoto, o dentro de otro programa
* Si un comando termina con "\" indica que el comando continua en la linea siguiente, y 
  que Ud. debe considerar las dos lineas como una sola secuencia


Ejercicio Parte I
================

0. Loin a su servidor como el usuario sysadm. 

1. Instale MRTG
---------------

Instalaremos MRTG y grficaremos entrada/salida de las interfaces de red de los enrutadores de nuestra clase
Esto es, cuanto trafico fluye a traves de cada enrutador

        $ sudo apt-get install mrtg
        
cuando pregunte si el fichero debe pertenecer al usuario root y solo legible para el, responda "<No>", 
pues necesita ser legible para RRDTool mas tarde. 



2. Cree el directorio /etc/mrtg 
---------------------------------

        $ sudo mkdir /etc/mrtg


3. Recuerde SNMP RO Community string: "NetManage"
--------------------------------------------------

Necesitara esta informacion despues

4. Halle la IP y Nombre del Dispositivo
----------------------------------------


        name:   rtr<X>.ws.nsrc.org
        IP:     10.10.X.254
        
Ejemplo para grupo 3 la informacion debe ser:

        nombre: rtr3.ws.nsrc.org
        IP:     10.10.3.254
        
(Necesita esta informacion en paso 5 


5. Corra cfgmaker 
------------------


        $ sudo bash
        
Ahora es root 
        
        # mkdir -p /var/www/mrtg

        # /usr/bin/cfgmaker --output=/etc/mrtg/device.mrtg --global 'workdir: /var/www/mrtg' --global \
          'options[_]: growright,bits' NetManage@10.10.X.254


Vea el fichero de configuracion creado por cfgmaker


6. Use indexmaker para crear ficheros HTML 
------------------------------------------

        # /usr/bin/indexmaker --output=/var/www/mrtg/device.html /etc/mrtg/device.mrtg


7. Ejecute comando MRTG command 
-------------------------------

Este comando debe ser ejecutado 3 veces (en serio, 3 veces!)

        # LANG=C /usr/bin/mrtg /etc/mrtg/device.mrtg


NOTA: Si Ubuntu/Debian se queja sobre LANG. Si es asi, ejecute el comando de esta forma:

        # "LANG=C /usr/bin/mrtg /etc/mrtg/device.mrtg"


8. Ponga el comando en un fichero de ejecucion (script)
---------------------------------------------------------

        # echo 'LANG=C /usr/bin/mrtg /etc/mrtg/device.mrtg' >/etc/mrtg/mrtgscript
        
Haga el script ejecutable:

        # chmod +x /etc/mrtg/mrtgscript


9. Edite el crontab e inserte el comando, de forma tal que se  ejecute cada 5 minutos
-------------------------------------------------------------------------------------

        # crontab -e


adicione:

        0-59/5 * * * * /etc/mrtg/mrtgscript

Salve el fichero y salga del editor



10. Visualizacion 
-----------------

Vea los resultados de la ejecucion del comando (que se esta' ejecutando a intervalos
regulares en su servidor (pc1 a pc26):

     http://pcX.ws.nsrc.org/mrtg/device.html

NOTA: 
No vera' resultados por un buen rato.
Puede ser hasta 10 minutos, pues toma varias corridas para que la
visualizacion en la barra X (tiempo) tenga sentido.




RRDTool
--------

1. Instalar paquetes necesarios
-------------------------------

        # apt-get install rrdtool
        # apt-get install librrdp-perl
        # apt-get install librrds-perl

O, puede hacerse asu tambien:

        # apt-get install rrdtool librrdp-perl librrds-perl

Puede tomar algun tiempo.



2. Adicione su fichero de configuracion MRTG
---------------------------------------------

        # vi /etc/mrtg/device.mrtg


Busque la siguiente cadena hacia el principio del fichero:

        
        WorkDir: /var/www/mrtg

Adicione una linea justo debajo de "WorkDir" asi:

        LogFormat: rrdtool

Salve y salga del editor

Fuerze la creacion de los ficheros de rrd en /var/www/mrtg:

        # /etc/mrtg/mrtgscript
        
Vea el contenido de /var/www/mrtg.
Vera' que hay ahora fcheros .rrd si todo se hizo adecuadamente

        # ls /var/www/mrtg


Y como preparamos los graficos?


3. Instalar mrtg-rrd
-------------------

        # apt-get install mrtg-rrd
        # cd /usr/lib/cgi-bin
        # ln -s mrtg-rrd.cgi 14all.cgi


4. Corra indexmaker otra vez
-----------------------------

        # /usr/bin/indexmaker --output=/var/www/mrtg/device.html /etc/mrtg/device.mrtg


5. Crear /etc/mrtg-rrd.conf
----------------------------

        # echo '/etc/mrtg/device.mrtg' >/etc/mrtg-rrd.conf


4. De permisos de escritura en el subdirectorio de graficos
-----------------------------------------------------------

Ahora de permisos de escritura en el subdirectorio donde iran los graficos.
El subdirectorio es  /var/www/mrtg 
El usuatio que corre el web-server es www-data

        # chown www-data /var/www/mrtg


5. Remover los viejos ficheros PNG de los graficos de MRTG 
------------------------------------------------------------

        # rm /var/www/mrtg/10.10*.png


6. Visualize otra vez! (http://pcX.ws.nsrc.org/mrtg/device.html) 
----------------------------------------------------------------------

Ahora los graficos son diferentes, pero contienen la misma informacion.
Lo importante es que los graficos se generan dinamicamente usando la base de datos RRD
en lugar de ser almacenados como ficheros PNG cada 5 minutos.


NOTA:

Aunque es tedioso, se pueden cambiar algunas elementos de visualizacion 
en los ficheros de configuracion:
        /etc/mrtg/device.mrtg
        /var/www/mrtg/device.html
        
etc.