Guia Penta Ho

PENTAHO BUSINESS INTELLIGENCE SUITE 4.5UNA GUIA PARA COMENZAR CON POSTGRESQL 9.1 Y

GNU/LINUX

OMAR CABRERA ROSERO

UNIVERSIDAD DE NARINOFACULTAD DE INGENIERIA

PROGRAMA DE INGENIERIA DE SISTEMASSAN JUAN DE PASTO

2012

You are free:

to Share – to copy, distribute and transmit thiswork

to Remix – to adapt this work

Under the following conditions:

Attribution – You must attribute the work in themanner specified by the author or licensor (but notin any way that suggests that they endorse you oryour use of the work)

Share Alike – If you alter, transform, or buildupon this work, you may distribute the resultingwork only under the same or similar license to thisone.

Subject to conditions outlined in the license.

This work is licensed under the Creative Commons Attribution-ShareAlike 3.0

Unported License. To view a copy of this license, visit

http://creativecommons.org/licenses/by-sa/3.0/

or send a letter to Creative Commons, 171 Second Street, Suite 300, San Fran-

cisco, California, 94105, USA.

http://creativecommons.org/licenses/by-sa/3.0/

CONTENIDO

1. Comenzando Instalacion 7

1.1. Instalacion Java de Oracle 7

1.2. Instalacion y configuracion de PostgreSQL 9.1 Server 8

2. Implementacion de la plataforma 11

2.1. PostgreSQL Java Conector 11

2.2. SQL Script Pack 12

3. Configurando la Base de Datos 13

3.1. Extraer el paquete de scripts para postgreSQL 13

3.2. Cargando los scritps SQL 13

4. Configurando Seguridad JDBC 16

4.1. applicationContext-spring-security-jdbc.xml 16

4.2. applicationContext-spring-security-hibernate.properties 17

4.3. hibernate-settings.xml 17

4.4. postgresql.hibernate.cfg.xml (opcional) 18

5. Configurar Hibernate y Quartz 19

5.1. context.xml y pentaho.xml 19

5.2. quartz.properties 20

6. Configurar servidor Apache-Tomcat 21

6.1. solution-path 21

6.2. fully-qualified-server-url 22

6.3. Deshabilitar base de datos HSQL al inicio 22

6.4. TrustedIpAddrs 23

6.5. Otros parametros 24

7. Configurando SMTP (servidor de correo) 25

8. Configurando publicacion 27

9. Configuracion de la consola de administracion 28

10.Cuenta de Usuario 29

11.Iniciar la Plataforma Pentaho BI 30

12.Iniciar la Plataforma Pentaho BI Automaticamente 32

13.Iniciar la consola de Administracion 34

INTRODUCCION

Pentaho BI Platform Community Edition (CE), proporciona la arquitectura y la infra-

estructura necesarios para crear soluciones para problemas de inteligencia de negocios

(BI). El framework proporciona servicios basicos como la autenticacion, registro, audi-

torıa, servicios web y motores de reglas. La plataforma tambien incluye un motor de

solucion que integra la presentacion de informes, analisis, cuadros de mando y los com-

ponentes de minerıa de datos. El diseno modular y basado en arquitectura de plugin

permite que toda o parte de la plataforma sea embebida en aplicaciones de terceros por

los usuarios finales, ası como OEMs.

La aplicacion mas conocida de la Plataforma de BI es el Pentaho BI server que fun-

ciona como sistema manejador de reportes basado en la web el informe, el servidor de

integracion de aplicaciones y el motor de flujo de trabajo ligero (secuencias de accion.)

Esta disenado para facil integracion en cualquier proceso de negocio.

Community Edition es un software libre de codigo abierto soportado. La Enterprise

Edition (EE) de la Pentaho BI plataform esta disponible como parte de la Pentaho BI

Suite EE que incluye soporte tecnico, manejador de actualizaciones y caracterısticas de

la empresa. Para obtener mas informacion acerca de la EE o para demos y hojas de

datos, podemos visitar Pentaho BI Suite EE en el sitio corporativo de Pentaho 1.

Para usar esta guia se considera que el lector tiene conociemintos intermedios y avan-

zados en su configuracion de eleccion y conocimientos basicos de Pentaho (aunque no

es necesario). Los siguientes sistemas operativos y base de datos son soportados:

1http://www.pentaho.com/products/

http://www.pentaho.com/products/

Windows

• MySQL

• PostgreSQL

• Oracle

GNU/Linux

• MySQL

• PostgreSQL

• Oracle

Esta guia es para configurar Pentaho BI Server 4.5.0 en GNU/Linux y PostgreSQL 9.1,

parte de esta guia esta basada en la guia realizada por Prashant Raju 2 y el libro de

Roland Boumen y Jos van Dongen 3

2http://www.prashantraju.com/projects/pentaho/3Pentaho Solutions: Business Intelligence and Data Warehousing with Pentaho and MySQL

http://www.prashantraju.com/projects/pentaho/

1 Comenzando Instalacion

1.1. Instalacion Java de Oracle

Pentaho BI requiere de una JVM (Java Virtual Machine) instalada en su PC o servidor.

Para comprobar si Java esta instalado se ejecuta el siguiente comando en la terminal:

$ java −ve r s i onjava ve r s i on ‘ ‘ 1 . 7 . 0 07 ’ ’Java (TM) SE Runtime Environment ( bu i ld 1 . 7 . 0 07−b10 )Java HotSpot (TM) 64−Bit Server VM ( bu i ld 23.3−b01 , mixed mode)

Si muestra una salida similar a la anterior Java ya esta instalado. Si no, instale Java en

GNU/Linux siguiendo los pasos siguientes:

Lo primero que se tiene que hacer es descargar el JDK, el cual se lo puede encontrar

en: http://www.oracle.com se acepta la licencia y dependiendo de la arquitectura del

sistema se descarga el archivo jdk-7u7-linux-i586.tar.gz para plataforma x86 o jdk-7u7-

linux-x64.tar.gz para plataforma x64.

Luego el archivo descargado se lo copia a la carpeta opt y se lo descomprime de la

siguiente forma en la terminal:

$ su# cp jdk−7u7−l inux−x64 . t a r . gz / opt# tar x v f jdk−7u7−l inux−x64 . t a r . gz

Se cambia el nombre a la carpeta que se descomprimio

# mv jdk1 . 7 . 0 07 jvm

7

http://www.oracle.com/technetwork/java/javase/downloads/jdk7u7-downloads-1836413.html

Luego se ejecutan los siguientes comandos

# update−a l t e r n a t i v e s −− i n s t a l l ‘ ‘/ usr / b in / java ’ ’ ‘ ‘ java ’ ’ ‘ ‘/ opt /jvm/ j r e / b in / java ’ ’ 1

# update−a l t e r n a t i v e s −− i n s t a l l ‘ ‘/ usr / b in / java ’ ’ ‘ ‘ java ’ ’ ‘ ‘/ opt /jvm/ bin / java ’ ’ 1

# update−a l t e r n a t i v e s −− i n s t a l l ‘ ‘/ usr / b in / javac ’ ’ ‘ ‘ javac ’ ’ ‘ ‘/ opt/jvm/ bin / javac ’ ’ 1

# update−a l t e r n a t i v e s −− i n s t a l l ‘ ‘/ usr / b in / javaws ’ ’ ‘ ‘ javaws ’ ’ ‘ ‘/opt /jvm/ bin / javaws ’ ’ 1

# update−a l t e r n a t i v e s −−con f i g java

El siguiente paso es configurar la variable de entorno JAVA HOME, para eso se agregan

las siguientes lineas en el archivo /etc/environment:

JAVA HOME=“/opt/jvm”

JRE HOME=“/opt/jvm/jre”

Ahora para comprobar si la variable de entorno quedo bien configurada, se ejecuta el

siguiente comando en la terminal:

$ echo $JAVA HOME $JRE HOME/ opt /jvm / opt/jvm/ j r e

Si muestra una salida similar a la anterior, la variable de entorno JAVA HOME esta

configurada correctamente.

1.2. Instalacion y configuracion de PostgreSQL 9.1 Server

Para la instalacion de PostgreSQL 9.1 (Para Debian/Linux), en una terminal se ejecuta

los siguiente:

$ su# apt−ge t i n s t a l l p o s t g r e s q l p o s t g r e s q l−c l i e n t p o s t g r e s q l−con t r i b

pgadmin3

Ahora se borra la contrasena para la cuenta de adminitrador de “postgres” para ello se

ejecuta lo siguiente en la linea de comandos.

8

# su po s t g r e s −c p s q l t empla te1

template1=# ALTER USER pos tg r e s WITH PASSWORD ‘ pos tg r e s1 ’ ;template1=#\q

Eso altera la contrasena dentro de la base de datos, ahora se tiene que hacer lo mismo

para el usuario ’postgres’ y colocar la misma contrasena que utilizo anteriormente.

# passwd −d po s t g r e s#su po s t g r e s −c passwd

Para configurar el paquete de administracion de PostgreSQL que permite un mejor re-

gistro y supervision dentro de pgAdmin se ejecuta lo siguiente en la terminal.

# su po s t g r e s −c p s q l < /usr / share / p o s t g r e s q l /9.1/ ex t ens ion /adminpack−−1.0. s q l

Para poder acceder y utilizar el servidor de forma remota se debe editar el archivo

postgresql.conf

nano / e tc / p o s t g r e s q l /9 .1/ main/ p o s t g r e s q l . conf

Al final del archivo agregamos las siguientes lineas:

listen addresses = ’*’

password encryption = on

Ahora se debe definir quien puede acceder al servidor, para ello se modifica el archivo

pg hba.conf.

nano / e tc / p o s t g r e s q l /9 .1/ main/pg hba . conf

9

Debe quedar algo similar a lo siguiente:

# DO NOT DISABLE!# I f you change t h i s f i r s t en try you w i l l need to make sure# tha t the # database# super user can access the database us ing some other method .# Nonin t e rac t i v e# access to a l l da tabases i s r e qu i r ed during automatic# maintenance # ( autovacuum , d a i l y cronjob , r e p l i c a t i o n ,# and s im i l a r t a s k s ) .## Database admin i s t r a t i v e l o g i n by UNIX soc k e t slocal a l l po s t g r e s md5# TYPE DATABASE USER CIDR−ADDRESS METHOD

# ” l o c a l ” i s f o r Unix domain socke t connec t ions on lylocal a l l a l l md5# IPv4 l o c a l connect ions :host a l l a l l 1 2 7 . 0 . 0 . 1 / 3 2 md5# IPv6 l o c a l connect ions :host a l l a l l : : 1 / 1 2 8 md5

# Connections f o r a l l PCs on the subnet## TYPE DATABASE USER IP−ADDRESS IP−MASK METHODhost a l l a l l [ ip address ] [ subnet mask ] md5

En la ultima lınea, agrega su mascara de subred (por ejemplo, 255.255.255.0) y la

direccion IP de la maquina que usted desea tener acceso a su servidor (por ejemplo,

192.168.1.104). Sin embargo, si usted desea permitir el acceso a un rango de direcciones

IP, Se sustituye el ultimo numero por un cero y todas las maquinas dentro de ese rango

se permitira el acceso (por ejemplo, 192.168.1.0 permitirıa a todos los equipos con una

direccion IP 192.168.1.X para usar el servidor de base de datos).

Ya por ultimo se reinicia el servidor:

# / e t c / i n i t . d/ p o s t g r e s q l r e s t a r t

10

2 Implementacion de la plataforma

Hay muchas maneras de implementar la plataforma, con Apache-Tomcat que viene con

el archivo de instalacion del servidor Pentaho BI o con un servidor existente Apache-

Tomcat.

En esta guıa se impletentara con el servidor Apache-Tomcat que viene con el servidor

de Pentaho BI, para ello primero se descarga el archivo “biserver-ce-4.5.0-stable.tar.gz”

desde http://sourceforge.net/projects/pentaho/

Se crea el directorio /opt/pentaho, en esta carpeta se mueve el archivo descargado y se

lo extrae de la siguiente manera en la terminal:

$ su# mkdir / opt /pentaho# mv b i s e r v e r−ce−4.5.0− s t a b l e . t a r . gz / opt /pentaho# cd / opt /pentaho# tar x v z f b i s e r v e r−ce−4.5.0− s t a b l e . t a r . gz

Los siguientes directorios pueden ser visibles luego de extraer el arcivo tar.gz

opt/

• pentaho/

◦ administration-console

◦ biserver-ce

2.1. PostgreSQL Java Conector

Para colocar el conector JDBC se procede a descargar el archivo “postgresql-9.2-1002.jdbc4.jar”

en el directorio “/opt/pentaho/biserver-ce/tomcat/lib” para ello se ejecuta lo siguiente

en la terminal:

11

http://sourceforge.net/projects/pentaho/files/Business%20Intelligence%20Server/4.5.0-stable/biserver-ce-4.5.0-stable.tar.gz

# cd /opt /pentaho/ b i s e r v e r−ce/ tomcat/ l i b# wget h t t p :// jdbc . p o s t g r e s q l . org /download/ po s t g r e s q l −9.2−1002.

jdbc4 . j a r

2.2. SQL Script Pack

Un paquete de scripts SQL es un conjunto de secuencias de comandos SQL para confi-

gurar todas las bases de datos necesarias. El paquete de scripts SQL para PostgreSQL

se lo puede descargar aquı.

12

http://docs.google.com/leaf?id=0B9Jmocc0fj_EOTVjYWYyOGEtMGI3Ny00N2I5LTg1NmUtY2IyMWE1ZmQwMTkw&hl=en

3 Configurando la Base de Datos

3.1. Extraer el paquete de scripts para postgreSQL

Despues de descargar el paquete los scripts SQL para PostgreSQL se tienen que extraer

los archivos en una ubicacion temporal. Estas son los cinco scripts SQL que deben ser

visibles despues de que el paquete ha sido extraıdos:

1 create repository postgresql.sql: Crea la base de datos Hibernate.

2 create quartz postgresql.sql: Crea la base de datos de cuarzo.

3 create sample datasource postgresql.sql: Carga los datos de ejemplo de fuente

de datos en la base de datos Hibernate.

4 load sample users postgresql.sql: Crea todos los usuarios de ejemplo y roles en

la base de datos Hibernate.

5 sample data postgresql.sql: Crea la base de datos de datos de ejemplo.

Los scripts anteriores se deben cargar en el orden en que se enumeran. Cargue estos

scripts SQL utilizando la consola de PostgreSQL.

3.2. Cargando los scritps SQL

Antes de empezar, asegurese de que coloca todos los scripts SQL en el directorio que

iniciara la sesion en la consola de PostgreSQL, en este caso /home/pentaho/tmp/.

Luego para ejecutar los scritps en una terminal ejecutamos:

13

# cd /home/pentaho/tmp# p s q l −−username=pos t g r e s −f 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 lPassword for user po s tg r e s :. . . outputPassword for user h ibuse r : [ en te r ‘ ‘ password ’ ’ ]# ps q l −−username=pos t g r e s −f 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 lPassword for user po s tg r e s :. . . outputPassword for user pentaho user : [ en te r ‘ ‘ password ’ ’ ]# ps q l −−username=pos t g r e s −f 3 c r e a t e s amp l e d a t a s o u r c e p o s t g r e s q l

. s q lc 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 lPassword for user po s tg r e s :Password for user h ibuse r : [ en te r ‘ ‘ password ’ ’ ]. . . output# ps q l −−username=pos t g r e s −f 4 l o a d s amp l e u s e r s p o s t g r e s q l . s q lPassword for user po s tg r e s :Password for user h ibuse r : [ en te r ‘ ‘ password ’ ’ ]. . . output# ps q l −−username=pos t g r e s −f 5 s amp l e d a t a p o s t g r e s q l . s q lPassword for user po s tg r e s :. . . output

Ejecutando los anteriores scripts se crean tres base de datos hibernate, quartz y sam-

pledata con las siguientes tablas:

hibernate 1

L i s t o f r e l a t i o n sSchema | Name | Type | Owner−−−−−−−−+−−−−−−−−−−−−−−−−−−−−−+−−−−−−−+−−−−−−−−−

pub l i c | a u t h o r i t i e s | t a b l e | h ibuse rpub l i c | datasource | t a b l e | h ibuse rpub l i c | g r a n t e d a u t h o r i t i e s | t a b l e | h ibuse rpub l i c | use r s | t a b l e | h ibuse r

1Hibernate crea nuevas tablas en la base de datos hibernate despues de que la plataforma PentahoBI inicia por primera vez.

14

4 Configurando Seguridad JDBC

En esta seccion se describe como configurar la seguridad de la plataforma Pentaho

BI JDBC que se utiliza en el servido PostgreSQL, esto significa que la plataforma de

Pentaho BI ahora apuntara a la base de datos hibernate en el servidor PostgreSQL en

lugar del paquete de la base de datos HSQL.

4.1. applicationContext-spring-security-jdbc.xml

Este archivo esta esta localizado en el directorio pentaho-solutions/system/.

Una vez abierto el archivo se localiza este fragmento de codigo:

< !−− This i s on ly f o r Hypersonic . P lease update t h i s s e c t i on f o rany o ther database you are us ing −−>

<bean id = ‘ ‘ dataSource ’ ’ c l a s s = ‘ ‘ org . springframework . jdbc . datasource. DriverManagerDataSource ’ ’>

<property name= ‘ ‘ driverClassName ” value = ‘ ‘ org . hsqldb . jdbcDriver ’ ’/>

<property name= ‘ ‘ ur l ’ ’ va lue = ‘ ‘ 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 /hibernate ’ ’ />

<property name= ‘ ‘ username ’ ’ va lue = ‘ ‘ h ibuser ’ ’ /><property name= ‘ ‘ password ’ ’ va lue = ‘ ‘ password ’ ’ />

</bean>

Se realizan algunos cambios en la seccion y el codigo debe ser similar al siguiente:

16

< !−− This i s on ly f o r Hypersonic . P lease update t h i s s e c t i on f o rany o ther database you are us ing −−>

<bean id = ‘ ‘ dataSource ’ ’ c l a s s = ‘ ‘ org . springframework . jdbc . datasource. DriverManagerDataSource ’ ’>

<property name= ‘ ‘ driverClassName ’ ’ va lue = ‘ ‘ org . p o s t g r e s q l . Dr iver ’’ />

<property name= ‘ ‘ u r l ’ ’ va lue = ‘ ‘ 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 ibe rnate ’ ’ />

<property name= ‘ ‘ username ’ ’ va lue = ‘ ‘ h ibuse r ’ ’ /><property name= ‘ ‘ password ’ ’ va lue = ‘ ‘ password ’ ’ />

</bean>

4.2. applicationContext-spring-security-hibernate.properties

Este archivo esta esta localizado en el directorio pentaho-solutions/system/


jdbc . d r i v e r=org . hsqldb . jdbcDr iverjdbc . u r l=jdbc : hsqldb : hsq l : // l o c a l h o s t :9001/ h ibe rnatejdbc . username=hibuse rjdbc . password=passwordh ibernate . d i a l e c t=org . h ibe rnate . d i a l e c t . HSQLDialect


jdbc . d r i v e r=org . p o s t g r e s q l . Dr iverjdbc . u r l=jdbc : p o s t g r e s q l : // l o c a l h o s t :5432/ h ibe rnatejdbc . username=hibuse rjdbc . password=passwordh ibernate . d i a l e c t=org . h ibe rnate . d i a l e c t . PostgreSQLDialect

4.3. hibernate-settings.xml

Este archivo esta esta localizado en el directorio pentaho-solutions/system/hibernate/


17

<con f i g− f i l e>system/ h ibe rnate / hsq l . h ibe rnate . c f g . xml</ con f i g− f i l e>


<con f i g− f i l e>system/ h ibe rnate / p o s t g r e s q l . h ibe rnate . c f g . xml</ con f i g−f i l e>

4.4. postgresql.hibernate.cfg.xml (opcional)

Este archivo esta esta localizado en el directorio pentaho-solutions/system/hibernate/

No se tiene que realizar ningun cambio en este archivo si desea utilizar el usuario

hibuser por defecto (que fue creado con el archivo 4 load sample users postgresql.sql).

Sin embargo, si usted desea especificar su propio usuario buscar y cambiar las siguientes

dos lıneas de codigo:

<property name= ‘ ‘ connect ion . username ’ ’>h ibuse r</ property><property name= ‘ ‘ connect ion . password ’ ’>password</ property>

Realice los cambios con un nombre de usuario y la contrasena de su eleccion.

18

5 Configurar Hibernate y Quartz

Hibernate y Quartz necesitan especificame usar las bases de datos hibernate y quartz

que se crean en el servidor PostgreSQL.

5.1. context.xml y pentaho.xml

Estos archivos se encuentra en el directorio /tomcat/webapps/pentaho/META-INF/ y

/conf/Catalina/localhost/ respectivamente y tienen el mismo contenido.

Una vez abiertos los archivos se localiza este fragmento de codigo:

<?xml version= ‘ ‘1 .0 ’ ’ encoding = ‘ ‘UTF−8 ’ ’ ?><Context path = ‘ ‘/ pentaho ’ ’ docbase = ‘ ‘webapps/pentaho/ ’ ’>

<Resource name= ‘ ‘ jdbc / Hibernate ’ ’ auth = ‘ ‘ Container ’ ’ type = ‘ ‘ javax. s q l . DataSource ’ ’

f a c t o r y = ‘ ‘ org . apache . commons . dbcp . BasicDataSourceFactory ’ ’maxActive = ‘ ‘20 ’ ’ maxIdle = ‘ ‘5 ’ ’

maxWait= ‘ ‘10000 ’ ’ username = ‘ ‘ h ibuse r ’ ’ password = ‘ ‘ password ’ ’driverClassName = ‘ ‘ org . hsqldb . jdbcDr iver ’ ’ 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 ibe rnate ’ ’va l idat ionQuery = ‘ ‘ s e l e c t count (∗ ) from INFORMATION SCHEMA.

SYSTEM SEQUENCES ’ ’ />

<Resource name= ‘ ‘ jdbc /Quartz ’ ’ auth = ‘ ‘ Container ’ ’ type = ‘ ‘ javax .s q l . DataSource ’ ’


maxWait= ‘ ‘10000 ’ ’ username = ‘ ‘ pentaho user ’ ’ password = ‘ ‘ password’ ’

driverClassName = ‘ ‘ org . hsqldb . jdbcDr iver ’ ’ 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 / quartz ’ ’

va l idat ionQuery = ‘ ‘ s e l e c t count (∗ ) from INFORMATION SCHEMA.SYSTEM SEQUENCES ’ ’ />

</Context>


19

<?xml version= ‘ ‘1 .0 ’ ’ encoding = ‘ ‘UTF−8 ’ ’ ?><Context path = ‘ ‘/ pentaho ’ ’ docbase = ‘ ‘webapps/pentaho/ ’ ’>

<Resource name= ‘ ‘ jdbc / Hibernate ’ ’ auth = ‘ ‘ Container ’ ’ type = ‘ ‘ javax. s q l . DataSource ’ ’


maxWait= ‘ ‘10000 ’ ’ username = ‘ ‘ h ibuse r ’ ’ password = ‘ ‘ password ’ ’driverClassName = ‘ ‘ org . p o s t g r e s q l . Dr iver ’ ’ 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 ibe rnate ’ ’va l idat ionQuery = ‘ ‘ s e l e c t 1 ’ ’ />

<Resource name= ‘ ‘ jdbc /Quartz ’ ’ auth = ‘ ‘ Container ’ ’ type = ‘ ‘ javax .s q l . DataSource ’ ’


maxWait= ‘ ‘10000 ’ ’ username = ‘ ‘ pentaho user ’ ’ password = ‘ ‘ password’ ’

driverClassName = ‘ ‘ org . p o s t g r e s q l . Dr iver ’ ’ 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 / quartz ’ ’

va l idat ionQuery = ‘ ‘ s e l e c t 1 ’ ’ /></Context>

5.2. quartz.properties

Un cambio adicional se necesita hacer para conseguir trabajar PostgreSQL con quartz

para ello se abre el archivo quartz.properties que se encuentra en el directorio / pentaho-

solutions/system/.

Buscar el siguiente fragmento de codigo:

#org . quar t z . j o bS to r e . d r i v e rDe l e ga t eC l a s s =

Se realizan algunos cambios y el codigo debe ser similar al siguiente:

org . quartz . j obStore . d r i v e rDe l ega t eC la s s = org . quartz . impl .j d b c j o b s t o r e . PostgreSQLDelegate

20

6 Configurar servidor Apache-Tomcat

Para configurar los ajustes del servidor Apache-Tomcat para la plataforma Pentaho

BI, la mayorıa de los cambios se realizan en el archivo web.xml que se encuentra en el

directorio tomcat/webapps/pentaho/WEB INF/.

Usted puede configurar los siguientes elementos (y mas) para la plataforma Pentaho

BI:

pentaho-solutions location

URL

Deshabilitar base de datos HSQL al inicio

TrustedIpAddrs n(opcional - para la consola de administracion y si se esta acce-

diendo al servidor remoto)

Si esta satisfecho con la siguiente configuracion para el servidor Pentaho BI usted no

tendra que realizar ningun cambio en el archivo.

6.1. solution-path

El parametro solution-path permite a la Plataforma de Pentaho BI saber donde localizar

el directorio pentaho-solutions. Por defecto se establece en el directorio /opt/biserver-

ce/pentaho/.


<context−param><param−name>s o lu t i on−path</param−name><param−value>/ opt /pentaho/pentaho−s o l u t i o n s /</param−value>

</ context−param>

21

6.2. fully-qualified-server-url

Si esta satisfecho cuando visita la URL http://localhost:8080/pentaho para acceder a

la plataforma Pentaho BI no necesita cambiar este parametro, sin embargo si usted

desea que otros accedan al sitio (de forma remota o en una red) usted necesita realizar

cambios en este parametro.


<param−value> h t t p : // l o c a l h o s t : 8 0 8 0 /pentaho/ </ param−value>


<param−value> h t t p : //www. pagina . com:8080/pentaho/ </ param−value>

o

<param−value> h t t p : //192 . 168 . 1 . 100 :8080 /pentaho/ </ param−value>

6.3. Deshabilitar base de datos HSQL al inicio

Por defecto con la base de datos HSQL inicia automaticamente, para prevenir esto se

localizan estos fragmentos de codigo:

< !−− [BEGIN HSQLDB DATABASES] −−><context−param>

<param−name>hsqldb−databases</param−name><param−value>sampledata@ . . / . . / data / hsqldb / sampledata ,

hibernate@ . . / . . / data / hsqldb / hibernate , quartz@ . . / . . / data /hsqldb / quartz<$

</context−param>< !−− [END HSQLDB DATABASES] −−>

22

< !−− [BEGIN HSQLDB STARTER] −−>< l i s t e n e r>

< l i s t e n e r −c l a s s>Sta r tupL i s t ene rorg . pentaho . p lat form . web . http . context . Hsq ldbStartupLis tener</

l i s t e n e r −c l a s s></ l i s t e n e r>< !−− [END HSQLDB STARTER] −−>

Se realizan algunos cambios y los codigos debe ser similares a los siguientes:

< !−− [BEGIN HSQLDB DATABASES] −−>< !−− <context−param>

<param−name>hsq ldb−da tabases</param−name><param−value>sampledata@ . . / . . / data / h s q l d b / sampledata ,

hibernate@ . . / . . / data / h s q l d b / h ibernate , quartz@ . . / . . / data /h s q l d b / quar t z<$

</context−param> −−>< !−− [END HSQLDB DATABASES] −−>

< !−− [BEGIN HSQLDB STARTER] −−>< !−− < l i s t e n e r>

< l i s t e n e r −c l a s s>S ta r tupL i s t ene rorg . pentaho . p la t form . web . h t t p . con t ex t . Hsq l d bS ta r tupL i s t ene r</

l i s t e n e r −c l a s s></ l i s t e n e r> −−>< !−− [END HSQLDB STARTER] −−>

6.4. TrustedIpAddrs

Si desea acceder a su servidor Apache-Tomcat remotamente por lo que en el paso

anterior no ha especificado localhost o 127.0.0.1 para el parametro de base-url - usted

tendra que agregar la direccion IP de su servidor Apache-Tomcat a esta lista.

Abra el archivo y localice esta lınea de codigo:


<param−name>TrustedIpAddrs</param−name><param−value>1 2 7 . 0 . 0 . 1</param−value>

23

Se realizan algunos cambios y los codigos debe ser similares a los siguientes:

<param−name>TrustedIpAddrs</param−name><param−value>1 2 7 . 0 . 0 . 1 , [ y o u r i p a d d r e s s ]</param−value>

Esto permitira a la administracion de la consola Pentaho hacer ’ping’ al servidor para

ver si es hacia arriba o abajo, no es necesario hacer esto si tu hosting es servidor local.

6.5. Otros parametros

Tambien puede cambiar el idioma local y pais en el archivo web.xml, los cambios en

estos parametros se explica por sı mismo.

24

7 Configurando SMTP (servidor de correo)

Para configurar la plataforma Pentaho BI para utilizar un servidor SMTP (servidor de

correo) que se utilizara para enviar informes por correo electronico, se necesitan hacer

modificaciones al archivo /pentaho-solutions/system/smtp-email/email config.xml.

Estos son los parametros disponibles que se pueden configurar para que soporte SMTP:

mail.smtp.host: Esta es la direccion de su servidor de correo electronico SMTP para

el envıo de correo electronico por ejemplo: smtp.gmail.com.

mail.smtp.port: Este es el puerto de su servidor de correo electronico SMTP, para

GMail es el 587.

mail.transport.protocol: El transporte para acceder al servidor de correo. Usual-

mente es smtp, para GMail es smtps.

mail.smtp.starttls.enable: Si el servidor SMTP utiliza autenticacion TTLS coloca-

mos ese parametro en ‘true’, para GMail es ‘true’.

mail.smtp.auth: Colocar en ‘true’ si el remitente del servidor de correo requiere au-

tentificarse.

mail.smtp.ssl: Se coloca en ‘true’ si el servidor de correo electronico requiere una

conexion SSL, para GMail es ‘true’.

mail.debug: Salida de informacion de depuracion de la API JavaMail.

mail.pop3: No se esta utilizando.

mail.from.default: La direccion de los correos electronicos de la plataforma Pentaho

BI por ejemplo, [email protected].

mail.userid: El ID de usuario que se utiliza para autenticar con el servidor SMTP,

mail.smtp.auth se debe establecer en ‘true’.

25

mail.password: La contrasena que se utiliza para autenticar con el servidor SMTP,

mail.smtp.auth se debe establecer en ‘true’.

El siguiente es un ejemplo del archivo smtp-email.xml configurado para GMail:

<email−smtp><p r o p e r t i e s>

<mail . smtp . host>smtp . gmail . com</ mail . smtp . host><mail . smtp . port>587</ mail . smtp . port><mail . t r an spo r t . p ro to co l>smtps</ mail . t r anspor t . p ro to co l><mail . smtp . s t a r t t l s . enable>t rue</ mail . smtp . s t a r t t l s . enable><mail . smtp . auth>t rue</ mail . smtp . auth><mail . smtp . s s l>t rue</ mail . smtp . s s l><mail . smtp . qu i twa i t> f a l s e</ mail . smtp . qu i twa i t>

</ p r o p e r t i e s><mail . pop3></ mail . pop3><mail . from . default>ejemplo@gmail . com</ mail . from . default><mail . u s e r i d>ejemplo@gmail . com</ mail . u s e r i d><mail . password>password</ mail . password>

</ email−smtp>

26

8 Configurando publicacion

Por defecto publicacion no esta habilitada, para habilitarla debera especificar una con-

trasena que debera ser utilizada para publicar. Para comenzar se tiene que editar

el archivo publisher config.xml que se encuentra ubicado en el directorio /pentaho-

solutions/system/


<pub l i she r−c o n f i g><pub l i she r−password></ pub l i she r−password>

</ pub l i she r−c o n f i g>

Se ingresa un password entre la etiquetas publisher-password (esta contrasena sera la

misma para todos los usuarios). El codigo debe quedar similar al siguiente (en este caso

la contrasena es ’password’):

<pub l i she r−c o n f i g><pub l i she r−password>password</ pub l i she r−password>

</ pub l i she r−c o n f i g>

A partir de ahora, cuando un usuario intenta publicar contenido en la plataforma Pen-

taho BI se tendra que especificar la contrasena.

27

9 Configuracion de la consola de administracion

Para configurar la Consola de administracion de PostgreSQL se tiene que descargar el

driver JDBC para PostgreSQL.

Para colocar el conector JDBC se procede a descargar el archivo “postgresql-9.2-1002.jdbc4.jar”

en el directorio “/administration-console/jdbc/”, para ello se ejecuta lo siquiente en la

terminal:

# cd /opt /pentaho/ admin i s t ra t ion−conso l e / jdbc /# wget h t t p :// jdbc . p o s t g r e s q l . org /download/ po s t g r e s q l −9.2−1002.

jdbc4 . j a r

28

10 Cuenta de Usuario

Por razones de seguridad, se debe considerar la creacion de un usuario independiente

cuenta para ejecutar las aplicaciones del servidor, como Pentaho. Normalmente, la cuen-

ta de usuario puede tambien ser dueno del directorio que contiene el software. Ademas,

esta cuenta de usuario podrıa ser bloqueada del resto del sistema. Esto es una cuestion

de errores: un bug en el software o un servidor simplemente hackeado no puede hacer

ningun dano fuera de su propio directorio del software, es decir, la cuenta de usuario

reservado para Pentaho no tiene ningun permiso fuera del arbol del directorio Pentaho.

Para configurar un cuenta de usuario, grupo, en una terminal se ejecuta lo siguiente:

# addgroup pentahoAdding group ’ p e n t a h o (GID 1001) . . .

# adduser −−system −−ingroup pentaho −−d i sab l ed−l o g i n pentahoAdding system user ’ p e n t a h o (UID 115) . . .Adding new user ’ p e n t a h o (UID 115) with group ’ p e n t a h o . . .Creat ing home d i r e c t o r y ’/home/ p e n t a h o . . .

Ahora se cambia de dueno a la carpeta Pentaho, en una terminal se ejecuta lo siguiente:

# chown pentaho : pentaho −R /opt /pentaho

29

11 Iniciar la Plataforma Pentaho BI

Para iniciar la plataforma Pentaho BI en una terminal se ejecuta el siguiente comando

“start-pentaho.sh” que se encuentra en el directorio /opt/pentaho/biserver-ce de la si-

guiente manera en la terminal:

# cd /opt /pentaho/ b i s e r v e r−ce# sudo −u pentaho ./ s t a r t−pentaho . sh/ opt /pentaho/ b i s e rv e r−ce/ opt /pentaho/ b i s e rv e r−ceWARNING: Using java from pathDEBUG: PENTAHO JAVA HOME=DEBUG: PENTAHO JAVA=javaUsing CATALINA BASE: / opt /pentaho/ b i s e rv e r−ce /tomcatUsing CATALINA HOME: / opt /pentaho/ b i s e rv e r−ce /tomcatUsing CATALINA TMPDIR: / opt /pentaho/ b i s e rv e r−ce /tomcat/tempUsing JRE HOME: / usrUsing CLASSPATH: / opt /pentaho/ b i s e rv e r−ce /tomcat/ bin /

boots t rap . j a r

Nota: 1

Ahora ya se puede visitar la direccion http://localhost:8080 y aparecera una panta-

lla la en la cual se debe ingresar el usuario y la contrasena, la cual se encuentra haciendo

click en el boton “Evaluation Login” como lo muestra la Figura 11.1.

Para parar la plataforma Pentaho BI en una terminal se ejecuta el siguiente comando

“stop-pentaho.sh” que se encuentra en el mismo directorio de la siguiente manera en la

terminal:

1Tenga en cuenta el comando sudo pentaho -u garantiza que el comando sera ejecutado con lospermisos del usuario pentaho. Si se omite, el servidor se ejecutara con permisos de root y eso se quiereevitar como se dijo en el anterior apartado. automaticamente cuando se inicia el sistema operativo.

30

http://localhost:8080

Figura 11.1: Pantalla Inicial Plataforma Pentaho BI

# sudo −u pentaho ./ stop−pentaho . sh/ opt /pentaho/ b i s e rv e r−ce/ opt /pentaho/ b i s e rv e r−ceWARNING: Using java from pathDEBUG: PENTAHO JAVA HOME=DEBUG: PENTAHO JAVA=javaUsing CATALINA BASE: / opt /pentaho/ b i s e rv e r−ce /tomcatUsing CATALINA HOME: / opt /pentaho/ b i s e rv e r−ce /tomcatUsing CATALINA TMPDIR: / opt /pentaho/ b i s e rv e r−ce /tomcat/tempUsing JRE HOME: / usrUsing CLASSPATH: / opt /pentaho/ b i s e rv e r−ce /tomcat/ bin /

boots t rap . j a r

31

12 Iniciar la Plataforma Pentaho BI Automaticamente

Para iniciar la plataforma Pentaho BI cuando se inicia el sistema, se realiza un script

llamado “pentaho-init.sh” con el siguiente contenido:

#!/ bin / sh# go to the pentaho homecd / opt /pentaho/ b i s e rv e r−ce

# se t up command fo r pentaho user , s e t java environmentcmd=”sudo −u pentaho JAVA HOME=/opt /jvm/ JAVA OPTS=−Djava . awt .

head l e s s=true ”case ”$1” in

s t a r t )# run the o r i g i n a l pentaho s t a r t s c r i p t$cmd . / s ta r t−pentaho . sh >> pentaho−demo . l og &

; ;stop )# run the o r i g i n a l pentaho s t a r t s c r i p t$cmd . / stop−pentaho . sh >> pentaho−demo . l og &

; ;r e s t a r t )

$0 stop$0 s t a r t

; ;∗)

echo ”Usage : $0 { s t a r t | stop | r e s t a r t }”exit 1

esacexit 0

Este script debe ser copiado en el directorio /etc/init.d, se lo copia de la siguiente

manera en la terminal:

# cp pentaho−i n i t . sh / e t c / i n i t . d

32

Para comprobar su funcionamiento, se puede comprobar de la siguiente manera en la

terminal:

# cp / e t c / i n i t . d/# ./ pentaho−i n i t . shUsage : . / pentaho− i n i t . sh { s t a r t | stop | r e s t a r t }# ./ pentaho−i n i t . sh s top# ./ pentaho−i n i t . sh s t a r t

Para indicar que el script se ejecute durante el arranque del sistema, se ejecuta lo si-

guiente en la terminal:

# update−rc . d pentaho−i n i t . sh d e f a u l t s

Para eliminar un servicio previamente instalado se usa el parametro -f de la siguiente

manera en la terminal:

# update−rc . d −f pentaho−i n i t . sh remove

33

13 Iniciar la consola de Administracion

Para iniciar la consola de Administracion en una terminal se ejecuta el siguiente co-

mando ’start-pac.sh’ que se encuentra en el directorio “/opt/pentaho/administration-

console” de la siguiente manera en la terminal:

# cd /opt /pentaho/ admin i s t ra t ion−conso l e# sudo −u pentaho ./ s t a r t−pac . sh09 :26 : 28 , 749 INFO [ Je t tySe rve r ] Console i s now s t a r t e d . I t can be

acce s s ed us ing http :// poldrosky−l aptop :8099 or http: / / 1 2 7 . 0 . 1 . 1 : 8 0 9 9

Ahora ya se puede visitar la direccion http://localhost:8099 Se le pedira un nombre

de usuario y contrasena que por defecto son “admin” y “password”. Si se ha iniciado y

conectado a la consola de administracion debiera ver la pantalla de bienvenida como lo

muestra la Figura 13.1.

Figura 13.1: Pantalla Inicial Consola de Administracion

34

http://localhost:8099

Guia Penta Ho

Documents

Transcript of Guia Penta Ho