Proyecto Forrest
Liga de Simulación 2D
RoboCup
Instructivo de Instalación
Forrest Log Analyser Consultancy System
Versión 1.0
Histórico de Revisiones
Versión Fecha Resumen de cambios Autor
1.0 01-06-2006 Versión inicial Grupo Forrest
Facultad de Ingeniería - Universidad de la República Montevideo - Uruguay
Componentes del paquete de instalación
j2sdk-1_4_2_12-linux-i586.bin (kit de desarrollo para java)
jakarta-tomcat-5.0.19 (servidor web)
postgresql-8.1.4.tar.gz (fuentes y librerias de postgresql) ForrestLogAnalyser4.2.tgz (aplicación de carga)
Base.dump (respaldo de la base de datos)
FLACS.tgz (aplicación OLAP para consultas a la base)
Nota: Los dos primeros paquetes se asume que deben estar instalados en el sistema y por lo tanto esta
guia no contiene los pasos para instalarlos.
Manual de instalación
La instalacion de todos los productos que componen el sistema implica:
1. Instalación de Postgresql
2. Crear la base de datos
3. Instalación del proceso de carga de la base de datos y el cubo
4. Instalación del sistema de consultas OLAP - FLACS
Detalle de cada paso:
1. Instalación e inicialización de la servidor Postgresql
a) Descomprimir el archivo fuente: tar xzvf postgresql-8.1.4.tar.gz Esto crea un directorio de nombre postgresql-8.1.4.
b) Posicionarse en este directorio. c) Ejecutar: ./configure
En este paso puede reclamar el paquete "readline" y el "bison", estos se instalan con el yast; en la distribución de Suse viene para instalar. Si no lo tienen no importa, esto es accesorio para poder usar el tabulador dentro de postgres y que te complete la sentencia. En caso de no tenerlo seguir las instrucciones que te da el configure.
d) Ejecutar: gmake
Si en el sistema no se encuentra instalado el gmake, ejecutar make. e) Loguearse como root
f ) Ejecutar la instalación de las binarios: gmake install
mkdir /usr/local/pgsql/data useradd postgres
g) Inicializacion del manejador de base de datos su postgres
/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data
Descripcion de flags: -D indica que "dir" sera el directorio almacen de datos.
2. Crear la base de datos
a) Levantar el servidor de base de datos: /usr/local/pgsql/bin/postmaster -D /usr/local/pgsql/data & b) Crear el super usuario “admin” para la base de datos: /usr/local/pgsql/bin/createuser admin c) Crear la base de datos "ForrestLogAnalyser": /usr/local/pgsql/bin/createdb ForrestLogAnalyser d) Levantar el respaldo inicial de la base: /usr/local/pgsql/bin/psql -d ForrestLogAnalyser -U
admin -f <rutaArchivodeBaseRespaldo>/Base.dump
Descripcion de flags: -d: indica la base de datos a la cual conectar; -U: indica el usuario con el cual me quiero conectar a la base; -h: indica el host donde esta la base de datos (por defecto -sino se especifica nada- es localhost); -f: indica un archivo con comandos a ejecutar (un script) Sino le pongo -f entro a trabajar a la base por linea de comandos (consultas sql, etc.).
3. Instalacion del proceso de carga de la base de datos y el cubo:
a) Descomprimir en un directorio cualquiera el archivo ForrestLogAnalyserVxx.tgz: tar xzvf <archivo>
Esto crea un directorio con el nombre ForrestLogAnalyserVxx. Dentro del mismo se tienen los siguientes directorios:
lib: se encuentran los jars de jdbc de postgres, xdom para el manejo de xml en la app, y log4j.
cfg: se encuentran dos archivos, uno es ForrestLogAnalyser.xml que tiene la configura-cion de la app y el otro es log4j.properties que contiene la configuración del loguer. bin: se encuentra el jar de la app
log: Este es un directorio auxiliar. Existe para que, en caso de desearlo, se vuelquen los logs de ejecucion de la app de carga. Si así se desea es necesario indicarlo en el archivo log4j.properties ubicado en el directorio cfg de esta aplicacion. La sentencia para hacerlo es "log4j.appender.A2.File=DIR" donde "DIR" debe sustituirse por la direccion absoluta de este directorio "log". Y también genera un el script de ejecucion del proceso de carga start.sh
b) Configurar entorno
Para que esten disponibles los jar de postgres y demás para la app, se deben copiar los jar que se encuentran en el directorio lib al directorio $JAVA_HOME/jre/lib/ext
c) JAVA_HOME debe estar seteada en el directorio raiz donde se encuentra la jsdk de java (Ej: /usr/lib/j2sdk1.4.2_12/)
4. Instalacion del sistema de consultas OLAP - FLACS (Forrest Log Analyser Consultancy System)
a) Descomprimir el archivo de la aplicación: tar xzvf FLACS.tgz
Debe ser en el mismo directorio donde se encuentra el servidor de servlets, en el caso de Tomcat es $CATALINA_HOME/webapps. CATALINA_HOME tiene que estar apuntando al directorio raiz del Tomcat.
Esto crea un directorio con el nombre "FLACS" conteniendo la app. Verificar que el string de conexión que se encuentra en el archivo FLACS/WEBINF/queries/reqCubos.jsp se corre-sponda con el nombre de la base de datos y la IP de la maquina donde se encuentra el servidor de base de datos. Si la misma se encuentra en el mismo equipo del servidor web debiera decir localhost, de lo contrario corregirlo.
Manual de ejecución
PRE-CONDICION: Antes de que se ejecuten los siguientes pasos deben haberse generado los archivos
de logs generados por el scripts de ejecucion automatica de las pruebas, los cuales deben encontrarse en dirlogs.
logs del servidor soccerserver logs de cada jugador de Forrest
indicadores.kpi
NOTA: En caso de que no se cuente con alguno de estos tipos de archivo, la aplicacion muestra un msg
pero no aborta.
Pasos a segir:
1. Levantar el servidor de base de datos
loguearse como root loguearse como postgres
Levantar el servidor de BD: /usr/local/pgsql/bin/postmaster -D /usr/local/pgsql/data &
2. Ejecutar el proceso de carga: start.sh <dirlogs>locatario visitante Especificacion de parametros:
dirlogs: nombre del directorio en donde se encuentran los logs a cargar locatario: nombre del equipo locatario
visitante: nombre del equipo visitante
Tener en cuenta que este proceso realiza los siguientes pasos: carga los datos de cada archivo con extención .log que se encuentren en el directorio recibido por parametro, carga los datos de cada archivo con extención .kpi que se encuentren en el directorio recibido por parametro.Por último, realiza la carga de la estructura del cubo utilizado posteriormente por FLACS. Para realizar el proceso de carga se debe estar parado en el directorio raiz del script start.h
3. Ejecutar el sistema de consultas:
Levantar el servidor web En caso de estar utilizando Tomcat ejecutar: $CATALINA_HOME /bin/startup.sh
Ejecutar en un browser la pagina de inicio http://localhost:8080/FLACS
Comandos básicos de postgres
Crear la base de datos: /usr/local/pgsql/bin/createdb ForrestLogAnalyser
Borrar la base de datos: /usr/local/pgsql/bin/dropdb ForrestLogAnalyser
Entrar a trabajar a la base por linea de comandos: /usr/local/pgsql/bin/psql -d ForrestLogAnalyser -U admin
Subir el servidor de base de datos: /usr/local/pgsql/bin/postmaster -D /usr/local/pgsql/data Bajar el servidor de la base de datos: /usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data/ stop
Dentro de la consola del postgres:
• \d: para ver el catalogo de la base de datos de la base a la que estoy logueado. • \q: para salir