Gua de instalacin de Pentaho Business Intelligence Suite

Introduccin
El objetivo de este documento es realizar una gua de la instalacin de Pentaho Business
Intelligence Suite 3.8.0 para Debian/Ubuntu. Se utilizar el servidor Apache Tomcat que viene
empaquetado por estas distribuciones. Se espera tambin que ya est instalados una implementacin
de Java 2, versiones 5 o 6 y el servidor de base de datos PostgreSQL 8.4. Se asumen bsicos de
GNU/Linux.

Descargar Pentaho BI Server

Pentaho BI Server se puede obtener de la pgina del proyecto en Sourceforge. Descargue el archivo
biserver-ce-3.8.0-stable.tar.gz, y luego descomprmalo utilizando el siguiente comando:
$ tar -xzf

biserver-ce-3.8.0-stable.tar.gz

Bases de datos
Por defecto Pentaho BI Server est configurado para utilizar dos bases datos y a cada una se conecta
con un usuario distinto, la contrasea de los usuarios para cada usuario es password, la cual se
debe de cambiar.
Para crearlas se deben de ejecutar los siguientes comandos:
1. Base de datos quartz
# su postgres
$ createuser pentaho_user -S -D -R -P
$ createdb quartz owner pentaho_user
$ logout
# psql -h localhost -U pentaho_user -f biserverce/data/postgresql/create_quartz_postgresql.sql quartz

2. Base de datos hibernate

# su postgres
$ createuser hibuser -S -D -R -P
$ createdb hibernate owner hibuser
$ logout
# psql -h localhost -U hibuser -f biserverce/data/postgresql/create_repository_postgresql.sql hibernate

3. Base de datos isp_bolivar

# su postgres
$ createuser isp_bolivar -S -D -R -P
$ createdb isp_bolivar_dw owner isp_bolivar
$ logout
# psql -h localhost -U isp_bolivar -f isp_bolivar.sql isp_bolivar_dw

Desplegar Pentaho BI Server

Para desplegar la plataforma el servidor Apache Tomcat existente debemos realizar los siguientes
acciones:

# /etc/init.d/tomcat6 stop
# cp -r biserver-ce/tomcat/webapps/pentaho /var/lib/tomcat6/webapps/
# cp -r biserver-ce/tomcat/webapps/pentaho-style /var/lib/tomcat6/webapps/
# mkdir /usr/local/lib/biserver-ce
# cp -r biserver-ce/pentaho-solutions /usr/local/lib/biserver-ce
# cp -r kpi /usr/local/lib/biserver-ce/pentaho-solutions
# apt-get install libpg-java
# cp /usr/share/java/postgresql-jdbc3-8.4.jar
/var/lib/tomcat6/webapps/pentaho/WEB-INF/lib
# chown -R tomcat6.tomcat6 /var/lib/tomcat6/webapps/pentaho
# chown -R tomcat6.tomcat6 /var/lib/tomcat6/webapps/pentaho-style
# chown -R tomcat6.tomcat6 /usr/local/lib/biserver-ce/pentaho-solutions

Configuracin de Pentaho BI Server

Aplicacin Web
web.xml
El archivo se encuentra en /var/lib/tomcat6/webapps/pentaho/WEB-INF.
solution-path

Encontrar el siguiente texto dentro del archivo web.xml.

<context-param>
<param-name>solution-path</param-name>
<param-value></param-value>
</context-param>

Modificarlo para que quede de la siguiente manera:

<context-param>
<param-name>solution-path</param-name>
<param-value>/usr/local/lib/biserver-ce/pentaho-solutions</param-value>
</context-param>

fully-qualified-server-url

Debe de buscar el siguiente texto:

<context-param>
<param-name>fully-qualified-server-url</param-name>
<param-value>http://localhost:8080/pentaho/</param-value>
</context-param>

En este caso debe de sustuir localhost, por la direccin IP o el nombre de dominio que se utilizar
para acceder a Pentaho BI Server, por ejemplo:
<context-param>
<param-name>fully-qualified-server-url</param-name>
<param-value>http://192.168.1.1:8080/pentaho/</param-value>
</context-param>

hsqldb

Por defecto Pentaho BI Server est configurado para utilizar unas bases de datos en HSQLD, y las
cuales son iniciadas por la aplicacin. Como ya no se necesitan comentamos las siguientes partes:
<!-- [BEGIN HSQLDB DATABASES]
<!-<context-param>
<param-name>hsqldb-databases</param-name>
<paramvalue>sampledata@../../data/hsqldb/sampledata,hibernate@../../data/hsqldb/hibernate,quart
z@../../data/hsqldb/quartz</param-value>
</context-param>
-->
<!-- [END HSQLDB DATABASES] -->
<!-- [BEGIN HSQLDB STARTER] -->
<!-<listener>
<listenerclass>org.pentaho.platform.web.http.context.HsqldbStartupListener</listener-class>
</listener>
-->
<!-- [END HSQLDB STARTER]

log4j.xml
Este archivo se encuentra en /var/lib/tomcat6/webapps/pentaho/WEB-INF/classes.
Editarlo, luego buscar el texto:
<param name="File" value="pentaho.log"/>

Modificarlo para que quede as:

<param name="File" value="${catalina.base}/logs/pentaho.log"/>

Bases de datos
Ahora es necesario configurar la plataforma para que pueda acceder a las bases de datos en
PostgreSQL.

context.xml
Este archivo est en el directorio /var/lib/tomcat6/webapps/pentaho/META-INF.
Abrir el archivo y encuentre el siguiente texto:
<Resource name="jdbc/Hibernate" auth="Container" type="javax.sql.DataSource"
factory="org.apache.commons.dbcp.BasicDataSourceFactory" maxActive="20"
maxIdle="5"
maxWait="10000" username="hibuser" password="password"
driverClassName="org.hsqldb.jdbcDriver"
url="jdbc:hsqldb:hsql://localhost/hibernate"
validationQuery="select count(*) from
INFORMATION_SCHEMA.SYSTEM_SEQUENCES" />

<Resource name="jdbc/Quartz" auth="Container" type="javax.sql.DataSource"

factory="org.apache.commons.dbcp.BasicDataSourceFactory" maxActive="20"
maxIdle="5"
maxWait="10000" username="pentaho_user" password="password"
driverClassName="org.hsqldb.jdbcDriver"
url="jdbc:hsqldb:hsql://localhost/quartz"
validationQuery="select count(*) from INFORMATION_SCHEMA.SYSTEM_SEQUENCES"/>

Editarlo para que quede de la siguiente manera:

<Resource name="jdbc/Hibernate" auth="Container" type="javax.sql.DataSource"
factory="org.apache.commons.dbcp.BasicDataSourceFactory" maxActive="20"
maxIdle="5"
maxWait="10000" username="hibuser" password="password"
driverClassName="org.postgresql.Driver"
url="jdbc:postgresql://localhost/hibernate"
validationQuery="select 1" />
<Resource name="jdbc/Quartz" auth="Container" type="javax.sql.DataSource"
factory="org.apache.commons.dbcp.BasicDataSourceFactory" maxActive="20"
maxIdle="5"
maxWait="10000" username="pentaho_user" password="password"
driverClassName="org.postgresql.Driver"
url="jdbc:postgresql://localhost/quartz"
validationQuery="select 1"/>

Luego adicionar el siguiente texto para la base de datos de la solucin:

<Resource name="jdbc/kpi" auth="Container" type="javax.sql.DataSource"
factory="org.apache.commons.dbcp.BasicDataSourceFactory" maxActive="20"
maxIdle="5"
maxWait="10000" username="isp_bolivar" password="password"
driverClassName="org.postgresql.Driver"
url="jdbc:postgresql://localhost/isp_bolivar_dw"
validationQuery="select 1"/>

hibernate-settings.xml
El archivo est localizado dentro del directorio pentaho-solutions/system/hibernate.
Una vez abierto el archivo localice el siguiente el siguiente texto:
<config-file>system/hibernate/hsql.hibernate.cfg.xml</config-file>

Modifquelo para que quede de la siguiente forma:

<config-file>system/hibernate/postgresql.hibernate.cfg.xml</config-file>

postgresql.hibernate.cfg.xml
Este archivo est en el mismo directorio.
Una vez abierto localice el siguiente texto:
<property
name="connection.url">jdbc:postgresql://localhost:5432/hibernate</property>
<property name="dialect">org.hibernate.dialect.PostgreSQLDialect</property>

<property name="connection.username">hibuser</property>
<property name="connection.password">password</property>

Modifquelo que quede de la siguiente forma:

<property
name="connection.url">jdbc:postgresql://localhost:5432/hibernate</property>
<property name="dialect">org.hibernate.dialect.PostgreSQLDialect</property>
<property name="connection.username">hibuser</property>
<property name="connection.password">password</property>

Si utiliz otra contrasea para el usuario hiuser debe de actualizarla aqu.

quartz.properties
El archivo se encuentra en el directorio pentaho-solutions/system/quartz.
Abrir el archivo con un editor de texto y localizar el siguiente texto:
org.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.StdJDBCDelegate

Modificar la lnea de texto para que quede de la siguiente forma:

org.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.PostgreSQLDelegate

Autenticacin
applicationContext-security-ldap.properties
Este archivo est en el directorio pentaho-solutions/system.
Editarlo para que quede de la siguiente forma:
contextSource.providerUrl=ldap\://localhost\:10389/ou\=system
contextSource.userDn=uid\=admin,ou\=system
contextSource.password=secret
userSearch.searchBase=ou\=users
userSearch.searchFilter=(cn\={0})
populator.convertToUpperCase=false
populator.groupRoleAttribute=cn
populator.groupSearchBase=ou\=roles
populator.groupSearchFilter=(roleOccupant\={0})
populator.rolePrefix=
populator.searchSubtree=false
allAuthoritiesSearch.roleAttribute=cn
allAuthoritiesSearch.searchBase=ou\=roles
allAuthoritiesSearch.searchFilter=(objectClass\=organizationalRole)
allUsernamesSearch.usernameAttribute=uid
allUsernamesSearch.searchBase=ou\=users
allUsernamesSearch.searchFilter=objectClass\=Person

pentaho-spring-beans.xml
El archivo se encuentra en pentaho-solutions/system.
Buscar el siguiente texto:
<import resource="applicationContext-spring-security-hibernate.xml" />
<import resource="applicationContext-pentaho-security-hibernate.xml" />

Modificarlo para que quede de la siguiente forma:

<import resource="applicationContext-spring-security-ldap.xml" />
<import resource="applicationContext-pentaho-security-ldap.xml" />