PENTAHO BUSINESS INTELLIGENCE SUITE 4.5 UNA GUIA PARA COMENZAR CON POSTGRESQL 9.

1 Y GNU/LINUX

OMAR CABRERA ROSERO

UNIVERSIDAD DE NARINO FACULTAD DE INGENIER IA DE SISTEMAS PROGRAMA DE INGENIERIA SAN JUAN DE PASTO 2012

You are free: to Share to copy, distribute and transmit this work to Remix to adapt this work Under the following conditions: Attribution You must attribute the work in the manner specied by the author or licensor (but not in any way that suggests that they endorse you or your use of the work) Share Alike If you alter, transform, or build upon this work, you may distribute the resulting work only under the same or similar license to this one. 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 Francisco, California, 94105, USA.

CONTENIDO

1. Comenzando Instalacin o 1.1. Instalacin Java de Oracle o 1.2. Instalacin y conguracin de PostgreSQL 9.1 Server o o 2. Implementacin de la plataforma o 2.1. PostgreSQL Java Conector 2.2. SQL Script Pack 3. Congurando la Base de Datos 3.1. Extraer el paquete de scripts para postgreSQL 3.2. Cargando los scritps SQL 4. Congurando Seguridad JDBC 4.1. applicationContext-spring-security-jdbc.xml 4.2. applicationContext-spring-security-hibernate.properties 4.3. hibernate-settings.xml 4.4. postgresql.hibernate.cfg.xml (opcional)

7 7 8 11 11 12 13 13 13 16 16 17 17 18

5. Congurar Hibernate y Quartz 5.1. context.xml y pentaho.xml 5.2. quartz.properties 6. Congurar servidor Apache-Tomcat 6.1. solution-path 6.2. fully-qualied-server-url 6.3. Deshabilitar base de datos HSQL al inicio 6.4. TrustedIpAddrs 6.5. Otros parametros 7. Congurando SMTP (servidor de correo) 8. Congurando publicacin o 9. Conguracin de la consola de administracin o o 10. uenta de Usuario C 11. niciar la Plataforma Pentaho BI I 12. niciar la Plataforma Pentaho BI Automticamente I a 13. niciar la consola de Administracin I o

19 19 20 21 21 22 22 23 24 25 27 28 29 30 32 34

INTRODUCCION

Pentaho BI Platform Community Edition (CE), proporciona la arquitectura y la infraestructura necesarios para crear soluciones para problemas de inteligencia de negocios (BI). El framework proporciona servicios bsicos como la autenticacin, registro, audia o tor servicios web y motores de reglas. La plataforma tambin incluye un motor de a, e solucin que integra la presentacin de informes, anlisis, cuadros de mando y los como o a ponentes de miner de datos. El diseo modular y basado en arquitectura de plugin a n permite que toda o parte de la plataforma sea embebida en aplicaciones de terceros por los usuarios nales, as como OEMs. La aplicacin ms conocida de la Plataforma de BI es el Pentaho BI server que funo a ciona como sistema manejador de reportes basado en la web el informe, el servidor de integracin de aplicaciones y el motor de ujo de trabajo ligero (secuencias de accin.) o o Est diseado para facil integracin en cualquier proceso de negocio. a n o Community Edition es un software libre de cdigo abierto soportado. La Enterprise o Edition (EE) de la Pentaho BI plataform est disponible como parte de la Pentaho BI a Suite EE que incluye soporte tcnico, manejador de actualizaciones y caracter e sticas de la empresa. Para obtener ms informacin acerca de la EE o para demos y hojas de a o 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 avanzados en su conguracin de eleccin y conocimientos bsicos de Pentaho (aunque no o o a es necesario). Los siguientes sistemas operativos y base de datos son soportados:

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

Windows MySQL PostgreSQL Oracle GNU/Linux MySQL PostgreSQL Oracle Esta guia es para congurar 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 Roland Boumen y Jos van Dongen
3 2

y el libro de

2 3

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

1 Comenzando Instalacin o

1.1.

Instalacin Java de Oracle o

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:
$ j a v a v e r s i o n j a v a v e r s i o n 1 . 7 . 0 07 Java (TM) SE Runtime Environment ( b u i l d 1 . 7 . 0 07b10 ) Java HotSpot (TM) 64 B i t S e r v e r VM ( b u i l d 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-7u7linux-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 j d k 7u7l i n u x x64 . t a r . g z / o p t # t a r x v f j d k 7u7l i n u x x64 . t a r . g z

Se cambia el nombre a la carpeta que se descomprimi o

# mv j d k 1 . 7 . 0 0 7 jvm

Luego se ejecutan los siguientes comandos

# updatea l t e r n a t i v e s i n s t a l l / u s r / b i n / j a v a j a v a / o p t / jvm/ j r e / b i n / j a v a 1 # updatea l t e r n a t i v e s i n s t a l l / u s r / b i n / j a v a j a v a / o p t / jvm/ b i n / j a v a 1 # updatea l t e r n a t i v e s i n s t a l l / u s r / b i n / j a v a c j a v a c / o p t /jvm/ b i n / j a v a c 1 # updatea l t e r n a t i v e s i n s t a l l / u s r / b i n / javaws javaws / o p t /jvm/ b i n / javaws 1 # updatea l t e r n a t i v e s c o n f i g j a v a

El siguiente paso es congurar 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 congurada, 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 congurada correctamente.

1.2.

Instalacin y conguracin de PostgreSQL 9.1 Server o o

Para la instalacin de PostgreSQL 9.1 (Para Debian/Linux), en una terminal se ejecuta o los siguiente:
$ su # aptg e 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 c o n t r i b pgadmin3

Ahora se borra la contrasea para la cuenta de adminitrador de postgres para ello se n ejecuta lo siguiente en la linea de comandos. 8

# su p o s t g r e s c p s q l t e m p l a t e 1 t e m p l a t e 1=# ALTER USER p o s t g r e s WITH PASSWORD p o s t g r e s 1 ; t e m p l a t e 1=#\q

Eso altera la contrasea dentro de la base de datos, ahora se tiene que hacer lo mismo n para el usuario postgres y colocar la misma contrasea que utiliz anteriormente. n o
# passwd d p o s t g r e s #su p o s t g r e s c passwd

Para congurar el paquete de administracin de PostgreSQL que permite un mejor reo gistro y supervisin dentro de pgAdmin se ejecuta lo siguiente en la terminal. o
# su p o s t g r e s c p s q l < / u s r / s h a r e / p o s t g r e s q l / 9 . 1 / e x t e n s i o n / 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 t c / p o s t g r e s q l / 9 . 1 / main/ p o s t g r e s q l . c o n f

Al nal del archivo agregamos las siguientes lineas: listen addresses = * password encryption = on Ahora se debe denir quin puede acceder al servidor, para ello se modica el archivo e pg hba.conf.
nano / e t c / p o s t g r e s q l / 9 . 1 / main/ pg hba . c o n f

Debe quedar algo similar a lo siguiente:

# DO NOT DISABLE ! # I f you change t h i s f i r s t e n t r y you w i l l need t o make s u r e # that the # database # s u p e r u s e r can a c c e s s t h e d a t a b a s e u s i n g some o t h e r method . # Noninteractive # access to a l l databases i s required during automatic # maintenance # ( autovacuum , d a i l y c r o n j o b , r e p l i c a t i o n , # and s i m i l a r t a s k s ) . # # Database a d m i n i s t r a t i v e l o g i n by UNIX s o c k e t s local all postgres md5 # TYPE DATABASE USER CIDRADDRESS METHOD # l o c a l i s f o r Unix domain s o c k e t c o n n e c t i o n s o n l y local all all # IPv4 l o c a l c o n n e c t i o n s : host all all 127.0.0.1/32 # IPv6 l o c a l c o n n e c t i o n s : host all all ::1/128 # C o n n e c t i o n s f o r a l l PCs on t h e s u b n e t # # TYPE DATABASE USER IPADDRESS IP MASK METHOD host all all [ ip address ] [ s u b n e t mask ]

md5 md5 md5

md5

En la ultima l nea, agrega su mscara de subred (por ejemplo, 255.255.255.0) y la a direccin IP de la mquina que usted desea tener acceso a su servidor (por ejemplo, o a 192.168.1.104). Sin embargo, si usted desea permitir el acceso a un rango de direcciones IP, Se sustituye el ultimo nmero por un cero y todas las mquinas dentro de ese rango u a se permitir el acceso (por ejemplo, 192.168.1.0 permitir a todos los equipos con una a a direccin IP 192.168.1.X para usar el servidor de base de datos). o 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 Implementacin de la plataforma o

Hay muchas maneras de implementar la plataforma, con Apache-Tomcat que viene con el archivo de instalacin del servidor Pentaho BI o con un servidor existente Apacheo Tomcat. En esta gu se impletentar con el servidor Apache-Tomcat que viene con el servidor a a 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 / o p t / p e n t a h o mv b i s e r v e r ce 4.5.0 s t a b l e . t a r . g z / o p t / p e n t a h o cd / o p t / p e n t a h o t a r 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 . g z

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

# cd / o p t / p e n t a h o / b i s e r v e r ce / tomcat / l i b # wget h t t p : / / j d b c . p o s t g r e s q l . o r g / download / p o s t g r e s q l 9.2 1002. jdbc4 . jar

2.2.

SQL Script Pack

Un paquete de scripts SQL es un conjunto de secuencias de comandos SQL para congurar todas las bases de datos necesarias. El paquete de scripts SQL para PostgreSQL se lo puede descargar aqu .

12

3 Congurando la Base de Datos

3.1.

Extraer el paquete de scripts para postgreSQL

Despus de descargar el paquete los scripts SQL para PostgreSQL se tienen que extraer e los archivos en una ubicacin temporal. Estas son los cinco scripts SQL que deben ser o visibles despus de que el paquete ha sido extra e 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, asegrese de que coloca todos los scripts SQL en el directorio que u iniciar la sesin en la consola de PostgreSQL, en este caso /home/pentaho/tmp/. a o Luego para ejecutar los scritps en una terminal ejecutamos:

13

# cd /home/ p e n t a h o /tmp # p s q l username=p o s 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 l Password f o r u s e r p o s t g r e s : . . . output Password f o r u s e r h i b u s e r : [ e n t e r password ] # p s q l username=p o s 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 l Password f o r u s e r p o s t g r e s : . . . output Password f o r u s e r p e n t a h o u s e r : [ e n t e r password ] # p s q l username=p o s t g r e s f 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 . sql create sample datasource postgresql . sql Password f o r u s e r p o s t g r e s : Password f o r u s e r h i b u s e r : [ e n t e r password ] . . . output # p s q l username=p o s t g r e s f 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 Password f o r u s e r p o s t g r e s : Password f o r u s e r h i b u s e r : [ e n t e r password ] . . . output # p s q l username=p o s t g r e s f 5 s a m p l e d a t a p o s t g r e s q l . s q l Password f o r u s e r p o s t g r e s : . . . output

Ejecutando los anteriores scripts se crean tres base de datos hibernate, quartz y sampledata con las siguientes tablas: hibernate
1

List of relations Schema | Name | Type | Owner +++ public | authorities | table | hibuser public | datasource | table | hibuser public | granted authorities | table | hibuser public | users | table | hibuser

Hibernate crea nuevas tablas en la base de datos hibernate despus de que la plataforma Pentaho e BI inicia por primera vez.

14

quartz
List of relations Schema | Name | Type | Owner +++ public | qrtz blob triggers | table | pentaho user public | qrtz calendars | table | pentaho user public | qrtz cron triggers | table | pentaho user public | q r t z f i r e d t r i g g e r s | table | pentaho user public | qrtz job det ails | table | pentaho user public | q r t z j o b l i s t e n e r s | table | pentaho user public | qrtz locks | table | pentaho user public | qrtz paused trigger grps | table | pentaho user public | qrtz scheduler state | table | pentaho user public | qrtz simple triggers | table | pentaho user public | q r t z t r i g g e r l i s t e n e r s | table | pentaho user public | qrtz triggers | table | pentaho user

sampledata
List of relations Schema | Name | Type | Owner +++ public | customer w ter | table | postgres public | customers | table | postgres p u b l i c | department managers | t a b l e | p o s t g r e s p u b l i c | employees | table | postgres public | o f f i c e s | table | postgres public | orderdetails | table | postgres public | orderfact | table | postgres public | orders | table | postgres p u b l i c | payments | table | postgres public | products | table | postgres public | quadrant actuals | table | postgres p u b l i c | time | table | postgres public | trial balance | table | postgres

15

4 Congurando Seguridad JDBC

En esta seccin se describe cmo congurar la seguridad de la plataforma Pentaho o o BI JDBC que se utiliza en el servido PostgreSQL, esto signica que la plataforma de Pentaho BI ahora apuntar a la base de datos hibernate en el servidor PostgreSQL en a 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 cdigo: o
< ! This i s o n l y f o r H y p e r s o n i c . P l e a s e u p d a t e t h i s s e c t i o n f o r any o t h e r d a t a b a s e you a r e u s i n g > <bean i 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 . DriverManagerDataSource > <p r o p e r t y name= d r iv er C la s s Na 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 y name= 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 y name= username v a l u e = h i b u s e r /> <p r o p e r t y name= password v a l u e = password /> </bean>

Se realizan algunos cambios en la seccin y el cdigo debe ser similar al siguiente: o o

16

< ! This i s o n l y f o r H y p e r s o n i c . P l e a s e u p d a t e t h i s s e c t i o n f o r any o t h e r d a t a b a s e you a r e u s i n g > <bean i 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 . DriverManagerDataSource > <p r o p e r t y name= d r iv er C la s s Na 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 y name= 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 y name= username v a l u e = h i b u s e r /> <p r o p e r t y name= password v a l u e = password /> </ bean>

4.2.

applicationContext-spring-security-hibernate.properties

Este archivo esta esta localizado en el directorio pentaho-solutions/system/ Una vez abierto el archivo se localiza este fragmento de cdigo: o
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 . username=h i b u s e r j d b c . password=password 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 . HSQLDialect

Se realizan algunos cambios en la seccin y el cdigo debe ser similar al siguiente: o o

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 . username=h i b u s e r j d b c . password=password 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

4.3.

hibernate-settings.xml

Este archivo esta esta localizado en el directorio pentaho-solutions/system/hibernate/ Una vez abierto el archivo se localiza este fragmento de cdigo: o

17

<c o n f i g f i l e>system / 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 . xml</ c o n f i g f i l e>

Se realizan algunos cambios en la seccin y el cdigo debe ser similar al siguiente: o o

<c o n f i g f i l e>system / 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 . xml</ c o n 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 ningn cambio en este archivo si desea utilizar el usuario u hibuser por defecto (que fue creado con el archivo 4 load sample users postgresql.sql). Sin embargo, si usted desea especicar su propio usuario buscar y cambiar las siguientes dos l neas de cdigo: o
<p r o p e r t y name= c o n n e c t i o n . username >h i b u s e r</ p r o p e r t y> <p r o p e r t y name= c o n n e c t i o n . password >password</ p r o p e r t y>

Realice los cambios con un nombre de usuario y la contrasea de su eleccin. n o

18

5 Congurar Hibernate y Quartz

Hibernate y Quartz necesitan especicame 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 cdigo: o
<?xml version = 1 . 0 e n c o d i n g = UTF8 ?> <Context path = / pentaho d o c b a s e = webapps / pentaho / > <Resource name= j d b c / H i b e r n a t e auth = C o n t a i n e r type = j a v a x . s q l . DataSource f a c t o r y = o r g . apache . commons . dbcp . B a s i c D a t a S o u r c e F a c t o r y maxActive = 20 maxIdle = 5 maxWait = 10000 username = h i b u s e r password = password d ri v er C la s sN a me = 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 t count ( ) from INFORMATION SCHEMA. SYSTEM SEQUENCES /> <Resource name= j d b c / Quartz auth = C o n t a i n e r type = j a v a x . s q l . DataSource f a c t o r y = o r g . apache . commons . dbcp . B a s i c D a t a S o u r c e F a c t o r y maxActive = 20 maxIdle = 5 maxWait = 10000 username = p e n t a h o u s e r password = password d ri v er C la s sN a me = 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 t count ( ) from INFORMATION SCHEMA. SYSTEM SEQUENCES /> </ Context>

Se realizan algunos cambios en la seccin y el cdigo debe ser similar al siguiente: o o 19

<?xml version = 1 . 0 e n c o d i n g = UTF8 ?> <Context path = / pentaho d o c b a s e = webapps / pentaho / > <Resource name= j d b c / H i b e r n a t e auth = C o n t a i n e r type = j a v a x . s q l . DataSource f a c t o r y = o r g . apache . commons . dbcp . B a s i c D a t a S o u r c e F a c t o r y maxActive = 20 maxIdle = 5 maxWait = 10000 username = h i b u s e r password = password d ri v er C la s sN a me = 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 t 1 /> <Resource name= j d b c / Quartz auth = C o n t a i n e r type = j a v a x . s q l . DataSource f a c t o r y = o r g . apache . commons . dbcp . B a s i c D a t a S o u r c e F a c t o r y maxActive = 20 maxIdle = 5 maxWait = 10000 username = p e n t a h o u s e r password = password d ri v er C la s sN a me = 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 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 / pentahosolutions/system/. Buscar el siguiente fragmento de cdigo: o
#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 =

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

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 . impl . j d b c j o b s t o r e . PostgreSQLDelegate

20

6 Congurar servidor Apache-Tomcat

Para congurar los ajustes del servidor Apache-Tomcat para la plataforma Pentaho BI, la mayor de los cambios se realizan en el archivo web.xml que se encuentra en el a directorio tomcat/webapps/pentaho/WEB INF/. Usted puede congurar los siguientes elementos (y ms) para la plataforma Pentaho a BI: pentaho-solutions location URL Deshabilitar base de datos HSQL al inicio TrustedIpAddrs n(opcional - para la consola de administracin y si se est acce o a diendo al servidor remoto) Si est satisfecho con la siguiente conguracin para el servidor Pentaho BI usted no a o tendr que realizar ningn cambio en el archivo. a u

6.1.

solution-path

El parmetro solution-path permite a la Plataforma de Pentaho BI saber dnde localizar a o el directorio pentaho-solutions. Por defecto se establece en el directorio /opt/biserverce/pentaho/. Se realizan algunos cambios y el cdigo debe ser similar al siguiente: o
<c o n t e x t param> <paramname>s o l u t i o n path</paramname> <paramv a l u e>/ opt / pentaho / pentahos o l u t i o n s /</paramv a l u e> </ c o n t e x t param>

21

6.2.

fully-qualied-server-url

Si est satisfecho cuando visita la URL http://localhost:8080/pentaho para acceder a a la plataforma Pentaho BI no necesita cambiar este parmetro, sin embargo si usted a desea que otros accedan al sitio (de forma remota o en una red) usted necesita realizar cambios en este parmetro. a Buscar el siguiente fragmento de cdigo: o
<paramv a l u e> h t t p : // l o c a l h o s t : 8 0 8 0 / pentaho / </ paramv a l u e>

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

<paramv a l u e> h t t p : //www. p a g i n a . com:8080 / pentaho / </ paramv a l u e>

o
<paramv a l u e> h t t p : / / 1 9 2 . 1 6 8 . 1 . 1 0 0 : 8 0 8 0 / pentaho / </ paramv a l u e>

6.3.

Deshabilitar base de datos HSQL al inicio

Por defecto con la base de datos HSQL inicia automticamente, para prevenir esto se a localizan estos fragmentos de cdigo: o
< ! [BEGIN HSQLDB DATABASES] > <c o n t e x t param> <paramname>hsqldbd a t a b a s e s</paramname> <paramv a l u e>sampledata@ . . / . . / data / h s q l d b / sampledata , h i b e r n a t e @ . . / . . / data / h s q l d b / h i b e r n a t e , quartz@ . . / . . / data / h s q l d b / q u a r t z<$ </c o n t e x t 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>S t a r t u p L i s t e n e r o r g . pentaho . p l a t f o r m . web . 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> < ! [END HSQLDB STARTER] >

Se realizan algunos cambios y los cdigos debe ser similares a los siguientes: o
< ! [BEGIN HSQLDB DATABASES] > < ! <c o n t e x t param> <paramname>h s q l d b d a t a b a s e s</paramname> <paramv a l u e>sampledata@ . . / . . / d a t a / h s q l d b / sampledata , 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 , quartz@ . . / . . / d a t a / h s q l d b / q u a r t z<$ </c o n t e x t 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 t a r t u p L i s t e n e r o r g . p e n t a h o . p l a t f o r m . web . 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> > < ! [END HSQLDB STARTER] >

6.4.

TrustedIpAddrs

Si desea acceder a su servidor Apache-Tomcat remotamente por lo que en el paso anterior no ha especicado localhost o 127.0.0.1 para el parmetro de base-url - usted a tendr que agregar la direccin IP de su servidor Apache-Tomcat a esta lista. a o Abra el archivo y localice esta l nea de cdigo: o Buscar el siguiente fragmento de cdigo: o
<paramname>TrustedIpAddrs</paramname> <paramv a l u e>1 2 7 . 0 . 0 . 1</paramv a l u e>

23

Se realizan algunos cambios y los cdigos debe ser similares a los siguientes: o
<paramname>TrustedIpAddrs</paramname> <paramv a l u e> 1 2 7 . 0 . 0 . 1 , [ y o u r i p a d d r e s s ]</paramv a l u e>

Esto permitir a la administracin de la consola Pentaho hacer ping al servidor para a o ver si es hacia arriba o abajo, no es necesario hacer esto si tu hosting es servidor local.

6.5.

Otros parametros

Tambin puede cambiar el idioma local y pais en el archivo web.xml, los cambios en e estos parmetros se explica por s mismo. a

24

7 Congurando SMTP (servidor de correo)

Para congurar la plataforma Pentaho BI para utilizar un servidor SMTP (servidor de correo) que se utilizar para enviar informes por correo electrnico, se necesitan hacer a o modicaciones al archivo /pentaho-solutions/system/smtp-email/email cong.xml. Estos son los parmetros disponibles que se pueden congurar para que soporte SMTP: a mail.smtp.host: Esta es la direccin de su servidor de correo electrnico SMTP para o o el env de correo electrnico por ejemplo: smtp.gmail.com. o o mail.smtp.port: Este es el puerto de su servidor de correo electrnico SMTP, para o GMail es el 587. mail.transport.protocol: El transporte para acceder al servidor de correo. Usualmente es smtp, para GMail es smtps. mail.smtp.starttls.enable: Si el servidor SMTP utiliza autenticacin TTLS colocao mos ese parametro en true, para GMail es true. mail.smtp.auth: Colocar en true si el remitente del servidor de correo requiere autenticarse. mail.smtp.ssl: Se coloca en true si el servidor de correo electrnico requiere una o conexin SSL, para GMail es true. o mail.debug: Salida de informacin de depuracin de la API JavaMail. o o mail.pop3: No se esta utilizando. mail.from.default: La direccin de los correos electrnicos de la plataforma Pentaho o o BI por ejemplo, ejemplo@gmail.com. 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 contrasea que se utiliza para autenticar con el servidor SMTP, n mail.smtp.auth se debe establecer en true. El siguiente es un ejemplo del archivo smtp-email.xml congurado para GMail:
<email smtp> <p r o p e r t i e s> <m a i l . smtp . h o s t>smtp . g m a i l . com</ m a i l . smtp . h o s t> <m a i l . smtp . p o r t>587</ m a i l . smtp . p o r t> <m a i l . t r a n s p o r t . p r o t o c o l>smtps</ 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 . smtp . s t a r t t l s . e n a b l e>t r u e</ m a i l . smtp . s t a r t t l s . e n a b l e> <m a i l . smtp . auth>t r u e</ m a i l . smtp . auth> <m a i l . smtp . s s l>t r u e</ m a i l . smtp . s s l> <m a i l . smtp . q u i t w a i t> f a l s e</ m a i l . smtp . q u i t w a i t> </ p r o p e r t i e s> <m a i l . pop3></ m a i l . pop3> <m a i l . from . default>ejemplo@gmail . com</ m a i l . from . default> <m a i l . u s e r i d>ejemplo@gmail . com</ m a i l . u s e r i d> <m a i l . password>password</ m a i l . password> </ email smtp>

26

8 Congurando publicacin o

Por defecto publicacin no est habilitada, para habilitarla deber especicar una cono a a trasea que deber ser utilizada para publicar. Para comenzar se tiene que editar n a el archivo publisher cong.xml que se encuentra ubicado en el directorio /pentahosolutions/system/ Una vez abierto el archivo se localiza este fragmento de cdigo: o
<p u b l i s h e r c o n f i g> <p u b l i s h e r password></ p u b l i s h e r password> </ p u b l i s h e r c o n f i g>

Se ingresa un password entre la etiquetas publisher-password (esta contrasea sera la n misma para todos los usuarios). El cdigo debe quedar similar al siguiente (en este caso o la contrasea es password): n
<p u b l i s h e r c o n f i g> <p u b l i s h e r password>password</ p u b l i s h e r password> </ p u b l i s h e r c o n f i g>

A partir de ahora, cuando un usuario intenta publicar contenido en la plataforma Pentaho BI se tendr que especicar la contrasea. a n

27

9 Conguracin de la consola de administracin o o

Para congurar la Consola de administracin de PostgreSQL se tiene que descargar el o 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 / 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 / j d b c / # wget h t t p : / / j d b c . p o s t g r e s q l . o r g / download / p o s t g r e s q l 9.2 1002. jdbc4 . jar

28

10 Cuenta de Usuario

Por razones de seguridad, se debe considerar la creacin de un usuario independiente o cuenta para ejecutar las aplicaciones del servidor, como Pentaho. Normalmente, la cuenta de usuario puede tambin ser dueo del directorio que contiene el software. Adems, e n a esta cuenta de usuario podr ser bloqueada del resto del sistema. Esto es una cuestin a o de errores: un bug en el software o un servidor simplemente hackeado no puede hacer ningn dao fuera de su propio directorio del software, es decir, la cuenta de usuario u n reservado para Pentaho no tiene ningn permiso fuera del rbol del directorio Pentaho. u a Para congurar un cuenta de usuario, grupo, en una terminal se ejecuta lo siguiente:
# addgroup p e n t a h o Adding group p e n t a h o

(GID 1 0 0 1 ) . . .

# a d d u s e r system i n g r o u p p e n t a h o d i s a b l e d l o g i n p e n t a h o Adding system u s e r p e n t a h o (UID 1 1 5 ) . . . Adding new u s e r p e n t a h o (UID 1 1 5 ) with group p e n t a h o . . . C r e a t i n g home d i r e c t o r y / home/ p e n t a h o . . .

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

# chown p e n t a h o : p e n t a h o R / o p t / p e n t a h o

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 siguiente manera en la terminal:
# cd / o p t / p e n t a h o / b i s e r v e r ce # sudo u p e n t a h o . / s t a r t p e n t a h o . sh / opt / pentaho / b i s e r v e r c e / opt / pentaho / b i s e r v e r c e WARNING: Using j a v a from path DEBUG: PENTAHO JAVA HOME= DEBUG: PENTAHO JAVA=j a v a Using CATALINA BASE : / opt / pentaho / b i s e r v e r c e / tomcat Using CATALINA HOME: / opt / pentaho / b i s e r v e r c e / tomcat Using CATALINA TMPDIR : / opt / pentaho / b i s e r v e r c e / tomcat /temp Using JRE HOME: / usr Using CLASSPATH: / opt / pentaho / b i s e r v e r c e / tomcat / b i n / bootstrap . jar

Nota:

Ahora ya se puede visitar la direccin http://localhost:8080 y aparecer una pantao a lla la en la cual se debe ingresar el usuario y la contrasea, la cual se encuentra haciendo n 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:

Tenga en cuenta el comando sudo pentaho -u garantiza que el comando ser ejecutado con los a permisos del usuario pentaho. Si se omite, el servidor se ejecutar con permisos de root y eso se quiere a evitar como se dijo en el anterior apartado. automticamente cuando se inicia el sistema operativo. a

30

Figura 11.1: Pantalla Inicial Plataforma Pentaho BI

# sudo u p e n t a h o . / s t o p p e n t a h o . sh / opt / pentaho / b i s e r v e r c e / opt / pentaho / b i s e r v e r c e WARNING: Using j a v a from path DEBUG: PENTAHO JAVA HOME= DEBUG: PENTAHO JAVA=j a v a Using CATALINA BASE : / opt / pentaho / b i s e r v e r c e / tomcat Using CATALINA HOME: / opt / pentaho / b i s e r v e r c e / tomcat Using CATALINA TMPDIR : / opt / pentaho / b i s e r v e r c e / tomcat /temp Using JRE HOME: / usr Using CLASSPATH: / opt / pentaho / b i s e r v e r c e / tomcat / b i n / bootstrap . jar

31

12 Iniciar la Plataforma Pentaho BI Automticamente a

Para iniciar la plataforma Pentaho BI cuando se inicia el sistema, se realiza un script llamado pentaho-init.sh con el siguiente contenido:
#! / b i n / sh # go t o t h e p e n t a h o home cd / opt / pentaho / b i s e r v e r c e # s e t up command f o r p e n t a h o user , s e t j a v a environment cmd= sudo u pentaho JAVA HOME=/opt /jvm/ JAVA OPTS=Djava . awt . h e a d l e s s=t r u e case $1 i n start ) # run t h e o r i g i n a l p e n t a h o s t a r t s c r i p t $cmd . / s t a r t pentaho . sh >> pentahodemo . l o g & ;; stop ) # run t h e o r i g i n a l p e n t a h o s t a r t s c r i p t $cmd . / stoppentaho . sh >> pentahodemo . l o g & ;; restart ) $0 s t o p $0 s t a r t ;; ) echo Usage : $0 { s t a r t | s t o p | r e s t a r t } exit 1 esac ex i t 0

Este script debe ser copiado en el directorio /etc/init.d, se lo copia de la siguiente manera en la terminal:
# cp pentahoi 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/ # . / pentahoi n i t . sh Usage : . / pentahoi n i t . sh { s t a r t | s t o p | r e s t a r t } # . / pentahoi n i t . sh s t o p # . / pentahoi n i t . sh s t a r t

Para indicar que el script se ejecute durante el arranque del sistema, se ejecuta lo siguiente en la terminal:
# updater c . d pentahoi n i t . sh d e f a u l t s

Para eliminar un servicio previamente instalado se usa el parmetro -f de la siguiente a manera en la terminal:
# updater c . d f pentahoi n i t . sh remove

33

13 Iniciar la consola de Administracin o

Para iniciar la consola de Administracin en una terminal se ejecuta el siguiente coo mando start-pac.sh que se encuentra en el directorio /opt/pentaho/administrationconsole de la siguiente manera en la terminal:
# cd / 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 # sudo u p e n t a h o . / s t a r t pac . sh 0 9 : 2 6 : 2 8 , 7 4 9 INFO [ J e t t y S e r v e r ] C o n s o l e i s now s t a r t e d . I t can be a c c e s s e d u s i n g h t t p : / / p o l d r o s k y l a p t o p : 8 0 9 9 o r h t t p ://127.0.1.1:8099

Ahora ya se puede visitar la direccin http://localhost:8099 Se le pedir un nombre o a de usuario y contrasea que por defecto son admin y password. Si se ha iniciado y n conectado a la consola de administracin debiera ver la pantalla de bienvenida como lo o muestra la Figura 13.1. Figura 13.1: Pantalla Inicial Consola de Administracin o

34