PENTAHO BUSINESS INTELLIGENCE SUITE 4.5 UNA GUIA PARA COMENZAR CON POSTGRESQL 9.1 Y GNU/LINUX OMAR CABRERA ROSERO

Transcripción

1 PENTAHO BUSINESS INTELLIGENCE SUITE 4.5 UNA GUIA PARA COMENZAR CON POSTGRESQL 9.1 Y GNU/LINUX OMAR CABRERA ROSERO UNIVERSIDAD DE NARIÑO FACULTAD DE INGENIERÍA PROGRAMA DE INGENIERÍA DE SISTEMAS SAN JUAN DE PASTO 2012

2 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 specified 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 or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.

3 CONTENIDO 1. Comenzando Instalación Instalación Java de Oracle Instalación y configuración de PostgreSQL 9.1 Server 8 2. Implementación de la plataforma PostgreSQL Java Conector SQL Script Pack Configurando la Base de Datos Extraer el paquete de scripts para postgresql Cargando los scritps SQL Configurando Seguridad JDBC applicationcontext-spring-security-jdbc.xml applicationcontext-spring-security-hibernate.properties hibernate-settings.xml postgresql.hibernate.cfg.xml (opcional) 18

4 5. Configurar Hibernate y Quartz context.xml y pentaho.xml quartz.properties Configurar servidor Apache-Tomcat solution-path fully-qualified-server-url Deshabilitar base de datos HSQL al inicio TrustedIpAddrs Otros parametros Configurando SMTP (servidor de correo) Configurando publicación Configuración de la consola de administración Cuenta de Usuario Iniciar la Plataforma Pentaho BI Iniciar la Plataforma Pentaho BI Automáticamente Iniciar la consola de Administración 34

5 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 básicos como la autenticación, registro, auditoría, servicios web y motores de reglas. La plataforma también incluye un motor de solución que integra la presentación de informes, análisis, cuadros de mando y los componentes de minería de datos. El diseño 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 aplicación más conocida de la Plataforma de BI es el Pentaho BI server que funciona como sistema manejador de reportes basado en la web el informe, el servidor de integración de aplicaciones y el motor de flujo de trabajo ligero (secuencias de acción.) Está diseñado para facil integración en cualquier proceso de negocio. Community Edition es un software libre de código abierto soportado. La Enterprise Edition (EE) de la Pentaho BI plataform está disponible como parte de la Pentaho BI Suite EE que incluye soporte técnico, manejador de actualizaciones y características de la empresa. Para obtener más información 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 avanzados en su configuración de elección y conocimientos básicos de Pentaho (aunque no es necesario). Los siguientes sistemas operativos y base de datos son soportados: 1

6 Windows MySQL PostgreSQL Oracle GNU/Linux MySQL PostgreSQL Oracle Esta guia es para configurar Pentaho BI Server 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 Pentaho Solutions: Business Intelligence and Data Warehousing with Pentaho and MySQL

7 1 Comenzando Instalación 1.1. Instalación 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 v e r s i o n java v e r s i o n Java (TM) SE Runtime Environment ( b u i l d b10 ) Java HotSpot (TM) 64 Bit Server 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: 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 i n u x x64. t a r. gz / opt # t a r x v f jdk 7u7 l inux x64. t a r. gz Se cambia el nombre a la carpeta que se descomprimió # mv jdk jvm 7

8 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 / bin / java java / opt / jvm/ j r e / bin / java 1 # update a l t e r n a t i v e s i n s t a l l / usr / bin / 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 / bin / 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 / bin / javaws javaws / opt /jvm/ bin / javaws 1 # update a l t e r n a t i v e s c o n 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 Instalación y configuración de PostgreSQL 9.1 Server Para la instalación de PostgreSQL 9.1 (Para Debian/Linux), en una terminal se ejecuta los siguiente: $ su # apt g 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 contraseña para la cuenta de adminitrador de postgres para ello se ejecuta lo siguiente en la linea de comandos. 8

9 # su p o s t g r e s c p s q l template1 template1=# ALTER USER p o s t g r e s WITH PASSWORD p o s t g r e s 1 ; template1=#\q Eso altera la contraseña dentro de la base de datos, ahora se tiene que hacer lo mismo para el usuario postgres y colocar la misma contraseña que utilizó anteriormente. # passwd d p o s t g r e s #su p o s t g r e s c passwd Para configurar el paquete de administración de PostgreSQL que permite un mejor registro y supervisión dentro de pgadmin se ejecuta lo siguiente en la terminal. # su p o 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/ 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. conf Al final del archivo agregamos las siguientes lineas: listen addresses = * password encryption = on Ahora se debe definir quién puede acceder al servidor, para ello se modifica el archivo pg hba.conf. nano / e t c / p o s t g r e s q l /9.1/ main/ pg hba. conf 9

10 Debe quedar algo similar a lo siguiente: # DO NOT DISABLE! # I f you change t h i s f i r s t entry you w i l l need to make sure # t h a t the # database # super user can a c c e s s the database using some o t h e r method. # N o n i n t e r a c t i v e # a c c e s s to a l l d a t a b a s e s i s r e q u i r e d during automatic # maintenance # ( autovacuum, d a i l y cronjob, 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 a l l p o 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 s o c k e t connections only local a l l a l l md5 # IPv4 l o c a l connections : host a l l a l l / 3 2 md5 # IPv6 l o c a l connections : host a l l a l l : : 1 / md5 # Connections f o r a l l PCs on the subnet # # TYPE DATABASE USER IP ADDRESS IP MASK METHOD host a l l a l l [ ip address ] [ subnet mask ] md5 En la última línea, agrega su máscara de subred (por ejemplo, ) y la dirección IP de la máquina que usted desea tener acceso a su servidor (por ejemplo, ). Sin embargo, si usted desea permitir el acceso a un rango de direcciones IP, Se sustituye el último número por un cero y todas las máquinas dentro de ese rango se permitirá el acceso (por ejemplo, permitiría a todos los equipos con una dirección IP X para usar el servidor de base de datos). Ya por último 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

11 2 Implementación de la plataforma Hay muchas maneras de implementar la plataforma, con Apache-Tomcat que viene con el archivo de instalación del servidor Pentaho BI o con un servidor existente Apache- Tomcat. En esta guía se impletentará con el servidor Apache-Tomcat que viene con el servidor de Pentaho BI, para ello primero se descarga el archivo biserver-ce stable.tar.gz desde 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 s t a b l e. t a r. gz / opt / pentaho # cd / opt / pentaho # t a r x v z f b i s e r v e r ce 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 jdbc4.jar en el directorio /opt/pentaho/biserver-ce/tomcat/lib para ello se ejecuta lo siguiente en la terminal: 11

12 # cd / opt / pentaho / 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. org / download / p o s t g r e s q l j d b c 4. j a r 2.2. SQL Script Pack Un paquete de scripts SQL es un conjunto de secuencias de comandos SQL para configurar todas las bases de datos necesarias. El paquete de scripts SQL para PostgreSQL se lo puede descargar aquí. 12

13 3 Configurando la Base de Datos 3.1. Extraer el paquete de scripts para postgresql Después de descargar el paquete los scripts SQL para PostgreSQL se tienen que extraer los archivos en una ubicación temporal. Estas son los cinco scripts SQL que deben ser visibles después 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 Cargando los scritps SQL Antes de empezar, asegúrese de que coloca todos los scripts SQL en el directorio que iniciará la sesión en la consola de PostgreSQL, en este caso /home/pentaho/tmp/. Luego para ejecutar los scritps en una terminal ejecutamos: 13

14 # cd /home/ pentaho /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 for user p o s t g r e s :... output Password for user 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 for user p o s t g r e s :... output Password for user pentaho user : [ 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. s q l 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 Password for user p o s t g r e s : Password for user 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 for user p o s t g r e s : Password for user 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 for user 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 L i s t o f r e l a t i o n s Schema Name Type Owner p u b l i c a u t h o r i t i e s t a b l e h i b u s e r p u b l i c datasource t a b l e h i b u s e r p u b 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 i b u s e r p u b l i c u s e r s t a b l e h i b u s e r 1 Hibernate crea nuevas tablas en la base de datos hibernate después de que la plataforma Pentaho BI inicia por primera vez. 14

15 quartz L i s t o f r e l a t i o n s Schema Name Type Owner p u b l i c q r t z b l o b t r i g g e r s t a b l e pentaho user p u b l i c q r t z c a l e n d a r s t a b l e pentaho user p u b l i c q r t z c r o n t r i g g e r s t a b l e pentaho user p u b l i c q r t z f i r e d t r i g g e r s t a b l e pentaho user p u b l i c q r t z j o b d e t a i l s t a b l e pentaho user p u b l i c q r t z j o b l i s t e n e r s t a b l e pentaho user p u b l i c q r t z l o c k s t a b l e pentaho user p u b l i c q r t z p a u s e d t r i g g e r g r p s t a b l e pentaho user p u b l i c q r t z s c h e d u l e r s t a t e t a b l e pentaho user p u b l i c q r t z s i m p l e t r i g g e r s t a b l e pentaho user p u b l i c q r t z t r i g g e r l i s t e n e r s t a b l e pentaho user p u b l i c q r t z t r i g g e r s t a b l e pentaho user sampledata L i s t o f r e l a t i o n s Schema Name Type Owner p u b l i c customer w ter t a b l e p o s t g r e s p u b l i c customers t a b l e p o s t g r e s 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 t a b l e p o s t g r e s p u b l i c o f f i c e s t a b l e p o s t g r e s p u b l i c o r d e r d e t a i l s t a b l e p o s t g r e s p u b l i c o r d e r f a c t t a b l e p o s t g r e s p u b l i c o r d e r s t a b l e p o s t g r e s p u b l i c payments t a b l e p o s t g r e s p u b l i c products t a b l e p o s t g r e s p u b l i c q u a d r a n t a c t u a l s t a b l e p o s t g r e s p u b l i c time t a b l e p o s t g r e s p u b l i c t r i a l b a l a n c e t a b l e p o s t g r e s 15

16 4 Configurando Seguridad JDBC En esta sección se describe cómo 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 apuntará a la base de datos hibernate en el servidor PostgreSQL en lugar del paquete de la base de datos HSQL 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 código: <! This i s only f o r Hypersonic. Please update t h i s s e c t i o n f o r any o t h e r database you are using > <bean id = datasource c l a s s = org. springframework. jdbc. datasource. DriverManagerDataSource > <property name= driverclassname value = org. hsqldb. jdbcdriver /> <property name= url value = j d b c : h s q l d b : h s q l : // l o c a l h o s t : / hibernate /> <property name= username value = hibuser /> <property name= password value = password /> </bean> Se realizan algunos cambios en la sección y el código debe ser similar al siguiente: 16

17 <! This i s only f o r Hypersonic. Please update t h i s s e c t i o n f o r any o t h e r database you are using > <bean id = datasource c l a s s = org. springframework. jdbc. datasource. DriverManagerDataSource > <property name= driverclassname value = org. p o s t g r e s q l. Driver /> <property name= u r l value = j d b c : p o s t g r e s q l : // l o c a l h o s t : / h i b e r n a t e /> <property name= username value = h i b u s e r /> <property name= password value = 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 código: jdbc. d r i v e r=org. hsqldb. jdbcdriver jdbc. u r l=jdbc : hsqldb : h s q l : / / l o c a l h o s t :9001/ h i b e r n a t e jdbc. username=h i b u s e r jdbc. password=password h i b e r n a t e. d i a l e c t=org. h i b e r n a t e. d i a l e c t. HSQLDialect Se realizan algunos cambios en la sección y el código debe ser similar al siguiente: jdbc. d r i v e r=org. p o s t g r e s q l. Driver jdbc. 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 i b e r n a t e jdbc. username=h i b u s e r jdbc. password=password h i b e r n a t e. d i a l e c t=org. h i b e r n a t e. 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/ Una vez abierto el archivo se localiza este fragmento de código: 17

18 <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 sección y el código debe ser similar al siguiente: <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 ningún 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 código: <property name= connection. username >h i b u s e r</ property> <property name= connection. password >password</ property> Realice los cambios con un nombre de usuario y la contraseña de su elección. 18

19 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 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 código: <?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= username = h i b u s e r password = password driverclassname = org. hsqldb. jdbcdriver 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 validationquery = s e l e c t count ( ) from INFORMATION SCHEMA. SYSTEM SEQUENCES /> <Resource name= jdbc / Quartz 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= username = pentaho user password = password driverclassname = org. hsqldb. jdbcdriver 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 validationquery = s e l e c t count ( ) from INFORMATION SCHEMA. SYSTEM SEQUENCES /> </ Context> Se realizan algunos cambios en la sección y el código debe ser similar al siguiente: 19

20 <?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= username = h i b u s e r password = password driverclassname = org. p o s t g r e s q l. Driver 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 : / h i b e r n a t e validationquery = s e l e c t 1 /> <Resource name= jdbc / Quartz 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= username = pentaho user password = password driverclassname = org. p o s t g r e s q l. Driver 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 : / quartz validationquery = 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 código: #org. 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 código debe ser similar al siguiente: org. quartz. 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 = org. quartz. impl. j d b c j o b s t o r e. PostgreSQLDelegate 20

21 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 más) para la plataforma Pentaho BI: pentaho-solutions location URL Deshabilitar base de datos HSQL al inicio TrustedIpAddrs ñ(opcional - para la consola de administración y si se está accediendo al servidor remoto) Si está satisfecho con la siguiente configuración para el servidor Pentaho BI usted no tendrá que realizar ningún cambio en el archivo solution-path El parámetro solution-path permite a la Plataforma de Pentaho BI saber dónde localizar el directorio pentaho-solutions. Por defecto se establece en el directorio /opt/biserverce/pentaho/. Se realizan algunos cambios y el código debe ser similar al siguiente: <context param> <param name>s o l u t i o n path</param name> <param value>/ opt / pentaho / pentaho s o l u t i o n s /</param value> </ context param> 21

22 6.2. fully-qualified-server-url Si está satisfecho cuando visita la URL para acceder a la plataforma Pentaho BI no necesita cambiar este parámetro, sin embargo si usted desea que otros accedan al sitio (de forma remota o en una red) usted necesita realizar cambios en este parámetro. Buscar el siguiente fragmento de código: <param value> h t t p : // l o c a l h o s t : / pentaho / </ param value> Se realizan algunos cambios y el código debe ser similar al siguiente: <param value> h t t p : //www. pagina. com:8080 / pentaho / </ param value> o <param value> h t t p : / / :8080 / pentaho / </ param value> 6.3. Deshabilitar base de datos HSQL al inicio Por defecto con la base de datos HSQL inicia automáticamente, para prevenir esto se localizan estos fragmentos de código: <! [BEGIN HSQLDB DATABASES] > <context param> <param name>hsqldb d a t a b a s e s</param name> <param value>sampledata@.. /.. / data / hsqldb / sampledata, hibernate@.. /.. / data / hsqldb / hibernate, quartz@.. /.. / data / hsqldb / quartz<$ </context param> <! [END HSQLDB DATABASES] > 22

23 <! [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 org. pentaho. platform. web. http. context. HsqldbStartupListener</ 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 códigos debe ser similares a los siguientes: <! [BEGIN HSQLDB DATABASES] > <! <context param> <param name>hsqldb d a t a b a s e s</param name> <param value>sampledata@.. /.. / data / h s q l d b / sampledata, hibernate@.. /.. / data / h s q l d b / hibernate, quartz@.. /.. / data / h s q l d b / q u a r 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 t a r t u p L i s t e n e r org. 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] > 6.4. TrustedIpAddrs Si desea acceder a su servidor Apache-Tomcat remotamente por lo que en el paso anterior no ha especificado localhost o para el parámetro de base-url - usted tendrá que agregar la dirección IP de su servidor Apache-Tomcat a esta lista. Abra el archivo y localice esta línea de código: Buscar el siguiente fragmento de código: <param name>trustedipaddrs</param name> <param value> </param value> 23

24 Se realizan algunos cambios y los códigos debe ser similares a los siguientes: <param name>trustedipaddrs</param name> <param value> , [ y o u r i p a d d r e s s ]</param value> Esto permitirá a la administración 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 Otros parametros También puede cambiar el idioma local y pais en el archivo web.xml, los cambios en estos parámetros se explica por sí mismo. 24

25 7 Configurando SMTP (servidor de correo) Para configurar la plataforma Pentaho BI para utilizar un servidor SMTP (servidor de correo) que se utilizará para enviar informes por correo electrónico, se necesitan hacer modificaciones al archivo /pentaho-solutions/system/smtp- / config.xml. Estos son los parámetros disponibles que se pueden configurar para que soporte SMTP: mail.smtp.host: Esta es la dirección de su servidor de correo electrónico SMTP para el envío de correo electrónico por ejemplo: smtp.gmail.com. mail.smtp.port: Este es el puerto de su servidor de correo electrónico SMTP, para 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 autenticación TTLS colocamos ese parametro en true, para GMail es true. mail.smtp.auth: Colocar en true si el remitente del servidor de correo requiere autentificarse. mail.smtp.ssl: Se coloca en true si el servidor de correo electrónico requiere una conexión SSL, para GMail es true. mail.debug: Salida de información de depuración de la API JavaMail. mail.pop3: No se esta utilizando. mail.from.default: La dirección de los correos electrónicos de la plataforma Pentaho BI por ejemplo, mail.userid: El ID de usuario que se utiliza para autenticar con el servidor SMTP, mail.smtp.auth se debe establecer en true. 25

26 mail.password: La contraseña 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- .xml configurado para GMail: < 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 a n s p o r t. p r o t o c o l>smtps</ mail. t r a n s p o r t. p r o t o c o l> <mail. smtp. s t a r t t l s. enable>true</ mail. smtp. s t a r t t l s. enable> <mail. smtp. auth>true</ mail. smtp. auth> <mail. smtp. s s l>true</ mail. smtp. s s l> <mail. smtp. q u i t w a i t>f a l s e</ mail. smtp. q u i t w a 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> </ smtp> 26

27 8 Configurando publicación Por defecto publicación no está habilitada, para habilitarla deberá especificar una contraseña que deberá ser utilizada para publicar. Para comenzar se tiene que editar el archivo publisher config.xml que se encuentra ubicado en el directorio /pentahosolutions/system/ Una vez abierto el archivo se localiza este fragmento de código: <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 contraseña sera la misma para todos los usuarios). El código debe quedar similar al siguiente (en este caso la contraseña es password ): <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 especificar la contraseña. 27

28 9 Configuración de la consola de administración Para configurar la Consola de administración de PostgreSQL se tiene que descargar el driver JDBC para PostgreSQL. Para colocar el conector JDBC se procede a descargar el archivo postgresql jdbc4.jar en el directorio /administration-console/jdbc/, para ello se ejecuta lo siquiente en la terminal: # cd / opt / pentaho / administration 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. org / download / p o s t g r e s q l j d b c 4. j a r 28

29 10 Cuenta de Usuario Por razones de seguridad, se debe considerar la creación de un usuario independiente cuenta para ejecutar las aplicaciones del servidor, como Pentaho. Normalmente, la cuenta de usuario puede también ser dueño del directorio que contiene el software. Además, esta cuenta de usuario podría ser bloqueada del resto del sistema. Esto es una cuestión de errores: un bug en el software o un servidor simplemente hackeado no puede hacer ningún daño fuera de su propio directorio del software, es decir, la cuenta de usuario reservado para Pentaho no tiene ningún permiso fuera del árbol del directorio Pentaho. Para configurar un cuenta de usuario, grupo, en una terminal se ejecuta lo siguiente: # addgroup pentaho Adding group p e n t a h o (GID 1001)... # adduser system ingroup pentaho d i s a b l e d l o g i n pentaho Adding 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... Creating home d i r e c t o r y /home/ p e n t a h o... Ahora se cambia de dueño a la carpeta Pentaho, en una terminal se ejecuta lo siguiente: # chown pentaho : pentaho R / opt / pentaho 29

30 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 / 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 r v e r ce / opt / pentaho / b i s e r v e r ce 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 ce / tomcat Using CATALINA HOME: / opt / pentaho / b i s e r v e r ce / tomcat Using CATALINA TMPDIR: / opt / pentaho / b i s e r v e r ce / tomcat /temp Using JRE HOME: / usr Using CLASSPATH: / opt / pentaho / b i s e r v e r ce / tomcat / bin / bootstrap. j a r Nota: 1 Ahora ya se puede visitar la dirección y aparecerá una pantalla la en la cual se debe ingresar el usuario y la contraseña, la cual se encuentra haciendo click en el boton Evaluation Login como lo muestra la Figura 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: 1 Tenga en cuenta el comando sudo pentaho -u garantiza que el comando será ejecutado con los permisos del usuario pentaho. Si se omite, el servidor se ejecutará con permisos de root y eso se quiere evitar como se dijo en el anterior apartado. automáticamente cuando se inicia el sistema operativo. 30

31 Figura 11.1: Pantalla Inicial Plataforma Pentaho BI # sudo u pentaho. / stop pentaho. sh / opt / pentaho / b i s e r v e r ce / opt / pentaho / b i s e r v e r ce 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 ce / tomcat Using CATALINA HOME: / opt / pentaho / b i s e r v e r ce / tomcat Using CATALINA TMPDIR: / opt / pentaho / b i s e r v e r ce / tomcat /temp Using JRE HOME: / usr Using CLASSPATH: / opt / pentaho / b i s e r v e r ce / tomcat / bin / bootstrap. j a r 31

32 12 Iniciar la Plataforma Pentaho BI Automáticamente 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 home cd / opt / pentaho / b i s e r v e r ce # s e t up command f o r pentaho user, s e t java environment cmd= sudo u pentaho JAVA HOME=/opt /jvm/ JAVA OPTS= Djava. awt. h e a d 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 t a r t pentaho. sh >> pentaho demo. l o g & ; ; 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 o g & ; ; 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 esac exit 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

33 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. sh Usage :. / 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 t o p #. / 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 siguiente 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 parámetro -f de la siguiente manera en la terminal: # update rc. d f pentaho i n i t. sh remove 33

34 13 Iniciar la consola de Administración Para iniciar la consola de Administración en una terminal se ejecuta el siguiente comando start-pac.sh que se encuentra en el directorio /opt/pentaho/administrationconsole de la siguiente manera en la terminal: # cd / opt / pentaho / administration c o n s o l e # sudo u pentaho. / s t a r t pac. sh 0 9 : 2 6 : 2 8, INFO [ J e t t y S e r v e r ] Console i s now s t a r t e d. I t can be a c c e s s e d using http : / / poldrosky laptop :8099 or http : / / : Ahora ya se puede visitar la dirección Se le pedirá un nombre de usuario y contraseña que por defecto son admin y password. Si se ha iniciado y conectado a la consola de administración debiera ver la pantalla de bienvenida como lo muestra la Figura Figura 13.1: Pantalla Inicial Consola de Administración 34