*--------------------------------------
* Archivo:  uso-leeme.txt
* Objetivo: Explicar cmo usar "uso"
* Autor:    Pedro Reina
* Fecha:    S.10.11.2007
* Versin:  1.0
*--------------------------------------


Objetivo de estos archivos
--------------------------

Instalar en un servidor, preferiblemente libre, un
sistema que permita monitorizar va web algunos
parmetros del servidor


Requisitos del servidor
-----------------------

Para que funcione correctamente el contenido de estos
archivos es necesario que el servidor ya cuente con
algunos programas:

* El programa "cron" o algo similar, para que arranque
  automticamente uso.pl cada cinco minutos.

* Perl para lanzar el programa uso.pl, imprescindible para
  recopilar los datos necesarios e ingresarlos en las bases
  de datos.

* El programa rrdtool para almacenar las bases de datos
  "round robin" y generar los grficos. Es la pieza clave
  de todo.

* Servidor web con soporte PHP para consultar los archivos
  php. Si se retocan las pginas, se podra no tener soporte
  PHP, ya que no es esencial.

* El servidor de bases de datos SQLite; es opcional, se usa
  para almacenar todos los datos obtenidos y as disponer
  de un histrico completo. Si no se dispone de l, basta
  borrar las lneas en las que se usa.


Instalacin del sistema
-----------------------

El sistema ha sido creado sobre un sistema oprativo Debian
Etch y puede requerir modificaciones para funcionar sobre
otros sistemas.

* Se crea en el directorio principal del servidor web un
  directorio para contener los archivos.

* Se copian a ese directorio los archivos que aparecen
  al descomprimir el archivo uso-1.0.zip

* Se crean las bases de datos round robin usando el archivo
  ejecutable crea-rrd.sh con la orden
  ./crea-rrd.sh

* (Opcional) Se crea la base de datos SQLite con la orden
  sqlite3 uso.db ".read uso.sql"

* Se retoca al gusto las constantes del archivo uso.pl

* Se editan al gusto los archivos php, que estn pensados
  para ejecutarse en mi sistema y probablemente den sencillos
  errores en el tuyo.

* Se copia al directorio de cron el archivo uso.cron, quiz
  cambindole el nombre a cron. En mi sistema:
  cp uso.cron /etc/cron.d/uso
  Si es necesario, se edita el archivo para que apunte al
  directorio donde est el programa uso.pl

* Para que se creen todos los archivos png es necesario esperar
  hasta las 00:00 horas del da siguiente a la instalacin,
  pero los primeros png se crean en el primer minuto que sea
  cero o mltiplo de cinco.

* Los archivos uso.sql, uso-leeme.txt y crea-rrd.sh ya no son
  necesarios, los puedes borrar del directorio de trabajo.
