Instalacin Pentaho biserver 3.

8 en Linux y base PostgreSQL

Consorcio - SIU Fecha actualizacin: 11/05/2012

Importante: Hay una nueva gua de instalacin en la Wiki

http://repositorio.siu.edu.ar/trac/dw_pentaho/wiki/WikiStart

Contenido
Introduccin Requerimientos mnimos de Hardware y Software Instalacin del BI Server Listado de tareas involucradas Instalar el biserver de Pentaho Modificar la memoria RAM asignada a la JVM Cambiar puerto y url Modificar el tiempo de timeout de la sesin de la Consola de Usuario Modificar la pantalla de Login de la consola de Usuario Configuracin de confianza en la Consola de Administracin Arranque automtico del servidor Pentaho y la Consola de Administracin Biserver Consola de administracin Configuracin de Pentaho en PostgreSQL Extraer el paquete de Scripts SQL PostgreSQL 8.x.x Script Pack Cargar los scripts SQL Configurando la seguridad JDBC applicationContext-spring-security-jdbc.xml applicationContext-spring-security-hibernate.properties hibernate-settings.xml postgresql.hibernate.cfg.xml Configurando Hibernate and Quartz context.xml quartz.properties pentaho.xml Configurando Apache-Tomcat Server solution-path fully-qualified-server-url Deshabilitar el arranque de la base HSQL TrustedIpAddrs Configurando SMTP (mail server) SIU - Datawarehouse

Configurando Publicacin (Publishing) Configurando la Consola de Administracin Iniciando el servidor de Pentaho Iniciando la Consola de Administracin Configuracin de la conexin JNDI Monitorear la actividad del Apache-Tomcat en Pentaho CE Instalacin de las soluciones SIU en Pentaho Carga de datos en la base del datawarehouse (siu_dw)

Introduccin
Este documento tiene como objetivo guiar al usuario en la instalacin y configuracin de un servidor de Pentaho, en especial el biserver 3.8, en la ditribucin Ubuntu de Linux. Adems, se detallan los pasos para instalar el repositorio en base de datos PostgreSQL y la puesta en funcionamiento de las soluciones SIU.

Requerimientos mnimos de Hardware y Software

Para realizar una instalacin bsica recomendamos contar con al menos lo siguiente: Software: S.O: Ubuntu o Debian (Probados por el SIU) B.D: PostgreSQL 8.1 o superior. (La versin 9.1 an no se prob) Java: JRE versin 1.6.0 o superior Hardware (Mnimo): Procesador: Dual Core RAM: 2 o 3 GB HD: 100 GB

Instalacin del BI Server

Listado de tareas involucradas
1- Instalar el biserver de Pentaho. 2- Configurar los puertos de escucha del biserver. Hablar con los encargados de IT/Redes para que habiliten los puertos de acceso al servidor desde Internet. 3- Configurar un usuario en el servidor de Pentaho (por ej: pentaho) y dar permiso a todos los archivos de pentaho a ese usuario /usr/local/pentaho. Esto es para seguridad y que no se ejecute como root. 4- Configurar el arranque automtico del servidor Pentaho y la Consola de Administracin. 5-Modificar el tiempo de timeout de la session de la Consola de Usuario. Por defecto tiene seteado 30 minutos. 6- Instalar la base de datos en PostgreSQL. Hablar con los encargados IT para que creen las bases necesarias y los usuarios y en caso de ser necesario para que habiliten los puertos para acceder desde el servidor de Pentaho a la base PostgreSQL. 7- Instalar las soluciones SIU en el servidor de Pentaho. 8- Cargar los datos de la solucin de Pentaho en la base de datos. SIU - Datawarehouse

9- Configurar el biserver para que utilice la base de datos Postgres y no la que viene por defecto (hypersonic). 10- Desactivar la base Hypersonic. 11- Configurar los usuarios y roles que tienen acceso al servidor de Pentaho. Eliminar los usuarios que vienen por defecto. IMPORTANTE: Tener en cuenta los siguientes puntos de configuracin de seguridad: http://wiki.pentaho.com/display/ServerDoc2x/Security+Configuration+Checklist IMPORTANTE: Se presupone que los archivos y directorios de la instalacin de pentaho (/usr/local/pentaho/ hacia adentro), tienen como propietario a un usuario de linux llamado pentaho. Hay que crearlo si es necesario, y no cambiar al propietario al editar los archivos.

Instalar el biserver de Pentaho

En esta oportunidad se instalar el biserver 3.8 de Pentaho. Para esto se deben seguir los siguientes pasos: 1-Descargar del sitio Sourceforge.com el biserver de Pentaho mediante el link http://sourceforge.net/projects/pentaho/files/Business%20Intelligence%20Server/3.8.0-stable/ biserver-ce-3.8.0-stable.tar.gz o desde la consola con wget http://sourceforge.net/projects/pentaho/files/Business%20Intelligence%20Server/3.8.0-stable/ biserver-ce-3.8.0-stable.tar.gz/download 2-Descomprimir el archivo descargado en alguna carpeta del SO (por ejemplo /usr/local/pentaho): Para descomprimir el archivo y moverlo al directorio /usr/local/pentaho utiizar los siguientes comandos remarcados en negrita en el prompt de la terminal. mpierri@minerva-2k9:~/pentaho$ sudo tar xvzf biserver-ce-3.8.0-stable.tar.gz mpierri@minerva-2k9:~/pentaho$ sudo mv ./administration-console/ /usr/local/pentaho/ mpierri@minerva-2k9:~/pentaho$ sudo mv ./biserver-ce /usr/local/pentaho/ Los siguientes directorios debern verse al descomprimir el archivo: /usr /local/ |-- pentaho | |-- adminstration-console | |-- biserver-ce

3- Antes de poder iniciar el servidor de Pentaho hay que verificar que la JVM (Java Virtual Machine) est intalada y que el JAVA_HOME est configurado correctamente. Para verificar que la JVM est instalada ejecutar desde la consola el comando java -version. Si la JVM est instalada y el PATH de Java es correcto aparecer algo como lo siguiente:

SIU - Datawarehouse

java version "1.6.0_20" Java(TM) SE Runtime Environment (build 1.6.0_20-b02) Java HotSpot(TM) 64-Bit Server VM (build 16.3-b01, mixed mode) En caso que la JVM no est instalada se puede instalar mediante apt-get desde la consola: sudo apt-get install sun-java6-jre 4- Configurar las variables de entorno de JAVA: Las variables de entorno de java se pueden setear agregando una lnea en el archivo /etc/environment. Se necesita tener privilegios de root para poder editar el archivo. En una terminal ingresar el comando sudo gedit /etc/environment. Agregar las siguientes lneas al archivo: export JAVA_HOME=/usr/lib/jvm/java-6-sun export PATH=$PATH:$JAVA_HOME/bin JAVA_HOME=/usr/lib/jvm/java-6-sun (modificar la ruta de acuerdo a la configuracin de la mquina). Guargar el archivo y cerrar el editor. Para chequear si la variable est seteada correctamente se utiliza el comando echo $JAVA_HOME, pero todava no retornar nada. Para activar la variable en la sesin actual, se usa el comando source /etc/environment, pero para activar la variable para todas las sesiones, hay que desloguearse y volver a loguearse nuevamente (no es necesario reiniciar el sistema). Info obtenida del libro (pag.27 y 28 - Pentaho Solutions - Roland Bauman)

Modificar la memoria RAM asignada a la JVM

Para incrementar la cantidad de memoria asignada a la JVM del biserver hay que editart el archivo start-pentaho.sh ubicado en <path pentaho>/biserver-ce y modificar el valor del parmetro -Xmx como se muestra en el ejemplo siguiente: export CATALINA_OPTS="-Xms256m -Xmx2048m -XX:MaxPermSize=256m -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000"

Cambiar puerto y url

Por defecto, el biserver viene configurado para escuchar en el puerto 8080 y en la url http://localhost:8080. En caso que quiera o deba modificar estos valores se deben realizar los siguientes cambios: Cambiar la configuracin de puertos Acceder al archivo: /usr/local/pentaho/biserver-ce/tomcat/conf/server.xml y buscar las siguientes lneas: <-- A "Connector" represents an endpoint by which requests are received and responses are returned. Documentation at : Java HTTP Connector: /docs/config/http.html (blocking & non-blocking) Java AJP Connector: /docs/config/ajp.html APR (HTTP/AJP) Connector: /docs/apr.html Define a non-SSL HTTP/1.1 Connector on port 8080 <Connector URIEncoding="UTF-8" port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" /> SIU - Datawarehouse

Como se ve el puerto est en el 8080. Cambiarlo a gusto, en este caso pondremos 8081. Una vez guardada la nueva configuracin (ojo! es recomendable guardar la configuracin anterior, por las dudas) y reiniciado el servidor, se podr acceder con el nuevo puerto, por ejemplo: http://localhost:8081/pentaho Cambiar la URL del servidor Puede darse el caso de que quieras ponerle un nombre a la direccin y no estar con el "localhost" siempre. Para eso, editar el archivo /usr/local/pentaho/biserver-ce/tomcat/webapps/pentaho/WEB-INF/web.xml y buscar las siguientes lneas: <!-- FullyQualifiedServerUrl is used only in the case of offline content generation and whenever something need to talk back to the server --> <context-param> <param-name>fully-qualified-server-url</param-name> <param-value>http://localhost/pentaho/</param-value> </context-param> Y donde aparece http://localhost/pentaho/, sustituir "localhost" por la IP:Puerto o la direccin deseada del servidor. Para que los cambios tomen efecto hay que reiniciar el servidor.

Modificar el tiempo de timeout de la sesin de la Consola de Usuario

Por defecto, la Consola de Usuario de Pentaho viene configurada con un tiempo de timeout para la sesin de 30 minutos. Modificar el archivo "web.xml" en $BISERVER/tomcat/webapps/pentaho/WEB-INF Buscar la configuracin: <!-- insert additional servlet mappings --> <session-config> <session-timeout>30</session-timeout> </session-config> El nmero es el tiempo de sesin en minutos. Modificar y reiniciar el BI-Server.

Modificar la pantalla de Login de la consola de Usuario

Si se quiere modificar la pantalla de Login que viene por defecto en la instalacin bsica de Pentaho para que no aparezca el combo desde el cual se seleccionan los usuarios seguir los pasos planteados por Prashant Raju en el siguiente link: http://www.prashantraju.com/2010/02/customising-the-pentaho-user-console-part-1/

SIU - Datawarehouse

Configuracin de confianza en la Consola de Administracin

Para poder acceder a la consola de administracin, que se ejecuta desde la carpeta <PATH biserver-ce>/administration-console (./start-pac.sh) y corre por defecto en el puerto 8099, desde fuera del servidor hay que configurar una conexin de confianza entre la Consola de Administracin y el Biserver. De manera predeterminada, el Biserver confiar en PAC (Pentaho Admin Console) si se accede dese localhost o 127.0.0.1. Confiar significa que toda solicitud de un conjunto de direcciones IP se asume previamente autenticadas. Previamente autenticada significa que el que realiza la peticin (ej. PAC) se hizo cargo de la autenticacin del usuario. PAC no envia la contrasea, todo lo que se comunica entre PAC y el Biserver es el nombre del usuario con el que se ejecuta. Por esto es necesario que el usuario con el que se accede a PAC exista en el Biserver. Como ejemplo, creamos el usuario dwpentaho que reemplazar al usuario Admin que viene por defecto: 1- Iniciar el Biserver. 2- Iniciar el PAC. 3- Desde la Consola de Administracin, crear un usuario (dwpentaho en el ejemplo). 4- Asignarle rol de administrador al usuario creado. 5- Parar PAC. 6- Parar el Biserver. 7- Editar biserver-ce/tomcat/webapps/pentaho/WEB-INF/web.xml. a. Buscar TrustedIpAddrs. b. El param-value inmediatemente inferior a TrustedIpAddrs es una lista separada por coma de las direcciones IP en las cuales se debe confiar. Agregar la direccin IP del host que est ejecutando PAC. 8- Editar administration-console/resource/config/console.xml. a. Buscar platform-username . b. Reemplazar el valor (por defecto es joe ) con el usuario de un administrador (en este caso es dwpentaho) con el cual el Biserver deber ejecutar todas las peticiones. 9- Iniciar el Biserver. 10- Iniciar PAC.
La informacin anterior fue tomada del siguiente link: http://wiki.pentaho.com/display/ServerDoc2x/Setting+up+trust+between+Administration+Console+and+BI+Ser ver

Arranque automtico del servidor Pentaho y la Consola de Administracin

Siguiendo la gua del libro Pentaho Solutions - pag. 40 a 42, configuramos los scripts necesarios para levantar y parar los servicios del BI Server y la Consola de administracin en Linux.

Biserver Hay que crear un script de inicio que inicie el servidor de Pentaho. En este caso, siguiedo la gua del libro se crea el archivo pentaho-biserver.sh que se encuentra en /etc/init.d. (Nota: hay que tener permisos de root, y hay que usar sudo para copiar o mover el script en esa

SIU - Datawarehouse

ubicacin.) ------------------------------------------------------------------------------------------------------------------------#!/bin/sh # go to the pentaho home cd /usr/local/pentaho/biserver-ce # set up command for pentaho user, set java environment cmd="sudo -u pentaho JAVA_HOME=/usr/lib/jvm/sun-java6 JAVA_OPTS=-Djava.awt.headless=true" case $1 in start) # run the original pentaho start script $cmd ./start-pentaho.sh >> pentaho-demo.log & ;; stop) # run the original pentaho stop script $cmd ./stop-pentaho.sh >> pentaho-demo.log & ;; restart) $0 stop $0 start ;; *) echo Usage: $0 {start|stop|restart } exit 1 esac exit 0 ------------------------------------------------------------------------------------------------------------------------Para usar el script: shell> cd /etc/init.d shell> sudo ./pentaho-biserver.sh Usage: ./pentaho-biserver.sh {start|stop|restart|status} shell> sudo ./pentaho-biserver.sh start shell> sudo ./pentaho-biserver.sh stop En las distribuciones Linux basadas en Debian, incluyendo Ubuntu, se puede utilizar la aplicacin update-rc.d, mediante la cual se setean los links simblicos, haciendo que el script se ejecute en el momento que el Servidor arranca, iniciando el servidor de Pentaho ( y parando el servidor de pentaho cuando se apaga o reinicia el servidor): shell> sudo update-rc.d pentaho-biserver.sh defaults update-rc.d: warning: /etc/init.d/pentaho-biserver.sh missing LSB style header Adding system startup for /etc/init.d/pentaho-biserver.sh ... /etc/rc0.d/K20pentaho-biserver.sh -> ../init.d/pentaho-biserver.sh SIU - Datawarehouse

/etc/rc1.d/K20pentaho-biserver.sh -> ../init.d/pentaho-biserver.sh /etc/rc6.d/K20pentaho-biserver.sh -> ../init.d/pentaho-biserver.sh /etc/rc2.d/S20pentaho-biserver.sh -> ../init.d/pentaho-biserver.sh /etc/rc3.d/S20pentaho-biserver.sh -> ../init.d/pentaho-biserver.sh /etc/rc4.d/S20pentaho-biserver.sh -> ../init.d/pentaho-biserver.sh /etc/rc5.d/S20pentaho-biserver.sh -> ../init.d/pentaho-biserver.sh Con la misma aplicacin update-rc.d se pueden eliminar un servicio existente, usando la lnea: shell> sudo update-rc.d -f pentaho-biserver.sh remove

Consola de administracin Siguiendo los mismos pasos anteriores se crea un script para iniciar y parar la Consola de Administracin de Pentaho y se agrega como servicio en el servidor Linux. El script genera se llama pentaho-adminConsole.sh y se encuentra en /etc/init.d/: pentaho-adminConsole.sh ----------------------------------------------------------------------------------------------------------------------#!/bin/sh # Script para iniciar autimaticamente la consola de administracion de Pentaho # MPIERRI 20110705 # ir a la carpeta de la consola de administracion cd /usr/local/pentaho/administration-console # configurar al entorno de JAVA cmd="sudo -u pentaho JAVA_HOME=/usr/lib/jvm/sun-java6 JAVA_OPTS=-Djava.awt.headless=true" case "$1" in start) # ejecutar el script original de inicio de la consola de administracion $cmd ./start-pac.sh >> pentaho-demo.log & ;; stop) # ejecutar el script original para detener la consola de administracion $cmd ./stop-pac.sh >> pentaho-demo.log & ;; restart) $0 stop $0 start ;; *) echo "Usage: $0 {start|stop|restart }" exit 1 esac exit 0 ----------------------------------------------------------------------------------------------------------------------shell> sudo update-rc.d pentaho-adminConsole.sh defaults 21 SIU - Datawarehouse

(El 21 indica el nmero de secuencia en que se va a ejecutar y se pone en 21 para que se ejecute luego del Biserver. Por defecto si no se especifica se le asigna 20) update-rc.d: warning: /etc/init.d/pentaho-adminConsole.sh missing LSB information update-rc.d: see <http://wiki.debian.org/LSBInitScripts> Adding system startup for /etc/init.d/pentaho-adminConsole.sh ... /etc/rc0.d/K20pentaho-adminConsole.sh -> ../init.d/pentaho-adminConsole.sh /etc/rc1.d/K20pentaho-adminConsole.sh -> ../init.d/pentaho-adminConsole.sh /etc/rc6.d/K20pentaho-adminConsole.sh -> ../init.d/pentaho-adminConsole.sh /etc/rc2.d/S20pentaho-adminConsole.sh -> ../init.d/pentaho-adminConsole.sh /etc/rc3.d/S20pentaho-adminConsole.sh -> ../init.d/pentaho-adminConsole.sh /etc/rc4.d/S20pentaho-adminConsole.sh -> ../init.d/pentaho-adminConsole.sh /etc/rc5.d/S20pentaho-adminConsole.sh -> ../init.d/pentaho-adminConsole.sh

Configuracin de Pentaho en PostgreSQL

La idea es configurar Pentaho para que la base del repositorio de de usuarios y permisos est en base de datos PostgresSQL y no siga utilizando la base Hypersonic que trae por defecto. Esto se recomienda para la instalacin de Pentaho en un entorno de produccin, mientras que en un entorno de desarrollo o testing se puede utilizar la configuracin que viene por defecto en Pentaho. Para esto hay que seguir los pasos indicados en la gua de Prashant Raju (http://goo.gl/Y3bWJ) que se describen abajo y tiene algunas modificaciones respecto a esa versin: Importante! Es necesario descargar el driver JDBC para PostgreSQL. Para esto ingresar al sitio PostgreSQL JDBC Driver downloads y descargar el driver de acuerdo a la versin de Java instalada. Despus de descargar el archivo p o s t g r e s q l 8 . x x x x . j d b c x . j a rmoverlo dentro del directorio / b i s e r v e r c e / t o m c a t / l i b / .

Extraer el paquete de Scripts SQL PostgreSQL 8.x.x Script Pack

Despus descargar el paquete de scripts Pentaho_3.6.0_PostgreSQL_SQL_Pack.zip de la siguiente url ( https://docs.google.com/file/d/0B9Jmocc0fj_EOTVjYWYyOGEtMGI3Ny00N2I5LTg1NmUtY2Iy MWE1ZmQwMTkw/edit ) hay que descomprimir los archivos en una carpeta temporal. Son 5 scripts SQL:
1 _ c r e a t e _ r e p o s i t o r y _ p o s t g r e s q l . s q l C r e al ab a s eH i b e r n a t e 2 _ c r e a t e _ q u a r t z _ p o s t g r e s q l . s q l C r e al ab a s eQ u a r t z 3 _ c r e a t e _ s a m p l e _ d a t a s o u r c e _ p o s t g r e s q l . s q l C a r g ae ld a t a s o u r c ed ee j e m p l oe nl ab a s eH i b e r n a t e 4 _ l o a d _ s a m p l e _ u s e r s _ p o s t g r e s q l . s q l C r e al o su s u a r i o syr o l e sd e m oe nl ab a s eH i b e r n a t e 5 _ s a m p l e _ d a t a _ p o s t g r e s q l . s q l C r e al ab a s ed ee j e m p l o

SIU - Datawarehouse

Los scripts deben ser corridos en el orden en que aparecen listados. Leer estos scripts usando la consola de PostgreSQL.

Cargar los scripts SQL

Antes de empezar asegurarse de dejar todos los scripts SQL en el directorio en el cual vas a loguearte dentro de la consola de PostgreSQL, en este ejemplo es / h o m e / p e n t a h o / t m p / . Ejecutar los comandos siguientes que se encuentran en negrita uno despus del otro:
r o o t @ t e r m i n a l : / o p t / p e n t a h o / #p s q lu s e r n a m e = p o s t g r e sf 1 _ c r e a t e _ r e p o s i t o r y _ p o s t g r e s q l . s q l P a s s w o r df o ru s e rp o s t g r e s : . . . o u t p u t P a s s w o r df o ru s e rh i b u s e r :[ i n g r e s a r" p a s s w o r d " ] r o o t @ t e r m i n a l : / o p t / p e n t a h o / #p s q lu s e r n a m e = p o s t g r e sf 2 _ c r e a t e _ q u a r t z _ p o s t g r e s q l . s q l P a s s w o r df o ru s e rp o s t g r e s : . . . o u t p u t P a s s w o r df o ru s e rp e n t a h o _ u s e r :[ i n g r e s a r" p a s s w o r d " ] r o o t @ t e r m i n a l : / o p t / p e n t a h o / #p s q lu s e r n a m e = p o s t g r e sf 3 _ c r e a t e _ s a m p l e _ d a t a s o u r c e _ p o s t g r e s q l . s q l P a s s w o r df o ru s e rp o s t g r e s : P a s s w o r df o ru s e rh i b u s e r :[ i n g r e s a r" p a s s w o r d " ] . . . o u t p u t r o o t @ t e r m i n a l : / o p t / p e n t a h o / #p s q lu s e r n a m e = p o s t g r e sf 4 _ l o a d _ s a m p l e _ u s e r s _ p o s t g r e s q l s q l P a s s w o r df o ru s e rp o s t g r e s : P a s s w o r df o ru s e rh i b u s e r :[ i n g r e s a r" p a s s w o r d " ] . . . o u t p u t r o o t @ t e r m i n a l : / o p t / p e n t a h o / #p s q lu s e r n a m e = p o s t g r e sf 5 _ s a m p l e _ d a t a _ p o s t g r e s q l . s q l P a s s w o r df o ru s e rp o s t g r e s : . . . o u t p u t

Ahora abrir la consola de postgres y ejecutar el siguiente comando (en negrita) para ver si se crearon correctamente las bases h i b e r n a t e ,q u a r t z ys a m p l e d a t a :
p s q l >s h o wd a t a b a s e s ;

o
p s q l >\ l

segn la versin de postgres.

Solo como referencia, aca est el listado de tablas y bases que deberan haberse creado luego de ejecutar los scripts del paquete PostgreSQL 8.x.x SQL Script:
h i b e r n a t e * a u t h o r i t i e s d a t a s o u r c e

SIU - Datawarehouse

10

g r a n t e d _ a u t h o r i t i e s u s e r s q u a r t z q r t z _ b l o b _ t r i g g e r s q r t z _ c a l e n d a r s q r t z _ c r o n _ t r i g g e r s q r t z _ f i r e d _ t r i g g e r s q r t z _ j o b _ d e t a i l s q r t z _ j o b _ l i s t e n e r s q r t z _ l o c k s q r t z _ p a u s e d _ t r i g g e r _ g r p s q r t z _ s c h e d u l e r _ s t a t e q r t z _ s i m p l e _ t r i g g e r s q r t z _ t r i g g e r _ l i s t e n e r s q r t z _ t r i g g e r s s a m p l e d a t a c u s t o m e r _ w _ t e r c u s t o m e r s d e p a r t m e n t _ m a n a g e r s d i m _ t i m e e m p l o y e e s o f f i c e s o r d e r d e t a i l s o r d e r f a c t o r d e r s p a y m e n t s p r o d u c t s q u a d r a n t _ a c t u a l s t r i a l _ b a l a n c e

* Hibernate crear nuevas tablas dentro de la base h i b e r n a t edespus de que se inicie por primera vez el Pentaho BI Platform.

Configurando la seguridad JDBC

Esta seccin describe cmo configurar la seguridad JDBC en el Pentaho BI Platform para utilizar el servidor PostgreSQL, esto significa que ahora el Pentaho apuntar a la base h i b e r n a t een el servidor PostgreSQL en vez de la base HSQL que viene por defecto. NOTA Si ya se cuenta con un usuario al cual se le quiere dar permisos de acceso a la base hibernate en vez del usuario hibuser, se deben modificar todas las ocurrencias de hibuser / password en esta seccin. applicationContext-spring-security-jdbc.xml El archivo se encuentra en el directorio p e n t a h o s o l u t i o n s / s y s t e m /. Una vez abierto el archivo buscar el siguiente cdigo:
< ! -T h i si so n l yf o rH y p e r s o n i c .P l e a s eu p d a t et h i ss e c t i o nf o ra n y

SIU - Datawarehouse

11

o t h e rd a t a b a s ey o ua r eu s i n g> < b e a ni d = " d a t a S o u r c e " c l a s s = " o r g . s p r i n g f r a m e w o r k . j d b c . d a t a s o u r c e . D r i v e r M a n a g e r D a t a S o u r c e " > < p r o p e r t yn a m e = " d r i v e r C l a s s N a m e "v a l u e = " o r g . h s q l d b . j d b c D r i v e r "/ > < p r o p e r t yn a m e = " u r l " v a l u e = " j d b c : h s q l d b : h s q l : / / l o c a l h o s t : 9 0 0 1 / h i b e r n a t e "/ > < p r o p e r t yn a m e = " u s e r n a m e "v a l u e = " h i b u s e r "/ > < p r o p e r t yn a m e = " p a s s w o r d "v a l u e = " p a s s w o r d "/ > < / b e a n >

Modificar las secciones remarcadas de manera que queden similar a esto:

< ! - T h i si so n l yf o rH y p e r s o n i c .P l e a s eu p d a t et h i ss e c t i o nf o ra n y o t h e rd a t a b a s ey o ua r eu s i n g> < b e a ni d = " d a t a S o u r c e " c l a s s = " o r g . s p r i n g f r a m e w o r k . j d b c . d a t a s o u r c e . D r i v e r M a n a g e r D a t a S o u r c e " > < p r o p e r t yn a m e = " d r i v e r C l a s s N a m e "v a l u e = " o r g . p o s t g r e s q l . D r i v e r "/ > < p r o p e r t yn a m e = " u r l " v a l u e = " j d b c : p o s t g r e s q l : / / l o c a l h o s t : 5 4 3 2 / h i b e r n a t e "/ > < p r o p e r t yn a m e = " u s e r n a m e "v a l u e = " h i b u s e r "/ > < p r o p e r t yn a m e = " p a s s w o r d "v a l u e = " p a s s w o r d "/ > < / b e a n >

applicationContext-spring-security-hibernate.properties El archivo se encuentra en el directorio p e n t a h o s o l u t i o n s / s y s t e m /. Una vez abierto el archivo buscar el siguiente cdigo:
j d b c . d r i v e r = o r g . h s q l d b . j d b c D r i v e r j d b c . u r l = j d b c : h s q l d b : h s q l : / / l o c a l h o s t : 9 0 0 1 / h i b e r n a t e j d b c . u s e r n a m e = h i b u s e r j d b c . p a s s w o r d = p a s s w o r d h i b e r n a t e . d i a l e c t = o r g . h i b e r n a t e . d i a l e c t . H S Q L D i a l e c t

Modificar las secciones remarcadas de manera que queden similar a esto:

j d b c . d r i v e r = o r g . p o s t g r e s q l . D r i v e r j d b c . u r l = j d b c : p o s t g r e s q l : / / l o c a l h o s t : 5 4 3 2 / h i b e r n a t e j d b c . u s e r n a m e = h i b u s e r j d b c . p a s s w o r d = p a s s w o r d h i b e r n a t e . d i a l e c t = o r g . h i b e r n a t e . d i a l e c t . P o s t g r e S Q L D i a l e c t

hibernate-settings.xml El archivo se encuentra en el directorio p e n t a h o s o l u t i o n s / s y s t e m / h i b e r n a t e /. Una vez abierto el archivo buscar el siguiente cdigo: < c o n f i g f i l e > s y s t e m / h i b e r n a t e / h s q l . h i b e r n a t e . c f g . x m l < / c o n f i g f i l e > Modificar las secciones remarcadas de manera que queden similar a esto: < c o n f i g f i l e > s y s t e m / h i b e r n a t e / p o s t g r e s q l . h i b e r n a t e . c f g . x m l < / c o n f i g f i l e > postgresql.hibernate.cfg.xml El archivo se encuentra en el directorio p e n t a h o s o l u t i o n s / s y s t e m / h i b e r n a t e /.
< p r o p e r t y

SIU - Datawarehouse

12

n a m e = " c o n n e c t i o n . u r l " > j d b c : p o s t g r e s q l : / / l o c a l h o s t : 5 4 3 2 / h i b e r n a t e < / p r o p e r t y > < p r o p e r t yn a m e = " c o n n e c t i o n . u s e r n a m e " > h i b u s e r < / p r o p e r t y > < p r o p e r t yn a m e = " c o n n e c t i o n . p a s s w o r d " > p a s s w o r d < / p r o p e r t y >

Modificar lo que est en negrita.

Configurando Hibernate and Quartz

Hibernate y Quartz necesitan especficamente utilizar las bases h i b e r n a t ey q u a r t zque se crearon en el servidor PostgreSQL. Para esto, hay que hacer algunas modificaciones al archivo c o n t e x t . x m lubicado en el directorio / t o m c a t / w e b a p p s / p e n t a h o / M E T A I N F /. NOTA Si ya se cuenta con un usuario al cual se le quiere dar permisos de acceso a la base hibernate en vez del usuario hibuser, se deben modificar todas las ocurrencias de hibuser / password en esta seccin. Esto mismo se aplica a pentaho_user / password usado para conectarse a la base Quartz. context.xml Una vez abierto el archivo se ve el siguiente pedazo de cdigo:
< ? x m lv e r s i o n = " 1 . 0 "e n c o d i n g = " U T F 8 " ? > < C o n t e x tp a t h = " / p e n t a h o "d o c b a s e = " w e b a p p s / p e n t a h o / " > < R e s o u r c en a m e = " j d b c / H i b e r n a t e "a u t h = " C o n t a i n e r " t y p e = " j a v a x . s q l . D a t a S o u r c e " f a c t o r y = " o r g . a p a c h e . c o m m o n s . d b c p . B a s i c D a t a S o u r c e F a c t o r y " m a x A c t i v e = " 2 0 "m a x I d l e = " 5 " m a x W a i t = " 1 0 0 0 0 "u s e r n a m e = " h i b u s e r "p a s s w o r d = " p a s s w o r d " d r i v e r C l a s s N a m e = " o r g . h s q l d b . j d b c D r i v e r " u r l = " j d b c : h s q l d b : h s q l : / / l o c a l h o s t / h i b e r n a t e " v a l i d a t i o n Q u e r y = " s e l e c tc o u n t ( * )f r o m I N F O R M A T I O N _ S C H E M A . S Y S T E M _ S E Q U E N C E S "/ > < R e s o u r c en a m e = " j d b c / Q u a r t z "a u t h = " C o n t a i n e r " t y p e = " j a v a x . s q l . D a t a S o u r c e " f a c t o r y = " o r g . a p a c h e . c o m m o n s . d b c p . B a s i c D a t a S o u r c e F a c t o r y " m a x A c t i v e = " 2 0 "m a x I d l e = " 5 " m a x W a i t = " 1 0 0 0 0 "u s e r n a m e = " p e n t a h o _ u s e r "p a s s w o r d = " p a s s w o r d " d r i v e r C l a s s N a m e = " o r g . h s q l d b . j d b c D r i v e r " u r l = " j d b c : h s q l d b : h s q l : / / l o c a l h o s t / q u a r t z " v a l i d a t i o n Q u e r y = " s e l e c tc o u n t ( * )f r o m I N F O R M A T I O N _ S C H E M A . S Y S T E M _ S E Q U E N C E S " / > < / C o n t e x t >

Modificar las partes en negrita de manera que queden similar a esto:

< ? x m lv e r s i o n = " 1 . 0 "e n c o d i n g = " U T F 8 " ? > < C o n t e x tp a t h = " / p e n t a h o "d o c b a s e = " w e b a p p s / p e n t a h o / " > < R e s o u r c en a m e = " j d b c / H i b e r n a t e "a u t h = " C o n t a i n e r " t y p e = " j a v a x . s q l . D a t a S o u r c e " f a c t o r y = " o r g . a p a c h e . c o m m o n s . d b c p . B a s i c D a t a S o u r c e F a c t o r y "

SIU - Datawarehouse

13

m a x A c t i v e = " 2 0 "m a x I d l e = " 5 " m a x W a i t = " 1 0 0 0 0 "u s e r n a m e = " h i b u s e r "p a s s w o r d = " p a s s w o r d " d r i v e r C l a s s N a m e = " o r g . p o s t g r e s q l . D r i v e r " u r l = " j d b c : p o s t g r e s q l : / / l o c a l h o s t : 5 4 3 2 / h i b e r n a t e " v a l i d a t i o n Q u e r y = " s e l e c t1 "/ > < R e s o u r c en a m e = " j d b c / Q u a r t z "a u t h = " C o n t a i n e r " t y p e = " j a v a x . s q l . D a t a S o u r c e " f a c t o r y = " o r g . a p a c h e . c o m m o n s . d b c p . B a s i c D a t a S o u r c e F a c t o r y " m a x A c t i v e = " 2 0 "m a x I d l e = " 5 " m a x W a i t = " 1 0 0 0 0 "u s e r n a m e = " p e n t a h o _ u s e r "p a s s w o r d = " p a s s w o r d " d r i v e r C l a s s N a m e = " o r g . p o s t g r e s q l . D r i v e r " u r l = " j d b c : p o s t g r e s q l : / / l o c a l h o s t : 5 4 3 2 / q u a r t z " v a l i d a t i o n Q u e r y = " s e l e c t1 " / > < / C o n t e x t >

quartz.properties Otro cambio que es necesario hacer para que Postgres 8.x.x funcione con Quartz es abrir el archivo q u a r t z . p r o p e r t i e subicado en el directorio / p e n t a h o s o l u t i o n s / s y s t e m / q u a r t z /. Dentro del archivo, buscar la configuracin de Job Store:
#J o bS t o r e o r g . q u a r t z . j o b S t o r e . c l a s s=o r g . q u a r t z . i m p l . j d b c j o b s t o r e . J o b S t o r e T X # _ r e p l a c e _ j o b s t o r e _ p r o p e r t i e s o r g . q u a r t z . j o b S t o r e . m i s f i r e T h r e s h o l d=6 0 0 0 0 o r g . q u a r t z . j o b S t o r e . d r i v e r D e l e g a t e C l a s s=o r g . q u a r t z . i m p l . j d b c j o b s t o r e . S t d J D B C D e l e g a t e o r g . q u a r t z . j o b S t o r e . u s e P r o p e r t i e s=f a l s e o r g . q u a r t z . j o b S t o r e . d a t a S o u r c e=m y D S o r g . q u a r t z . j o b S t o r e . t a b l e P r e f i x=Q R T Z _ o r g . q u a r t z . j o b S t o r e . i s C l u s t e r e d=f a l s e

Modificar de acuerdo a lo que se encuentra en negrita:

#J o bS t o r e o r g . q u a r t z . j o b S t o r e . c l a s s=o r g . q u a r t z . i m p l . j d b c j o b s t o r e . J o b S t o r e T X # _ r e p l a c e _ j o b s t o r e _ p r o p e r t i e s o r g . q u a r t z . j o b S t o r e . m i s f i r e T h r e s h o l d=6 0 0 0 0 o r g . q u a r t z . j o b S t o r e . d r i v e r D e l e g a t e C l a s s=o r g . q u a r t z . i m p l . j d b c j o b s t o r e . P o s t g r e S Q L D e l e g a t e o r g . q u a r t z . j o b S t o r e . u s e P r o p e r t i e s=f a l s e o r g . q u a r t z . j o b S t o r e . d a t a S o u r c e=m y D S o r g . q u a r t z . j o b S t o r e . t a b l e P r e f i x=Q R T Z _ o r g . q u a r t z . j o b S t o r e . i s C l u s t e r e d=f a l s e

SIU - Datawarehouse

14

pentaho.xml Modificar el archivo pentaho.xml ubicado en el directorio ..\biserver-ce\tomcat\conf\Catalina\localhost y configurar los parmetros para que se conecte a la base postgreSQL. Debe quedar igual que en el archivo context.xml que se configur anteriormente.

Configurando Apache-Tomcat Server

Para configurar el servidor Apache-Tomcat de Pentaho, la mayora de los cambios se hacen en el archivo w e b . x m lque se encuentra en el directorio/ t o m c a t / w e b a p p s / p e n t a h o / W E B _ I N F /. Los siguiente items y otros se pueden configurar en Pentaho: u b i c a c i nd ep e n t a h o s o l u t i o n s URL Deshabilitar el arranque de la base HSQL TrustedIpAddrs (opcional - para la consola de usuario y si se accede al servidor de manera remota)

Si las siguientes configuraciones le parecen correctas en Biserver de Pentaho no es necesario hacer ningn cambio: d i r e c t o r i op e n t a h o s o l u t i o n s /ubicado en el directorio / < p a t h p e n t a h o > / b i s e r v e r c e / URL para acceso a la consola de usuario de Pentaho: http://localhost:8080/pentaho solution-path
E lp a r m e t r os o l u t i o n p a t hl ep e r m i t ea lb i s e r v e rd eP e n t a h os a b e ru b i c a r e ld i r e c t o r i op e n t a h o s o l u t i o n s .P o rd e f e c t os es e t e ae ne ld i r e c t o r i o / b i s e r v e r c e / p e n t a h o / .

Si decidi utilizar un servidor Apache-Tomcat existente (o movi el directorio p e n t a h o s o l u t i o n ) necesitar apuntar este a donde se encuentra el directorio p e n t a h o s o l u t i o n s . En este ejemplo el directorio p e n t a h o s o l u t i o n sse encuentra en / u s r / l o c a l / p e n t a h o / , y el fragmento de cdigo del s o l u t i o n p a t hse ve como:
< c o n t e x t p a r a m > < p a r a m n a m e > s o l u t i o n p a t h < / p a r a m n a m e > < p a r a m v a l u e > / u s r / l o c a l / p e n t a h o / p e n t a h o s o l u t i o n s / < / p a r a m v a l u e > < / c o n t e x t p a r a m >

fully-qualified-server-url Si no tiene problemas en acceder a la consola de usuario mediante la URL http://localhost:8080/pentaho no es necesario modificar este parmetro, sin embargo si se quiere que otros accedan al sitio de Pentaho (de manera remota o por la red) es necesario modificar este parmetro. Abrir el archivo y buscar el siguiente cdigo

SIU - Datawarehouse

15

< p a r a m v a l u e > h t t p : / / l o c a l h o s t : 8 0 8 0 / p e n t a h o / < / p a r a m v a l u e >

Modificar lo que est remarcado por la IP o nombre de dominio de la PC o servidor de manera que quede como esto:
< p a r a m v a l u e > h t t p : / / w w w . p r a s h a n t r a j u . c o m : 8 0 8 0 / p e n t a h o / < / p a r a m v a l u e > or < p a r a m v a l u e > h t t p : / / 1 9 2 . 1 6 8 . 1 . 1 0 : 8 0 8 0 / p e n t a h o / < / p a r a m v a l u e >

Deshabilitar el arranque de la base HSQL Por defecto con la versin 3.8 la base HSQL se inicia automticamente - para prevenir que esto suceda buscar los siguientes bloques de cdigo:
< c o n t e x t p a r a m > < p a r a m n a m e > h s q l d b d a t a b a s e s < / p a r a m n a m e > < p a r a m v a l u e > s a m p l e d a t a @ . . / . . / d a t a / h s q l d b / s a m p l e d a t a , h i b e r n a t e @ . . / . . / d a t a / h s q l d b / h i b e r n a t e , q u a r t z @ . . / . . / d a t a / h s q l d b / q u a r t z < / p a r a m v a l u e > < / c o n t e x t p a r a m > < l i s t e n e r > < l i s t e n e r c l a s s > o r g . p e n t a h o . p l a t f o r m . w e b . h t t p . c o n t e x t . H s q l d b S t a r t u p L i s t e n e r < / l i s t e n e r c l a s s > < / l i s t e n e r >

Se puede eliminar el siguiente cdigo y simplemente comentarlo de manera que quede como:
< ! < c o n t e x t p a r a m > < p a r a m n a m e > h s q l d b d a t a b a s e s < / p a r a m n a m e > < p a r a m v a l u e > s a m p l e d a t a @ . . / . . / d a t a / h s q l d b / s a m p l e d a t a , h i b e r n a t e @ . . / . . / d a t a / h s q l d b / h i b e r n a t e , q u a r t z @ . . / . . / d a t a / h s q l d b / q u a r t z < / p a r a m v a l u e > < / c o n t e x t p a r a m > > < ! < l i s t e n e r > < l i s t e n e r c l a s s > o r g . p e n t a h o . p l a t f o r m . w e b . h t t p . c o n t e x t . H s q l d b S t a r t u p L i s t e n e r < / l i s t e n e r c l a s s > < / l i s t e n e r > >

TrustedIpAddrs Si se quiere acceder remotamente al servidor Apache-Tomcat es necesario agregar la IP del servidor Apache-Tomcat a la lista. Abrir el archivo y encontrar el siguiente cdigo: < p a r a m n a m e > T r u s t e d I p A d d r s < / p a r a m n a m e > < p a r a m v a l u e > 1 2 7 . 0 . 0 . 1 < / p a r a m v a l u e > Modificar las partes remarcadas y agregar la IP o el dominio de la PC o el servidor de manera que quede similar a esto:
< p a r a m n a m e > T r u s t e d I p A d d r s < / p a r a m n a m e > < p a r a m v a l u e > 1 2 7 . 0 . 0 . 1 , [ y o u r _ i p _ a d d r e s s ] < / p a r a m v a l u e >

Esto le permitir a la Consola de administracin de Pentaho (PAC) hacer un ping al servidor

SIU - Datawarehouse

16

para verificar si se encuentra activo o inactivo. No es necesario hacer esto si el servidor esta hosteado localmente. Otros parmetros tambin se puede modificar el idioma local y el pas en el archivo w e b . x m lfile, los cambios a estos parmetros se explican por si solos.

Configurando SMTP (mail server)

Para configurar el servidor de Pentaho para usar un servidor SMTP (servidor de correo) para el envio de reportes por email, etc hay que modificar el archivo / p e n t a h o s o l u t i o n s / s y s t e m / s m t p e m a i l / e m a i l _ c o n f i g . x m l file. Estos son los parmetros que pueden ser configurados para tener soporte SMTP: m a i l . s m t p . h o s t Direccin del servidor de email SMTP Ej: smtp.gmail.com m a i l . s m t p . p o r t Puerto del servidor SMTP Ej: para GMail es el 587 m a i l . t r a n s p o r t . p r o t o c o l El protocolo de transporte para acceder al servidor de email. Generalmente es smtp Ej: para GMail es s m t p s m a i l . s m t p . s t a r t t l s . e n a b l e Si el servidor SMTP server usa autenticacin TLS setear esto como true Ej: para GMail es t r u e m a i l . s m t p . a u t h Setear en t r u esi el servidor de email requiere la autenticacin al enviar. m a i l . s m t p . s s l Es true si el servidor de email requiere un conexin SSL Ej: para GMail es t r u e m a i l . d e b u g Salida de informacin de debug de la API JavaMail m a i l . p o p 3 No se usa. m a i l . f r o m . d e f a u l t La direccin de origen from que envia mails desde el servidor de Pentaho Ej: serverpentaho@gmail.com m a i l . u s e r i d Nobre de usuario usado para autenticar con el servidor SMTP, m a i l . s m t p . a u t hdebe estar seteado en t r u e . m a i l . p a s s w o r d Contrasea que se usa para autenticar con el servidor SMTP, mail.smtp.auth debe estar seteado en true. Este es un ejemplo del archivo s m t p e m a i l . x m lconfigurado GMail:
< e m a i l s m t p > < p r o p e r t i e s > < m a i l . s m t p . h o s t > s m t p . g m a i l . c o m < / m a i l . s m t p . h o s t > < m a i l . s m t p . p o r t > 5 8 7 < / m a i l . s m t p . p o r t >

SIU - Datawarehouse

17

< m a i l . t r a n s p o r t . p r o t o c o l > s m t p s < / m a i l . t r a n s p o r t . p r o t o c o l > < m a i l . s m t p . s t a r t t l s . e n a b l e > t r u e < / m a i l . s m t p . s t a r t t l s . e n a b l e > < m a i l . s m t p . a u t h > t r u e < / m a i l . s m t p . a u t h > < m a i l . s m t p . s s l > t r u e < / m a i l . s m t p . s s l > < m a i l . s m t p . q u i t w a i t > f a l s e < / m a i l . s m t p . q u i t w a i t > < / p r o p e r t i e s > < m a i l . p o p 3 > < / m a i l . p o p 3 > < m a i l . f r o m . d e f a u l t > p e n t a h o a d m i n @ g m a i l . c o m < / m a i l . f r o m . d e f a u l t > < m a i l . u s e r i d > p e n t a h o a d m i n @ g m a i l . c o m < / m a i l . u s e r i d > < m a i l . p a s s w o r d > p a s s w o r d < / m a i l . p a s s w o r d > < / e m a i l s m t p >

Configurando Publicacin (Publishing)

Por defecto la publicacin no est habilitada, para habilitarlo hay que especificar una contrasea que ser usada al momento de publicar. Para configurarlo hay que editar el archivo p u b l i s h e r _ c o n f i g . x m lubicado en el directorio / p e n t a h o s o l u t i o n s / s y s t e m / , y una vez abierto buscar el siguiente cdigo:
< p u b l i s h e r c o n f i g > < p u b l i s h e r p a s s w o r d > < / p u b l i s h e r p a s s w o r d > < / p u b l i s h e r c o n f i g >

Ingresar la contrasea deseada entre los tags p u b l i s h e r p a s s w o r d(esta contrasea ser el mismo para todos los usuarios) de manera que quede parecido al ejemplo de abajo:
< p u b l i s h e r c o n f i g > < p u b l i s h e r p a s s w o r d > m i c o n t r a s e a < / p u b l i s h e r p a s s w o r d > < / p u b l i s h e r c o n f i g >

Desde este momento, cualquier usuario que intente publicar contenido en el servidor de Pentaho tendr que especificar esta contrasea.

Configurando la Consola de Administracin

Para configurar la Consola de Administracin con PostgreSQL es necesario descargar el driver JDBC para PostgreSQL. Para esto ingresar al sitio PostgreSQL JDBC Driver downloads y descargar el driver de acuerdo a la versin de Java instalada. Despus de descargar el archivo p o s t g r e s q l 8 . 4 7 0 1 . j d b c x . j a rmoverlo dentro del directorio / a d m i n i s t r a t i o n c o n s o l e / j d b c / .

SIU - Datawarehouse

18

Iniciando el servidor de Pentaho

El servidor de Pentaho es una aplicacin web que corre en el servidor Apache-Tomcat.Para iniciar en servidor Apache-Tomcat hay que ejecutar el script start-pentaho.sh ubicado en el directorio / b i s e r v e r c e / Luego se puede acceder mediante el navegador en la url: http://localhost:8080/pentaho or h t t p : / / [ t u _ d o m i n i o _ o _ i p ] : 8 0 8 0 / p e n t a h o . Si el servidor de Pentaho se inici correctamente debera ver la siguiente pantalla de bienvenida:

Luego de loguearse y ejecutar un reporte de ejemplo de la carpeta de las soluciones de S t e e lW h e e l s :

SIU - Datawarehouse

19

Iniciando la Consola de Administracin

Para iniciar la Consola de Administracin hay que ejecutar el archivo s t a r t p a c . s hfile que se encuantra en el directorio / p e n t a h o / a d m i n i s t r a t i o n c o n s o l e /:
u s e r @ t e r m i n a l : / o p t / p e n t a h o / a d m i n i s t r a t i o n c o n s o l e #s t a r t p a c . s h D E B U G :U s i n gJ A V A _ H O M E D E B U G :_ P E N T A H O _ J A V A _ H O M E = / l i b / j v m / j a v a 6 s u n / D E B U G :_ P E N T A H O _ J A V A = / l i b / j v m / j a v a 6 s u n / 2 0 1 0 0 1 0 51 6 : 2 7 : 1 7 . 8 2 4 : : I N F O : L o g g i n gt oS T D E R Rv i a o r g . m o r t b a y . l o g . S t d E r r L o g 0 5 / 0 1 / 2 0 1 04 : 2 7 : 1 8P Mo r g . p e n t a h o . p a c . s e r v e r . J e t t y S e r v e rs t a r t S e r v e r I N F O :C o n s o l ei ss t a r t i n g 2 0 1 0 0 1 0 51 6 : 2 7 : 1 8 . 1 1 8 : : I N F O : j e t t y 6 . 1 . 2 2 0 1 0 0 1 0 51 6 : 2 7 : 3 8 . 6 7 2 : : I N F O : S t a r t e dS o c k e t C o n n e c t o r@0 . 0 . 0 . 0 : 8 0 9 9 0 5 / 0 1 / 2 0 1 04 : 2 7 : 3 8P Mo r g . p e n t a h o . p a c . s e r v e r . J e t t y S e r v e rs t a r t S e r v e r I N F O :C o n s o l ei sn o ws t a r t e d .I tc a nb ea c c e s s e d u s i n g h t t p : / / D 1 1 9 9 4 0 : 8 0 9 9o rh t t p : / / 1 6 1 . 1 1 7 . 1 1 7 . 4 0 : 8 0 9 9

SIU - Datawarehouse

20

Ahora se podr acceder mediante la url http://localhost:8099/ o la IP especificada en la salida. Para ingresar hay que especificar el usuario y contrasea que por defecto son "admin" y "password". Una vez logueado correctamente se ver la siguiente pantalla:

Configuracin de la conexin JNDI

Una vez configurado todo para que funcione en la base de PostgreSQL hay que crear la conexin siu_dw para que se conecte Pentaho a la base siu_dw. Para eso, desde la Consola de Administracin hay que crear una nueva conexin con los parmetros correspondientes al servidor de PostgreSQL:

SIU - Datawarehouse

21

Monitorear la actividad del Apache-Tomcat en Pentaho CE

La versin Community de Pentaho no cuenta con la posibilidad de monitorear el servidor, para esto se puede utilizar algn software de monitoreo general de aplicaciones en Apache Tomcat, como por ejemplo Lambda Probe. Con esta aplicacin se puede monitoriear las sesiones abiertas en el apache, la memoria consumida por la JVM, el historial de uso de memoria, etc. Los pasos para instalar "Probe" en el servidor de Pentaho son muy simples (tomados de http://www.lambdaprobe.org/d/installation.shtml). 1- Descargar el arhivo Lamda Probe .war 2- Bajar el servidor de Pentaho. 3- Copiar el archivo probe.war en <biserver_home>/tomcat/webapps 4- Configuracin de seguridad: Lambda requiere de la declaracin de cuatro roles de seguridad: manager, poweruser, poweruserplus y probeuser. Por defecto los roles de Tomcat se declaran en <biserver_home>/tomcat/conf/tomcat-users.xml. manager: Este rol tiene acceso total a las funcionalidades de Lambda Probe. poweruser: Este rol tiene los mismos provilegios que manager excepto para deployar y eliminar aplicaciones y monitorear Tomcat mediante la opcin "quick check". poweruserplus: Este rol tiene los mismos privilegios que el poweruser incluido la posibilidad de reiniciar la JVM.

SIU - Datawarehouse

22

probeuser: Es el rol con menos privilegios de los tres y est restringido a funcionalidades de solo lectura. Caractersticas como parar/iniciar aplicaciones, reiniciar datasources no estn disponibles. 5- Iniciar el servidor de Pentaho. 6- Ingresar a Lambda Probe por la url http://<url_biserver>/probe ej: http://localhost/probe mediante alguno de los usuarios definidos en el archivo tomcat-users.xml. Nota: Para poder ver los datos de la opcin System information hay que agregar la opcin (-Dcom.sun.management.jmxremote ) en CATALINA_OPTS. Editar el archivo /biserver-ce/start-pentaho.sh y agregar la opcin: export CATALINA_OPTS="-Xms512m -Xmx1024m -XX:MaxPermSize=256m -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 -Dcom.sun.management.jmxremote" Ejemplo de definicin de los roles en el archivo tomcat-users.xml
<?xml version='1.0' encoding='utf-8'?> <tomcat-users> <role rolename="manager"/> <role rolename="poweruser"/> <role rolename="poweruserplus"/> <role rolename="probeuser"/> <user username="manager" password="manager" roles="manager"/> <user username="poweruser" password="poweruser" roles="poweruser"/> <user username="poweruserplus" password="poweruserplus" roles="poweruserplus"/> <user username="probeuser" password="probeuser" roles="probeuser"/> </tomcat-users>

SIU - Datawarehouse

23

Instalacin de las soluciones SIU en Pentaho

Una vez que el servidor y la base de datos se encuentran configurados se prosigue con la instalacin de las soluciones SIU en pentaho. Esta solucin consta de los cubos, vistas, reportes y tableros de los distintos sistemas del SIU (Guaran, Pilag y Mapuche). Dentro del paquete que se distribuye con las soluciones del SIU en Pentaho se encuentra la documentacin de instalacin, los procesos ETL de carga de datos de los diferentes sistemas a la base del datawarehouse. El paquete de soluciones SIU en Pentaho se puede descargar desde la Extranet del SIU (http://extranet.siu.edu.ar/) ingresando con su usuario y contrasea. El mismo se encuentra ubicado en Herramientas y servicios -> Repositorios -> Navegador de archivos

Luego en SIU-DW -> DataWarehouse Pentaho Versiones - Universidad (versin completa para Universidades) o en SIU-DW -> DataWarehouse Pentaho Versiones - Facultades (versin para Facultades) Luego deber descargar el archivo .rar de la ltima versin disponible: en el caso de las Universidades (SIU-DW-Pentaho-v1.0.0beta-20120507.rar) y en el caso de la Facultades (Pentaho-Facultad-v1.0.0beta20120707.rar). Luego al descomprimirlo, ver que contiene las siguientes carpetas: /documentacion: Contiene la documentacin de instalacin de Pentaho (carpeta compartido) y de carga de los datos para cada uno de los sistemas. /etl: Contiene los procesos de Kettle - PDI para realizar la carga de los datos de los sistemas en la base del datawarehouse. /pentaho-solutions/siu: Contiene los cubos, vistas, reportes y tableros de los diferentes sistemas. Atencin: Para comenzar con la instalacin de las soluciones SIU, leer con detenimiento el documento Instalacion soluciones SIU en Pentaho.txt que se encuentra en la carpeta /documentacion.

Importante: Recordar cargar las cubos en el archivo datasources.xml para que estn disponibles en Nueva Vista de Anlisis dentro de la Consola de Usuario de SIU - Datawarehouse

24

Pentaho. Ver (Paso 2: Registrar los cubos en la lista de Datasources de Pentaho) en el archivo documentacion/compartido/Instalacion soluciones SIU en Pentaho.txt Refrescar la Cache del Repositorio de Pentaho: Para que las carpetas copiadas en pentaho-solutions se actualicen en el servidor hay que refrescar la cache del repositorio mediante la Consola de Usuario (Herramientas -> Actualizar -> Actualizar el cache del repositorio)

o sino mediante la Consola de Administracin (Administration -> Services -> Solution Repository Refresh). En ambos casos debe loguearse con un usuario que tenga permisos de administrador.

Instalar los componentes de Pentaho CDE (Community Dashboard Editor) para que funiconen los tableros (dashboards). Ver (Paso 4: Instalacin de Pentaho CDE (Community Dashboard editor) en el archivo documentacion/compartido/ Instalacion soluciones SIU en Pentaho.txt

Carga de datos en la base del datawarehouse (siu_dw)

Pentaho requiere que los datos que se van a consultar estn almacenados en una base de

SIU - Datawarehouse

25

datos, por eso desde el SIU se dise una base de datos con un formato especial para datawarehouse la cual hay que cargar mediante los procesos desarrollados con la herramienta Pentaho PDI (conocida tambin como Kettle). Esta herramienta forma parte de la Suite de Pentaho y se puede descargar desde http://sourceforge.net/projects/pentaho/files/Data%20Integration/4.2.1-stable/ (pdi-ce-4.2.1-stable.tar.gz). Los pasos a seguir para cargar los datos de los diferentes sistemas que se quieran analizar con Pentaho se encuentran documentados en el paquete de soluciones del SIU en Pentaho en la carpeta correspondiente: Guaran: /documentacion/guarani/instrucciones_cargar_siu_dw_guarani.txt Pilag: documentacion/pilaga/instrucciones_cargar_siu_dw_pilaga.txt Mapuche : /documentacion/mapuche/instrucciones_cargar_siu_dw_mapuche.txt Importante: Cada vez que cargue nuevos datos a la base siu_dw deber refrescar la cache de Mondrian mediante la Consola de Usuario (Herramientas -> Actualizar -> Vaciar el cache de esquemas de Mondrian) o mediante la Consola de Administracin (Administration -> Services -> Refresh Bi Server -> Mondrian Cache ). Una vez realizado este paso podr ver los nuevos datos en los cubos que consulte, de otra manera seguir viendo los datos anteriores a la actualizacin de la base.

SIU - Datawarehouse

26